- REST reference
- Market context
- Narrative
Get today’s narrative
GET/public/v1/narrative/today
The latest published market narrative: headline, deck, branches, anchors and catalysts (news catalysts are titles only).
Request
curl "https://api.tradeeasyai.net/public/v1/narrative/today" \
-H "X-API-Key: $TRADEEASY_API_KEY"Response shape
Field names and types; no sample values.
{
"success": true,
"data": {
"runDate": "<string>",
"publishedAt": "<string>",
"masterHeadline": "<string>",
"masterDeck": "<string>",
"catalysts": [ … ]
},
"meta": { "timestamp": "<string>", "request_id": "<string>" }
}Parameters#
No parameters.
Response fields#
- runDatestring
The day of the run.
- publishedAtstring · ISO 8601
When it was published.
- masterHeadlinestring
The narrative’s headline.
- masterDeckstring
The standfirst.
- catalysts[]array
What the narrative is built on.
- branches[] · anchors[]array
The scenarios and the levels they hang on.
convictionScore, convictionDelta and convictionLabel are model outputs, documented by name only.
Errors#
- 401detail
Missing, invalid or revoked key, or a locked account. FastAPI {"detail": …} body, not the envelope.
- 403detail
The plan does not include the REST API, or the subscription is not active.
- 404NO_DATA
No narrative has been published yet.
- 429RATE_LIMIT_EXCEEDED
Per-key minute or day bucket spent. Honour Retry-After.
- 500FETCH_FAILED
Unexpected read failure. Retry with backoff.