Status Endpoint

Returns your current quota and the plan of your account.

Quota

Requests to this endpoint do not count against your quota or rate limit

Request Method: GET
Request URL: https://api.fxapi.com/v1/status

Request Parameters

Parameter	Type	Mandatory	Description
apikey	string	️	Your API Key

Sample Response

The response contains your account_id (and in account_id_str the same id as a string for JavaScript clients, whose numbers lose precision above 2^53) and one bucket per quota type: month for your regular monthly quota and grace for grace requests.

{
    "account_id": 313373133731337,
    "account_id_str": "313373133731337",
    "quotas": {
        "month": {
            "total": 300,
            "used": 71,
            "remaining": 229
        },
        "grace": {
            "total": 0,
            "used": 0,
            "remaining": 0
        }
    },
    "plan": {
        "name": "free",
        "interval": "month",
        "price_id": "price_1AbCdEfGhIjKlMnOpQrStUvW",
        "free": true,
        "custom": false,
        "status": "active",
        "renews_at": "2026-11-01T00:00:00+00:00",
        "scheduled": null,
        "upgrade_url": "https://app.fxapi.com/upgrade?utm_source=agent&utm_campaign=status&team=313373133731337",
        "plans_url": "https://api.fxapi.com/v1/agent/plans"
    }
}

The response also has a plan object after quotas: name, interval, price_id, free, custom, status (of the subscription, e.g. active), renews_at, scheduled (a plan change that starts later, or null), upgrade_url (null for a custom plan) and plans_url (every plan as JSON). Use it to check that an upgrade took effect.

Grace quota

If a subscription payment fails we do not block your API access right away. Instead your account temporarily receives a limited amount of grace requests. While the grace quota is active, successful requests count against the grace bucket instead of the month bucket, and responses carry X-RateLimit-Limit-Grace-Month / X-RateLimit-Remaining-Grace-Month headers. Once the payment is completed your regular quota applies again. For accounts in good standing the grace bucket is all zeroes.