Skip to content

Vote Reward API

A single universal API (/v1/l2/*) used by any Lineage 2 server listed on the platform, regardless of Chronicle or Platform. Server-to-server authentication via HMAC-SHA256 (API Key + Secret) — generate your credentials from your server's Manage page once it's verified.

Basic Flow

  1. Player runs .vote on the game server.
  2. The server calls POST /v1/l2/vote-sessions (HMAC-signed) → gets a VT_xxx token and a vote URL.
  3. Player opens the vote URL and votes on the site.
  4. The server calls POST /v1/l2/votes/check to see if the vote is eligible.
  5. The server calls POST /v1/l2/votes/claim (idempotent, atomic) and grants the reward.

Optional: POST /v1/l2/status lets the game server self-report its current online player count ({ "playersOnline": 123 }) instead of relying only on the platform's own periodic status check — the more accurate source of the "Players Online" number shown on your listing.

Authentication

Every request needs these four headers (no session/cookie/bearer token here):

x-l2-api-keyYour API Key, as-is.
x-l2-timestampCurrent Unix time in seconds.
x-l2-nonceA random, unique-per-request string (8–128 characters).
x-l2-signatureAn HMAC-SHA256 signature of the request.

For the exact signing algorithm and a working example, contact us when you're ready to integrate.