Deposits

Look up deposits to backfill missed webhooks or to reconcile. Webhooks remain the fastest way to learn about a deposit.

Get deposit

GET/v1/deposits/{id}

Returns one deposit. id is the deposit_id from deposit webhooks. Unknown ids return 404 not_found.

200 OK

{
  "id": "c1a5e8f2-7b3d-4e9a-8c6f-1d2e3f4a5b6c",
  "status": "confirmed",
  "chain": "tron",
  "asset": "tron:USDT",
  "decimals": 6,
  "address": "TQ9xG7c2...7kLm",
  "player_ref": "player_1024",
  "from": "TFp3...Wq8",
  "amount": "50000000",
  "fee": "1000000",
  "net": "49000000",
  "finality": "finalized",
  "tx_hash": "0x7c3e...b91d",
  "log_index": 0,
  "block_number": "68421337",
  "detected_at": "2026-10-10T08:00:41.000Z",
  "confirmed_at": "2026-10-10T08:01:12.000Z"
}

Deposit object

Field	Type	Description
`status`	string · required	See the status table below.
`address`	string · required	The player's deposit address that received the funds.
`player_ref`	string · required	Your id for the player, from Create address.
`from`	string · required	Sender address.
`amount`	string · required	What the player sent, in the smallest unit. Credit the player this full amount.
`fee`	string \| null · required	Our fee. Set once `confirmed`.
`net`	string \| null · required	`amount − fee`: what your balance receives (the fee is charged to you, not the player). Set once `confirmed`.
`finality`	string \| null · required	`fast` (small deposit credited after a few blocks on slow-finality chains) or `finalized`.
`tx_hash, log_index, block_number`	string, number, string · required	Where the transfer is on-chain.

Status

status	Meaning
`detected`	Seen on-chain, not final. Show it as pending; do not credit.
`confirmed`	Final and credited to your balance. fee and net are set.
`below_min`	Below the minimum deposit; not credited. Contact us to resolve it.
`flagged`	Held for review; not credited.
`orphaned`	The block it was in was reorganized away before it became final. Nothing was credited.

List deposits

GET/v1/deposits

Newest first.

Parameter	Type	Description
`player_ref`	string · optional	Only this player's deposits.
`status`	string · optional	One of the statuses above.
`limit`	integer · optional	1–100, default 50.
`before`	string · optional	For the next page, pass `next_before` from the previous response.

let before = null;
do {
  const q = new URLSearchParams({ player_ref: "player_1024", limit: "100", ...(before && { before }) });
  const { body } = await icn("GET", `/v1/deposits?${q}`);
  for (const d of body.deposits) handle(d);
  before = body.next_before;
} while (before);

before = None
while True:
    q = "player_ref=player_1024&limit=100" + (f"&before={before}" if before else "")
    status, body = icn("GET", f"/v1/deposits?{q}")
    for d in body["deposits"]:
        handle(d)
    before = body["next_before"]
    if not before:
        break

200 OK

{
  "deposits": [ { "id": "c1a5e8f2-…", "status": "confirmed", … } ],
  "next_before": "c1a5e8f2-7b3d-4e9a-8c6f-1d2e3f4a5b6c"
}

next_before is null on the last page. The query string is part of what you sign, so sign it exactly as you send it.