Pave Bank
Crypto

Create Digital Asset Exchange

Admin Access Required

Use this API to create a Digital Asset Exchange. This API will respond with a Transaction ID, use this Transaction ID in the GET Transaction endpoint to get the crypto quote (e.g. rate and amounts). No funds move until the order is confirmed.

Supported assets in sandbox

In sandbox, Digital Asset Exchange supports USDC and USDT on Ethereum, traded against USD.

Digital assetbase_assetquote_assetsymbolMinor unit decimals
USD CoinETHEREUM-USDCUSDUSDC-USD6
TetherETHEREUM-USDTUSDUSDT-USD6

We recommend testing with USDT. Our sandbox holds a limited supply of USDC, so USDC orders are more likely to fail for lack of available balance.

Sandbox network and token contracts

Sandbox runs against the Ethereum Sepolia testnet. The wallet addresses and transaction_hash values returned by the API are Sepolia addresses and hashes, and can be inspected on Sepolia Etherscan.

Digital assetSepolia contract address
USDC0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238
USDT0xdeB5c83f0eFd5AE456746912A2cCA573BC33d220

USDC is Circle's official Sepolia deployment — see USDC contract addresses. Tether does not publish a Sepolia deployment, so sandbox USDT uses a Pave-deployed test contract with the same ERC-20 interface and 6 decimals.

These contracts and addresses are testnet-only and carry no value. Do not send mainnet funds to a sandbox wallet address.

Digital Asset Exchange Flow

A Digital Asset Exchange follows a two-step quote/confirm pattern:

  1. Create order (POST /v1/crypto/order) — returns a live, time-boxed quote (rate and amounts). No funds move.
  2. Review quote (GET /v1/transactions/:transactionID) — retrieve the order to review the quote before confirming.
  3. Confirm order (PUT /v1/crypto/order) — confirms the quote and triggers execution and settlement.

The quote expires automatically if it is not confirmed before quote_valid_until.

Example POST to create a Digital Asset Exchange (quote)

curl -X POST 'https://developer-api-staging.pavebank.dev/v1/crypto/order' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <YOUR_IDEMPOTENCY_KEY>' \
  --header 'Authorization: Bearer <YOUR_BEARER_TOKEN>' \
  --data '{
  "side": "sell",                                        // "buy" or "sell", from the customer perspective
  "priority": "instant",                                 // "instant"
  "rail": "rfq",                                         // "rfq"
  "symbol": "USDT-USD",
  "base_asset": "ETHEREUM-USDT",
  "quote_asset": "USD",
  "requested_asset": "ETHEREUM-USDT",                    // The asset the requested_amount is denominated in
  "requested_amount": "100000000",
  "customer_pays_account_id": "account_<Example_USDT_Account>",
  "customer_receives_account_id": "account_<Example_USD_Account>",
  "description": "Sell 100 USDT",
  "additional_details": ""
}'

This API will respond with a transaction_id

{
  "transaction_id": "transaction_tvc28vj7eul6gtymqcl9nm6xhl"
}

Use this transaction_id in the GET Transaction endpoint to get the Digital Asset Exchange. This is a quote and not an executed trade. If you would like to execute the trade, use the Digital Asset Exchange PUT API before the quote expires.

It might take several seconds for the Transaction to be able to be retrieved by this API. If you get a 404 error, please try again in 5-15 seconds.

// Example transaction response after using transaction_tvc28vj7eul6gtymqcl9nm6xhl

