# Adjacent API > Prediction market data API: markets, indices, events, reference rates, and semantic search from Kalshi and Polymarket This file contains the full content of all documentation pages. For a compact index, see [llms.txt](https://docs.adjacent.markets/llms.txt). To download all pages as a zip, use [docs.zip](https://docs.adjacent.markets/docs.zip). --- title: Adjacent API url: "https://docs.adjacent.markets/index.md" description: "Use prediction market data, indices, reference rates, and news in your own tools." --- Adjacent gives you one place to work with prediction-market data from Kalshi and Polymarket. Use it to build research tools, track markets, compare prices, or give an AI agent reliable market data. You can start with delayed public data or use an API key for realtime data and the full catalog. Browse every endpoint with schemas, examples, and a live cURL request. Compare data access, quotas, and plan limits. ## Choose what you need **Market data.** Find markets and events, then read prices, trades, quotes, and candles. Start with [Market data](/explore/market-data). **Indices.** Use an index when you need a single measure built from many prediction markets. Start with [Indices](/explore/indices). **Reference rates.** Compare the same market across venues or across rolling contracts with one price series. Start with [Reference rates](/explore/reference-rates). **News.** Find stored articles and connect them to markets, indices, and filings. Start with [News](/explore/news). **Filings.** Browse CFTC industry filings and follow status changes, attachments, and related markets. Start with [Filings](/explore/filings). **AI agents.** Connect an agent through MCP instead of teaching it every REST endpoint. Start with [MCP server](/explore/mcp). ## Base URL ``` https://api.adjacent.markets ``` All endpoints use the `/api/v1/` prefix. ## Authentication The anonymous `/api/v1/public/*` tier needs no token and returns data delayed by 15 minutes. Realtime endpoints require a bearer token. Use a session token from the app or an **API key** with the read scope for the resource you are calling. ```bash curl -H "Authorization: Bearer YOUR_TOKEN" \ https://api.adjacent.markets/api/v1/rates ``` ### API keys Create and manage keys in the app under **Settings → API keys**. Choose scopes that your account can grant, then copy the secret because it appears only once. Send the key as a bearer token: ```bash curl -H "Authorization: Bearer ak_your_key" \ https://api.adjacent.markets/api/v1/rates ``` …or as an `api_key` query parameter: ```bash curl "https://api.adjacent.markets/api/v1/rates?api_key=ak_your_key" ``` A key can reach only the endpoints covered by its scopes. Other requests return `403`. ## Need help choosing? Start with the public tier if you are exploring the data or building a prototype. Use an API key when you need realtime values, deeper history, news, or higher request limits. If you are not sure which endpoint fits your use case, [contact support](mailto:lucas@adjacentresearch.xyz). --- title: Explore the API url: "https://docs.adjacent.markets/explore.md" description: "Find the right Adjacent data for your research, product, or AI agent." --- Start with the question you are trying to answer. This guide points you to the right data and shows the requests that come next. ## A typical first request Most projects follow the same path: 1. Find an event, market, index, or rate. 2. Save its id from the response. 3. Request the detail or price history for that id. 4. Use the returned data in your chart, report, alert, or agent. The API returns stable ids. Pass them from one request into the next instead of guessing a ticker or rebuilding a venue-specific identifier. Find markets and events, then read prices, trades, quotes, and candles. Track a value built from many prediction markets. Combine prices across venues or across contracts that roll over time. Find articles and connect them to markets, indices, and filings. Browse CFTC industry filings, changes, attachments, and related records. Let an AI agent find and read Adjacent data through four focused tools. ## Pick a starting point **You are exploring a topic.** Start with [Market data](/explore/market-data). Search for an event, inspect its markets, and follow the price history. **You need a broader signal.** Start with [Indices](/explore/indices). An index combines many markets into one value and provides its composition and weights. **You need market context.** Start with [News](/explore/news). Search stored articles, read the source record, and find related markets. **You need regulatory context.** Start with [Filings](/explore/filings). Browse CFTC filings and connect them to the markets and articles they relate to. **You are comparing venues.** Start with [Reference rates](/explore/reference-rates). A rate puts prices for the same underlying market into one series. **You are connecting an AI agent.** Start with [MCP server](/explore/mcp). The agent can search by topic and use the returned id for detail or price history. **You need verified on-chain data.** Start with [Oracles](/explore/oracles). The SEDA proxy provides signed responses for supported index data. ## Choose your data access Use the public tier to try the API without an account. It returns a 15-minute-delayed snapshot of core market, event, index, and rate data. Use an API key for realtime data, deeper history, news, semantic search, and MCP access. The key also gives you higher request limits and access to the full market and filing catalogs. ## What you can build Use market data for a research notebook, market monitor, or search experience. Use indices and rates when your product needs one series instead of a list of markets. Use MCP when an AI agent needs to choose its next lookup. The public tier is a good place to test an idea. It requires no token and returns data delayed by 15 minutes. Add an API key when you need realtime values, deeper history, news, or higher request limits. ## Go deeper * [Authentication](/#authentication) explains tokens and API keys. * [Pricing](/pricing) shows data access and request limits. * [Rate limits](/rate-limits) explains quotas, headers, and concurrency. * [API reference](/api/get-api-v1-public-markets) lists every endpoint and schema. --- title: Market data url: "https://docs.adjacent.markets/explore/market-data.md" description: Pull live and historical prediction-market data from Kalshi and Polymarket through one API. --- Use this guide when you need the underlying market data rather than a derived index or rate. Adjacent returns markets, events, trades, quotes, and candles from Kalshi and Polymarket in one schema. Every `market_id` and `event_id` is globally unique and prefixed with its platform (`kalshi:` / `polymarket:`). That prefix lets you pass an id from a list response directly into a detail or history request. Set `ADJ_TOKEN` to an API key before running these examples; see [Authentication](/#authentication). ## A simple market workflow Start with a filtered market list when you know the venue or category but not the exact market id. Pick an id from the response, then request the market detail to confirm its question, status, and close date. Once you have the right market, choose the history that matches your question: * Use prices to chart how the implied probability changed. * Use trades to inspect individual executions. * Use quotes to inspect the bid and ask at a point in time. * Use candles to work with open, high, low, and close values. ## Find markets Filter by platform, category, probability, or volume. Results are paginated, so you can browse a large catalog without loading it all at once. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets?platform=kalshi&category=Politics&probability_min=50&sort_dir=desc&per_page=10" ``` The response includes a `data` array and a `meta` object. Save the `market_id` from the market you want to inspect. ## Follow one market Use the saved id to fetch the market record. Then choose the history endpoint that matches your question. ```bash MARKET_ID="kalshi:KXPRESPARTY-2028-R" curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/markets/$MARKET_ID" curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/markets/$MARKET_ID/prices?interval=1hour&per_page=24" ``` Use the market record for labels and status. Use price history for charts. Use trades and quotes when you need to explain a price change. ## Read a market Market prices use a 0-100 scale. A price of `75` means an implied probability of 75%. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R" ``` ## Follow a market over time Use price history to chart a market, trades to see executions, quotes to inspect the latest bid and ask, and candles to work with OHLC data. ```bash # Bucketed price history curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/prices?interval=1hour&per_page=24" # Recent trades curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/trades?per_page=20" # Raw top-of-book bid/ask snapshots curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/quotes?per_page=20" # OHLC candles (interval is the period length in minutes) curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/candles?interval=60" ``` ## Find similar markets Use this when you know one market but want related markets. Results are ranked by embedding cosine similarity. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/similar?per_page=5&min_similarity=0.7" ``` ## Browse events Events group markets that resolve together, such as the markets for an election. Use an event when you want the full set of related markets. ```bash # List events in a category curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/events?category=Politics&per_page=10" # Event detail with its markets curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/events/kalshi:KXPRESPARTY-2028" ``` See the [API reference](/api/get-api-v1-markets) for full schemas. --- title: Indices url: "https://docs.adjacent.markets/explore/indices.md" description: "Track index values, composition, weights, price history, and constituent returns." --- Use an index when a single market is too narrow. Adjacent combines many prediction markets into a value that you can track over time. The catalog includes political examples such as `red` and `blue`, along with `red_tr` (`RED-TR`), a total-return index, and NFL team indices (`methodology` `nti`). Other index methodologies can use the same endpoints. ## What an index helps you answer Use an index when you want to follow a group of markets without choosing one market at a time. The index detail gives you its current level and recent change. The constituents endpoint shows which markets contribute to that level and how much each one weighs. Use price history to chart the index. Use the export endpoints when you want to work with the series in a spreadsheet or analysis script. ## Read an index value The RED, BLUE, and UPFI political indices use a 50–150 scale. They do not use a 0–100 probability scale or a dollar price. The formula is `value = 50 + (the index party's aggregate win-probability, in percent)`. The scale runs from `50` (0%) through `100` (an even 50/50) to `150` (100%). Subtract `50` from the value to get the implied win probability. For example, `95` ≈ 45%, `109` ≈ 59%, and `130` ≈ 80%. For the political examples, `red` above `100` means Republicans are favored across its races and `blue` above `100` means Democrats are favored. Other indices can use a different scale, so check the index's methodology before comparing values. A constituent market's price is a 0–100% Yes probability, which is different from the index scale. Set `ADJ_TOKEN` to an API key before running these examples. See [Authentication](/#authentication). ## Find an index Start by listing indices if you do not know which index id to use. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/indices" ``` ## Read an index The response includes the latest price and 1-day and 7-day changes. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/indices/red" ``` The index response gives you the current value and recent changes. Use the `constituents` link when you need to explain what moved the index. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/indices/red/constituents" ``` ## Understand an index's composition Each constituent carries a `kind` (`market` for leaf markets, `index` for a composite's child sub-indices) alongside its computed weight. The current political catalog defines two composites: | Composite | Ticker | Child sub-indices and fixed weights | | --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `red` | `RED` | `presr_kalshi` / `PRESR` 40%, `senater_kalshi` / `SENR` 30%, `houser_kalshi` / `HOUSER` 20%, `govr_kalshi` / `GOVR` 8%, `mayorr_kalshi` / `MAYORR` 2% | | `blue` | `BLUE` | `presd_kalshi` / `PRESD` 40%, `senated_kalshi` / `SEND` 30%, `housed_kalshi` / `HOUSED` 20%, `govd_kalshi` / `GOVD` 8%, `mayord_kalshi` / `MAYORD` 2% | Sub-index market weights use the UPFI methodology factors. Presidential and Senate weights use lifetime cumulative contract or share count and time-to-resolution. House, Governor, and Mayoral weights use jurisdiction population. House and Governor use state population. Mayoral uses city population. There is no impact factor. RED and BLUE publish a trailing 1-hour SMA of the raw composite value. Sub-indices publish their raw per-cycle value. `red_tr` / `RED-TR` does not use the 50–150 scale. It is a path-dependent total-return index over RED's eligible constituents: `100` is its base value, `125` is a cumulative return of 25%, and the value is not SMA-smoothed. NFL team indices (`methodology` `nti`, `quote_convention` `points`) also skip the 50-150 scale. Each index tracks one team across four sleeves (Super Bowl, conference, division, next game). An active sleeve holds a constant 25 contracts; the level starts at `1000` and adds each sleeve's dollar P\&L, `NTI_t = NTI_{t-1} + Σ 25 × (P_t - P_prev)`, floored at zero. Index detail returns those holdings as `sleeves` and the latest official daily print as `official_daily_value`. Read the official daily series and recent sleeve admissions or settlements on the family-specific routes (other families return an empty list): ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/indices/{id}/daily-values" curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/indices/{id}/membership-events" ``` ## Track an index over time ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/indices/red/prices?interval=1hour&per_page=24" ``` ## Download the data You can download index listings and price history as CSV or TSV for offline analysis. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/export/indices/csv" curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/export/indices/red/prices.csv?interval=1hour" ``` See the [API reference](/api/get-api-v1-indices) for full schemas. --- title: Reference rates url: "https://docs.adjacent.markets/explore/reference-rates.md" description: Cross-platform benchmark rates and rolling-contract chains for the same underlying market. --- Use a reference rate when the same underlying market appears on more than one venue or rolls from one contract into the next. Adjacent combines those source prices into one series and reports the `spread` between them. Rates use the same 0-100 percent scale as market prices. They give you one series to chart, compare, and pass to another system. ## What the rate tells you The rate is the combined value of its source markets. Its `spread` shows how far those source prices are apart. A small spread means the sources are close. A large spread tells you to inspect the individual markets before treating the rate as a single signal. The source list includes each market's contribution and weight. Use it to explain the rate or compare the venues behind it. For `volume_weighted_average`, each source's effective weight is its configured or roll weight multiplied by its cumulative contract or share count: `Σ(price_i · weight_i · count_i) / Σ(weight_i · count_i)`. Other supported methods are `simple_average` and `median`. Choose `volume_weighted_average` when trading volume should affect the result. Choose `simple_average` when each source should count equally. Choose `median` when you want the middle source price and less sensitivity to an outlier. Set `ADJ_TOKEN` to an API key before running these examples. See [Authentication](/#authentication). ## Find a rate ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/rates" ``` ## Read a rate The response includes the source markets, their weights, and recent price changes. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/rates/adj_redp" ``` ## Track a rate over time ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/rates/adj_redp/prices?interval=1hour&per_page=24" ``` ## Keep a series across contract rolls Chains join successive contracts, such as the 2024 and 2028 presidential contracts, so a benchmark continues after an expiry. The `roll_schedule` blends adjacent contracts during the roll window. A chain-backed rate uses the same endpoints as any other rate. Pass `sources=true` with price history to see the roll weight for each contract at each point. ```bash # Rolling rate price history, with per-leg roll weights curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/rates/adj_redp/prices?interval=1hour&per_page=24&sources=true" ``` See the [API reference](/api/get-api-v1-rates) for full schemas. --- title: News url: "https://docs.adjacent.markets/explore/news.md" description: "Find stored articles and connect them to prediction markets, indices, and filings." --- Use the news API when you want articles beside market data. Adjacent stores article metadata, source information, and extracted text, then links articles to related markets, indices, and filings. ## What you can do * Browse the latest articles with page-based pagination. * Filter the stored catalog by source or language. * Read one article with its description and stored body. * Find markets or filings related to an article. * Find articles related to a market, index, rate, or filing. News search and related-content endpoints require an API key. The public tier includes a small, delayed set of related articles on market, index, and rate pages. Set `ADJ_TOKEN` to an API key before running these examples. See [Authentication](/#authentication). ## Get the latest articles Use the latest endpoint when you are building a feed or want the newest available articles. It uses page-based pagination. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/news/latest?per_page=20" ``` ## Filter the catalog Use the catalog endpoint when you want to page through stored articles or filter by a known source or language. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/news?source=SOURCE_ID&language=en" ``` Use the filters endpoint to discover source ids and language codes before building filter controls. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/news/filters" ``` The list response places articles in `data` and pagination values in `meta`. Each article summary includes an `id`, `title`, `url`, `source`, `published_date`, and `language`. ## Read an article Pass an article id from a list response to get its full stored record, including the description and truncated body. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/news/ARTICLE_ID" ``` The detail response adds the article `author`, `description`, and truncated `content`. Keep the article `url` when you show a link back to the publisher. ## Find related markets Use the related-markets endpoint to find markets connected to an article. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/news/ARTICLE_ID/markets?per_page=10" ``` The reverse lookup is also available. Use a market, index, rate, or filing endpoint when you already know the record and want its related articles. Related results are ranked matches, not proof that an article caused a market move. Use the article timestamp and the market price history together when you are building a timeline. See the [API reference](/api/get-api-v1-news) for full schemas. --- title: Filings url: "https://docs.adjacent.markets/explore/filings.md" description: Browse CFTC industry filings and connect them to markets and news. --- Use the filings API to track CFTC industry submissions, certifications, and rule changes. Adjacent stores each filing, its status history, attachment text, and links to related markets and news. ## What you can do * Browse the full filing catalog with filters and relevance-ranked search. * Use the public tier to browse filings from the last 90 days. * Follow new filings, status changes, and added attachments. * Read the action history for one filing. * Read extracted markdown from stored attachments. * Find related markets, news, and similar filings. The public tier covers filings whose status date is in the last 90 days. Use an API key with the `org:filings:read` scope for the full catalog, historical filings, change events, and related-record endpoints. Set `ADJ_TOKEN` to an API key before running these examples. See [Authentication](/#authentication). ## Browse recent filings Start with the public list when you want recent filings without authentication. It includes the same core filing shape and returns the newest status dates first. ```bash curl "https://api.adjacent.markets/api/v1/public/filings?per_page=20" ``` Use the filters endpoint to populate feed, organization, and status filters. ```bash curl "https://api.adjacent.markets/api/v1/public/filings/filters" ``` Each filing has an `id`, `title`, `feed`, `org_code`, `status`, `status_date`, and `doc_count`. The `feed` tells you which CFTC registry provided the row. ## Search the full catalog Use the authenticated list for historical filings and relevance-ranked search. Search checks the organization, description, product name and type, affected products, and filing id. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/filings?search=bitcoin&per_page=20" ``` ## Follow filing changes The change feed lets you keep a local record current. Save the highest `seq` from each response, then pass it as `since_seq` on the next request. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/filings/events?since_seq=100" ``` The feed reports first sightings, status changes, and later attachments. Use the event `kind` to decide what to refresh. A status change updates the filing record. A documents-added event means you can request the attachment text again. ## Read a filing and its history Use the filing id from a list or event response to fetch the filing, its action history, or the text extracted from its attachments. ```bash curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/filings/FILING_ID" curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/filings/FILING_ID/actions" curl -H "Authorization: Bearer $ADJ_TOKEN" \ "https://api.adjacent.markets/api/v1/filings/FILING_ID/markdown" ``` The actions endpoint returns the filing's history in oldest-first order. The markdown endpoint returns the filing and the extracted text for its stored attachments. ## Connect filings to other data Use the related endpoints to move between a filing and the markets, articles, or similar filings connected to it. See the [API reference](/api/get-api-v1-filings) for full schemas. --- title: Oracles url: "https://docs.adjacent.markets/explore/oracles.md" description: "Bring Adjacent data on-chain through the SEDA data oracle network with signed, verifiable responses." --- Use the SEDA proxy when another system must verify Adjacent data before using it on-chain. Adjacent publishes data to the [SEDA oracle network](https://github.com/sedaprotocol/seda-data-proxy) through a SEDA data proxy. The proxy signs each response with a registered keypair. Overlay nodes verify that the payload came from Adjacent before settling it on-chain. The testnet needs no key and returns delayed data. Mainnet responses require SEDA proof verification and are not generally available. ## Endpoints | | Testnet | Mainnet | | --------- | --------------------------------- | ----------------------------- | | Host | `oracle.testnet.adjacent.markets` | `oracle.api.adjacent.markets` | | Data tier | 15-min delayed | Real-time | | Access | Ungated | SEDA proof verification | | Status | Live | Not generally available | ## Health ```bash curl "https://oracle.testnet.adjacent.markets/status/health" ``` ## Read index data The proxy exposes the same index listings and price history as the REST API under the `/proxy` route group. Testnet needs no API key. ```bash # List indices curl "https://oracle.testnet.adjacent.markets/proxy/indices" # Index price history (public tier allows interval=1hour|1d) curl "https://oracle.testnet.adjacent.markets/proxy/indices/red/prices?interval=1hour&per_page=24" ``` See [Indices](/explore/indices) and [Reference rates](/explore/reference-rates) for the underlying benchmarks, and the [API reference](/api/get-api-v1-indices) for full schemas. --- title: MCP server url: "https://docs.adjacent.markets/explore/mcp.md" description: Connect AI agents to Adjacent prediction-market data over the Model Context Protocol. --- Use MCP when an AI agent needs to search Adjacent data without knowing the REST API. The Adjacent MCP server exposes prediction-market data through the [Model Context Protocol](https://modelcontextprotocol.io). The server has four tools. An agent can pass an id from `list` or `find` to `get` or `price`. ## A typical agent workflow An agent can: 1. Use `find` when the user gives a topic, such as a race or policy question. 2. Use `get` to inspect the matching market, event, index, or rate. 3. Use `price` when the user asks how that value changed over time. 4. Use the returned ids to continue the conversation without another search. The public endpoint supports basic discovery. Add an API key when the agent needs realtime data, news, similar markets, or historical lookups. For example, an agent can turn "What is the current price for the 2028 presidential market?" into a `find` call, pass the returned market id to `get`, and then call `price` if the user asks for a chart or recent change. ## Connect to MCP ``` https://mcp.adjacent.markets/mcp ``` Public (no key) traffic uses the **15-minute-delayed** snapshot tier. For **realtime** data, append your Adjacent API key as `apiKey`. REST uses the `api_key` query parameter or a Bearer token. MCP uses `apiKey` on the URL: ``` https://mcp.adjacent.markets/mcp?apiKey=YOUR_KEY ``` Create and manage keys in **Settings** on [adjacent.markets](https://adjacent.markets). ## Add MCP to an agent Most agent hosts accept a single URL under a "remote MCP" or "Streamable HTTP" option. Config file paths vary by host. Use one of these configurations: **Cursor / Claude (remote Streamable HTTP)** ```json { "mcpServers": { "adjacent": { "url": "https://mcp.adjacent.markets/mcp" } } } ``` **With an API key (realtime tier)** ```json { "mcpServers": { "adjacent": { "url": "https://mcp.adjacent.markets/mcp?apiKey=YOUR_KEY" } } } ``` ## Choose a tool | Tool | When to use it | | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `list` | Browse tradable events (default), markets, indices, rates, or news. News requires an API key. Search is all-words AND. For a historical market catalog, use an API key and pass `include_resolved` with `created_before` / `as_of`. | | `find` | Discover an entity by topic when you don't have an id. Optional `type` (`index`, `rate`, `event`, `market`, `news`, `similar`). News and similar-market queries require an API key. Same historical flags as `list`. An empty search returns `SEARCH_NO_MATCH`. | | `get` | Full detail by id. Indices include constituents. Index, rate, and market reads accept `as_of` for a historical snapshot (`price_at_as_of`); live `probability` is omitted. Event historical reads return `BAD_REQUEST` because the API does not store historical membership. | | `price` | Price history. Live: a human timeframe (`24h`, `7d`, `30d`, `90d`). Index, rate, and market historical reads accept `end` or `as_of` (RFC3339 or `YYYY-MM-DD`); the default interval is `1d`. Compact mode returns the last bucket at or before the cutoff. Event historical reads return `BAD_REQUEST` because the API does not store historical membership. No such bucket is `NO_PRICE_AT_AS_OF`. | Ids from `list` or `find` chain into `get` or `price`. Markets use `:`, such as `kalshi:KXPRESPARTY-2028-R`. Indices and rates use slugs such as `red` or `pres`. Do not use a live timeframe (`30d`, `90d`) as a substitute for `end` on a past question. Failures set `isError` and a stable `code` (`RATE_LIMITED`, `FORBIDDEN`, `NOT_FOUND`, `SEARCH_NO_MATCH`, `NO_PRICE_AT_AS_OF`, `CREATED_AFTER_AS_OF`, `BAD_REQUEST`). ## Learn more * [API reference](/api/get-api-v1-indices): the underlying REST endpoints * [Rate limits](/rate-limits): caller-visible quotas for authenticated traffic --- title: Pricing url: "https://docs.adjacent.markets/pricing.md" description: API plans for realtime Adjacent data --- | Plan | Price | Data | Seats | Organization limits | Adjacent Press | | ------- | ---------: | ------------------------------------------------------------ | ----: | ----------------------------------------- | ----------------------------- | | Free | $0 | Public API and MCP, 15-minute delayed | — | 50 requests / 10 seconds / IP at the edge | Free content | | Pro | $50/month | Realtime indices, rates, markets, history, research, and MCP | 5 | 30 requests/minute; 20,000/day | Complimentary for seat emails | | Premium | $250/month | Everything in Pro with higher throughput | 10 | 180 requests/minute; 150,000/day | Complimentary for seat emails | Free price endpoints serve hourly history for the previous 30 days or daily history for the previous 90 days. Finer intervals and deeper history are paid. Pro is for interactive research and light automation. Premium is for teams that need more throughput. Neither plan permits redistribution or use in a financial product. WebSockets, the index builder, and ratings data are not included in these v1 plans. Paid limits are organization-wide and reset at 00:00 UTC. See [Rate limits](/rate-limits) for response headers and over-limit behavior. Manage a plan and see live usage in **Settings → Billing & usage**. For a custom use case, [contact us](mailto:lucas@adjacentresearch.xyz). --- title: Rate limits url: "https://docs.adjacent.markets/rate-limits.md" description: Organization-wide request ceilings for Adjacent API plans --- | Plan | Applies to | Minute limit | Daily limit | Keyed by | | ------- | -------------------------- | -----------------------: | ----------: | --------------------- | | Free | `/api/v1/public/*` | 50 requests / 10 seconds | — | Client IP at the edge | | Pro | Authenticated realtime API | 30 requests/minute | 20,000/day | Organization | | Premium | Authenticated realtime API | 180 requests/minute | 150,000/day | Organization | Paid limits are **organization-wide**. Every API key and authenticated session in an organization draws from the same budgets. Creating more keys does not increase throughput. The daily budget resets at 00:00 UTC. Public requests are limited and cached at the Cloudflare edge and are not double-counted by the application limiter. Realtime reads from an organization with no paid plan are refused with `403` (see [No plan at all](#no-plan-at-all)). They are not billed against a minute or daily budget, so they carry none of the headers below. ## Response headers Paid (Pro and Premium) responses carry both budgets: | Header | Meaning | | --------------------------- | ---------------------------------------- | | `RateLimit-Limit` | Plan requests per minute. | | `RateLimit-Remaining` | Requests left in the current minute. | | `RateLimit-Reset` | Seconds until the minute counter resets. | | `RateLimit-Daily-Limit` | Plan requests per UTC day. | | `RateLimit-Daily-Remaining` | Requests left today. | | `RateLimit-Daily-Reset` | Seconds until 00:00 UTC. | An over-limit request returns `429 Too Many Requests`. It includes the same headers, sets the exhausted remaining value to zero, and includes `Retry-After` for the budget that blocked the request: ```json { "error": "rate_limited", "limit": "rpm", "message": "Organization rpm request limit exceeded; retry after 18s.", "upgrade_url": "https://adjacent.markets/subscribe" } ``` Back off for at least `Retry-After` seconds. `upgrade_url` points to the plan catalog. It is omitted when no plan is available to buy. The live minute and daily meters are under **Settings → Billing & usage**. ## Concurrent requests Beyond the per-minute and daily budgets, each organization can run up to 4 requests at the same time. This capacity is dedicated to your organization, not shared with other callers. A request over the limit waits up to 2 seconds for a slot. If no slot frees up, it returns `429 Too Many Requests` with `Retry-After` and the body above with `"limit": "concurrency"`. The public tier (`/api/v1/public/*`) shares one pool of capacity across all anonymous callers and can return `429` with `Retry-After` under load: ```json { "error": "too_many_requests", "message": "The public API is at its concurrent request limit. Retry after 2s." } ``` Issue requests sequentially, or keep parallelism within the limit, and back off for `Retry-After` seconds on a concurrency 429. ## No plan at all A 429 means a plan's budget ran out. A request from an organization with no paid plan is refused up front instead, with `403 Forbidden`: ```json { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` `upgrade_url` carries the same meaning as on a 429 and is likewise omitted when no plan is available to buy. Unlike a 429, retrying does not help: nothing resets until the organization holds a plan. --- title: List API keys url: "https://docs.adjacent.markets/api/get-api-v1-api-keys.md" description: "Returns the API keys owned by the caller's organization." --- --- title: Create API key url: "https://docs.adjacent.markets/api/post-api-v1-api-keys.md" description: "Creates a new API key for the caller's organization." ---

