API
Versioned JSON under /api/v1. Read-only. News and Company, index and show.
Create a key on your account after you sign in. Session cookies do not authenticate the API. Request and object counts for the last 30 days are on usage.
Authentication
Send the key on every request. Prefer the Authorization header.
Authorization: Bearer tf_…
X-Api-Key is also accepted. Do not put the key in the query string.
curl -sS -H "Authorization: Bearer $TICKRFEED_API_KEY" \ https://tickrfeed.com/api/v1/news
Pagination and filters
Index responses include a pagination object: page, limit, count, pages. Pass page to move through results.
- q — search
- symbol — ticker / issuer symbol
News
Published stories only. Newest first.
GET /api/v1/news GET /api/v1/news/:id
Index item: id, title, summary, url, external_id, source_name, source_url, company_id, company_name, ticker, author, published_at, fetched_at, language, created_at, updated_at. Show adds body. Dates are ISO-8601.
curl -sS -H "Authorization: Bearer $TICKRFEED_API_KEY" \ "https://tickrfeed.com/api/v1/news?symbol=ACME"
Companies
Issuer catalog. Show accepts a UUID or a symbol.
GET /api/v1/companies GET /api/v1/companies/:id
Fields: id, name, symbol, website_url, cik, status, created_at, updated_at.
curl -sS -H "Authorization: Bearer $TICKRFEED_API_KEY" \ https://tickrfeed.com/api/v1/companies/ACME
Errors
- 401 — missing or invalid key. {"error":"Unauthorized"}
- 404 — unknown news or company. {"error":"Not found"}