MPPtempoquality 0.88

Real-time smart money perpetual trades on Hyperliquid from Nansen's labeled wallet database.

Price
$0.05 / call
Protocol
mpp
Verified
no
Endpoint
https://api.nansen.ai/api/v1/smart-money/perp-trades

What it does

This endpoint returns granular, transaction-level perpetual trading activity from Nansen-labeled smart money wallets on Hyperliquid. Each record includes the trader address and label, coin symbol, trade amount, price, USD value, side (Long/Short), action (Open/Add/Close/Reduce), and order type (Market/Limit). An optional `only_new_positions` flag restricts results to position-opening trades.

The endpoint is part of Nansen's broader API (v1, OpenAPI 3.1.0) which spans smart money analytics, wallet profiling, Token God Mode, prediction markets, and an AI research agent. It accepts a POST with a JSON body containing optional filters (smart money labels, token symbol, side, action, type, price/value ranges), pagination, and sort order. Responses include pagination metadata and rate-limit headers. The endpoint costs 50 free-tier credits or 5 pro-tier credits per call, and also supports pay-per-request via the x402 protocol at $0.05 per call.

The probe confirmed the endpoint is live (HTTP 402 on HEAD, consistent with x402 payment challenge). A full OpenAPI spec with detailed request/response schemas is available at the origin.

Capabilities

smart-money-perp-tradeshyperliquid-perpetualswallet-labelingtrade-filteringpaginationsort-orderx402-paymentrate-limitingsmart-money-labels

Use cases

  • —Monitor what Nansen-labeled smart money wallets are trading on Hyperliquid perpetuals in real time
  • —Filter for new position openings by funds or smart traders to detect early directional bets
  • —Build automated alerts when smart money opens large Long or Short positions on specific coins
  • —Backtest trading strategies by analyzing historical smart money perp trade patterns
  • —Integrate smart money perp signals into a trading bot or portfolio dashboard

Fit

Best for

  • —Crypto traders tracking smart money perpetual positions on Hyperliquid
  • —Quantitative researchers building alpha signals from labeled wallet activity
  • —DeFi analytics dashboards needing real-time perp trade feeds
  • —Trading bots that react to smart money position changes

Not for

  • —Spot DEX trade data (use the /smart-money/dex-trades endpoint instead)
  • —Historical multi-year backtesting (data is recent/real-time focused)
  • —Non-Hyperliquid perpetual exchanges

Quick start

curl -X POST https://api.nansen.ai/api/v1/smart-money/perp-trades \
  -H 'Content-Type: application/json' \
  -H 'apiKey: YOUR_API_KEY' \
  -d '{
    "filters": {"token_symbol": "BTC", "side": "Long"},
    "pagination": {"page": 1, "per_page": 10}
  }'

Example

Request

{
  "filters": {
    "side": "Long",
    "type": "Market",
    "value_usd": {
      "min": 1000
    },
    "token_symbol": "BTC"
  },
  "order_by": [
    {
      "field": "block_timestamp",
      "direction": "DESC"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "only_new_positions": false
}

Response

{
  "data": [
    {
      "side": "Long",
      "type": "Market",
      "action": "Add",
      "price_usd": 105000,
      "value_usd": 52500,
      "token_amount": 0.5,
      "token_symbol": "BTC",
      "trader_address": "0xa312114b5795dff9b8db50474dd57701aa78ad1e",
      "block_timestamp": "2025-07-15T14:30:00Z",
      "transaction_hash": "0xabc123...",
      "trader_address_label": "Smart HL Perps Trader [0xa312]"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": false
  }
}

Endpoint

URLhttps://api.nansen.ai/api/v1/smart-money/perp-trades
Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.88/ 1.00

Full OpenAPI 3.1.0 schema with detailed request/response models, clear pricing ($0.05/call via x402), and a confirmed live 402 challenge. Docs pages at the origin return 404 so external documentation is thin, but the OpenAPI spec itself is comprehensive.

Warnings

  • —No standalone documentation pages found at api.nansen.ai/docs or similar — all info derived from OpenAPI spec
  • —Response schema references ($ref SmartMoneyPerpTradesResponse) were not fully resolved in the probe, so exact response field names are inferred from the OpenAPI components

Citations

Provenance

Indexed frommpp_dev
Enriched2026-04-19 15:54:23Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/mw3t7V