{
  "generated_at": "2026-04-24T15:01:35.625676+00:00",
  "slug": "hl-portfolio-production-up-railway-app-api-account",
  "title": "Hyperliquid Portfolio \u00b7 Account state fetch",
  "url": "https://hl-portfolio-production.up.railway.app/api/account",
  "category": "finance",
  "summary": "Retrieve complete Hyperliquid account state including total equity, open positions, and margin details for any wallet address.",
  "seo": {
    "title": "Hyperliquid Account API | DeFi Portfolio x402 on Base",
    "description": "Fetch Hyperliquid perpetual futures account value and positions for 0.003 USDC. DeFi portfolio API on Base via x402 protocol."
  },
  "use_cases": [
    "Monitor perpetual futures portfolio value",
    "Track open positions and unrealized PnL",
    "Calculate margin utilization ratios"
  ],
  "ideal_buyer": "Hyperliquid traders and portfolio management tools needing real-time account state for position tracking.",
  "example_prompt": "Get the current account value and all open positions for Hyperliquid wallet 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "example_request_body": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  },
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "cheap_outlier",
    "ratio": 0.1,
    "median_category_atomic": 30000
  },
  "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": [
              "address"
            ],
            "properties": {
              "address": {
                "type": "string",
                "description": "Hyperliquid wallet address (0x...) to retrieve account state for"
              }
            }
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "output": {
          "type": "json",
          "schema": {
            "type": "object",
            "required": [
              "accountValue",
              "positions"
            ],
            "properties": {
              "positions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "coin": {
                      "type": "string"
                    },
                    "size": {
                      "type": "string"
                    },
                    "leverage": {
                      "type": "number"
                    },
                    "entryPrice": {
                      "type": "string"
                    },
                    "marginType": {
                      "type": "string"
                    },
                    "unrealizedPnl": {
                      "type": "string"
                    },
                    "liquidationPrice": {
                      "type": "string"
                    }
                  }
                }
              },
              "totalNtlPos": {
                "type": "string",
                "description": "Total notional position size"
              },
              "accountValue": {
                "type": "string",
                "description": "Total account equity in USD"
              },
              "withdrawable": {
                "type": "string",
                "description": "Available balance"
              },
              "totalMarginUsed": {
                "type": "string",
                "description": "Margin locked in positions"
              }
            }
          },
          "example": {}
        }
      }
    }
  ],
  "duplicate_cluster_id": "finance-cl-f1ba9abc81bb",
  "origin": {
    "slug": "hl-portfolio-production-up-railway-app",
    "host": "hl-portfolio-production.up.railway.app",
    "title": "hl-portfolio-production",
    "description": "An x402-payable API origin hosted on Railway. No application is currently deployed at this endpoint.",
    "url": "https://hl-portfolio-production.up.railway.app",
    "favicon": "https://hl-portfolio-production.up.railway.app/favicon.ico"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/hl-portfolio-production-up-railway-app-api-account",
    "url": "https://x402all.com/resource/hl-portfolio-production-up-railway-app-api-account",
    "name": "Hyperliquid Portfolio \u00b7 Account state fetch",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/hl-portfolio-production-up-railway-app-api-account",
      "@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://hl-portfolio-production.up.railway.app/api/account",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/hl-portfolio-production-up-railway-app",
      "url": "https://hl-portfolio-production.up.railway.app",
      "name": "hl-portfolio-production",
      "@type": "Organization"
    },
    "identifier": "hl-portfolio-production-up-railway-app-api-account",
    "description": "Fetch Hyperliquid perpetual futures account value and positions for 0.003 USDC. DeFi portfolio API on Base via x402 protocol.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=hl-portfolio-production-up-railway-app-api-account",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "finance"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=hl-portfolio-production-up-railway-app-api-account"
}