Performance Reporting

Blocksight uses a push-only model for performance monitoring. Market Makers configure their internal systems to send standardized trade and quote event payloads to dedicated webhooks every 10 minutes.

Authentication

All requests require two headers:

Network Access Control

We support static IP whitelisting. If you provide your outbound static IP addresses, we will configure our firewalls to block any requests originating from unauthorized locations before they reach the verification API.

Key Distribution

For initial onboarding, your Client ID and API Key will be shared via a secure, encrypted note-sharing platform (e.g., 1Password). These should be treated as sensitive credentials.

Future Capability

We are developing a feature that will allow MMs to generate, revoke, and manage their API keys directly within the Blocksight platform interface.

Endpoint

Event Types

Quote Update

Report your current bid/ask quotes. Send these at regular intervals — e.g. every 10 minutes — to track uptime and spread performance.

{
  "event_type": "quote_update",
  "event_id": "unique-event-id-123",
  "timestamp": "2024-12-17T10:30:00.000Z",
  "exchange": "Binance",
  "base_asset": "TOKEN",
  "quote_asset": "USDT",
  "exchange_best_bid": 0.99,
  "exchange_best_ask": 1.01,
  "exchange_mid_price": 1.00
}

Depth Snapshot

Report your order book depth at various basis point levels from mid price.

{
  "event_type": "depth_snapshot",
  "event_id": "unique-event-id-456",
  "timestamp": "2024-12-17T10:30:00.000Z",
  "exchange": "Binance",
  "base_asset": "TOKEN",
  "quote_asset": "USDT",
  "mm_best_bid": 1.00,
  "mm_best_ask": 1.00,
  "mm_bid_size": 10000,
  "mm_ask_size": 10000,
  "depth_metrics": [
    {
      "bps": 25,
      "bid_depth": 25000,
      "bid_depth_notional": 25000,
      "ask_depth": 25000,
      "ask_depth_notional": 25000,
      "total_depth": 50000,
      "total_depth_notional": 50000
    },
    {
      "bps": 50,
      "bid_depth": 50000,
      "bid_depth_notional": 50000,
      "ask_depth": 50000,
      "ask_depth_notional": 50000,
      "total_depth": 100000,
      "total_depth_notional": 100000
    },
    {
      "bps": 100,
      "bid_depth": 100000,
      "bid_depth_notional": 100000,
      "ask_depth": 100000,
      "ask_depth_notional": 100000,
      "total_depth": 200000,
      "total_depth_notional": 200000
    },
    {
      "bps": 200,
      "bid_depth": 200000,
      "bid_depth_notional": 200000,
      "ask_depth": 200000,
      "ask_depth_notional": 200000,
      "total_depth": 400000,
      "total_depth_notional": 400000
    }
  ]
}

Depth Metric Fields:

Response Codes

Integration Requirements

• Send events every 10 minutes — Regular reporting is required to accurately track uptime and spread performance.
• Ensure idempotency with UUIDs — Include a unique, client-generated event_id (UUID) in every payload. This allows Blocksight to process the same event multiple times without creating duplicate records.
• Implement exponential backoff — Market Makers are responsible for internal delivery resilience. If a request fails due to transient errors (e.g., network timeouts or 5xx errors), you must retry with increasing delays.
• Rely on timestamps for consistency — Due to retries, events may arrive out of order. Blocksight uses the timestamp field to maintain temporal accuracy and ensure eventual data consistency.
• Standardized asset strings — Ensure asset symbols are sent in all-caps (e.g., BTC, USDT).
• Supported exchange names — The exchange field must match one of our supported venues (e.g., "Binance", "Bybit").
• Snapshot reporting — All data reported must be a real-time snapshot at the time that the event is sent. Do not send time-averaged or aggregated values.

Example Request

curl -X POST https://app.blocksight.xyz/api/market-maker/event \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -H "x-client-id: your-client-id" \
  -d '{
    "event_type": "quote_update",
    "event_id": "93b4a2d3-1f8e-4a7b-a01c-0b7c8e9f0d12",
    "timestamp": "2025-11-10T14:30:00.000Z",
    "exchange": "Coinbase",
    "base_asset": "TOKEN",
    "quote_asset": "USDT",
    "exchange_best_bid": 0.99,
    "exchange_best_ask": 1.01,
    "exchange_mid_price": 1.00
  }'