Skills Guide

Delphi Terminal API

VerifiedSafe

Unified interface to query prediction market data across nine exchanges and execute RFQs/trades via the Delphi Terminal API.

Sby Skills Guide Bot
Data & AIIntermediate
207/23/2026
Claude Code
#prediction-market#delphi-terminal#kalshi#polymarket#market-data

Recommended for

Claude CodeData scientistData & analysis

Our review

Query unified prediction market data from nine exchanges, including orderbooks, trade history, and parlay RFQ/trades via the Delphi Terminal API.

Strengths

  • Single API endpoint for real-time data across nine prediction market exchanges.
  • Supports advanced operations like RFQs, MVE trades, and parlays.
  • Semantic search and multi-exchange market clustering.
  • Free test key available for quick evaluation.

Limitations

  • Requires an API key (test key temporary, production key requires signup).
  • Not all exchanges provide full orderbook data (e.g., ForecastEx).
  • Rate limits: 60 req/min for test, 300 req/min for production.
When to use it

Use this skill when you need to fetch, compare, or trade on prediction market odds, orderbooks, or volumes across multiple exchanges.

When not to use it

Avoid if you only need deep historical data for a single exchange not covered by Delphi Terminal.

Security analysis

Safe
Quality score90/100

The skill only provides information for querying a read-only prediction market API. There are no destructive, exfiltrating, or obfuscated instructions. The declared allowed-tools are empty, so risk is minimal.

No concerns found

Examples

Get current odds for a Kalshi market
What are the current odds for the Kalshi market 'Will Bitcoin be above $55,000 on Feb 14, 2025?' using the Delphi Terminal API?
Compare prices across exchanges
Compare the best bid and ask prices for 'Trump wins 2024' on Polymarket and Kalshi using Delphi Terminal.
Parlay RFQ example
I want to request a quote for a parlay that combines 'Kamala Harris wins 2024' on Polymarket and 'Fed cuts rates in Sept' on Kalshi. Use the Delphi Terminal API.

name: delphi-terminal description: Query unified prediction market data (Kalshi, Polymarket, Limitless, Predict.fun, Gemini, Manifold, Opinion, ForecastEx, PredictIt) and parlay RFQs/trades via the Delphi Terminal API. triggers:

  • prediction market
  • Kalshi / KLSI
  • Polymarket / POLY
  • Limitless, Predict.fun, Gemini, Manifold, Opinion, ForecastEx, PredictIt
  • market odds, prices, orderbook, trade history, OHLCV candles
  • RFQ, MVE trades, parlays

Delphi Terminal API — Agent Skill

You are about to query the Delphi Terminal API, a single interface for prediction market data across nine exchanges and a parlays/RFQ feed. This file is the authoritative guide. Follow it literally.

When to use this skill

Use this skill whenever the user asks about:

  • Prediction market odds, prices, volume, liquidity, spreads
  • Orderbooks, top-of-book, raw orderbook deltas
  • Trade history or OHLCV candles
  • Market search, semantic search, categories, events, clusters
  • Parlay RFQs, MVE trades
  • Bulk historical data exports (parquet)
  • Real-time streaming via WebSockets

If the user names any of these exchanges or asks for "live odds," default to this skill: Kalshi, Polymarket, Limitless, Predict.fun, Gemini, Manifold, Opinion, ForecastEx, PredictIt.

Base URLs

| Purpose | URL | | ------- | --- | | REST API | https://api.delphiterminal.co | | WebSockets | wss://api.delphiterminal.co | | Docs (this skill lives here) | https://docs.delphimarkets.com |

Authentication — do this first

Every REST request needs X-API-Key: <key> in the headers. WebSockets require the key as an api_key query param.

Bootstrap flow (when the user has no key)

  1. Generate a free test key (10-minute TTL, 60 req/min, no auth required):

    curl -X POST https://api.delphiterminal.co/api/v1/test-key

    Response:

    { "api_key": "dphi_live_a1b2c3d4...", "expires_at": "...", "expires_in": "10 minutes" }

  2. Save api_key and pass it on every subsequent call.

  3. For production usage, direct the user to https://delphimarkets.com to request a permanent key (300 req/min).

Rate limits and errors

| Key type | Limit | | -------- | ----- | | Test | 60 req/min | | Production | 300 req/min |

| Code | Meaning | | ---- | ------- | | 400 | Bad Request — invalid parameters | | 401 | Unauthorized — missing or invalid API key | | 404 | Not Found — resource doesn't exist | | 429 | Too Many Requests — back off and retry | | 500 | Server error — retry with jitter |

Errors return {"error": "..."}.

Exchanges and identifiers

