Create a 0Pools quote

0Pools API pages are for approved headless partners. They cover the partner-visible quote, transact, status, trade, and balance lifecycle only.

Pricing a conversion and locking a quote is the first money-shaped step in the lifecycle. A quote captures the side, the pair, the amount, the partner-visible economics, and — for a buy — the delivery address. Your server reads the quote, shows the user only the partner-visible economics, and either executes once before expiry or lets the quote lapse.

Endpoint

The {id} path parameter is a pool id this partner is entitled to, discovered from GET /pools. A pool id you are not entitled to returns 404 (cross-tenant access is never 403).

Use it for

Price a specific conversion and lock a short-lived, single-use quote for an entitled pool. For a buy (on_ramp), the call also captures and locks the on-chain delivery address that the purchased crypto will be sent to at settlement.

Use this endpoint only for the partner-scoped resource it describes. Store your own reference id, the returned quoteId, the request id, timestamps, and the current status so support and reconciliation do not depend on browser callbacks alone.

Production rules

• Keep secret keys on your server. This endpoint requires a sk_* key.
• Validate environment, mode, entitlement, asset, network, and amount before the call.
• For a buy, validate the delivery address before requesting the quote — it is locked at this step and cannot be changed later.
• Branch on machine-readable status, error code, object id, and request id.
• Treat examples and placeholder ids as fake data only.

Request body

Sides and the amount role

side sets the direction of the conversion and therefore what amount means.

rate is always expressed as output per unit of input for the chosen side, as a decimal string.

Firm vs indicative

type controls whether the call locks an executable quote or just returns a price.

A firm quote returns a quoteId and an expiresAt roughly 15 seconds in the future. It is single-use: once you transact it (or reject it, or it expires) it cannot be reused. Show the user only the partner-visible economics and execute once before expiresAt.

An indicative quote returns available: true with executable: false and no quoteId and no expiresAt. It is never persisted and can never be passed to transact. Use it to render a price without committing inventory.

Only act on executable: true. Never attempt to transact an indicative quote, and never transact a quote that is reported unavailable.

On-ramp delivery contract

For a buy (on_ramp), destAddress is required and is captured and locked onto the quote at this step.

• It is validated as an EVM 0x… (40-hex) address against an EVM-only allowlist. The EIP-55 checksum is enforced only for mixed-case addresses; an all-lowercase or all-uppercase address passes on format.
• destNetwork, when provided, must be one of the allowed EVM networks; when omitted it defaults to the quoted cryptoNetwork.
• At transact, the locked delivery target is copied onto the trade from the quote, never from the transact body — there is no way to redirect delivery after the quote is locked.
• The crypto is delivered to that address when the trade settles.
• A missing destAddress on an on_ramp quote is a 400.

Delivery networks are EVM-only:

Response

The response is always HTTP 200 — both an available quote and an unavailable pool return 200. Branch on the available flag, not on the status code.

For per-pool spread and fee ceilings and order limits, read GET /pools/{id}/capabilities rather than hard-coding values.

Unavailable (fail-soft) response

When the route cannot be priced, the API returns 200 with available: false, an unavailableReason, and no quoteId. This is a normal outcome, not an error — never treat it as a failure to retry in a tight loop, and never attempt to transact it.

Show the user a partner-visible unavailable state, optionally offer another pool, and back off before re-quoting.

Examples

curl -X POST https://pools-api.0bit.app/v1/pools/pool_test_123/quote \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "side": "on_ramp",
    "fiatCurrency": "EUR",
    "cryptoCurrency": "USDT",
    "amount": "100.00",
    "cryptoNetwork": "tron",
    "type": "firm",
    "destAddress": "0x52908400098527886E0F7030069857D2E4169EE7",
    "destNetwork": "arbitrum"
  }'

{
  "available": true,
  "type": "firm",
  "executable": true,
  "quoteId": "pq_test_8f3c000000000123",
  "rate": "1.0731",
  "spreadBps": 25,
  "feeBps": 30,
  "minOrderUsdt": 10,
  "maxOrderUsdt": 50000,
  "expiresAt": "2026-01-01T00:00:15Z"
}

{
  "available": true,
  "type": "indicative",
  "executable": false,
  "rate": "1.0731",
  "spreadBps": 25,
  "feeBps": 30,
  "minOrderUsdt": 10,
  "maxOrderUsdt": 50000
}

{
  "available": false,
  "unavailableReason": "pool_dry"
}

Errors

All errors use the unified envelope and carry an X-Request-Id response header. Branch on code/type/statusCode, not on the free-form message.

{
  "type": "invalid_request",
  "code": "invalid_request",
  "message": "Example validation error using fake data.",
  "request_id": "req_test_000000000123",
  "doc_url": null,
  "statusCode": 400
}

Public boundary

This reference covers partner-visible discovery, quote, transact, status, trade, and balance behavior. Liquidity operations, routing internals, settlement venues and networks, provider details, reserve logic, and runbooks are outside the public API contract.

Related pages