mcpField
T
tenero

tenero

github.com/aibtcdev数据与数据库11170 次安装1 天前更新
代码仓库

关于 tenero

tenero 是通过 Tenero API 查询 Stacks、Spark 和 SportsFun 市场数据的命令行技能，适用于代币与钱包分析。它提供只读查询，且接口无需认证。

主要功能

  1. 01查询代币价格、成交量与元数据
  2. 02查看市场历史、流动性和统计
  3. 03查询钱包持仓与交易记录
  4. 04筛选涨跌代币及热门池
  5. 05查看大额交易和持币分布
  6. 06按名称或地址片段搜索

适用场景

  1. 01查看代币的近期价格和成交量
  2. 02检查钱包持仓价值与交易历史
  3. 03比较热门交易池和大额交易

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aibtcdev/skills --skill tenero

安装后在 Claude Code 中输入/tenero确认已加载。

附带文件AGENT.mdtenero.ts

详细介绍

Tenero 技能

通过 Tenero API（原 STXTools）为代币、钱包、DEX 和市场提供实时市场分析。所有端点均为只读，无需身份验证。数据涵盖 Stacks、Spark 和 SportsFun 链。

用法

bun run tenero/tenero.ts <subcommand> [options]

子命令

token-info

获取代币详情，包括元数据、价格和交易量。

bun run tenero/tenero.ts token-info --token <address> [--chain <chain>]

选项：

  • --token（必需）— 代币合约地址（例如 SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token）
  • --chain（可选）— 要查询的链（默认：stacks）

输出：

{
  "contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
  "symbol": "LEO",
  "name": "Leo",
  "decimals": 6,
  "price_usd": "0.0012",
  "price_stx": "0.0042",
  "volume_24h_usd": "45000",
  "market_cap_usd": "1200000"
}
market-summary

获取代币市场摘要，包括价格历史、交易量和流动性。

bun run tenero/tenero.ts market-summary --token <address> [--chain <chain>]

选项：

  • --token（必需）— 代币合约地址
  • --chain（可选）— 要查询的链（默认：stacks）

输出：

{
  "contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
  "price_usd": "0.0012",
  "price_change_1h": "1.2",
  "price_change_24h": "-3.5",
  "price_change_7d": "12.4",
  "volume_24h_usd": "45000",
  "liquidity_usd": "350000",
  "holders": 1842
}
market-stats

获取整体市场统计信息，包括总交易量、市值和活跃代币。

bun run tenero/tenero.ts market-stats [--chain <chain>]

选项：

  • --chain（可选）— 要查询的链（默认：stacks）

输出：

{
  "total_volume_24h_usd": "2500000",
  "total_market_cap_usd": "85000000",
  "active_tokens": 342,
  "total_trades_24h": 18420,
  "unique_traders_24h": 3210
}
top-gainers

获取过去 24 小时内按价格涨幅百分比排名的代币。

bun run tenero/tenero.ts top-gainers [--chain <chain>] [--limit <number>]

选项：

  • --chain（可选）— 要查询的链（默认：stacks）
  • --limit（可选）— 结果数量上限（默认：10）

输出：

[
  {
    "contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
    "symbol": "LEO",
    "price_usd": "0.0012",
    "price_change_24h": "42.5",
    "volume_24h_usd": "45000"
  }
]
top-losers

获取过去 24 小时内按价格跌幅百分比排名的代币。

bun run tenero/tenero.ts top-losers [--chain <chain>] [--limit <number>]

选项：

  • --chain（可选）— 要查询的链（默认：stacks）
  • --limit（可选）— 结果数量上限（默认：10）

输出：

[
  {
    "contract_id": "SP2C2YFP12AJZB4MABJBAJ55XECVS7E4PMMZ89YZR.arkadiko-token",
    "symbol": "DIKO",
    "price_usd": "0.045",
    "price_change_24h": "-18.3",
    "volume_24h_usd": "12000"
  }
]
wallet-holdings

获取钱包持有的代币及其当前美元价值。如果省略 --address，则使用当前钱包地址。

