18+ Only  |  Gambling can be addictive — please gamble responsibly  |  Gambling Help: 1800 858 858  |  GambleAware

API reference / Account

GET /v1/account/insights

Usage, request health, projection and upgrade advice

What the console dashboard shows: successful calls and credits per Australia/Sydney day, the endpoints you use most, refused requests grouped by cause (with whose side the cause is on), whether your integration is working, a projection to the next reset (only once there is enough history to make one), and upgrade advice that appears only when your own usage shows a need. Request contents are never stored or returned.

Requires X-API-Key 0 credits

Request

curl 'https://api.puntersedge.online/v1/account/insights' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

NameIn TypeRequired Description
days query integer no Days of history for the daily series.

Responses

Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json — this call costs 0 credits. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "generated_at": "2026-10-22T06:00:00Z",
  "days": 7,
  "timezone": "Australia/Sydney",
  "metered": true,
  "plan": "free",
  "integration": {
    "first_success_at": "2026-10-05T03:46:00Z",
    "last_success_at": "2026-10-21T06:00:00Z",
    "last_24h": {
      "ok": 1,
      "customer_errors": 2,
      "server_errors": 0
    },
    "state": "errors",
    "basis": "More of your requests were refused than answered in the last 24 hours."
  },
  "daily": [
    {
      "date": "2026-10-20",
      "ok_calls": 3,
      "credits": 135,
      "client_errors": {},
      "server_errors": 0
    },
    {
      "date": "2026-10-21",
      "ok_calls": 3,
      "credits": 135,
      "client_errors": {},
      "server_errors": 0
    },
    {
      "date": "2026-10-22",
      "ok_calls": 0,
      "credits": 0,
      "client_errors": {
        "422": 1,
        "403": 1
      },
      "server_errors": 0
    }
  ],
  "top_endpoints": [
    {
      "endpoint": "/v1/racing/next-to-go",
      "calls": 22,
      "credits": 990
    }
  ],
  "errors": [
    {
      "status": 403,
      "endpoint": "/v1/racing/price-history",
      "count": 1,
      "last_at": "2026-10-22T03:00:00Z",
      "guidance_code": "plan_gate",
      "side": "yours",
      "gate": "price_history_past"
    },
    {
      "status": 422,
      "endpoint": "/v1/racing/results",
      "count": 1,
      "last_at": "2026-10-22T04:00:00Z",
      "guidance_code": "validation",
      "side": "yours",
      "gate": null
    }
  ],
  "projection": {
    "method": "Two rates are compared: credits used since the start of this period (or since your first successful request, if later) per day, and the last 7 days per day. Each is carried forward to the next reset. When they disagree by more than 2x, or one day holds most of the period's use, a range is shown instead of one number.",
    "used": 2400,
    "limit": 3000,
    "period_start": "2026-10-01T00:00:00Z",
    "next_reset": "2026-11-01T00:00:00Z",
    "sufficient": true,
    "reason": null,
    "active_days": 6,
    "period_rate_per_day": 140.4,
    "trailing_7d_rate_per_day": 115.7,
    "projected": 3769,
    "projected_low": 3528,
    "projected_high": 3769,
    "irregular": false,
    "exhausts_before_reset": true,
    "exhaustion_estimate": "2026-10-26T12:33:30Z"
  },
  "entitlements": {
    "plan": "free",
    "held": [],
    "grandfathered": []
  },
  "recommendations": [
    {
      "id": "credits",
      "reason": "credits",
      "limitation": "At your current rate your credits run out before the reset.",
      "evidence": {
        "refused_402": 0,
        "projected": 3769,
        "projected_high": 3769,
        "limit": 3000,
        "exhaustion_estimate": "2026-10-26T12:33:30Z"
      },
      "config_fixes": [
        {
          "id": "etag",
          "text": "Send If-None-Match with the ETag of your last next-to-go response: an unchanged board comes back as 304 and costs 0 credits."
        },
        {
          "id": "poll_interval",
          "seconds": 65,
          "text": "Poll next-to-go no more often than every 65 seconds: the stored board is refreshed on that cycle for your plan, so faster polls pay again for the same data."
        }
      ],
      "resolves": "a larger monthly credit allowance",
      "offer": {
        "plan": "hobby",
        "plan_name": "Hobby",
        "price_aud": 9,
        "credits_per_month": 7500,
        "rpm": 60,
        "sales_assisted": false,
        "url": "https://puntersedge.online/api/pricing?plan=hobby&utm_source=console&utm_medium=recommendation#plan-hobby",
        "covers_projected_need": true
      },
      "not_included": []
    },
    {
      "id": "gate:price_history_past",
      "reason": "plan_gate",
      "limitation": "1 request for price history on races that started more than 24 hours ago refused on your plan.",
      "resolves": "price history on races that started more than 24 hours ago",
      "evidence": {
        "refused_403": 1,
        "gate": "price_history_past"
      },
      "config_fixes": [
        {
          "id": "recent_races",
          "text": "Price history on races that started in the last 24 hours stays available on your plan: fetch it while the race is recent."
        }
      ],
      "sample": "price_history",
      "offer": {
        "plan": "racing",
        "plan_name": "Standard",
        "price_aud": 29,
        "credits_per_month": 75000,
        "rpm": 200,
        "sales_assisted": false,
        "url": "https://puntersedge.online/api/pricing?plan=racing&utm_source=console&utm_medium=recommendation#plan-racing"
      },
      "also_in": [
        "Plus",
        "Business",
        "Platform",
        "Scale"
      ],
      "not_included": []
    }
  ],
  "overage": null
}

Related endpoints

Try it against live data

The free tier needs no credit card, and the sandbox endpoints need no key at all.

Get a free API key Quickstart
This site contains wagering-related analysis and is intended for Australian users aged 18+. Gambling involves risk. Please gamble responsibly.