API Docs

BTC liquidation max pain API · Bearer API key authentication

Back to Dashboard Pro Management

Authentication

All paid API requests must include:

Authorization: Bearer YOUR_API_KEY

The server stores only the API key sha256 hash and prefix. Raw keys are never stored in plaintext.

GET /api/v1/liquidation-pain

Returns BTC real-time price, 12h liquidation max pain, long and short pain distance, liquidation amount, and AI agent direction forecast.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://qorav.com/api/v1/liquidation-pain"

Response Example

{
  "ok": true,
  "data": {
    "market": {
      "symbol_spot": "BTC-USDT",
      "last_price": 61430.1
    },
    "max_pain": {
      "range": "12h",
      "long_max_pain_price": 61046.64,
      "short_max_pain_price": 62099.58,
      "long_max_pain_level": 21826229.54,
      "short_max_pain_level": 21583416.89,
      "analysis": {
        "dominant_liquidation_side": "long",
        "long_side_probability": 0.63,
        "short_side_probability": 0.37
      }
    },
    "agent_prediction": {
      "bias": "中文多空分析",
      "conf": 0.61
    }
  },
  "usage": {
    "used": 12,
    "remaining": 9988,
    "quota": 10000,
    "period_end": "2026-07-11T00:00:00+00:00"
  }
}

GET /api/v1/me

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://qorav.com/api/v1/me"

Checks the current API key, subscription plan, quota, and remaining usage.

API Key Management

Key management endpoints also require an active API key, but they do not consume data API quota.

# List keys
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://qorav.com/api/keys"

# Create a new key. The raw key is shown only once.
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Prod Key"}' \
  "https://qorav.com/api/keys"

# Revoke a key
curl -X DELETE -H "Authorization: Bearer YOUR_API_KEY" \
  "https://qorav.com/api/keys/KEY_ID"

Error Codes