account_lines

该account_lines方法返回有关账户信任额度的信息，包括所有非STM货币和资产的余额。所有检索到的信息都与分类账的特定版本有关。 请求格式的示例：

{
  "id": 1,
  "command": "account_lines",
  "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
  "ledger": "current"
}

{
    "method": "account_lines",
    "params": [
        {
            "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
            "ledger": "current"
        }
    ]
}

该请求接受以下参数：

Field	类型	描述
account	String	该帐户的唯一标识符，通常是帐户的地址。
ledger_hash	String	（可选）要使用的分类帐版本的20字节十六进制字符串。（请参阅指定分类帐）
ledger_index	String or Unsigned Integer	（可选）要使用的分类帐的序号或快捷字符串自动选择分类帐。（请参阅指定分类帐）
peer	String	（可选）第二个帐户的地址。如果提供，只显示连接两个帐户的信任线。
limit	Integer	（可选，默认值有所不同）限制要检索的事务数量。服务器不需要遵守这个值。必须在10到400的范围内。
marker	(Not Specified)	（可选）来自之前分页响应的值。在该响应停止的情况下继续恢复数据。

以下参数已被弃用，可能会被删除，恕不另行通知：ledger和peer_index。 一个成功回应的例子:

{
  "id": 1,
  "result": {
    "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
    "ledger_current_index": 155833,
    "lines": [{
      "account": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
      "balance": "999857.44805",
      "currency": "CNY",
      "limit": "1000000000000000e-4",
      "limit_peer": "0",
      "no_vstream": true,
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
      "balance": "0",
      "currency": "STM",
      "limit": "0",
      "limit_peer": "0",
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
      "balance": "0",
      "currency": "XCN",
      "limit": "0",
      "limit_peer": "0",
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vp9Ykz8Af9bYV6zpjxRiza2oeim8xmiu7i",
      "balance": "0",
      "currency": "BTC",
      "limit": "1000000000000000e-4",
      "limit_peer": "0",
      "no_vstream": true,
      "no_vstream_peer": true,
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vp9Ykz8Af9bYV6zpjxRiza2oeim8xmiu7i",
      "balance": "0",
      "currency": "ETH",
      "limit": "1000000000000000e-4",
      "limit_peer": "0",
      "no_vstream": true,
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
      "balance": "0",
      "currency": "BTC",
      "limit": "1000000000000000e-4",
      "limit_peer": "0",
      "no_vstream": true,
      "quality_in": 0,
      "quality_out": 0
    }],
    "validated": false
  },
  "status": "success",
  "type": "response"
}

200 OK
{
  "result": {
    "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
    "ledger_current_index": 155833,
    "lines": [{
      "account": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
      "balance": "999857.44805",
      "currency": "CNY",
      "limit": "1000000000000000e-4",
      "limit_peer": "0",
      "no_vstream": true,
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
      "balance": "0",
      "currency": "XRP",
      "limit": "0",
      "limit_peer": "0",
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
      "balance": "0",
      "currency": "XCN",
      "limit": "0",
      "limit_peer": "0",
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vp9Ykz8Af9bYV6zpjxRiza2oeim8xmiu7i",
      "balance": "0",
      "currency": "BTC",
      "limit": "1000000000000000e-4",
      "limit_peer": "0",
      "no_vstream": true,
      "no_vstream_peer": true,
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vp9Ykz8Af9bYV6zpjxRiza2oeim8xmiu7i",
      "balance": "0",
      "currency": "ETH",
      "limit": "1000000000000000e-4",
      "limit_peer": "0",
      "no_vstream": true,
      "quality_in": 0,
      "quality_out": 0
    }, {
      "account": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
      "balance": "0",
      "currency": "BTC",
      "limit": "1000000000000000e-4",
      "limit_peer": "0",
      "no_vstream": true,
      "quality_in": 0,
      "quality_out": 0
    }],
    "validated": false
  },
  "status": "success",
  "type": "response"
}

响应遵循标准格式，包含帐户地址和信任线对象数组的成功结果。具体而言，结果对象包含以下字段：

Field	类型	描述
account	String	此请求所对应帐户的唯一地址。这是用于信任线目的的“透视帐户”。
lines	Array	信任线对象数组，如下所述。如果信任线的数量很大，则一次只返回到此limit的次数。
ledger_current_index	Integer	（如果ledger_hash或ledger_index提供，则省略）检索此数据时使用的分类帐版本的序号。
ledger_index	Integer	（如果ledger_current_index改为提供，则省略）请求中提供的序列号，用于检索此数据时使用的分类帐版本。
ledger_hash	String	（可以省略）请求中提供的Hex哈希检索此数据时使用的分类帐版本。
marker	Not Specified	指示响应的服务器定义的值是分页的。将此传递给下一个调用以恢复此调用停止的位置。在此之后没有附加页面时省略。

每个信任线对象具有以下字段的某种组合：

Field	类型	描述
account	String	该信任线对手的唯一地址。
balance	String	表示当前针对此行保留的数字余额。积极的平衡意味着角度账户持有价值; 负差额意味着远景账户欠款。
currency	String	一个货币代码，标识这个信任线可以容纳什么货币。
limit	String	此帐户愿意欠对方帐户的最大金额
limit_peer	String	交易对手账户愿意欠透视账户的最大金额
quality_in	Unsigned integer	该账户对该信任额度上的收入余额进行评估的比率，即每10亿个单位的这个值的比率。（例如，5亿的值代表0.5：1的比率。）作为特例，0被视为1：1的比例。
quality_out	Unsigned integer	账户价值在此信任额度上的外发余额的比率，作为此值每10亿单位的比率。（例如，5亿的值代表0.5：1的比率。）作为特例，0被视为1：1的比例。
no_stream	Boolean	（可以省略）true如果此帐户已启用此行的NoStream标志。如果省略，则与之相同false。
no_stream_peer	Boolean	（可以省略）true如果对等帐户已启用NoStream标志。如果省略，则与之相同false。
authorized	Boolean	（可以省略）true如果此帐户已授权此信任热线。如果省略，则与之相同false。
peer_authorized	Boolean	（可以省略）true如果同行帐户授权此信任线。如果省略，则与之相同false。
freeze	Boolean	（可以省略）true如果此帐户冻结了此信任线。如果省略，则与之相同false。
freeze_peer	Boolean	（可以省略）true如果同行账户冻结了这个信任线。如果省略，则与之相同false。

可能的错误：

• 任何通用错误类型。
• invalidParams - 一个或多个字段指定不正确，或缺少一个或多个必填字段。
• actNotFound- 请求字段中指定的地址account不对应分类账中的账户。
• lgrNotFound- 由ledger_hash或者ledger_index不存在的分类账，或者确实存在，但服务器没有。
• actMalformed- 如果marker提供的字段不可接受。