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:

• On the direct-transfer path the response message is Direct transfer transaction prepared (otherwise Quote requested)

• 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: 123e4567-e89b-12d3-a456-426614174000

Responses

200

Quote generated successfully

application/json

messagestringOptional

Status message

Example: Quote requested

transactionIdstringOptional

Transaction ID

Example: 550e8400-e29b-41d4-a716-446655440000

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: 230

{
  "fromChain": "42161",
  "fromToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "fromAddress": "0x742d35Cc6634C0532925a3b844Bc45426438f000",
  "intent": {
    "method": "usd",
    "value": "100"
  },
  "recipientId": "123e4567-e89b-12d3-a456-426614174000"
}

USD-based quote with existing recipientQuote with inline settlement details

{
  "message": "Quote requested",
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "quote": {
    "provider": "Relay",
    "subProvider": "Relay",
    "providerRequestId": "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",
    "gasPrice": "0x3b9aca00",
    "nonce": "0x1",
    "maxFeePerGas": "0x2d8f0fc",
    "maxPriorityFeePerGas": "0x0"
  },
  "feeTxParams": {
    "from": "0x742d35Cc6634C0532925a3b844Bc45426438f000",
    "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "gas": "0xb3e0",
    "gasPrice": "0x2d8f0fc",
    "data": "0xa9059cbb000000000000000000000000f70da97812cb96acdf810712aa562db8dfa3dbef00000000000000000000000000000000000000000000000000000000000003e8",
    "nonce": "0x29",
    "value": "0x0",
    "chainId": 8453
  },
  "providerQuoteDetails": {
    "fromAmount": "1000000",
    "toAmount": "999299",
    "isDirectTransfer": false,
    "provider": "Relay",
    "originalIntent": {
      "method": "usd",
      "value": "1"
    }
  }
}

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 GET or endpoints with no request body, use the string "{}" (canonical empty object) for the signature.

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:

• In_progress: Cross-chain processing in progress

• Completed: Transaction completed successfully

• Failed: Transaction failed (internally-expired transactions are reported as 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

transactionIdstring · uuidOptional

Transaction ID from quote response

Example: 550e8400-e29b-41d4-a716-446655440000

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

requestSuccessbooleanOptionalExample: true

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": "550e8400-e29b-41d4-a716-446655440000",
    "status": "Completed",
    "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 organization.

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 GET or endpoints with no request body, use the string "{}" (canonical empty object) for the signature.

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

• Scope is your entire organization; only Completed transactions 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

_idstringOptionalExample: 550e8400-e29b-41d4-a716-446655440000

fromChainstringOptionalExample: 8453

toChainstringOptionalExample: 42161

fromTokenstringOptionalExample: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

toTokenstringOptionalExample: 0xaf88d065e77c8cC2239327C5EDb3A432268e5831

fromAmountstringOptionalExample: 999800

toAmountstringOptionalExample: 999299

usdAmountnumberOptionalExample: 1

fromAddressstringOptionalExample: 0xEb773962B73e9b4d07dc747238C8a75C440973dB

toAddressstringOptionalExample: 0x34e90b6fa4bc74b92bb5743dcafa3b479cfbcecf

typestring · enumOptionalExample: RelayPossible values:

feestringOptionalExample: 501

createdAtstring · date-timeOptionalExample: 2025-03-13T14:37:11.349Z

sourceTransactionHashstringOptionalExample: 0x29623029145bffe2479c2d466bd95a01762ce3e852d826bb67975fa2d7bfc580

destinationTransactionHashstringOptionalExample: 0x29623029145bffe2479c2d466bd95a01762ce3e852d826bb67975fa2d7bfc580

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": "550e8400-e29b-41d4-a716-446655440000",
    "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"
  }
]