Skip to content
Get started
Sentiment
  1. REST reference
  2. Model outputs
  3. Sentiment

Get sentiment history

GET/public/v1/sentiment/{symbol}/history

Both horizons for up to 365 days from per-symbol snapshots, with a coverage block that says what was actually found.

PremiumAnnualLifetimeModel output · reference

Model output · reference only. This route returns TradeEasy model scores, probabilities or levels. Its fields are documented by name and type; the docs show no sample values. Educational research, not investment advice.

Request

curl "https://api.tradeeasyai.net/public/v1/sentiment/XAUUSD/history?days=30" \
  -H "X-API-Key: $TRADEEASY_API_KEY"

Response shape · reference only

Field names and types; no sample values.

200 · application/json
{
  "success": true,
  "data": {
    "history": [ … ],
    "coverage": { … },
    "bucket_note": "<string>",
    "degraded": { … }
  },
  "meta": { "timestamp": "<string>", "request_id": "<string>" }
}

Parameters#

  • symbolstringpathRequired

    TradeEasy symbol, for example XAUUSD or EURUSD. Up to 32 characters.

  • daysintegerquery

    Days of history, 1 to 365. Default 30.

  • granularitystringquery

    daily (one reading a day) or intraday (every closed 15-minute snapshot). Default daily.

Response fields#

  • history[]array

    Readings, oldest first: date (and timestamp), swing and day objects with direction, conviction and score, alignment.

  • coverageobject

    days_returned, first, last, complete.

  • bucket_notestring

    Says that only closed 15-minute buckets are served.

  • degradedobject

    Present when a slow fallback returned partial data.

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.

  • 500FETCH_FAILED

    Unexpected read failure. Retry with backoff.

  • 503DATA_UNAVAILABLE

    History is temporarily unavailable. 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.