Skip to main content

​
What is Parsec?

Parsec gives you one contract for prediction market discovery, pricing, streaming, and cross-exchange matching. Start by finding a market with /markets, then reuse the returned identifiers everywhere else.

Market Data API

Browse the REST endpoints, identifier model, and response conventions.

Trading Setup

Choose managed, self, or per-request credentials for trading flows.

Builder Program

Build for end-users with impersonation, onboarding, and fee routing.

​
Choose your path

Explore Markets

Use Parsec as one market-data layer across exchanges.

Trade Your Account

Connect credentials or a managed wallet, then place orders through one router.

Build for Users

Create end-users, impersonate requests, and collect fees as a builder.

​
Quickstart

​
1. Get an API key

Create an account at parsecapi.com, then copy your key from the dashboard. 
export PARSEC_API_KEY="pk_live_YOUR_KEY"

​
2. Find a market first

Use /markets for discovery. The response gives you all of the identifiers you need for downstream endpoints: 
curl -H "X-API-Key: $PARSEC_API_KEY" \
  "https://api.parsecapi.com/api/v1/markets?exchanges=kalshi&search=bitcoin&limit=1"

{
  "markets": [
    {
      "parsec_id": "kalshi:KXBTC-26MAR10",
      "exchange": "kalshi",
      "exchange_market_id": "KXBTC-26MAR10",
      "question": "Will Bitcoin close above $85,000 on March 10?"
    }
  ],
  "pagination": {
    "count": 1,
    "total": 1,
    "has_more": false
  }
}
parsec_id is Parsec’s standard market ID. It is just {exchange}:{exchange_market_id}, so you can either use it directly or derive it from the exchange-native ID you just found.

​
3. Reuse either selector form on market-data endpoints

The data endpoints accept either parsec_id or exchange + market_id: 
# Canonical selector
curl -H "X-API-Key: $PARSEC_API_KEY" \
  "https://api.parsecapi.com/api/v1/orderbook?parsec_id=kalshi:KXBTC-26MAR10&outcome=yes"

# Equivalent native selector
curl -H "X-API-Key: $PARSEC_API_KEY" \
  "https://api.parsecapi.com/api/v1/orderbook?exchange=kalshi&market_id=KXBTC-26MAR10&outcome=yes"

​
4. Pull cross-exchange matches

Once you have a market, ask for the published same_market links: 
curl -H "X-API-Key: $PARSEC_API_KEY" \
  "https://api.parsecapi.com/api/v1/markets?parsec_ids=kalshi:KXBTC-26MAR10&include_matches=true"
Matched counterparts are returned on each market as matched_markets, including the counterpart exchange, confidence metadata, and counterpart status (active, closed, or archived).

​
5. Stream live updates when polling is not enough

Use the WebSocket API for live orderbooks, trades, and fills: 
{ "type": "auth", "api_key": "pk_live_YOUR_KEY" }

{
  "type": "subscribe",
  "markets": [{ "parsec_id": "kalshi:KXBTC-26MAR10", "outcome": "Yes", "depth": 10 }]
}
See WebSocket Overview for the connection flow and protocol docs.
Ready to trade? Start with Trading Setup to choose self, managed, or per-request credentials before you use the Order Router.