查询意图拍卖结果#

查询某次意图拍卖(Solver 竞价)的详细结果。auctionIdtxHash 二选一必填。

请求地址#

GET
https://web3.okx.com/api/v6/dex/aggregator/intent/auction-info

请求参数#

参数类型必传描述
auctionIdstring条件必填拍卖 ID。auctionIdtxHash 二选一必填。
txHashString条件必填上链交易哈希。auctionIdtxHash 二选一必填。

响应参数#

参数类型描述
auctionIdstring本次拍卖的唯一标识。
auctionStartBlockLong拍卖开始时的区块高度。
auctionDeadlineBlockLongSolver 提交方案的截止区块高度。
auctionObject本次拍卖的详细信息,包含参与订单和参考价格。
ordersArray<String>参与本次拍卖的 orderUid 列表。
referencePricesObject在solution竞争中计算surplus 及 费用等金额转换为USD价值,便于选出胜出的solutions。
solutionsArray各 Solver 提交的竞价方案列表。
solverAddressString提交该方案的 Solver 钱包地址。
rankingInteger该方案在所有提交方案中的排名,1 表示最优。
scoreString该方案的评分,用于排名比较,分值越高越优。
isWinnerBoolean该方案是否为最终胜出方案。
filteredOutBoolean该方案是否在评估阶段被过滤淘汰。
txHashString该 Solver 提交的结算交易哈希。
clearingPricesObject以代币合约地址为 key、结算价格比率为 value 的映射,用于该方案的链上结算。
ordersArray该方案成交的订单列表。
orderUidString成交订单的唯一标识。
fromTokenAmountString卖出代币的成交数量,以十进制字符串表示。
toTokenAmountString买入代币的收到数量,以十进制字符串表示。

请求示例#

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": ""
}