Token Movers / aeon skill

Crypto top movers scanner agent

Crypto market scanner and single-token analyst - movers scans top winners/losers/trending or on-chain runners with pump-risk flags; single-token produces a verdict-first deep report for one token.

CATEGORY BasicsRUNS Daily at 12:00 UTCUPDATED
Skill
Token Movers token-movers
Category
Basics
Default schedule
Daily at 12:00 UTC
cron 0 12 * * *
Last updated

commit e0895c4
Source
aeonfun/aeon/skills/token-movers/SKILL.md MIT licensed, one prompt file

What it does

Token Movers is an aeon skill: Crypto market scanner and single-token analyst - movers scans top winners/losers/trending or on-chain runners with pump-risk flags; single-token produces a verdict-first deep report for one token. Like every aeon skill it is one SKILL.md prompt file that runs unattended on your own GitHub Actions, on a schedule or when you trigger it, and sends what it finds to Telegram, Discord, Slack or email.

Input: the var setting

Every aeon skill takes one optional text input, var, set in aeon.yml or typed in when you run it by hand. It picks the target or the mode for that run.

Selects the scan. Two behavioral modes (movers, single-token) over two sources (coingecko, geckoterminal):

  • empty → movers scan on the default source (CoinGecko): top winners, losers, trending.
  • coingecko → same movers scan, CoinGecko source (explicit).
  • geckoterminal → movers scan on GeckoTerminal: on-chain "runners" across major chains.
  • geckoterminal:<chain> or a bare chain slug (solana, eth, ethereum, base, bsc, arbitrum, polygon, optimism, avalanche, avax) → GeckoTerminal runners scoped to that one chain.
  • category:<name> (e.g. category:layer-2, category:meme) - or a bare hyphen/space value like layer-2 / meme coins → CoinGecko movers scoped to that category.
  • <contract> or <contract>:<chain> (e.g. 0xabc…, 0xabc…:base) → single-token deep report on that contract.
  • <SYMBOL> (e.g. SOL, WIF) → single-token deep report; resolve the symbol to its top contract first.
  • token / single-token → single-token deep report on the token configured in memory/token-report.md.
  • deep-dive:<symbol|contract> (e.g. deep-dive:WIF, deep-dive:0xabc…:base) → single-token deep report - the shape the Telegram force-reply sends. Strips the deep-dive: prefix and resolves the remainder exactly like a bare symbol/contract.

Examples: "" (global movers), geckoterminal:base (Base runners), category:layer-2 (L2 movers), 0x4ed…:base or WIF (single-token report).

What it needs

Besides the model you connected to aeon, Token Movers uses the following. Add secrets as GitHub Actions secrets on your aeon repo, or in Aeon Connect.

  • COINGECKO_API_KEY - optional secret, unlocks more data or features
  • ALCHEMY_API_KEY - optional secret, unlocks more data or features
  • XAI_API_KEY - optional secret, unlocks more data or features
  • BASE_RPC_URL - optional secret, unlocks more data or features

Install and run it

Easiest: open Aeon Connect, sign in with GitHub and turn on Token Movers. No clone, no terminal. To add it to an existing aeon repo from a shell, run:

bin/add-skill aeonfun/aeon token-movers

Then switch it on in aeon.yml (the default schedule is filled in):

skills:
  token-movers: { enabled: true, schedule: "0 12 * * *", var: "" }

New to aeon? Read the docs for how skills, schedules and memory fit together, or browse all skills.