Home
Platform&Services
Investors
Documentation
Company

API Reference

FUZE.ac Platform API

API Reference

FUZE.ac Platform API

Programmatic access to FUZE.ac’s core services: AI‑powered market making, KPI compliance monitoring, unlock management, and more. Integrate, automate, and monitor all from your own infrastructure.

Authentication & Security

All endpoints require an API key. Tokens are non‑custodial—FUZE.ac never holds your funds; we simply relay instructions to your exchange accounts.

1.1 Obtain API Key

  1. Log in to the FUZE.ac Dashboard.
  2. Navigate to Settings → API Keys.
  3. Generate a new key; copy your API_KEY.

1.2 Using the Key

Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

All calls are over HTTPS and rate‑limited for fair usage.

API Endpoints

Market Making Engine Endpoints

Control and monitor your AI MM bots across exchanges.

POST/v1/bots/start

Starts a new market making bot.

Example Body:

{
  "exchange_id": "binance",
  "pair": "FUZE/USDT",
  "strategy_mode": "VolumeBoost",
  "depth_target_pct": 1,
  "spread_target_pct": 0.02
}

Returns:

201 Created with bot_id and initial status.
POST/v1/bots/stop

Stops an active bot.

Example Body:

{
  "bot_id": "abc123"
}

Returns:

200 OK on success.
POST/v1/bots/update_strategy

Changes the strategy for a running bot.

Example Body:

{
  "bot_id": "abc123",
  "new_strategy_mode": "DumpRecovery"
}

Returns:

Updated strategy_mode in bot status.
GET/v1/bots/{bot_id}/status

Retrieves the status for a specific bot.

Parameters:

bot_id

Returns:

JSON object with current mode, PnL, spread, depth, uptime.

KPI & Compliance API

Fetch real‑time and historical KPI data for your token listings.

GET/v1/kpi/realtime

Fetches current KPIs for a token pair.

Parameters:

exchange_id=gatepair=FUZE/USDT

Returns:

{
  "daily_volume_usd": 32000,
  "avg_spread_pct": 1.8,
  "depth_ratio": 6.5,
  "price_retention_pct": 85.2
}
GET/v1/kpi/history

Retrieves historical KPI data.

Parameters:

exchange_id=gatepair=FUZE/USDTstart_date=2025-06-01end_date=2025-06-30

Returns:

Array of timestamped KPI snapshots.

Unlock Schedule API

Manage vesting and unlock events programmatically.

POST/v1/unlocks/schedule

Schedules a new unlock event.

Example Body:

{
  "group_name": "Seed Investors",
  "unlock_date": "2025-12-15T00:00:00Z",
  "token_amount": 25000000
}

Returns:

201 Created with event ID.
GET/v1/unlocks

Lists all upcoming and historical unlock events.

Returns:

List of unlock events with status.

Rate Limits & SDKs

Rate Limits: Default 100 requests/min per key; see X-RateLimit-* headers.

SDKs: Official JavaScript/TypeScript and Python SDKs coming soon—streamlining authentication, retries, and pagination.

Error Handling

Standardized HTTP status codes and error format:

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "retry_after": 60
  }
}

For the full API specification, including WebSocket streams and advanced parameters, refer to the OpenAPI schema in the Downloads section.