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 fiat currency amount (e.g., EUR) and a chosen 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 also includes the exact amount of cryptocurrency the user will receive at the locked rate.

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": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "rate": 0.9245,
    "amount": 92.45,
    "expiresAt": "2025-09-23T06:55:40Z",
    "cryptocurrency": "usdc",
    "network": "polygon"
}

Orders

Create and Finalize an Order