最終更新:
編集

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で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。