```bash title="cURL" lines=false curl -X POST "https://api.adjacent.markets/api/v1/api-keys" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "name": "string", "scopes": [ "string" ] }' ``` ```json title="default" lines=false { "name": "production-readonly", "scopes": [ "org:events:read", "org:rates:read" ] } ``` ```json title="201 — default" lines=false { "id": "key_a1b2c3", "name": "production-readonly", "scopes": [ "org:events:read", "org:rates:read" ], "secret": "ak_live_9f8e7d6c5b4a39281706f5e4d3c2b1a0", "created_at": 1750000000000 } ``` ```json title="400 — default" lines=false { "error": "bad_request", "message": "name and scopes are required" } ``` ```json title="401 — default" lines=false { "error": "Missing or invalid Authorization header", "status": 401 } ``` ```json title="403 — default" lines=false { "error": "forbidden", "message": "an organization is required to manage API keys" } ``` ```json title="409 — default" lines=false { "error": "conflict", "message": "Key creation hit a name collision. Retry the request; the same display name may be reused." } ```

--- title: List grantable scopes url: "https://docs.adjacent.markets/api/get-api-v1-api-keys-grantable-scopes.md" description: "Returns the permission scopes the caller may grant when creating an API key, the permissions held by their organization role, excluding org:apikeys:manage (a key cannot manage keys)." --- --- title: Revoke API key url: "https://docs.adjacent.markets/api/delete-api-v1-api-keys-id.md" description: Revokes the API key with the given ID. --- --- title: List events url: "https://docs.adjacent.markets/api/get-api-v1-events.md" description: "List all events, filterable by category, region, venue, and a resolution-date window (expiresafter / expiresbefore)." ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/events" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "event_id": "kalshi:CONTROLH-2028", "name": "2028 House winner", "category": "Elections", "region": "US", "election_date": "2028-11-07", "description": "In 2028", "created_at": "2026-06-02T16:28:27.350946Z", "updated_at": "2026-06-02T16:29:39.257577Z", "market_count": 2 }, { "event_id": "kalshi:CONTROLS-2028", "name": "2028 Senate winner", "category": "Elections", "region": "US", "election_date": "2028-11-07", "description": "In 2028", "created_at": "2026-06-02T16:28:24.146031Z", "updated_at": "2026-06-02T16:29:34.765363Z", "market_count": 2 } ], "meta": { "total": 204963, "page": 1, "per_page": 20, "total_pages": 10249, "has_next": true, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ```

