> ## Documentation Index > Fetch the complete documentation index at: https://docs.trdrs.co/llms.txt > Use this file to discover all available pages before exploring further. # List news headlines > Returns aggregated market-news headlines, newest first. `limit` is clamped to 100. Page by passing the oldest item's `publishedAt` as `before`. `instrument` scopes to one futures root (items are tagged with roots at ingest): pass `ES`, never a full catalog symbol. `source` filters to one publisher. `summary` may be a one-line teaser or a full plain-text body in the lightweight format — render it as text; publisher HTML never appears. ## OpenAPI ````yaml /partner-platform/openapi.json get /api/news openapi: 3.1.0 info: title: trdrs Engine API version: 1.1.0 description: >- ## API Reference This is the served OpenAPI contract for the trdrs engine: market data, trading and account routes for your firm's traders, trdrs Connect account-registration handoff, and preview challenge routes. See Quick Start for the first integration path: key setup, market config, chart data, Connect account registrations, idempotency, stream reconnects, and conformance. See Overview and API Standards for the cross-cutting contract rules. servers: - url: https://app.trdrs.co description: Production - url: / description: This engine security: [] tags: - name: Market data description: >- Symbol search and resolution, OHLCV history, quote snapshots, the server clock, and the live bar stream. Crypto rides each venue’s public feed; futures stream from the caller’s own connected Rithmic account. With none connected, futures requests answer 503 `feed_requires_connection`. - name: News description: >- Aggregated market news and the economic calendar, from licensed/open sources, keyword-tagged with futures roots at ingest. Platform-wide content (nothing per-user), admitted exactly like Market data: a licensed origin, a session, or a firm API key. Headlines page by published time, scope by instrument root, and stream live over SSE; thumbnails serve through the image proxy. - name: Trading description: >- The money surface: entries, exits, replaces, cancels, and position/account flattening. Every order-placing call uses `clientOrderId` as its idempotency key. - name: Account description: >- Reading a connected account. You do not create trading accounts here: a trader connects their own broker account (or creates a free demo account) in the app, and firms create evaluation accounts through the Partner API (Firm accounts → Create evaluation accounts) or register venue accounts through Connect (Create an account registration). Account state and the durable ledgers: balances, positions, working orders, fills, P&L history, and the live account stream. - name: Connect description: >- trdrs Connect account registration, for partner firms. Register an account you issued on your own venue — a pending account registration — with the trader’s sign-in email, optionally the venue account id and the login name your venue issued. The trader finds it waiting in the connect flow the moment they sign in with that email: the connect step is pre-filled with everything except the credential, which the trader always enters themselves. A registration never transmits a password and never grants access to anything before the trader’s own login succeeds. These routes answer a partner-scoped key only; a firm API key or a user session gets 401. Registrations expire after 30 days; re-registering the same email + account refreshes the expiry instead of duplicating. The end-to-end flow guide is **[Quick Start](/docs/guides/quick-start)**. - name: Firm accounts description: >- Evaluation accounts your firm issues on the trdrs venue, through your partner key — the other half of account setup. Connect registrations hand off accounts that exist on your venue; these routes create and manage accounts on ours: the trader trades them on trdrs, and your firm owns the lifecycle. Every route is scoped to accounts your firm created through this API — an account the same trader opened themselves is invisible and untouchable here, by construction. Creation is batched with per-item results, and every write carries your own `referenceId`, so a crashed pipeline retries safely. Served when the deployment runs the prop engine; without it, every route in this group answers `404`. - name: Webhooks description: >- The outbound event bus: register an https endpoint and the platform pushes events to it instead of your back office polling us. Every delivery is signed (`trdrs-signature: t=,v1=` over `${t}.${rawBody}`) so you can prove it came from us and is fresh, and every delivery is durable — a failed attempt is retried with backoff for about nine hours and the whole log is readable, so an endpoint that was down is a delay rather than a lost event. Serves brokers and prop firms alike: the account-registration (`registration.*`) events fire wherever Connect does, and the account events fire where the prop engine runs. - name: Challenges description: >- The prop evaluation surface: challenge programs and a trader’s own enrollments. **Preview: the one group on this page outside the additive-only guarantee** (the pre-contract v1 scaffold; the Phase-1 rebuild will change these shapes; see Stability). **Cookie-authenticated, not key-authenticated**, and served only when the engine runs with `CHALLENGES_ENABLED`; without that flag the bundle is absent and every route below returns `404`. The firm-console/admin half of this surface is deliberately not documented here. It is back office, not licensed surface. paths: /api/news: get: tags: - News summary: List news headlines description: >- Returns aggregated market-news headlines, newest first. `limit` is clamped to 100. Page by passing the oldest item's `publishedAt` as `before`. `instrument` scopes to one futures root (items are tagged with roots at ingest): pass `ES`, never a full catalog symbol. `source` filters to one publisher. `summary` may be a one-line teaser or a full plain-text body in the lightweight format — render it as text; publisher HTML never appears. parameters: - name: limit in: query schema: type: integer default: 50 description: Clamped to 1..100 - name: before in: query schema: type: string description: ISO timestamp; items strictly older (the paging cursor) - name: instrument in: query schema: type: string description: One futures root, e.g. ES - name: source in: query schema: type: string description: One publisher name responses: '200': description: NewsResponse content: application/json: schema: $ref: '#/components/schemas/NewsResponse' '400': description: Malformed before timestamp content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limited (Retry-After header set) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - tenantKey: [] x-codeSamples: - lang: javascript label: TypeScript source: |- const res = await fetch('https://app.trdrs.co/api/news', { headers: { Authorization: `Bearer ${process.env.TRDRS_API_KEY}` }, }) const data = await res.json() - lang: shell label: cURL source: |- curl 'https://app.trdrs.co/api/news' \ -H "Authorization: Bearer $TRDRS_API_KEY" components: schemas: NewsResponse: type: object properties: items: type: array items: $ref: '#/components/schemas/WireNewsItem' description: Newest first required: - items example: items: - id: a3f8c2d94b1e6a07c5d2f8b3e9a1c4d7f0b6e2a8c1d5f9b4e7a0c3d6f2b8e5a1 source: fxstreet headline: S&P 500 futures hold near highs as rate-cut bets firm summary: |- Equity index futures held near session highs on Monday. ## The rates picture Markets now price a September cut as the base case. • ES up 0.4% at 6,481 • 10-year yield down 4bp url: https://www.fxstreet.com/news/example-article imageUrl: https://cdn.example.com/thumb.jpg publishedAt: '2026-08-24T13:42:00.000Z' tags: - macro - stocks instruments: - ES - NQ - id: b7e1d4a92c8f5b3e6a0d7c2f9b4e1a8d5c0f3b6e9a2d7c4f1b8e5a0d3c6f9b2 source: brownfield headline: Corn, soybeans firm ahead of USDA export sales summary: Grain futures traded higher in quiet overnight dealing. url: https://www.brownfieldagnews.com/news/example imageUrl: null publishedAt: '2026-08-24T11:05:00.000Z' tags: - ag instruments: - ZC - ZS ErrorResponse: type: object properties: error: type: string required: - error example: error: invalid_instrument WireNewsItem: type: object description: >- WireNewsItem. One aggregated market-news headline. `summary` is plain text in a lightweight format ('## ' opens a subheading, '• ' a bullet, everything else a paragraph) — publisher HTML never appears. Instruments are the futures roots the item was tagged with at ingest. properties: id: type: string description: Stable sha256 id; also the image-proxy key source: type: string description: Publisher name, for attribution headline: type: string summary: type: string description: Teaser or full body; empty string when the feed sent none url: type: string description: The article at its source imageUrl: type: - string - 'null' description: >- Feed thumbnail presence flag; fetch via /api/news/image/{id}, never this URL publishedAt: type: string description: ISO 8601 tags: type: array items: type: string description: Feed categories (macro, energy, metals, …) instruments: type: array items: type: string description: Futures roots tagged at ingest (ES, GC, ZC, …) required: - id - source - headline - summary - url - imageUrl - publishedAt - tags - instruments securitySchemes: tenantKey: type: http scheme: bearer description: >- Your firm’s API key (the API calls this the `tenant` key; `trdrs_sk_…`), server-to-server only. ````