Top-up Status

curl "https://api-antseed.mrdn.finance/v1/antseed/topups/0xf6cd…d723"

{
  "topupId": "0xf6cd…d723",
  "state": "deposited",
  "buyer": "0xYourAddress",
  "payer": "0xYourAddress",
  "network": "optimism",
  "sourceNetwork": "optimism",
  "grossAmount": "5000000",
  "netAmount": "4900000",
  "settlementTx": "0xeb80…e5a8",
  "fillTx": "0xa91c…44fe",
  "depositTx": "0x8186…1234",
  "refundTx": null,
  "error": null,
  "createdAt": 1783656257928,
  "updatedAt": 1783656258080
}

GET

{merchant}

topups

{id}

curl "https://api-antseed.mrdn.finance/v1/antseed/topups/0xf6cd…d723"

{
  "topupId": "0xf6cd…d723",
  "state": "deposited",
  "buyer": "0xYourAddress",
  "payer": "0xYourAddress",
  "network": "optimism",
  "sourceNetwork": "optimism",
  "grossAmount": "5000000",
  "netAmount": "4900000",
  "settlementTx": "0xeb80…e5a8",
  "fillTx": "0xa91c…44fe",
  "depositTx": "0x8186…1234",
  "refundTx": null,
  "error": null,
  "createdAt": 1783656257928,
  "updatedAt": 1783656258080
}

Free, public status of a top-up. The topupId comes from the POST response. The row never exposes the payment signature.

Path

string

default:"antseed"

required

Merchant id. Currently antseed. Returns 404 for ids that belong to a different merchant.

string

required

Top-up id (topupId from the create response).

States

same-chain:  settling ───────────→ settled → depositing → deposited
cross-chain: settling → bridging → settled → depositing → deposited
                                      └→ refunding → refunded
any → failed | needs_review                              terminal

Poll until the state is terminal: deposited, refunded, failed, or needs_review. A status request advances non-terminal top-ups. The gateway also resumes them in the background and after restarts. Use the Retry-After value from a pending POST (currently 5 seconds). A clean settlement failure appears as failed. It is terminal for status polling, but the same X-PAYMENT can be resubmitted while its authorization is still unused and unexpired. bridge_expired, bridge_timeout, or any needs_review state requires Meridian operations review.

curl "https://api-antseed.mrdn.finance/v1/antseed/topups/0xf6cd…d723"

{
  "topupId": "0xf6cd…d723",
  "state": "deposited",
  "buyer": "0xYourAddress",
  "payer": "0xYourAddress",
  "network": "optimism",
  "sourceNetwork": "optimism",
  "grossAmount": "5000000",
  "netAmount": "4900000",
  "settlementTx": "0xeb80…e5a8",
  "fillTx": "0xa91c…44fe",
  "depositTx": "0x8186…1234",
  "refundTx": null,
  "error": null,
  "createdAt": 1783656257928,
  "updatedAt": 1783656258080
}

Overview

x402 Payments

x402 Inference

Merchant Top-ups

Nanopayments Gateway

Path

States

​Path

​States

Path

States