Skip to Content
SkewtapeDocs

List fee schedules

GET
/v1/fees

Fee schedule rows in (venue, category, effective_from) order. Open to every plan. Optional venue filter.

Authorization

ApiKey
headerX-API-Key<token>

Data endpoints. Format st_live__ (ADR-0012).

Query Parameters

venue?string
limit?integer

Page size (ARCHITECTURE 9.4). Default 100, maximum 1,000. May change between pages; the cursor does not bind to limit.

Range1 <= value <= 1000
Default100
cursor?string

Opaque pagination cursor from a previous next_cursor. Bound to the operation and its query filters (not limit). Tampered, malformed, foreign-route or foreign-query cursors are 400 invalid_request with no detail.

Response Body

Fees page

application/json
  1. response
data*array<>
next_cursor*|

Opaque cursor for the next page, or null when there is no further page (ARCHITECTURE 9.4). Pass as the cursor query parameter.

Example Request
curl -X GET 'https://api.skewtape.com/v1/fees'
Example Response
{  "data": [    {      "category": "string",      "effective_from": "2019-08-24T14:15:22Z",      "effective_to": "2019-08-24T14:15:22Z",      "formula": "quadratic",      "maker_rebate_params": {        "property1": 0,        "property2": 0      },      "min_fee_micros": 0,      "rounding": "none",      "schema_version": "string",      "source_url": "string",      "taker_params": {        "property1": 0,        "property2": 0      },      "venue": "string"    }  ],  "next_cursor": "string"}

Powered by Kalshi Research

List candles GET

Candles from the lake in (market_id, token_id, ts) order. With event_id, active members are read in (venue, market_id) order, each in that table order. With venue alone, the same key across the venue's markets. Exactly one selector: venue with market_id, event_id alone, or venue alone. from is inclusive and clamped to the plan's history; to is exclusive and must be after from. With venue alone, from and to are at most 7 days apart. Candles count each trade once (an order book match's maker legs, a market maker trade's one row) and arrive within an hour. event_id resolves an approved matched event the caller can see and reads its active members only; members outside the plan's candle venues are left out, and members whose venue's trades rights are not raw contribute no rows. A missing or hidden event_id is 404. Free and History include Polymarket daily candles (res=1d); other venues and resolutions need the builder plan.

List fills GET

Fills from published lake files in (market_id, ts, log_index, tx_hash) order. With event_id, active members are read in (venue, market_id) order, each in that table order. With venue alone, the same key across the venue's markets. Exactly one selector: venue with market_id, event_id alone, or venue alone. from is inclusive and clamped to the plan's history; to is exclusive and must be after from. With venue alone, from and to are at most 7 days apart. Fills arrive within a day. event_id resolves an approved matched event the caller can see and reads its active members only; members whose venue's trades rights are not raw contribute no rows. A missing or hidden event_id is 404. Free and History plans do not include fills.