Create Exchange

Executes a currency exchange between two supported assets using a pre-established rate lock.

You must provide a valid rate lock ID (obtained via Retrieve Exchange Rate and Create a Lock) to execute the transaction at the guaranteed rate. Currency codes (currencyFrom, currencyTo) should be provided as uppercase tickers.

Asynchronous Workflow

The exchange process is asynchronous and follows these steps:

Create a Rate Lock: Call Retrieve Exchange Rate and Create a Lock to obtain a valid lockId.

Execute the Exchange: Submit this request with the lockId, exchange amount, and target currency pair. The system validates the request structure and immediately returns a unique transactionId.

Track Status: Monitor the transaction until it reaches a terminal status (successful or unsuccessful):

Listen for real-time updates via the Exchange Webhook.

Poll Retrieve Exchange Details using the returned transactionId or your externalId.

Asynchronous Processing

Business logic checks (such as available balance verification) are performed asynchronously during execution.

A 200 OK response indicates that the request was successfully queued. Always verify the final outcome via webhooks or by querying Retrieve Exchange Details.

curl --location 'https://stage-api.fintegence.io/v1/partner/exchange' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "amount": 10, "currencyFrom": "DOGE", "currencyTo": "EUR", "lockId": "9c61a20a-824c-4025-827b-d4b7dd0de826" }'

Asynchronous Workflow

Request

Responses

Create Exchange

Asynchronous Workflow#

Request

Responses

Asynchronous Workflow