Cross Chain | Baltex Docs

Available currencies

get

Returns a list of available currencies for Cross-Chain exchanges.

Authorizations

x-api-keystringRequired

Responses

200

List of available currencies for cross-chain exchanges

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/cross-chain/available-currencies

GET /v1/cross-chain/available-currencies HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

[
  {
    "ticker": "btc",
    "network": "btc",
    "symbol": "btc",
    "name": "Bitcoin",
    "hasMemo": false,
    "requireMemo": false,
    "isFiat": false,
    "isStable": false,
    "supportsFixedRate": true,
    "enabled": true,
    "image": "https://baltex.io/uploads/btc.svg",
    "regexAddress": "^[13][a-km-zA-HJ-NP-Z1-9]{25,34}$|^[(bc1q)|(bc1p)][0-9A-Za-z]{37,62}$",
    "addressExplorer": "https://mempool.space/address/{}",
    "txExplorer": "https://mempool.space/tx/{}",
    "confirmations": 2,
    "rank": 0
  },
  {
    "ticker": "eth",
    "network": "eth",
    "symbol": "eth",
    "name": "Ethereum",
    "hasMemo": false,
    "requireMemo": false,
    "isFiat": false,
    "isStable": false,
    "supportsFixedRate": true,
    "enabled": true,
    "image": "https://baltex.io/uploads/eth.svg",
    "regexAddress": "^(0x)[0-9A-Fa-f]{40}$",
    "addressExplorer": "https://etherscan.io/address/{}",
    "txExplorer": "https://etherscan.io/tx/{}",
    "confirmations": 10,
    "rank": 0
  }
]

Exchange rate

get

Returns an exchange rate quote for the specified currencies and networks.

Authorizations

x-api-keystringRequired

Query parameters

fromCurrencystringRequired

Source currency ticker

fromNetworkstringRequired

Source network

toCurrencystringRequired

Target currency ticker

toNetworkstringRequired

Target network

amountstringOptional

Amount to exchange (default: 1)

flowstring · enumOptional

Exchange flow type (standard, fixed-rate)

Possible values:

Responses

200

Successful response with exchange rate data

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/cross-chain/rate

GET /v1/cross-chain/rate?fromCurrency=text&fromNetwork=text&toCurrency=text&toNetwork=text HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "min": 0.00701928,
  "max": 786.322508,
  "fromAmount": 1,
  "toAmount": 0.03649319,
  "fromCurrency": "eth",
  "toCurrency": "btc",
  "fromNetwork": "eth",
  "toNetwork": "btc",
  "amountFromUsd": "4264.38",
  "amountToUsd": "115832.83"
}

Private exchange rate

get

Returns a private exchange rate for the specified currencies and networks.

Authorizations

x-api-keystringRequired

Query parameters

fromCurrencystringRequired

Source currency ticker

fromNetworkstringRequired

Source network

toCurrencystringRequired

Target currency ticker

toNetworkstringRequired

Target network

amountstringOptional

Amount to exchange (default: 1)

privateTypestringRequired

Responses

200

Successful response with private exchange rate data

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/cross-chain/rate/private

GET /v1/cross-chain/rate/private?fromCurrency=text&fromNetwork=text&toCurrency=text&toNetwork=text&privateType=text HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "min": 0.00933292,
  "max": 126.59933868,
  "fromAmount": 2,
  "toAmount": 0.07250671,
  "fromCurrency": "eth",
  "toCurrency": "btc",
  "fromNetwork": "eth",
  "toNetwork": "btc",
  "amountFromUsd": "4264.38",
  "amountToUsd": "115832.83"
}

Exchange status

get

Returns the status of any type of exchange by its ID.

Authorizations

x-api-keystringRequired

Query parameters

idstringRequired

Exchange ID

Responses

200

Exchange status information

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/cross-chain/exchange/status

GET /v1/cross-chain/exchange/status?id=text HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "type": "standard",
  "exchange": {
    "id": "55a4e635719ff426",
    "created": "2025-10-13T19:09:03.355Z",
    "exchangeType": "standard",
    "status": "pending",
    "request": {
      "fromCurrency": "usdc",
      "fromNetwork": "eth",
      "toCurrency": "usdt",
      "toNetwork": "eth",
      "amountFromRequested": "100",
      "amountToRequested": "98.137725",
      "depositAddress": "0xABe4A5E47A135a926602aA9491Fa1a08C3cdbe6E",
      "recipientAddress": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
      "depositMemo": null,
      "recipientMemo": null,
      "refundAddress": null,
      "refundMemo": null,
      "flow": "standard"
    },
    "exchanges": [
      {
        "amountFromReceived": null,
        "amountToReceived": null,
        "status": "pending",
        "payinHash": null,
        "payoutHash": null,
        "created": "2025-10-13T19:09:14.670Z"
      }
    ]
  }
}

