Dokumentasi developer tersedia dalam bahasa Inggris. Kode, nama field, dan path API sama di semua bahasa.
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:
break200 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.