TronScan Data Lookup

TronScan データ検索スキル

概要

このスキルを使用すると、AI エージェントは TronScan API を通じて TRON ブロックチェーンを検索できます。ユニバーサル検索、アカウント詳細、トランザクション、トークン情報、ブロック、スマートコントラクト、送金履歴、チェーンレベルの統計情報など、主要なデータ検索操作を網羅する 8 つの Node.js スクリプトを提供します。

すべてのスクリプトは、bankofai のスキル規約に従って、構造化された JSON を標準出力に出力し、進行状況を標準エラー出力に記録します。

前提条件

• Node.js ^22.23.4 || ^24.22.1 || >=26.12.1
• npm（依存関係のインストールに使用）
• 初回使用前に、スキルのルートディレクトリで npm install を実行してください

API キー（任意）

API キーが設定されていない場合、スクリプトは自動的に BofAI プロキシ（ts.bankofai.io）を使用します。設定は不要です。

代わりに独自の TronScan API キーを使用する場合（レート制限が緩和されます）、次の環境変数を設定してください。

export TRONSCAN_API_KEY="your-api-key-here"

無料のキーは https://tronscan.org/#/myaccount/apiKeys で取得できます。

レート制限

• 1 秒あたり最大 5 リクエスト
• 無料枠のキーでは、合計 100,000 リクエストまで
• コントラクトイベントの一括クエリを除き、すべてのエンドポイントで HTTP GET を使用します
• 1 リクエストあたりの limit は最大 200 です（一部のエンドポイントでは最大 500 まで指定できます）
• ページネーションに対応するエンドポイントでは、start + limit が 10,000 以下である必要があります

使用方法

1. ユニバーサル検索

アドレス、トークン、コントラクト、トランザクション、ブロックを横断して検索します。

node scripts/search.js <term> [--type <type>] [--limit <n>]

パラメーター：

パラメーター	説明	値
term	検索クエリ（位置指定、必須）	任意の文字列
--type	結果の種類を絞り込みます	token、address、contract、transaction、block
--limit	結果の最大数	1～50、デフォルトは 20

使用する場面： 名前、アドレス、ハッシュの一部しかわからない場合や、TRON 上の対象が何かを特定したい場合に使用します。

---

2. アカウント詳細

アカウント情報、残高、トークン保有状況、リソース使用状況を確認します。

node scripts/account.js <address>                          # Full account details
node scripts/account.js <address> --tokens [--limit <n>]   # Token holdings
node scripts/account.js <address> --wallet                 # Portfolio with USD values
node scripts/account.js <address> --resources              # Bandwidth & energy
node scripts/account.js <address> --analysis --type <0-4>  # Daily analytics

モード：

フラグ	説明
(なし)	アカウントの詳細情報（残高、作成日、権限、スーパーレップの状態）
--tokens	すべてのトークン残高。TRC20 のみの場合は --show 1、TRC721 の場合は 2、すべての場合は 3、TRC1155 の場合は 4 を指定します
--wallet	米ドル換算額を表示するポートフォリオビュー
--resources	帯域幅／エネルギーの割り当て（Stake 2.0）
--analysis	日次分析。--type：0=残高、1=送金、2=エネルギー、3=帯域幅、4=トランザクション

使用する場面： ユーザーが TRON ウォレットの残高、トークン保有状況、ステーキングリソース、アカウント履歴について尋ねた場合に使用します。

---

3. トランザクション検索

ハッシュで個別のトランザクションを取得するか、フィルターを指定してトランザクションの一覧を取得します。

node scripts/transaction.js <hash>                                  # By hash
node scripts/transaction.js --list [--from <addr>] [--to <addr>]    # Filtered list
node scripts/transaction.js --stats                                 # Network stats

一覧オプション：

パラメーター	説明
--from	送信者アドレスで絞り込みます
--to	受信者アドレスで絞り込みます
--block	ブロック番号で絞り込みます
--start_timestamp	開始時刻（ミリ秒）
--end_timestamp	終了時刻（ミリ秒）
--sort	並べ替えフィールド（デフォルト：-timestamp）
--limit	1 ページあたりの結果数（デフォルトは 20、最大 200）
--start	ページネーションのオフセット

使用する場面： 特定のトランザクションハッシュを検索したい場合や、アドレスの最近のトランザクションを照会したい場合に使用します。

---

4. トークン情報

トークンの詳細、価格、保有者一覧、供給量データ、ランキングを取得します。

node scripts/token.js --list [--filter <type>] [--sort <field>]   # Token rankings
node scripts/token.js --trc20 <contract_address>                  # TRC20 detail
node scripts/token.js --trc10 <token_id>                          # TRC10 detail
node scripts/token.js --price [symbol]                            # Current price
node scripts/token.js --holders <contract_address> [--limit <n>]  # Top holders
node scripts/token.js --supply <contract_address>                 # Total supply
node scripts/token.js --distribution <token_id>                   # Holdings distribution

一覧のフィルター： trc10、trc20、trc721、trc1155、all、top 並べ替えフィールド： priceInTrx、gain、volume24hInTrx、holderCount、marketcap

使用する場面： 特定のトークン（価格、保有者、供給量）について尋ねられた場合や、TRON 上の上位トークンを調べたい場合に使用します。

---

5. ブロック情報

ブロックの詳細、最近のブロック、またはブロック統計情報を照会します。

node scripts/block.js                                     # Latest block
node scripts/block.js <number>                            # By block number
node scripts/block.js --list --limit <n>                  # Recent blocks
node scripts/block.js --producer <address>                # By block producer
node scripts/block.js --stats                             # Network block stats

