Get Wallet Balance - AssetPay

Returns the wallet balance of the merchant that owns the API key. Use it to check how much you can spend on withdrawals before calling /secure/buy, or to reconcile your own books. Authentication: Merchant API Key (api-key header) Scope: LEDGER_READ

Wallet and ledger routes carry the /v1 prefix, unlike the version-neutral trading routes.

Request

GET https://api.assetpay.gg/v1/wallets/me/balance
api-key: ap_...

This endpoint takes no parameters.

Response

{
  "requestId": "...",
  "success": true,
  "data": {
    "balance": 1250.40,
    "pendingBalance": 85.00,
    "escrowBalance": 312.75,
    "currency": "USD"
  }
}

Field	Type	Description
`balance`	number	Available balance in USD. This is what you can spend now.
`pendingBalance`	number	Uncleared crypto deposits, plus funds locked for withdrawals that are still in flight.
`escrowBalance`	number	The part of CS2 skin deposits that was not credited instantly, while those deposits are in hold. It moves to `balance` when a deposit completes; if the deposit fails or is reverted it is taken back and never reaches you. Rust deposits never use escrow.
`currency`	string	Always `USD`.

The three buckets are separate. Your total wallet value is their sum.

Rate Limits

Merchant Status	Limit
Verified	500 requests / min
Unverified	50 requests / min

Errors

Code	Key	When
1100	`UNAUTHORIZED`	Neither an `api-key` header nor a `Bearer` `Authorization` header was sent (HTTP 401)
1300	`MERCHANT_API_KEY_REQUIRED`	An admin API key was used; this route needs a merchant key (HTTP 403)
1301	`ACCOUNT_DISABLED`	The account that owns the API key is not active (HTTP 403)
1901	`INVALID_API_KEY`	The key does not exist or was revoked
1904	`API_KEY_IP_DENIED`	The request IP is not in the key’s whitelist
1908	`INSUFFICIENT_SCOPE`	The key does not have the `LEDGER_READ` scope
1005	`RATE_LIMITED`	Rate limit exceeded