Crypto To Crypto

Operations for handling direct and cross-chain transactions

Request a quote

post

Authentication

All API requests to orda require HMAC signatures using your project's client ID and client secret. To authenticate your quote request the signature is a HMAC-SHA256 hash of the request body, using your Client Secret as the key. Never share your Client Secret or include it directly in your client-side code.

• Generate an x-signature header using your client secret.

• Include your x-client-id in the request headers.

Required Headers

Header	Description
x-client-id	Your project's client ID
x-signature	HMAC-SHA256 signature derived from your client secret
Content-Type	application/json for this request

---

Intent Specification: The quote request uses an intent object to specify the amount calculation method:

• usd: Calculate based on USD amount

• fromAmount: Calculate based on source token amount

• toAmount: Calculate based on destination token amount

Important Notes:

• Quotes are valid for 15 seconds

• Make sure you are using the correct token decimals for the token and chain when using toAmount and fromAmount intent methods

• Users should request new quotes frequently for accurate pricing

• The API uses rate limiting for all end points (10 requests per 5 minutes per project)

• You must provide either recipientId OR settlementDetails (not both)

Authorizations

ClientId & Signature & Timestamp

x-client-idstringRequired

Your project client ID from orda dashboard

x-signaturestringRequired

HMAC-SHA256 signature of canonical request body using your client secret

x-timestampstringRequired

Unix timestamp in milliseconds for replay protection (recommended)

Header parameters

x-client-idstringRequired

Your project client ID from orda dashboard

Default: prj_abc123def456ghi789Example: prj_abc123def456ghi789

x-signaturestringRequired

HMAC-SHA256 signature of canonical request body using your client secret

Default: a1b2c3d4e5f6789abc123def456ghi789abc123def456Example: a1b2c3d4e5f6789abc123def456ghi789abc123def456

x-timestampstringOptional

Unix timestamp in milliseconds for replay protection (recommended)

Default: 1704067200000Example: 1704067200000

Body

application/json

fromChainstringRequired

Source blockchain chain ID

Example: 42161

fromTokenstringRequired

Source token contract address

Example: 0xaf88d065e77c8cC2239327C5EDb3A432268e5831

fromAddressstringRequired

Source wallet address

Example: 0x742d35Cc6634C0532925a3b844Bc45426438f000

recipientIdstringOptional

The ID of an existing recipient to send funds to (provide either this OR settlementDetails)

Example: recipient-id

Responses

200

Quote generated successfully

application/json

400

Bad Request - Invalid or missing parameters

application/json

401

Unauthorized - Invalid API key or signature

application/json

404

Not Found - Business or recipient not found

application/json

429

Too Many Requests - Rate limit exceeded

application/json

500

Internal Server Error

application/json

post

/quote

HTTPcURLJavaScriptPython

POST /v1/quote HTTP/1.1
Host: api.orda.network
x-client-id: prj_abc123def456ghi789
x-signature: a1b2c3d4e5f6789abc123def456ghi789abc123def456
x-timestamp: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 206

{
  "fromChain": "42161",
  "fromToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "fromAddress": "0x742d35Cc6634C0532925a3b844Bc45426438f000",
  "intent": {
    "method": "usd",
    "value": "100"
  },
  "recipientId": "recipient-id"
}

USD-based quote with existing recipientQuote with inline settlement details

{
  "message": "Quote requested",
  "transactionId": "67e6fb79b7b3b7bc1deba5bb",
  "quote": {
    "provider": "Relay",
    "subProvider": "Relay",
    "provideRequestId": "0xe2d67270a28fa4985c3943482c6629f6492d22121557457f9ed93a9d71ea61f6",
    "fromToken": {
      "address": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
      "decimals": 6,
      "symbol": "USDC",
      "price": 0.9999769931209431,
      "chainId": 42161
    },
    "toToken": {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "symbol": "USDC",
      "price": 0.9999769838656899,
      "chainId": 8453
    },
    "fromAmount": "999701",
    "toAmount": "999299",
    "fromAddress": "0x742d35Cc6634C0532925a3b844Bc45426438f000",
    "toAddress": "0xEb773962B73e9b4d07dc747238C8a75C440973dB",
    "estimatedDuration": 4,
    "fees": {
      "bridge": {
        "amount": "402",
        "token": "USDC"
      },
      "gas": {
        "amount": "985",
        "token": "USDC"
      },
      "integrator": "0.000000",
      "maxSlippage": 0.0408
    }
  },
  "approvalTxParams": {
    "from": "0x742d35Cc6634C0532925a3b844Bc45426438f000",
    "to": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "gas": "0xe7db",
    "data": "0x095ea7b3000000000000000000000000af88d065e77c8cc2239327c5edb3a432268e583100000000000000000000000000000000000000000000000000000000000f4115",
    "value": "0x0",
    "nonce": 41
  },
  "transactionRequest": {
    "from": "0x742d35Cc6634C0532925a3b844Bc45426438f000",
    "to": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "data": "0xa9059cbb000000000000000000000000f70da97812cb96acdf810712aa562db8dfa3dbef00000000000000000000000000000000000000000000000000000000000f4371",
    "value": "0",
    "chainId": 42161,
    "requestId": "0x006b09055cff301034ed164c81c56f8302a350d51210b8686f8d43a1fa13fc06",
    "gas": "0xf257",
    "maxFeePerGas": "0x2d8f0fc",
    "maxPriorityFeePerGas": "0x0"
  }
}

Get transaction status

get

Retrieve the status of a transaction by transaction ID, source hash, or destination hash. At least one of these parameters must be provided.

Authentication