使用する場面： 最新のブロックを確認したい場合、特定のブロックを検索したい場合、またはブロック生成統計を確認したい場合に使用します。

---

6. スマートコントラクトの詳細

コントラクト情報、エネルギー使用量、呼び出し統計、呼び出し元の分析情報を確認します。

node scripts/contract.js <address>                         # Contract detail
node scripts/contract.js --list [--search <term>]          # Search/list contracts
node scripts/contract.js <address> --energy                # Energy consumption
node scripts/contract.js <address> --calls                 # Call statistics
node scripts/contract.js <address> --callers               # Caller list
node scripts/contract.js <address> --analysis --type <0-5> # Daily analytics

分析タイプ： 0=呼び出し元、1=呼び出し、2=エネルギー、3=帯域幅、4=trx_transfers、5=token_transfers

使用する場合： スマートコントラクトのコード検証状況、使用状況、エネルギーコスト、または誰が呼び出しているかについてユーザーから質問された場合に使用します。

---

7. 送金履歴

アドレスとコントラクトのTRX、TRC10、TRC20の送金履歴を照会します。

node scripts/transfer.js --trx <address>                             # TRX transfers
node scripts/transfer.js --trc20 <address> [--token <contract>]      # TRC20 transfers
node scripts/transfer.js --trc10 <address> [--token <token_id>]      # TRC10 transfers
node scripts/transfer.js --trc20-contract <contract> [--addr <addr>] # By contract
node scripts/transfer.js --internal <address>                        # Internal txns

一般的なオプション：

パラメーター	説明
--direction	0=すべて、1=受信、2=送信
--start_timestamp	開始時刻（ミリ秒）
--end_timestamp	終了時刻（ミリ秒）
--limit	1ページあたりの結果数（デフォルト20、最大200）

使用する場合： ウォレットの送金履歴（受信／送信したTRX、USDT、その他のトークン）を確認したいとユーザーが希望した場合に使用します。

---

8. チェーンの概要と統計情報

TRONネットワークの概要データ、スーパー代表者、ガバナンス、市場データを取得します。

node scripts/overview.js                         # Full chain dashboard
node scripts/overview.js --tps                   # Current transactions per second
node scripts/overview.js --witnesses              # Super Representative list
node scripts/overview.js --params                 # Chain parameters
node scripts/overview.js --proposals              # Governance proposals
node scripts/overview.js --daily-accounts [days]  # New account growth
node scripts/overview.js --funds                  # TRX supply & burn data
node scripts/overview.js --trx-volume             # TRX price/volume history
node scripts/overview.js --nodes                  # Network node map

使用する場合： TRONネットワークの健全性、TPS、スーパー代表者、ガバナンス、TRXの供給量、または市場データについてユーザーから質問された場合に使用します。

例

TRONウォレットとそのUSDT残高を確認する

# Get full account info
node scripts/account.js TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf

# Get token holdings with USD values
node scripts/account.js TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf --wallet

トランザクションを確認する

node scripts/transaction.js 7f4a6d28e3c5f1b2a9d8e7c6b5a4f3e2d1c0b9a8f7e6d5c4b3a2f1e0d9c8b7a6

現在のTRX価格を取得する

node scripts/token.js --price trx

時価総額上位10件のTRC20トークンを一覧表示する

node scripts/token.js --list --filter trc20 --sort marketcap --limit 10

アドレスの最近のUSDT送金を取得する

node scripts/transfer.js --trc20 TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf --token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t --limit 10

チェーンの概要を取得する

node scripts/overview.js

エラー処理

すべてのスクリプトで、一貫したエラー処理を行います。

エラー	原因	解決方法
Missing required argument	必須の位置引数が指定されていません	スクリプトのヘッダーにある使用方法を確認してください
Request failed with status 403	APIキーが無効か、レート制限に達しています	TRONSCAN_API_KEYを確認し、リクエスト頻度を下げてください
Request failed with status 404	エンドポイントが見つからないか、パラメーターが無効です	アドレス／ハッシュの形式を確認してください
timeout of 15000ms exceeded	APIサーバーの応答が遅いか、到達できません	数秒後に再試行してください
ENOTFOUND	ネットワークに接続できません	インターネット接続を確認してください

スクリプトはエラー時にコード1で終了し、機械で解析できるよう、標準出力に{ "error": "message" }を出力します。

セキュリティに関する考慮事項

• APIキーは読み取り専用であり、ブロックチェーンの状態を変更できません
• APIキーはTRONSCAN_API_KEY環境変数からのみ読み込まれ、ハードコードされることはありません
• APIキーが設定されていない場合、キーのヘッダーなしでBofAIプロキシ（ts.bankofai.io）経由でリクエストが送信されます
• スクリプトの実行時に、秘密鍵やウォレットのシークレットを決して埋め込まないでください
• すべてのクエリは、公開されているTronScan APIへの読み取り専用のGETリクエストです
• APIキーがログや公開リポジトリに漏えいした場合は、キーをローテーションしてください
• キーの失効を避けるため、レート制限は最大毎秒5リクエストにしてください

一般的なトークンアドレス

resources/common_tokens.jsonファイルには、広く知られているメインネットのトークンアドレスが含まれています。主なトークンは次のとおりです。

シンボル	コントラクトアドレス	小数桁数
TRX	(ネイティブ)	6
USDT	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t	6
USDC	TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8	6
USDD	TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn	18
WTRX	TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR	6
BTT	TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4	18
JST	TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9	18
SUN	TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S	18

エージェントは、これらのアドレスを検索せずに直接使用できます。

---

バージョン2.0.0 — Bank of AI向けに M2M Agent Registryが作成