API V1

Build with live MMO server data.

Query published servers and receive signed lifecycle events.

QUICKSTART

Create a key

Open Dashboard → API access, choose a plan, complete checkout and create a key. The secret is shown once and only its SHA-256 hash is stored.

curl "https://arcaderank-top.votus.chatgpt.site/api/v1/servers?game=MU%20Online&limit=25" \
+ -H "x-api-key: YOUR_KEY"
ENDPOINT

GET /api/v1/servers

Send x-api-key. Optional parameters: game and limit. Responses contain identity, game, version, rates, region, launch date, online state, ping, votes, rating and verification.

LIMITS

Plans

Starter · $2910,000 requestsCurrent data
Business · $99100,00090 days + webhooks
Enterprise · $2991,000,000365 days + webhooks
WEBHOOKS

Event delivery

Configure an HTTPS endpoint in Dashboard → API webhooks. Available events: server.online, server.offline, vote.created, and server.launching_soon. Return 2xx quickly; MMOTOP.ORG attempts failed requests up to three times and records them in the delivery log.

SECURITY

Verify HMAC signatures

expected = HMAC_SHA256(secret, timestamp + "." + rawRequestBody)
header: x-mmorank-signature: v1=<hex digest>

Use the raw body and headers x-mmorank-id, x-mmorank-timestamp, x-mmorank-signature. Reject stale timestamps and deduplicate delivery IDs.

ERRORS

HTTP status codes

401 invalid key · 403 unavailable capability · 429 quota reached · 500 platform error.