Retrieve Order Rate and Create a Lock

Testing Env

https://stage-api.fintegence.io

POST

/v1/order/lock-rate

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

The lock is valid for approximately 60 seconds.

When called, this endpoint returns current rates, calculates the exact payment-side amount needed to match the requested settlement amount, and generates a unique lockId. This lock guarantees the quoted settlement terms remain unchanged during the confirmation window, allowing time to place the order without exposure to market fluctuation.

If the order is not placed before the lock expires, call this endpoint again to obtain a new lockId before proceeding.

Lock Expiry

Rate locks expire after approximately 60 seconds. Request a new lock if expiry occurs before order placement.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Body Params application/json

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠400P403: Validation error

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠401Access Denied

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stage-api.fintegence.io/v1/order/lock-rate' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "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