# nft_sell_offers

[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/NFTOffers.cpp)

`nft_sell_offers`メソッドは、与えられた[NFToken](/ja/docs/references/protocol/data-types/nftoken)オブジェクトに対する売却オファーのリストを返します。

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

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

注記
このメソッドにはコマンドライン構文がありません。代わりに[jsonメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/utility-methods/json)を使って、コマンドラインからこのメソッドにアクセスすることができます。

WebSocket

```json
{
  "command": "nft_sell_offers",
  "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "nft_sell_offers",
    "params": [
        {
            "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007"
        }
    ]
}
```

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

| `Field` | 型 | 説明 |
|  --- | --- | --- |
| `nft_id` | 文字列 | [NFToken](/ja/docs/references/protocol/data-types/nftoken) オブジェクトの一意の識別子。 |
| `ledger_hash` | 文字列 | *(省略可)* 使用するレジャーのバージョンを示す20バイトの16進文字列。[レジャーの指定](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%81%AE%E6%8C%87%E5%AE%9A)をご覧ください）。 |
| `ledger_index` | 文字列 または 数値 | *(省略可)* 使用するレジャーの[レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9)、またはレジャーを自動的に選択するためのショートカット文字列。[レジャーの指定](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%81%AE%E6%8C%87%E5%AE%9A)をご覧ください）。 |
| `limit` | 整数値 | *(省略可)* 取得するNFTの売却オファーの数を制限します。この値は50未満または500を超えることはできません。この範囲外の正の値は、最も近い有効な値に置き換えられます。デフォルトは250です。 |
| `marker` | [マーカー][] | *(省略可)* 以前のページ分割されたレスポンスの値。そのレスポンスが終了したところからデータの取得を再開します。 |


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

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

WebSocket

```json
{
  "result": {
    "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007",
    "offers": [
      {
        "amount": "1000",
        "flags": 1,
        "nft_offer_index": "9E28E366573187F8E5B85CE301F229E061A619EE5A589EF740088F8843BF10A1",
        "owner": "rLpSRZ1E8JHyNDZeHYsQs1R5cwDCB3uuZt"
      }
    ]
  },
  "status": "success",
  "type": "response"
}
```

JSON-RPC

```json
{
  "result": {
    "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007",
    "offers": [
      {
        "amount": "1000",
        "flags": 1,
        "nft_offer_index": "9E28E366573187F8E5B85CE301F229E061A619EE5A589EF740088F8843BF10A1",
        "owner": "rLpSRZ1E8JHyNDZeHYsQs1R5cwDCB3uuZt"
      }
    ],
    "status": "success"
  }
}
```

このレスポンスは[標準フォーマット](/ja/docs/references/http-websocket-apis/api-conventions/response-formatting)に従っており、正常に完了した場合は結果に次のフィールドが含まれます。

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


### 売却オファー

`offers`配列の各メンバーは、対象のNFTを売却するための1つの[NFTokenOfferオブジェクト](/ja/docs/references/protocol/ledger-data/ledger-entry-types/nftokenoffer)を表し、以下のフィールドを持ちます。

| `Field` | 型 | 説明 |
|  --- | --- | --- |
| `amount` | 文字列 または オブジェクト | NFTを売却するために提示される金額で、XRPのドロップ数を表す文字列、または(代替可能)トークンの金額を表すオブジェクトです。([通貨金額の指定](/ja/docs/references/protocol/data-types/basic-data-types#%E9%80%9A%E8%B2%A8%E9%A1%8D%E3%81%AE%E6%8C%87%E5%AE%9A)をご覧ください)。 |
| `flags` | 数値 | このオファーのためのフラグ。指定できる値については、[NFTokenOfferのフラグ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/nftokenoffer#nftokenoffer%E3%81%AE%E3%83%95%E3%83%A9%E3%82%B0)をご覧ください。 |
| `nft_offer_index` | 文字列 | このオファーの[レジャーオブジェクトID](/ja/docs/references/protocol/ledger-data/common-fields)。 |
| `owner` | 文字列 | このオファーを作成アカウント。 |


## 考えられるエラー

* いずれかの[汎用エラータイプ](/ja/docs/references/http-websocket-apis/api-conventions/error-formatting#%E6%B1%8E%E7%94%A8%E3%82%A8%E3%83%A9%E3%83%BC)。
* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
* `actNotFound` - リクエストの`account`フィールドに指定されているアドレスが、レジャーのアカウントに対応していません。
* `lgrNotFound` - `ledger_hash`または`ledger_index`で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。