{
  "transaction_id": "transaction_tvc28vj7eul6gtymqcl9nm6xhl",
  "status": "in_progress",
  "timestamp": "2026-07-13T07:19:31.969776Z",
  "type": "CRYPTO-TRADE-V2",
  "customer_type": "Exchange (Digital asset)",
  "crypto_trade_v2": {
    "transaction_id": "transaction_tvc28vj7eul6gtymqcl9nm6xhl",
    "customer_legal_entity_id": "legalentity_<LEGAL_ENTITY_ID>",
    "initiated_by": {
      "id": "user_<YOUR_USER_ID>",
      "first_name": "Local",
      "last_name": ""
    },
    "checked_by": null,
    "checked_at": null,
    "priority": "instant",
    "side": "sell",
    "rail": "rfq",
    "symbol": "USDT-USD",
    "base_asset": "ETHEREUM-USDT",
    "quote_asset": "USD",
    "customer_pays_account_id": "account_<Example_USDT_Account>",
    "customer_pays_account_name": "ETH USDT 02",
    "customer_pays_account_iban": "",
    "customer_pays_account_wallet_address": "0x54138299990c0F2F44DD58808b69EcFfCfdba508",
    "customer_receives_account_id": "account_<Example_USD_Account>",
    "customer_receives_account_name": "First USD",
    "customer_receives_account_iban": "<RECEIVES_ACCOUNT_IBAN>",
    "customer_receives_account_wallet_address": "",
    "customer_requested_asset": "ETHEREUM-USDT",
    "customer_requested_amount": "100000000",
    "customer_pays_asset": "ETHEREUM-USDT",     // What the customer pays on confirmation
    "customer_pays_amount": "100000000",
    "customer_receives_asset": "USD",           // What the customer receives
    "customer_receives_amount": "9957",
    "customer_rate": "0.9957155299663593",      // Quoted rate, expressed as Base/Quote
    "quote_valid_until": "2026-07-13T07:24:31.928134Z", // Confirm before this time or the quote expires
    "quote_confirmed_at": null,
    "description": "Sell 100 USDT",
    "additional_details": "",
    "document_ids": [],
    "transaction_hash": "",
    "customer_pays_network_fee_asset": "",
    "customer_pays_network_fee_amount": null,
    "customer_pays_network_fee_account_id": "",
    "created_at": "2026-07-13T07:19:31.928134Z",
    "updated_at": "2026-07-13T07:19:31.928134Z"
  }
}

The quote will automatically expire if the order is not confirmed before quote_valid_until.

POST
/v1/crypto/order

Authorization

AuthorizationRequiredBearer <token>

Enter your token in the format: Bearer {token}

In: header

Request Body

application/jsonOptional
sideRequiredstring

Trade direction from the customer perspective: "buy" or "sell".

Value in: "buy" | "sell"
priorityRequiredstring

Supported values are "instant" only. Drives how quickly settlement is dispatched.

Value in: "instant"
railRequiredstring

The rail the trade flows through: "rfq".

Value in: "rfq"
symbolRequiredstring

The trading pair symbol, e.g. "USDT-USD".

base_assetRequiredstring

The currency in which the amount is made (e.g. USD, EUR, SGD)

quote_assetRequiredstring

The currency in which the amount is made (e.g. USD, EUR, SGD)

requested_assetRequiredstring

The currency in which the amount is made (e.g. USD, EUR, SGD)

requested_amountRequiredstring

The amount of money. Our API expect amount values to be in minor units - the smallest unit of a currency depending on the number of decimals. For example, USD has two decimals. So $10 is represented by 1000. JPY has no decimals, so ¥10 is 10.

customer_pays_account_idRequiredstring

Account the customer pays from. Must be owned by your legal entity.

customer_receives_account_idRequiredstring

Account the proceeds are delivered to. Must be owned by your legal entity.

descriptionstring
additional_detailsstring

Header Parameters

Idempotency-KeyRequiredstring

Response Body

Success response

transaction_idRequiredstring
curl -X POST "https://developer-api-staging.pavebank.dev/v1/crypto/order" \
  -H "Idempotency-Key: string" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "side": "buy",
    "priority": "instant",
    "rail": "rfq",
    "symbol": "string",
    "base_asset": "string",
    "quote_asset": "string",
    "requested_asset": "string",
    "requested_amount": "string",
    "customer_pays_account_id": "string",
    "customer_receives_account_id": "string",
    "description": "string",
    "additional_details": "string"
  }'
{
  "transaction_id": "string"
}

Get Balance Summary GET

Retrieves the balance summary for the given account ID, can be filtered by date.

Confirm Digital Asset Exchange PUT

Use this API to confirm and execute a Digital Asset Exchange quote that was created with the POST Create Digital Asset Exchange endpoint. The quote must be confirmed before it expires.