Retrieve Exchange Rate and Create a Lock

Testing Env

https://stage-api.fintegence.io

GET

/v1/partner/get-lock

Retrieves current exchange rates and creates a rate lock for the exchange transaction.

The lock is valid for 60 seconds.

When called, this endpoint returns current rates and generates a unique lockId. This lock guarantees the quoted rate will remain unchanged during the confirmation window, allowing time to review and finalize the exchange without exposure to market fluctuation.

If the exchange is not finalized within 60 seconds, the lock expires. Call this endpoint again to obtain a new lockId before proceeding.

Lock Expiry

Rate locks expire after 60 seconds. Request a new lock if expiry occurs before exchange finalization.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Access Denied

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stage-api.fintegence.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"
}

Retrieve Exchange Rate

Create and Finalize an Exchange