nft_buy_offers

nft_buy_offersメソッドは、与えられたNFTokenオブジェクトに対する購入オファーのリストを返します。

(NonFungibleTokensV1_1 amendmentにより追加されました。)

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

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

注記

このメソッドにはコマンドライン構文がありません。代わりにjsonメソッドを使って、コマンドラインからこのメソッドにアクセスすることができます。

{
  "command": "nft_buy_offers",
  "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007",
  "ledger_index": "validated"
}

試してみる >

リクエストには以下のパラメーターが含まれます。

`Field`	型	説明
`nft_id`	文字列	NFToken オブジェクトの一意の識別子。
`ledger_hash`	文字列	(省略可) 使用するレジャーのバージョンを示す20バイトの16進文字列。レジャーの指定をご覧ください）。
`ledger_index`	文字列または数値	(省略可) 使用するレジャーのレジャーインデックス、またはレジャーを自動的に選択するためのショートカット文字列。レジャーの指定をご覧ください）。
`limit`	整数値	(省略可) 取得するNFTの購入オファーの数を制限します。この値は50未満または500を超えることはできません。この範囲外の正の値は、最も近い有効な値に置き換えられます。デフォルトは250です。
`marker`	マーカー	(省略可) 以前のページ分割されたレスポンスの値。そのレスポンスが終了したところからデータの取得を再開します。

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

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

{
  "result": {
    "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007",
    "offers": [
      {
        "amount": "1500",
        "flags": 0,
        "nft_offer_index": "3212D26DB00031889D4EF7D9129BB0FA673B5B40B1759564486C0F0946BA203F",
        "owner": "rsuHaTvJh1bDmDoxX9QcKP7HEBSBt4XsHx"
      }
    ]
  },
  "status": "success",
  "type": "response"
}

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

`Field`	型	説明
`nft_id`	文字列	リクエストで指定された NFToken
`offers`	配列	トークンの購入オファー一覧。各オファーは購入オファー (下記参照)の形式で表示されます。
`limit`	数値	(省略可) リクエストで指定された`limit`。
`marker`	マーカー	(省略可) レスポンスがページ分割されていることを示す、サーバ定義の値。これを次の呼び出しに渡すと、この呼び出しが中断したところから再開します。この後に情報のページがない場合は省略されます。

購入オファー

offers配列の各メンバーは、対象のNFTを購入するための1つのNFTokenOfferオブジェクトを表し、以下のフィールドを持ちます。

`Field`	型	説明
`amount`	文字列またはオブジェクト	NFTを購入するために提示される金額で、XRPのドロップ数を表す文字列、または(代替可能)トークンの金額を表すオブジェクトです。(通貨金額の指定をご覧ください)。
`flags`	数値	このオファーのためのフラグ。指定できる値については、NFTokenOfferのフラグをご覧ください。
`nft_offer_index`	文字列	このオファーのレジャーオブジェクトID。
`owner`	文字列	このオファーを作成アカウント。

考えられるエラー

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