book_offers
book_offers
メソッドは、オーダーブックと呼ばれる、2つの通貨間のオファーのリストを取得します。結果が非常に大きい場合、結果の一部がマーカー付きで返されます。これにより、その後のリクエストは前回のリクエストで終わった箇所から再開できます。
リクエストのフォーマット
リクエストのフォーマットの例:
{
"id": 4,
"command": "book_offers",
"taker": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"taker_gets": {
"currency": "XRP"
},
"taker_pays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
},
"limit": 10
}
リクエストには以下のパラメーターが含まれます。
Field | 型 | 説明 |
---|---|---|
ledger_hash | 文字列 | (省略可) 使用するレジャーバージョンの20バイトの16進文字列。(レジャーの指定をご覧ください) |
ledger_index | 文字列または符号なし整数 | (省略可) 使用するレジャーのレジャーインデックス、またはレジャーを自動的に選択するためのショートカット文字列。(レジャーの指定をご覧ください) |
limit | 符号なし整数 | (省略可) 指定されている場合、サーバはこの制限を超える数のオファーを結果に含めません。資金供給のないオファーはサーバにより省略されるため、返される結果の総数はこの制限よりも少ないことがあります。 |
marker | マーカー | (省略可) 以前にページネーションされたレスポンスの値。そのレスポンスを停止した箇所からデータの取得を再開します。 |
taker | 文字列 | (省略可) パースペクティブとして使用するアカウントのアドレス。このアカウントが発行した資金供給のないオファーは常にレスポンスに含まれます。(これを使用して、キャンセルしたい各自のオーダーを検索できます。) |
taker_gets | オブジェクト | オファーを受諾するアカウントが受け取る通貨を、通貨額と同様に、currency フィールドとissuer フィールドを持つオブジェクトとして指定します(XRPの場合はissuerを省略)。 |
taker_pays | オブジェクト | オファーを受諾するアカウントが支払う通貨を、通貨額と同様に、currency フィールドとissuer フィールドを持つオブジェクトとして指定します(XRPの場合はissuerを省略)。 |
レスポンスのフォーマット
処理が成功したレスポンスの例:
{
"id": 11,
"status": "success",
"type": "response",
"result": {
"ledger_current_index": 7035305,
"offers": [
{
"Account": "rM3X3QSr8icjTGpaF52dozhbT2BZSXJQYM",
"BookDirectory": "7E5F614417C2D0A7CEFEB73C4AA773ED5B078DE2B5771F6D55055E4C405218EB",
"BookNode": "0000000000000000",
"Flags": 0,
"LedgerEntryType": "Offer",
"OwnerNode": "0000000000000AE0",
"PreviousTxnID": "6956221794397C25A53647182E5C78A439766D600724074C99D78982E37599F1",
"PreviousTxnLgrSeq": 7022646,
"Sequence": 264542,
"TakerGets": {
"currency": "EUR",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "17.90363633316433"
},
"TakerPays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "27.05340557506234"
},
"index": "96A9104BF3137131FF8310B9174F3B37170E2144C813CA2A1695DF2C5677E811",
"quality": "1.511056473200875"
},
{
"Account": "rhsxKNyN99q6vyYCTHNTC1TqWCeHr7PNgp",
"BookDirectory": "7E5F614417C2D0A7CEFEB73C4AA773ED5B078DE2B5771F6D5505DCAA8FE12000",
"BookNode": "0000000000000000",
"Flags": 131072,
"LedgerEntryType": "Offer",
"OwnerNode": "0000000000000001",
"PreviousTxnID": "8AD748CD489F7FF34FCD4FB73F77F1901E27A6EFA52CCBB0CCDAAB934E5E754D",
"PreviousTxnLgrSeq": 7007546,
"Sequence": 265,
"TakerGets": {
"currency": "EUR",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "2.542743233917848"
},
"TakerPays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "4.19552633596446"
},
"index": "7001797678E886E22D6DE11AF90DF1E08F4ADC21D763FAFB36AF66894D695235",
"quality": "1.65"
}
]
}
}
このレスポンスは標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドが含まれます。
Field | 型 | 説明 |
---|---|---|
ledger_current_index | 数値 - レジャーインデックス | (ledger_current_index が指定されている場合は省略) この情報の取得時に使用した、現在処理中のレジャーバージョンのレジャーインデックス。 |
ledger_index | 数値 - レジャーインデックス | (ledger_current_index が指定されている場合は省略可) リクエストに従って、このデータの取得時に使用されたレジャーバージョンのレジャーインデックス。 |
ledger_hash | 文字列 - ハッシュ | (省略される場合があります) リクエストに従って、このデータの取得時に使用されたレジャーバージョンの識別用ハッシュ。 |
marker | マーカー | (省略される場合があります) レスポンスがページネーションされていることを示す、サーバが定義した値。この値を次のコールに渡して、このコールで終わった箇所から再開します。この後に情報ページがない場合は省略されます。 |
offers | 配列 | Offerオブジェクトの配列。各オブジェクトにはOffer オブジェクトのフィールドが含まれています。 |
offers
配列の要素には、Offerの標準フィールドの他に以下のフィールドが含まれます。
Field | 型 | 説明 |
---|---|---|
owner_funds | 文字列 | オファーの発行元が保有する取引可能なTakerGets通貨の金額。(XRPはdrop単位で表されます。その他のすべての通貨は10進数値として表されます。)1人のトレーダーの複数のオファーが同一のブックに含まれている場合、このフィールドは最高順位のオファーにのみ含まれます。 |
taker_gets_funded | 文字列(XRP)またはオブジェクト(XRP以外) | (部分的に資金供給されているオファーのみに含まれます)オファーの資金供給ステータスが指定されている場合に、受取人が受領できる最大通貨額。 |
taker_pays_funded | 文字列(XRP)またはオブジェクト(XRP以外) | (部分的に資金供給されているオファーのみに含まれます)オファーの資金供給ステータスが指定されている場合に、受取人が支払う最大通貨額。 |
quality | 文字列 | 為替レート(taker_pays をtaker_gets で割った比率)。公正を期すため、同じクオリティのオファーは先入れ先出しで自動的に受諾されます。(つまり、複数の人々が通貨を同じレートで取引するオファーを出した場合、最も古いオファーが最初に受諾されます。) |
考えられるエラー
- いずれかの汎用エラータイプ。
invalidParams
- 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。lgrNotFound
-ledger_hash
またはledger_index
で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。srcCurMalformed
- リクエストのtaker_pays
フィールドのフォーマットが適切ではありません。dstAmtMalformed
- リクエストのtaker_gets
フィールドのフォーマットが適切ではありません。srcIsrMalformed
- リクエストのtaker_pays
フィールドのissuer
フィールドが無効です。dstIsrMalformed
- リクエストのtaker_gets
フィールドのissuer
フィールドが無効です。badMarket
- 必要なオーダーブックが存在していません(ある通貨をその通貨自体と交換するオファーなど)。