Get Escrow Balances
Read token balances of up to 20 escrows directly from the chain.
Reads the current token balance of one or more escrow contracts directly from the chain. Authoritative — for a bulk financial view with deposits, releases and fees included, prefer GET /escrows/financial.
Each factory only answers for its own escrows — use the endpoint that matches the contract flavor of the addresses you pass.
Single Release (v2)
Invokes get_multiple_escrow_balances on the single-release-v2 factory. Each address must be a deployed single-release-v2 escrow (C...). Maximum 20 addresses per call.
Up to 20 deployed single-release-v2 escrow addresses to query.
["CDHAZ2RTE2MDHYQQ7NATF5IVKIFVGLX6FHJ66OPK6MUXBSTRRXFXJ6QB"]Balances read successfully.
Escrow contract address whose balance was queried.
CDHAZ2RTE2MDHYQQ7NATF5IVKIFVGLX6FHJ66OPK6MUXBSTRRXFXJ6QBToken balance held by the escrow, in human-readable decimals (already scaled by the trustline decimals).
1000.5Trustline decimals (e.g. 7 for Stellar USDC). Useful for clients that need to format the value with a fixed precision.
7Request body or query params fail schema validation (wrong type, missing required field, unknown property).
Missing, malformed, expired, revoked or invalid API key.
API key is valid but does not have the role required for this operation.
Payload is well-formed but a business rule rejects it (e.g. amount out of range, role not allowed for this user).
Unexpected server-side failure. Use the traceId to look up the incident in server logs or contact support.
GET /escrow/single-release/v2/escrow-balances?addresses=CDHAZ2RTE2MDHYQQ7NATF5IVKIFVGLX6FHJ66OPK6MUXBSTRRXFXJ6QB HTTP/1.1
Host: beta.api.trustlesswork.com
x-api-key: YOUR_API_KEY
Accept: */*
[
{
"address": "CDHAZ2RTE2MDHYQQ7NATF5IVKIFVGLX6FHJ66OPK6MUXBSTRRXFXJ6QB",
"balance": 1000.5,
"decimals": 7
}
]Multi Release (v2)
Invokes get_multiple_escrow_balances on the multi-release-v2 factory. Each address must be a deployed multi-release-v2 escrow. Maximum 20 addresses per call.
Up to 20 deployed multi-release-v2 escrow addresses to query.
["CDHAZ2RTE2MDHYQQ7NATF5IVKIFVGLX6FHJ66OPK6MUXBSTRRXFXJ6QB"]Balances read successfully.
Escrow contract address whose balance was queried.
CDHAZ2RTE2MDHYQQ7NATF5IVKIFVGLX6FHJ66OPK6MUXBSTRRXFXJ6QBToken balance held by the escrow, in human-readable decimals (already scaled by the trustline decimals).
1000.5Trustline decimals (e.g. 7 for Stellar USDC). Useful for clients that need to format the value with a fixed precision.
7Request body or query params fail schema validation (wrong type, missing required field, unknown property).
Missing, malformed, expired, revoked or invalid API key.
API key is valid but does not have the role required for this operation.
Payload is well-formed but a business rule rejects it (e.g. amount out of range, role not allowed for this user).
Unexpected server-side failure. Use the traceId to look up the incident in server logs or contact support.
GET /escrow/multi-release/v2/escrow-balances?addresses=CDHAZ2RTE2MDHYQQ7NATF5IVKIFVGLX6FHJ66OPK6MUXBSTRRXFXJ6QB HTTP/1.1
Host: beta.api.trustlesswork.com
x-api-key: YOUR_API_KEY
Accept: */*
[
{
"address": "CDHAZ2RTE2MDHYQQ7NATF5IVKIFVGLX6FHJ66OPK6MUXBSTRRXFXJ6QB",
"balance": 1000.5,
"decimals": 7
}
]Field notes
Up to 20 contract addresses per request.
Every address in one call must be a deployed escrow of that endpoint's flavor — don't mix single- and multi-release addresses in the same request.
Read-only: nothing to sign, nothing to submit.
Last updated