| Exchange | Prefix in path | ID field | ID format example | | -------- | -------------- | -------- | ----------------- | | Kalshi | /klsi/ | klsi_id | KXBTCD-25FEB14-B55000 | | Polymarket | /poly/ | poly_id / condition_id | 0xb09a659b55f0eab385d75ef14d180e9a6b... | | Limitless | /limitless/ | market_id | opaque string | | Predict.fun | /pfun/ | market_id | opaque string | | Gemini | /gemini/ | market_id | GEMI-BTC15M-HI70000 | | Manifold | /manifold/ | market_id | slug like Iz0lRpO85N | | Opinion | /opinion/ | market_id | numeric string like 10702 | | ForecastEx | /fex/ | market_id | EMCAC_1226_24 (no orderbook) | | PredictIt | /predictit/ | market_id | numeric string like 34256 (prices only) |

Delphi also has a unified delphi_id that clusters equivalent markets across exchanges — useful for cross-venue comparisons.

REST endpoint cheat-sheet

All paths are relative to https://api.delphiterminal.co. Send X-API-Key on every call except where noted.

Auth and keys

| Method | Path | Purpose | | ------ | ---- | ------- | | POST | /api/v1/test-key | Free 10-min test key (no auth) | | POST | /api/v1/auth/signup | Create user account | | POST | /api/v1/auth/login | Get session token | | GET | /api/v1/auth/me | Current user info | | POST | /api/v1/auth/logout | Invalidate session |

Cross-exchange search and discovery

| Method | Path | Purpose | | ------ | ---- | ------- | | GET | /api/v1/events/search?q=<text> | Free-text event search | | GET | /api/v1/search/suggest?q=<text> | Typeahead suggestions | | GET | /api/v1/search/markets?q=<text> | Keyword market search | | GET | /api/v1/search/semantic?q=<text> | Vector/semantic market search | | GET | /api/v1/events/{event_id} | Event details | | GET | /api/v1/events/category/{category} | Events in a category | | GET | /api/v1/events/category/{category}/klsi | Kalshi events in a category | | GET | /api/v1/events/category/{category}/poly | Polymarket events in a category | | GET | /api/v1/markets/{market_id}/orderbook_analytics | Unified orderbook analytics | | GET | /api/v1/markets/{market_id}/orderbook_analytics/best_quotes | Unified best quotes |

Delphi clustering (cross-exchange equivalence)

| Method | Path | Purpose | | ------ | ---- | ------- | | GET | /api/v1/delphi/{delphi_id}/cluster | Get a cluster by delphi ID | | GET | /api/v1/delphi/{delphi_id}/markets | All markets in a delphi cluster | | GET | /api/v1/clusters/{cluster_id} | Cluster detail | | GET | /api/v1/klsi/{klsi_id}/cluster | Cluster for a Kalshi market | | GET | /api/v1/poly/{poly_id}/cluster | Cluster for a Polymarket market | | GET | /api/v1/limitless/{market_id}/cluster | Cluster for a Limitless market | | GET | /api/v1/pfun/{market_id}/cluster | Cluster for a Predict.fun market |

Kalshi (KLSI)

| Method | Path | Purpose | | ------ | ---- | ------- | | GET | /api/v1/klsi/markets | List markets (paginated) | | GET | /api/v1/klsi/markets/categories | All categories | | GET | /api/v1/klsi/markets/category/{category} | Markets by category | | GET | /api/v1/klsi/{klsi_id}/market | Market detail | | GET | /api/v1/klsi/{klsi_id}/rules | Market rules | | GET | /api/v1/klsi/{klsi_id}/prices | Price history | | GET | /api/v1/klsi/{klsi_id}/candles | OHLCV candles | | GET | /api/v1/klsi/{klsi_id}/top_of_book | Best bid/ask | | GET | /api/v1/klsi/{klsi_id}/orderbook | Full orderbook (up to 101 levels) | | GET | /api/v1/klsi/{klsi_id}/raw_deltas | Raw orderbook deltas | | GET | /api/v1/klsi/{klsi_id}/tradehistory | Trade history | | GET | /api/v1/klsi/{klsi_id}/orderbook_analytics | Orderbook analytics | | GET | /api/v1/klsi/{klsi_id}/orderbook_analytics/best_quotes | Best quotes analytics | | GET | /api/v1/klsi/event/{event_id} | Kalshi event detail | | GET | /api/v1/klsi/event/{event_id}/markets | Markets under a Kalshi event |

Polymarket (POLY)