List of exchanges

get

Returns all exchanges for partner from the last 24 hours with optional filters.

Authorizations

x-api-keystringRequired

Query parameters

statusstring · enumOptional

Filter by exchange status

Possible values:

fromCurrencystringOptional

Filter by source currency ticker

fromNetworkstringOptional

Filter by source network

toCurrencystringOptional

Filter by target currency ticker

toNetworkstringOptional

Filter by target network

exchangeTypestring · enumOptional

Filter by exchange type

Possible values:

Responses

200

List of exchanges

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/cross-chain/exchange/list

GET /v1/cross-chain/exchange/list HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "total": 2,
  "data": [
    {
      "id": "52bd5457b095d079",
      "created": "2025-10-13T19:22:42.257Z",
      "exchangeType": "private",
      "status": "pending",
      "request": {
        "fromCurrency": "usdt",
        "fromNetwork": "eth",
        "toCurrency": "usdc",
        "toNetwork": "eth",
        "amountFromRequested": "1000",
        "amountToRequested": "988.28905436",
        "depositAddress": "0x9ee1936232399284cc7b9cef443db89827a62629",
        "depositMemo": null,
        "recipientAddress": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
        "recipientMemo": null,
        "refundAddress": null,
        "refundMemo": null
      },
      "exchanges": [
        {
          "amountFromReceived": "1000",
          "amountToReceived": "988.28905436",
          "status": "pending",
          "payinHash": null,
          "payoutHash": null,
          "created": "2025-10-13T19:22:43.716467+00:00"
        }
      ]
    },
    {
      "id": "55a4e635719ff426",
      "created": "2025-10-13T19:09:03.355Z",
      "exchangeType": "standard",
      "status": "pending",
      "request": {
        "fromCurrency": "usdc",
        "fromNetwork": "eth",
        "toCurrency": "usdt",
        "toNetwork": "eth",
        "amountFromRequested": "100",
        "amountToRequested": "98.137725",
        "depositAddress": "0xABe4A5E47A135a926602aA9491Fa1a08C3cdbe6E",
        "depositMemo": null,
        "recipientAddress": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
        "recipientMemo": null,
        "refundAddress": null,
        "refundMemo": null
      },
      "exchanges": [
        {
          "amountFromReceived": null,
          "amountToReceived": null,
          "status": "pending",
          "payinHash": null,
          "payoutHash": null,
          "created": "2025-10-13T19:09:14.67061+00:00"
        }
      ]
    }
  ]
}

Standard exchange status

get

Returns the status of a standard exchange by its ID.

Authorizations

x-api-keystringRequired

Query parameters

idstringRequired

Exchange ID

Responses

200

Standard exchange status

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/cross-chain/exchange/status/standard

GET /v1/cross-chain/exchange/status/standard?id=text HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "id": "55a4e635719ff426",
  "created": "2025-10-13T19:09:03.355Z",
  "exchangeType": "standard",
  "status": "pending",
  "request": {
    "fromCurrency": "usdc",
    "fromNetwork": "eth",
    "toCurrency": "usdt",
    "toNetwork": "eth",
    "amountFromRequested": "100",
    "amountToRequested": "98.137725",
    "depositAddress": "0xABe4A5E47A135a926602aA9491Fa1a08C3cdbe6E",
    "recipientAddress": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
    "depositMemo": null,
    "recipientMemo": null,
    "refundAddress": null,
    "refundMemo": null,
    "flow": "standard"
  },
  "exchanges": [
    {
      "amountFromReceived": null,
      "amountToReceived": null,
      "status": "pending",
      "payinHash": null,
      "payoutHash": null,
      "created": "2025-10-13T19:09:14.670Z"
    }
  ]
}

Private exchange status

get

Returns the status of a private exchange by its ID.

Authorizations

x-api-keystringRequired

Query parameters

idstringRequired

Exchange ID

Responses

200

Private exchange status

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/cross-chain/exchange/status/private

