GET

orders

Endpoint URL

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

Documentation

Orders API V2

orders 部分包含用于创建订单以及向现有订单添加用户电子邮件的方法。通过可用方法，您可以通过创建订单来发起兑换，也可以添加电子邮件，以便接收有关订单状态的通知。

orders

一般说明

该方法返回用户创建的订单列表。

此端点返回特定合作伙伴/集成的订单历史记录。响应中的每个订单都对应于使用相同 X-Api-Public-Key 发起的创建请求。

该方法支持分页，并支持按创建时间排序。

HTTP 请求

方法： GET
URL（生产环境）： https://quickex.io/api/v2/orders/public

请求示例

curl -X 'GET' \
  'https://quickex.io/api/v2/orders?order=asc' \
  -H 'accept: application/json' \
  -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
  -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
  -H 'X-Api-Signature: {SIGNATURE}' \

签名公式：

StrToSign = timestamp + body + publicKey
Signature = Base64(HMAC_SHA256(StrToSign, secretKey))

请求头

请求头	必填	说明
Accept	是	推荐值：`application/json`。
X-Api-Public-Key	是	您的公开 API 密钥。
X-Api-Timestamp	是	时间戳（通常为 UNIX 毫秒），用于生成签名。
X-Api-Signature	是	请求签名（根据 API v2 方案使用 HMAC SHA256）。

请求参数

所有参数均通过 query string 传递。

查询参数

参数	类型	必填	说明
offset	int	否	从开头跳过的记录数量。用于分页。
limit	int	否	响应中返回的最大订单数量。用于分页。
order	string	否	按创建日期排序：`asc` — 从旧到新，`desc` — 从新到旧。默认值为 `desc`。

如果未指定 offset 和 limit，默认返回该合作伙伴的完整记录列表。

响应格式

该方法返回一个 JSON 数组，其中每个元素都是使用指定 API 密钥创建的订单对象。

响应示例

[
  {
    "orderId": 3209,
    "destinationAddress": "lnbc213490a70f987c097d897",
    "createdAt": "2025-12-10T15:15:32.394Z",
    "updatedAt": "2025-12-10T15:15:32.552Z",
    "destinationAddressMemo": null,
    "refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
    "refundAddressMemo": null,
    "claimedDepositAmount": "100",
    "claimedNetworkFee": "0.00002",
    "amountToGet": "0.00106686",
    "amountToGetUSDT": "98.15976599979",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "USDT",
    "instrumentFromNetworkTitle": "TRC20",
    "instrumentToCurrencyTitle": "BTC",
    "instrumentToNetworkTitle": "Lightning Network",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3208,
    "destinationAddress": "lnbc213490a70f987c097d897",
    "createdAt": "2025-12-10T15:12:05.830Z",
    "updatedAt": "2025-12-10T15:12:05.914Z",
    "destinationAddressMemo": null,
    "refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
    "refundAddressMemo": null,
    "claimedDepositAmount": "100",
    "claimedNetworkFee": "0.00002",
    "amountToGet": "0.0010655",
    "amountToGetUSDT": "98.15753399959",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "USDT",
    "instrumentFromNetworkTitle": "TRC20",
    "instrumentToCurrencyTitle": "BTC",
    "instrumentToNetworkTitle": "Lightning Network",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": false,
    "state": "created"
  }
]

响应字段说明

每个数组元素都是一个订单对象，包含以下信息：

字段	类型	说明
orderId	int	系统中的唯一订单 ID。
destinationAddress	string	兑换后资金将发送到的接收地址。
destinationAddressMemo	string / null	目标网络要求时使用的附加字段（memo/tag/payment ID）。
refundAddress	string / null	退款地址，仅用于固定汇率兑换中用户拒绝切换到浮动汇率，或因错误导致入金无效的情况。
refundAddressMemo	string / null	退款地址所需的 memo/tag。
createdAt	string（ISO datetime）	订单创建日期和时间。
updatedAt	string（ISO datetime）	订单最后更新日期和时间。
claimedDepositAmount	string	用户在计算器中输入的金额，或实际发送/存入的金额。
claimedNetworkFee	string	与交易相关的网络费用。如果网络实际扣除的费用发生变化（例如动态网络费用），`claimedNetworkFee` 可能与计算费用不同。
amountToGet	string	用户兑换后应收到的金额。
amountToGetUSDT	string	`amountToGet` 对应的 USDT 等值金额。
amountToWithdrawFact	string	实际发送给用户的金额。如果尚未发送，则为 0。
amountToWithdrawFactUSDT	string	`amountToWithdrawFact` 对应的 USDT 等值金额。
instrumentFromCurrencyTitle	string	入金币种。
instrumentFromNetworkTitle	string	入金网络。
instrumentToCurrencyTitle	string	用户应收到的币种。
instrumentToNetworkTitle	string	提现网络。
ip	string	用户 IP 地址。
geoCode	string	用户所在国家/地区的地理位置代码（ISO）。
markup	string	合作伙伴定义的兑换加价。这是合作伙伴获取收入或调整汇率的关键机制。该值由合作伙伴设置，可以为任意金额。
userEmail	string / null	用户电子邮件，如已提供。
completed	boolean	订单完成标志。
state	string	当前订单状态（created、kyc、trading、withdraw、refund）。

可能的使用场景

获取用户的完整订单历史记录。

Code Sample

Response Example

