Skip to main content
GET
/
balance
Get balance
curl --request GET \
  --url https://processor-prod.up.railway.app/balance \
  --header 'x-service-key: <api-key>'
{
  "success": true,
  "status": 200,
  "message": "Balance fetched successfully",
  "timestamp": "2025-09-09T17:36:53.285Z",
  "data": {
    "id": "solana:usdc",
    "name": "USD Coin",
    "code": "USDC",
    "blockchain": {
      "id": 10000,
      "name": "Solana"
    },
    "balance": 0,
    "available": 0,
    "debt": 0
  }
}

Authorizations

​
x-service-key
string
header
required

Query Parameters

​
asset
enum<string>
required

The asset to get balance for

Available options:
ethereum:usdc,
base:usdc,
arbitrum:usdc,
solana:usdc,
bsc:usdc,
polygon:usdc,
optimism:usdc,
avalanche:usdc,
ethereum:usdt,
arbitrum:usdt,
solana:usdt,
polygon:usdt,
bsc:usdt,
optimism:usdt,
avalanche:usdt,
base:cngn,
bsc:cngn
Example:

"solana:usdc"

​
wallet_id
string
required

The wallet ID to get balance for

Example:

"68bc290df51feea8c53f5275"

Response

200 - application/json

Balance fetched successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
Example:

"Balance fetched successfully"

​
timestamp
string<date-time>
Example:

"2025-09-09T17:36:53.285Z"

​
data
object