Skip to main content
Before writing integration code, understand how Liquidramp models a trade end to end.

Transaction model

Exchange rates

Preview rates without reserving a quote.

Quotes

POST /v1/orders/quote reserves a rate before you commit an order.

Orders

Unified POST /v1/orders for onramp, offramp, and swap.

Order lifecycle

How status moves from created through completed.

Transaction statuses

Terminal and in-flight status values — when to poll, when to wait for webhooks.

Liquidity and settlement

Liquidity providers

How independent providers supply inventory for routed orders.

Settlement

How fiat and crypto legs complete after payment confirmation.

Escrow

On-chain protection for crypto during offramp and swap.

Integration operations

Callbacks

Outbound webhooks for order status changes.

Idempotency

Safe retries on order creation without duplicate trades.

Retries

When to retry API calls vs wait for async settlement.

Rate limits

How to handle throttling.

Reference data

Assets and corridors are fetched at runtime — do not hardcode:

Quick integration path

1

Authenticate

Generate pk_* / sk_* / enc_* keys. Authentication
2

Discover assets

Call reference endpoints to populate currency and network pickers.
3

Quote and order

Preview rate, then create order. Onramp quickstart
4

Fulfil and settle

Payment is auto-detected. Optionally call POST /v1/orders/:reference/fulfill if confirmation is delayed. Listen for webhooks.

Order types at a glance