VICEX.exchange
Developers

VICEX Developer API

Programmatic access to the DacityCoin market: live quotes, order placement, order status, and the fulfilment network that fills orders. The full API goes live Nov 19 alongside GTA VI. Until then, anyone can pre-order with SOL on the exchange, and those orders fill first.
Status: preview REST · WebSocket · Webhooks HMAC-signed requests

Overview#

The API has three surfaces:

Market data

Public quotes, tickers and candles for DacityCoin/SOL. No key needed.

Trading

Place and track orders for your users from bots, Discord shops or your own storefront.

Fulfilment

Approved partners claim queued orders, deliver DacityCoin in-game and get paid in SOL.

Settlement always happens on Solana. Creating an order returns an unsigned transaction that pays the VICEX vault, with the order ID in a memo. The end user signs it with their own wallet, so the API never holds private keys.

Launch timeline#

  1. NowPre-orders open

    The exchange takes SOL orders, which queue as Pending. Public market endpoints are already live.

  2. Nov 19API v1 + fulfilment network

    API keys issued, trading and partner endpoints enabled, WebSocket and webhooks switched on. Pending orders start filling in queue order.

  3. After launchSell side

    Buyback (selling DacityCoin for SOL) opens, along with sell orders over the API.

Available today#

These read-only endpoints on the exchange already work and need no key. Their response shape will carry over to v1.

GET/api/market?range=24HLiveLive quote, stats and price series
GET/api/orders/recent?limit=25LivePublic order feed
curl https://vicex.exchange/api/market?range=24H
{
  "solUsd": 71.52,
  "usdPerMillion": 4,
  "buy": 0.05593,          // SOL per 1M DacityCoin
  "sell": 0.04754,         // buyback quote
  "stats": { "orders24h": 0, "cash24h": 0, "sol24h": 0, "queueCount": 0, "queueCash": 0 },
  "series": [{ "t": 1794794400000, "buy": 0.05614, "sell": 0.04719 }]
}

Base URL & versioning#

https://api.vicex.exchange/v1

The version is in the path. Changes within v1 only add things: new fields and endpoints may appear, and existing ones won't be removed or renamed. All amounts are integers: DacityCoin in whole units, SOL in lamports (1 SOL = 1,000,000,000 lamports). Timestamps are ISO-8601 UTC.

Authentication#

Trading and partner endpoints need an API key and secret. Sign every request with HMAC-SHA256 over timestamp + method + path + body and send these headers:

VICEX-KEY:        vx_live_8a1f…
VICEX-TIMESTAMP:  1795046400
VICEX-SIGNATURE:  base64(hmac_sha256(secret, timestamp + method + path + body))
Signing
import { createHmac } from "node:crypto";

function sign(secret: string, method: string, path: string, body = "") {
  const ts = Math.floor(Date.now() / 1000).toString();
  const sig = createHmac("sha256", secret).update(ts + method + path + body).digest("base64");
  return { "VICEX-KEY": process.env.VICEX_KEY!, "VICEX-TIMESTAMP": ts, "VICEX-SIGNATURE": sig };
}
Key scopes
Keys are scoped to read, trade or fulfil. Requests with a timestamp more than 30 seconds old are rejected.

Rate limits#

SurfaceLimitWindow
Public market data120 requestsper minute, per IP
Trading60 requestsper minute, per key
Fulfilment300 requestsper minute, per key
WebSocket10 connectionsper key

Every response includes X-RateLimit-Remaining and X-RateLimit-Reset. Going over returns 429. Back off until the reset time.

Endpoints#

Markets

GET/marketsNov 19List markets (DC-SOL)
GET/markets/DC-SOL/tickerNov 19Buy, sell, spread, 24h stats
GET/markets/DC-SOL/quote?amount=Nov 19Exact SOL cost incl. volume discount
GET/markets/DC-SOL/candles?interval=15mNov 19OHLC price history

Orders

POST/ordersNov 19Create an order; returns unsigned tx
POST/orders/{id}/submitNov 19Submit the signed tx for verification
GET/orders/{id}Nov 19Order status & queue position
GET/orders?wallet=Nov 19List orders for a wallet
Create order
POST https://api.vicex.exchange/v1/orders
{
  "amount": 5000000,
  "platform": "xbox",
  "handle": "NightRunner42",
  "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}

Fulfilment partners

Approved partners pull the queue, claim orders, deliver in-game and confirm. Payouts settle in SOL.

GET/fulfilment/queue?platform=ps5Nov 19Next claimable orders, FIFO
POST/fulfilment/{id}/claimNov 19Lock an order (status → filling)
POST/fulfilment/{id}/completeNov 19Mark delivered (status → fulfilled)
DELETE/fulfilment/{id}/claimNov 19Release a claim back to the queue

Order object#

{
  "id": "8f3a2c1e-5b7d-4e2a-9c61-0d4b8e7f1a23",
  "status": "pending",            // awaiting_payment | pending | filling | fulfilled | refunded | expired
  "amount": 5000000,              // DacityCoin
  "platform": "xbox",             // ps5 | xbox
  "lamports": 268464000,
  "usd_total": 19.20,
  "queue_position": 412,          // null unless pending
  "tx_signature": "5UfD…q9Lk",
  "created_at": "2026-11-17T01:42:10Z",
  "paid_at": "2026-11-17T01:42:31Z"
}

WebSocket streams#

wss://api.vicex.exchange/v1/stream
→ { "op": "subscribe", "channels": ["ticker:DC-SOL", "fills", "orders:<wallet>"] }
← { "type": "subscribed", "channels": ["ticker:DC-SOL", "fills", "orders:7xKX…gAsU"] }

Public channels need no auth. Wallet and partner channels need a signed auth message first. The server pings every 20s; reply with a pong or the connection closes.

Webhooks#

Register an HTTPS endpoint and choose events. Each delivery is signed so you can check it came from VICEX.

order.paid

Payment confirmed, order is Pending

order.filling

A partner claimed the order

order.fulfilled

DacityCoin delivered

order.refunded

SOL returned to the payer

Verify signature
import { createHmac, timingSafeEqual } from "node:crypto";

export function verify(raw: string, header: string, secret: string) {
  const [t, v1] = header.split(",").map((p) => p.split("=")[1]); // "t=…,v1=…"
  const expected = createHmac("sha256", secret).update(`${t}.${raw}`).digest("hex");
  return timingSafeEqual(Buffer.from(v1), Buffer.from(expected));
}

Failed deliveries are retried with exponential backoff for 24 hours. Reply with any 2xx status to acknowledge.

Errors#

Errors return JSON: { "error": "message", "code": "..." }

400invalid_requestBad amount, platform or handle
401unauthorizedMissing or bad signature
404not_foundUnknown order
409conflictOrder already paid or claimed
429rate_limitedSlow down
503unavailablePrice feed or vault offline

SDKs#

Official clients ship with v1 on Nov 19:

pnpm add @vicex/sdk        # TypeScript / Node
pip install vicex          # Python

Changelog#

  • 2026-11-17Public preview of the v1 spec. Market and order-feed endpoints are live on the exchange.