Create Corridor Rate

POST

/v2/send/corridor-rates

• Staging
• Development

Create a new corridor rate

Authorizations

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

Request Body ^required

object

corridor

required

Corridor name

string

USDC/PAK

stablecoinToFiatRateId

required

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

string format: uuid

82c4fce1-d2c7-48cb-a647-6993dbe37819

fiatToFiatRateId

required

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

string format: uuid

82c4fce1-d2c7-48cb-a647-6993dbe37819

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

Responses

201

Corridor rate created successfully

object

corridorRateId

required

The corridor ID

string format: uuid

82c4fce1-d2c7-48cb-a647-6993dbe37819

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

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error