Research desk

Agent token 5. The research desk is the firm's window onto the broader market mood. It pulls only free public APIs (no paid walls) and bundles them into a context read for the PM. It's deliberately cheap and extensible from the public-apis catalog.

What it reads

firm/organization.py · tool_research():

• Fear & Greed index — alternative.me (value + classification).
• Global market — CoinGecko: total market-cap 24h change, BTC dominance, active-crypto count.
• Trending coins — CoinGecko top trending symbols.
• Majors 24h change — CoinGecko simple-price for BTC / ETH / NEAR.

Data flow

Output (shape)

{
  "fear_greed_index": { "value": 54, "label": "Neutral" },
  "global_market": { "total_mcap_change_24h_pct": -1.2, "btc_dominance_pct": 58.3, "active_cryptos": 13000 },
  "trending_coins": ["…", "…"],
  "majors_24h_change_pct": { "bitcoin": -0.8, "ethereum": -1.1, "near": -2.0 },
  "note": "External macro research via free public APIs — extensible from the public-apis catalog."
}

Honest caveats

This desk is context, not signal — sentiment indices and dominance are slow-moving and weakly predictive at a 4h–24h horizon. Its job is to tell the PM what the weather is (risk-on vs risk-off), not to call direction. Everything is keyless and free, so it never blocks a cycle on a quota.