Yubbit Derivatives Public API Perpetuals

This document describes the public REST endpoints that expose Yubbit derivatives data. All endpoints are unauthenticated and return application/json. The format is suitable for integration with derivatives data aggregators.

Base URL

Endpoints Overview

Endpoint Description Example
GET /contracts Summary of all derivative contracts traded on Yubbit. https://api.yubbit.com/contracts
GET /contract-specs Contract specification details (same schema as /contracts). https://api.yubbit.com/contract-specs
GET /contract-depth/{ticker_id} Order book depth for the given derivative contract. https://api.yubbit.com/contract-depth/BTCUSDT_PERP?depth=50

Example: /contracts

{
  "ticker_id": "BTCUSDT_PERP",
  "base_currency": "USDT",
  "quote_currency": "BTC",
  "last_price": 68000.12,
  "base_volume": 1234567.89,
  "usd_volume": 1234567.89,
  "quote_volume": 180.45,
  "bid": 67995.10,
  "ask": 68002.50,
  "high": 69000.00,
  "low": 67000.00,
  "product_type": "Perpetual",
  "open_interest": 250000.00,
  "open_interest_usd": 250000.00,
  "index_price": 67998.30,
  "creation_timestamp": 0,
  "expiry_timestamp": 0,
  "funding_rate": 0.0001,
  "next_funding_rate": 0.0001,
  "next_funding_rate_timestamp": 1729260482034,
  "maker_fee": 0.02,
  "taker_fee": 0.06,
  "contract_type": "Vanilla",
  "contract_price": 68000.12,
  "contract_price_currency": "USDT"
}

Example: /contract-depth/BTCUSDT_PERP

{
  "ticker_id": "BTCUSDT_PERP",
  "timestamp": "1729259836182",
  "bids": [
    ["67995.10", "0.5"],
    ["67990.00", "1.2"]
  ],
  "asks": [
    ["68002.50", "0.4"],
    ["68010.00", "1.0"]
  ]
}