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

Use the latest endpoint when you are building a feed or want the newest available articles. It uses page-based pagination.
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.
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.
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.
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.
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.
Adjacent API
Powered byHolocron