[
  {
    "orderId": 2096,
    "destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
    "createdAt": "2024-11-21T09:57:37.536Z",
    "updatedAt": "2024-11-21T09:57:37.536Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "11905.4",
    "claimedNetworkFee": "0.25",
    "amountToGet": "2000.535980286546",
    "amountToGetUSDT": "0",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TRX",
    "instrumentFromNetworkTitle": "TRX",
    "instrumentToCurrencyTitle": "XRP",
    "instrumentToNetworkTitle": "XRP",
    "ip": "165.22.73.162",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 2097,
    "destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
    "createdAt": "2024-11-21T09:57:56.849Z",
    "updatedAt": "2024-11-21T09:57:56.849Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "500",
    "claimedNetworkFee": "0.25",
    "amountToGet": "88.201060256891",
    "amountToGetUSDT": "0",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TRX",
    "instrumentFromNetworkTitle": "TRX",
    "instrumentToCurrencyTitle": "XRP",
    "instrumentToNetworkTitle": "XRP",
    "ip": "165.22.73.162",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3038,
    "destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
    "createdAt": "2025-04-28T13:15:03.006Z",
    "updatedAt": "2025-07-22T10:36:58.557Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "0.034268",
    "claimedNetworkFee": "1.5",
    "amountToGet": "3263.05",
    "amountToGetUSDT": "3263.058154",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "BTC",
    "instrumentFromNetworkTitle": "BTC",
    "instrumentToCurrencyTitle": "USDT",
    "instrumentToNetworkTitle": "TRC20",
    "ip": "45.76.90.73",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3172,
    "destinationAddress": "TPjT9p6UK5omA19h1QuYf4HbWvB9CukMzx",
    "createdAt": "2025-11-25T07:52:52.871Z",
    "updatedAt": "2025-11-27T11:34:19.690Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "52",
    "claimedNetworkFee": "2.054188275293",
    "amountToGet": "419.2",
    "amountToGetUSDT": "114.402051690569",
    "amountToWithdrawFact": "417.825363",
    "amountToWithdrawFactUSDT": "114.0245415627",
    "instrumentFromCurrencyTitle": "XRP",
    "instrumentFromNetworkTitle": "XRP",
    "instrumentToCurrencyTitle": "TRX",
    "instrumentToNetworkTitle": "TRX",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": true,
    "state": "withdraw"
  },
  {
    "orderId": 3192,
    "destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
    "createdAt": "2025-12-02T14:11:15.985Z",
    "updatedAt": "2025-12-02T14:11:16.107Z",
    "destinationAddressMemo": null,
    "refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
    "refundAddressMemo": null,
    "claimedDepositAmount": "3300",
    "claimedNetworkFee": "0.14",
    "amountToGet": "2363.663",
    "amountToGetUSDT": "4999.384629917638",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TON",
    "instrumentFromNetworkTitle": "TON",
    "instrumentToCurrencyTitle": "DOT",
    "instrumentToNetworkTitle": "DOT",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": null,
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3193,
    "destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
    "createdAt": "2025-12-02T14:14:34.356Z",
    "updatedAt": "2025-12-02T14:14:34.557Z",
    "destinationAddressMemo": null,
    "refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
    "refundAddressMemo": null,
    "claimedDepositAmount": "73",
    "claimedNetworkFee": "0.14",
    "amountToGet": "52.235",
    "amountToGetUSDT": "110.556162356583",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TON",
    "instrumentFromNetworkTitle": "TON",
    "instrumentToCurrencyTitle": "DOT",
    "instrumentToNetworkTitle": "DOT",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": null,
    "completed": false,
    "state": "created"
  }
]

Try it out

POST

orders/public/create

Endpoint URL

https://quickex.io/api/v2/orders/public/create

Documentation

一般说明

该请求会按预先确定的汇率创建兑换订单。汇率可以是 FIXED（在创建订单时锁定），也可以是 FLOATING（在订单完成前根据市场情况变化）。
该方法在通过 /api/v2/rates/public/one 获取汇率之后调用，并固定交易参数：交易工具、入金金额、汇率、目标地址、推荐信息、加价等。

HTTP 请求

方法： POST
URL： https://quickex.io/api/v2/orders/public/create

请求头

请求头	必填	说明
Accept	是	application/json
Content-Type	是	application/json
X-Api-Public-Key	是	您的公开 API 密钥
X-Api-Timestamp	是	任意时间戳（通常为毫秒）
X-Api-Signature	是	根据 API v2 公式生成的请求签名

签名公式：

StrToSign = timestamp + body + publicKey
Signature = Base64(HMAC_SHA256(StrToSign, secretKey))

请求示例（仅使用必填参数发起请求）

        curl -X 'POST' \
          'https://quickex.io/api/v2/orders/public/create' \
          -H 'Accept: application/json' \
          -H 'Content-Type: application/json' \
          -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
          -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
          -H 'X-Api-Signature: {SIGNATURE}' \
          -d '{
            "instrumentFrom": {
              "currencyTitle": "TON",
              "networkTitle": "TON"
            },
            "instrumentTo": {
              "currencyTitle": "DOT",
              "networkTitle": "DOT"
            },
            "destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
            "refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
            "claimedDepositAmount": "73"
          }'