| Method | Path | Purpose | | ------ | ---- | ------- | | GET | /api/v1/poly/markets | List markets | | GET | /api/v1/poly/markets/categories | All categories | | GET | /api/v1/poly/markets/category/{category} | Markets by category | | GET | /api/v1/poly/{poly_id}/market | Market detail | | GET | /api/v1/poly/{poly_id}/rules | Market rules | | GET | /api/v1/poly/{poly_id}/prices | Price history | | GET | /api/v1/poly/{poly_id}/top_of_book | Best bid/ask | | GET | /api/v1/poly/{poly_id}/orderbook | Full orderbook | | GET | /api/v1/poly/{poly_id}/raw_deltas | Raw orderbook deltas | | GET | /api/v1/poly/{poly_id}/tradehistory | Trade history | | GET | /api/v1/poly/{poly_id}/event | Event for a Polymarket market | | GET | /api/v1/poly/event/{event_id}/markets | Markets under a Polymarket event |

Limitless

| Method | Path | Purpose | | ------ | ---- | ------- | | GET | /api/v1/limitless/markets | List markets | | GET | /api/v1/limitless/{market_id}/market | Market detail | | GET | /api/v1/limitless/{market_id}/top_of_book | Best bid/ask | | GET | /api/v1/limitless/{market_id}/orderbook | Full orderbook | | GET | /api/v1/limitless/{market_id}/tradehistory | Trade history | | GET | /api/v1/limitless/{market_id}/exchange_prices | Raw exchange prices |

Predict.fun (PFUN)

| Method | Path | Purpose | | ------ | ---- | ------- | | GET | /api/v1/pfun/markets | List markets | | GET | /api/v1/pfun/{market_id}/market | Market detail | | GET | /api/v1/pfun/{market_id}/top_of_book | Best bid/ask | | GET | /api/v1/pfun/{market_id}/orderbook | Full orderbook | | GET | /api/v1/pfun/{market_id}/tradehistory | Trade history | | GET | /api/v1/pfun/{market_id}/exchange_prices | Raw exchange prices |

Gemini, Manifold, Opinion, ForecastEx, PredictIt

Same shape as above. Substitute the prefix:

| Exchange | List | Detail | Orderbook | Prices | Trades | | -------- | ---- | ------ | --------- | ------ | ------ | | Gemini | /api/v1/gemini/markets | /api/v1/gemini/{market_id}/market | /api/v1/gemini/{market_id}/orderbook | /api/v1/gemini/{market_id}/prices | /api/v1/gemini/{market_id}/tradehistory | | Manifold | /api/v1/manifold/markets | /api/v1/manifold/{market_id}/market | /api/v1/manifold/{market_id}/orderbook | /api/v1/manifold/{market_id}/prices | /api/v1/manifold/{market_id}/tradehistory | | Opinion | /api/v1/opinion/markets | /api/v1/opinion/{market_id}/market | /api/v1/opinion/{market_id}/orderbook | /api/v1/opinion/{market_id}/prices | /api/v1/opinion/{market_id}/tradehistory | | ForecastEx | /api/v1/fex/markets | /api/v1/fex/{market_id}/market | — (no orderbook) | — | /api/v1/fex/{market_id}/tradehistory | | PredictIt | /api/v1/predictit/markets | /api/v1/predictit/{market_id}/market | — (no orderbook) | /api/v1/predictit/{market_id}/prices | — |

Parlays and RFQs (Pro+ plan)

| Method | Path | Purpose | | ------ | ---- | ------- | | GET | /api/v1/klsi/{klsi_id}/rfq | RFQs for a Kalshi market | | GET | /api/v1/klsi/{klsi_id}/mve_trades | MVE trades for a Kalshi market | | GET | /api/v1/klsi/rfq/{rfq_id} | Single RFQ by ID | | GET | /api/v1/klsi/rfq/date/{date} | RFQs for a date (YYYY-MM-DD) |

Bulk data export (parquet)

| Method | Path | Purpose | | ------ | ---- | ------- | | GET | /api/v1/data/{dataset}?date=YYYY-MM-DD | Presigned parquet download URLs for a date | | GET | /api/v1/data/{dataset}/latest | Today's parquet export |

Supported datasets: rfqs, mve_trades.

WebSockets — unified pattern

Every exchange uses the same subscribe/unsubscribe contract; only the endpoint, ID field, and available message types change.

Connect

const ws = new WebSocket(
  "wss://api.delphiterminal.co/ws/<exchange>?api_key=YOUR_API_KEY"
);

Connection properties: ping every 54s, 60s pong timeout, 512KB max message.

Subscribe

{
  "action": "subscribe",
  "<ID_FIELD>": ["<market_id>", "..."],
  "message_types": ["prices", "orderbook", "trades"]
}

message_types defaults to ["prices", "orderbook"] if omitted. action: "unsubscribe" removes subscriptions.

Per-exchange reference

