VICEX Developer API
Overview#
The API has three surfaces:
Public quotes, tickers and candles for DacityCoin/SOL. No key needed.
Place and track orders for your users from bots, Discord shops or your own storefront.
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#
- NowPre-orders open
The exchange takes SOL orders, which queue as Pending. Public market endpoints are already live.
- 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.
- 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.
/api/market?range=24HLiveLive quote, stats and price series/api/orders/recent?limit=25LivePublic order feedcurl 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/v1The 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))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 };
}read, trade or fulfil. Requests with a timestamp more than 30 seconds old are rejected.Rate limits#
| Surface | Limit | Window |
|---|---|---|
| Public market data | 120 requests | per minute, per IP |
| Trading | 60 requests | per minute, per key |
| Fulfilment | 300 requests | per minute, per key |
| WebSocket | 10 connections | per key |
Every response includes X-RateLimit-Remaining and X-RateLimit-Reset. Going over returns 429. Back off until the reset time.
Endpoints#
Markets
/marketsNov 19List markets (DC-SOL)/markets/DC-SOL/tickerNov 19Buy, sell, spread, 24h stats/markets/DC-SOL/quote?amount=Nov 19Exact SOL cost incl. volume discount/markets/DC-SOL/candles?interval=15mNov 19OHLC price historyOrders
/ordersNov 19Create an order; returns unsigned tx/orders/{id}/submitNov 19Submit the signed tx for verification/orders/{id}Nov 19Order status & queue position/orders?wallet=Nov 19List orders for a walletPOST 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.
/fulfilment/queue?platform=ps5Nov 19Next claimable orders, FIFO/fulfilment/{id}/claimNov 19Lock an order (status → filling)/fulfilment/{id}/completeNov 19Mark delivered (status → fulfilled)/fulfilment/{id}/claimNov 19Release a claim back to the queueOrder 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.paidPayment confirmed, order is Pending
order.fillingA partner claimed the order
order.fulfilledDacityCoin delivered
order.refundedSOL returned to the payer
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": "..." }
| 400 | invalid_request | Bad amount, platform or handle |
| 401 | unauthorized | Missing or bad signature |
| 404 | not_found | Unknown order |
| 409 | conflict | Order already paid or claimed |
| 429 | rate_limited | Slow down |
| 503 | unavailable | Price feed or vault offline |
SDKs#
Official clients ship with v1 on Nov 19:
pnpm add @vicex/sdk # TypeScript / Node
pip install vicex # PythonChangelog#
- 2026-11-17Public preview of the v1 spec. Market and order-feed endpoints are live on the exchange.