请求示例

        curl -X 'POST' \
          'https://quickex.io/api/v2/orders/public/create' \
          -H 'Accept: application/json' \
          -H 'Content-Type: application/json' \
          -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
          -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
          -H 'X-Api-Signature: {SIGNATURE}' \
          -d '{
          "instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20"},
          "instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" },
          "destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
          "destinationAddressMemo": null,
          "refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
          "refundAddressMemo": null,
          "claimedDepositAmount": "3300",
          "claimedPublicRate": {
            "price": "0.014271620139287839394",
            "updatedAt": "2024-02-13T14:43:12.983Z",
            "claimedAmountToReceive": "47.09634645964987"
          },
          "claimedNetworkFee": "0.001",
          "userEmail": "test@example.com",
          "referrerId": "aff_some-affiliate-id",
          "markupAffiliateId": "aff_some-affiliate-id",
          "rateMode": "FLOATING",
          "utmData": {},
          "browserFingerprint": "string",
          "markup": "0.01",
          "mercuryoBearerToken": "string",
          "locale": "string"
        }'

请求参数

参数通过 request body（JSON） 传递。

必填参数

字段	类型	必填	说明
instrumentFrom	object	是	源交易工具（用户要支付的资产）。
instrumentFrom.currencyTitle	string	是	用户发送的币种代码（例如 USDT）。
instrumentFrom.networkTitle	string	是	源交易工具所在网络（例如 TRC20）。
instrumentTo	object	是	目标交易工具（用户将收到的资产）。
instrumentTo.currencyTitle	string	是	目标币种代码（例如 LTC）。
instrumentTo.networkTitle	string	是	目标交易工具所在网络（例如 LTC）。
destinationAddress	string	是	兑换成功后资金将发送到的地址。
destinationAddressMemo	string	否	目标地址的 Memo/Tag/Comment（如果网络要求）。
refundAddress	string	是	退款地址，仅用于固定汇率兑换中用户拒绝切换为浮动汇率的情况。
refundAddressMemo	string	否	退款地址的 Memo/Tag（如果网络要求）。
claimedDepositAmount	string	是	用户承诺发送的入金金额。
claimedPublicRate	object	否	从 /rates/public/one 复制的汇率及相关参数。
claimedPublicRate.price	string	否	用于计算兑换的汇率。
claimedPublicRate.updatedAt	string	否	该汇率有效时的时间戳（ISO8601）。
claimedPublicRate.claimedAmountToReceive	string	否	按该汇率计算出的用户将收到的金额。
claimedNetworkFee	string	否	计算中包含的网络费用（如适用）。
userEmail	string	否	用于通知的用户电子邮件。
referrerId	string	否	推荐该用户的推荐人或合作伙伴 ID。示例：`"1523"`。
markupAffiliateId	string	否	与加价相关的合作伙伴 ID。
rateMode	string	否	兑换汇率模式： FIXED — 汇率在创建订单时锁定；市场汇率的任何变化都不会影响最终收到的金额。 FLOATING — 汇率可能会根据当前市场情况变化，直到订单完成。
browserFingerprint	string	否	用于额外保护/分析的浏览器指纹。
markup	string	否	合作伙伴加价（1%）。
locale	string	否	用户语言环境（例如 en、ru），用于邮件/UI 模板。

响应格式

该方法返回一个 JSON 对象，用于描述已创建的订单、入金地址以及当前的入金/出金信息。

完整响应示例

        {
          "deposits": [
            {
              "createdAt": "2025-12-02T08:52:08.178Z",
              "instrument": {
                "currencyTitle": "USDT",
                "networkTitle": "TRC20"
              },
              "amount": "1000.1",
              "confirmations": 0,
              "txId": "0xdeadc0dedeadbeef",
              "depositAddress": "0xdeadc0de",
              "isPending": true,
              "id": 0,
              "counterPartyAddress": "0xdeadc0dedeadbeef"
            }
          ],
          "withdrawals": [
            {
              "createdAt": "2025-12-02T08:52:08.178Z",
              "instrument": {
                "currencyTitle": "USDT",
                "networkTitle": "TRC20"
              },
              "amount": "1000.1",
              "networkFee": "1.1",
              "txId": "0xdeadc0dedeadbeef"
            }
          ],
          "depositAddress": {
            "orderId": 0,
            "liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
            "instrument": {
              "currencyTitle": "USDT",
              "networkTitle": "TRC20"
            },
            "depositAddress": "0xdeadc0de",
            "depositAddressMemo": "string",
            "redirectUrl": "string"
          },
          "orderId": 0,
          "userId": 0,
          "legacyOrderId": "string",
          "pair": {
            "instrumentFrom": {
              "currencyTitle": "USDT",
              "networkTitle": "TRC20"
            },
            "instrumentTo": {
              "currencyTitle": "USDT",
              "networkTitle": "TRC20"
            }
          },
          "createdAt": "2025-12-02T08:52:08.179Z",
          "claimedDepositAmount": "10.01",
          "amountToGet": "10.01",
          "claimedPublicRate": {
            "price": "1000.1",
            "quotes": {
              "sellQuote": {
                "baseValue": "1000.1",
                "quoteValue": "1000.1"
              },
              "buyQuote": {
                "baseValue": "1000.1",
                "quoteValue": "1000.1"
              }
            },
            "updatedAt": "2025-12-02T08:52:08.179Z",
            "liquidityProviderPublicCode": "formulae",
            "claimedAmountToReceive": "0.01",
            "finalNetworkFeeAmount": "0.01",
            "platformFee_Absolute": "0.01",
            "fixedRate_maxAmount": "1000.000",
            "fixedRate_maxTimeMinutes": 1,
            "fixedRate_maxRateVolatilityPercent": "1000.000"
          },
          "claimedNetworkFee": "10.01",
          "KYCFormLink": "string",
          "orderEvents": [
            {
              "kind": "TRACKING_STARTED",
              "createdAt": "2025-12-02T08:52:08.179Z"
            }
          ],
          "userEmail": "test@example.com",
          "rateMode": "FLOATING",
          "destinationAddress": "0xdeadbeef",
          "destinationAddressMemo": "0xdeadbeef",
          "completed": false,
          "possibleCashbackAmountUSDT": "500.00",
          "redirectUrl": "https://payments.mercuryo.io/",
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }

