Retrieve Order Rate and Create a Lock

Testing Env

https://partner-api-stage.p100.io

POST

/v1/order/lock-rate

Locks the exchange rate for a specified settlement amount (e.g., EUR, USDC) and a chosen payment cryptocurrency.

Call this endpoint when you are ready to initiate a payment. The response will provide a unique identifier (lockId), which is valid for a limited time and must be used to place an order. The response calculates the exact amount of payment cryptocurrency required to match the requested settlement amount.

For a list of available currencies, see Supported Currencies.
If you only need to check the current rates without creating a lock, use the Get Rates endpoint instead.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠400P403: Validation error

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠401Access Denied

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://partner-api-stage.p100.io/v1/order/lock-rate' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "currency": "usdc",
    "amount": "346.59",
    "network": "polygon"
}'

Response Example

201 - Success

{
    "lockId": "aa1cb52d-4692-45b2-aadb-5a11ac221328",
    "amount": 412.607142,
    "rate": "0.84",
    "expiresAt": "2026-02-13T11:28:46.569Z",
    "currency": "usdc",
    "destinationCurrency": "eur",
    "network": "polygon"
}

Get Rates

Create and Finalize an Order