Skip to main content

​
Processing exchange callbacks

Exchange callbacks are sent whenever the status of an exchange created via the /exchange/fixed or /exchange/now endpoint changes. The callback format is the same for exchanges created with either endpoint. When you receive a callback with "status": "confirmed", the exchange has been successfully completed. At this stage, your balances for the affected currencies have already been updated. You can retrieve your current account balances via the /accounts/list endpoint.

​
Exchange callback payload example

Below is an example of a callback for a confirmed exchange: 
{
  "id": 134782394,
  "type": "exchange",
  "currency_sent": {
    "currency": "BTC",
    "amount": "0.00010000"
  },
  "currency_received": {
    "currency": "ETH",
    "amount": "0.00326418"
  },
  "transactions": [
    {
      "id": 9628634,
      "currency": "BTC",
      "currency_to": "ETH",
      "transaction_type": "exchange",
      "type": "exchange",
      "amount": "0.00010000",
      "amount_to": "0.00326418"
    }
  ],
  "fees": [
    {
      "type": "fee_crypto_exchange_to_crypto",
      "currency": "BTC",
      "amount": "0.00000200"
    }
  ],
  "error": "",
  "status": "confirmed"
}
Last modified on April 28, 2026