balance_safe and locked_safe — an
off-chain mirror of the USDC actually held in your on-chain Gnosis Safe.
Endpoint
GET /api/v2/atlas/account/balances
Returns one row per currency. GET /api/v2/atlas/account/balances/:currency
returns a single row.
Every row reflects the live pools at the time of the request.
Response fields
The response also carries
balance and locked. These belong to an operator-held balance model that Calibri does not offer — they read "0". The pools that matter to you are balance_safe and locked_safe.Example row
How the Safe pool moves
- Funding — USDC sent to your Safe address on-chain is credited to
balance_safeonce the transfer confirms. - Resting order — placing an order locks collateral against
locked_safe. - Settlement — a winning position is credited to
redeemable_safe, notbalance_safe: the payout is still held by the ConditionalTokens contract. - Redemption — redeeming (by hand or via auto-redeem) moves the USDC into
your Safe on-chain; once it confirms, the amount moves from
redeemable_safetobalance_safe. - Withdrawal — moving USDC out of the Safe on-chain debits
balance_safeand cancels any resting orders those funds collateralised.
Related
- The Safe — how the on-chain Safe is created and funded
- Signed orders — what locks
locked_safe - Redeeming winnings — how payouts reach
balance_safe