API Reference

Authentication

All API requests require an API key. Pass it via the X-API-Key header or the Authorization: Bearer header.

Scopes

Getting an API Key

API keys are provisioned on request. Contact us via GitHub Issues or email to request access.

Example

curl -H "X-API-Key: $API_KEY" https://api.varshtat.com/v1/secmaster/stats

Secmaster Stats

Returns aggregate counts and status breakdowns for events, markets, pairs, and conditions. No parameters required.

Example

curl -H "X-API-Key: $API_KEY" https://api.varshtat.com/v1/secmaster/stats

Response

{
  "events": { "total": 1250, "active": 340, "closed": 910 },
  "markets": { "total": 8500, "active": 1200, "closed": 7300 },
  "pairs": { "total": 45, "active": 42, "halted": 3 },
  "conditions": { "total": 3200, "active": 890, "resolved": 2310 }
}

Kalshi

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/events?status=active&limit=50"

Response

{
  "events": [
    {
      "ticker": "KXBTCD-26FEB28",
      "title": "Bitcoin above $105,249.99 on Feb 28?",
      "category": "Crypto",
      "series": "KXBTCD",
      "status": "active",
      "strikeDate": "2026-02-28T17:00:00Z",
      "marketCount": 12
    }
  ],
  "count": 1
}

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/markets?status=active&close_within_hours=24&limit=100"

Response

{
  "markets": [
    {
      "ticker": "KXBTCD-26FEB28-T105249.99",
      "title": "BTC above $105,249.99?",
      "status": "active",
      "closeTime": "2026-02-28T17:00:00Z",
      "event": "KXBTCD-26FEB28",
      "series": "KXBTCD",
      "volume": 4523,
      "openInterest": 1250
    }
  ],
  "count": 1
}

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/series?category=crypto&limit=20"

Response

{
  "series": [
    {
      "ticker": "KXBTCD",
      "title": "Bitcoin Daily Close",
      "category": "Crypto",
      "tags": ["crypto", "bitcoin"],
      "frequency": "daily",
      "activeEventCount": 7
    }
  ],
  "count": 1
}

Kraken Futures

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/pairs?market_type=perpetual&status=active"

Response

{
  "pairs": [
    {
      "pairId": "PF_XBTUSD",
      "symbol": "PF_XBTUSD",
      "base": "BTC",
      "quote": "USD",
      "marketType": "perpetual",
      "status": "active",
      "tickSize": 0.5,
      "contractSize": 1
    }
  ],
  "count": 1
}

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/pairs/PF_XBTUSD/snapshots?from=2026-02-15&to=2026-02-22"

Response

{
  "snapshots": [
    {
      "pairId": "PF_XBTUSD",
      "timestamp": "2026-02-22T14:00:00Z",
      "bid": 97250.5,
      "ask": 97251.0,
      "last": 97250.75,
      "fundingRate": 0.0001
    }
  ],
  "count": 1
}

Polymarket

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/conditions?status=active&limit=50"

Response

{
  "conditions": [
    {
      "conditionId": "0x1234...abcd",
      "question": "Will BTC exceed $100k by March 2026?",
      "status": "active",
      "endDate": "2026-03-31T23:59:59Z",
      "tokenCount": 2,
      "category": "Crypto"
    }
  ],
  "count": 1
}

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/polymarket/tokens?category=crypto&minVolume=10000"

Response

{
  "tokens": [
    {
      "tokenId": "0xabcd...1234",
      "conditionId": "0x1234...abcd",
      "outcome": "Yes",
      "price": 0.65,
      "volume": 125000.50,
      "status": "active"
    }
  ],
  "count": 1
}

Fees

Lists current fee schedules for all series.

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" https://api.varshtat.com/v1/fees

Response

{
  "fees": [
    {
      "series": "KXBTCD",
      "takerFee": 0.07,
      "makerFee": 0.0,
      "effectiveDate": "2026-01-01T00:00:00Z"
    }
  ],
  "count": 1
}

Returns the fee schedule for a specific series.

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/fees/KXBTCD?as_of=2026-01-15"

Data Endpoints

Historical trade data, price snapshots, event summaries, and volume aggregates are available via the /v1/data/* endpoints. For Parquet file downloads, see the Download Data guide.

Returns trade summaries grouped by ticker/instrument. Counts trades, sums volume, and provides price range (min/max/avg).

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/data/trades?feed=kalshi&date=2026-02-22&limit=10"

Returns the latest price snapshot per instrument from ticker/bid-ask data.

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/data/prices?feed=kraken-futures&date=2026-02-22&hour=1400"

Returns event-level trade summaries, grouping markets by parent event. Includes event name, close time, market count, total volume, and top markets.

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/data/events?feed=polymarket&date=2026-02-22&limit=10"

Returns per-feed trade counts, total volume, active ticker count, and top tickers. Volume units differ by feed (contracts for Kalshi, USD for Polymarket, base currency for Kraken).

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/data/volume?date=2026-02-22"

Checks data freshness for feeds. Reports the newest file age and flags feeds that are stale (over 7 hours old).

Query Parameters

Example

curl -H "X-API-Key: $API_KEY" \
  "https://api.varshtat.com/v1/data/freshness?feed=kalshi"

Error Responses

All error responses return JSON with an error field.

Example

{
  "error": "Insufficient scope: requires secmaster:read"
}

Rate Limits

API keys have per-key rate limits. The default tier allows 60 requests per minute. Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in responses.

List endpoints support a limit parameter but no offset or cursor-based pagination. Results are returned in server-defined order.