All API requests to orda require HMAC signatures using your project's client ID and client secret. The signature is a HMAC-SHA256 hash of the request body, using your Client Secret as the key. For the endpoints where there is no request body, use an empty string.

Required Headers

Header	Description
x-client-id	Your project's client ID
x-signature	HMAC-SHA256 signature derived from your client secret
Content-Type	application/json for this request

---

Status Values:

• Pending: Transaction submitted to blockchain

• In_progress: Cross-chain processing in progress

• Completed: Transaction completed successfully

• Failed: Transaction failed

• Refunded: Transaction was refunded

Authorizations

ClientId & Signature & Timestamp

x-client-idstringRequired

Your project client ID from orda dashboard

x-signaturestringRequired

HMAC-SHA256 signature of canonical request body using your client secret

x-timestampstringRequired

Unix timestamp in milliseconds for replay protection (recommended)

Query parameters

transactionIdstringOptional

Transaction ID from quote response

Example: 67299f9f617d20cb18b37640

sourceHashstringOptional

Source transaction hash

Example: 0x123...

destinationHashstringOptional

Destination transaction hash

Example: 0x456...

Header parameters

x-client-idstringRequired

Your project client ID from orda dashboard

Default: prj_abc123def456ghi789Example: prj_abc123def456ghi789

x-signaturestringRequired

HMAC-SHA256 signature of canonical request body using your client secret

Default: a1b2c3d4e5f6789abc123def456ghi789abc123def456Example: a1b2c3d4e5f6789abc123def456ghi789abc123def456

x-timestampstringOptional

Unix timestamp in milliseconds for replay protection (recommended)

Default: 1704067200000Example: 1704067200000

Responses

200

Transaction status retrieved

application/json

400

Bad request - Missing required parameters

application/json

401

Unauthorized - Invalid API key

application/json

404

Transaction not found

application/json

429

Too Many Requests - Rate limit exceeded

application/json

500

Internal Server Error

application/json

get

/status

HTTPcURLJavaScriptPython

GET /v1/status HTTP/1.1
Host: api.orda.network
x-client-id: prj_abc123def456ghi789
x-signature: a1b2c3d4e5f6789abc123def456ghi789abc123def456
x-timestamp: YOUR_API_KEY
Accept: */*

{
  "requestSuccess": true,
  "transaction": {
    "id": "67299f9f617d20cb18b37640",
    "status": "Pending",
    "type": "Direct",
    "fromChain": "8453",
    "toChain": "8453",
    "fromToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "toToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "fromAmount": "9992999",
    "usdAmount": 10,
    "sourceTransactionHash": "0x123...",
    "destinationTransactionHash": "0x456...",
    "createdAt": "2024-11-05T04:31:27.751Z",
    "updatedAt": "2024-11-05T04:31:27.751Z"
  }
}

List successful transactions

get

Returns all completed transactions for your business or specific recipient.

Authentication

All API requests to orda require HMAC signatures using your project's client ID and client secret. The signature is a HMAC-SHA256 hash of the request body, using your Client Secret as the key. For the endpoints where there is no request body, use an empty string.

Required Headers

Header	Description
x-client-id	Your project's client ID
x-signature	HMAC-SHA256 signature derived from your client secret
Content-Type	application/json for this request

---

Notes:

• Transactions are sorted by creation date (newest first)

• Results include both direct transfers and cross-chain swaps

• For recipient client IDs, only transactions related to that specific recipient are returned

Authorizations

ClientId & Signature & Timestamp

x-client-idstringRequired

Your project client ID from orda dashboard

x-signaturestringRequired

HMAC-SHA256 signature of canonical request body using your client secret

x-timestampstringRequired

Unix timestamp in milliseconds for replay protection (recommended)

Header parameters

x-client-idstringRequired

Your project client ID from orda dashboard

Default: prj_abc123def456ghi789Example: prj_abc123def456ghi789

x-signaturestringRequired

HMAC-SHA256 signature of canonical request body using your client secret

Default: a1b2c3d4e5f6789abc123def456ghi789abc123def456Example: a1b2c3d4e5f6789abc123def456ghi789abc123def456

x-timestampstringOptional

Unix timestamp in milliseconds for replay protection (recommended)

Default: 1704067200000Example: 1704067200000

Responses

200

Transactions retrieved successfully

application/json

400

Bad Request - API key is missing

application/json

401

Unauthorized - Invalid API key

application/json

404

Not Found - Business not found

application/json

429

Too Many Requests - Rate limit exceeded

application/json

500

Internal Server Error - Server error

application/json

get

/successful-transactions

HTTPcURLJavaScriptPython

GET /v1/successful-transactions HTTP/1.1
Host: api.orda.network
x-client-id: prj_abc123def456ghi789
x-signature: a1b2c3d4e5f6789abc123def456ghi789abc123def456
x-timestamp: YOUR_API_KEY
Accept: */*

[
  {
    "_id": "67d2ed97b7b3b7bc1deb5acc",
    "fromChain": "8453",
    "toChain": "42161",
    "fromToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "toToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "fromAmount": "999800",
    "toAmount": "999299",
    "usdAmount": 1,
    "fromAddress": "0xEb773962B73e9b4d07dc747238C8a75C440973dB",
    "toAddress": "0x34e90b6fa4bc74b92bb5743dcafa3b479cfbcecf",
    "type": "Relay",
    "fee": "501",
    "createdAt": "2025-03-13T14:37:11.349Z",
    "sourceTransactionHash": "0x29623029145bffe2479c2d466bd95a01762ce3e852d826bb67975fa2d7bfc580",
    "destinationTransactionHash": "0x29623029145bffe2479c2d466bd95a01762ce3e852d826bb67975fa2d7bfc580"
  }
]