MarketExchange team

June 9, 2026

~1 min read

The pairs section provides a method for obtaining information about a specific currency pair by its identifier. The method allows you to get the pair parameters necessary for calculating and executing the exchange.

GET

pairs/public

Endpoint URL

https://marketexchange.io/api/v2/pairs/public

Documentation

General Description

The request returns a list of active trading pairs (exchange directions) available in the Marketexchange system.

Each pair defines an exchange: which asset you send (instrumentFrom), which asset you receive (instrumentTo), and the available limits and reserves for this exchange.

HTTP Request

Method: GET
URL: https://marketexchange.io/api/v2/pairs/public

Request Example

curl -X 'GET' \
  'https://marketexchange.io/api/v2/pairs/public' \
  -H 'accept: application/json'

Request Parameters

Query Parameters

Parameter	Type	Description	Required
`instrumentFromCurrencyTitle`	string	Filter by source currency (e.g. `BTC`).	No
`instrumentFromNetworkTitle`	string	Filter by source network (e.g. `TRX`, `ERC20`).	No
`instrumentToCurrencyTitle`	string	Filter by target currency (e.g. `USDT`).	No
`instrumentToNetworkTitle`	string	Filter by target network (e.g. `TRC20`, `SOL`).	No
`limit`	number	Maximum number of results to return.	No
`offset`	number	Number of items to skip (used for pagination).	No

Response Format

The method returns a JSON array where each element is an instrument pair object.

Response Example

[
  {
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "currencyFriendlyTitle": "BTC",
      "slug": "btc",
      "precisionDecimals": 7,
      "reservesAmount": "104.35892",
      "instrumentType": "crypto",
      "bestChangeCurrencyName": "BTC",
      "currencyLogoLink": "https://marketexchange.io/assets/coins/btc.svg",
      "contractAddress": ""
    },
    "instrumentTo": {
      "currencyTitle": "XMR",
      "networkTitle": "XMR",
      "currencyFriendlyTitle": "XMR",
      "slug": "xmr",
      "precisionDecimals": 4,
      "reservesAmount": "24441.213",
      "instrumentType": "crypto",
      "bestChangeCurrencyName": "XMR",
      "currencyLogoLink": "https://marketexchange.io/assets/coins/xmr.svg",
      "contractAddress": ""
    },
    "isActive": true,
    "minAmount": "",
    "maxAmount": ""
  },
  {
    "instrumentFrom": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "currencyFriendlyTitle": "TRON",
      "slug": "trx",
      "precisionDecimals": 2,
      "reservesAmount": "33984708",
      "instrumentType": "crypto",
      "bestChangeCurrencyName": "TRX",
      "currencyLogoLink": "https://marketexchange.io/assets/coins/trx.svg",
      "contractAddress": ""
    },
    "instrumentTo": {
      "currencyTitle": "SOL",
      "networkTitle": "SOL",
      "currencyFriendlyTitle": "SOL",
      "slug": "sol",
      "precisionDecimals": 4,
      "reservesAmount": "70192.68",
      "instrumentType": "crypto",
      "bestChangeCurrencyName": "SOL",
      "currencyLogoLink": "https://marketexchange.io/assets/coins/sol.svg",
      "contractAddress": ""
    },
    "isActive": true,
    "minAmount": "",
    "maxAmount": ""
  },
  ...
]

Response Field Breakdown

Example of a Pair Object

{
  "instrumentFrom": {
    "currencyTitle": "TRX",
    "networkTitle": "TRX",
    "currencyFriendlyTitle": "TRON",
    "slug": "trx",
    "precisionDecimals": 2,
    "reservesAmount": "33984708",
    "instrumentType": "crypto",
    "bestChangeCurrencyName": "TRX",
    "currencyLogoLink": "https://marketexchange.io/assets/coins/trx.svg",
    "contractAddress": ""
  },
  "instrumentTo": {
    "currencyTitle": "SOL",
    "networkTitle": "SOL",
    "currencyFriendlyTitle": "SOL",
    "slug": "sol",
    "precisionDecimals": 4,
    "reservesAmount": "70192.68",
    "instrumentType": "crypto",
    "bestChangeCurrencyName": "SOL",
    "currencyLogoLink": "https://marketexchange.io/assets/coins/sol.svg",
    "contractAddress": ""
  },
  "isActive": true,
  "minAmount": "",
  "maxAmount": ""
}

Top-level Fields

Field	Type	Description
`instrumentFrom`	object	Source instrument object (what the user gives).
`instrumentTo`	object	Target instrument object (what the user receives).
`isActive`	boolean	The pair is active and available for exchange.
`minAmount`	string	Minimum exchange amount (can be empty).
`maxAmount`	string	Maximum exchange amount (can be empty).

Instrument Object Fields

Field	Type	Description
`currencyTitle`	string	Currency code (`BTC`, `SOL`, `TRX`).
`networkTitle`	string	Network code (`BTC`, `TRX`, `SOL`, `ERC20`, `TRC20`).
`currencyFriendlyTitle`	string	Human-readable currency name.
`slug`	string	Unique short identifier of the instrument for internal API use and links, e.g., `btc`, `trx`, `sol`. Makes filtering and working with instruments easier.
`precisionDecimals`	number	Number of decimal places.
`reservesAmount`	string	Amount of available currency/token for exchange, e.g., `104.35892` for BTC or `70192.68` for SOL. Used to check that the exchange for the requested amount is possible and to display limits to users.
`instrumentType`	string	Type of instrument(crypto, stablecoin, fiat, cash ). Allows filtering and handling different categories of assets.
`bestChangeCurrencyName`	string	Currency name on the BestChange aggregator, e.g., `BTC`, `TRX`, `SOL`. Useful for matching with external services and displaying to users.
`currencyLogoLink`	string	Currency logo.
`contractAddress`	string	Smart contract address (`0x1234567890abcdef1234567890abcdef12345678`) of the token on the blockchain (e.g., ERC20, TRC20). For native coins like BTC/TRX, the field is empty (`""`). Used to uniquely identify the token for integration.

Possible Use Cases

Preloading the list of pairs for caching.
Building a list of exchange directions.
Filtering parameters must be used for UI, as the endpoint returns large amounts of data by default.
Using limits and reserves to validate amounts.

Code Sample

Response Example

Try it out

Share this article:

Pairs API V2

Documentation

General Description

HTTP Request

Request Example

Request Parameters

Query Parameters

Response Format

Response Example

Response Field Breakdown

Example of a Pair Object

Top-level Fields

Instrument Object Fields

Possible Use Cases

Code Sample

Response Example

Try it out

Query Parameters

Headers