响应字段说明

入金（deposits）

        "deposits": [
          {
            "createdAt": "2025-12-02T08:44:15.824Z",
            "instrument": {
              "currencyTitle": "USDT",
              "networkTitle": "TRC20"
            },
            "amount": "1000.1",
            "confirmations": 0,
            "txId": "0xdeadc0dedeadbeef",
            "depositAddress": "0xdeadc0de",
            "isPending": true,
            "id": 0,
            "counterPartyAddress": "0xdeadc0dedeadbeef"
          }
        ]

字段	类型	说明
deposits	array	该订单的入金列表（如果用户只进行了一次转账，通常为 0 或 1 条记录）。
createdAt	string	入金登记时间。
instrument	object	入金所使用的交易工具（币种和网络）。
instrument.currencyTitle	string	入金币种代码（USDT）。
instrument.networkTitle	string	入金网络（TRC20）。
amount	string	入金金额。
confirmations	number	该笔入金的网络确认数量。
txId	string	区块链上的入金交易哈希。
depositAddress	string	入金发送到的地址（Quickex/提供商入金地址）。
isPending	boolean	表示入金是否仍在等待足够的确认。
id	number	内部入金记录 ID。
counterPartyAddress	string	发送方地址（用户钱包或资金来源）。

出金（withdrawals）

        "withdrawals": [
          {
            "createdAt": "2025-12-02T08:44:15.825Z",
            "instrument": {
              "currencyTitle": "USDT",
              "networkTitle": "TRC20"
            },
            "amount": "1000.1",
            "networkFee": "1.1",
            "txId": "0xdeadc0dedeadbeef"
          }
        ]

字段	类型	说明
withdrawals	array	发送给用户的出金列表。
createdAt	string	出金发起或登记时间。
instrument	object	出金交易工具（币种/网络）。
amount	string	发送给用户的出金金额。
networkFee	string	出金过程中扣除的网络费用。
txId	string	出金的区块链交易哈希。

入金地址（depositAddress）

       "depositAddress": {
          "orderId": 0,
          "liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
          "instrument": {
            "currencyTitle": "USDT",
            "networkTitle": "TRC20"
          },
          "depositAddress": "0xdeadc0de",
          "depositAddressMemo": "string",
          "redirectUrl": "string"
        }

字段	类型	说明
orderId	number	与该入金地址关联的订单 ID。
liquidityProviderTitle	string	流动性提供商或入金接收方案的名称。
instrument	object	入金交易工具（币种/网络）。
depositAddress	string	用户应发送资金的入金地址。
depositAddressMemo	string	入金所需的 Memo/Tag/Comment（如果网络要求）。
redirectUrl	string	重定向 URL（如果使用外部支付提供商/组件）。

订单通用信息

        "orderId": 0,
        "userId": 0,
        "legacyOrderId": "string",
        "pair": {
          "instrumentFrom": {
            "currencyTitle": "USDT",
            "networkTitle": "TRC20"
          },
          "instrumentTo": {
            "currencyTitle": "USDT",
            "networkTitle": "TRC20"
          }
        },
        "createdAt": "2025-12-02T08:44:15.825Z",
        "claimedDepositAmount": "10.01",
        "amountToGet": "10.01"

字段	类型	说明
orderId	number	Quickex 系统中的唯一订单 ID。
userId	number	用户 ID（如果订单绑定到账户）。
pair	object	订单的币种对：源（入金）币种和目标（接收）币种。
pair.instrumentFrom	object	源交易工具（用户支付的资产）。
pair.instrumentTo	object	目标交易工具（用户收到的资产）。
createdAt	string	订单创建时间。
claimedDepositAmount	string	创建订单时使用的入金金额。
amountToGet	string	用户应从该订单中收到的金额。

claimedPublicRate 区块

         "claimedPublicRate": {
          "price": "1000.1",
          "quotes": {
            "sellQuote": {
              "baseValue": "1000.1",
              "quoteValue": "1000.1"
            },
            "buyQuote": {
              "baseValue": "1000.1",
              "quoteValue": "1000.1"
            }
          }
        }

字段	类型	说明
claimedPublicRate	object	用于创建订单的汇率和报价。通常是 /rates/public/one 的副本或子集。
claimedPublicRate.price	string	用于计算 claimedDepositAmount 和 amountToGet 的汇率。
claimedPublicRate.quotes	object	用于调试和分析的详细报价（sell/buy）。
sellQuote.baseValue	string	基础值（基础资产数量）。
sellQuote.quoteValue	string	对应的报价值。
buyQuote.baseValue	string	买入操作的基础值。
buyQuote.quoteValue	string	对应的报价值。

可能的使用场景

