Crypto To Fiat

Operations for crypto to fiat conversions (off-ramp)

Request off-ramp quote

post

Generate a quote for converting cryptocurrency to fiat currency.

You can provide either an existing recipientId or create a new recipient by providing kycInformation and fiatSettlementDetails.

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

---

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:

• Provide EITHER recipientId OR both kycInformation and fiatSettlementDetails (not both options)

• If a recipientId is provided, the system will use the recipient's pre-configured settlement details

• If you provide kycInformation and fiatSettlementDetails, settlement details are provided inline

• KYC information is required for compliance with financial regulations

• Quotes have a limited validity period

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 the recipient to send funds to (provide either this OR kycInformation+fiatSettlementDetails)

Example: recipient-id

Responses

200

Off-ramp quote generated successfully

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid authentication

application/json

404

Not Found - Business not found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/offramp/quote

HTTPcURLJavaScriptPython

POST /v1/offramp/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"
}

Existing recipientInline KYC and settlement details

{
  "message": "Crypto-to-Fiat Quote requested",
  "transactionId": "67e55737b7b3b7bc1deb8977",
  "quote": {
    "provider": "Transfero",
    "providerRequestId": "0x006b09055cff301034ed164c81c56f8302a350d51210b8686f8d43a1fa13fc06",
    "fromToken": {
      "address": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
      "symbol": "USDC"
    },
    "toCurrency": "BRL",
    "fromAmount": "100",
    "toAmount": "590",
    "exchangeRate": "5.90",
    "fromAddress": "0x65dC5d3Dab013af752832a5B03De7Ae902aCF048",
    "estimatedDuration": 4
  },
  "approvalTxParams": {
    "from": "0x65dC5d3Dab013af752832a5B03De7Ae902aCF048",
    "to": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "gas": "0xe7db",
    "data": "0x095ea7b3000000000000000000000000af88d065e77c8cc2239327c5edb3a432268e583100000000000000000000000000000000000000000000000000000000000f4371",
    "value": "0x0",
    "nonce": 41
  },
  "transactionRequest": {
    "from": "0x65dC5d3Dab013af752832a5B03De7Ae902aCF048",
    "to": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "data": "0xa9059cbb000000000000000000000000f70da97812cb96acdf810712aa562db8dfa3dbef00000000000000000000000000000000000000000000000000000000000f4371006b09055cff301034ed164c81c56f8302a350d51210b8686f8d43a1fa13fc06",
    "value": "0",
    "chainId": 42161,
    "requestId": "0x006b09055cff301034ed164c81c56f8302a350d51210b8686f8d43a1fa13fc06",
    "maxFeePerGas": "0x2d8f0fc",
    "maxPriorityFeePerGas": "0x0"
  }
}

Get off-ramp status

get

Authentication

All API requests to orda require HMAC signatures using your project's client ID and client secret:

Required Headers

Header	Description
x-client-id	Your project's client ID
x-signature	HMAC-SHA256 signature derived from your client secret

The signature is an HMAC-SHA256 hash of the request body, using your Client Secret as the key.

---

Check the status of a crypto-to-fiat transaction.

Status Values:

• pending: The order has been created but crypto deposit has not been received yet

• processing: The crypto has been received and fiat conversion is in process

• completed: The fiat has been successfully sent to the recipient's bank account

• failed: The transaction failed

• refunded: The 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

transactionIdstringRequired

Reference ID of the off-ramp transaction

Example: ref-123456

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 successfully

application/json

400

Bad Request - Missing reference ID

application/json

401

Unauthorized - Missing or invalid API key

application/json

404

Not Found - Transaction not found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

get

/offramp/status

HTTPcURLJavaScriptPython

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

{
  "id": "order-67e6fb79b7b3",
  "status": "processing",
  "createdAt": "2025-01-15T12:34:56.789Z",
  "updatedAt": "2025-01-15T12:35:56.789Z",
  "depositAddress": "0x1234567890123456789012345678901234567890",
  "depositAmount": "100.0",
  "depositTxHash": "0x29623029145bffe2479c2d466bd95a01762ce3e852d826bb67975fa2d7bfc580",
  "withdrawalAmount": "99.5",
  "withdrawalDetails": {
    "bankAccountNumber": "****7890",
    "currency": "BRL",
    "status": "processing"
  }
}