GET /v1/cross-chain/exchange/status/private?id=text HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "id": "52bd5457b095d079",
  "created": "2025-10-13T19:22:42.257Z",
  "exchangeType": "private",
  "status": "pending",
  "request": {
    "fromCurrency": "usdt",
    "fromNetwork": "eth",
    "toCurrency": "usdc",
    "toNetwork": "eth",
    "amountFromRequested": "1000",
    "amountToRequested": "988.28905436",
    "depositAddress": "0x9ee1936232399284cc7b9cef443db89827a62629",
    "depositMemo": null,
    "recipientAddress": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
    "recipientMemo": null,
    "refundAddress": null,
    "refundMemo": null,
    "flow": "standard"
  },
  "exchanges": [
    {
      "amountFromReceived": "1000",
      "amountToReceived": "988.28905436",
      "status": "pending",
      "payinHash": null,
      "payoutHash": null,
      "created": "2025-10-13T19:22:43.716Z"
    }
  ]
}

Create standard exchange

post

Creates a standard exchange.

Authorizations

x-api-keystringRequired

Body

fromCurrencystringRequired

Source currency ticker

toCurrencystringRequired

Target currency ticker

fromNetworkstringRequired

Source network

toNetworkstringRequired

Target network

fromAmountstringRequired

Amount to exchange

addressstringOptional

Recipient address

memostringOptional

Memo for recipient (if required)

refundAddressstringOptional

Refund address

refundMemostringOptional

Refund memo

flowstring · enumRequired

Exchange flow type

Possible values:

rateIdstringOptional

RateId is needed so that you can freeze the estimate from the /rate method for fixed-rate exchange. It is valid for 1 minute from the moment it is received.

Responses

201

Exchange created successfully

application/json

401

Unauthorized — missing or invalid API key

application/json

post

/v1/cross-chain/exchange

POST /v1/cross-chain/exchange HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "fromCurrency": "text",
  "toCurrency": "text",
  "fromNetwork": "text",
  "toNetwork": "text",
  "fromAmount": "text",
  "address": "text",
  "memo": "text",
  "refundAddress": "text",
  "refundMemo": "text",
  "flow": "standard",
  "rateId": "text"
}

{
  "id": "55a4e635719ff426",
  "status": "pending",
  "exchangeType": "standard",
  "created": "2025-10-13T19:09:03.355Z",
  "request": {
    "fromCurrency": "usdc",
    "fromNetwork": "eth",
    "toCurrency": "usdt",
    "toNetwork": "eth",
    "amountFromRequested": "100",
    "amountToRequested": "98.137725",
    "depositAddress": "0xABe4A5E47A135a926602aA9491Fa1a08C3cdbe6E",
    "recipientAddress": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
    "flow": "standard"
  },
  "exchanges": []
}

Create private exchange

post

Creates a private exchange order.

Authorizations

x-api-keystringRequired

Body

fromCurrencystringRequired

Source currency ticker

toCurrencystringRequired

Target currency ticker

fromNetworkstringRequired

Source network

toNetworkstringRequired

Target network

fromAmountstringRequired

Amount to exchange

memostringOptional

Extra ID for recipient (if required)

privateTypestringOptional

There are two types of private exchanges: 'privatePlus' - an intermediary network for XMR only; 'efficient' - the fastest and cheapest intermediary networks.

addressstringOptional

Recipient address

refundAddressstringOptional

Refund address

refundMemostringOptional

Extra ID for refund address (if required)

Responses

201

Private exchange created successfully

application/json

401

Unauthorized — missing or invalid API key

application/json

post

/v1/cross-chain/exchange/private

POST /v1/cross-chain/exchange/private HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 198

{
  "fromCurrency": "text",
  "toCurrency": "text",
  "fromNetwork": "text",
  "toNetwork": "text",
  "fromAmount": "text",
  "memo": "text",
  "privateType": "text",
  "address": "text",
  "refundAddress": "text",
  "refundMemo": "text"
}

{
  "id": "52bd5457b095d079",
  "created": "2025-10-13T19:22:42.257Z",
  "exchangeType": "private",
  "status": "pending",
  "request": {
    "fromCurrency": "usdt",
    "fromNetwork": "eth",
    "toCurrency": "usdc",
    "toNetwork": "eth",
    "amountFromRequested": "1000",
    "amountToRequested": "988.28905436",
    "depositAddress": "0x9ee1936232399284cc7b9cef443db89827a62629",
    "recipientAddress": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
    "flow": "standard"
  },
  "exchanges": []
}

Rates

get

Returns exchange rates in XML format. This is a publicly accessible endpoint that does not require authentication.

Responses

200

Exchange rates in XML format

No content

get

/v1/rates

GET /v1/rates HTTP/1.1
Host: api.baltex.io
Accept: */*

200

Exchange rates in XML format

No content