Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

News

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.

Get the latest articles

Poll the latest endpoint for the live feed. There is no article WebSocket. The response is page-based and omits the stored body; use the article id to fetch detail when you need description and truncated content.
Optional topic restricts the page to politics, sports, crypto, or other.
curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/news/latest?per_page=20&topic=politics"

Filter the catalog

Use the catalog endpoint when you want to page through stored articles or filter by a known source or language.
curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/news?source=SOURCE_ID&language=en&topic=politics"
Use the filters endpoint to discover source ids and language codes before building filter controls.
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, language, and topic (politics, sports, crypto, or other).

Read an article

Pass an article id from a list response to get its full stored record, including the description and truncated body.
curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/news/ARTICLE_ID"
The detail response adds the article author, description, truncated content, and topic. Keep the article url when you show a link back to the publisher.
Use the related-markets endpoint to find markets connected to an article.
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 for full schemas.