| Exchange | Endpoint | ID field | Available message_types | | -------- | -------- | -------- | ----------------------- | | Kalshi | /ws/kalshi | klsi_ids | prices, orderbook, trades | | Polymarket | /ws/poly | condition_ids | prices, orderbook, trades | | Predict.fun | /ws/pfun | market_ids | prices, orderbook, trades | | Limitless | /ws/limitless | market_ids | prices, orderbook, trades | | Gemini | /ws/gemi | market_ids | prices, orderbook, trades | | Manifold | /ws/mani | market_ids | prices, orderbook, trades | | Opinion | /ws/opnm | market_ids | prices, orderbook, trades | | ForecastEx | /ws/fex | market_ids | prices, trades (no orderbook) | | PredictIt | /ws/prdi | market_ids | prices only | | Parlays | /ws/parlays | market_ids | rfq, mve_trades (Pro+ plan) |

Worked examples

1. Semantic search across all exchanges

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.delphiterminal.co/api/v1/search/semantic?q=will%20bitcoin%20hit%20100k%20this%20year" | jq

2. Pull Kalshi orderbook

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.delphiterminal.co/api/v1/klsi/KXBTCD-25FEB14-B55000/orderbook" | jq

3. Pull Polymarket trade history

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.delphiterminal.co/api/v1/poly/0xb09a659b55f0eab385d75ef14d180e9a6b2f02290a427504e38bf803e35d25d6/tradehistory?limit=50" | jq

4. Stream Kalshi prices + orderbook

const ws = new WebSocket(
  "wss://api.delphiterminal.co/ws/kalshi?api_key=" + process.env.API_KEY
);

ws.onopen = () => {
  ws.send(JSON.stringify({
    action: "subscribe",
    klsi_ids: ["KXBTCD-25FEB14-B55000"],
    message_types: ["prices", "orderbook", "trades"],
  }));
};

ws.onmessage = (event) => console.log(JSON.parse(event.data));

5. Download a parquet export

curl -s -H "X-API-Key: $API_KEY" \
  "https://api.delphiterminal.co/api/v1/data/rfqs?date=2026-02-13" > export.json
URL=$(jq -r '.parts[0].url' export.json)
curl -L "$URL" -o rfqs_2026-02-13.parquet
duckdb -c "SELECT * FROM read_parquet('rfqs_2026-02-13.parquet') LIMIT 20;"

Presigned URLs expire in ~5 minutes. Re-request metadata if the download fails.

Operating guidelines for the agent

  • Prefer search first. When the user names a topic, call /api/v1/search/semantic or /api/v1/events/search before guessing market IDs.
  • Use clusters for cross-venue answers. If the user asks "which exchange has the best price for X," fetch /api/v1/delphi/{delphi_id}/markets or the per-exchange /cluster endpoints and compare top_of_book.
  • Paginate. All list endpoints accept limit and offset (or cursor). Default limit=50.
  • Stream, don't poll. If the user wants live updates, use the WebSocket for that exchange.
  • Handle 429s with exponential backoff. Never hammer on retry.
  • Never hardcode IDs. Look them up dynamically from search or the markets list.
  • Surface the API key source. If you minted a test key, tell the user it expires in 10 minutes and point them to https://delphimarkets.com for a production key.

When the cheat-sheet isn't enough

Fetch these on demand for full schemas and edge cases:

  • Full REST spec: https://docs.delphimarkets.com/openapi.json
  • Parlays spec: https://docs.delphimarkets.com/openapi-parlays.json
  • WebSocket spec: https://docs.delphimarkets.com/openapi-websockets.json
  • Full flat docs dump: https://docs.delphimarkets.com/llms-full.txt
  • Per-exchange WebSocket pages:
    • https://docs.delphimarkets.com/ws-kalshi.md
    • https://docs.delphimarkets.com/ws-polymarket.md
    • https://docs.delphimarkets.com/ws-pfun.md
    • https://docs.delphimarkets.com/ws-limitless.md
    • https://docs.delphimarkets.com/ws-gemi.md
    • https://docs.delphimarkets.com/ws-mani.md
    • https://docs.delphimarkets.com/ws-opnm.md
    • https://docs.delphimarkets.com/ws-fex.md
    • https://docs.delphimarkets.com/ws-prdi.md
    • https://docs.delphimarkets.com/ws-parlays.md
  • Topical pages: /introduction.md, /quickstart.md, /authentication.md, /data-extraction.md, /klsi-examples.md, /polymarket-examples.md, /websocket-examples.md, /changelog.md.
Related skills

Prompt Engineering

Data & AI

Prompt engineering best practices and templates to maximize AI outputs.

claudeCursorWindsurf+1beginner
289
78
852
Admin

Data Visualization

Data & AI

Generates data visualizations and charts tailored to your data.

claudeCursorWindsurfintermediate
198
56
683
Admin

RAG Architecture Setup

Data & AI

Setup guide for RAG (Retrieval-Augmented Generation) architectures.

claudeCursorWindsurfadvanced
167
51
645
Admin