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 POST /exchange/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 (POST /exchange/execute) 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 an automated webhook notification sent to your configured endpoint.

Poll the GET /exchange/{exchangeId} endpoint at any time using the exchangeId.

Business logic errors (such as insufficient funds) are not checked at this stage. Processing occurs asynchronously. Use the Get Transfer Details endpoint to verify the final status and any errors.

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