Swap Quickstart

Exchange one crypto currency for another on the same network. Both quote legs use currency + network; order type is inferred automatically.

from.network and to.network must match. Cross-chain swaps are not supported.

Prerequisites

KYB-approved partner account with sk_* and enc_* keys
Destination wallet address on the target network
HMAC signing on all write requests

End-user KYC is not required for swap. It is required for onramp and offramp.

End-to-end flow

Create a quote

Reserve a rate between two currencies on the same network.

Create the order

Pass quote_id and recipient.address (where swapped tokens are delivered).

Collect source crypto

Customer sends the source currency to the payin deposit address.

Wait for payment confirmation

Liquidramp auto-detects the deposit. Optionally submit tx_hash via fulfill if confirmation is delayed.

Receive payout

Destination currency arrives at recipient.address; track via order or webhooks.

1. Create a quote

curl -X POST "$BASE_URL/orders/quote" \
  -H "Content-Type: application/json" \
  -H "liquidramp-client-id: $CLIENT_ID" \
  -H "Authorization: Bearer $SECRET_KEY" \
  -H "liquidramp-timestamp: $TIMESTAMP" \
  -H "liquidramp-signature: $SIGNATURE" \
  -d '{
  "from": { "currency": "USDT", "network": "BSC", "amount": 50 },
  "to": { "currency": "USDC", "network": "BSC" },
  "partner_fee": 0
}'

2. Create the order

curl -X POST "$BASE_URL/orders" \
  -H "Content-Type: application/json" \
  -H "liquidramp-client-id: $CLIENT_ID" \
  -H "Authorization: Bearer $SECRET_KEY" \
  -H "liquidramp-timestamp: $TIMESTAMP" \
  -H "liquidramp-signature: $SIGNATURE" \
  -d '{
  "quote_id": "QUOTE_ID_FROM_STEP_1",
  "recipient": { "address": "0x34DF48981ce4d1899a2b1139CC0fDDb6951C4053" },
  "customer": {
    "reference": "cust-001",
    "name": "Jane Doe",
    "email": "jane@example.com"
  }
}'

Swap orders require recipient.address but not bank details. merchant_reference is optional. There is no wallet-management API — you own key management on your side. Validate that the address matches to.network; sending to the wrong chain is irreversible. The response payin object is the source-currency deposit:

"payin": {
  "asset": "USDT",
  "address": "0xDepositAddress...",
  "network": "BSC",
  "amount": 50,
  "expires_at": "2026-06-27T13:00:00.000Z",
  "paid_at": null
}

3. Confirm pay-in (optional)

Liquidramp auto-detects the source-currency deposit. Call fulfill only if confirmation is delayed:

curl -X POST "$BASE_URL/orders/ORD-REFERENCE/fulfill" \
  -H "Content-Type: application/json" \
  -H "liquidramp-client-id: $CLIENT_ID" \
  -H "Authorization: Bearer $SECRET_KEY" \
  -H "liquidramp-timestamp: $TIMESTAMP" \
  -H "liquidramp-signature: $SIGNATURE" \
  -d '{
  "tx_hash": "0xabc123def456789"
}'

4. Check payout

Request ?include=payout for destination delivery details (asset, address, network, amount, tx_hash, paid_at).

curl -X GET "$BASE_URL/orders/ORD-REFERENCE?include=payout,timeline" \
  -H "liquidramp-client-id: $CLIENT_ID" \
  -H "Authorization: Bearer $SECRET_KEY" \
  -H "liquidramp-timestamp: $TIMESTAMP" \
  -H "liquidramp-signature: $SIGNATURE"

Endpoint	Method	Purpose
`/orders/quote`	POST	Reserve swap rate
`/orders`	POST	Create swap order
`/orders/{reference}/fulfill`	POST	Optional pay-in proof if confirmation is delayed
`/orders/{reference}`	GET	Status + payout

Introduction

Getting Started

Quickstarts

Liquidity Providers

Resources

Prerequisites

End-to-end flow

1. Create a quote

2. Create the order

3. Confirm pay-in (optional)

4. Check payout

​Prerequisites

​End-to-end flow

​1. Create a quote

​2. Create the order

​3. Confirm pay-in (optional)

​4. Check payout

​Related

Prerequisites

End-to-end flow

1. Create a quote

2. Create the order

3. Confirm pay-in (optional)

4. Check payout

Related