Skip to main content
GET
/
v1
/
{merchant}
/
topups
/
{id}
curl "https://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

​
merchant
string
required
Merchant id. Currently antseed. Returns 404 for ids that belong to a different merchant.
​
id
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, needs_review). bridging usually resolves in under a minute. The gateway resumes every non-terminal top-up after a restart, so crash recovery never double-credits the buyer. bridge_expired or bridge_timeout in error requires Meridian operations review. 
curl "https://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
}