:` (for example `kalshi:KXPRESPARTY-2028`). Use it to fetch the event's detail and to group markets by their parent event."},"name":{"type":"string","description":"The event's title as published by its venue, intended for display."},"category":{"type":"string","description":"The event's category, folded into a fixed cross-venue taxonomy (`Politics`, `Elections`, `Economics`, `Crypto`, `Sports` and similar, with `Other` as the catch-all). Every market under the event inherits this value."},"region":{"type":["string","null"],"description":"Geographic scope of the event: a two-letter US state code for state-level races, or `US` for federal ones. Null whenever the event carries no geographic anchor, which covers non-election events and all Polymarket events."},"election_date":{"type":["string","null"],"format":"date","description":"The election day this event resolves against, derived from the event's identifier for election markets and null for everything else. Pass `sort=election_date` to order the events list by it (undated events last)."},"description":{"type":["string","null"],"description":"Longer description of the event as published by its venue. Omitted when the venue supplies none."},"created_at":{"type":["string","null"],"format":"date-time","description":"When this event was first recorded by the API. It is a first-seen timestamp on our side, not a venue publication date."},"updated_at":{"type":["string","null"],"format":"date-time","description":"When this event's record was last written. The record is rewritten every time the event is re-read from its venue, so this advances even when no field actually changed."},"market_count":{"type":"integer","description":"Total number of markets under this event, counted with no status or filter restriction, so settled and closed markets are included. The public events list reports a `market_count` covering only the markets that match that request's filters, so the two can legitimately differ for the same event."},"volume":{"type":["number","null"],"description":"Summed all-time contract/share volume across the event's markets, not dollars. Unit is in `volume_unit`. Omitted when no market reports volume."},"volume_unit":{"description":"Wire unit for `volume`, from the event's venue (every market shares the event's venue). See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"open_interest":{"type":["number","null"],"description":"Summed open interest across the event's markets. Unit is in `open_interest_unit`. Omitted when no market reports open interest."},"open_interest_unit":{"description":"Wire unit for `open_interest`, from the event's venue. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true}}}},"meta":{"type":"object","properties":{"total":{"type":["integer","null"],"description":"Total number of records matching the request across every page, not just the current one. null on an uncounted list; page using has_next. A relevance-ranked search is uncounted, and a searched events list stays uncounted even with sort. A searched markets list with sort returns a total over the ranked matches (at most 10,000)."},"page":{"type":"integer","description":"The 1-based page number this response covers."},"per_page":{"type":"integer","description":"Maximum number of items on a page. The last page may hold fewer."},"total_pages":{"type":["integer","null"],"description":"Total number of pages available at the current per_page. null whenever total is null; page using has_next."},"has_next":{"type":"boolean","description":"True when a page exists after this one."},"has_prev":{"type":"boolean","description":"True when this is not the first page."},"total_capped":{"type":"boolean","description":"True when `total` and `total_pages` reflect the server's counting ceiling rather than the exact matched count: the real set is at least `total` large. Render such totals as a lower bound (for example \"10,000+\"). Omitted when the count is exact. A sorted markets search that fills the 10,000-candidate ceiling sets this flag."}}}}},"example":{"data":[{"event_id":"kalshi:CONTROLH-2028","name":"2028 House winner","category":"Elections","region":"US","election_date":"2028-11-07","description":"In 2028","created_at":"2026-06-02T16:28:27.350946Z","updated_at":"2026-06-02T16:29:39.257577Z","market_count":2},{"event_id":"kalshi:CONTROLS-2028","name":"2028 Senate winner","category":"Elections","region":"US","election_date":"2028-11-07","description":"In 2028","created_at":"2026-06-02T16:28:24.146031Z","updated_at":"2026-06-02T16:29:34.765363Z","market_count":2}],"meta":{"total":204963,"page":1,"per_page":20,"total_pages":10249,"has_next":true,"has_prev":false}},"examples":[{"name":"default","value":{"data":[{"event_id":"kalshi:CONTROLH-2028","name":"2028 House winner","category":"Elections","region":"US","election_date":"2028-11-07","description":"In 2028","created_at":"2026-06-02T16:28:27.350946Z","updated_at":"2026-06-02T16:29:39.257577Z","market_count":2},{"event_id":"kalshi:CONTROLS-2028","name":"2028 Senate winner","category":"Elections","region":"US","election_date":"2028-11-07","description":"In 2028","created_at":"2026-06-02T16:28:24.146031Z","updated_at":"2026-06-02T16:29:34.765363Z","market_count":2}],"meta":{"total":204963,"page":1,"per_page":20,"total_pages":10249,"has_next":true,"has_prev":false}}}]},{"status":"403","description":"The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.","schema":{"type":"object","required":["error","status"],"properties":{"error":{"type":"string","description":"Human-readable reason the request was refused."},"status":{"type":"integer","description":"HTTP status code, repeated in the body."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase."}}},"example":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"},"examples":[{"name":"default","value":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"}}]},{"status":"429","description":"The organization's minute or UTC-day request budget is exhausted, or the organization has reached its cap on requests running at the same time (`limit: \"concurrency\"`). Wait `Retry-After` seconds before retrying; for a concurrency 429, reduce parallelism.","schema":{"type":"object","required":["error","limit","message"],"properties":{"error":{"type":"string","description":"Always `rate_limited`. Branch on this to detect a throttled request.","enum":["rate_limited"]},"limit":{"type":"string","description":"Which limit was hit: `rpm` for the per-minute cap, `daily` for the daily one, or `concurrency` for the cap on requests running at the same time.","enum":["rpm","daily","concurrency"]},"message":{"type":"string","description":"Human-readable explanation naming the limit that was exceeded."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase."}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Session token from the app, or an API key (the `ak_` prefix), sent as a Bearer token or an `?api_key=` query parameter."}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Get event details url: "https://docs.adjacent.markets/api/get-api-v1-events-id.md" description: Get event with all linked markets ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/events/" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "event_id": "kalshi:CONTROLH-2028", "name": "2028 House winner", "description": "In 2028", "category": "Elections", "markets": [ { "market_id": "kalshi:CONTROLH-2028-D", "display_ticker": "CONTROLH-2028-D", "platform": "kalshi", "question": "Will Democrats win control of the House in 2028?", "probability": 65, "tape_mid_1m": 64.8, "volume": 1850000, "volume_unit": "contracts" }, { "market_id": "kalshi:CONTROLH-2028-R", "display_ticker": "CONTROLH-2028-R", "platform": "kalshi", "question": "Will Republicans win control of the House in 2028?", "probability": 36, "tape_mid_1m": 36.2, "volume": 1420000, "volume_unit": "contracts" } ] } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Event not found" } ```

:` (for example `kalshi:KXPRESPARTY-2028`)."},"name":{"type":"string","description":"The event's title as published by its venue, intended for display."},"description":{"type":["string","null"],"description":"Longer description of the event as published by its venue. Null when the venue supplies none."},"category":{"type":"string","description":"The event's category, folded into a fixed cross-venue taxonomy (`Politics`, `Elections`, `Economics`, `Crypto`, `Sports` and similar, with `Other` as the catch-all)."},"markets":{"type":"array","description":"Every market under this event, with no status filter applied, so settled and closed markets appear alongside open ones. Ordered by market identifier, and each entry carries that market's latest price, freshest tape mid, and all-time volume.","items":{"type":"object","required":["market_id","display_ticker","platform"],"properties":{"market_id":{"type":"string","description":"Canonical identifier for this child market, formed as `:` (for example `kalshi:KXPRESPARTY-2028-R`). This is the id every other endpoint accepts."},"display_ticker":{"type":"string","description":"Human-readable market label, Polymarket market slug when present, else the raw ticker."},"platform":{"type":"string","description":"The venue that lists this market: `kalshi` or `polymarket`. It is also the prefix of `market_id`, and it determines what `volume` is counted in (see `volume_unit`)."},"question":{"type":["string","null"],"description":"Market question text (same field as MarketSummary.question)."},"probability":{"type":["number","null"],"format":"float","description":"Yes-side probability on the 0-100 cents scale, from the market's last traded price. Same projection as MarketSummary.probability."},"tape_mid_1m":{"type":["number","null"],"description":"Most recent 1-minute average of yes-side trade prices within the trailing 7 days, on the 0-100 cents scale. Distinct from probability, which is the single last traded price. This is the newest minute that had trades, not necessarily the minute just past. Null when the market has not traded in the last 7 days."},"volume":{"type":["number","null"],"format":"float","description":"All-time traded volume as a contract/share count, the same number the markets list serves for this market (MarketSummary.volume), so the two surfaces agree. Unit is in `volume_unit`."},"volume_unit":{"description":"Unit for volume: `contracts` for Kalshi and `shares` for Polymarket. Without it the volume column mixes two different quantities.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true}}}}}},"example":{"event_id":"kalshi:CONTROLH-2028","name":"2028 House winner","description":"In 2028","category":"Elections","markets":[{"market_id":"kalshi:CONTROLH-2028-D","display_ticker":"CONTROLH-2028-D","platform":"kalshi","question":"Will Democrats win control of the House in 2028?","probability":65,"tape_mid_1m":64.8,"volume":1850000,"volume_unit":"contracts"},{"market_id":"kalshi:CONTROLH-2028-R","display_ticker":"CONTROLH-2028-R","platform":"kalshi","question":"Will Republicans win control of the House in 2028?","probability":36,"tape_mid_1m":36.2,"volume":1420000,"volume_unit":"contracts"}]},"examples":[{"name":"default","value":{"event_id":"kalshi:CONTROLH-2028","name":"2028 House winner","description":"In 2028","category":"Elections","markets":[{"market_id":"kalshi:CONTROLH-2028-D","display_ticker":"CONTROLH-2028-D","platform":"kalshi","question":"Will Democrats win control of the House in 2028?","probability":65,"tape_mid_1m":64.8,"volume":1850000,"volume_unit":"contracts"},{"market_id":"kalshi:CONTROLH-2028-R","display_ticker":"CONTROLH-2028-R","platform":"kalshi","question":"Will Republicans win control of the House in 2028?","probability":36,"tape_mid_1m":36.2,"volume":1420000,"volume_unit":"contracts"}]}}]},{"status":"403","description":"The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.","schema":{"type":"object","required":["error","status"],"properties":{"error":{"type":"string","description":"Human-readable reason the request was refused."},"status":{"type":"integer","description":"HTTP status code, repeated in the body."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase."}}},"example":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"},"examples":[{"name":"default","value":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"}}]},{"status":"404","description":"Event not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Stable, machine-readable code identifying the failure; branch on this rather than on `message`. One of `bad_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`, `service_unavailable`, `upstream_error`, `service_error`, or `internal_error`."},"message":{"type":"string","description":"Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld."}}},"example":{"error":"not_found","message":"Event not found"},"examples":[{"name":"default","value":{"error":"not_found","message":"Event not found"}}]},{"status":"429","description":"The organization's minute or UTC-day request budget is exhausted, or the organization has reached its cap on requests running at the same time (`limit: \"concurrency\"`). Wait `Retry-After` seconds before retrying; for a concurrency 429, reduce parallelism.","schema":{"type":"object","required":["error","limit","message"],"properties":{"error":{"type":"string","description":"Always `rate_limited`. Branch on this to detect a throttled request.","enum":["rate_limited"]},"limit":{"type":"string","description":"Which limit was hit: `rpm` for the per-minute cap, `daily` for the daily one, or `concurrency` for the cap on requests running at the same time.","enum":["rpm","daily","concurrency"]},"message":{"type":"string","description":"Human-readable explanation naming the limit that was exceeded."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase."}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Session token from the app, or an API key (the `ak_` prefix), sent as a Bearer token or an `?api_key=` query parameter."}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Export events list url: "https://docs.adjacent.markets/api/get-api-v1-export-events-ext.md" description: Export a filtered list of events as a CSV or TSV file download. --- --- title: Export event markets url: "https://docs.adjacent.markets/api/get-api-v1-export-events-id-marketsext.md" description: Export all markets belonging to an event as a CSV or TSV file download. --- --- title: Export indices list url: "https://docs.adjacent.markets/api/get-api-v1-export-indices-ext.md" description: Export the list of indices as a CSV or TSV file download. --- --- title: Export index price history url: "https://docs.adjacent.markets/api/get-api-v1-export-indices-id-pricesext.md" description: Export historical index values as a CSV or TSV file download. --- --- title: Export markets list url: "https://docs.adjacent.markets/api/get-api-v1-export-markets-ext.md" description: Export a filtered list of markets as a CSV or TSV file download. --- --- title: Export market price history url: "https://docs.adjacent.markets/api/get-api-v1-export-markets-id-pricesext.md" description: Export historical price data for a market as a CSV or TSV file download. --- --- title: Export market trades url: "https://docs.adjacent.markets/api/get-api-v1-export-markets-id-tradesext.md" description: "Export trade history for a market as a CSV or TSV file download, newest first." --- --- title: Export reference rates list url: "https://docs.adjacent.markets/api/get-api-v1-export-rates-ext.md" description: Export the list of reference rates as a CSV or TSV file download. --- --- title: Export reference rate price history url: "https://docs.adjacent.markets/api/get-api-v1-export-rates-id-pricesext.md" description: "Export historical reference rate values as a CSV or TSV file download, newest first." --- --- title: List indices url: "https://docs.adjacent.markets/api/get-api-v1-indices.md" description: Get all available indices ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/indices" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "index_id": "red", "name": "Republican Political Future Index", "ticker": "RED", "description": "Composite of Republican party-line contests across all levels of office in the United States", "constituents_count": 5, "latest_price": 91.3069, "updated_at": "2026-06-20T19:16:06.844983Z", "methodology": "upfi", "created_at": "2026-06-02T14:20:24.299003Z", "display_order": 1, "halted": false }, { "index_id": "blue", "name": "Democratic Political Future Index", "ticker": "BLUE", "description": "Composite of Democratic party-line contests across all levels of office in the United States", "constituents_count": 5, "latest_price": 108.5114, "updated_at": "2026-06-20T19:16:06.740650Z", "methodology": "upfi", "created_at": "2026-06-02T14:20:24.587181Z", "display_order": 2, "halted": false } ], "meta": { "total": 12, "page": 1, "per_page": 20, "total_pages": 1, "has_next": false, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ```

--- title: Get index details url: "https://docs.adjacent.markets/api/get-api-v1-indices-id.md" description: Get detailed information about a specific index ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/indices/" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "index_id": "red", "name": "Republican Political Future Index", "ticker": "RED", "description": "Composite of Republican party-line contests across all levels of office in the United States", "constituents_count": 5, "latest_price": 91.3069, "price_change_1d": 0.2663, "price_change_7d": -0.3112, "halted": false } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Index not found" } ```

:`) for the attributed constituent."},"ticker":{"type":"string","description":"Raw exchange ticker of the constituent market. Use `display_ticker` for a label and `market_id` for lookups or links."},"display_ticker":{"type":"string","description":"Human-readable market label, Polymarket market slug when present, else the raw ticker."},"name":{"type":["string","null"],"description":"The constituent market's question text. Absent when the market has no question on record."},"contribution":{"type":"number","description":"The market's share of the index's blended probability, equal to `weight` multiplied by `price` divided by 100. Rows are ordered by descending absolute contribution and, across all rows, sum to the blended probability behind the published index level."},"weight":{"type":"number","description":"The market's effective weight in the index, as a fraction rather than a percent, after any sub-index legs are flattened. Weights across all rows sum to about 1.0."},"price":{"type":"number","description":"The market's probability, 0-100, as it entered the index calculation these figures reconcile to. Because it is the value that calculation consumed, it can lag the market's latest trade."}}}},"constituent_returns":{"type":"array","description":"Per-constituent own price move for the 1d/7d/30d trailing windows, precomputed server-side. Each row includes percent_change; each window includes group_by and groups.","items":{"type":"object","description":"Per-constituent price moves for one trailing window, computed server-side. A window whose start predates the index's earliest compute cycle comes back empty (rows: [], groups: []), degrading together with the null stats.trailing_returns for the same window.","properties":{"window":{"type":"string","description":"Window label: 1d / 7d / 30d."},"group_by":{"type":"string","description":"Dimension groups are keyed by. state means each group's key is a US state (or other for untagged rows). A city, party, or office grouping is a different group_by value, not a new field on the group.","enum":["state"]},"rows":{"type":"array","description":"One row per constituent held at the end of the window, ordered from largest to smallest end weight. Constituents that left the index before the window ended are omitted, and the array is empty when the index has no history reaching back to the window start.","items":{"type":"object","description":"One constituent's own price move over a trailing window. Every field is computed server-side and rendered verbatim.","properties":{"constituent_id":{"type":"string","description":"Prefixed constituent id (with kind): market_id for a market, index_id for a sub-index leg, rate_id for a rate sleeve, event_id for a same-event race."},"kind":{"type":"string","description":"Navigable kind: market (market page) / index (index page) / rate (rate page) / event (a same-event race, not individually linkable).","enum":["market","index","event","rate"]},"ticker":{"type":"string","description":"Display ticker for the constituent: the market's ticker (a readable slug where the venue provides one), the child index's ticker for a sub-index leg, the rate_id for a rate sleeve, or the race identifier for a same-event group."},"name":{"type":["string","null"],"description":"Readable name for the constituent: the market's question, the child index's name, the rate's name, or the event's name. Absent when the underlying record has none."},"platform":{"type":"string","description":"kalshi/polymarket for markets; index for a composite's sub-index leg; rate for a rate-backed sleeve."},"state_code":{"type":["string","null"],"description":"Two-letter state for House/Senate/Gov market constituents; absent for composite legs, same-event races, and markets with no state."},"weight":{"type":"number","description":"Effective (composite-flattened, normalized) weight at the window end."},"start_weight":{"type":"number","description":"Same weight at the window start, so a tile whose size changed over the window (a reweighting) is explainable (start_weight -> weight)."},"start_price":{"type":"number","description":"Constituent value at the start of the window (0-100 probability for markets; the child's UPFI value for a composite's sub-index leg; the rate mark for a rate sleeve)."},"end_price":{"type":"number","description":"Constituent value at the end of the window (same scale as start_price)."},"point_change":{"type":"number","description":"end_price minus start_price, in the constituent's own points."},"percent_change":{"type":["number","null"],"description":"Percent change from start_price to end_price: (end_price - start_price) / start_price * 100. Null when start_price is 0."}}}},"groups":{"type":"array","description":"Aggregates of rows under group_by, ordered from largest to smallest weight. Empty when rows is empty.","items":{"type":"object","description":"One grouped slice of constituent returns for a trailing window. The grouping dimension is the window's group_by; key identifies the group. Weight, point_change, and percent_change are computed server-side from the window's rows.","properties":{"key":{"type":"string","description":"Group id inside group_by. When group_by is state, this is a two-letter US state, or other for untagged rows."},"label":{"type":"string","description":"Display string when it differs from key. Omitted when key is already the label."},"weight":{"type":"number","description":"Sum of member end weights."},"member_count":{"type":"integer","description":"Count of members with end weight greater than 0."},"point_change":{"type":"number","description":"Weight-average of member point_change."},"percent_change":{"type":["number","null"],"description":"Weight-average of member percent_change over members whose percent_change is present. Null when no member has a usable start_price."}}}}}}}}}],"nullable":true},"halted":{"type":"boolean","description":"True when the latest index value was carried forward because the index fell below its constituent floor."},"halt_valid_constituents":{"type":["integer","null"],"description":"When halted, the valid (priced, guardrail-passing) constituents at the most recent halt cycle. Omitted when not halted."},"halt_min_constituents":{"type":["integer","null"],"description":"When halted, the category constituent floor the index fell below. Omitted when not halted."},"halt_reason":{"type":["string","null"],"description":"When halted, a human-readable explanation of the halt, composed from the constituent halt counts. Omitted when not halted."},"visibility":{"type":"string","description":"Access level of the index. `public` is visible to everyone; `organization` is visible to members of listed organizations. Other reserved values may appear on authenticated responses. Omitted on the anonymous public tier, which returns only public indices.","enum":["public","superuser","organization"]},"official_daily_value":{"description":"Most recent official daily value. Null when this index family does not publish daily values.","allOf":[{"type":"object","description":"One official daily value: the value stamped for one US-Eastern calendar day.","required":["et_date","value"],"properties":{"et_date":{"type":"string","format":"date","description":"The US-Eastern calendar day the value is official for."},"value":{"type":"number","description":"The official index value for that day, in index points."}}}],"nullable":true},"sleeves":{"type":"array","description":"Current sleeve state for an NFL team index. Empty for other index families.","items":{"type":"object","description":"One sleeve of an NFL team index: a fixed seat holding at most one market at a time.","required":["sleeve","active","cumulative_points"],"properties":{"sleeve":{"type":"string","description":"Stable sleeve name.","enum":["super_bowl","conference","division","next_game"]},"active":{"type":"boolean","description":"Whether the sleeve holds an active member. An inactive sleeve keeps its seat and contributes nothing until a successor is admitted."},"market_id":{"type":["string","null"],"description":"The current member's market id. Omitted for an inactive sleeve."},"display_ticker":{"type":["string","null"],"description":"Display label for the current member. Omitted for an inactive sleeve."},"name":{"type":["string","null"],"description":"The current member's question. Omitted for an inactive sleeve."},"mark_price":{"type":["number","null"],"description":"The sleeve's latest approved mark, 0-100. Omitted for an inactive sleeve or before the sleeve's first computed mark."},"cumulative_points":{"type":"number","description":"The sleeve's cumulative contribution to the index level since base, in index points."}}}}}},"example":{"index_id":"red","name":"Republican Political Future Index","ticker":"RED","description":"Composite of Republican party-line contests across all levels of office in the United States","constituents_count":5,"latest_price":91.3069,"price_change_1d":0.2663,"price_change_7d":-0.3112,"halted":false},"examples":[{"name":"default","value":{"index_id":"red","name":"Republican Political Future Index","ticker":"RED","description":"Composite of Republican party-line contests across all levels of office in the United States","constituents_count":5,"latest_price":91.3069,"price_change_1d":0.2663,"price_change_7d":-0.3112,"halted":false}}]},{"status":"403","description":"The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.","schema":{"type":"object","required":["error","status"],"properties":{"error":{"type":"string","description":"Human-readable reason the request was refused."},"status":{"type":"integer","description":"HTTP status code, repeated in the body."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase."}}},"example":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"},"examples":[{"name":"default","value":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"}}]},{"status":"404","description":"Index not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Stable, machine-readable code identifying the failure; branch on this rather than on `message`. One of `bad_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`, `service_unavailable`, `upstream_error`, `service_error`, or `internal_error`."},"message":{"type":"string","description":"Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld."}}},"example":{"error":"not_found","message":"Index not found"},"examples":[{"name":"default","value":{"error":"not_found","message":"Index not found"}}]},{"status":"429","description":"The organization's minute or UTC-day request budget is exhausted, or the organization has reached its cap on requests running at the same time (`limit: \"concurrency\"`). Wait `Retry-After` seconds before retrying; for a concurrency 429, reduce parallelism.","schema":{"type":"object","required":["error","limit","message"],"properties":{"error":{"type":"string","description":"Always `rate_limited`. Branch on this to detect a throttled request.","enum":["rate_limited"]},"limit":{"type":"string","description":"Which limit was hit: `rpm` for the per-minute cap, `daily` for the daily one, or `concurrency` for the cap on requests running at the same time.","enum":["rpm","daily","concurrency"]},"message":{"type":"string","description":"Human-readable explanation naming the limit that was exceeded."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase."}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Session token from the app, or an API key (the `ak_` prefix), sent as a Bearer token or an `?api_key=` query parameter."}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Get index constituents url: "https://docs.adjacent.markets/api/get-api-v1-indices-id-constituents.md" description: Get constituent markets with weights and prices ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/indices//constituents" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "kind": "index", "market_id": "presr_kalshi", "ticker": "presr_kalshi", "display_ticker": "presr_kalshi", "platform": "index", "weight": 0.4, "price": 91.5, "name": "Presidential (R)" }, { "kind": "index", "market_id": "senater_kalshi", "ticker": "senater_kalshi", "display_ticker": "senater_kalshi", "platform": "index", "weight": 0.3, "price": 99.0654, "name": "Senate (R)" } ], "meta": { "total": 5, "page": 1, "per_page": 500, "total_pages": 1, "has_next": false, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Index not found" } ```

:`. For composites: the child index_id."},"ticker":{"type":"string","description":"For markets: raw exchange ticker. For composites: the child index_id."},"display_ticker":{"type":"string","description":"Human-readable market label, Polymarket market slug when present, else the raw ticker."},"platform":{"type":"string","description":"'kalshi'/'polymarket' for markets; 'index' for composite components."},"weight":{"type":"number","description":"This constituent's share of the index, as a fraction of 1 (0.18 means 18 percent). These are the index's stored base weights, which sum to 1 across the full constituent list; a given published price point can differ, because the calculation renormalizes over only the constituents that had a usable price that cycle."},"price":{"type":["number","null"],"description":"Latest value for the constituent: for market constituents, the most recent yes-side traded price on the 0-100 cents scale; for sub-index constituents (`kind` = `index`), the child index's latest published level, which is in index points and not on the 0-100 scale. Null when the constituent has never traded or has no published value yet, and it carries no age bound, so an inactive market's price can be hours old."},"name":{"type":["string","null"],"description":"Display label for the constituent: the market's question for market rows, and the sub-index's name for `kind` = `index` rows."},"volume":{"type":["number","null"],"description":"All-time traded volume as a contract/share count (Kalshi contracts, Polymarket shares), not dollars. Present for kind='market' rows only. Unit is in `volume_unit`."},"volume_unit":{"description":"Wire unit for `volume`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"open_interest":{"type":["number","null"],"description":"Open interest: a Kalshi contract count; Polymarket's is USD. Present for kind='market' rows only. Unit is in `open_interest_unit`."},"open_interest_unit":{"description":"Wire unit for `open_interest`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"end_date":{"type":["string","null"],"format":"date-time","description":"When trading closes for a market constituent. Always null for sub-index constituents (`kind` = `index`), which do not expire."},"state_code":{"type":["string","null"],"description":"Two-letter state code (House/Senate/Gubernatorial); market rows only"},"city_code":{"type":["string","null"],"description":"City code (Mayoral); market rows only"}}}},"meta":{"type":"object","properties":{"total":{"type":["integer","null"],"description":"Total number of records matching the request across every page, not just the current one. null on an uncounted list; page using has_next. A relevance-ranked search is uncounted, and a searched events list stays uncounted even with sort. A searched markets list with sort returns a total over the ranked matches (at most 10,000)."},"page":{"type":"integer","description":"The 1-based page number this response covers."},"per_page":{"type":"integer","description":"Maximum number of items on a page. The last page may hold fewer."},"total_pages":{"type":["integer","null"],"description":"Total number of pages available at the current per_page. null whenever total is null; page using has_next."},"has_next":{"type":"boolean","description":"True when a page exists after this one."},"has_prev":{"type":"boolean","description":"True when this is not the first page."},"total_capped":{"type":"boolean","description":"True when `total` and `total_pages` reflect the server's counting ceiling rather than the exact matched count: the real set is at least `total` large. Render such totals as a lower bound (for example \"10,000+\"). Omitted when the count is exact. A sorted markets search that fills the 10,000-candidate ceiling sets this flag."}}}}},"example":{"data":[{"kind":"index","market_id":"presr_kalshi","ticker":"presr_kalshi","display_ticker":"presr_kalshi","platform":"index","weight":0.4,"price":91.5,"name":"Presidential (R)"},{"kind":"index","market_id":"senater_kalshi","ticker":"senater_kalshi","display_ticker":"senater_kalshi","platform":"index","weight":0.3,"price":99.0654,"name":"Senate (R)"}],"meta":{"total":5,"page":1,"per_page":500,"total_pages":1,"has_next":false,"has_prev":false}},"examples":[{"name":"default","value":{"data":[{"kind":"index","market_id":"presr_kalshi","ticker":"presr_kalshi","display_ticker":"presr_kalshi","platform":"index","weight":0.4,"price":91.5,"name":"Presidential (R)"},{"kind":"index","market_id":"senater_kalshi","ticker":"senater_kalshi","display_ticker":"senater_kalshi","platform":"index","weight":0.3,"price":99.0654,"name":"Senate (R)"}],"meta":{"total":5,"page":1,"per_page":500,"total_pages":1,"has_next":false,"has_prev":false}}}]},{"status":"403","description":"The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.","schema":{"type":"object","required":["error","status"],"properties":{"error":{"type":"string","description":"Human-readable reason the request was refused."},"status":{"type":"integer","description":"HTTP status code, repeated in the body."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase."}}},"example":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"},"examples":[{"name":"default","value":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"}}]},{"status":"404","description":"Index not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Stable, machine-readable code identifying the failure; branch on this rather than on `message`. One of `bad_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`, `service_unavailable`, `upstream_error`, `service_error`, or `internal_error`."},"message":{"type":"string","description":"Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld."}}},"example":{"error":"not_found","message":"Index not found"},"examples":[{"name":"default","value":{"error":"not_found","message":"Index not found"}}]},{"status":"429","description":"The organization's minute or UTC-day request budget is exhausted, or the organization has reached its cap on requests running at the same time (`limit: \"concurrency\"`). Wait `Retry-After` seconds before retrying; for a concurrency 429, reduce parallelism.","schema":{"type":"object","required":["error","limit","message"],"properties":{"error":{"type":"string","description":"Always `rate_limited`. Branch on this to detect a throttled request.","enum":["rate_limited"]},"limit":{"type":"string","description":"Which limit was hit: `rpm` for the per-minute cap, `daily` for the daily one, or `concurrency` for the cap on requests running at the same time.","enum":["rpm","daily","concurrency"]},"message":{"type":"string","description":"Human-readable explanation naming the limit that was exceeded."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase."}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Session token from the app, or an API key (the `ak_` prefix), sent as a Bearer token or an `?api_key=` query parameter."}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Find related news url: "https://docs.adjacent.markets/api/get-api-v1-indices-id-news.md" description: "Related news drawn from the index's constituent markets, ranked by closest market match (viamarketid, viamarketquestion) and relevance blended with recency." ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/indices//news" \ -H "Authorization: Bearer " ``` ```json title="default" lines=false { "data": [ { "article_id": "a1b2c3d4", "similarity": 0.84, "title": "Senate race tightens in Pennsylvania", "url": "https://example.com/news/senate-pa", "published_date": "2026-06-01T08:00:00Z", "source": "Reuters" }, { "article_id": "e5f6g7h8", "similarity": 0.79, "title": "New polling shifts House outlook", "url": "https://example.com/news/house-outlook", "published_date": "2026-06-01T07:30:00Z", "source": "AP" } ], "meta": { "total": 2, "page": 1, "per_page": 20, "total_pages": 1, "has_next": false, "has_prev": false } } ```

--- title: Get index price history url: "https://docs.adjacent.markets/api/get-api-v1-indices-id-prices.md" description: Get historical index values ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/indices//prices" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "timestamp": "2026-06-20T19:00:00Z", "price": 91.2892 }, { "timestamp": "2026-06-20T18:55:00Z", "price": 91.2703 } ], "meta": { "total": 7398, "page": 1, "per_page": 100, "total_pages": 74, "has_next": true, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ```

--- title: Get official daily values url: "https://docs.adjacent.markets/api/get-api-v1-indices-id-daily-values.md" description: "Official daily values for an index whose family publishes one, newest first. The NFL team indices stamp one official value per US-Eastern calendar day, taken from a fixed morning window; days without " --- --- title: Get membership events url: "https://docs.adjacent.markets/api/get-api-v1-indices-id-membership-events.md" description: "Recent membership events for an NFL team index, newest first: admissions (a market became its sleeve's active member) and settlements (a member's market resolved and its final value was booked). Indic" --- --- title: List markets url: "https://docs.adjacent.markets/api/get-api-v1-markets.md" description: Get a paginated list of prediction markets with filtering options. ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/markets" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "market_id": "kalshi:KXNBA-26-SAS", "ticker": "KXNBA-26-SAS", "display_ticker": "KXNBA-26-SAS", "platform": "kalshi", "question": "Will the San Antonio win the 2026 Pro Basketball Finals?", "link": "https://kalshi.com/markets/kxnba/kxnba-26", "probability": 65, "volume": 44526290, "volume_24h": 1157100.4, "open_interest": 21229516, "status": "active", "category": "Sports", "is_constituent": false, "end_date": "2028-06-29T14:00:00Z", "created_at": "2026-06-03T14:46:46.966195Z", "updated_at": "2026-06-03T14:46:46.966195Z" }, { "market_id": "kalshi:KXNBA-26-NYK", "ticker": "KXNBA-26-NYK", "display_ticker": "KXNBA-26-NYK", "platform": "kalshi", "question": "Will the New York win the 2026 Pro Basketball Finals?", "link": "https://kalshi.com/markets/kxnba/kxnba-26", "probability": 37, "volume": 42456692, "volume_24h": 1904408, "open_interest": 24467278, "status": "active", "category": "Sports", "is_constituent": false, "end_date": "2028-06-29T14:00:00Z", "created_at": "2026-06-03T14:41:36.373567Z", "updated_at": "2026-06-03T14:41:36.373567Z" } ], "meta": { "total": 87749, "page": 1, "per_page": 20, "total_pages": 4388, "has_next": true, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ```

:` (for example `kalshi:SENATEPA-26-R`). This is the id every other endpoint accepts, so use it rather than `ticker` when looking a market up."},"ticker":{"type":"string","description":"The venue's own symbol for the market, without the `:` prefix. Not guaranteed unique across venues, so use `market_id` as the lookup key and `display_ticker` as the human-readable label."},"display_ticker":{"type":"string","description":"Human-readable market label, Polymarket market slug when present, else the raw ticker."},"platform":{"type":"string","description":"The venue that lists this market: `kalshi` or `polymarket`. It is also the prefix of `market_id`, and it determines what the volume and open interest figures are counted in (see the companion `volume_unit`, `volume_24h_unit`, and `open_interest_unit` fields)."},"question":{"type":"string","description":"The market's question, worded as the venue words it. When a venue supplies no title we fall back to the raw ticker, so this is never empty."},"probability":{"type":["number","null"],"description":"Implied yes-side probability on the 0-100 scale, where 48.5 means 48.5 percent. This is the market's latest traded price."},"volume":{"type":["number","null"],"description":"All-time traded volume as a contract/share count (Kalshi contracts, Polymarket shares), not dollars. Unit is in `volume_unit`."},"volume_unit":{"description":"Wire unit for `volume`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"volume_24h":{"type":["number","null"],"description":"Trailing 24h volume. Platform-native: Kalshi contracts, Polymarket USD. Unit is in `volume_24h_unit`."},"volume_24h_unit":{"description":"Wire unit for `volume_24h`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"open_interest":{"type":["number","null"],"description":"Open interest: a Kalshi contract count; Polymarket's is USD. Unit is in `open_interest_unit`."},"open_interest_unit":{"description":"Wire unit for `open_interest`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"status":{"type":"string","description":"Lifecycle state of the market: `active` (trading), `closed` (trading has ended, outcome not yet published), `resolved` (settled with a known outcome), `expired` (ended long ago and never settled by the venue), or `unknown` (the venue reported no status we recognize)."},"category":{"type":["string","null"],"description":"Topic category of this market's parent event, normalized across venues (for example `Politics`, `Sports`, `Crypto`). Every market under the same event shares it."},"is_constituent":{"type":"boolean","description":"True when the market is a constituent of at least one index. The public markets list exposes every tracked market; default to constituents by filtering on this flag."},"indices":{"type":"array","description":"Index ids this market is a constituent of, ascending. Omitted when the market is in no index. Populated only on the authenticated /api/v1/markets list.","items":{"type":"string"}},"end_date":{"type":["string","null"],"format":"date-time","description":"When trading closes on the venue. This is not the settlement time; a market can sit in `closed` for a while before its outcome is published."},"created_at":{"type":"string","format":"date-time","description":"When we first recorded this market, not when the venue listed it. Only the authenticated markets list returns it; the public markets list omits it."},"updated_at":{"type":"string","format":"date-time","description":"When any stored field on this market last changed on our side, so it also moves on routine metadata refreshes and is not a price-move timestamp. Only the authenticated markets list returns it; the public markets list omits it."},"link":{"type":["string","null"],"description":"URL of the venue's public page for this contract, which on both venues is the parent event page rather than a single strike. Null when no working URL can be built, which happens for Kalshi markets whose series is unknown."},"state_code":{"type":["string","null"],"description":"Two-letter US state code when the contract is tied to a state race. Absent for national contests and for markets with no state on record."},"city_code":{"type":["string","null"],"description":"Mayoral city code parsed at ingest; present for Mayoral markets, absent otherwise."}}}},"meta":{"type":"object","properties":{"total":{"type":["integer","null"],"description":"Total number of records matching the request across every page, not just the current one. null on an uncounted list; page using has_next. A relevance-ranked search is uncounted, and a searched events list stays uncounted even with sort. A searched markets list with sort returns a total over the ranked matches (at most 10,000)."},"page":{"type":"integer","description":"The 1-based page number this response covers."},"per_page":{"type":"integer","description":"Maximum number of items on a page. The last page may hold fewer."},"total_pages":{"type":["integer","null"],"description":"Total number of pages available at the current per_page. null whenever total is null; page using has_next."},"has_next":{"type":"boolean","description":"True when a page exists after this one."},"has_prev":{"type":"boolean","description":"True when this is not the first page."},"total_capped":{"type":"boolean","description":"True when `total` and `total_pages` reflect the server's counting ceiling rather than the exact matched count: the real set is at least `total` large. Render such totals as a lower bound (for example \"10,000+\"). Omitted when the count is exact. A sorted markets search that fills the 10,000-candidate ceiling sets this flag."}}}}},"example":{"data":[{"market_id":"kalshi:KXNBA-26-SAS","ticker":"KXNBA-26-SAS","display_ticker":"KXNBA-26-SAS","platform":"kalshi","question":"Will the San Antonio win the 2026 Pro Basketball Finals?","link":"https://kalshi.com/markets/kxnba/kxnba-26","probability":65,"volume":44526290,"volume_24h":1157100.4,"open_interest":21229516,"status":"active","category":"Sports","is_constituent":false,"end_date":"2028-06-29T14:00:00Z","created_at":"2026-06-03T14:46:46.966195Z","updated_at":"2026-06-03T14:46:46.966195Z"},{"market_id":"kalshi:KXNBA-26-NYK","ticker":"KXNBA-26-NYK","display_ticker":"KXNBA-26-NYK","platform":"kalshi","question":"Will the New York win the 2026 Pro Basketball Finals?","link":"https://kalshi.com/markets/kxnba/kxnba-26","probability":37,"volume":42456692,"volume_24h":1904408,"open_interest":24467278,"status":"active","category":"Sports","is_constituent":false,"end_date":"2028-06-29T14:00:00Z","created_at":"2026-06-03T14:41:36.373567Z","updated_at":"2026-06-03T14:41:36.373567Z"}],"meta":{"total":87749,"page":1,"per_page":20,"total_pages":4388,"has_next":true,"has_prev":false}},"examples":[{"name":"default","value":{"data":[{"market_id":"kalshi:KXNBA-26-SAS","ticker":"KXNBA-26-SAS","display_ticker":"KXNBA-26-SAS","platform":"kalshi","question":"Will the San Antonio win the 2026 Pro Basketball Finals?","link":"https://kalshi.com/markets/kxnba/kxnba-26","probability":65,"volume":44526290,"volume_24h":1157100.4,"open_interest":21229516,"status":"active","category":"Sports","is_constituent":false,"end_date":"2028-06-29T14:00:00Z","created_at":"2026-06-03T14:46:46.966195Z","updated_at":"2026-06-03T14:46:46.966195Z"},{"market_id":"kalshi:KXNBA-26-NYK","ticker":"KXNBA-26-NYK","display_ticker":"KXNBA-26-NYK","platform":"kalshi","question":"Will the New York win the 2026 Pro Basketball Finals?","link":"https://kalshi.com/markets/kxnba/kxnba-26","probability":37,"volume":42456692,"volume_24h":1904408,"open_interest":24467278,"status":"active","category":"Sports","is_constituent":false,"end_date":"2028-06-29T14:00:00Z","created_at":"2026-06-03T14:41:36.373567Z","updated_at":"2026-06-03T14:41:36.373567Z"}],"meta":{"total":87749,"page":1,"per_page":20,"total_pages":4388,"has_next":true,"has_prev":false}}}]},{"status":"403","description":"The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.","schema":{"type":"object","required":["error","status"],"properties":{"error":{"type":"string","description":"Human-readable reason the request was refused."},"status":{"type":"integer","description":"HTTP status code, repeated in the body."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase."}}},"example":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"},"examples":[{"name":"default","value":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"}}]},{"status":"429","description":"The organization's minute or UTC-day request budget is exhausted, or the organization has reached its cap on requests running at the same time (`limit: \"concurrency\"`). Wait `Retry-After` seconds before retrying; for a concurrency 429, reduce parallelism.","schema":{"type":"object","required":["error","limit","message"],"properties":{"error":{"type":"string","description":"Always `rate_limited`. Branch on this to detect a throttled request.","enum":["rate_limited"]},"limit":{"type":"string","description":"Which limit was hit: `rpm` for the per-minute cap, `daily` for the daily one, or `concurrency` for the cap on requests running at the same time.","enum":["rpm","daily","concurrency"]},"message":{"type":"string","description":"Human-readable explanation naming the limit that was exceeded."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase."}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Session token from the app, or an API key (the `ak_` prefix), sent as a Bearer token or an `?api_key=` query parameter."}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Get market details url: "https://docs.adjacent.markets/api/get-api-v1-markets-id.md" description: Get detailed information about a specific market ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/markets/" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "market_id": "kalshi:KXNBA-26-SAS", "ticker": "KXNBA-26-SAS", "display_ticker": "KXNBA-26-SAS", "platform": "kalshi", "question": "Will the San Antonio win the 2026 Pro Basketball Finals?", "probability": 65, "volume": 44526290, "volume_24h": 1157100.4, "open_interest": 21229516, "status": "active", "open_time": "2025-07-12T14:00:00Z", "end_date": "2028-06-29T14:00:00Z", "expiration_date": "2026-06-30T14:00:00Z", "link": "https://kalshi.com/markets/kxnba/kxnba-26", "category": "Sports", "market_type": "binary", "rules_primary": "If San Antonio win the 2026 Pro Basketball Finals, then the market resolves to Yes.", "rules_secondary": "", "yes_sub_title": "San Antonio", "no_sub_title": "San Antonio" } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Market not found" } ```

:` (for example `kalshi:SENATEPA-26-R`). This is the id every other endpoint accepts, so use it rather than `ticker` when looking a market up."},"ticker":{"type":"string","description":"The venue's own symbol for the market, without the `:` prefix. Not guaranteed unique across venues, so use `market_id` as the lookup key and `display_ticker` as the human-readable label."},"display_ticker":{"type":"string","description":"Human-readable market label, Polymarket market slug when present, else the raw ticker."},"platform":{"type":"string","description":"The venue that lists this market: `kalshi` or `polymarket`. It is also the prefix of `market_id`, and it determines what the volume and open interest figures are counted in (see the companion `volume_unit`, `volume_24h_unit`, and `open_interest_unit` fields)."},"question":{"type":["string","null"],"description":"The market's question, worded as the venue words it. When a venue supplies no title we fall back to the raw ticker, so this is never empty."},"description":{"type":["string","null"],"description":"Longer explanatory text for the contract as supplied by the venue (Kalshi's subtitle, Polymarket's description). Frequently absent, especially on Kalshi."},"probability":{"type":["number","null"],"description":"Implied yes-side probability on the 0-100 scale, where 48.5 means 48.5 percent. For a live market this is the latest traded price. For a resolved market with a known yes/no outcome it is the settlement value (100 or 0) rather than the last traded price."},"volume":{"type":["number","null"],"description":"All-time traded volume as a contract/share count (Kalshi contracts, Polymarket shares), not dollars. Unit is in `volume_unit`."},"volume_unit":{"description":"Wire unit for `volume`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"volume_24h":{"type":["number","null"],"description":"Trailing 24h volume. Platform-native: Kalshi contracts, Polymarket USD. Unit is in `volume_24h_unit`."},"volume_24h_unit":{"description":"Wire unit for `volume_24h`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"open_interest":{"type":["number","null"],"description":"Open interest: a Kalshi contract count; Polymarket's is USD. Unit is in `open_interest_unit`."},"open_interest_unit":{"description":"Wire unit for `open_interest`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"yes_bid":{"type":["number","null"],"description":"Latest top-of-book YES bid (0-100 cents, ~1-min fresh)."},"yes_ask":{"type":["number","null"],"description":"Latest top-of-book YES ask (0-100 cents, ~1-min fresh)."},"no_bid":{"type":["number","null"],"description":"Derived NO bid (100 - yes_ask)."},"no_ask":{"type":["number","null"],"description":"Derived NO ask (100 - yes_bid)."},"event_ticker":{"type":["string","null"],"description":"Raw venue event ticker (unprefixed)."},"status":{"type":["string","null"],"description":"Lifecycle state of the market: `active` (trading), `closed` (trading has ended, outcome not yet published), `resolved` (settled with a known outcome), `expired` (ended long ago and never settled by the venue), or `unknown` (the venue reported no status we recognize)."},"open_time":{"type":["string","null"],"format":"date-time","description":"When the market opened for trading on the venue. Static once set, and absent for venues that do not report an open time."},"end_date":{"type":["string","null"],"format":"date-time","description":"When trading closes on the venue. This is not the settlement time; a market can sit in `closed` for a while before it resolves, so see `expiration_date` for the expected settlement."},"expiration_date":{"type":["string","null"],"format":"date-time","description":"Expected settlement time as published by the venue. Distinct from `end_date`, which is when trading closes; a market sits between the two while awaiting its outcome."},"link":{"type":["string","null"],"description":"URL of the venue's public page for this contract, which on both venues is the parent event page rather than a single strike. Null when no working URL can be built, which happens for Kalshi markets whose series is unknown."},"category":{"type":["string","null"],"description":"Topic category of this market's parent event, normalized across venues (for example `Politics`, `Sports`, `Crypto`). Every market under the same event shares it."},"state_code":{"type":["string","null"],"description":"Two-letter US state code parsed from the ticker when the contract is tied to a state (Senate, Governor, House). Absent for contracts with no state, including Mayoral markets, which carry `city_code` instead."},"city_code":{"type":["string","null"],"description":"Mayoral city code parsed at ingest; present for Mayoral markets, absent otherwise."},"market_type":{"type":["string","null"],"description":"The venue's own contract-type label (for example a binary or scalar market). Static contract metadata, absent when the venue reports none."},"rules_primary":{"type":["string","null"],"description":"The venue's primary settlement rules text, describing what resolves the contract YES."},"rules_secondary":{"type":["string","null"],"description":"Additional settlement rules text from the venue, covering edge cases and sourcing. Frequently absent."},"yes_sub_title":{"type":["string","null"],"description":"Short label for the YES leg as the venue words it, suitable for a button or leg header."},"no_sub_title":{"type":["string","null"],"description":"Short label for the NO leg as the venue words it, suitable for a button or leg header."},"settlement":{"type":["object","null"],"description":"Resolution provenance, platform-agnostic (Kalshi series object / Polymarket resolution_source).","properties":{"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":["string","null"]},"url":{"type":["string","null"]}}}},"terms_url":{"type":["string","null"]}}},"result":{"type":["string","null"],"description":"Resolution outcome reported by the venue: `yes` or `no`. Absent while the market is open, and for markets that settle to a scalar value or without a per-market yes/no outcome. When set, `probability` is the settlement value (100 or 0)."},"stats":{"description":"Trailing returns and risk statistics computed from the market's daily trade-price series over roughly the trailing 400 days. The values are null individually when the series is too short for that window.","allOf":[{"type":"object","properties":{"trailing_returns":{"type":"array","description":"Percent price change over each of six fixed trailing windows: 1D, 1W, 1M, 3M, YTD, and 1Y.","items":{"type":"object","required":["label"],"properties":{"label":{"type":"string","description":"The trailing window this return covers: `1D`, `1W`, `1M`, `3M`, `YTD`, or `1Y`."},"value":{"type":["number","null"],"description":"Percent change from the value at the start of the window to the latest value in the series. Null when the series has no data point close enough to the start of that window."},"point_change":{"type":["number","null"],"description":"Absolute change in the level's own units over the same window. Point-quoted indices (quote_convention `points`) express trailing performance with this figure; omitted when no comparable historical point exists."}}}},"risk":{"type":"object","description":"Volatility, range, and period return computed over the most recent 31 points of the daily series. The window counts data points, so a series with gaps spans more than 31 calendar days.","properties":{"volatility":{"type":["number","null"],"description":"Annualized volatility in percent, from the daily returns across the most recent 31 daily data points, annualized over 365 days because these markets trade every calendar day. Null when the daily series has fewer than 3 points."},"daily_vol":{"type":["number","null"],"description":"Standard deviation of the daily returns across the most recent 31 daily data points, in percent and not annualized. Null when the daily series has fewer than 3 points."},"range_high":{"type":["number","null"],"description":"Highest value reached within the most recent 31 daily data points, in the series' own units (index points for an index, 0-100 for a rate). Null when the daily series has fewer than 3 points."},"range_low":{"type":["number","null"],"description":"Lowest value reached within the most recent 31 daily data points, in the series' own units (index points for an index, 0-100 for a rate). Null when the daily series has fewer than 3 points."},"return_pct":{"type":["number","null"],"description":"Percent change from the first to the last of the most recent 31 daily data points. Null when the daily series has fewer than 3 points."}}}}}],"nullable":true}}},"example":{"market_id":"kalshi:KXNBA-26-SAS","ticker":"KXNBA-26-SAS","display_ticker":"KXNBA-26-SAS","platform":"kalshi","question":"Will the San Antonio win the 2026 Pro Basketball Finals?","probability":65,"volume":44526290,"volume_24h":1157100.4,"open_interest":21229516,"status":"active","open_time":"2025-07-12T14:00:00Z","end_date":"2028-06-29T14:00:00Z","expiration_date":"2026-06-30T14:00:00Z","link":"https://kalshi.com/markets/kxnba/kxnba-26","category":"Sports","market_type":"binary","rules_primary":"If San Antonio win the 2026 Pro Basketball Finals, then the market resolves to Yes.","rules_secondary":"","yes_sub_title":"San Antonio","no_sub_title":"San Antonio"},"examples":[{"name":"default","value":{"market_id":"kalshi:KXNBA-26-SAS","ticker":"KXNBA-26-SAS","display_ticker":"KXNBA-26-SAS","platform":"kalshi","question":"Will the San Antonio win the 2026 Pro Basketball Finals?","probability":65,"volume":44526290,"volume_24h":1157100.4,"open_interest":21229516,"status":"active","open_time":"2025-07-12T14:00:00Z","end_date":"2028-06-29T14:00:00Z","expiration_date":"2026-06-30T14:00:00Z","link":"https://kalshi.com/markets/kxnba/kxnba-26","category":"Sports","market_type":"binary","rules_primary":"If San Antonio win the 2026 Pro Basketball Finals, then the market resolves to Yes.","rules_secondary":"","yes_sub_title":"San Antonio","no_sub_title":"San Antonio"}}]},{"status":"403","description":"The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.","schema":{"type":"object","required":["error","status"],"properties":{"error":{"type":"string","description":"Human-readable reason the request was refused."},"status":{"type":"integer","description":"HTTP status code, repeated in the body."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase."}}},"example":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"},"examples":[{"name":"default","value":{"error":"Insufficient scope: a Pro or Premium API plan is required","status":403,"upgrade_url":"https://adjacent.markets/subscribe"}}]},{"status":"404","description":"Market not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Stable, machine-readable code identifying the failure; branch on this rather than on `message`. One of `bad_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`, `service_unavailable`, `upstream_error`, `service_error`, or `internal_error`."},"message":{"type":"string","description":"Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld."}}},"example":{"error":"not_found","message":"Market not found"},"examples":[{"name":"default","value":{"error":"not_found","message":"Market not found"}}]},{"status":"429","description":"The organization's minute or UTC-day request budget is exhausted, or the organization has reached its cap on requests running at the same time (`limit: \"concurrency\"`). Wait `Retry-After` seconds before retrying; for a concurrency 429, reduce parallelism.","schema":{"type":"object","required":["error","limit","message"],"properties":{"error":{"type":"string","description":"Always `rate_limited`. Branch on this to detect a throttled request.","enum":["rate_limited"]},"limit":{"type":"string","description":"Which limit was hit: `rpm` for the per-minute cap, `daily` for the daily one, or `concurrency` for the cap on requests running at the same time.","enum":["rpm","daily","concurrency"]},"message":{"type":"string","description":"Human-readable explanation naming the limit that was exceeded."},"upgrade_url":{"type":"string","format":"uri","description":"Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase."}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Session token from the app, or an API key (the `ak_` prefix), sent as a Bearer token or an `?api_key=` query parameter."}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Get market candles url: "https://docs.adjacent.markets/api/get-api-v1-markets-id-candles.md" description: "Get OHLC candles for a market, optionally scoped to a source bucket window." ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/markets//candles" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "timestamp": "2026-06-01T14:00:00Z", "yes_bid": 47, "yes_ask": 49, "mid": 48, "close": 48, "volume": 12500, "source": "kalshi_candlestick", "synthetic_book": false }, { "timestamp": "2026-06-01T13:00:00Z", "yes_bid": 47, "yes_ask": 47, "mid": 47, "close": 47, "volume": 9800, "source": "polymarket_clob_history", "synthetic_book": true } ], "meta": { "total": 2, "page": 1, "per_page": 100, "total_pages": 1, "has_next": false, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Market not found" } ```

--- title: Find related news url: "https://docs.adjacent.markets/api/get-api-v1-markets-id-news.md" description: Find news articles semantically related to a market using AI embeddings ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/markets//news" \ -H "Authorization: Bearer " ``` ```json title="default" lines=false { "data": [ { "article_id": "a1b2c3d4", "similarity": 0.87, "title": "Senate race tightens in Pennsylvania", "url": "https://example.com/news/senate-pa", "published_date": "2026-06-01T08:00:00Z", "source": "Reuters" }, { "article_id": "e5f6g7h8", "similarity": 0.81, "title": "New polling shifts House outlook", "url": "https://example.com/news/house-outlook", "published_date": "2026-06-01T07:30:00Z", "source": "AP" } ], "meta": { "total": 2, "page": 1, "per_page": 20, "total_pages": 1, "has_next": false, "has_prev": false } } ```

--- title: Get market price history url: "https://docs.adjacent.markets/api/get-api-v1-markets-id-prices.md" description: Get historical price data with OHLC aggregation ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/markets//prices" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "timestamp": "2026-06-03T04:00:00Z", "price": 64.5219, "ohlc": { "open": 63, "high": 65, "low": 61, "close": 64 } }, { "timestamp": "2026-06-02T04:00:00Z", "price": 63.9531, "ohlc": { "open": 63, "high": 65, "low": 61, "close": 64 } } ], "meta": { "total": 68, "page": 1, "per_page": 100, "total_pages": 1, "has_next": false, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Market not found" } ```

--- title: Get market quote snapshots url: "https://docs.adjacent.markets/api/get-api-v1-markets-id-quotes.md" description: "Get raw bid/ask quote snapshots for a market, optionally scoped to a source bucket window." ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/markets//quotes" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "timestamp": "2026-06-01T14:22:10Z", "yes_bid": 47, "yes_ask": 49, "mid": 48 }, { "timestamp": "2026-06-01T14:21:10Z", "yes_bid": 46, "yes_ask": 48, "mid": 47 } ], "meta": { "total": 2, "page": 1, "per_page": 100, "total_pages": 1, "has_next": false, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Market not found" } ```

--- title: Find similar markets url: "https://docs.adjacent.markets/api/get-api-v1-markets-id-similar.md" description: Find semantically similar markets using AI embeddings ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/markets//similar" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "market_id": "kalshi:KXNBA-26-NYK", "similarity": 0.91, "platform": "kalshi", "question": "Will the New York win the 2026 Pro Basketball Finals?" }, { "market_id": "kalshi:KXNBA-26-BOS", "similarity": 0.88, "platform": "kalshi", "question": "Will the Boston win the 2026 Pro Basketball Finals?" } ], "meta": { "total": 2, "page": 1, "per_page": 20, "total_pages": 1, "has_next": false, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ```

--- title: Get market trades url: "https://docs.adjacent.markets/api/get-api-v1-markets-id-trades.md" description: Get recent trades for a market ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/markets//trades" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "trade_id": "d25ba779-817d-6df2-9bc1-e381aeadecbc", "timestamp": "2026-06-03T14:46:34.680308Z", "price": 65, "count": 30, "side": "yes", "volume": 19.5 }, { "trade_id": "acd34816-75a9-6fb6-72f9-f6b48c48a660", "timestamp": "2026-06-03T14:46:31.814730Z", "price": 65, "count": 225, "side": "yes", "volume": 146.25 } ], "meta": { "total": 128113, "page": 1, "per_page": 20, "total_pages": 6406, "has_next": true, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Market not found" } ```

--- title: List news articles url: "https://docs.adjacent.markets/api/get-api-v1-news.md" description: "Stored articles, newest first, with optional source and language filters." --- --- title: List available news filters url: "https://docs.adjacent.markets/api/get-api-v1-news-filters.md" description: "Distinct source ids and language codes present in the articles, for populating filter controls." --- --- title: Get latest news url: "https://docs.adjacent.markets/api/get-api-v1-news-latest.md" description: "Get the latest news articles from 5,000+ sources" ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/news/latest" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "id": "a1b2c3d4", "title": "Senate race tightens in Pennsylvania", "url": "https://example.com/news/senate-pa", "published_date": "2026-06-01T08:00:00Z", "author": "Jane Doe", "source": "Reuters" }, { "id": "e5f6g7h8", "title": "New polling shifts House outlook", "url": "https://example.com/news/house-outlook", "published_date": "2026-06-01T07:30:00Z", "author": "John Smith", "source": "AP" } ], "meta": { "total": 2, "page": 1, "per_page": 20, "total_pages": 1, "has_next": false, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ```

--- title: Get a news article url: "https://docs.adjacent.markets/api/get-api-v1-news-id.md" description: "Full stored record for one article, including its description and truncated body." --- --- title: Find related markets url: "https://docs.adjacent.markets/api/get-api-v1-news-id-markets.md" description: Find markets semantically related to a news article using AI embeddings ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/news//markets" \ -H "Authorization: Bearer " ``` ```json title="default" lines=false { "data": [ { "market_id": "kalshi:SENATEPA-26-R", "similarity": 0.89, "name": "Will a Republican win the 2026 Pennsylvania U.S. Senate election?", "platform": "kalshi" }, { "market_id": "kalshi:GOVPA-26-R", "similarity": 0.76, "name": "Will a Republican win the 2026 Pennsylvania Governor election?", "platform": "kalshi" } ], "meta": { "total": 2, "page": 1, "per_page": 20, "total_pages": 1, "has_next": false, "has_prev": false } } ```

--- title: List public events url: "https://docs.adjacent.markets/api/get-api-v1-public-events.md" description: Markets grouped into their parent events. ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/public/events" ``` ```json title="default" lines=false { "data": [ { "event_id": "kalshi:KXPRESPARTY-2028", "name": "2028 Presidential Election winner? (Party)", "category": "Elections", "market_count": 2, "volume": 525225.94, "volume_unit": "contracts", "open_interest": 254090.81, "open_interest_unit": "contracts", "is_constituent": true, "markets": [ { "market_id": "kalshi:KXPRESPARTY-2028-D", "ticker": "KXPRESPARTY-2028-D", "display_ticker": "KXPRESPARTY-2028-D", "platform": "kalshi", "question": "Will Democratic win the Presidency in 2028?", "link": "https://kalshi.com/markets/kxpresparty/kxpresparty-2028", "probability": 58, "volume": 233444.98, "volume_unit": "contracts", "volume_24h": 14.2, "volume_24h_unit": "contracts", "open_interest": 116538.21, "open_interest_unit": "contracts", "status": "active", "category": "Elections", "is_constituent": true, "end_date": "2029-11-07T15:00:00Z" } ] } ], "meta": { "total": 412, "page": 1, "per_page": 1, "total_pages": 412, "has_next": true, "has_prev": false } } ```

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/public/indices" ``` ```json title="default" lines=false { "data": [ { "index_id": "red", "name": "Republican Political Future Index", "ticker": "RED", "description": "Composite of Republican party-line contests across all levels of office in the United States", "constituents_count": 5, "is_composite": true, "office_category": null, "party_side": "republican", "latest_price": 96.6691, "previous_close_1d": 96.6815, "change_1d": -0.0217, "price_change_1d": -0.0124, "change_7d": 0.9579976564409233, "change_30d": 6.543321995939699, "change_90d": 8.343186711332823, "previous_close_7d": 95.7518, "previous_close_30d": 90.7322, "previous_close_90d": 89.2249, "updated_at": "2026-07-29T14:02:00Z", "methodology": "upfi", "created_at": "2026-06-02T14:20:24.299003Z", "display_order": 1, "halted": false } ], "meta": { "total": 10, "page": 1, "per_page": 1, "total_pages": 10, "has_next": true, "has_prev": false } } ```

--- title: Get public index detail url: "https://docs.adjacent.markets/api/get-api-v1-public-indices-id.md" description: "Index detail with trailing-return and risk stats, plus composition analytics: state exposure, maturity profile, weight attribution, and per-constituent returns over 1d, 7d, and 30d." ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/public/indices/" ``` ```json title="default" lines=false { "index_id": "red", "name": "Republican Political Future Index", "ticker": "RED", "description": "Composite of Republican party-line contests across all levels of office in the United States", "office_category": null, "methodology": "upfi", "is_composite": true, "constituents_count": 5, "latest_price": 96.6691, "level_interpretation": [ { "label": "Index level", "value": "96.7" }, { "label": "Composite probability value", "value": "46.7%" }, { "label": "Interpretation", "value": "-3.3 pts" } ], "price_change_1d": -0.0124, "price_change_7d": 0.9173, "previous_close_1d": 96.6815, "previous_close_7d": 95.7518, "stats": { "trailing_returns": [ { "label": "1D", "value": -0.01282561813790593 }, { "label": "1W", "value": 0.9579976564409206 } ] } } ```

:`) for the attributed constituent."},"ticker":{"type":"string","description":"Raw exchange ticker of the constituent market. Use `display_ticker` for a label and `market_id` for lookups or links."},"display_ticker":{"type":"string","description":"Human-readable market label, Polymarket market slug when present, else the raw ticker."},"name":{"type":["string","null"],"description":"The constituent market's question text. Absent when the market has no question on record."},"contribution":{"type":"number","description":"The market's share of the index's blended probability, equal to `weight` multiplied by `price` divided by 100. Rows are ordered by descending absolute contribution and, across all rows, sum to the blended probability behind the published index level."},"weight":{"type":"number","description":"The market's effective weight in the index, as a fraction rather than a percent, after any sub-index legs are flattened. Weights across all rows sum to about 1.0."},"price":{"type":"number","description":"The market's probability, 0-100, as it entered the index calculation these figures reconcile to. Because it is the value that calculation consumed, it can lag the market's latest trade."}}}},"constituent_returns":{"type":"array","description":"Per-constituent own price move for the 1d/7d/30d trailing windows, precomputed server-side. Each row includes percent_change; each window includes group_by and groups.","items":{"type":"object","description":"Per-constituent price moves for one trailing window, computed server-side. A window whose start predates the index's earliest compute cycle comes back empty (rows: [], groups: []), degrading together with the null stats.trailing_returns for the same window.","properties":{"window":{"type":"string","description":"Window label: 1d / 7d / 30d."},"group_by":{"type":"string","description":"Dimension groups are keyed by. state means each group's key is a US state (or other for untagged rows). A city, party, or office grouping is a different group_by value, not a new field on the group.","enum":["state"]},"rows":{"type":"array","description":"One row per constituent held at the end of the window, ordered from largest to smallest end weight. Constituents that left the index before the window ended are omitted, and the array is empty when the index has no history reaching back to the window start.","items":{"type":"object","description":"One constituent's own price move over a trailing window. Every field is computed server-side and rendered verbatim.","properties":{"constituent_id":{"type":"string","description":"Prefixed constituent id (with kind): market_id for a market, index_id for a sub-index leg, rate_id for a rate sleeve, event_id for a same-event race."},"kind":{"type":"string","description":"Navigable kind: market (market page) / index (index page) / rate (rate page) / event (a same-event race, not individually linkable).","enum":["market","index","event","rate"]},"ticker":{"type":"string","description":"Display ticker for the constituent: the market's ticker (a readable slug where the venue provides one), the child index's ticker for a sub-index leg, the rate_id for a rate sleeve, or the race identifier for a same-event group."},"name":{"type":["string","null"],"description":"Readable name for the constituent: the market's question, the child index's name, the rate's name, or the event's name. Absent when the underlying record has none."},"platform":{"type":"string","description":"kalshi/polymarket for markets; index for a composite's sub-index leg; rate for a rate-backed sleeve."},"state_code":{"type":["string","null"],"description":"Two-letter state for House/Senate/Gov market constituents; absent for composite legs, same-event races, and markets with no state."},"weight":{"type":"number","description":"Effective (composite-flattened, normalized) weight at the window end."},"start_weight":{"type":"number","description":"Same weight at the window start, so a tile whose size changed over the window (a reweighting) is explainable (start_weight -> weight)."},"start_price":{"type":"number","description":"Constituent value at the start of the window (0-100 probability for markets; the child's UPFI value for a composite's sub-index leg; the rate mark for a rate sleeve)."},"end_price":{"type":"number","description":"Constituent value at the end of the window (same scale as start_price)."},"point_change":{"type":"number","description":"end_price minus start_price, in the constituent's own points."},"percent_change":{"type":["number","null"],"description":"Percent change from start_price to end_price: (end_price - start_price) / start_price * 100. Null when start_price is 0."}}}},"groups":{"type":"array","description":"Aggregates of rows under group_by, ordered from largest to smallest weight. Empty when rows is empty.","items":{"type":"object","description":"One grouped slice of constituent returns for a trailing window. The grouping dimension is the window's group_by; key identifies the group. Weight, point_change, and percent_change are computed server-side from the window's rows.","properties":{"key":{"type":"string","description":"Group id inside group_by. When group_by is state, this is a two-letter US state, or other for untagged rows."},"label":{"type":"string","description":"Display string when it differs from key. Omitted when key is already the label."},"weight":{"type":"number","description":"Sum of member end weights."},"member_count":{"type":"integer","description":"Count of members with end weight greater than 0."},"point_change":{"type":"number","description":"Weight-average of member point_change."},"percent_change":{"type":["number","null"],"description":"Weight-average of member percent_change over members whose percent_change is present. Null when no member has a usable start_price."}}}}}}}}}],"nullable":true},"halted":{"type":"boolean","description":"True when the latest index value was carried forward because the index fell below its constituent floor."},"halt_valid_constituents":{"type":["integer","null"],"description":"When halted, the valid (priced, guardrail-passing) constituents at the most recent halt cycle. Omitted when not halted."},"halt_min_constituents":{"type":["integer","null"],"description":"When halted, the category constituent floor the index fell below. Omitted when not halted."},"halt_reason":{"type":["string","null"],"description":"When halted, a human-readable explanation of the halt, composed from the constituent halt counts. Omitted when not halted."},"visibility":{"type":"string","description":"Access level of the index. `public` is visible to everyone; `organization` is visible to members of listed organizations. Other reserved values may appear on authenticated responses. Omitted on the anonymous public tier, which returns only public indices.","enum":["public","superuser","organization"]},"official_daily_value":{"description":"Most recent official daily value. Null when this index family does not publish daily values.","allOf":[{"type":"object","description":"One official daily value: the value stamped for one US-Eastern calendar day.","required":["et_date","value"],"properties":{"et_date":{"type":"string","format":"date","description":"The US-Eastern calendar day the value is official for."},"value":{"type":"number","description":"The official index value for that day, in index points."}}}],"nullable":true},"sleeves":{"type":"array","description":"Current sleeve state for an NFL team index. Empty for other index families.","items":{"type":"object","description":"One sleeve of an NFL team index: a fixed seat holding at most one market at a time.","required":["sleeve","active","cumulative_points"],"properties":{"sleeve":{"type":"string","description":"Stable sleeve name.","enum":["super_bowl","conference","division","next_game"]},"active":{"type":"boolean","description":"Whether the sleeve holds an active member. An inactive sleeve keeps its seat and contributes nothing until a successor is admitted."},"market_id":{"type":["string","null"],"description":"The current member's market id. Omitted for an inactive sleeve."},"display_ticker":{"type":["string","null"],"description":"Display label for the current member. Omitted for an inactive sleeve."},"name":{"type":["string","null"],"description":"The current member's question. Omitted for an inactive sleeve."},"mark_price":{"type":["number","null"],"description":"The sleeve's latest approved mark, 0-100. Omitted for an inactive sleeve or before the sleeve's first computed mark."},"cumulative_points":{"type":"number","description":"The sleeve's cumulative contribution to the index level since base, in index points."}}}}}},"example":{"index_id":"red","name":"Republican Political Future Index","ticker":"RED","description":"Composite of Republican party-line contests across all levels of office in the United States","office_category":null,"methodology":"upfi","is_composite":true,"constituents_count":5,"latest_price":96.6691,"level_interpretation":[{"label":"Index level","value":"96.7"},{"label":"Composite probability value","value":"46.7%"},{"label":"Interpretation","value":"-3.3 pts"}],"price_change_1d":-0.0124,"price_change_7d":0.9173,"previous_close_1d":96.6815,"previous_close_7d":95.7518,"stats":{"trailing_returns":[{"label":"1D","value":-0.01282561813790593},{"label":"1W","value":0.9579976564409206}]}},"examples":[{"name":"default","value":{"index_id":"red","name":"Republican Political Future Index","ticker":"RED","description":"Composite of Republican party-line contests across all levels of office in the United States","office_category":null,"methodology":"upfi","is_composite":true,"constituents_count":5,"latest_price":96.6691,"level_interpretation":[{"label":"Index level","value":"96.7"},{"label":"Composite probability value","value":"46.7%"},{"label":"Interpretation","value":"-3.3 pts"}],"price_change_1d":-0.0124,"price_change_7d":0.9173,"previous_close_1d":96.6815,"previous_close_7d":95.7518,"stats":{"trailing_returns":[{"label":"1D","value":-0.01282561813790593},{"label":"1W","value":0.9579976564409206}]}}}]},{"status":"404","description":"Index not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Stable, machine-readable code identifying the failure; branch on this rather than on `message`. One of `bad_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`, `service_unavailable`, `upstream_error`, `service_error`, or `internal_error`."},"message":{"type":"string","description":"Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld."}}},"examples":[]}],"security":[],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Get public index constituents url: "https://docs.adjacent.markets/api/get-api-v1-public-indices-id-constituents.md" description: "Constituents of an index, both markets and child sub-indices, with their weights." --- :`. For composites: the child index_id."},"ticker":{"type":"string","description":"For markets: raw exchange ticker. For composites: the child index_id."},"display_ticker":{"type":"string","description":"Human-readable market label, Polymarket market slug when present, else the raw ticker."},"platform":{"type":"string","description":"'kalshi'/'polymarket' for markets; 'index' for composite components."},"weight":{"type":"number","description":"This constituent's share of the index, as a fraction of 1 (0.18 means 18 percent). These are the index's stored base weights, which sum to 1 across the full constituent list; a given published price point can differ, because the calculation renormalizes over only the constituents that had a usable price that cycle."},"price":{"type":["number","null"],"description":"Latest value for the constituent: for market constituents, the most recent yes-side traded price on the 0-100 cents scale; for sub-index constituents (`kind` = `index`), the child index's latest published level, which is in index points and not on the 0-100 scale. Null when the constituent has never traded or has no published value yet, and it carries no age bound, so an inactive market's price can be hours old."},"name":{"type":["string","null"],"description":"Display label for the constituent: the market's question for market rows, and the sub-index's name for `kind` = `index` rows."},"volume":{"type":["number","null"],"description":"All-time traded volume as a contract/share count (Kalshi contracts, Polymarket shares), not dollars. Present for kind='market' rows only. Unit is in `volume_unit`."},"volume_unit":{"description":"Wire unit for `volume`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"open_interest":{"type":["number","null"],"description":"Open interest: a Kalshi contract count; Polymarket's is USD. Present for kind='market' rows only. Unit is in `open_interest_unit`."},"open_interest_unit":{"description":"Wire unit for `open_interest`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"end_date":{"type":["string","null"],"format":"date-time","description":"When trading closes for a market constituent. Always null for sub-index constituents (`kind` = `index`), which do not expire."},"state_code":{"type":["string","null"],"description":"Two-letter state code (House/Senate/Gubernatorial); market rows only"},"city_code":{"type":["string","null"],"description":"City code (Mayoral); market rows only"}}}},"meta":{"allOf":[{"type":"object","properties":{"total":{"type":["integer","null"],"description":"Total number of records matching the request across every page, not just the current one. null on an uncounted list; page using has_next. A relevance-ranked search is uncounted, and a searched events list stays uncounted even with sort. A searched markets list with sort returns a total over the ranked matches (at most 10,000)."},"page":{"type":"integer","description":"The 1-based page number this response covers."},"per_page":{"type":"integer","description":"Maximum number of items on a page. The last page may hold fewer."},"total_pages":{"type":["integer","null"],"description":"Total number of pages available at the current per_page. null whenever total is null; page using has_next."},"has_next":{"type":"boolean","description":"True when a page exists after this one."},"has_prev":{"type":"boolean","description":"True when this is not the first page."},"total_capped":{"type":"boolean","description":"True when `total` and `total_pages` reflect the server's counting ceiling rather than the exact matched count: the real set is at least `total` large. Render such totals as a lower bound (for example \"10,000+\"). Omitted when the count is exact. A sorted markets search that fills the 10,000-candidate ceiling sets this flag."}}}]}}},"example":{"data":[{"kind":"index","market_id":"presr_kalshi","ticker":"presr_kalshi","display_ticker":"presr_kalshi","platform":"index","weight":0.4000000059604645,"price":91.5,"name":"Presidential (R)"}],"meta":{"total":5,"page":1,"per_page":1,"total_pages":5,"has_next":true,"has_prev":false}},"examples":[{"name":"default","value":{"data":[{"kind":"index","market_id":"presr_kalshi","ticker":"presr_kalshi","display_ticker":"presr_kalshi","platform":"index","weight":0.4000000059604645,"price":91.5,"name":"Presidential (R)"}],"meta":{"total":5,"page":1,"per_page":1,"total_pages":5,"has_next":true,"has_prev":false}}}]},{"status":"404","description":"Index not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Stable, machine-readable code identifying the failure; branch on this rather than on `message`. One of `bad_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`, `service_unavailable`, `upstream_error`, `service_error`, or `internal_error`."},"message":{"type":"string","description":"Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld."}}},"examples":[]}],"security":[],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Get public index correlation matrix url: "https://docs.adjacent.markets/api/get-api-v1-public-indices-id-correlation.md" description: "Pearson correlation matrix of daily returns across a composite index's sub-indices." --- --- title: Get public index price history url: "https://docs.adjacent.markets/api/get-api-v1-public-indices-id-prices.md" description: Delayed index price series. --- --- title: List public markets url: "https://docs.adjacent.markets/api/get-api-v1-public-markets.md" description: Paginated list of tracked markets on the 15-minute-delayed public tier. ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/public/markets" ``` ```json title="default" lines=false { "data": [ { "market_id": "kalshi:KXPRESPARTY-2028-D", "ticker": "KXPRESPARTY-2028-D", "display_ticker": "KXPRESPARTY-2028-D", "platform": "kalshi", "question": "Will Democratic win the Presidency in 2028?", "link": "https://kalshi.com/markets/kxpresparty/kxpresparty-2028", "probability": 58, "volume": 233444.98, "volume_unit": "contracts", "volume_24h": 14.2, "volume_24h_unit": "contracts", "open_interest": 116538.21, "open_interest_unit": "contracts", "status": "active", "category": "Elections", "is_constituent": true } ], "meta": { "total": 1155, "page": 1, "per_page": 1, "total_pages": 1155, "has_next": true, "has_prev": false } } ```

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/public/markets/" ``` ```json title="default" lines=false { "market_id": "kalshi:KXPRESPARTY-2028-D", "ticker": "KXPRESPARTY-2028-D", "display_ticker": "KXPRESPARTY-2028-D", "platform": "kalshi", "question": "Will Democratic win the Presidency in 2028?", "probability": 58, "volume": 233444.98, "volume_unit": "contracts", "volume_24h": 14.2, "volume_24h_unit": "contracts", "open_interest": 116538.21, "open_interest_unit": "contracts", "yes_bid": 57, "yes_ask": 58, "no_bid": 42, "no_ask": 43, "event_ticker": "KXPRESPARTY-2028", "status": "active", "open_time": "2024-11-06T15:00:00Z", "end_date": "2029-11-07T15:00:00Z", "expiration_date": "2029-01-21T15:00:00Z", "link": "https://kalshi.com/markets/kxpresparty/kxpresparty-2028", "category": "Elections", "market_type": "binary" } ```

:` (for example `kalshi:SENATEPA-26-R`). This is the id every other endpoint accepts, so use it rather than `ticker` when looking a market up."},"ticker":{"type":"string","description":"The venue's own symbol for the market, without the `:` prefix. Not guaranteed unique across venues, so use `market_id` as the lookup key and `display_ticker` as the human-readable label."},"display_ticker":{"type":"string","description":"Human-readable market label, Polymarket market slug when present, else the raw ticker."},"platform":{"type":"string","description":"The venue that lists this market: `kalshi` or `polymarket`. It is also the prefix of `market_id`, and it determines what the volume and open interest figures are counted in (see the companion `volume_unit`, `volume_24h_unit`, and `open_interest_unit` fields)."},"question":{"type":["string","null"],"description":"The market's question, worded as the venue words it. When a venue supplies no title we fall back to the raw ticker, so this is never empty."},"description":{"type":["string","null"],"description":"Longer explanatory text for the contract as supplied by the venue (Kalshi's subtitle, Polymarket's description). Frequently absent, especially on Kalshi."},"probability":{"type":["number","null"],"description":"Implied yes-side probability on the 0-100 scale, where 48.5 means 48.5 percent. For a live market this is the latest traded price. For a resolved market with a known yes/no outcome it is the settlement value (100 or 0) rather than the last traded price."},"volume":{"type":["number","null"],"description":"All-time traded volume as a contract/share count (Kalshi contracts, Polymarket shares), not dollars. Unit is in `volume_unit`."},"volume_unit":{"description":"Wire unit for `volume`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"volume_24h":{"type":["number","null"],"description":"Trailing 24h volume. Platform-native: Kalshi contracts, Polymarket USD. Unit is in `volume_24h_unit`."},"volume_24h_unit":{"description":"Wire unit for `volume_24h`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"open_interest":{"type":["number","null"],"description":"Open interest: a Kalshi contract count; Polymarket's is USD. Unit is in `open_interest_unit`."},"open_interest_unit":{"description":"Wire unit for `open_interest`. See QuantityUnit.","allOf":[{"type":"string","description":"Wire unit for a market quantity field. Backend-owned from platform reporting conventions so clients never map platform→unit themselves. `contracts` = Kalshi contract count; `shares` = Polymarket share count (lifetime volume); `usd` = Polymarket USD notional (volume_24h / OI); `mixed` = event-level aggregate over children that disagree.","enum":["contracts","shares","usd","mixed"]}],"nullable":true},"yes_bid":{"type":["number","null"],"description":"Latest top-of-book YES bid (0-100 cents, ~1-min fresh)."},"yes_ask":{"type":["number","null"],"description":"Latest top-of-book YES ask (0-100 cents, ~1-min fresh)."},"no_bid":{"type":["number","null"],"description":"Derived NO bid (100 - yes_ask)."},"no_ask":{"type":["number","null"],"description":"Derived NO ask (100 - yes_bid)."},"event_ticker":{"type":["string","null"],"description":"Raw venue event ticker (unprefixed)."},"status":{"type":["string","null"],"description":"Lifecycle state of the market: `active` (trading), `closed` (trading has ended, outcome not yet published), `resolved` (settled with a known outcome), `expired` (ended long ago and never settled by the venue), or `unknown` (the venue reported no status we recognize)."},"open_time":{"type":["string","null"],"format":"date-time","description":"When the market opened for trading on the venue. Static once set, and absent for venues that do not report an open time."},"end_date":{"type":["string","null"],"format":"date-time","description":"When trading closes on the venue. This is not the settlement time; a market can sit in `closed` for a while before it resolves, so see `expiration_date` for the expected settlement."},"expiration_date":{"type":["string","null"],"format":"date-time","description":"Expected settlement time as published by the venue. Distinct from `end_date`, which is when trading closes; a market sits between the two while awaiting its outcome."},"link":{"type":["string","null"],"description":"URL of the venue's public page for this contract, which on both venues is the parent event page rather than a single strike. Null when no working URL can be built, which happens for Kalshi markets whose series is unknown."},"category":{"type":["string","null"],"description":"Topic category of this market's parent event, normalized across venues (for example `Politics`, `Sports`, `Crypto`). Every market under the same event shares it."},"state_code":{"type":["string","null"],"description":"Two-letter US state code parsed from the ticker when the contract is tied to a state (Senate, Governor, House). Absent for contracts with no state, including Mayoral markets, which carry `city_code` instead."},"city_code":{"type":["string","null"],"description":"Mayoral city code parsed at ingest; present for Mayoral markets, absent otherwise."},"market_type":{"type":["string","null"],"description":"The venue's own contract-type label (for example a binary or scalar market). Static contract metadata, absent when the venue reports none."},"rules_primary":{"type":["string","null"],"description":"The venue's primary settlement rules text, describing what resolves the contract YES."},"rules_secondary":{"type":["string","null"],"description":"Additional settlement rules text from the venue, covering edge cases and sourcing. Frequently absent."},"yes_sub_title":{"type":["string","null"],"description":"Short label for the YES leg as the venue words it, suitable for a button or leg header."},"no_sub_title":{"type":["string","null"],"description":"Short label for the NO leg as the venue words it, suitable for a button or leg header."},"settlement":{"type":["object","null"],"description":"Resolution provenance, platform-agnostic (Kalshi series object / Polymarket resolution_source).","properties":{"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":["string","null"]},"url":{"type":["string","null"]}}}},"terms_url":{"type":["string","null"]}}},"result":{"type":["string","null"],"description":"Resolution outcome reported by the venue: `yes` or `no`. Absent while the market is open, and for markets that settle to a scalar value or without a per-market yes/no outcome. When set, `probability` is the settlement value (100 or 0)."},"stats":{"description":"Trailing returns and risk statistics computed from the market's daily trade-price series over roughly the trailing 400 days. The values are null individually when the series is too short for that window.","allOf":[{"type":"object","properties":{"trailing_returns":{"type":"array","description":"Percent price change over each of six fixed trailing windows: 1D, 1W, 1M, 3M, YTD, and 1Y.","items":{"type":"object","required":["label"],"properties":{"label":{"type":"string","description":"The trailing window this return covers: `1D`, `1W`, `1M`, `3M`, `YTD`, or `1Y`."},"value":{"type":["number","null"],"description":"Percent change from the value at the start of the window to the latest value in the series. Null when the series has no data point close enough to the start of that window."},"point_change":{"type":["number","null"],"description":"Absolute change in the level's own units over the same window. Point-quoted indices (quote_convention `points`) express trailing performance with this figure; omitted when no comparable historical point exists."}}}},"risk":{"type":"object","description":"Volatility, range, and period return computed over the most recent 31 points of the daily series. The window counts data points, so a series with gaps spans more than 31 calendar days.","properties":{"volatility":{"type":["number","null"],"description":"Annualized volatility in percent, from the daily returns across the most recent 31 daily data points, annualized over 365 days because these markets trade every calendar day. Null when the daily series has fewer than 3 points."},"daily_vol":{"type":["number","null"],"description":"Standard deviation of the daily returns across the most recent 31 daily data points, in percent and not annualized. Null when the daily series has fewer than 3 points."},"range_high":{"type":["number","null"],"description":"Highest value reached within the most recent 31 daily data points, in the series' own units (index points for an index, 0-100 for a rate). Null when the daily series has fewer than 3 points."},"range_low":{"type":["number","null"],"description":"Lowest value reached within the most recent 31 daily data points, in the series' own units (index points for an index, 0-100 for a rate). Null when the daily series has fewer than 3 points."},"return_pct":{"type":["number","null"],"description":"Percent change from the first to the last of the most recent 31 daily data points. Null when the daily series has fewer than 3 points."}}}}}],"nullable":true}}},"example":{"market_id":"kalshi:KXPRESPARTY-2028-D","ticker":"KXPRESPARTY-2028-D","display_ticker":"KXPRESPARTY-2028-D","platform":"kalshi","question":"Will Democratic win the Presidency in 2028?","probability":58,"volume":233444.98,"volume_unit":"contracts","volume_24h":14.2,"volume_24h_unit":"contracts","open_interest":116538.21,"open_interest_unit":"contracts","yes_bid":57,"yes_ask":58,"no_bid":42,"no_ask":43,"event_ticker":"KXPRESPARTY-2028","status":"active","open_time":"2024-11-06T15:00:00Z","end_date":"2029-11-07T15:00:00Z","expiration_date":"2029-01-21T15:00:00Z","link":"https://kalshi.com/markets/kxpresparty/kxpresparty-2028","category":"Elections","market_type":"binary"},"examples":[{"name":"default","value":{"market_id":"kalshi:KXPRESPARTY-2028-D","ticker":"KXPRESPARTY-2028-D","display_ticker":"KXPRESPARTY-2028-D","platform":"kalshi","question":"Will Democratic win the Presidency in 2028?","probability":58,"volume":233444.98,"volume_unit":"contracts","volume_24h":14.2,"volume_24h_unit":"contracts","open_interest":116538.21,"open_interest_unit":"contracts","yes_bid":57,"yes_ask":58,"no_bid":42,"no_ask":43,"event_ticker":"KXPRESPARTY-2028","status":"active","open_time":"2024-11-06T15:00:00Z","end_date":"2029-11-07T15:00:00Z","expiration_date":"2029-01-21T15:00:00Z","link":"https://kalshi.com/markets/kxpresparty/kxpresparty-2028","category":"Elections","market_type":"binary"}}]},{"status":"404","description":"Market not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Stable, machine-readable code identifying the failure; branch on this rather than on `message`. One of `bad_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`, `service_unavailable`, `upstream_error`, `service_error`, or `internal_error`."},"message":{"type":"string","description":"Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld."}}},"examples":[]}],"security":[],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} /> --- title: Get public market price history url: "https://docs.adjacent.markets/api/get-api-v1-public-markets-id-prices.md" description: Delayed market price series in cents (0-100). --- --- title: Get snapshot metadata url: "https://docs.adjacent.markets/api/get-api-v1-public-meta.md" description: "Returns the pinned snapshot timestamp, last refresh time, and the daily-bucket timezone for the public snapshot tier." ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/public/meta" ``` ```json title="default" lines=false { "snapshot_at": "2026-07-29T14:02:34.885595Z", "refreshed_at": "2026-07-29T14:17:34.885595Z", "day_boundary_timezone": "America/New_York", "market_statuses": [ "unknown", "active", "closed", "resolved", "expired" ], "market_platforms": [ "kalshi", "polymarket" ], "market_categories": [ "Politics", "Elections", "World", "Economics", "Crypto" ], "freshness": [ { "tier": "markets", "mode": "delayed", "delay_seconds": 900 }, { "tier": "indices", "mode": "delayed", "delay_seconds": 900 } ] } ```

--- title: List purchasable API plans url: "https://docs.adjacent.markets/api/get-api-v1-public-plans.md" description: "The purchasable plans, Pro and Premium, with their monthly price, seat count, and per-minute and per-day request ceilings." --- --- title: List public reference rates url: "https://docs.adjacent.markets/api/get-api-v1-public-rates.md" description: "Returns the {data, meta} envelope." ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/public/rates" ``` ```json title="default" lines=false { "data": [ { "rate_id": "adj_bluh", "name": "Democratic House", "methodology": "simple_average", "sources_count": 1, "latest_price": 83.5, "previous_close_1d": 83.5, "price_change_1d": 0, "spread": 0, "sources": [ { "market_id": "kalshi:CONTROLH-2026-D", "display_ticker": "CONTROLH-2026-D", "platform": "kalshi", "weight": 1, "question": "Will Democrats win the House in 2026?", "latest_price": 83.5, "end_date": "2027-02-01T15:00:00Z", "is_active": true } ] } ], "meta": { "total": 8, "page": 1, "per_page": 1, "total_pages": 8, "has_next": true, "has_prev": false } } ```

--- title: Get public reference rate detail url: "https://docs.adjacent.markets/api/get-api-v1-public-rates-id.md" description: Get public reference rate detail ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/public/rates/" ``` ```json title="default" lines=false { "rate_id": "adj_bluh", "name": "Democratic House", "description": "Rolling rate from contract chain 'bluh_chain'", "methodology": "simple_average", "sources": [ { "market_id": "kalshi:CONTROLH-2026-D", "display_ticker": "CONTROLH-2026-D", "platform": "kalshi", "weight": 1, "question": "Will Democrats win the House in 2026?", "latest_price": 83.5, "end_date": "2027-02-01T15:00:00Z", "is_active": true } ], "latest_price": 83.5, "price_change_1d": 0, "price_change_7d": 1, "previous_close_1d": 83.5, "previous_close_7d": 82.5, "spread": 0, "stats": { "trailing_returns": [ { "label": "1D", "value": 0 }, { "label": "1W", "value": 1.2121212121212122 } ] } } ```

--- title: Get public reference rate price history url: "https://docs.adjacent.markets/api/get-api-v1-public-rates-id-prices.md" description: Delayed rate price series. --- --- title: Related news for a market url: "https://docs.adjacent.markets/api/get-api-v1-public-markets-id-news.md" description: "Up to 3 related articles, each published at least 24 hours ago, ordered by relevance blended with recency." --- --- title: Related news for an index url: "https://docs.adjacent.markets/api/get-api-v1-public-indices-id-news.md" description: "Related news drawn from the index's constituent markets, ranked by closest market match (viamarketid, viamarketquestion) and relevance blended with recency." --- --- title: Related news for a reference rate url: "https://docs.adjacent.markets/api/get-api-v1-public-rates-id-news.md" description: "Up to 3 related articles, each published at least 24 hours ago, ordered by relevance blended with recency." --- --- title: Get official daily values url: "https://docs.adjacent.markets/api/get-api-v1-public-indices-id-daily-values.md" description: "Official daily values for an index whose family publishes one, newest first. The NFL team indices stamp one official value per US-Eastern calendar day, taken from a fixed morning window; days without " --- --- title: Get membership events url: "https://docs.adjacent.markets/api/get-api-v1-public-indices-id-membership-events.md" description: "Recent membership events for an NFL team index, newest first: admissions (a market became its sleeve's active member) and settlements (a member's market resolved and its final value was booked). Indic" --- --- title: List reference rates url: "https://docs.adjacent.markets/api/get-api-v1-rates.md" description: Get all reference rates with current prices ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/rates" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "rate_id": "adj_bluh", "name": "Democratic House", "methodology": "simple_average", "sources_count": 1, "latest_price": 77.5, "spread": 0 }, { "rate_id": "adj_blup", "name": "Adjacent Democratic President", "methodology": "simple_average", "sources_count": 2, "latest_price": 58.5, "spread": 0 } ], "meta": { "total": 6, "page": 1, "per_page": 20, "total_pages": 1, "has_next": false, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ```

--- title: Get reference rate details url: "https://docs.adjacent.markets/api/get-api-v1-rates-id.md" description: Get rate with contributing sources ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/rates/" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "rate_id": "adj_bluh", "name": "Democratic House", "description": "Rolling rate from contract chain 'bluh_chain'", "methodology": "simple_average", "sources": [ { "market_id": "kalshi:CONTROLH-2026-D", "display_ticker": "CONTROLH-2026-D", "platform": "kalshi", "weight": 1, "question": "Will Democrats win the House in 2026?", "latest_price": 77.5, "end_date": "2027-02-01T15:00:00Z", "is_active": true } ], "latest_price": 77.5, "spread": 0 } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ``` ```json title="404 — default" lines=false { "error": "not_found", "message": "Rate not found" } ```

--- title: Find related news url: "https://docs.adjacent.markets/api/get-api-v1-rates-id-news.md" description: "Related news for a reference rate: articles matching the rate itself or any of its source markets, ranked by closest match. viamarketid names the source market when that match wins; it is omitted when" ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/rates//news" \ -H "Authorization: Bearer " ``` ```json title="default" lines=false { "data": [ { "article_id": "a1b2c3d4", "similarity": 0.82, "title": "Senate race tightens in Pennsylvania", "url": "https://example.com/news/senate-pa", "published_date": "2026-06-01T08:00:00Z", "source": "Reuters" }, { "article_id": "e5f6g7h8", "similarity": 0.77, "title": "New polling shifts House outlook", "url": "https://example.com/news/house-outlook", "published_date": "2026-06-01T07:30:00Z", "source": "AP" } ], "meta": { "total": 2, "page": 1, "per_page": 20, "total_pages": 1, "has_next": false, "has_prev": false } } ```

--- title: Get rate price history url: "https://docs.adjacent.markets/api/get-api-v1-rates-id-prices.md" description: Get historical rate values with OHLC ---

```bash title="cURL" lines=false curl -X GET "https://api.adjacent.markets/api/v1/rates//prices" \ -H "Authorization: Bearer " ``` ```json title="200 — default" lines=false { "data": [ { "timestamp": "2026-06-20T19:00:00Z", "price": 77.5 }, { "timestamp": "2026-06-20T18:00:00Z", "price": 77.2 } ], "meta": { "total": 420, "page": 1, "per_page": 100, "total_pages": 5, "has_next": true, "has_prev": false } } ``` ```json title="403 — default" lines=false { "error": "Insufficient scope: a Pro or Premium API plan is required", "status": 403, "upgrade_url": "https://adjacent.markets/subscribe" } ```

--- title: List recent industry filings url: "https://docs.adjacent.markets/api/get-api-v1-public-filings.md" description: "CFTC industry filings whose status date is in the last 90 days, newest first." --- --- title: Recent filing filter values url: "https://docs.adjacent.markets/api/get-api-v1-public-filings-filters.md" description: "Feeds, organizations, and statuses present among filings from the last 90 days." --- --- title: Get a recent filing url: "https://docs.adjacent.markets/api/get-api-v1-public-filings-id.md" description: One CFTC filing whose status date is in the last 90 days. --- --- title: Recent filing attachment text url: "https://docs.adjacent.markets/api/get-api-v1-public-filings-id-markdown.md" description: The filing plus extracted markdown from each stored attachment. --- --- title: List industry filings url: "https://docs.adjacent.markets/api/get-api-v1-filings.md" description: "Full CFTC industry-filings catalog, newest status date first, or by sort/sortdir." --- --- title: List filing events url: "https://docs.adjacent.markets/api/get-api-v1-filings-events.md" description: "Every observed change across the filings tape, oldest first: first sightings, status flips, and later attachments." --- --- title: Filing filter values url: "https://docs.adjacent.markets/api/get-api-v1-filings-filters.md" description: "Distinct feeds, organizations, and statuses present in the catalog." --- --- title: Get a filing url: "https://docs.adjacent.markets/api/get-api-v1-filings-id.md" description: One stored CFTC filing by id. --- --- title: Filing actions url: "https://docs.adjacent.markets/api/get-api-v1-filings-id-actions.md" description: "Receipt, status changes, and later attachments for one filing, oldest first." --- --- title: Filing attachment text url: "https://docs.adjacent.markets/api/get-api-v1-filings-id-markdown.md" description: The filing plus extracted markdown from each stored attachment. --- --- title: Similar filings url: "https://docs.adjacent.markets/api/get-api-v1-filings-id-similar.md" description: The named filing plus other filings whose titles are close to it. --- --- title: Markets related to a filing url: "https://docs.adjacent.markets/api/get-api-v1-filings-id-markets.md" description: The named filing plus markets whose questions sit near its title. --- --- title: News related to a filing url: "https://docs.adjacent.markets/api/get-api-v1-filings-id-news.md" description: The named filing plus articles whose text sits near its title. --- --- title: Filings related to a market url: "https://docs.adjacent.markets/api/get-api-v1-markets-id-filings.md" description: The named market plus CFTC filings whose titles sit near its question. --- --- title: Filings related to an article url: "https://docs.adjacent.markets/api/get-api-v1-news-id-filings.md" description: The named article plus CFTC filings whose titles sit near it. --- --- title: Filings related to an index url: "https://docs.adjacent.markets/api/get-api-v1-indices-id-filings.md" description: The named index plus CFTC filings related through its constituent markets. --- --- title: Changelog url: "https://docs.adjacent.markets/changelog.md" description: Updates to the Adjacent API. --- {/* Add customer-facing entries under the Unreleased block below. At release, `just changelog-release` stamps it with the date (docs-deploy-prod fires on the release tag). */} **NFL Team Index reads.** Index detail for an NFL team index (`methodology` `nti`) includes `sleeves` (four seats: Super Bowl, conference, division, next game) and `official_daily_value`. `quote_convention` is `points` and the level starts at 1000. `GET /api/v1/indices/{id}/daily-values` and `GET /api/v1/indices/{id}/membership-events` (and the `/api/v1/public/indices/...` twins) return the official daily series and recent sleeve admissions or settlements. Other families return empty lists. **Filings list by last listing observation.** `GET /api/v1/filings` and `GET /api/v1/public/filings` accept `last_seen_days` (integer, at least 1) to return only filings not observed on a CFTC listing in that many days. Pass `sort=last_seen` with `sort_dir` to order by when a filing last appeared on a listing. **Public indices list stays complete when the catalog is large.** `GET /api/v1/public/indices` returns every public index when the catalog includes dozens of NFL team series. `GET /api/v1/public/indices/{id}` quotes the same stamped `latest_price`. A quiet index still omits `latest_price` when its last print is older than seven days. **Public rates list stays complete when the catalog is large.** `GET /api/v1/public/rates` returns every public rate when the catalog has hundreds of rows (NFL team sleeve rates). A quiet rate still omits `latest_price` when its last print is older than seven days. **NTI sleeve members include each contract's mark.** On `GET /api/v1/indices/{id}` and `GET /api/v1/public/indices/{id}`, each `sleeves.members[]` entry has `mark_price` (0-1) for that contract. A win-total pair therefore carries both marks. **Event-contract rates treat a 0¢ bid or ask as missing.** When only one side of the book is present, `GET /api/v1/rates/{id}` (and the public twin) uses last trade, then the remaining quote, then the half-cent floor. A prior half-cent print does not stick once last trade or a one-sided quote is available. **Rate constituents in component returns.** Index detail (`GET /api/v1/indices/{id}` and the public tier) labels a rate-backed constituent in `constituent_returns` with `kind` `rate`. Link those rows to the rate page. **Rate news includes source-market matches.** `GET /api/v1/rates/{id}/news` and `GET /api/v1/public/rates/{id}/news` return articles that match the rate itself or any of its source markets. `via_market_id` names the source market when that match wins; it is omitted when the rate itself matched more closely. **Index news includes constituent rate sources.** `GET /api/v1/indices/{id}/news` and `GET /api/v1/public/indices/{id}/news` draw related articles from the index's constituent markets, including the source markets of any constituent rates. `via_market_id` names the closest market. `GET /api/v1/indices/{id}/filings` uses the same market set. **Wins-sleeve members follow the wrapping pair before the first print.** On `GET /api/v1/indices/{id}` and `GET /api/v1/public/indices/{id}`, an NTI index's wins `sleeves.members` lists the wrapping win-total rates from the latest prints. After the first mark, members continue to follow the printed pair. **Quiet rates omit the latest price.** `GET /api/v1/rates` and the rates CSV export look back seven days when you omit `start`: a rate whose last print is older than that window returns `latest_price` and `spread` as null. Pass an earlier `start` to include older prints. `GET /api/v1/public/rates`, `GET /api/v1/rates/{id}`, and `GET /api/v1/public/rates/{id}` use the same seven-day window. **Rate sources stay on the detail page when the print did not use a two-sided book.** `GET /api/v1/public/rates/{id}` (and the list's inlined `sources`) includes every configured source market. A source that did not enter the latest print omits `latest_price`. **Inactive rates drop off the public list.** `GET /api/v1/public/rates` omits a rate when every source is inactive (`is_active` is false). The rate detail URL still returns the rate. The authenticated catalog is unchanged. **Searched event lists stay uncounted with sort.** `GET /api/v1/events` and `GET /api/v1/public/events` return `total` and `total_pages` as `null` when `search` is set, including when you also pass `sort`; page with `has_next`. A searched markets list is uncounted on relevance ranking, but passing `sort` on `GET /api/v1/markets` or `GET /api/v1/public/markets` returns a total over the ranked matches (at most 10,000). Events have no stable number for that request shape. **Sorted market-search totals at the ceiling are a floor.** When `search` and `sort` are both set on a markets list and `meta.total` is 10,000, `meta.total_capped` is `true`. Render that as "10,000+", not as an exact count. Below the ceiling the total is exact. **Searched event lists are uncounted.** `GET /api/v1/events` and `GET /api/v1/public/events` return `total` and `total_pages` as `null` when `search` is set; page with `has_next` instead. Unsearched lists are unchanged and still carry an exact total. This matches `GET /api/v1/markets`, which has always been uncounted on a searched page. The previous total was bounded by the search's internal candidate window rather than the matched set, so it under-reported broad queries and changed as you paged through the same result set. **CFTC industry filings.** A new catalog of product certifications and rule submissions from the four CFTC industry-filing registries (PTC/DCM rules, DCM products, DCO, DCO rules). `GET /api/v1/public/filings` returns filings whose CFTC status date falls in the last 90 days, with `GET /api/v1/public/filings/filters` for the feed, organization, and status values present, `GET /api/v1/public/filings/{id}` for one filing, and `GET /api/v1/public/filings/{id}/markdown` for the extracted text of its attachments. Filtering, relevance-ranked search, and sorting work on this tier too, within that window. Filings older than it, the change feed, and related records require the `org:filings:read` scope. **Full filings history.** `GET /api/v1/filings` returns the whole catalog, filtered by `feed`, `org`, `status`, and a relevance-ranked `search` across the organization, description, product name and type, affected products, and filing id. A searched page is uncounted, so page with `has_next` rather than a total, the same as the markets list. Pass `sort` (`status_date`, `received`, `first_seen`, `org`) with `sort_dir` to order by a field instead. `GET /api/v1/filings/{id}/actions` returns one filing's dated history: its receipt, each status change, and each later attachment. **Filing change feed.** `GET /api/v1/filings/events` returns every observed change across the catalog, oldest first, each row carrying the filing it happened to. Poll it with `since_seq` set to the highest `seq` of the previous page to receive only what has changed since. Filter by `kind` (`received`, `status_changed`, `documents_added`), by `feed`, or by a `since` timestamp for a first poll that has no cursor yet. **Filings alongside markets, news, and indices.** `GET /api/v1/filings/{id}/markets`, `/news`, and `/similar` return records related to a filing. `GET /api/v1/markets/{id}/filings`, `GET /api/v1/news/{id}/filings`, and `GET /api/v1/indices/{id}/filings` return the same relationships from the other side. **Filter events by venue and market close window.** `GET /api/v1/events` and `GET /api/v1/export/events/{ext}` accept `venue` (for example `kalshi` or `polymarket`), `expires_after`, and `expires_before`. `start` and `end` are deprecated; use `expires_after` and `expires_before` instead. Events are returned newest-added first, or by relevance when `search` is set. **Filter events by listing time.** `GET /api/v1/events` (and `GET /api/v1/export/events/{ext}`) accept `created_since` and `created_until` (ISO date or datetime), which filter events by when they were first listed on the platform. The anonymous public events list does not implement those parameters; use an API key. `expires_after` / `expires_before` bound the resolution window instead. **Grouped constituent returns with percent change.** Index detail (`GET /api/v1/indices/{id}` and the public tier) returns `constituent_returns` grouped by a dimension (`group_by`, for example `state`); each group carries its weight and both its point change and `percent_change`. **Index visibility.** Indices carry a `visibility` field on authenticated responses (`public` or `organization`; other values are reserved). The anonymous public tier returns only public indices and omits the field. **Relevance-ranked market search.** `search` on `GET /api/v1/markets` and `GET /api/v1/public/markets` ranks results by relevance and matches a market's slug. A relevance-ranked search is uncounted: `meta.total` is `null`, so page with `meta.has_next` rather than a total count. **Explicit sort on searched lists.** `GET /api/v1/public/events` and `GET /api/v1/public/markets` honor an explicit `sort` and `sort_dir` when a `search` query is present. **Capped list totals.** List responses carry `meta.total_capped`. When `true`, `meta.total` and `meta.total_pages` are a lower bound rather than an exact count, so render them as, for example, "10,000+". The field is omitted when the count is exact.