# Collections Secondary Trade Viewer

## Collections Secondary Trade Viewer とは？

<https://open-sea-utilities.vercel.app/collections-secondary-trade-viewer>

Open SeaでのNFTの売買履歴をコレクション単位で取得し、一時流通、二次流通の取引数を可視化するサービスです。

二次流通量が多い = そのコレクションのNFTを欲しがる人が多い = 資産性が高い と考えられます。

コレクターがNFTの購入を検討する際の判断材料の一つになればと思い制作しました。

また、クリエイターの利益の概&#x7B97;**（あくまで概算）**&#x306B;も使えます。まずは以下の計算式で売り上げ(ETH)をざっくり求めます。

> Firstly Trade の Volume  +&#x20;
>
> Secondary Trade の Volume × クリエイターが設定したロイヤリティ率

ここから出品手数料とガス代を引けば粗利になる、はず…。

クリエイターとしてNFTを売り上げた実績がないので手元にデータがなく、本当にこの考え方で合ってるか不安なので歯切れが悪いです。間違ってたら教えてください。

また、出品手数料、ガス代は追跡できないのでご自身で記録してもらう必要があります。

![](/files/j8VkDOV7KLcjiCHzjLAz)

※イメージ画像では[イケハヤ](https://twitter.com/IHayato)さんの「[CryptoNinja NFT](https://opensea.io/collection/crypto-ninja-nft)」を使わせてもらってます。

## 仕組み

Open Seaが提供するAPIを使用して取引情報を取得し、情報を集計して表示してます。

APIの詳細は以下の公式ドキュメントを参照。

{% embed url="<https://docs.opensea.io/reference/retrieving-asset-events>" %}

#### Collections Secondary Trade Viewer が使用しているパラメータ

| パラメータ            | 設定値                       |
| ---------------- | ------------------------- |
| collection\_slug | 入力されたコレクションURLのslug\_name |
| event\_type      | successful                |
| limit            | 300                       |

APIで取得した履歴情報を一件ずつチェック。

購入者情報(winner\_account)、販売者情報(seller)が設定されていたら売買履歴とみなし、それ以外はスキップ。&#x20;

コレクションのコミッション支払い先(asset.collection.payout\_address)と、販売者アドレス(seller.address)が一致してたら一時流通、不一致ならば二次流通という判定をして集計してます。

## 注意事項

* Ethereumチェーンのみ対応。Polygonは非対応。
* 画面がごちゃくつのを回避するため、ETH、WETHを一緒くたにして表示してます。
* Open Sea APIの仕様で、最大300件の履歴情報しか取得できません。※[Open Sea Trade Viewer](/ytendens-tools-doc/tools/open-sea-trade-viewer.md)と同様。
* コミッション支払い先と一時流通で販売したアドレスが一致しない場合、他プラットフォームで取引された場合などは一時流通情報がてきませんのでご注意ください。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://barururu3-pororo-kmt.gitbook.io/ytendens-tools-doc/tools/collections-secondary-trade-viewer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
