Retrieve Exchange Rate and Create a Lock

Testing Env

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

GET

/v1/partner/get-lock

Retrieves the current exchange rates and creates a rate lock for the partner 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 partner-initiated exchange transaction. When called, it returns the current rates for all supported currencies and generates a unique rate lock ID associated with the partner. This lock guarantees that the quoted rates will remain unchanged for 60 seconds, allowing the partner 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 partner 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

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Responses

🟢200Success

application/json

Body

🟠401Access Denied

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "id": "7f92b887-159f-4bbb-bb77-3078c0b9dd3d",
    "rates": {
        "btc": 101464.26399862,
        "doge": 0.2180131,
        "eth": 3739.63838808,
        "eur": 1,
        "ltc": 102.49595319,
        "pol": 0.20626987,
        "usdc": 0.850897
    },
    "feePercentage": 1.49,
    "createdAt": "2025-10-02T12:54:46.228Z",
    "validUntil": "2025-10-02T12:55:46.227Z"
}

Get Transaction History

Create and Finalize an Exchange