Skip to content
moxon home

Authentication

The moxon API uses Bearer token authentication to identify users with premium plans.

Usage

To authenticate your requests, include your API key in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.moxon.dev/v5/infos

Checking Your Plan

Use GET /auth to check which tier a token resolves to, along with its limits:

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.moxon.dev/auth
{
    "authenticated": true,
    "tier": "pro",
    "limits": {
        "hourly": 6000,
        "burst": 120
    }
}

Without a token, it returns the default tier instead of an error:

{
    "authenticated": false,
    "tier": "default",
    "limits": {
        "hourly": 2000,
        "burst": 50
    }
}

An invalid token returns the same 401 shown below.

Rate Limits

PlanRequests/hourBurst/10s
Free2,00050
Advanced3,50080
Pro6,000120
Business10,000200

Burst Limit

The burst limit prevents sending too many requests in a short window. If you exceed the burst limit, you will receive a 429 Too Many Requests response.

See the Pricing page for more details.

Error Responses

Invalid Token

If the provided token is incorrect or expired:

{
    "message": "Unauthorized",
    "error": "Invalid token.",
    "status": "401"
}

No Token

Note

If no token is provided, the request is treated as unauthenticated and uses the Free tier limits (2,000 requests/hour).

Getting an API Key

To obtain an API key, purchase a plan on the Pricing page. Your unique token will be sent to your email after purchase.

Edit this page on GitHubReport an issue

Last updated on July 31, 2026