Octodamus Intelligence Oracle
AI oracle: BTC/ETH/SOL signals, Polymarket edges, congressional trades. x402 $0.01/call on Base.
Open source Repository Open in the app JSON README (API)
About
AI oracle: BTC/ETH/SOL signals, Polymarket edges, congressional trades. x402 $0.01/call on Base.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- octodamus
- Origin
- official
- Category
- ferramentas
- Transport
- sse
- Version
- 1.2.0
- Stars
- 1
- Last push
- 2026-09-02T16:21:19Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:02:08
- Updated
- 2026-08-29 03:02:08
- Origin id
io.github.Octodamus/market-intelligence
README
# Octodamus Market Intelligence MCP Server
AI-consensus market oracle for autonomous agents. 27 live data feeds. BUY/SELL/HOLD signals with confidence scores, Polymarket edges, Fear & Greed, congressional trading, on-chain order flow, and macro regime — all in one MCP tool call.
**Smithery:** [octodamusai/market-intelligence](https://smithery.ai/server/octodamusai/market-intelligence)
**API:** [api.octodamus.com](https://api.octodamus.com)
**X:** [@octodamusai](https://x.com/octodamusai)
---
## Tools
| Tool | Description | Auth |
|------|-------------|------|
| `get_agent_signal` | BUY/SELL/HOLD + confidence + Fear & Greed + BTC price + Polymarket edges | Free |
| `get_market_brief` | One-paragraph oracle read across all assets + macro. Drop into any LLM system prompt. | Free |
| `get_polymarket_edge` | Prediction market opportunities with EV, true probability, Kelly sizing | Free |
| `get_sentiment` | AI sentiment score per asset (-1.0 bearish to +1.0 bullish) | Free (BTC) |
| `get_prices` | Live prices with 24h change for BTC, ETH, SOL (+ stocks with key) | Free |
| `get_oracle_signals` | Raw 11-signal consensus votes — RSI, MACD, funding rate, L/S ratio, taker flow, whale moves | API key |
| `get_data_sources` | All 27 live data feeds with update frequencies | Free |
| `get_all_data` | Everything in one call — signal + edges + sentiment + prices + brief | API key |
---
## Installation
### Claude Desktop / Cursor / Windsurf
Add to your MCP config:
```json
{
"mcpServers": {
"octodamus": {
"url": "https://api.octodamus.com/mcp",
"config": {
"apiKey": ""
}
}
}
}
```
Leave `apiKey` blank for free tools (500 req/day). Get a free key: `POST https://api.octodamus.com/v1/signup?email=you@example.com`
### Smithery (one-click install)
```bash
npx @smithery/cli install octodamusai/market-intelligence
```
---
## Example Output
```json
{
"action": "BUY",
"confidence": "high",
"signal": {"asset": "BTC", "direction": "LONG", "timeframe": "1W"},
"fear_greed": {"value": 17, "label": "Extreme Fear"},
"btc": {"price_usd": 81385, "change_24h": 2.64, "trend": "UP"},
"polymarket_edge": [
{"question": "BTC above $90k by June?", "side": "YES", "ev": 0.22, "confidence": "high"}
],
"reasoning": "Extreme fear + LONG signal + macro dip = accumulation zone.",
"track_record": {"wins": 5, "losses": 6, "total": 11}
}
```
---
## Pricing
| Plan | Price | Limit |
|------|-------|-------|
| Free | $0 | 500 req/day |
| Pay-per-call | $0.01 USDC/call | Unlimited — x402 on Base, no account needed |
| Annual | $29/year | 10k req/day |
x402 payments: Base chain (eip155:8453), USDC. No account or credit card required — just a funded Base wallet.
Signup: `POST https://api.octodamus.com/v1/signup?email=your@email.com`
---
## Signal Coverage
- **Crypto:** BTC, ETH, SOL
- **Stocks:** NVDA, TSLA, AAPL, MSFT, SPY (+ tokenized versions on Base via Dinari)
- **Macro:** FRED yield curve, DXY, VIX, M2, Fed probability (CME FedWatch)
- **On-chain:** Binance 24h delta, Base DEX flow, whale wallet moves
- **Sentiment:** Grok/X crowd sentiment with contrarian divergence flags (BULL_TRAP/BEAR_TRAP)
- **Congressional:** Finance Committee insider trading on mega-cap stocks (QuiverQuant)
- **Prediction markets:** Polymarket edges with EV and Kelly sizing
---
## Ed25519 Verification
All premium responses are signed with Octodamus's Ed25519 key for on-chain verification. The public key is published at `https://api.octodamus.com/.well-known/x402.json` under `signing`.
```python
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey
import base64, json
response = ... # API response dict
pubkey_b64 = response["signer_pubkey"]
sig_b64 = response["signature"]
payload = {k: v for k, v in response.items() if k not in ("signature", "signer_pubkey")}
canonical = json.dumps(payload, sort_keys=True, separators=(",", ":")).encode()
key = Ed25519PublicKey.from_public_bytes(base64.b64decode(pubkey_b64))
key.verify(base64.b64decode(sig_b64), canonical) # raises if invalid
```
---
## ACP (Agent Commerce Protocol)
14 offerings available for agent-to-agent commerce via Virtuals ACP ($1.00-$2.00 USDC/job):
- Market Signal (BTC/ETH/SOL) $1.00
- Grok Sentiment Brief $1.00
- Fear vs Crowd Divergence $2.00
- BTC Bull Trap Monitor $1.50
- Overnight Asia Brief $2.00
- Tokenized Stock Signal (AAPL/MSFT/SPY on Base) $1.00
- MacroMind Brief $1.00 | StockOracle Brief $1.00
- Order ChainFlow Brief $1.00 | X Sentiment Brief $1.00
Discovery: `GET https://api.octodamus.com/.well-known/acp.json`
---
## License
MIT — see [LICENSE](LICENSE)