# Prediction Market X Sentiment API

> Pay-per-call sentiment for Polymarket and Kalshi markets, scored from live X (Twitter) chatter by Grok. Payments are USDC on Base (eip155:8453) via the x402 protocol (HTTP 402). No account or API key.

Base URL: https://prediction-bot-iggf.onrender.com

## Free routes
- [Catalog](https://prediction-bot-iggf.onrender.com/catalog): every route, price, network and pay-to address (JSON)
- [Pricing](https://prediction-bot-iggf.onrender.com/pricing): price ladder (JSON)
- [Sample](https://prediction-bot-iggf.onrender.com/sample): static example response, no live data (JSON)
- [Health](https://prediction-bot-iggf.onrender.com/health): status and prices (JSON)
- [OpenAPI](https://prediction-bot-iggf.onrender.com/openapi.json): full schemas for every route

## Paid routes (x402)
- GET /top ($0.35): 3 most-discussed Polymarket/Kalshi markets on X, each with score, catalyst, volume_signal
- GET /shift?q=QUESTION ($0.35): score change vs the previous cached score
- GET /sentiment?q=QUESTION ($0.35): score -100..100, catalyst, volume_signal
- GET /brief?q=QUESTION ($0.35): score, catalyst, volume_signal, shift, one-line summary and live Polymarket and Kalshi odds (Yes price) for the matched market

q is the exact market question, e.g. "Will Bitcoin hit 150k in 2026". Scores are cached 300s per question.

## How to pay
1. Request a paid route; the server answers 402 with a base64 PAYMENT-REQUIRED header (price, network, asset, pay-to).
2. Sign the USDC payment with an x402 client and retry with the PAYMENT-SIGNATURE header.

## MCP
Install as an MCP server: uvx --from git+https://github.com/wballztrading1/Prediction-bot#subdirectory=mcp_server prediction-bot-mcp
Source and docs: https://github.com/wballztrading1/Prediction-bot