在获取预估汇率后，从您的前端、机器人或集成系统中创建订单。

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-12-02T08:52:08.178Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-12-02T08:52:08.178Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "networkFee": "1.1",
      "txId": "0xdeadc0dedeadbeef"
    }
  ],
  "depositAddress": {
    "orderId": 0,
    "liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
    "instrument": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "depositAddress": "0xdeadc0de",
    "depositAddressMemo": "string",
    "redirectUrl": "string"
  },
  "orderId": 0,
  "userId": 0,
  "legacyOrderId": "string",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    }
  },
  "createdAt": "2025-12-02T08:52:08.179Z",
  "claimedDepositAmount": "10.01",
  "amountToGet": "10.01",
  "claimedPublicRate": {
    "price": "1000.1",
    "quotes": {
      "sellQuote": {
        "baseValue": "1000.1",
        "quoteValue": "1000.1"
      },
      "buyQuote": {
        "baseValue": "1000.1",
        "quoteValue": "1000.1"
      }
    },
    "updatedAt": "2025-12-02T08:52:08.179Z",
    "liquidityProviderPublicCode": "formulae",
    "claimedAmountToReceive": "0.01",
    "finalNetworkFeeAmount": "0.01",
    "platformFee_Absolute": "0.01",
    "fixedRate_maxAmount": "1000.000",
    "fixedRate_maxTimeMinutes": 1,
    "fixedRate_maxRateVolatilityPercent": "1000.000"
  },
  "claimedNetworkFee": "10.01",
  "KYCFormLink": "string",
  "orderEvents": [
    {
      "kind": "TRACKING_STARTED",
      "createdAt": "2025-12-02T08:52:08.179Z"
    }
  ],
  "userEmail": "test@example.com",
  "rateMode": "FLOATING",
  "destinationAddress": "0xdeadbeef",
  "destinationAddressMemo": "0xdeadbeef",
  "completed": false,
  "possibleCashbackAmountUSDT": "500.00",
  "redirectUrl": "https://payments.mercuryo.io/",
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

Try it out

POST

orders/public/set-email

Endpoint URL

https://quickex.io/api/v2/orders/public/set-email

Documentation

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-12-02T09:31:46.246Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-12-02T09:31:46.246Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "networkFee": "1.1",
      "txId": "0xdeadc0dedeadbeef"
    }
  ],
  "depositAddress": {
    "orderId": 0,
    "liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
    "instrument": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "depositAddress": "0xdeadc0de",
    "depositAddressMemo": "string",
    "redirectUrl": "string"
  },
  "orderId": 0,
  "userId": 0,
  "legacyOrderId": "string",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    }
  },
  "createdAt": "2025-12-02T09:31:46.246Z",
  "claimedDepositAmount": "10.01",
  "amountToGet": "10.01",
  "claimedPublicRate": {
    "price": "1000.1",
    "quotes": {
      "sellQuote": {
        "baseValue": "1000.1",
        "quoteValue": "1000.1"
      },
      "buyQuote": {
        "baseValue": "1000.1",
        "quoteValue": "1000.1"
      }
    },
    "updatedAt": "2025-12-02T09:31:46.246Z",
    "liquidityProviderPublicCode": "formulae",
    "claimedAmountToReceive": "0.01",
    "finalNetworkFeeAmount": "0.01",
    "platformFee_Absolute": "0.01",
    "fixedRate_maxAmount": "1000.000",
    "fixedRate_maxTimeMinutes": 1,
    "fixedRate_maxRateVolatilityPercent": "1000.000"
  },
  "claimedNetworkFee": "10.01",
  "KYCFormLink": "string",
  "orderEvents": [
    {
      "kind": "TRACKING_STARTED",
      "createdAt": "2025-12-02T09:31:46.246Z"
    }
  ],
  "userEmail": "QA@example.com",
  "rateMode": "FLOATING",
  "destinationAddress": "0xdeadbeef",
  "destinationAddressMemo": "0xdeadbeef",
  "completed": false,
  "possibleCashbackAmountUSDT": "500.00",
  "redirectUrl": "https://payments.mercuryo.io/",
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

Try it out

GET

orders/public-info

Endpoint URL

https://quickex.io/api/v2/orders/public-info

Documentation

一般说明

此方法通过 orderId 返回特定订单的详细信息。
与订单列表（GET /api/v2/orders）不同，它会提供与所选订单相关的全部数据：
包含完整的交易工具对及其参数、固定汇率（claimedPublicRate）、
确认限制、事件历史（orderEvents）、入金地址，
以及潜在返现或推荐奖励累积信息和完成状态。
订单访问受当前 API 密钥限制——您只能查看使用您的 X-Api-Public-Key 创建的订单。

HTTP 请求

方法： GET
URL： https://quickex.io/api/v2/orders/public-info

请求示例

curl -X 'GET' \
  'https://quickex.io/api/v2/orders/public-info?orderId=3038' \
  -H 'accept: application/json' \
  -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
  -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
  -H 'X-Api-Signature: {SIGNATURE}'

请求头

请求头	必填	说明
Accept	是	推荐值：`application/json`。
X-Api-Public-Key	是	您的公开 API 密钥。
X-Api-Timestamp	是	时间戳（通常为 UNIX 毫秒），包含在签名中。
X-Api-Signature	是	请求签名（根据 API v2 方案使用 HMAC SHA256）。

请求参数

查询参数

参数	类型	必填	说明
orderId	int	是	需要查询信息的订单标识符。

响应格式

该方法返回一个包含订单完整信息的 JSON 对象。

响应示例

