Top-up History · Token Kiosk

GET /v1/topups/:wallet

List a wallet's top-up history, newest first — used to render receipts. Wallet-scoped: accepts API key or SIWE auth.

curl https://agent-router.gaib.ai/v1/topups/0xYourWallet \
  -H "Authorization: Bearer sk-your-key"

The API key may also be passed as an api_key query parameter.

curl "https://agent-router.gaib.ai/v1/topups/0xYourWallet?message=<siwe>&signature=<sig>"

{
  "wallet": "0xabc...",
  "network": "Base (Mainnet)",
  "topups": [
    {
      "id": 12,
      "amount_usdc": 5000000,
      "tx_hash": "0x...",
      "created_at": "2026-06-09T10:23:00.000Z"
    }
  ]
}

Field	Unit	Description
`network`	`string`	Human-readable network the gateway settles on (`Base (Mainnet)` or `Base Sepolia (Testnet)`)
`topups[].amount_usdc`	micro-USDC	`/ 1_000_000` = USD
`topups[].tx_hash`	`string`	On-chain settlement transaction hash
`topups[].created_at`	ISO 8601	When the top-up was recorded

To create a top-up, see Top Up.