bun run tenero/tenero.ts wallet-holdings [--address <stx_address>] [--chain <chain>]

选项：

  • --address（可选）— 要检查的 Stacks 地址（如果省略，则使用当前钱包）
  • --chain（可选）— 要查询的链（默认：stacks）

输出：

{
  "address": "SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173",
  "total_value_usd": "1250.42",
  "holdings": [
    {
      "contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
      "symbol": "LEO",
      "balance": "1000000",
      "value_usd": "1.20"
    }
  ]
}
wallet-trades

获取钱包交易历史。如果省略 --address，则使用当前钱包地址。

bun run tenero/tenero.ts wallet-trades [--address <stx_address>] [--chain <chain>] [--limit <number>]

选项：

  • --address（可选）— 要检查的 Stacks 地址（如果省略，则使用当前钱包）
  • --chain（可选）— 要查询的链（默认：stacks）
  • --limit（可选）— 结果数量上限（默认：20）

输出：

[
  {
    "tx_id": "0xabc123...",
    "timestamp": "2024-01-15T12:00:00Z",
    "type": "swap",
    "token_in": "STX",
    "token_out": "LEO",
    "amount_in_usd": "10.00",
    "amount_out_usd": "9.85"
  }
]
trending-pools

获取指定时间范围内按交易量排名的热门 DEX 池。

bun run tenero/tenero.ts trending-pools [--timeframe <1h|6h|24h>] [--chain <chain>] [--limit <number>]

选项：

  • --timeframe（可选）— 时间范围：1h、6h 或 24h（默认：24h）
  • --chain（可选）— 要查询的链（默认：stacks）
  • --limit（可选）— 结果数量上限（默认：10）

输出：

[
  {
    "pool_id": "SP1Y5YSTAHZ88XYK1VPDH24GY0HPX5J4JECTMY4A1.univ2-share-fee-to",
    "token_x": "STX",
    "token_y": "LEO",
    "volume_usd": "85000",
    "liquidity_usd": "420000",
    "fee_24h_usd": "255"
  }
]
whale-trades

获取超过指定阈值的大额／鲸鱼交易。

bun run tenero/tenero.ts whale-trades [--chain <chain>] [--limit <number>]

选项：

  • --chain（可选）— 要查询的链（默认：stacks）
  • --limit（可选）— 结果数量上限（默认：10）

输出：

[
  {
    "tx_id": "0xdef456...",
    "timestamp": "2024-01-15T11:45:00Z",
    "wallet": "SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173",
    "type": "buy",
    "token": "ALEX",
    "amount_usd": "25000"
  }
]
holder-stats

获取代币持有者分布和统计信息。

bun run tenero/tenero.ts holder-stats --token <address> [--chain <chain>]

选项：

  • --token（必需）— 代币合约地址
  • --chain（可选）— 要查询的链（默认：stacks）

输出：

{
  "contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
  "total_holders": 1842,
  "top_10_concentration": "45.2",
  "top_25_concentration": "62.8",
  "top_holders": [
    {
      "address": "SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173",
      "balance": "50000000",
      "percentage": "5.0"
    }
  ]
}
search

按名称或地址片段搜索代币、池和钱包。

bun run tenero/tenero.ts search --query <string> [--chain <chain>]

选项：

  • --query（必需）— 搜索查询字符串（代币名称、符号或地址）
  • --chain（可选）— 要查询的链（默认：stacks）

输出：

{
  "tokens": [
    {
      "contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
      "symbol": "LEO",
      "name": "Leo"
    }
  ],
  "pools": [],
  "wallets": []
}

注意事项

  • 所有端点均为只读 — 大多数子命令无需 API 密钥或钱包
  • 如果省略 --address，wallet-holdings 和 wallet-trades 会使用当前已解锁的钱包地址
  • --chain 选项支持 stacks（默认）、spark 和 sportsfun
  • 响应数据直接取自 Tenero API 的 data 字段
  • 基础 URL：https://api.tenero.io

评论

支持 Markdown