Incoming TRC-20 deposits with custody statuses
The merchant's incoming TRC-20 deposits: the ledger credit plus the DepositSweepWorker lifecycle of the receiving address (CREDITED / SWEEP_PENDING / SWEEP_FAILED / SWEEP_STUCK / SWEPT). Keyset pagination (AIP-158): page_size 1–100 (default 20), page_token/next_page_token.
/api/v1/p2p/merchant/wallet/depositsThe merchant's incoming TRC-20 deposits: the ledger credit plus the DepositSweepWorker lifecycle of the receiving address (CREDITED / SWEEP_PENDING / SWEEP_FAILED / SWEEP_STUCK / SWEPT). Keyset pagination (AIP-158): page_size 1–100 (default 20), page_token/next_page_token.
Authorization
MerchantToken MerchantSignature 64-character hex public merchant token assigned during onboarding.
In: header
Stripe-style HMAC-SHA256 signature.
Format: t=<unix_seconds>,v1=<hex_hmac_sha256>
where hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>").
Replay window: 5 minutes (60s future drift tolerated).
In: header
Query Parameters
Maximum number of results to return (default 20, max 100).
int321 <= value <= 10020Opaque pagination token returned by the previous page.
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1/p2p/merchant/wallet/deposits"{ "data": [ { "block_timestamp": "2019-08-24T14:15:22Z", "amount_usdt_cents": 0, "tx_hash": "string", "trc20_address": "string", "status": "CREDITED" } ], "next_page_token": "string"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "instance": "../dictionary", "errors": [ { "field": "amount", "message": "must be greater than 0", "code": "POSITIVE_REQUIRED" } ]}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "instance": "../dictionary", "errors": [ { "field": "amount", "message": "must be greater than 0", "code": "POSITIVE_REQUIRED" } ]}Quote the withdrawal fee before submitting GET
Read-only quote of the withdrawal fee that applies to the authenticated merchant BEFORE they submit: the per-counterparty override when set, else the tenant base — resolved through the SAME policy resolver the money path uses, so the quote cannot drift from the charged fee. Optional `amount_usdt_cents` (USDT cents, note — whole-USDT units in the create request) also yields the net amount.
Withdrawal history (manual queue merged with executed debits) GET
The merchant's withdrawal history: the manual approval queue merged with the executed ledger debits, deduplicated by on-chain tx hash. Statuses: PENDING (awaiting approval), APPROVED (approved, not yet broadcast), COMPLETED (broadcast, tx hash present), CANCELLED (rejected by an operator). Same keyset pagination as deposits.