token-report

name	token-report
description	Daily price performance report for the project's token — price, volume, liquidity, and context
var
tags	["crypto"]

${var} — Token contract address. If empty, uses tracked token from MEMORY.md.

Config

This skill reads the token to track from the "Tracked Token" section in memory/MEMORY.md.

## Tracked Token
| Token | Contract | Chain |
|-------|----------|-------|
| AEON  | 0xbf8e... | base |

---

Read memory/MEMORY.md for the tracked token. Read the last 7 days of memory/logs/ for previous price and volume data to show trends.

Steps

1. Fetch token info from GeckoTerminal (free, no API key needed):

   # Token metadata + price
   curl -s "https://api.geckoterminal.com/api/v2/networks/base/tokens/CONTRACT_ADDRESS"
   

2. Fetch pool data for the token (top liquidity pools):

   # Top pools for this token
   curl -s "https://api.geckoterminal.com/api/v2/networks/base/tokens/CONTRACT_ADDRESS/pools?page=1"
   

3. Fetch OHLCV data for trend analysis:

   # Get the top pool address from step 2, then fetch candles
   # Daily candles for the last 30 days
   curl -s "https://api.geckoterminal.com/api/v2/networks/base/pools/POOL_ADDRESS/ohlcv/day?aggregate=1&limit=30"
   
   # Hourly candles for the last 24h
   curl -s "https://api.geckoterminal.com/api/v2/networks/base/pools/POOL_ADDRESS/ohlcv/hour?aggregate=1&limit=24"
   

4. Fetch recent trades for activity signal:

   curl -s "https://api.geckoterminal.com/api/v2/networks/base/pools/POOL_ADDRESS/trades"
   

5. Search for social sentiment (optional — requires XAI_API_KEY): The sandbox blocks $XAI_API_KEY expansion in curl headers, so this skill consumes results that scripts/prefetch-xai.sh fetched before Claude started.

   Path A (cache present): If .xai-cache/token-report-social.json exists AND .xai-cache/token-report-social.symbol matches the token symbol you just read from MEMORY.md (strip any leading $), parse output[].content[].text / output_text from the JSON and use those tweets + sentiment for the Social Pulse section. Cite @handles and paste permalinks verbatim.

   Path B (no cache / symbol mismatch / empty results): Write one line in the Social Pulse section stating that X/Grok data wasn't available for this run (do NOT claim "XAI_API_KEY not set" — the key may well be set; the prefetch may simply have been skipped, rate-limited, or returned nothing). You may optionally use WebSearch for a loose secondary signal but keep it brief.

6. Compile the daily report:

   # Token Report — ${today}
   
   ## $TOKEN Performance
   
   | Metric | Value | 24h Change |
   |--------|-------|------------|
   | Price | $X.XXXX | +/-Y.Y% |
   | Liquidity | $X.XK | — |
   | 24h Volume | $X.XK | +/-Y.Y% |
   | 24h Buys/Sells | X / Y | — |
   | 24h High/Low | $X.XX / $X.XX | — |
   | FDV | $X.XM | — |
   
   ## Trend
   
   **Price**
   - **24h:** [price action summary from hourly candles]
   - **7-day:** +/-X.X% ([rallying, consolidating, pulling back, etc.])
   - **30-day:** +/-X.X% ([context])
   
   **Volume (daily)**
   - **24h:** $X.XK ([+/-Y.Y% vs prior day])
   - **7-day avg:** $X.XK ([+/-Y.Y% vs prior 7d])
   - **30-day avg:** $X.XK ([context — sustained, spiking, drying up, etc.])
   
   ## Volume & Liquidity
   [Is volume increasing/decreasing? Any notable large trades? Buy/sell ratio?]
   
   ## Social Pulse
   [Key mentions, sentiment, notable tweets from the `.xai-cache/token-report-social.json` Path A cache — or a short "X/Grok data unavailable this run" note when the cache is missing or the symbol sidecar doesn't match]
   
   ## Context
   [1-2 sentences connecting price action to any known events — repo updates, market conditions]
   
   ---
   *Data: GeckoTerminal | Chain: Base*
   *Contract: CONTRACT_ADDRESS*
   

7. Save to articles/token-report-${today}.md

8. Log to memory/logs/${today}.md including the current price and 24h volume (for price/volume trend comparison in future runs). Do this before sending the notification.

9. Send notification via ./notify:

   *$TOKEN Daily — ${today}*
   
   Price: $X.XXXX (Y.Y% 24h)
   Liquidity: $X.XK | 24h Vol: $X.XK (Y.Y% 24h)
   Buys/Sells: X/Y
   7d: +/-X.X% price, +/-X.X% vol | 30d: +/-X.X% price
   
   [1-sentence summary]
   
   Chart: https://www.geckoterminal.com/base/pools/POOL_ADDRESS
   

Important: If the GeckoTerminal API returns no data (token not found, API error, empty response), log "TOKEN_REPORT_NO_DATA" to memory and do NOT send any notification. Do not notify about failures or empty results.