API reference

Profile and limits

Your plan, today’s usage, your key and the settings optimize will use. It costs nothing: never counted and never limited, so call it as often as you like.

GET/v1/me

Example

curl https://api.kellyiq.com/v1/me \
  -H "Authorization: Bearer $KELLYIQ_API_KEY"

{
  "apiVersion": "1.0",
  "tier": "sharp",
  "trialEndsAt": null,
  "limits": {
    "optimize": {
      "perDay": 250,
      "usedToday": 3,
      "remainingToday": 247,
      "resetsAt": "2026-10-20T04:00:00Z",
      "maxConcurrentPerAccount": 1,
      "perMinute": 10
    },
    "calculators": {
      "metered": false,
      "perMinute": 60
    }
  },
  "key": {
    "prefix": "kiqa_5ePA",
    "createdAt": "2026-10-20T02:40:41Z",
    "lastUsedAt": "2026-10-20T03:25:12Z"
  },
  "defaults": {
    "maxTotalExposure": {
      "value": 1,
      "source": "default"
    },
    "perBetCap": {
      "value": 0.2,
      "source": "default"
    },
    "maxBets": {
      "value": null,
      "source": "default"
    },
    "warnings": []
  }
}

Response

Field	Meaning
`tier`	`free`, `bettor`, `sharp` or `pro`. `trialEndsAt` is set only during a trial.
`limits.optimize`	Today’s allowance: `perDay`, `usedToday`, `remainingToday`, `resetsAt` (next midnight US Eastern, in UTC), and the per-minute and one-at-a-time limits.
`limits.calculators`	Calculators are not counted per day; only the per-minute limit applies.
`key`	The start of your key, when it was created and last used. Never the key itself.
`defaults`	What optimize uses for each setting a request leaves out, and where it comes from. See settings.

usedToday can be higher than perDay: refused attempts over the limit still count.