{
  "generated_at": "2026-04-24T15:01:35.625676+00:00",
  "slug": "hyperliquid-whales-production-up-railway-app-api-positions",
  "title": "Hyperliquid Whales \u00b7 Query Whale Position Aggregates",
  "url": "https://hyperliquid-whales-production.up.railway.app/api/positions",
  "category": "data",
  "summary": "Returns whale position aggregates for Hyperliquid perp markets with optional coin filtering.",
  "seo": {
    "title": "Hyperliquid Whale Positions API | x402 Data Feed",
    "description": "Query aggregated whale positions on Hyperliquid perp markets. Filter by coin symbol. x402 micropayment: $0.003 USDC per call on Base."
  },
  "use_cases": [
    "Analyze whale concentration in specific perp markets",
    "Track large position movements across coins",
    "Build whale alert systems for trading signals",
    "Research market sentiment via position sizing"
  ],
  "ideal_buyer": "Quantitative traders and DeFi analysts building whale monitoring tools for Hyperliquid markets.",
  "example_prompt": "Show me the current whale position aggregates for BTC and ETH on Hyperliquid.",
  "example_request_body": {
    "coin": "BTC"
  },
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "cheap",
    "ratio": 0.15,
    "median_category_atomic": 20000
  },
  "pricing_review_required": false,
  "pricing_decimal_suspect": false,
  "trust_tier": "indexed_external",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "pay_to": "0x6e8b64638b24c6d625b045dd353120d850064e2e",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "max_amount_required_atomic": "3000",
      "max_timeout_seconds": 300,
      "verified": false,
      "hints": {
        "input": {
          "body": {
            "type": "object",
            "required": [],
            "properties": {
              "coin": {
                "type": "string",
                "description": "Filter by coin symbol (e.g. BTC, ETH, SOL). Optional \u00e2\u0080\u0094 returns all coins if omitted."
              }
            }
          },
          "type": "http",
          "method": "GET",
          "bodyType": "json"
        },
        "output": {
          "type": "json",
          "schema": {
            "type": "object",
            "required": [
              "chain",
              "results",
              "aggregates"
            ],
            "properties": {
              "chain": {
                "type": "string",
                "description": "Chain (hyperliquid)"
              },
              "results": {
                "type": "number",
                "description": "Number of whale aggregates"
              },
              "timestamp": {
                "type": "string"
              },
              "aggregates": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "coinFilter": {
                "type": "string",
                "description": "Coin filter applied"
              },
              "totalTraders": {
                "type": "number",
                "description": "Total traders analyzed"
              },
              "overallSentiment": {
                "type": "string",
                "description": "Overall market sentiment"
              },
              "tradersWithPositions": {
                "type": "number"
              }
            }
          },
          "example": {}
        }
      }
    }
  ],
  "origin": {
    "slug": "hyperliquid-whales-production-up-railway-app",
    "host": "hyperliquid-whales-production.up.railway.app",
    "title": "Hyperliquid Whales API",
    "description": "An x402-payable API origin on Railway. No public homepage is currently available; endpoints may be accessed directly.",
    "url": "https://hyperliquid-whales-production.up.railway.app",
    "favicon": "https://hyperliquid-whales-production.up.railway.app/favicon.ico"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/hyperliquid-whales-production-up-railway-app-api-positions",
    "url": "https://x402all.com/resource/hyperliquid-whales-production-up-railway-app-api-positions",
    "name": "Hyperliquid Whales \u00b7 Query Whale Position Aggregates",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/hyperliquid-whales-production-up-railway-app-api-positions",
      "@type": "Offer",
      "price": "0.003",
      "availability": "https://schema.org/InStock",
      "priceCurrency": "USDC",
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "0.003000",
        "unitText": "call",
        "priceCurrency": "USDC"
      },
      "eligibleCustomerType": "Agent",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "paymentNetwork",
          "value": "base"
        },
        {
          "@type": "PropertyValue",
          "name": "paymentAsset",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ]
    },
    "sameAs": "https://hyperliquid-whales-production.up.railway.app/api/positions",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/hyperliquid-whales-production-up-railway-app",
      "url": "https://hyperliquid-whales-production.up.railway.app",
      "name": "Hyperliquid Whales API",
      "@type": "Organization"
    },
    "identifier": "hyperliquid-whales-production-up-railway-app-api-positions",
    "description": "Query aggregated whale positions on Hyperliquid perp markets. Filter by coin symbol. x402 micropayment: $0.003 USDC per call on Base.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=hyperliquid-whales-production-up-railway-app-api-positions",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "data"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=hyperliquid-whales-production-up-railway-app-api-positions"
}