Skip to content

Feeds & Markets

RSS and Atom renderings of any story query, plus the market ticker values shown on the site.

Generated page

This page is generated from the published OpenAPI schema. Do not edit it by hand — run npm run generate:api.

GET /v1/rss

RSS feed

Authenticated RSS 2.0 feed. Supports the same filters as /v1/news.

API key required

Query parameters

NameRequiredDescriptionExample
pagenoPage number, starting at 1.1
page_sizenoStories per page. Alias: limit. Maximum 100.50
cursornoOpaque cursor returned as page.next_cursor for the next page.eyJvZmZzZXQiOjUwfQ
offsetnoZero-based offset. Ignored when cursor is supplied.100
fieldsnoComma-separated response fields to return. The id field is always included when present.id,title,publishedAt,impactPaths
includenoComma-separated detail groups. Use full for all fields, or sources,claims,impactDetails,body for selected heavy fields.sources,claims
sortnoFeed order: pipeline for newest stories or popular for 12-hour freshness-bucketed popularity.popular
countrynoG20 country filter from the story passive entities.Japan
categorynoNormalized Neural Ledger story category.Trading & Markets
entitynoPassive entity text or id filter.Federal Reserve
impact_pathnoImpact path text, id, or lookup token filter.oil
tagnoNormalized story tag filter.tariff
qnoFull-text query across titles, summaries, entities, tags, and impact paths.tariff
published_sincenoReturn stories published at or after this ISO date/time.2026-05-01T00:00:00Z
published_untilnoReturn stories published at or before this ISO date/time.2026-05-31T23:59:59Z
updated_sincenoReturn stories updated at or after this ISO date/time.2026-05-01T00:00:00Z
updated_untilnoReturn stories updated at or before this ISO date/time.2026-05-31T23:59:59Z

Example

bash
curl -sS "https://theneuralledger.com/v1/rss?page=1&page_size=50&cursor=eyJvZmZzZXQiOjUwfQ" \
  -H "Authorization: Bearer $TNL_API_KEY"

Responses

StatusMeaning
200Successful response.
401Missing or invalid API key.
429Monthly API call limit exceeded.

GET /v1/atom

Atom feed

Authenticated Atom feed. Supports the same filters as /v1/news.

API key required

Query parameters

NameRequiredDescriptionExample
pagenoPage number, starting at 1.1
page_sizenoStories per page. Alias: limit. Maximum 100.50
cursornoOpaque cursor returned as page.next_cursor for the next page.eyJvZmZzZXQiOjUwfQ
offsetnoZero-based offset. Ignored when cursor is supplied.100
fieldsnoComma-separated response fields to return. The id field is always included when present.id,title,publishedAt,impactPaths
includenoComma-separated detail groups. Use full for all fields, or sources,claims,impactDetails,body for selected heavy fields.sources,claims
sortnoFeed order: pipeline for newest stories or popular for 12-hour freshness-bucketed popularity.popular
countrynoG20 country filter from the story passive entities.Japan
categorynoNormalized Neural Ledger story category.Trading & Markets
entitynoPassive entity text or id filter.Federal Reserve
impact_pathnoImpact path text, id, or lookup token filter.oil
tagnoNormalized story tag filter.tariff
qnoFull-text query across titles, summaries, entities, tags, and impact paths.tariff
published_sincenoReturn stories published at or after this ISO date/time.2026-05-01T00:00:00Z
published_untilnoReturn stories published at or before this ISO date/time.2026-05-31T23:59:59Z
updated_sincenoReturn stories updated at or after this ISO date/time.2026-05-01T00:00:00Z
updated_untilnoReturn stories updated at or before this ISO date/time.2026-05-31T23:59:59Z

Example

bash
curl -sS "https://theneuralledger.com/v1/atom?page=1&page_size=50&cursor=eyJvZmZzZXQiOjUwfQ" \
  -H "Authorization: Bearer $TNL_API_KEY"

Responses

StatusMeaning
200Successful response.
401Missing or invalid API key.
429Monthly API call limit exceeded.

GET /v1/markets

Market ticker values

Returns the latest collected market ticker values shown in the site header.

API key required

Example

bash
curl -sS "https://theneuralledger.com/v1/markets" \
  -H "Authorization: Bearer $TNL_API_KEY"

Responses

StatusMeaning
200Successful response.
401Missing or invalid API key.
429Monthly API call limit exceeded.

The Neural Ledger API