{
  "orderId": 174059,
  "legacyOrderId": "602184da-5881-408e-bffa-3562702d7d3e",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "createdAt": "2025-12-15T14:38:40.523Z",
  "instrumentFromCurrencyTitle": "XRP",
  "instrumentFromNetworkTitle": "XRP",
  "instrumentToCurrencyTitle": "TRX",
  "instrumentToNetworkTitle": "TRX",
  "feeMode": "FIXED",
  "userId": 2382,
  "userEmail": "sam.white@support.example.io",
  "isPlatformEmail": false,
  "refundAddress": "rNFSruW9B1NwVoGgUMmfwXbruWMp8Mgv3K",
  "refundAddressMemo": null,
  "destinationAddress": "TWRW8YiZtjW7JkYxxzuPrN9fQzoDK5FHgm",
  "destinationAddressMemo": null,
  "claimedNetworkFee": "1.987665024814",
  "rateMode": "FIXED",
  "claimedDepositAmount": "57",
  "amountToGet": "393.07",
  "platformFee": "3.86",
  "redirectUrl": null,
  "orderEvents": [
    {
      "createdAt": "2025-12-15T14:42:43.317Z",
      "kind": "WITHDRAWAL_COMPLETED"
    },
    {
      "createdAt": "2025-12-15T14:41:54.109Z",
      "kind": "FUNDS_WITHDRAWAL_START"
    },
    {
      "createdAt": "2025-12-15T14:41:00.379Z",
      "kind": "DEPOSIT_REGISTERED"
    },
    {
      "createdAt": "2025-12-15T14:39:58.760Z",
      "kind": "INCOMING_FUNDS_DETECTED"
    },
    {
      "createdAt": "2025-12-15T14:38:41.642Z",
      "kind": "CREATION_END"
    }
  ],
  "depositAddress": {
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
    "depositAddressMemo": "2097040307"
  },
  "deposits": [
    {
      "id": 50958,
      "counterPartyAddress": null,
      "createdAt": "2025-12-15T14:39:45.000Z",
      "instrument": {
        "currencyTitle": "XRP",
        "networkTitle": "XRP"
      },
      "amount": "57",
      "amountUSDT": "112.40742",
      "txId": "DEA15CCF7AF04799A090298CB06D78DD177B3B518BED9C9DE8A0A5B717CCDBE7",
      "confirmations": 12,
      "depositAddress": {
        "instrument": {
          "currencyTitle": "XRP",
          "networkTitle": "XRP"
        },
        "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
        "depositAddressMemo": "2097040307"
      },
      "isPending": false
    }
  ],
  "withdrawals": [
    {
      "instrument": {
        "currencyTitle": "TRX",
        "networkTitle": "TRC20"
      },
      "amount": "393.07",
      "txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
      "createdAt": "2025-12-15T14:41:58.926Z",
      "networkFee": "1.98"
    }
  ],
  "KYCFormLink": null,
  "liquidityProviderPublicCode": "hat",
  "possibleRefferalAccrualAmount": "0.78",
  "possibleCashbackAmountUSDT": "0.22",
  "actualCashbackAmountUSDT": "0.22",
  "claimedPublicRate": {
    "claimedAmountToReceive": "393.07",
    "finalNetworkFeeAmount": "1.9876650248138958",
    "platformFee_Absolute": null,
    "price": "7.000992555831266",
    "quotes": {
      "sellQuote": {
        "baseValue": "0.2821",
        "quoteValue": "1.9453930016929823"
      },
      "buyQuote": {
        "baseValue": "1.97499",
        "quoteValue": "0.2777753832835882"
      }
    },
    "updatedAt": "2025-12-15T14:38:36.201Z",
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "completed": true,
  "minConfirmationsToTrade": 12,
  "minConfirmationsToWithdraw": 12
}

响应字段说明

以下是主要响应字段。部分嵌套结构（例如 instrumentFrom / instrumentTo）类似于 /instruments 和 /rates 方法中的对象。

订单通用信息

字段	类型	说明
orderId	number	Quickex 系统中的唯一订单标识符。
legacyOrderId	string	旧系统中的订单标识符（如果用于迁移/兼容）。
createdAt	string	订单创建时间（ISO8601）。
instrumentFromCurrencyTitle	string	源币种代码（`BTC`）。
instrumentFromNetworkTitle	string	源网络（`BTC`）。
instrumentToCurrencyTitle	string	目标币种代码（`USDT`）。
instrumentToNetworkTitle	string	目标网络（`TRC20`）。
feeMode	string	订单费用模式： • `FLOATING` — 费用可能会根据网络情况或市场汇率变化。 • `FIXED` — 费用在订单创建时固定。
rateMode	string	兑换汇率模式： • `FIXED` — 汇率在订单创建时锁定；应收金额不会变化。 • `FLOATING` — 汇率可能会在订单完成前波动；应收金额会根据当前市场情况更新。
claimedDepositAmount	string	用于创建订单的入金金额。
amountToGet	string	用户应从该订单中收到的金额。
claimedNetworkFee	string	订单计算中应用的网络费用。
platformFee	string	平台费用。
redirectUrl	string	跳转到外部服务的重定向 URL。
completed	boolean	订单完成标志：`true` — 兑换已完成，`false` — 处理中。
minConfirmationsToTrade	number	入金被视为可用于交易所需的最少确认数。
minConfirmationsToWithdraw	number	提现所需的最少确认数。

交易工具对（pair）

  "pair": {
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },

字段	类型	说明
instrumentFrom	object	源交易工具——用户发送的币种。
instrumentFrom.currencyTitle	string	源交易工具的币种代码（例如 XRP）。
instrumentFrom.networkTitle	string	源交易工具的区块链网络。
instrumentFrom.precisionDecimals	number	金额支持的小数位数。
instrumentFrom.slug	string	币种的内部标识符。
instrumentFrom.liquidityProviderCurrencies	array	该币种和网络的流动性提供商设置。
instrumentFrom.liquidityProviderCurrencies.minConfirmationsToTrade	number	将入金用于兑换所需的最少区块链确认数。
instrumentFrom.liquidityProviderCurrencies.minConfirmationsToWithdraw	number	允许提现前所需的最少确认数。
instrumentTo	object	目标交易工具——用户接收的币种。
instrumentTo.currencyTitle	string	目标交易工具的币种代码（例如 TRX）。
instrumentTo.networkTitle	string	目标交易工具的区块链网络。
instrumentTo.precisionDecimals	number	金额支持的小数位数。
instrumentTo.slug	string	币种的内部标识符。
instrumentTo.liquidityProviderCurrencies	array	该币种和网络的流动性提供商设置。
instrumentTo.liquidityProviderCurrencies.minConfirmationsToTrade	number	资金可兑换前所需的最少确认数。
instrumentTo.liquidityProviderCurrencies.minConfirmationsToWithdraw	number	资金可提现前所需的最少确认数。

orderEvents

  "orderEvents": [
    {
      "createdAt": "2025-12-15T14:42:43.317Z",
      "kind": "WITHDRAWAL_COMPLETED"
    },
    {
      "createdAt": "2025-12-15T14:41:54.109Z",
      "kind": "FUNDS_WITHDRAWAL_START"
    },
    {
      "createdAt": "2025-12-15T14:41:00.379Z",
      "kind": "DEPOSIT_REGISTERED"
    },
    {
      "createdAt": "2025-12-15T14:39:58.760Z",
      "kind": "INCOMING_FUNDS_DETECTED"
    },
    {
      "createdAt": "2025-12-15T14:38:41.642Z",
      "kind": "CREATION_END"
    }
  ],

字段	类型	说明
orderEvents	array	描述订单生命周期的事件列表，按时间顺序排列。
orderEvents[].createdAt	string (ISO 8601)	事件发生的时间戳。
orderEvents[].kind	string	订单事件类型。

orderEvents[].kind 的可能值

值	说明
CREATION_END	订单已成功创建。
INCOMING_FUNDS_DETECTED	已在区块链中检测到入金交易。
DEPOSIT_REGISTERED	入金已获得所需确认并已入账。
FUNDS_WITHDRAWAL_START	提现交易已发起。
WITHDRAWAL_COMPLETED	资金已成功发送至目标地址。

depositAddress 对象

  "depositAddress": {
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
    "depositAddressMemo": "2097040307"
  },

字段	类型	说明
depositAddress	object	源交易工具的入金详情。
depositAddress.instrument	object	用于入金的交易工具和网络。
depositAddress.instrument.currencyTitle	string	入金交易工具的币种代码（例如 XRP）。
depositAddress.instrument.networkTitle	string	用于入金的区块链网络。
depositAddress.depositAddress	string	用户必须发送资金的区块链地址。
depositAddress.depositAddressMemo	string \| null	入金所需的 Memo / tag（例如 XRP Destination Tag）。如果已提供，则必须填写。

deposits 数组

"deposits": [
  {
    "id": 50958,
    "counterPartyAddress": null,
    "createdAt": "2025-12-15T14:39:45.000Z",
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "amount": "57",
    "amountUSDT": "112.40742",
    "txId": "DEA15CCF7AF04799A090298CB06D78DD177B3B518BED9C9DE8A0A5B717CCDBE7",
    "confirmations": 12,
    "depositAddress": {
      "instrument": {
        "currencyTitle": "XRP",
        "networkTitle": "XRP"
      },
      "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
      "depositAddressMemo": "2097040307"
    },
    "isPending": false
  }
]

字段	类型	说明
deposits[]	array	与该订单关联的入金交易列表。
deposits[].id	number	入金交易的内部标识符。
deposits[].counterPartyAddress	string \| null	发送入金的交易对手地址，如已知。
deposits[].createdAt	string (ISO 8601)	入金交易在系统中登记的时间戳。
deposits[].instrument	object	入金币种的交易工具和网络。
deposits[].instrument.currencyTitle	string	入金币种代码（例如 XRP）。
deposits[].instrument.networkTitle	string	入金所在的区块链网络（例如 XRP）。
deposits[].amount	string	以原始代币表示的入金币种金额。
deposits[].amountUSDT	string	入金时该笔入金的 USDT 等值金额。
deposits[].txId	string	区块链上的入金交易 ID。
deposits[].confirmations	number	该笔入金已收到的区块链确认数量。
deposits[].depositAddress	object	资金发送到的入金地址对象（见 `depositAddress` 区块）。
deposits[].isPending	boolean	表示入金是否仍在等待中（true）或已确认/入账（false）。

withdrawals 数组

"withdrawals": [
  {
    "instrument": {
      "currencyTitle": "TRX",
      "networkTitle": "TRC20"
    },
    "amount": "393.07",
    "txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
    "createdAt": "2025-12-15T14:41:58.926Z",
    "networkFee": "1.98"
  }
]

字段	类型	说明
withdrawals[]	array	该订单的提现交易列表。
withdrawals[].instrument	object	正在提现的币种交易工具和网络。
withdrawals[].instrument.currencyTitle	string	提现代币的币种代码（例如 TRX）。
withdrawals[].instrument.networkTitle	string	用于提现的区块链网络（例如 TRC20）。
withdrawals[].amount	string	以原始代币表示的提现金额。
withdrawals[].txId	string	提现的区块链交易 ID。
withdrawals[].createdAt	string (ISO 8601)	提现创建的时间戳。
withdrawals[].networkFee	string	提现交易收取的网络费用。

可能的使用场景

获取特定订单的完整详情，用于在用户账户、合作伙伴仪表板中显示完整交易历史、状态和相关财务数据，或用于对账与审计。

Code Sample

Response Example

{
  "orderId": 3038,
  "legacyOrderId": "4602ddf9-e516-4c3a-9146-7bc748edd89b",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "precisionDecimals": 7,
      "slug": "btc",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20",
      "precisionDecimals": 5,
      "slug": "usdttrc20",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "createdAt": "2025-04-28T13:15:03.006Z",
  "instrumentFromCurrencyTitle": "BTC",
  "instrumentFromNetworkTitle": "BTC",
  "instrumentToCurrencyTitle": "USDT",
  "instrumentToNetworkTitle": "TRC20",
  "feeMode": "FLOATING",
  "userId": 229,
  "userEmail": "qa@support.quickex.io",
  "isPlatformEmail": false,
  "refundAddress": null,
  "refundAddressMemo": null,
  "destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
  "destinationAddressMemo": null,
  "claimedNetworkFee": "1.5",
  "rateMode": "FLOATING",
  "claimedDepositAmount": "0.034268",
  "amountToGet": "3263.05",
  "platformFee": null,
  "redirectUrl": null,
  "orderEvents": [
    {
      "createdAt": "2025-04-28T13:15:03.021Z",
      "kind": "CREATION_END"
    }
  ],
  "depositAddress": {
    "instrument": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC"
    },
    "depositAddress": "3LpR1ZKEVysoi6sxFqoGtB49638RsxzKSh",
    "depositAddressMemo": null
  },
  "deposits": [],
  "withdrawals": [],
  "KYCFormLink": null,
  "liquidityProviderPublicCode": "hat",
  "possibleRefferalAccrualAmount": "3.01",
  "possibleCashbackAmountUSDT": "0",
  "actualCashbackAmountUSDT": null,
  "claimedPublicRate": {
    "claimedAmountToReceive": "3259.38",
    "finalNetworkFeeAmount": "1.5",
    "price": "95158.1",
    "quotes": {
      "sellQuote": {
        "baseValue": "1",
        "quoteValue": "95114.32743505127"
      },
      "buyQuote": {
        "baseValue": "95158",
        "quoteValue": "0.9995400016924599"
      }
    },
    "updatedAt": "2025-04-28T13:11:30.251Z",
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "precisionDecimals": 7,
      "slug": "btc",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20",
      "precisionDecimals": 5,
      "slug": "usdttrc20",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "completed": false,
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

Try it out

POST

accept-rate-mode-change

字段	类型	必填	说明
`orderId`	number	是	需要确认汇率模式变更的订单标识符。
`destinationAddress`	string	是	与订单关联的目标地址（用作额外校验）。

代码	说明
`201 Created`	汇率模式变更已确认，订单将继续处理。
`404 Not Found`	未找到订单（`{"status":"ERR_NOT_FOUND","message":"Order not found"}`）。
`400 Bad Request`	验证错误（例如，输入数据无效）。
`5xx`	服务器内部错误。

POST

request-refund

Endpoint URL

https://quickex.io/api/v2/orders/public/request-refund

Documentation

字段	类型	必填	说明
`orderId`	number	是	请求退款的订单标识符。
`destinationAddress`	string	是	原始订单中指定的目标地址（用作额外校验）。
`refundAmount`	string	是	需要退还给用户的金额。
`refundAddress`	string	是	用户用于接收退款的钱包地址。
`claimedNetworkFee`	string	否	用户同意为退款支付的网络费用金额。

代码	说明
`201 Created`	退款请求已被接受，并将被处理。
`404 Not Found`	未找到订单（`{"status":"ERR_NOT_FOUND","message":"Order not found"}`）。
`400 Bad Request`	验证错误（例如，退款金额低于允许的最小值或 `refundAddress` 无效）。
`5xx`	服务器内部错误。

Code Sample

Try it out

GET

order-refund-info

代码	说明
`200 OK`	返回包含退款信息的 JSON（金额、地址、状态、费用）。
`400 Bad Request`	验证错误或订单数据无效（`{"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}`）。
`404 Not Found`	未找到订单。
`5xx`	服务器内部错误。

Orders API V2

Documentation

Orders API V2

一般说明

HTTP 请求

请求示例

签名公式：

请求头

请求参数

查询参数

响应格式

响应示例

响应字段说明

可能的使用场景

Code Sample

Response Example

Try it out

Query Parameters

Headers

Documentation

一般说明

HTTP 请求

请求头

签名公式：

请求示例（仅使用必填参数发起请求）

请求示例

请求参数

必填参数

响应格式

完整响应示例

响应字段说明

入金（deposits）

出金（withdrawals）

入金地址（depositAddress）

订单通用信息

claimedPublicRate 区块

可能的使用场景

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

一般说明

HTTP 请求

请求示例

请求头

请求参数

查询参数

响应格式

响应示例

响应字段说明

订单通用信息

交易工具对（pair）

orderEvents

orderEvents[].kind 的可能值

depositAddress 对象

deposits 数组

withdrawals 数组

可能的使用场景

Code Sample

Response Example

Try it out

Query Parameters

Headers

Documentation

URL

请求头

请求体（JSON）

请求示例（cURL）

响应

备注

Code Sample

Try it out