Liquidity Network

Market maker registry, rebate ledger, and public 24h leaderboard. Ship live 2026-09-07 as part of API v2.5.0.

Wave-1 scope: MM registry (self-serve starter tier), rebate ledger populated every 5 min from CLOB fill history, public leaderboard. Wave-2 deferred: live quote streaming WS, real-time inventory tracking, per-MM risk limits.

How rebates work

Rebates are computed deterministically at fill time using the same fee formula the CLOB engine uses to charge takers. When a maker's resting order fills against an eligible taker (currently: AMM matches + mint-taker flows), the maker receives a rebate paid from the taker fee pool. Standard P2P trades do not accrue rebates under the wave-1 model.

The rebate ledger is populated by a background poller (5-min cadence, cluster-safe via Redis lock) that reads CLOB trade history and upserts per-day, per-market aggregates into maker_rebates. Idempotent — reprocessing the same fill range is a no-op.

Endpoints

MethodPathAuthPurpose
POST/v1/mm/applyBearer (trade)Register as market maker
GET/v1/mm/statusBearer (read)Your MM registration status
GET/v1/mm/me/rebatesBearer (read)Your earned rebates by day + market
GET/v1/liquidity/leaderboardPublicTop 25 makers by 24h/7d/30d rebate

Register as a market maker

curl -X POST https://api.predictasiax.com/v1/mm/apply \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "display_name": "Acme Market Making",
    "requested_tier": "starter",
    "contact": { "telegram": "@acme_mm", "email": "[email protected]" }
  }'

Response for starter tier (auto-approved):

{
  "ok": true,
  "data": {
    "user_id": "app_...",
    "display_name": "Acme Market Making",
    "status": "approved",
    "tier": "starter",
    "quote_cap_usdt": 10000,
    "created_at": "2026-09-07T...",
    "approved_at": "2026-09-07T...",
    "note": "Starter tier auto-approved. You may now place maker orders and earn rebates automatically."
  }
}

Tiers

TierQuote capApproval
starter$10,000 USDTSelf-serve, auto-approve on apply
proNegotiatedHuman review — contact Request access
institutionalNegotiatedHuman review — contact Request access

Your rebate history

curl "https://api.predictasiax.com/v1/mm/me/rebates?from=2026-08-01" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Optional from / to query params (YYYY-MM-DD). Returns per-day, per-market aggregations plus totals.

Public leaderboard

curl "https://api.predictasiax.com/v1/liquidity/leaderboard?window=24h"

No auth required. window = 24h (default) / 7d / 30d. Cached 60s at edge and 60s per-worker.

Returns top 25 makers by rebate earned in the window, with tier + display name if registered (falls back to masked user_id if unregistered but earning).

Verify your rebates

All rebates trace back to individual fills in the CLOB trade history, which are event-log-hash-chained and Merkle-batched. Reconstruct proofs client-side via /verify. Rebate math is deterministic — same fill inputs always produce the same rebate output.

What's not shipped in wave-1: live quote streaming (WS), real-time inventory tracking, spread-quality scoring, LP token rewards. These require a dedicated market-making infrastructure and ship in a future wave.