Create Quote

POST

/v2/send/quotes

• Staging
• Development

Create a new quote or return existing active quote if one exists

Authorizations

• X-API-Key
• X-API-Secret

Request Body ^required

object

corridorId

required

Corridor ID

string format: uuid

d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

userId

required

End user ID

string format: uuid

d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

amount

Source amount in base units with source decimals. e.g. 1.00 USDC = 1000000. Either amount or destinationAmount must be provided, but not both.

string

1000000

destinationAmount

Destination amount in base units with destination decimals. e.g. 100.00 PKR = 10000. Either amount or destinationAmount must be provided, but not both.

string

10000

recipientId

required

Recipient ID

string format: uuid

d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

walletAddress

required

Wallet address

string

0x1234567890abcdef1234567890abcdef12345678

Responses

201

Created successfully

Created quote details with exchange rate and fees

object

id

required

Quote ID

string format: uuid

organisationId

required

Organisation ID

string format: uuid

userId

required

User ID

string format: uuid

status

required

Quote status

string

Allowed values: pending accepted rejected expired

corridorId

required

Corridor ID

string format: uuid

sourceAmount

required

Source amount in base units (smallest unit). For USDC with 6 decimals: 1.00 USDC = 1000000

string

amountDecimals

required

Number of decimal places for source amount (e.g., 6 for USDC)

number

6

destinationAmount

required

Destination amount in base units (smallest unit). For PKR with 2 decimals: 1.00 PKR = 100

string

destinationAmountDecimals

required

Number of decimal places for destination amount (e.g., 2 for PKR)

number

2

recipientId

required

Recipient ID

string

expiresAt

Expiration date

string format: date-time

createdAt

Created date

string format: date-time

updatedAt

Updated date

string format: date-time

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error