API Access
Pricing
The Seshat API is free and public today — every endpoint is open, no key required. Paid Pro and Enterprise tiers and x402 micropayments are planned for the roadmap and are not yet available.
Base URL
https://seshat.stealthbundlebot.workers.dev
| Method | Endpoint | Description | Access |
|---|---|---|---|
| GET | /api/tokens | Ranked token list with composite scores | Public |
| GET | /api/tokens/:address | Full token detail: score, fees, dev, research, identity | Public |
| GET | /api/tokens/:address/similar | Semantically similar tokens (Vectorize) | Public |
| GET | /api/tokens/:address/swarm | Latest multi-persona swarm sentiment | Public |
| GET | /api/tokens/hidden-gems | Active dev + low volume + unclaimed fees | Public |
| GET | /api/fees/dormant | Dormant unclaimed-fee opportunities + dormancy | Public |
| GET | /api/fees/opportunities | Latest unclaimed fee leaderboard | Public |
| GET | /api/fees/:address | Fee scan history for a token | Public |
| GET | /api/narratives | Trending narrative clusters by momentum | Public |
| GET | /api/developers | Developer score leaderboard | Public |
| GET | /api/developers/:wallet | Full developer profile + scored tokens | Public |
| GET | /api/scores | Top composite scores | Public |
| GET | /api/scores/:address/history | Score history over time for a token | Public |
| GET | /api/weights | Active self-learning scoring weights | Public |
| GET | /api/alerts | Recent alerts (filter by type, hours) | Public |
| POST | /api/chat | Streaming LLM chat over live DB context (SSE) | Rate-limited |
| POST | /api/track/:address | Subscribe to alerts for a contract address | Public |
| DELETE | /api/track/:address | Unsubscribe from contract alerts | Public |
| GET | /api/track/:address/claims | On-chain fee claim event history | Public |
| GET | /api/track/:address/chart | Daily fee accrual chart for a token | Public |
Authentication
All GET endpoints above are public and require no authentication — read freely. Only admin/operations endpoints (/api/admin/*) require a bearer token, and the chat endpoint is rate-limited per IP.
Public read
GET /api/tokens # no header required
Admin (bearer)
POST /api/admin/score/:address Authorization: Bearer <ADMIN_API_TOKEN>
Public reads
Unmetered
fair-use
Chat (/api/chat)
Per-IP hourly cap
CHAT_RATE_LIMIT_PER_HOUR
Admin
Bearer token
ADMIN_API_TOKEN