Create and Finalize an Exchange

Testing Env

https://partner-api-stage.p100.io

POST

/v1/exchange

This endpoint executes a currency exchange for a user, converting a specified amount from one supported currency to another (e.g., BTC to EUR). You must provide a valid rate lock ID (from the 'Retrieve Exchange Rate and Create a Lock' endpoint) to guarantee the exchange rate. The request requires the user's external ID, amount, source and target currencies, and the lock ID. The system reserves the user's funds and associates the transaction with the locked rate. The response returns an exchange ID immediately, while the actual processing (including balance checks and compliance) occurs asynchronously. Use the exchange details endpoint to check the final status and any errors.

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.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://partner-api-stage.p100.io/v1/exchange' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
  "sourceExternalUserId": "75a1d530-3c12-44e8-a23a-0241b9e73c87",
  "amount": 1,
  "currencyFrom": "eur",
  "currencyTo": "eth",
  "lockId": "e850ae7b-b416-4991-a8e1-1811e6c77e18"
}'

Response Example

201 - Success

{
    "exchangeId": "3f0aeaa7-1177-4d77-9985-0cb987809801"
}

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠401Access Denied

🟠400P403: Validation error

🟠400P412: User not exist

🟠400P432: Invalid Exchange Lock

🟠400P457: Currencies cannot be the same

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

Retrieve Exchange Rate and Create a Lock

Retrieve Detailed Exchange Infromation