# account_offers [[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/AccountOffers.cpp) `account_offers`メソッドは、特定の[アカウント](/ja/docs/concepts/accounts)から出された[オファー](/ja/docs/concepts/tokens/decentralized-exchange/offers)のうち、特定の[レジャーバージョン](/ja/docs/concepts/ledgers)で未処理であったオファーのリストを取得します。 ## リクエストのフォーマット リクエストのフォーマットの例: WebSocket ```json { "id": 2, "command": "account_offers", "account": "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM" } ``` JSON-RPC ```json { "method": "account_offers", "params": [ { "account": "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM" } ] } ``` コマンドライン ```sh #Syntax: account_offers account [ledger_index] rippled account_offers r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 current ``` リクエストには以下のパラメーターを指定できます。 | `Field` | 型 | 必須? | 説明 | | --- | --- | --- | --- | | `account` | 文字列 - [Address][] | はい | このアカウントからのオファーを検索します。 | | `ledger_hash` | [ハッシュ](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5) | いいえ | 使用するレジャーバージョンを識別する20バイトの16進文字列。 | | `ledger_index` | [レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9) | いいえ | 使用するレジャーの[レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9)、レジャーを自動的に選択するためのショートカット文字列。（[レジャーの指定](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%81%AE%E6%8C%87%E5%AE%9A)をご覧ください | | `limit` | 整数 | いいえ | 取得するオファーの数を制限します。サーバはこの数より少ない結果を返すことがあります。10～400の範囲内でなければなりません。この範囲外の正の値は、最も近い有効なオプションに置き換えられます。デフォルトは200です。 | | `marker` | [マーカー][] | いいえ | 以前にページネーションされたレスポンスの値。そのレスポンスを停止した箇所からデータの取得を再開します。 | 以下のパラメーターは廃止予定であり、今後予告なしに削除される可能性があります。`ledger`,`strict` ## レスポンスのフォーマット 処理が成功したレスポンスの例: WebSocket ```json { "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 } } ``` JSON-RPC ```json 200 OK { "result": { "account": "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM", "ledger_current_index": 18539596, "offers": [{ "flags": 0, "quality": "0.000000007599140009999998", "seq": 6578020, "taker_gets": "29740867287", "taker_pays": { "currency": "USD", "issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "value": "226.0050145327418" } }, { "flags": 0, "quality": "7989247009094510e-27", "seq": 6572128, "taker_gets": "2361918758", "taker_pays": { "currency": "XAU", "issuer": "rrh7rf1gV2pXAoqA8oYbpHd8TKv5ZQeo67", "value": "0.01886995237307572" } }, { "flags": 0, "quality": "0.00000004059594001318974", "seq": 6576905, "taker_gets": "3892952574", "taker_pays": { "currency": "CNY", "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", "value": "158.0380691682966" } }, ... ], "status": "success", "validated": false } } ``` コマンドライン ```json { "result" : { "account" : "rpP2JgiMyTF5jR5hLG3xHCPi1knBb1v9cM", "ledger_current_index" : 57110969, "offers" : [ { "flags" : 0, "quality" : "1499850014.892974", "seq" : 7916201, "taker_gets" : { "currency" : "BCH", "issuer" : "rcyS4CeCZVYvTiKcxj6Sx32ibKwcDHLds", "value" : "0.5268598580881351" }, "taker_pays" : "790210766" } ], "status" : "success", "validated" : false } } ``` このレスポンスは[標準フォーマット](/ja/docs/references/http-websocket-apis/api-conventions/response-formatting)に従っており、正常に完了した場合は結果に次のフィールドが含まれます。 | `Field` | 型 | 説明 | | --- | --- | --- | | `account` | 文字列 | オファーを出したアカウントを識別する一意の[アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | | `offers` | 配列 | オブジェクトの配列。各オブジェクトは、このアカウントが出したオファーの中で、レジャーバージョンがリクエストされた時点で未処理のオファーを表します。オファーの数が多い場合は、一度に`limit`の数までのオファーが返されます。 | | `ledger_current_index` | 数値 - [レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9) | *（`ledger_hash`または`ledger_index`が指定されている場合は省略可）* このデータの取得時に使用した、現在処理中のレジャーバージョンのレジャーインデックス。 | | `ledger_index` | 数値 - [レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9) | *（`ledger_current_index`が指定されている場合は省略可）* リクエストに従って、このデータの取得時に使用されたレジャーバージョンのレジャーインデックス。 | | `ledger_hash` | 文字列 - [ハッシュ](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5) | *（省略される場合があります）* このデータの取得時に使用されたレジャーバージョンの識別用ハッシュ。 | | `marker` | [マーカー][] | *（省略される場合があります）* レスポンスがページネーションされていることを示す、サーバが定義した値。この値を次のコールに渡して、このコールで終わった箇所から再開します。この後に情報ページがない場合は省略されます。 | 各Offerオブジェクトのフィールドを次に示します。 | `Field` | 型 | 説明 | | --- | --- | --- | | `flags` | 符号なし整数 | このオファーエントリに対してビットフラグとして設定されているオプション。 | | `seq` | 符号なし整数 | このエントリを作成したトランザクションのシーケンス番号。（トランザクションの[シーケンス番号](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%82%B7%E3%83%BC%E3%82%B1%E3%83%B3%E3%82%B9)はアカウントに関連付けられています。） | | `taker_gets` | 文字列またはオブジェクト | オファーを受け入れるアカウントが受領する額。XRPまたは通貨指定オブジェクトの額を表す文字列として示されます。([通貨額の指定](/ja/docs/references/protocol/data-types/basic-data-types#%E9%80%9A%E8%B2%A8%E9%A1%8D%E3%81%AE%E6%8C%87%E5%AE%9A)をご覧ください。) | | `taker_pays` | 文字列またはオブジェクト | オファーを受け入れるアカウントが提供する額。XRPまたは通貨指定オブジェクトの額を表す文字列として示されます。([通貨額の指定](/ja/docs/references/protocol/data-types/basic-data-types#%E9%80%9A%E8%B2%A8%E9%A1%8D%E3%81%AE%E6%8C%87%E5%AE%9A)をご覧ください。) | | `quality` | 文字列 | オファーの為替レート。元の`taker_pays`を元の`taker_gets`で割った比率です。オファーの実行時には、最も好ましい（最も低い）クオリティのオファーが最初に消費されます。同じクオリティのオファーは古いものから新しいものの順で実行されます。新規: rippled 0.29.0 | | `expiration` | 符号なし整数 | （省略される場合があります）この時刻の経過後は、資金化されなかったオファーとみなされます（[Rippleエポック以降の経過秒数](/ja/docs/references/protocol/data-types/basic-data-types#%E6%99%82%E9%96%93%E3%81%AE%E6%8C%87%E5%AE%9A)）。関連項目: [オファーの有効期限](/ja/docs/concepts/tokens/decentralized-exchange/offers#%E3%82%AA%E3%83%95%E3%82%A1%E3%83%BC%E3%81%AE%E6%9C%89%E5%8A%B9%E6%9C%9F%E9%99%90)。新規: rippled 0.30.1 | ## 考えられるエラー * いずれかの[汎用エラータイプ](/ja/docs/references/http-websocket-apis/api-conventions/error-formatting#%E6%B1%8E%E7%94%A8%E3%82%A8%E3%83%A9%E3%83%BC)。 * `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。 * `actNotFound` - リクエストの`account`フィールドに指定されている[アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9)が、レジャーのアカウントに対応していません。 * `lgrNotFound` - `ledger_hash`または`ledger_index`で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。 * `actMalformed` - 指定されている`marker`フィールドが受け入れられない場合。