Skip to main content
POST
/
swap
Execute swap
curl --request POST \
  --url https://processor-prod.up.railway.app/swap \
  --header 'Content-Type: application/json' \
  --header 'x-service-key: <api-key>' \
  --data '
{
  "wallet_id": "68bb7d8399900e253084e6f9",
  "receiver": "0x4ad21FA456Bb297f505B2718ba87ad63D8a95E6B",
  "from_asset": "solana:usdc",
  "to_asset": "base:usdc",
  "from_amount": -1,
  "to_amount": 100
}
'
{
  "success": true,
  "status": 200,
  "message": "Swap executed successfully",
  "timestamp": "2025-09-09T20:42:10.316Z",
  "data": {
    "hash": "0x8e935237667da1a673ea84cdaf1750ef9dddb125e075d20657f38b5223674da8",
    "link": "https://blockscan.com/tx/0x8e935237667da1a673ea84cdaf1750ef9dddb125e075d20657f38b5223674da8"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.bread.africa/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-service-key
string
header
required

Body

application/json
​
wallet_id
string
required

The wallet ID to swap from

Example:

"68bb7d8399900e253084e6f9"

​
receiver
string
required

The recipient address for the swapped assets

Example:

"0x4ad21FA456Bb297f505B2718ba87ad63D8a95E6B"

​
from_asset
enum<string>
required

The asset to swap from

Available options:
ethereum:usdc,
base:usdc,
arbitrum:usdc,
solana:usdc,
bsc:usdc,
polygon:usdc,
optimism:usdc,
avalanche:usdc,
ethereum:usdt,
arbitrum:usdt,
solana:usdt,
polygon:usdt,
bsc:usdt,
optimism:usdt,
avalanche:usdt,
base:cngn,
bsc:cngn
Example:

"solana:usdc"

​
to_asset
enum<string>
required

The asset to swap to

Available options:
ethereum:usdc,
base:usdc,
arbitrum:usdc,
solana:usdc,
bsc:usdc,
polygon:usdc,
optimism:usdc,
avalanche:usdc,
ethereum:usdt,
arbitrum:usdt,
solana:usdt,
polygon:usdt,
bsc:usdt,
optimism:usdt,
avalanche:usdt,
base:cngn,
bsc:cngn
Example:

"base:usdc"

​
from_amount
number

Amount to swap. Use -1 to swap all available balance.

Use this for EXACT INPUT swaps.

Example:

-1

​
to_amount
number

Amount of the to_asset you want to receive.

Use this for EXACT OUTPUT swaps.

Example:

100

Response

200 - application/json

Swap executed successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
Example:

"Swap executed successfully"

​
timestamp
string<date-time>
Example:

"2025-09-09T20:42:10.316Z"

​
data
object