Pairs API V2

团队 Quickex

2026年8月7日

~1 最小阅读量

部分提供了一种通过标识符获取特定币种对信息的方法。该方法允许您获取计算和执行兑换所需的币种对参数。

GET

pairs/public

Endpoint URL

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

Documentation

一般说明

该请求返回 Quickex 系统中可用的活跃交易对列表（兑换方向）。

每个交易对定义一次兑换：用户发送哪种资产（instrumentFrom）、用户接收哪种资产（instrumentTo），以及该兑换可用的限额和储备。

HTTP 请求

方法： GET
URL： https://quickex.io/api/v2/pairs/public

请求示例

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

请求参数

查询参数

参数	类型	说明	必填
`instrumentFromCurrencyTitle`	string	按源币种过滤（例如 `BTC`）。	否
`instrumentFromNetworkTitle`	string	按源网络过滤（例如 `TRX`、`ERC20`）。	否
`instrumentToCurrencyTitle`	string	按目标币种过滤（例如 `USDT`）。	否
`instrumentToNetworkTitle`	string	按目标网络过滤（例如 `TRC20`、`SOL`）。	否
`limit`	number	返回结果的最大数量。	否
`offset`	number	要跳过的项目数量（用于分页）。	否

响应格式

该方法返回一个 JSON 数组，其中每个元素都是一个交易工具对对象。

响应示例

[
  {
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "currencyFriendlyTitle": "BTC",
      "slug": "btc",
      "precisionDecimals": 7,
      "reservesAmount": "104.35892",
      "instrumentType": "crypto",
      "bestChangeCurrencyName": "BTC",
      "currencyLogoLink": "https://quickex.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://quickex.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://quickex.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://quickex.io/assets/coins/sol.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://quickex.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://quickex.io/assets/coins/sol.svg",
    "contractAddress": ""
  },
  "isActive": true,
  "minAmount": "",
  "maxAmount": ""
}

顶层字段

字段	类型	说明
`instrumentFrom`	object	源交易工具对象（用户支付的资产）。
`instrumentTo`	object	目标交易工具对象（用户接收的资产）。
`isActive`	boolean	该交易对处于活跃状态，可用于兑换。
`minAmount`	string	最小兑换金额（可以为空）。
`maxAmount`	string	最大兑换金额（可以为空）。

交易工具对象字段

字段	类型	说明
`currencyTitle`	string	币种代码（`BTC`、`SOL`、`TRX`）。
`networkTitle`	string	网络代码（`BTC`、`TRX`、`SOL`、`ERC20`、`TRC20`）。
`currencyFriendlyTitle`	string	便于用户阅读的币种名称。
`slug`	string	交易工具在内部 API 使用和链接中的唯一短标识符，例如 `btc`、`trx`、`sol`。它可以让交易工具的筛选和使用更加方便。
`precisionDecimals`	number	小数位数。
`reservesAmount`	string	可用于兑换的币种/代币数量，例如 BTC 的 `104.35892` 或 SOL 的 `70192.68`。用于检查所请求金额的兑换是否可行，并向用户显示限额。
`instrumentType`	string	交易工具类型（crypto、stablecoin、fiat、cash）。用于筛选和处理不同类别的资产。
`bestChangeCurrencyName`	string	BestChange 聚合器上的币种名称，例如 `BTC`、`TRX`、`SOL`。便于与外部服务匹配并向用户展示。
`currencyLogoLink`	string	币种图标。
`contractAddress`	string	代币在区块链上的智能合约地址（`0x1234567890abcdef1234567890abcdef12345678`）（例如 ERC20、TRC20）。对于 BTC/TRX 等原生币，该字段为空（`""`）。用于在集成中唯一识别代币。

可能的使用场景

预加载交易对列表以进行缓存。
构建兑换方向列表。
必须在 UI 中使用筛选参数，因为该端点默认会返回大量数据。
使用限额和储备来验证金额。

Code Sample

Response Example

Try it out

分享这篇文章：