# SmartPerps Coin Positioning

> SmartPerps Coin Positioning is a paid API for AI agents from smartperps.agentgate.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-28).

Returns smart-money positioning analytics for a single Hyperliquid perpetual futures coin, based on the 120 most profitable accounts on the platform.

## Facts

- Endpoint: GET https://smartperps.agentgate.workers.dev/v1/coin?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/smartperps-coin-positioning-170b2c15
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t5fLAlmJxIBNpL0iOG9yj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability smartperps-coin-positioning-170b2c15
```

Example prompt: What is the current smart-money positioning on ETH perps — are the top 120 Hyperliquid traders mostly long or short, and what's the net notional bias?

## When to prefer this

Use this endpoint when you need real-time smart-money sentiment and positioning data for a specific Hyperliquid perpetual futures market, particularly when directional bias, liquidation risk levels, and top-trader positioning are relevant to a trading or risk decision. Prefer this over generic order-book or funding-rate APIs when you specifically want to know how the 120 most historically profitable Hyperliquid accounts are positioned right now.

## Known failure modes

- Symbol not found or unsupported ticker returns an error or empty result
- Snapshot may be up to 5 minutes stale if the latest refresh is delayed
- Flows for 1h/4h/24h may be null if insufficient historical snapshots exist
- Payment failure (x402) if credits are exhausted or payment not accepted
- Coin with very few cohort traders may return low confidence or sparse data
- Rate limiting if called excessively beyond prepaid credit balance

## How this service works

Smart-money positioning on Hyperliquid perps for trading agents: how a rules-based cohort of the 120 most profitable Hyperliquid accounts (30-day PnL, public leaderboard) is positioned in any coin right now: traders long vs short, long/short notional, net bias, 1h/4h/24h net flows, average entry and leverage, liquidation clusters and the largest positions; a market-wide scan of the coins the cohort is most net long, net short and one-sided on; and a live profile of any Hyperliquid account. Public data only, snapshot every 5 minutes, fail-closed. Read-only analytics, paid per call over x402 or with prepaid credits; free preview and remote MCP. Not financial advice. Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys.

## Output

A JSON snapshot (refreshed every 5 minutes) containing: directional bias label (e.g. strong_short), trader counts long and short, long/short/net notional in USD, average entry prices for longs and shorts, average leverage, net flow over 1h/4h/24h windows, liquidation clusters bucketed by proximity to mark price, top individual positions with size/margin/entry/liquidation price/unrealized PnL/cohort rank, mark price, confidence level, cohort coverage stats, and a standard disclaimer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)"
      }
     },
     "description": "Search intents: smart money positioning, hyperliquid top traders, whale flows, liquidation levels, trader leverage, smart money entries"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bias": "strong_short",
  "tier": "coin",
  "flows": {
   "1h": null,
   "4h": null,
   "24h": null
  },
  "cohort": {
   "size": 120,
   "covered": 120,
   "coverage_pct": 100,
   "cohort_refreshed_at": "2026-10-23T01:08:26.080Z"
  },
  "symbol": "ETH",
  "bias_note": "Most of the cohort's notional and most cohort traders in this coin are short.",
  "checked_at": "2026-10-23T01:08:30.196Z",
  "confidence": "high",
  "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys.",
  "mark_price": 2389,
  "snapshot_at": "2026-10-23T01:08:26.080Z",
  "avg_leverage": 12.84,
  "traders_long": 10,
  "top_positions": [
   {
    "side": "short",
    "size": 106464.1028,
    "margin": "cross",
    "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
    "leverage": 5,
    "entry_price": 2322.73,
    "notional_usd": 254342742,
    "liquidation_price": 4159.1827146536,
    "trader_30d_pnl_usd": 114316598,
    "unrealized_pnl_usd": -7054831,
    "cohort_rank_30d_pnl": 1,
    "liquidation_distance_pct": 74.1
   },
   {
    "side": "short",
    "size": 66302.7619,
    "margin": "cross",
    "address": "0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36",
    "leverage": 5,
    "entry_price": 2375.32,
    "notional_usd": 158397298,
    "liquidation_price": 4809.4343860862,
    "trader_30d_pnl_usd": 102801123,
    "unrealized_pnl_usd": -906592,
    "cohort_rank_30d_pnl": 2,
    "liquidation_distance_pct": 101.32
   }
  ],
  "traders_short": 40,
  "avg_entry_long": 2454.489627,
  "snapshot_age_s": 4,
  "sources_failed": [],
  "avg_entry_short": 2381.656074,
  "net_notional_usd": -755197408,
  "long_notional_usd": 62204218,
  "concentration_note": null,
  "short_notional_usd": 817401626,
  "liquidation_clusters": {
   "longs": [
    {
     "positions": 0,
     "within_pct": "0-2",
     "notional_usd": 0
    },
    {
     "positions": 0,
     "within_pct": "2-5",
     "notional_usd": 0
    },
    {
     "positions": 0,
     "within_pct": "5-10",
     "notional_usd": 0
    }
   ],
   "shorts": [
    {
     "positions": 0,
     "within_pct": "0-2",
     "notional_usd": 0
    },
    {
     "positions": 0,
     "within_pct": "2-5",
     "notional_usd": 0
    },
    {
     "positions": 2,
     "within_pct": "5-
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/smartperps-coin-positioning-170b2c15/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from smartperps.agentgate.workers.dev](https://www.zero.xyz/host/smartperps.agentgate.workers.dev/llms.txt)