Skip to main content

Get Balances

GET /merchant/settlements/balances returns your cashout-able balance per asset — matured funds only — plus a "maturing" bucket for funds still inside the settlement waiting window. Call it before creating a settlement to know how much you can withdraw now.

Example​

TS=$(date +%s); BODY=""
SIG=$(printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$SIGNING_SECRET" | awk '{print $2}')
curl https://api-staging.finomesh.com/api/v1/merchant/settlements/balances \
  -H "X-Api-Key: $FINOMESH_API_KEY" \
  -H "X-Timestamp: $TS" -H "X-Signature: $SIG"

Each item carries assetId, symbol, networkId, totalAvailable (a decimal string — the amount you can withdraw now), totalAvailableUsd, and the maturing totalPending* fields.

The totalAvailable figure is the ceiling for a create settlement amount on that asset — requesting more returns a 409 conflict.

Reference​