tenero/SKILL.md
Tenero (formerly STXTools) market analytics — token info, market stats, top gainers/losers, wallet holdings and trades, trending DEX pools, whale trades, holder distribution, and search. Covers Stacks, Spark, and SportsFun chains. No API key required.
npx skillsauth add aibtcdev/skills teneroInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
bun run tenero/tenero.ts <subcommand> [options]
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:
{
"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"
}
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:
{
"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
}
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:
{
"total_volume_24h_usd": "2500000",
"total_market_cap_usd": "85000000",
"active_tokens": 342,
"total_trades_24h": 18420,
"unique_traders_24h": 3210
}
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:
[
{
"contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
"symbol": "LEO",
"price_usd": "0.0012",
"price_change_24h": "42.5",
"volume_24h_usd": "45000"
}
]
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:
[
{
"contract_id": "SP2C2YFP12AJZB4MABJBAJ55XECVS7E4PMMZ89YZR.arkadiko-token",
"symbol": "DIKO",
"price_usd": "0.045",
"price_change_24h": "-18.3",
"volume_24h_usd": "12000"
}
]
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:
{
"address": "SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173",
"total_value_usd": "1250.42",
"holdings": [
{
"contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
"symbol": "LEO",
"balance": "1000000",
"value_usd": "1.20"
}
]
}
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:
[
{
"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"
}
]
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:
[
{
"pool_id": "SP1Y5YSTAHZ88XYK1VPDH24GY0HPX5J4JECTMY4A1.univ2-share-fee-to",
"token_x": "STX",
"token_y": "LEO",
"volume_usd": "85000",
"liquidity_usd": "420000",
"fee_24h_usd": "255"
}
]
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:
[
{
"tx_id": "0xdef456...",
"timestamp": "2024-01-15T11:45:00Z",
"wallet": "SP2X0TZ59D5SZ8ACQ6YMCHHNR2ZN51Z32E2CJ173",
"type": "buy",
"token": "ALEX",
"amount_usd": "25000"
}
]
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:
{
"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 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:
{
"tokens": [
{
"contract_id": "SP1AY6K3PQV5MRT6R4S671NWW2FRVPKM0BR162CT6.leo-token",
"symbol": "LEO",
"name": "Leo"
}
],
"pools": [],
"wallets": []
}
wallet-holdings and wallet-trades use the active unlocked wallet address when --address is omitted--chain option supports stacks (default), spark, and sportsfundata fieldhttps://api.tenero.iodevelopment
Web of Trust operations for Nostr pubkeys — trust scoring, sybil detection, trust path analysis, neighbor discovery, follow recommendations, and network health. Free tier (wot.klabo.world, 50 req/day) with paid fallback (maximumsats.com, 100 sats via L402). Covers 52K+ pubkeys and 2.4M+ zap-weighted trust edges. Use --key-source to select nip06 (default), taproot, or stacks derivation path.
data-ai
BTC ordinals marketplace operations via Magic Eden — browse active listings, list inscriptions for sale via PSBT flow, submit signed listings, buy inscriptions, and cancel active listings. BTC ordinals only (not Solana). Mainnet-only.
testing
Pay-per-call access to LunarCrush social and market intelligence (Galaxy Score, AltRank, market cap rank, price, 24h change) via x402 on Stacks. USD-pegged pricing recomputed hourly from live STX/USD. Mainnet endpoint live; testnet supported.
devops
Detects HODLMM LP inventory drift (token-ratio imbalance from one-sided swap flow) and restores the target ratio via a corrective Bitflow swap plus a hodlmm-move-liquidity redeploy, gated by the 4h per-pool cooldown.