account_lines - 获取账户信任线
account_lines
方法返回指定账户的信任线,包括所有非XRP货币及资产的余额。
所有的信息都基于指定版本的账本。
API请求格式
WebSocket请求示例
{
"id": 1,
"command": "account_lines",
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
}
JSON-RPC请求示例
{
"method": "account_lines",
"params": [
{
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
}
]
}
API请求参数
- account:账户唯一ID,通常使用账户地址,字符串
- ledger_hash:账本哈希值,字符串,可选
- ledger_index:账本索引号或账本快捷选择符,整数或字符串,可选
- peer:第二个账户地址,字符串,可选。如果指定该参数,那么将返回连接该账户的信任线
- limit:返回的最大数量,整数,10~400,可选
- marker:服务端的分页响应标记对象,可选
API响应格式
WebSocket响应示例
{
"id": 1,
"status": "success",
"type": "response",
"result": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"lines": [
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "ASP",
"limit": "0",
"limit_peer": "10",
"quality_in": 0,
"quality_out": 0
},
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "XAU",
"limit": "0",
"limit_peer": "0",
"no_ripple": true,
"no_ripple_peer": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"balance": "3.497605752725159",
"currency": "USD",
"limit": "5",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
}
]
}
}
JSON-PRC响应示例
200 OK
{
"result": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"lines": [
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "ASP",
"limit": "0",
"limit_peer": "10",
"quality_in": 0,
"quality_out": 0
},
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "XAU",
"limit": "0",
"limit_peer": "0",
"no_ripple": true,
"no_ripple_peer": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rs9M85karFkCRjvc6KMWn8Coigm9cbcgcx",
"balance": "0",
"currency": "015841551A748AD2C1F76FF6ECB0CCCD00000000",
"limit": "10.01037626125837",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
}
],
"status": "success"
}
}
API响应字段
- account:账户地址,字符串
- lines:信任线对象数组
- ledger_current_index:所使用账本的最新序列号,整数
- ledger_index:所使用账本的序列号,整数
- ledger_hash:所使用账本的哈希值
- marker:服务端分页标记对象
每个信任线对象主要包含如下字段:
- account:对方账户地址,字符串
- balance:信任线当前余额,正数表示账户持有货币,负数表示账户欠等值货币,字符串
- currency:信任线所持有货币代码,字符串
- limit:当前账户可欠款的最大额度,字符串
- limit_peer:对方账户可欠款的最大额度,字符串
- quality_in:信任线买入汇率,整数
- quality_out:信任线卖出汇率,整数
- no_ripple:账户是否启用对非ripple货币的支持,布尔值
- no_ripple_peer:对方账户是否启用对非ripple货币的支持,布尔值
- authorized:账户是否授权该信任线,布尔值
- peer_authorized:对方账户是否授权该信任线,布尔值
- freeze:账户是否已经冻结该信任线,布尔值
- freeze_peer:对方账户是否已经冻结该信任线,布尔值