查询意图拍卖结果#
查询某次意图拍卖(Solver 竞价)的详细结果。auctionId 和 txHash 二选一必填。
请求地址#
GET
https://web3.okx.com/api/v6/dex/aggregator/intent/auction-info请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| auctionId | string | 条件必填 | 拍卖 ID。auctionId 和 txHash 二选一必填。 |
| txHash | String | 条件必填 | 上链交易哈希。auctionId 和 txHash 二选一必填。 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| auctionId | string | 本次拍卖的唯一标识。 |
| auctionStartBlock | Long | 拍卖开始时的区块高度。 |
| auctionDeadlineBlock | Long | Solver 提交方案的截止区块高度。 |
| auction | Object | 本次拍卖的详细信息,包含参与订单和参考价格。 |
| orders | Array<String> | 参与本次拍卖的 orderUid 列表。 |
| referencePrices | Object | 在solution竞争中计算surplus 及 费用等金额转换为USD价值,便于选出胜出的solutions。 |
| solutions | Array | 各 Solver 提交的竞价方案列表。 |
| solverAddress | String | 提交该方案的 Solver 钱包地址。 |
| ranking | Integer | 该方案在所有提交方案中的排名,1 表示最优。 |
| score | String | 该方案的评分,用于排名比较,分值越高越优。 |
| isWinner | Boolean | 该方案是否为最终胜出方案。 |
| filteredOut | Boolean | 该方案是否在评估阶段被过滤淘汰。 |
| txHash | String | 该 Solver 提交的结算交易哈希。 |
| clearingPrices | Object | 以代币合约地址为 key、结算价格比率为 value 的映射,用于该方案的链上结算。 |
| orders | Array | 该方案成交的订单列表。 |
| orderUid | String | 成交订单的唯一标识。 |
| fromTokenAmount | String | 卖出代币的成交数量,以十进制字符串表示。 |
| toTokenAmount | String | 买入代币的收到数量,以十进制字符串表示。 |
请求示例#
shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/aggregator/intent/auction-info?auctionId=10000000000000003' \
--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'
响应示例#
json
{
"code": "0",
"data": {
"auction": {
"orders": [
"0xfa2506196276f31c6bf7f4a2f02f3bd5ad80ed91354441ce4d5f28c87021e64c5b38da6a701c568545dcfcb03fcb875f56beddc469bbd743"
],
"referencePrices": {
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "0.99989",
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2498.123456789012345678"
}
},
"auctionDeadlineBlock": 24800035,
"auctionId": 10000000000000003,
"auctionStartBlock": 24800033,
"baselineScore": "",
"solutions": [
{
"baselineScore": "",
"clearingPrices": {
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "4987654321000000",
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10123456"
},
"filteredOut": false,
"isWinner": true,
"orders": [
{
"baselineScore": "",
"fromTokenAmount": "0.005000000000000000",
"orderUid": "0xfa2506196276f31c6bf7f4a2f02f3bd5ad80ed91354441ce4d5f28c87021e64c5b38da6a701c568545dcfcb03fcb875f56beddc469bbd743",
"toTokenAmount": "10.234567000000000000"
}
],
"ranking": 1,
"score": "0.923400156780000000",
"solverAddress": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
"txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
}
],
"txHash": ""
},
"msg": ""
}
