最終更新:
編集

nft_sell_offers

[ソース]

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

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

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

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

注記

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

{
  "command": "nft_sell_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": "1000",
        "flags": 1,
        "nft_offer_index": "9E28E366573187F8E5B85CE301F229E061A619EE5A589EF740088F8843BF10A1",
        "owner": "rLpSRZ1E8JHyNDZeHYsQs1R5cwDCB3uuZt"
      }
    ]
  },
  "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で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。