Skip to content
COLTFABLE

DOCS

Field manual.

What the station is

ColtFable is an autonomous research station. You give it a contract, wallet, ticker, protocol name, tokenized equity or market address. It identifies the subject from live sources, collects evidence, dispatches six agents, lets them argue, and publishes a verdict together with everything it could not verify.

Where the numbers come from

Prices, liquidity, volume and pair data come from DexScreener (with GeckoTerminal as a fallback on Robinhood Chain). Bytecode, ERC-20 metadata, balances, nonces and transactions come from read-only JSON-RPC on Ethereum, Base and Robinhood Chain. Holder counts, source verification and token holdings come from Blockscout. Every value carries its source, block, timestamp and age. If a source fails, the value is shown as unavailable.

What Claude does

Claude is the reasoning layer only. Each agent receives the normalised evidence brief and returns a structured summary, findings labelled fact / interpretation / opinion, risks, a confidence score and a list of missing evidence. The API key lives on the server. Without a key the station runs a deterministic rules engine and labels every output RULES.

How to read a verdict

The label is one of CONSTRUCTIVE, CAUTIOUSLY CONSTRUCTIVE, NEUTRAL, CAUTIOUS, ADVERSE or INSUFFICIENT EVIDENCE. Confidence is capped at 90% and lowered by unresolved disagreement. WHY lists the findings that carried the verdict. WHAT THE STATION COULD NOT VERIFY is the most important section: it is the list of things you still have to check yourself.

The agents

  • SCOUTMarket Discovery. Searches available market and contract data. First out of the airlock, first back with a source list.
  • ICEBREAKERMarket Structure. Inspects liquidity, market structure and abnormal activity. Speaks in ratios.
  • WARDENRisk & Evidence. Looks for risk, suspicious patterns and weak evidence. Assumes nothing until it is on-chain.
  • ARCHIVISTHistory. Checks historical data and previous station sessions. Rarely speaks; when it does, it cites a date.
  • NAVIGATORDirection. Interprets market direction and important changes. Frames what the evidence would have to show next.
  • COLTLead Synthesis. Lead agent. Weighs the specialists, records the disagreement, and publishes only what survives the cold.

Pipeline states

  • queued → QUEUED
  • collecting_data → COLLECTING DATA
  • dispatching_agents → AGENTS WORKING
  • debating → DEBATE IN PROGRESS
  • synthesizing → SYNTHESIZING VERDICT
  • completed → VERDICT PUBLISHED
  • failed → SESSION FAILED

API

POST /api/research            { query, network: auto|ethereum|base|robinhood } → { id }
GET  /api/research/:id        progressive session state
GET  /api/research/:id/stream NDJSON snapshots while the pipeline runs
GET  /api/archive             ?filter=all|tokens|markets|contracts|wallets&q=
GET  /api/station             live events from real sessions + capabilities
GET  /api/agents              per-agent run statistics
GET  /api/system              live reachability of every data source