Rippled/XRP API手册

在线工具推荐: Three.js AI纹理开发包 - YOLO合成数据生成器 - GLTF/GLB在线编辑 - 3D模型格式在线转换 - 可编程3D场景编辑器

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:对方账户是否已经冻结该信任线,布尔值