account_offers - 获取账户出价清单
account_offers
命令获取指定账户的出价清单。
API请求格式
WebSocket请求示例
{
"id": 2,
"command": "account_offers",
"account": "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM"
}
JSON-RPC请求示例
{
"method": "account_offers",
"params": [
{
"account": "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM"
}
]
}
命令行请求示例
#Syntax: account_offers account [ledger_index]
rippled account_offers r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 current
命令请求参数
- account:账户ID,字符串
- ledger:账本标识符,已弃用,可选
- ledger_hash:所使用账本哈希值,字符串,可选
- ledger_index:所使用账本索引号,可选
- limit:要获取的最大交易数量,整数:10~400,可选
- marker:服务端分页标记对象
API响应格式
WebSocket响应示例
{
"id": 9,
"status": "success",
"type": "response",
"result": {
"account": "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM",
"ledger_current_index": 18539550,
"offers": [
{
"flags": 0,
"quality": "0.00000000574666765650638",
"seq": 6577664,
"taker_gets": "33687728098",
"taker_pays": {
"currency": "EUR",
"issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq",
"value": "193.5921774819578"
}
},
{
"flags": 0,
"quality": "7989247009094510e-27",
"seq": 6572128,
"taker_gets": "2361918758",
"taker_pays": {
"currency": "XAU",
"issuer": "rrh7rf1gV2pXAoqA8oYbpHd8TKv5ZQeo67",
"value": "0.01886995237307572"
}
},
... trimmed for length ...
],
"validated": false
}
}
JSON-RPC响应示例
200 OK
{
"result": {
"account": "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM",
"ledger_current_index": 18539596,
"offers": [{
"flags": 0,
"quality": "0.000000007599140009999998",
"seq": 6578020,
"taker_gets": "29740867287",
"taker_pays": {
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"value": "226.0050145327418"
}
}, {
"flags": 0,
"quality": "7989247009094510e-27",
"seq": 6572128,
"taker_gets": "2361918758",
"taker_pays": {
"currency": "XAU",
"issuer": "rrh7rf1gV2pXAoqA8oYbpHd8TKv5ZQeo67",
"value": "0.01886995237307572"
}
}, {
"flags": 0,
"quality": "0.00000004059594001318974",
"seq": 6576905,
"taker_gets": "3892952574",
"taker_pays": {
"currency": "CNY",
"issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y",
"value": "158.0380691682966"
}
},
...
],
"status": "success",
"validated": false
}
}
命令响应字段
- account:账户ID
- offers:出价清单数组
- ledger_current_index:账本当前序列号,整数
- ledger_index:所使用的账户索引号,整数
- ledger_hash:所使用的账本哈希值,字符串
- marker:服务端分页标记对象
出价清单对象包含如下字段:
- flags:出价选项,无符号整数
- seq:创建此出价的交易序列号,无符号整数
- taker_gets:接受此出价的账户将收到的金额,字符串或对象
- taker_pays:接受此出价的账户将支付的金额,字符串或对象
- quality:出价兑换比率,字符串
- expiration:出价超时时间,无符号整数