Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/month

One month's year-by-year history

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/fxseasonality-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/fxseasonality-api/v1/month" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/fxseasonality-api/v1/month", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/fxseasonality-api/v1/month");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/fxseasonality-api/v1/month",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "base": "GBP",
        "name": "December",
        "pair": "GBPUSD",
        "month": 12,
        "quote": "USD",
        "years": 10,
        "history": [
            {
                "year": 2016,
                "return_pct": -2.57
            },
            {
                "year": 2017,
                "return_pct": 0.217
            },
            {
                "year": 2018,
                "return_pct": 0.699
            },
            {
                "year": 2019,
                "return_pct": 2.079
            },
            {
                "year": 2020,
                "return_pct": 2.412
            },
            {
                "year": 2021,
                "return_pct": 1.264
            },
            {
                "year": 2022,
                "return_pct": -1.398
            },
            {
                "year": 2023,
                "return_pct": 0.604
            },
            {
                "year": 2024,
                "return_pct": -1.147
            },
            {
                "year": 2025,
                "return_pct": 1.494
            }
        ],
        "win_rate_pct": 70,
        "avg_return_pct": 0.365
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:13.051Z",
        "request_id": "7a9a0101-9e5a-4f54-9b4d-41b1993e67af"
    },
    "status": "ok",
    "message": "Month history retrieved successfully",
    "success": true
}