Balance Queries
Query account balances and understand locked transactions
01
Get Balance
Query your account balance for a specific asset denomination:
curl -X GET "https://pay.yieldfabric.com/balance?denomination=aud-token-asset&obligor=null" \
-H "Authorization: Bearer $TOKEN"02
Response Fields
Balance Fields
private_balance- Encrypted balance (ZK-proof protected)public_balance- Public/transparent balancelocked_out- Outgoing pending paymentslocked_in- Incoming pending paymentsoutstanding- Total locked in outgoing
03
Understanding Your Balance
Available Balance = private_balance - outstanding
Incoming locked_in transactions don't affect your balance until you accept them.
04
Query with Specific Obligor
Query balances for obligations from a specific obligor:
curl -X GET "https://pay.yieldfabric.com/balance?denomination=aud-token-asset&obligor=issuer@yieldfabric.com" \
-H "Authorization: Bearer $TOKEN"05
Group Balance Queries
Query group balances using delegation token or group_id parameter:
curl -X GET "https://pay.yieldfabric.com/balance?denomination=aud-token-asset&obligor=null&group_id=550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $TOKEN"