Skip to content

Create Corridor Rate

POST
/v2/send/corridor-rates

Create a new corridor rate

X-API-Key
string

API Key

X-API-Secret
string

API Secret

object
corridor
required

Corridor name

string
USDC/PAK
stablecoinToFiatRateId
required

Foreign key to exchange_rate table for stablecoin-to-fiat rate

string format: uuid
e271bc5c-f870-44cd-8462-54280d0411f6
fiatToFiatRateId
required

Foreign key to exchange_rate table for fiat-to-fiat rate

string format: uuid
e271bc5c-f870-44cd-8462-54280d0411f6
toleranceMinRateBaseUnits
required

Minimum tolerance rate in base units (6 decimals). e.g., 990000 = 0.9900

string
990000
toleranceMaxRateBaseUnits
required

Maximum tolerance rate in base units (6 decimals). e.g., 1001000 = 1.0010

string
1001000

Corridor rate created successfully

object
corridorRateId
required

The corridor ID

string format: uuid
e271bc5c-f870-44cd-8462-54280d0411f6
corridorName
required

Corridor name

string
USDC/PAK
stablecoinToFiatRateBaseUnits
required

Stablecoin to intermediate fiat rate (e.g., USDC/USD) with 6 decimals of precision

string
1000000
fiatToFiatRateBaseUnits
required

Intermediate fiat to destination fiat rate (e.g., USD/PKR) with 6 decimals of precision

string
27850000
finalRateBaseUnits
required

Combined exchange rate (final USDC to destination fiat rate) with 6 decimals of precision

string
27850000
toleranceMinRateBaseUnits
required

Minimum tolerance rate in base units (6 decimals). Rate value for comparison, e.g., 990000 = 0.9900

string
990000
toleranceMaxRateBaseUnits
required

Maximum tolerance rate in base units (6 decimals). Rate value for comparison, e.g., 1001000 = 1.0010

string
1001000
calculatedAt
required

When this rate was calculated

string format: date-time
expiresAt
required

When this rate expires

string format: date-time

Bad Request

Unauthorized

Forbidden

Not Found

Internal Server Error