Deposits

Get all deposits

get

Returns all USDCx deposits from Ethereum to Stacks, aggregating data from 3 sources:

• ETH Events: DepositedToRemote events from the xReserve contract

• Circle Attestations: Signed attestations from Circle's API (after ETH finality)

• STX Mints: Print events from the relay transaction on Stacks

Each deposit has a status:

• pending: Only the ETH event exists (waiting for Circle attestation)

• attested: ETH event + Circle attestation (waiting to be relayed)

• relayed: All 3 sources present (deposit completed)

Deposits are matched by nonce and sorted chronologically (newest first).

Path parameters

networkStrstringRequired

Responses

200

Response for status 200

application/json

totalnumberRequired

get

/{networkStr}/deposits

HTTPcURLJavaScriptPython

GET /{networkStr}/deposits HTTP/1.1
Host: api.usdc-on-stacks.com
Accept: */*

200

Response for status 200

{
  "deposits": [
    {
      "amount": "text",
      "amountFormatted": "text",
      "circleAttestation": {
        "attestation": "text",
        "decodedAmount": "text",
        "decodedRemoteRecipient": "text",
        "messageHash": "text",
        "payload": "text"
      },
      "ethEvent": {
        "blockNumber": "text",
        "localDepositor": "text",
        "localToken": "text",
        "logIndex": 1,
        "maxFee": "text",
        "nonce": "text",
        "remoteRecipient": "text",
        "transactionHash": "text",
        "value": "text"
      },
      "ethExplorerLink": "text",
      "ethTxid": "text",
      "nonce": "text",
      "status": null,
      "stxRecipient": "text"
    }
  ],
  "total": 1
}