SPREDD TERMINAL — Unified Prediction Market API

spredd@terminal:~$ cat /etc/motd

███████╗██████╗ ██████╗ ███████╗██████╗ ██████╗ ██╔════╝██╔══██╗██╔══██╗██╔════╝██╔══██╗██╔══██╗ ███████╗██████╔╝██████╔╝█████╗ ██║ ██║██║ ██║ ╚════██║██╔═══╝ ██╔══██╗██╔══╝ ██║ ██║██║ ██║ ███████║██║ ██║ ██║███████╗██████╔╝██████╔╝ ╚══════╝╚═╝ ╚═╝ ╚═╝╚══════╝╚═════╝ ╚═════╝ T E R M I N A L

One API key. Every prediction market. Full execution.

Market data, order books, quotes, and on-chain trade execution across Kalshi, Polymarket, Myriad, Opinion, and Limitless. One endpoint. Normalized schema. 5 chains.

[ENTER] GET API KEY [D] DOCUMENTATION [F] LIVE FEED

WHAT YOU GET API

GET /v1/markets

Search, sort, and filter markets across all 5 platforms. Sort by volume, liquidity, or price. Price range filters. Normalized schema — same fields everywhere.
POST /v1/markets/prices

Batch prices for up to 500 markets in one call. Also: batch orderbooks (100), batch sparklines (100). One request instead of hundreds.
POST /v1/trading/order

Place market, limit, or stoploss orders. Full lifecycle — create, modify, cancel. Auto-monitoring triggers limit/stoploss when conditions are met.
GET /v1/trading/positions/pnl

Position tracking with realized/unrealized PNL breakdown. Auto-redeem resolved winners. Cost-basis averaging across all platforms.
GET /v1/news + /v1/arbitrage

News articles matched to markets by relevance. Cross-platform arbitrage detection — finds the same question priced differently across platforms.
WS /v1/ws/orderbook + /prices + /trades

3 dedicated WebSocket channels. Subscribe to specific markets for orderbook updates (3s), live prices (5s), or trade events. Pro tier and above.
GET /v1/markets/{id}/price-history

Historical price data and orderbook snapshots with time bucketing (1m to 1d). Sparklines for charts. Data collected every 60 seconds.

TRADING FLOW EXEC

Browse & Search

GET /v1/markets — search, sort by volume/liquidity, filter by price range. Batch prices for 500 markets at once. News feed matched to markets. Free tier.

Quote

POST /v1/trading/quote — real-time pricing before committing. See price, output, slippage, and fees. Paid tiers trade with zero fees.

Order

POST /v1/trading/order — market, limit, or stoploss. Market orders execute instantly. Limit/stoploss are monitored and triggered automatically. Modify or cancel anytime.

Track & Redeem

Positions with PNL tracking. Auto-redeem resolved winners. Historical price charts and orderbook depth. All across 5 platforms in one view.

CHAINS NET

Polygon

POLYMARKET

Solana

KALSHI

Base

LIMITLESS

Abstract

MYRIAD

BSC

OPINION (DATA)

COMING

PRICING TIERS

Free

60 requests/min

10K requests/month

Markets, search, order books

Batch prices & sparklines

Price history & news

Starter templates

1% trade fee

Builder

$79/mo

300 requests/min

100K requests/month

30 trades/min

Everything in Free +

Trading market/limit/stoploss

Orders create/modify/cancel

Positions + PNL tracking

Arbitrage detection

Auto-redeem resolved positions

0% trade fee

Pro

$199/mo

1,000 requests/min

1M requests/month

100 trades/min

Everything in Builder +

WebSocket orderbook/prices/trades

Feed endpoints

0% trade fee

Feed

$499/mo

3,000 requests/min

10M requests/month

Everything in Pro +

Create your own markets

Priority support

0% trade fee

*Free tier: 1% trade fee. Paid tiers ($79/mo+): zero trade fees.

API QUICKSTART REST

# Sign up and get your API key

$ curl -X POST https://api.spreddterminal.com/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com"}'

$ curl -X POST https://api.spreddterminal.com/v1/auth/api-keys \
  -H "Content-Type: application/json" \
  -d '{"account_id": "YOUR_ID", "tier": "builder"}'

# Browse markets across all platforms

$ curl "https://api.spreddterminal.com/v1/markets?search=bitcoin&limit=5" \
  -H "X-API-Key: sprdd_pk_..."

# Response — normalized schema, every platform
[{
  "platform": "polymarket",
  "market_id": "0x1234...",
  "title": "Bitcoin above $150K by EOY?",
  "yes_price": 0.41,
  "no_price": 0.59,
  "volume": 4100000,
  "chain": "polygon",
  "is_active": true
}]

# Get a quote — see price before you commit

$ curl -X POST https://api.spreddterminal.com/v1/trading/quote \
  -H "X-API-Key: sprdd_pk_..." \
  -H "Content-Type: application/json" \
  -d '{"platform":"polymarket","market_id":"0x1234...","outcome":"yes","side":"buy","amount":100}'

{
  "price_per_token": 0.41,
  "expected_output": 243.9,
  "fee_amount": 0.0,
  "fee_bps": 0
}

# Execute — one call, any platform, any chain

$ curl -X POST https://api.spreddterminal.com/v1/trading/execute \
  -H "X-API-Key: sprdd_pk_..." \
  -H "Content-Type: application/json" \
  -d '{"platform":"polymarket","market_id":"0x1234...","outcome":"yes","side":"buy","amount":100,"wallet_address":"0x...","private_key":"0x..."}'

{
  "tx_hash": "0xabc123...",
  "status": "confirmed",
  "explorer_url": "https://polygonscan.com/tx/0xabc123..."
}

FAQ HELP

What is Spredd Terminal?▶

A unified API for prediction markets. One API key gives you market data, order books, price quotes, and on-chain trade execution across Kalshi, Polymarket, Myriad, Opinion Labs, and Limitless. Every response uses the same normalized schema regardless of which platform the data comes from.

Can I actually execute trades through the API?▶

Yes. Place market, limit, or stoploss orders via POST /v1/trading/order. Market orders execute instantly. Limit and stoploss orders are monitored automatically and triggered when your price target is hit. You can also modify or cancel orders anytime. Builder tier ($79/mo) and above.

What are the trading fees?▶

Paid tiers ($79/mo and above) have zero trade fees — your subscription covers everything. The free tier charges a 1% fee per trade. Fee amount is shown in every quote response before you commit.

What order types are supported?▶

Market (immediate execution), Limit (triggers when price reaches your target), and Stoploss (protection against adverse movement). All orders can be listed, modified, and cancelled. Limit/stoploss orders expire after 7 days by default.

Do I need API keys for each platform?▶

No. Spredd handles all platform connections. You get one API key (sprdd_pk_...) and it works across all 5 platforms. Optionally, Polymarket builders can link their own builder account for volume attribution, but it's not required.

Is the free tier actually free?▶

Yes. 60 requests per minute, 10,000 requests per month. Full access to market data, batch endpoints, price history, news, and order books. No credit card required. Trading is available on all tiers (1% fee on free, 0% on paid).

What data features are included?▶

All tiers get: batch prices (500 markets/call), batch orderbooks, sparklines, price history, historical orderbook snapshots with time bucketing, and news articles matched to markets by relevance. Pro tier adds 3 dedicated WebSocket channels for real-time orderbook, price, and trade streaming.

What about position management?▶

Positions are tracked automatically with cost-basis averaging. PNL tracking shows realized and unrealized breakdown. Auto-redeem detects resolved winning positions and queues them for redemption. Available on Builder tier and above.