API reference

import { WebSocketServer, WebSocket } from 'ws';

const wss = new WebSocketServer({ port: 8081 });
const MASTER_TOKEN = process.env.AIMJUNKIES_MASTER_TOKEN || 'aj_master_sec_sample_99a8b7c6d5e4f3a2b1c0';

wss.on('connection', (ws: WebSocket) => {
  let authenticated = false;

  ws.on('message', (raw: string) => {
    const packet = JSON.parse(raw.toString());

    // 1. Verify Mutual Handshake
    if (packet.action === 'AUTH') {
      if (packet.token === MASTER_TOKEN) {
        authenticated = true;
        return ws.send(JSON.stringify({ status: 'AUTHENTICATED', orgId: 'org_developer_hub' }));
      }
      return ws.close(4001, 'Unauthorized Master Token');
    }

    if (!authenticated) return ws.close(4002, 'Unauthenticated stream');

    // 2. Handle Push Events
    if (packet.event === 'ORDER_FULFILLMENT') {
      ws.send(JSON.stringify({
        status: 'SUCCESS',
        orderId: packet.orderId,
        licenseKey: 'SAMPLE-KEY-99A1-B882-C773',
        instructions: 'Run loader as Admin.'
      }));
    }
  });
});

{
  "status": "AUTHENTICATED",
  "orgId": "org_developer_hub",
  "operationalStatus": "OPERATIONAL",
  "latencyMs": 12
}

import express, { Request, Response } from 'express';
import crypto from 'crypto';

const app = express();
app.use(express.json());
const MASTER_TOKEN = process.env.AIMJUNKIES_MASTER_TOKEN || 'aj_master_sec_sample_99a8b7c6d5e4f3a2b1c0';

function verifySecret(req: Request, res: Response, next: Function) {
  // Constant-time comparison of "Bearer <your secret>"
  const trusted = Buffer.from('Bearer ' + MASTER_TOKEN, 'utf8');
  const untrusted = Buffer.from((req.headers['authorization'] as string) || '', 'utf8');
  if (trusted.length !== untrusted.length || !crypto.timingSafeEqual(trusted, untrusted)) {
    return res.status(401).json({ status: 'FAILED', message: 'Invalid secret' });
  }
  next();
}

app.post('/v1/aimjunkies-gateway', verifySecret, (req, res) => {
  res.json({ status: 'SUCCESS', operationalStatus: 'OPERATIONAL' });
});

{
  "status": "SUCCESS",
  "operationalStatus": "OPERATIONAL",
  "latencyMs": 14
}

const res = await fetch('https://api.aimjunkies.net/api/v1/organizations/org_developer_hub/assets', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.AJ_API_KEY!, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'Apex loader',
    filename: 'loader-4.2.8.exe',
    mimeType: 'application/octet-stream',
    sizeBytes: 8421376,
    version: '4.2.8',
  }),
});
const { asset, uploadUrl } = await res.json();

{
  "asset": {
    "id": "ast_…",
    "name": "Apex loader",
    "versions": [
      {
        "id": "ver_…",
        "version": "4.2.8"
      }
    ]
  },
  "uploadUrl": "https://…",
  "expiresInSeconds": 900,
  "expiresAt": "2026-11-10T12:15:00.000Z"
}

const res = await fetch('https://api.aimjunkies.net/api/v1/organizations/org_developer_hub/catalog/products/PRODUCT_ID/releases', {
  headers: { 'X-API-Key': process.env.AJ_API_KEY! },
});
const releases = await res.json();

[
  {
    "id": "rel_…",
    "version": "4.2.8",
    "gameBuild": "1.2.3",
    "status": "LIVE",
    "detectionStatus": "UNDETECTED",
    "promotedAt": "2026-11-09T18:00:00.000Z"
  }
]

await fetch('https://api.aimjunkies.net/api/v1/organizations/org_developer_hub/catalog/products/PRODUCT_ID/releases', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.AJ_API_KEY!, 'Content-Type': 'application/json' },
  body: JSON.stringify({ version: '4.2.8', gameBuild: '1.2.3', notes: 'Updated offsets.', assetVersionId: 'VAULT_VERSION_ID' }),
});

{
  "id": "rel_…",
  "version": "4.2.8",
  "gameBuild": "1.2.3",
  "status": "TESTING",
  "assetVersionId": "ver_…",
  "createdAt": "2026-11-10T12:00:00.000Z"
}

await fetch('https://api.aimjunkies.net/api/v1/organizations/org_developer_hub/catalog/products/PRODUCT_ID/releases/RELEASE_ID/promote', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.AJ_API_KEY! },
});

