Skip to content
Get started
Analysis status
  1. REST reference
  2. Account
  3. Analysis status

Poll an analysis job

GET/public/v1/analysis/status/{job_id}

The state of an on-demand analysis job: pending, running, ready or failed. When ready, fetch result_url.

PremiumAnnualLifetime

Request

curl "https://api.tradeeasyai.net/public/v1/analysis/status/<job_id>" \
  -H "X-API-Key: $TRADEEASY_API_KEY"

Response shape

Field names and types; no sample values.

200 · application/json
{
  "success": true,
  "data": {
    "state": "<string>",
    "note": "<string>"
  },
  "meta": { "timestamp": "<string>", "request_id": "<string>" }
}

Parameters#

  • job_idstringpathRequired

    The job_id from a 202 response.

Response fields#

  • job_id · symbol · data_kindstring

    What was queued.

  • statestring

    pending → running → ready | failed.

  • poll_url · result_urlstring

    Where to poll, and where the data is once ready.

  • notestring

    For technical, narrative and predictions: readiness means sentiment is live; the kind backfills on its next scheduled run.

  • retry_after · retryableinteger · boolean

    While pending; after a failure.

Errors#

  • 400INVALID_JOB_ID

    Malformed id.

  • 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.

  • 404JOB_NOT_FOUND

    Unknown or expired job.

  • 429RATE_LIMIT_EXCEEDED

    Per-key minute or day bucket spent. 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.