Liquidity API
Institutional quote, transaction, reporting, and liquidity-management boundaries.
The public institutional liquidity surface lives at:
https://api.0bit.app/liquidity
It serves organizations that consume pool inventory programmatically and organizations that provide liquidity. Those roles share one Account and one credential authority; entitlements and scopes decide which operations are available.
Route families
| Route family | Purpose |
|---|---|
GET /liquidity |
List liquidity available to the authenticated organization |
/liquidity/:id/quote and /liquidity/:id/transact |
Lock terms and reserve an entitled transaction |
/liquidity/quotes/*, /liquidity/transactions/*, /liquidity/trades/* |
Read quote and transaction lifecycle state |
/liquidity/funding and /liquidity/ledger |
Read organization-scoped prefunding instructions and ledger history |
/liquidity/reports/* |
Read aggregate reports and bounded CSV exports |
/liquidity/webhooks/* |
Inspect, test, and replay institutional webhook deliveries |
/liquidity/rfq/* |
The separate, entitlement-gated institutional RFQ subproduct |
The endpoint itself remains the source of truth for availability. Do not infer a live corridor from a provider name or a static country list; disabled, unconfigured, or unentitled paths deny access.
RFQ responses name the venue that actually supplied or executed the quote. The RFQ product does not present a legacy product wrapper or a generic DEX identity.
Authentication and isolation
Discovery operations explicitly marked as public or publishable-key-safe may use
a pk_* key. Quotes, transactions, funding data, reports, webhook management,
and other organization state require an sk_* key. Every protected read and
write is organization-scoped.
See Organization API keys for key modes, scopes, and rotation.
Money representation
- Decimal values are transported as strings; do not parse money through binary floating-point types.
- Quoted rates are rounded once to 8 decimal places.
- Fiat payouts are rounded to the nearest minor unit using half-up rounding; exact half-cent ties round away from zero.
- Mutating routes that require
Idempotency-Keybind the key to the request fingerprint. Reusing it with a different body is rejected.
What is not public
The engine's reserve, commit, hedging, venue-balance, and router endpoints are
internal. Operations tooling consumes them through owned service boundaries;
partner integrations use /liquidity/* instead.