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

tickerstringOptional

Currency ticker (e.g., btc)

networkstringOptional

Network ticker (e.g., btc, eth)

symbolstringOptional

Symbol representing the currency

namestringOptional

Full name of the currency

hasMemobooleanOptional

Indicates whether this currency supports memo/extraId

requireMemobooleanOptional

Indicates whether memo/extraId is required to complete transactions

isFiatbooleanOptional

Shows if the currency is fiat (e.g., USD)

isStablebooleanOptional

Indicates if the currency is a stablecoin

supportsFixedRatebooleanOptional

True if fixed-rate exchanges are supported

enabledbooleanOptional

Indicates if currency is currently available for use

imagestringOptional

URL to the currency icon

regexAddressstringOptional

Regular expression pattern for validating recipient addresses

addressExplorerstringOptional

Block explorer URL template for addresses (use {} as placeholder)

txExplorerstringOptional

Block explorer URL template for transactions (use {} as placeholder)

confirmationsintegerOptional

Number of required confirmations for incoming transactions

rankintegerOptional

Currency ranking priority (use for sorting in UI)

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

minnumberOptional

Minimum allowed amount for the exchange

maxnumber · nullableOptional

Maximum allowed amount for the exchange (null means no limit)

fromAmountnumberOptional

Requested amount to exchange

toAmountnumberOptional

Estimated amount to receive

fromCurrencystringOptional

Ticker of the source currency

toCurrencystringOptional

Ticker of the target currency

fromNetworkstringOptional

Source network

toNetworkstringOptional

Target network

amountFromUsdstringOptional

Amount in USD equivalent (source)

amountToUsdstringOptional

Amount in USD equivalent (target)

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

minnumberOptional

Minimum allowed amount for the exchange

maxnumber · nullableOptional

Maximum allowed amount for the exchange (null means no limit)

fromAmountnumberOptional

Requested amount to exchange

toAmountnumberOptional

Estimated amount to receive

fromCurrencystringOptional

Ticker of the source currency

toCurrencystringOptional

Ticker of the target currency

fromNetworkstringOptional

Source network

toNetworkstringOptional

Target network

amountFromUsdstringOptional

Amount in USD equivalent (source)

amountToUsdstringOptional

Amount in USD equivalent (target)

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

typestring · enumOptional

Type of the exchange

Possible values:

exchangeone ofOptional

or

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

totalintegerOptional

Total number of exchanges

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

idstringOptional

Unique exchange identifier

createdstring · date-timeOptional

Exchange creation timestamp

exchangeTypestring · enumOptional

Type of exchange

Possible values:

statusstring · enumOptional

Current exchange status

Possible values:

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

idstringOptional

Unique exchange identifier

createdstring · date-timeOptional

Exchange creation timestamp

exchangeTypestring · enumOptional

Type of exchange

Possible values:

statusstring · enumOptional

Current exchange status

Possible values:

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

hashtagAvailable currencies

hashtagExchange rate

hashtagPrivate exchange rate

hashtagExchange status

hashtagList of exchanges

hashtagStandard exchange status

hashtagPrivate exchange status

hashtagCreate standard exchange

hashtagCreate private exchange

hashtagRates

Available currencies

Exchange rate

Private exchange rate

Exchange status

List of exchanges

Standard exchange status

Private exchange status

Create standard exchange

Create private exchange

Rates