account_offers

该account_offers方法检索由特定帐户作为特定分类账版本的优惠清单。 请求格式的示例：

{
  "id": 2,
  "command": "account_offers",
  "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
  "ledger": "current"
}

{
    "method": "account_offers",
    "params": [
        {
            "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
            "ledger_index": "current"
        }
    ]
}

#Syntax: account_offers account [ledger_index]
rippled account_offers vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV current

请求可以包含以下参数：

Field	类型	描述
account	String	该帐户的唯一标识符，通常是帐户的地址。
ledger	Unsigned integer, or String	（不推荐使用，可选）要使用的分类帐版本的唯一标识符，例如分类帐序列号，散列或诸如“已验证”的快捷方式。
ledger_hash	String	（可选）标识要使用的分类帐版本的20字节十六进制字符串。
ledger_index	（可选） Ledger Index	（可选，默认为current）要使用的分类帐的序列号，或“current”，“closed”或“validated”以动态选择分类帐。（请参阅指定分类帐）
limit	Integer	（可选，默认值有所不同）限制要检索的事务数量。服务器不需要遵守这个值。必须在10到400的范围内。
marker	Not Specified	（可选）来自之前分页响应的值。在该响应停止的情况下继续检索数据。

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

{
  "id": 2,
  "result": {
    "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
    "ledger_current_index": 155935,
    "offers": [{
      "flags": 0,
      "seq": 234,
      "taker_gets": {
        "currency": "CNY",
        "issuer": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
        "value": "1"
      },
      "taker_pays": "1000000"
    }, {
      "flags": 0,
      "seq": 239,
      "taker_gets": {
        "currency": "CNY",
        "issuer": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
        "value": "0.00195"
      },
      "taker_pays": "1950000"
    }, {
      "flags": 0,
      "seq": 275,
      "taker_gets": {
        "currency": "CNY",
        "issuer": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
        "value": "1.85"
      },
      "taker_pays": "1000000"
    }],
    "validated": false
  },
  "status": "success",
  "type": "response"
}

200 OK
{
  "result": {
    "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
    "ledger_current_index": 155935,
    "offers": [{
      "flags": 0,
      "seq": 234,
      "taker_gets": {
        "currency": "CNY",
        "issuer": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
        "value": "1"
      },
      "taker_pays": "1000000"
    }, {
      "flags": 0,
      "seq": 239,
      "taker_gets": {
        "currency": "CNY",
        "issuer": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
        "value": "0.00195"
      },
      "taker_pays": "1950000"
    }, {
      "flags": 0,
      "seq": 275,
      "taker_gets": {
        "currency": "CNY",
        "issuer": "vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz",
        "value": "1.85"
      },
      "taker_pays": "1000000"
    }],
    "validated": false
  },
  "status": "success",
  "type": "response"
}

响应遵循标准格式，成功结果包含以下字段：

Field	类型	描述
account	String	唯一地址标识提供商品的帐户
offers	Array	对象数组，其中每个对象都表示此帐户所提供的优惠，与请求的帐本版本相同。如果报价数量很大，则一次只能返回limit。
ledger_current_index	Integer	（如果ledger_hash或ledger_index提供，则省略）检索此数据时使用的分类帐版本的序号。
ledger_index	Integer	（如果ledger_current_index改为提供，则省略）请求中提供的序列号，用于检索此数据时使用的分类帐版本。
ledger_hash	String	（可以省略）请求中提供的Hex哈希检索此数据时使用的分类帐版本。
marker	(Not Specified)	（可以省略）服务器定义的值，表示响应是分页的。将此传递给下一个调用以恢复此调用停止的位置。在此之后没有信息页面时省略。

每个商品对象都包含以下字段：

Field	类型	描述
flags	Unsigned integer	此优惠条目的选项设置为位标志。
seq	Unsigned integer	创建此条目的事务的序列号。（交易序列号与账户相关。）
taker_gets	String or Object	接受报价的帐户接收的金额，作为表示STM中金额的字符串或货币规格对象。（请参阅指定货币金额）
taker_pays	String or Object	接受报价的账户所提供的金额，作为表示STM中金额的字符串或货币规格对象。（请参阅指定货币金额）
quality	String	报价的汇率，按原来的比例taker_pays除以原始报价taker_gets。执行报价时，最优质（最低）质量的报价首先被消耗; 提供具有相同质量的产品将从最旧到最新执行。
expiration	Unsigned integer	（可能会被忽略）之后，此优惠被视为无资金支持，因为自Stream Epoch以来的秒数。另请参阅：优惠到期。

可能的错误：

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