डेवलपर डॉक्स अंग्रेज़ी में हैं। कोड, फ़ील्ड के नाम और API पाथ हर भाषा में एक जैसे हैं।

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.