The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Oathscore listing page.
Every API makes promises. OathScore checks the receipts.
The trust layer for AI agents. Two products:
/now — A single endpoint returning the current state of the world for trading agents. Exchange status, volatility, events, regime, data health — one call.Requires: pip install httpx mcp[cli] and clone this repo.
| Tool | Description |
|---|---|
get_now | Current world state: exchanges, volatility, events, data health |
get_exchanges | Open/close status for 7 exchanges with next transition times |
get_volatility | VIX, VIX9D, VIX3M, VVIX, SKEW, term structure |
get_events | Next event, FOMC/CPI countdowns, week high-impact count |
get_score | OathScore rating for a specific API (0-100 composite + grade) |
compare_apis | Side-by-side comparison of two or more data APIs |
get_alerts | Active degradation alerts for monitored APIs |
check_health | Service health and data freshness |
For each rated API:
| Metric | Weight | How Measured |
|---|---|---|
| Accuracy | 35% | Compare forecasts/claims to actual outcomes daily |
| Uptime | 20% | Synthetic monitoring every 60 seconds |
| Freshness | 15% | Is "real-time" actually real-time? |
| Latency | 15% | P50/P95/P99 from multiple regions |
| Schema stability | 5% | Detect breaking changes |
| Documentation | 5% | OpenAPI spec, llms.txt, examples |
| Trust signals | 5% | Published accuracy data, response signing |
| API | Category | Score | Status |
|---|---|---|---|
| Curistat | Futures volatility | -- | Monitoring |
| Alpha Vantage | Equities/macro | -- | Monitoring |
| Polygon.io | Market data | -- | Monitoring |
| Finnhub | Multi-asset | -- | Monitoring |
| Twelve Data | Market data | -- | Monitoring |
| EODHD | Historical data | -- | Monitoring |
| Financial Modeling Prep | Fundamentals | -- | Monitoring |
Scores populate after 30 days of monitoring data.
/llms.txt — Agent-readable product description/llms-full.txt — Complete endpoint documentation/.well-known/ai-plugin.json — ChatGPT plugin manifest/openapi.json — OpenAPI 3.0.3 spec/docs — Interactive Swagger UI| Tier | /now Calls | Score Queries | Price |
|---|---|---|---|
| Free | 10/day | 5/day | $0 |
| Founding (first 50) | 5,000/day | 2,500/day | $9/mo (lifetime) |
| Pro | 10,000/day | 5,000/day | $29/mo |
| Enterprise | 100,000/day | 50,000/day | $99/mo |
| Pay-per-request (x402) | Unlimited | Unlimited | $0.001-0.005/call |
x402 micropayments: No signup needed. Agents pay per request with USDC stablecoins via the x402 protocol. When rate limited, the API returns 402 Payment Required with payment instructions.
API audits: Independent 7-day quality audit of your API — $299-499. Contact us.
Add to your MCP config (~/.claude/mcp.json or Claude Desktop settings):
Then ask Claude: "What's the current market state?" or "How reliable is Alpha Vantage?"
If this is useful, star the repo — it helps others find it.
Proprietary. All rights reserved.