tenero

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Tenero Skill

Provides real-time market analytics for tokens, wallets, DEXs, and markets via the Tenero API (formerly STXTools). All endpoints are read-only and require no authentication. Data covers Stacks, Spark, and SportsFun chains.

通过Tenero API（前身为STXTools）提供代币、钱包、DEX及市场的实时市场分析数据。所有接口均为只读模式，无需身份验证。数据覆盖Stacks、Spark和SportsFun链。

Usage

使用方法

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

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

Subcommands

子命令

token-info

Get token details including metadata, price, and volume.

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

Options:

--token

(required) — Token contract address (e.g.

SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token

)

```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)

Output:

json

{
  "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"
}

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

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

选项：

--token

（必填）——代币合约地址（例如

SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token

）

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

输出：

json

{
  "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

Get token market summary including price history, volume, and liquidity.

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

Options:

```
--token
```
(required) — Token contract address
```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)

Output:

json

{
  "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
}

获取代币市场汇总信息，包括价格历史、交易量和流动性。

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

选项：

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

输出：

json

{
  "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

Get overall market statistics including total volume, market cap, and active tokens.

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

Options:

```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)

Output:

json

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

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

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

选项：

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

输出：

json

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

top-gainers

Get top gaining tokens by price change percentage over the past 24 hours.

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

Options:

```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)
```
--limit
```
(optional) — Maximum number of results (default:
```
10
```
)

Output:

json

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

获取过去24小时内价格涨幅最高的代币。

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

选项：

```
--chain
```
（可选）——要查询的链（默认值：
```
stacks
```
）
```
--limit
```
（可选）——最大返回结果数（默认值：
```
10
```
）

输出：

json

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

top-losers

Get top losing tokens by price change percentage over the past 24 hours.

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

Options:

```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)
```
--limit
```
(optional) — Maximum number of results (default:
```
10
```
)

Output:

json

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

获取过去24小时内价格跌幅最高的代币。

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

选项：

```
--chain
```
（可选）——要查询的链（默认值：
```
stacks
```
）
```
--limit
```
（可选）——最大返回结果数（默认值：
```
10
```
）

输出：

json

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

wallet-holdings

Get wallet token holdings with current USD value. Uses the active wallet address if

--address

is omitted.

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

Options:

```
--address
```
(optional) — Stacks address to check (uses active wallet if omitted)
```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)

Output:

json

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

获取钱包的代币持仓及当前美元价值。若省略

--address

参数，则使用当前活跃钱包地址。

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

选项：

```
--address
```
（可选）——要查询的Stacks地址（省略则使用活跃钱包地址）
```
--chain
```
（可选）——要查询的链（默认值：
```
stacks
```
）

输出：

json

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

wallet-trades

Get wallet trade history. Uses the active wallet address if

--address

is omitted.

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

Options:

```
--address
```
(optional) — Stacks address to check (uses active wallet if omitted)
```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)
```
--limit
```
(optional) — Maximum number of results (default:
```
20
```
)

Output:

json

[
  {
    "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"
  }
]

获取钱包的交易历史记录。若省略

--address

参数，则使用当前活跃钱包地址。

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

选项：

```
--address
```
（可选）——要查询的Stacks地址（省略则使用活跃钱包地址）
```
--chain
```
（可选）——要查询的链（默认值：
```
stacks
```
）
```
--limit
```
（可选）——最大返回结果数（默认值：
```
20
```
）

输出：

json

[
  {
    "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

Get trending DEX pools by volume within a timeframe.

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

Options:

```
--timeframe
```
(optional) — Time window:
```
1h
```
,
```
6h
```
, or
```
24h
```
(default:
```
24h
```
)
```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)
```
--limit
```
(optional) — Maximum number of results (default:
```
10
```
)

Output:

json

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

获取指定时间段内交易量靠前的热门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
```
）

输出：

json

[
  {
    "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

Get large/whale trades above a threshold value.

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

Options:

```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)
```
--limit
```
(optional) — Maximum number of results (default:
```
10
```
)

Output:

json

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

获取超过阈值的大额交易记录。

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

选项：

```
--chain
```
（可选）——要查询的链（默认值：
```
stacks
```
）
```
--limit
```
（可选）——最大返回结果数（默认值：
```
10
```
）

输出：

json

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

holder-stats

Get token holder distribution and statistics.

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

Options:

```
--token
```
(required) — Token contract address
```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)

Output:

json

{
  "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"
    }
  ]
}

获取代币持仓分布及统计数据。

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

选项：

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

输出：

json

{
  "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

Search tokens, pools, and wallets by name or address fragment.

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

Options:

```
--query
```
(required) — Search query string (token name, symbol, or address)
```
--chain
```
(optional) — Chain to query (default:
```
stacks
```
)

Output:

json

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

通过名称或地址片段搜索代币、资金池和钱包。

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

选项：

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

输出：

json

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

Notes

注意事项

All endpoints are read-only — no API key or wallet required for most subcommands
```
wallet-holdings
```
and
```
wallet-trades
```
use the active unlocked wallet address when
```
--address
```
is omitted
The
```
--chain
```
option supports
```
stacks
```
(default),
```
spark
```
, and
```
sportsfun
```
Response data is passed through directly from the Tenero API
```
data
```
field
Base URL:
```
https://api.tenero.io
```

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