Create an exchange

POST

https://api.spreadefi.io/v1/exchanges

Opens a new exchange and returns a deposit address. Send the source
funds to address_from to start the swap.

Request

Body Params application/jsonRequired

Example

{
    "from": "btc",
    "to": "eth",
    "amount": "1",
    "address_to": "0x1a2b3c4d5e6f7890aBcDeF1234567890AbCdEf12",
    "fixed": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.spreadefi.io/v1/exchanges' \
--header 'Content-Type: application/json' \
--data '{
    "from": "btc",
    "to": "eth",
    "amount": "1",
    "address_to": "0x1a2b3c4d5e6f7890aBcDeF1234567890AbCdEf12",
    "fixed": false
}'

Responses

🟢201

application/json

Exchange created

Bodyapplication/json

Example

{
    "id": "exch_8f3k29dl01",
    "status": "waiting",
    "from": "btc",
    "to": "eth",
    "amount_from": "1",
    "amount_to": "15.83421",
    "address_from": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "extra_id_from": null,
    "address_to": "0x1a2b3c4d5e6f7890aBcDeF1234567890AbCdEf12",
    "extra_id_to": null,
    "tx_from": null,
    "tx_to": null,
    "rate": "15.83421",
    "fixed": false,
    "created_at": "2026-07-19T10:15:00Z",
    "expires_at": "2026-07-19T10:35:00Z",
    "updated_at": "2026-07-19T10:15:00Z"
}

🟠401Unauthorized

🟠422ValidationError

Estimate an exchange

List exchanges