AnalyticsFX. Trading Analytics and Journal Platform

GET/api/v1/seasonality/{symbol}

1 credit

Seasonality stats

Compiled seasonal statistics for a symbol. You give a symbol and a number of years; we compute the monthly seasonality (average/median return and win rate), the average annual return, and the best, worst and most-consistent months. Raw per-year data is not exposed. Need the underlying data? Contact us for a business API.

Parameters

Name	In	Type	Req.	Description
symbol	path	string	yes	Instrument symbol, case-insensitive. Example: eurusd, xauusd, aapl.
years	query	integer	no	Years of history to compile (default 15). Ignored when start_year is given.
start_year	query	integer	no	First year to include (overrides years).
end_year	query	integer	no	Last year to include (default current year). Span is capped at 25 years.

Example request

curl -H "Authorization: Bearer afx_live_xxx" \
  "https://www.analytics-fx.com/api/v1/seasonality/eurusd"

Example response

{
  "apiVersion": "v1",
  "data": {
    "symbol": "EURUSD", "requestedRange": { "startYear": 2010, "endYear": 2024 }, "yearsUsed": 15,
    "sampleYears": { "from": 2011, "to": 2025 },
    "avgAnnualReturnPct": 1.84,
    "monthly": [
      { "month": 1, "label": "Jan", "avgReturnPct": -0.42, "medianReturnPct": -0.30, "winRatePct": 40.0, "years": 15 }
    ],
    "best": { "month": "Apr", "avgReturnPct": 1.12 },
    "worst": { "month": "Sep", "avgReturnPct": -0.95 },
    "mostConsistent": { "month": "Dec", "winRatePct": 73.3 }
  },
  "meta": { "requestId": "req_ab12", "credits": { "cost": 1, "remaining": 994 } }
}

Try this endpoint

API key

symbol *yearsstart_yearend_year

GET /api/v1/seasonality/eurusd?years=15&start_year=2010&end_year=2024

Create a key at /dashboard/api. The key stays in your browser.

Name

Type

Req.

Description

symbol

path

string

yes

Instrument symbol, case-insensitive. Example: eurusd, xauusd, aapl.

years

query

integer

Years of history to compile (default 15). Ignored when start_year is given.

start_year

query

integer

First year to include (overrides years).

end_year

query

integer

Last year to include (default current year). Span is capped at 25 years.

{ "apiVersion": "v1", "data": { "symbol": "EURUSD", "requestedRange": { "startYear": 2010, "endYear": 2024 }, "yearsUsed": 15, "sampleYears": { "from": 2011, "to": 2025 }, "avgAnnualReturnPct": 1.84, "monthly": [ { "month": 1, "label": "Jan", "avgReturnPct": -0.42, "medianReturnPct": -0.30, "winRatePct": 40.0, "years": 15 } ], "best": { "month": "Apr", "avgReturnPct": 1.12 }, "worst": { "month": "Sep", "avgReturnPct": -0.95 }, "mostConsistent": { "month": "Dec", "winRatePct": 73.3 } }, "meta": { "requestId": "req_ab12", "credits": { "cost": 1, "remaining": 994 } } }