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