Authentication

Get an API key

Visit polyedge.dev to create an account and generate your API key.

Keep your API key secret. Do not expose it in client-side code, public repositories, or anywhere it can be read by others.

Pass the key in your requests

Include your API key in the X-PolyEdge-Key header on every request.

curl https://api.polyedge.dev/v1/analytics/leaderboard \
  -H "X-PolyEdge-Key: YOUR_API_KEY"

Node.js

import PolyEdgeClient from './polyedge.js';

const client = new PolyEdgeClient('YOUR_API_KEY');
// The X-PolyEdge-Key header is set automatically on every request.

Python

from polyedge import PolyEdgeClient

client = PolyEdgeClient('YOUR_API_KEY')
# The X-PolyEdge-Key header is set automatically on every request.

Access tiers

PolyEdge has two access tiers.

	Demo	Full access
Results per request	Max 20	Up to 100
Pagination (`offset`)	Must be `0`	Unrestricted
All endpoints	Yes	Yes
Real-time stream	Yes	Yes

Demo keys are useful for testing and prototyping. Upgrade to full access at polyedge.dev when you’re ready to paginate deeper or retrieve larger result sets.

Error reference

401 Unauthorized

A 401 response means the request was rejected due to an authentication problem.

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key."
}

Common causes:

The X-PolyEdge-Key header is missing from the request.
The API key is invalid, malformed, or has been revoked.
The key was passed in the wrong header name (e.g., Authorization instead of X-PolyEdge-Key).

Get Started

Guides

SDKs

Get an API key

Pass the key in your requests

Node.js

Python

Access tiers

Error reference

401 Unauthorized

​Get an API key

​Pass the key in your requests

​Node.js

​Python

​Access tiers

​Error reference

​401 Unauthorized

Get an API key

Pass the key in your requests

Node.js

Python

Access tiers

Error reference

401 Unauthorized