Ir al contenido
GET /v1/positioning

Three positioning cohorts side by side with the divergence

Pruébalo en vivo

10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.

Encabezados personalizados (opcional)
api.oanor.com/smartmoney-api

Funciona. Consigue una clave API y úsala en tu proyecto.

Obtener una clave API

Fragmentos de código

curl "https://api.oanor.com/smartmoney-api/v1/positioning" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/smartmoney-api/v1/positioning", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/smartmoney-api/v1/positioning");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/smartmoney-api/v1/positioning",
    headers={"x-oanor-key": "oanor_test_..."}
)

Respuesta de ejemplo

Una respuesta real de este endpoint, capturada en la última comprobación de estado.

{
    "data": {
        "note": "Three positioning cohorts from Binance futures, latest reading. retail_crowd is every account; top_traders_* are the top ~20% of accounts by margin balance (smart-money proxy), by account count and by position size. long_account_pct is the share positioned long. The divergence between top_traders_by_position and retail_crowd is the contrarian signal.",
        "period": "5m",
        "source": "Binance USDS-M futures",
        "symbol": "BTCUSDT",
        "cohorts": [
            {
                "label": "Global crowd (by accounts)",
                "cohort": "retail_crowd",
                "timestamp": 1781260200000,
                "is_smart_money": false,
                "long_account_pct": 60.2,
                "long_short_ratio": 1.5126,
                "short_account_pct": 39.8
            },
            {
                "label": "Top traders (by accounts)",
                "cohort": "top_traders_by_accounts",
                "timestamp": 1781260200000,
                "is_smart_money": true,
                "long_account_pct": 62.15,
                "long_short_ratio": 1.642,
                "short_account_pct": 37.85
            },
            {
                "label": "Top traders (by position size)",
                "cohort": "top_traders_by_position",
                "timestamp": 1781260200000,
                "is_smart_money": true,
                "long_account_pct": 54.79,
                "long_short_ratio": 1.2117,
                "short_account_pct": 45.21
            }
        ],
        "divergence": {
            "read": "Smart money and the crowd are positioned similarly — no strong divergence signal.",
            "signal": "aligned",
            "ratio_gap": -0.3009,
            "long_pct_gap": -5.41,
            "retail_long_pct": 60.2,
            "smart_money_long_pct": 54.79
        }
    },
    "meta": {
        "timestamp": "2026-06-12T10:35:27.228Z",
        "request_id": "be267660-c0d2-4ba4-ad98-c002cfcc1b57"
    },
    "status": "ok",
    "message": "Positioning retrieved successfully",
    "success": true
}