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

Parameters

Header Parameters

X-API-Key

string

API Key

X-API-Secret

string

API Secret

Request Body ^required

object

corridorId

required

Corridor ID

string format: uuid

e271bc5c-f870-44cd-8462-54280d0411f6

userId

required

End user ID

string format: uuid

e271bc5c-f870-44cd-8462-54280d0411f6

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

e271bc5c-f870-44cd-8462-54280d0411f6

walletAddress

required

Wallet address

string

0x1234567890abcdef1234567890abcdef12345678

Responses

201

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