Create and Finalize an Exchange

Executes a currency exchange using a pre-established rate lock.

This endpoint converts a specified amount from a source currency to a target currency at a guaranteed rate. A full list of available currency pairs can be found in the Supported Currencies guide.

Asynchronous Workflow

The exchange process is asynchronous and requires the following steps:

Create a Rate Lock: You must first call the Retrieve Exchange Rate and Create a Lock endpoint to obtain a valid rateLockId. This ID is mandatory to execute the exchange at the locked rate.

Execute the Exchange: Call this endpoint with the rateLockId and transaction details. The system validates the request, reserves the funds, and immediately returns an exchangeId.

Track Transaction Status: To determine the final status of the transaction (e.g., COMPLETED or FAILED), you can:

Listen for the automated Exchange Webhook.

Poll the Retrieve Detailed Exchange Information endpoint using the exchangeId.

Asynchronous Processing

Business logic errors (such as insufficient funds) are not checked immediately.
The API accepts the request and schedules it for processing. To verify the final outcome, check the payload of the incoming Webhook or call the details endpoint manually.

curl --location --request POST 'https://partner-api-stage.p100.io/v1/partner/exchange' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount": 10, "currencyFrom": "eth", "currencyTo": "eur", "lockId": "ee7b2f0f-0ffb-4fce-8fb3-66db2ca1f461" }'

Create and Finalize an Exchange

Asynchronous Workflow

Request

Responses

Create and Finalize an Exchange

Asynchronous Workflow#

Request

Responses

Asynchronous Workflow