查询限价单列表#
查询 DEX 限价单列表。
请求地址#
GET https://www.okx.com/api/v5/dex/aggregator/limit-order/all
请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| chainId | String | 是 | 链 ID (如1: Ethereum，更多可查看链 ID 列表) |
| page | String | 否 | 页码数(默认: 1) |
| limit | String | 否 | 每页条数 (默认: 100, 最大: 500) |
| statuses | String | 否 | 用于筛选限价订单的状态数组。状态包括 1 - 有效订单，2 - 暂时失效订单，3 - 被占用订单（正在上链)，4 - 过期，5 - 取消，6 - 成功， 7 - 失败订单。 |
| takerAsset | String | 否 | 指定成交钱包地址 |
| makerAsset | String | 否 | 用户下单钱包地址 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| chainId | string | 链 ID (如1: Ethereum，更多可查看链 ID 列表) |
| createTime | string | 订单创建时间 |
| expireTime | string | 订单过期时间 |
| makerAssetAddress | string | 创建订单的钱包地址 |
| makerRate | string | takingAmount/makingAmount |
| makerTokenAddress | string | 卖出币种合约地址 |
| makingAmount | string | 卖出币数量 |
| orderHash | string | 签名订单hash |
| receiver | string | 默认情况下是零地址，接受者资产将被发送到限价订单创建者的地址。如果您设置了一个值，资产将会发送到当前的地址 |
| remainingMakerAmount | string | 剩余可交易数量 |
| salt | string | 随机数盐，作为幂等标识 当前时间戳 (秒值) |
| signature | string | 钱包签名后的数据 |
| status | string | 订单状态 (0:可用，1:暂时失效，3:不可用，4订单已全部成交 ) |
| takerTokenAddress | string | 买入币种合约地址 |
| takingAmount | string | 买入币数量 |
| takerRate | string | makingAmount/takingAmount |
| takerAssetAddress | string | 默认情况下是零地址，每个人都可以与当前限价订单成交。如果您设置了一个值，则限价订单将仅可在指定地址执行 |
请求示例#
shell
curl --location --request GET 'https://www.okx.com/api/v5/dex/aggregator/limit-order/all?chainId=137' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
响应示例#
200
{
"code": "0",
"data":[
{
"chainId": "137",
"createTime": "2023-12-07 17:54:20",
"expireTime": "2023-12-10 13:59:31",
"makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",
"makerRate": "16.700084079252467628",
"makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",
"makingAmount": "2.095797831550000000",
"orderHash": "0x618d6abcde06366ae5bd70e8fc661443bd7f9da5073305b39273f1b426cda443",
"receiver": "",
"remainingMakerAmount": "2.095797831550000000",
"salt": "1701942829",
"signature": "0x867ad0143a04bbee935fde6fcd2a4ddb6cf734a0c6d59352cd5d769d366caf2b25f4480e83d4e9b31274314ec24b88b04686c4df0ad4658b898fd56d630c049e1b",
"status": "3",
"takerAssetAddress": "0x0000000000000000000000000000000000000000",
"takerRate": "0.059879938044285714",
"takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
"takingAmount": "35.000000000000000000"
},
{
"chainId": "137",
"createTime": "2023-11-09 16:54:40",
"expireTime": "2023-11-15 21:30:49",
"makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",
"makerRate": "17.142857142857142857",
"makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",
"makingAmount": "0.700000000000000000",
"orderHash": "0xf834d285a8bee9c4edf2d3de4acff5acbc350bafe81d0491fc2448d6122a98ee",
"receiver": "0x0a0de421eb2d6cbef3b81a9d5561f6d2f26c3d07",
"remainingMakerAmount": "0.000000000000000000",
"salt": "1699520029",
"signature": "0xe028369231a0c7d8224c68001bdf16fcdbd3a92ca05d3f50fc880b6688c0980626dc4ac76c5c25276a0197a0db92fd358959d231e31d6eb78488bf34f709edbc1c",
"status": "3",
"takerAssetAddress": "0x0000000000000000000000000000000000000000",
"takerRate": "0.058333333333333333",
"takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
"takingAmount": "12.000000000000000000"
},
{
"chainId": "137",
"createTime": "2023-12-06 11:17:01",
"expireTime": "2023-12-20 10:36:05",
"makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",
"makerRate": "16.700084079252467628",
"makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",
"makingAmount": "2.095797831550000000",
"orderHash": "0xe1cb49dad5d3b23585c9f99cd75d10a87be70b7f59aa92e04fc5f1fa9023f93c",
"receiver": "",
"remainingMakerAmount": "2.095797831550000000",
"salt": "1701832383",
"signature": "0x6880a1c3b7c05d1a1c027494512090390789ebae7211ba5a087fe29161394b9320f6ac4eee14ce404902743668d6d1a50170c3c906d47fe0fdcec45a25b111a71b",
"status": "3",
"takerAssetAddress": "0x0000000000000000000000000000000000000000",
"takerRate": "0.059879938044285714",
"takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
"takingAmount": "35.000000000000000000"
},
{
"chainId": "137",
"createTime": "2023-12-07 16:02:14",
"expireTime": "2023-12-10 13:59:31",
"makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",
"makerRate": "16.700084079252467628",
"makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",
"makingAmount": "2.095797831550000000",
"orderHash": "0x555199460dea70eed738b4e782929c8e1e02f9abfaea31494ce90ba300306292",
"receiver": "",
"remainingMakerAmount": "2.095797831550000000",
"salt": "1701936038",
"signature": "0x7b00c8b608cb9769c37825f41248d4e5b1502ee705c4255b5074f544482177724a7227daed6cd7acb199e2a46436dc76e71ee16d5c751bd4eb8d2d65e18b7ae21c",
"status": "3",
"takerAssetAddress": "0x0000000000000000000000000000000000000000",
"takerRate": "0.059879938044285714",
"takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
"takingAmount": "35.000000000000000000"
},
{
"chainId": "137",
"createTime": "2023-12-07 17:18:00",
"expireTime": "2023-12-10 13:59:31",
"makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",
"makerRate": "16.700084079252467628",
"makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",
"makingAmount": "2.095797831550000000",
"orderHash": "0x596d7bd82d82d9766154f9c1884963c06a8d4d26991cd7f9b2448cbdde750a27",
"receiver": "",
"remainingMakerAmount": "2.095797831550000000",
"salt": "1701940627",
"signature": "0x8185c0bc38ee22ac6cfd9eee078f0526b47c2b31d31f5fdaaa66b8c1ddef930960a1206939fcbf9074471bdeb0fe4875e313616e838ba378096fef6e8fb408491c",
"status": "3",
"takerAssetAddress": "0x0000000000000000000000000000000000000000",
"takerRate": "0.059879938044285714",
"takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
"takingAmount": "35.000000000000000000"
}
],
"msg": ""
}