REST reference
Market context
News tone

Get headline tone for a symbol

GET/public/v1/news-tone/{symbol}

The same rows for one symbol. Aliases resolve: GOLD answers as XAUUSD.

PremiumAnnualLifetime

Request

curl "https://api.tradeeasyai.net/public/v1/news-tone/XAUUSD?interval=1h" \
  -H "X-API-Key: $TRADEEASY_API_KEY"

Response shape

Field names and types; no sample values.

200 · application/json

{
  "success": true,
  "data": {
    "supported": "<boolean>",
    "rows": [ … ]
  },
  "meta": { "timestamp": "<string>", "request_id": "<string>" }
}

Parameters#

symbolstringpathRequired
TradeEasy symbol, for example XAUUSD, NAS100 or BTCUSD.
intervalstringquery
1h or 1d, as for asset classes.
startstringquery
ISO 8601, UTC.
endstringquery
ISO 8601, UTC. Default now.
min_nintegerquery
Minimum headlines for net_tone and strong_share. Default 8 per symbol.
limitintegerquery
Rows per page, 1 to 2,000. Default 500.
cursorstringquery
meta.next_cursor from the previous page.

Response fields#

symbol · requestedstring
The resolved symbol and what you asked for.
supportedboolean
False when the symbol has no tone coverage.
rows[]array
As for asset classes; daily rows add hours.

Errors#

400INVALID_SYMBOL
The symbol is empty or longer than 32 characters.
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.
422detail[]
A query value is outside its range (FastAPI validation).
429RATE_LIMIT_EXCEEDED
Per-key minute or day bucket spent. Honour Retry-After.
503TONE_UNAVAILABLE
The hourly rollup is behind. Honour Retry-After.

Educational market research, not investment advice; not for fully automated trade execution. Questions about the API or the MCP server: support@tradeeasyai.net.