Retrieve Exchange Rate and Create a Lock

Testing Env

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

GET

/v1/exchange/get-lock/{externalUserId}

Retrieves the current exchange rates and creates a rate lock for the specified user account. The rate lock is valid for 60 seconds.

This endpoint allows you to both preview the latest exchange rates and reserve (lock) a specific rate for a user-initiated exchange transaction. When called, it returns the current rates for all supported currencies and generates a unique rate lock ID associated with the user specified by externalUserId. This lock guarantees that the quoted rates will remain unchanged for 60 seconds, allowing the user to review and confirm the transaction without risk of rate fluctuation. If the exchange is not finalized within this time window, the lock expires and a new rate must be obtained. Use this endpoint before creating an exchange to ensure the user receives the expected rate, especially in volatile market conditions. The lock ID returned must be provided in the subsequent exchange request to finalize the transaction at the locked rate.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://partner-api-stage.p100.io/v1/exchange/get-lock/' \
--header 'x-api-key;'

Response Example

200 - Success

{
    "id": "407ea838-6e41-45ed-ae0f-84fb0f5d3863",
    "rates": {
        "btc": 101970.17793043,
        "doge": 0.20671822,
        "eth": 3329.10789425,
        "eur": 1,
        "ltc": 97.30869146,
        "pol": 0.20288041,
        "usdc": 0.858243,
        "usdt": 0.8582865811608077
    },
    "feePercentage": 1.49,
    "createdAt": "2025-07-28T11:24:46.312Z",
    "validUntil": "2025-07-28T11:25:46.310Z"
}

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Path Params

Responses

🟢200Success

application/json

Body

🟠401Access Denied

🟠400P412: User not exist

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

Retrieve Exchange Rate

Create and Finalize an Exchange