{
  "id": "rel_…",
  "version": "4.2.8",
  "status": "LIVE",
  "promotedAt": "2026-11-10T12:05:00.000Z"
}

const res = await fetch('https://api.aimjunkies.net/api/v1/organizations/org_developer_hub/webhooks', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.AJ_API_KEY!, 'Content-Type': 'application/json' },
  body: JSON.stringify({ url: 'https://hooks.example.com/aimjunkies', events: ['order.completed'] }),
});
const { id, secret } = await res.json(); // keep the secret: it is shown once

{
  "id": "whk_…",
  "organizationId": "org_developer_hub",
  "url": "https://hooks.example.com/aimjunkies",
  "secret": "whsec_…",
  "events": [
    "order.completed",
    "refund.processed"
  ],
  "status": "ACTIVE",
  "createdAt": "2026-11-10T12:00:00.000Z"
}

const res = await fetch('https://api.aimjunkies.net/api/v1/licenses/activate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ key: 'AJ-APEX-9921-X99B-814A', hwid: 'c7a93b4e182f09d6e84a2c5b3d1f8e7a' }),
});
const status = await res.json();

{
  "licenseId": "lic_…",
  "hwid": "c7a93b4e182f09d6e84a2c5b3d1f8e7a",
  "status": "ACTIVE",
  "expiresAt": "2026-11-10T13:00:00.000Z",
  "signature": "…"
}

const res = await fetch('https://api.aimjunkies.net/api/v1/licenses/validate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ key: 'AJ-APEX-9921-X99B-814A', hwid: 'c7a93b4e182f09d6e84a2c5b3d1f8e7a' }),
});
const status = await res.json();

{
  "licenseId": "lic_…",
  "hwid": "c7a93b4e182f09d6e84a2c5b3d1f8e7a",
  "status": "ACTIVE",
  "expiresAt": "2026-11-10T13:00:00.000Z",
  "signature": "…"
}

const res = await fetch('https://api.aimjunkies.net/api/v1/licenses/LICENSE_ID/hwid-reset/self', {
  method: 'POST',
  headers: { Authorization: `Bearer ${accessToken}` },
});
const allowance = await res.json(); // { allowed, remaining, nextAt, … }

{
  "allowed": true,
  "blocked": null,
  "limit": 3,
  "used": 1,
  "remaining": 2,
  "periodDays": 365,
  "lifetime": false,
  "nextAt": null
}

const res = await fetch('https://api.aimjunkies.net/api/v1/catalog/market/offers?section=keys-cards&type=steam-key&limit=20');
const offers = await res.json();

{
  "offers": [
    {
      "id": "off_…",
      "title": "…",
      "listing": {
        "slug": "…"
      },
      "seller": {
        "name": "…"
      },
      "purchasable": true
    }
  ],
  "filterable": [],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 20,
    "pages": 1,
    "sort": "relevance"
  }
}

const res = await fetch('https://api.aimjunkies.net/api/v1/catalog/market/quote', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ lines: [{ offerId: 'OFFER_ID', planDays: 30, quantity: 1 }] }),
});
const quote = await res.json();

{
  "lines": [
    {
      "index": 0,
      "offerId": "OFFER_ID",
      "status": "ok",
      "issues": [],
      "deliveryEstimate": "Instant"
    }
  ],
  "subtotalCents": 0,
  "currency": "USD",
  "ready": true,
  "checkout": {
    "available": true,
    "code": null
  }
}

const res = await fetch('https://api.aimjunkies.net/api/v1/orders', {
  method: 'POST',
  headers: { Authorization: `Bearer ${accessToken}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ items: [{ offerId: 'OFFER_ID', planDays: 30, quantity: 1 }] }),
});
const order = await res.json();

{
  "id": "ord_…",
  "status": "PENDING",
  "items": [
    {
      "id": "itm_…",
      "lineStatus": "AWAITING_PAYMENT"
    }
  ]
}

await fetch('https://api.aimjunkies.net/api/v1/orders/lines/LINE_ID/confirm', {
  method: 'POST',
  headers: { Authorization: `Bearer ${accessToken}` },
});

{
  "id": "line_…",
  "status": "PROTECTION",
  "timers": {
    "autoConfirmAt": null
  }
}

await fetch('https://api.aimjunkies.net/api/v1/orders/lines/LINE_ID/dispute', {
  method: 'POST',
  headers: { Authorization: `Bearer ${accessToken}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ reason: 'The key was already redeemed.', requested: 'full_refund' }),
});

{
  "id": "line_…",
  "status": "DISPUTED"
}