account_offers

account_offersメソッドは、特定のアカウントから出されたオファーのうち、特定のレジャーバージョンで未処理であったオファーのリストを取得します。

リクエストのフォーマット

リクエストのフォーマットの例:

WebSocket
JSON-RPC
コマンドライン

{
  "id": 2,
  "command": "account_offers",
  "account": "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM"
}

試してみる >

リクエストには以下のパラメーターを指定できます。

`Field`	型	必須?	説明
`account`	文字列 - Address	はい	このアカウントからのオファーを検索します。
`ledger_hash`	ハッシュ	いいえ	使用するレジャーバージョンを識別する20バイトの16進文字列。
`ledger_index`	レジャーインデックス	いいえ	使用するレジャーのレジャーインデックス、レジャーを自動的に選択するためのショートカット文字列。（レジャーの指定をご覧ください
`limit`	整数	いいえ	取得するオファーの数を制限します。サーバはこの数より少ない結果を返すことがあります。10～400の範囲内でなければなりません。この範囲外の正の値は、最も近い有効なオプションに置き換えられます。デフォルトは200です。
`marker`	マーカー	いいえ	以前にページネーションされたレスポンスの値。そのレスポンスを停止した箇所からデータの取得を再開します。

以下のパラメーターは廃止予定であり、今後予告なしに削除される可能性があります。ledger,strict

レスポンスのフォーマット

処理が成功したレスポンスの例:

WebSocket
JSON-RPC
コマンドライン

{
  "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
  }
}

このレスポンスは標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドが含まれます。

`Field`	型	説明
`account`	文字列	オファーを出したアカウントを識別する一意のアドレス
`offers`	配列	オブジェクトの配列。各オブジェクトは、このアカウントが出したオファーの中で、レジャーバージョンがリクエストされた時点で未処理のオファーを表します。オファーの数が多い場合は、一度に`limit`の数までのオファーが返されます。
`ledger_current_index`	数値 - レジャーインデックス	（`ledger_hash`または`ledger_index`が指定されている場合は省略可）このデータの取得時に使用した、現在処理中のレジャーバージョンのレジャーインデックス。
`ledger_index`	数値 - レジャーインデックス	（`ledger_current_index`が指定されている場合は省略可）リクエストに従って、このデータの取得時に使用されたレジャーバージョンのレジャーインデックス。
`ledger_hash`	文字列 - ハッシュ	（省略される場合があります）このデータの取得時に使用されたレジャーバージョンの識別用ハッシュ。
`marker`	マーカー	（省略される場合があります）レスポンスがページネーションされていることを示す、サーバが定義した値。この値を次のコールに渡して、このコールで終わった箇所から再開します。この後に情報ページがない場合は省略されます。

各Offerオブジェクトのフィールドを次に示します。

`Field`	型	説明
`flags`	符号なし整数	このオファーエントリに対してビットフラグとして設定されているオプション。
`seq`	符号なし整数	このエントリを作成したトランザクションのシーケンス番号。（トランザクションのシーケンス番号はアカウントに関連付けられています。）
`taker_gets`	文字列またはオブジェクト	オファーを受け入れるアカウントが受領する額。XRPまたは通貨指定オブジェクトの額を表す文字列として示されます。(通貨額の指定をご覧ください。)
`taker_pays`	文字列またはオブジェクト	オファーを受け入れるアカウントが提供する額。XRPまたは通貨指定オブジェクトの額を表す文字列として示されます。(通貨額の指定をご覧ください。)
`quality`	文字列	オファーの為替レート。元の`taker_pays`を元の`taker_gets`で割った比率です。オファーの実行時には、最も好ましい（最も低い）クオリティのオファーが最初に消費されます。同じクオリティのオファーは古いものから新しいものの順で実行されます。
`expiration`	符号なし整数	（省略される場合があります）この時刻の経過後は、資金化されなかったオファーとみなされます（Rippleエポック以降の経過秒数）。関連項目: オファーの有効期限。

考えられるエラー

いずれかの汎用エラータイプ。
invalidParams - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
actNotFound - リクエストのaccountフィールドに指定されているアドレスが、レジャーのアカウントに対応していません。
lgrNotFound - ledger_hashまたはledger_indexで指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。
actMalformed - 指定されているmarkerフィールドが受け入れられない場合。

account_offers

リクエストのフォーマット

レスポンスのフォーマット

考えられるエラー

Was this helpful?