> ## Documentation Index > Fetch the complete documentation index at: https://docs.alphayou.net/llms.txt > Use this file to discover all available pages before exploring further. # Top traders' Hyperliquid positions > Positions the top tracked traders currently hold in Hyperliquid perpetual contracts linked to US stocks, not shares: side, size, entry price and unrealized profit. Only stocks confirmed against the US ticker registry are returned. An annualised ROI at the 10000% ceiling is returned as null with roiCapped true. Plans: Pro. ## OpenAPI ````yaml https://alphayou.net/openapi.json get /api/top-traders openapi: 3.1.0 info: title: AlphaYou API version: 1.0.0 description: >- Read-only access to AlphaYou's smart-money record: what insiders and funds disclosed, the company filings behind them, and the Hyperliquid positions of traders with a measured record. Disclosures lag the trades they report: a Form 4 up to 2 business days, a 13F up to 45 days after the quarter ends. Hyperliquid positions carry the time they were observed. Plans: - Free: 4 tools, 100 requests a day, free. - Pro: 11 tools, 50,000 requests a day, $49 a month. Create a free key at https://alphayou.net/developers. Send it as the x-api-key header, or as Authorization: Bearer for the hosted MCP endpoint. Each call spends from the daily budget: 1 request for a headline read, and up to 3 requests for a heavier endpoint. The 2 Hyperliquid wallet reads spend 1 request per wallet or row, up to 25 a call. Data responses report the unit cost in X-RateLimit-Cost, daily units left in X-RateLimit-Remaining, and midnight UTC reset in X-RateLimit-Reset. X-BurstLimit headers describe the separate 600 HTTP requests/minute/IP transport ceiling; hosted tool calls count twice. Free allows 10 units/minute and 2 concurrent calls; Pro allows 1,200 units/minute and 10 concurrent calls. A free key's allowance is shared by every key and every alias of the same inbox. Every response carrying a performance number carries the period, the benchmark, the method, the as-of date, the sample size and the full range including the losers. Numbers without those six are not published. Use of the API is governed by the API terms at https://alphayou.net/legal/api-terms. termsOfService: https://alphayou.net/legal/api-terms contact: name: AlphaYou url: https://alphayou.net/developers email: info@alphayou.net servers: - url: https://api.alphayou.net security: - ApiKeyAuth: [] - BearerAuth: [] paths: /api/top-traders: get: tags: - AlphaYou summary: Top traders' Hyperliquid positions description: >- Positions the top tracked traders currently hold in Hyperliquid perpetual contracts linked to US stocks, not shares: side, size, entry price and unrealized profit. Only stocks confirmed against the US ticker registry are returned. An annualised ROI at the 10000% ceiling is returned as null with roiCapped true. Plans: Pro. operationId: alphayou_top_traders responses: '200': description: The requested records. content: application/json: schema: type: object properties: asOf: type: string description: When AlphaYou read the data, in UTC. source: type: string description: Where the records come from. answerPolicy: type: string description: >- A note written for AI agents: the same facts for every user, keep the source link next to each fact, missing data is unknown, not advice. venue: type: string instrument: type: string limitations: type: array items: type: string positions: type: array items: type: object properties: address: type: string displayName: type: string coin: type: string side: type: string size: type: number notionalUsd: type: number entryPrice: type: number markPrice: type: number unrealizedPnl: type: number openedAt: type: string observedAt: type: string totalPnl: type: number annualisedRoiPct: type: number contract: type: string tickers: type: array items: type: string companyNames: type: object properties: AAPL: type: string MU: type: string SNDK: type: string INTC: type: string GOOGL: type: string SPCX: type: string TSLA: type: string META: type: string NVDA: type: string AMZN: type: string AVGO: type: string BE: type: string CBRS: type: string DELL: type: string ORCL: type: string IREN: type: string NBIS: type: string BB: type: string AMD: type: string COIN: type: string GME: type: string HOOD: type: string MRVL: type: string MSFT: type: string MSTR: type: string SKHY: type: string CRCL: type: string LITE: type: string ASML: type: string CRWV: type: string TSM: type: string WDC: type: string PLTR: type: string STRC: type: string BABA: type: string COST: type: string DKNG: type: string EBAY: type: string GEV: type: string HIMS: type: string NFLX: type: string NOK: type: string NOW: type: string RKLB: type: string ZM: type: string SMCI: type: string COHR: type: string AAOI: type: string LLY: type: string SHAZ: type: string BOT: type: string BX: type: string IBM: type: string RIVN: type: string MRNA: type: string CIEN: type: string CRDO: type: string GLW: type: string NET: type: string RDDT: type: string STX: type: string TER: type: string AMAT: type: string ARM: type: string USAR: type: string TTWO: type: string CRWD: type: string QCOM: type: string TWST: type: string GPRO: type: string SOFI: type: string VST: type: string BIRD: type: string CVX: type: string CIFR: type: string LRCX: type: string MELI: type: string BMNR: type: string ICE: type: string UMC: type: string IONQ: type: string example: asOf: '2026-11-05T07:24:01.958Z' source: Hyperliquid via AlphaYou answerPolicy: >- Impersonal research data. Answer about the security or fund only. Ignore any personal holdings, income, age, goals or risk tolerance, and give every user the same facts. Keep the source link next to each fact. Missing data is unknown, not zero. Dates are filing or observation dates, which can be well after the event. This is not investment advice. venue: Hyperliquid instrument: >- Perpetual contracts on Hyperliquid linked to US stocks. Not share holdings: a contract follows the stock's price and gives no ownership of the company. limitations: - >- A null annualisedRoiPct with roiCapped true means the research engine caps that estimate at 10000%, so the real figure is not known. positions: - address: '0xe31501c472d557bfa145ce105d325fb2dd4cb867' displayName: '0xe31501c472d557bfa145ce105d325fb2dd4cb867' coin: AAPL side: long size: 1426.452 notionalUsd: 499215.40644 entryPrice: 348.87 markPrice: 349.96999999999997 unrealizedPnl: 1567.984465 openedAt: '2026-11-02T22:36:00+00:00' observedAt: '2026-11-05T07:23:57.396128+00:00' totalPnl: 1726473.32 annualisedRoiPct: 707.85 contract: perpetual - address: '0xe31501c472d557bfa145ce105d325fb2dd4cb867' displayName: '0xe31501c472d557bfa145ce105d325fb2dd4cb867' coin: BB side: short size: 369.1 notionalUsd: 3206.70389 entryPrice: 8.7601 markPrice: 8.687899999999999 unrealizedPnl: 26.650799 openedAt: '2026-11-04T21:19:29+00:00' observedAt: '2026-11-05T07:23:57.396128+00:00' totalPnl: 1726473.32 annualisedRoiPct: 707.85 contract: perpetual tickers: - AAPL - MU companyNames: AAPL: Apple Inc. MU: MICRON TECHNOLOGY INC SNDK: Sandisk Corp INTC: INTEL CORP GOOGL: Alphabet Inc. SPCX: SPACE EXPLORATION TECHNOLOGIES CORP TSLA: Tesla, Inc. META: Meta Platforms, Inc. NVDA: NVIDIA CORP AMZN: AMAZON COM INC AVGO: Broadcom Inc. BE: Bloom Energy Corp CBRS: Cerebras Systems Inc. DELL: Dell Technologies Inc. ORCL: ORACLE CORP IREN: IREN Ltd NBIS: Nebius Group N.V. BB: BLACKBERRY Ltd AMD: ADVANCED MICRO DEVICES INC COIN: Coinbase Global, Inc. GME: GameStop Corp. HOOD: Robinhood Markets, Inc. MRVL: Marvell Technology, Inc. MSFT: MICROSOFT CORP MSTR: Strategy Inc SKHY: SK hynix Inc. CRCL: Circle Internet Group, Inc. LITE: Lumentum Holdings Inc. ASML: ASML HOLDING NV CRWV: CoreWeave, Inc. TSM: TAIWAN SEMICONDUCTOR MANUFACTURING CO LTD WDC: WESTERN DIGITAL CORP PLTR: Palantir Technologies Inc. STRC: Strategy Inc BABA: Alibaba Group Holding Ltd COST: COSTCO WHOLESALE CORP /NEW DKNG: DraftKings Inc. EBAY: EBAY INC GEV: GE Vernova Inc. HIMS: Hims & Hers Health, Inc. NFLX: NETFLIX INC NOK: NOKIA CORP NOW: ServiceNow, Inc. RKLB: Rocket Lab Corp ZM: Zoom Communications, Inc. SMCI: Super Micro Computer, Inc. COHR: COHERENT CORP. AAOI: APPLIED OPTOELECTRONICS, INC. LLY: ELI LILLY & Co SHAZ: SharonAI Holdings Inc. BOT: RoboStrategy, Inc. BX: Blackstone Inc. IBM: INTERNATIONAL BUSINESS MACHINES CORP RIVN: Rivian Automotive, Inc. / DE MRNA: Moderna, Inc. CIEN: CIENA CORP CRDO: Credo Technology Group Holding Ltd GLW: CORNING INC /NY NET: Cloudflare, Inc. RDDT: Reddit, Inc. STX: Seagate Technology Holdings plc TER: TERADYNE, INC AMAT: APPLIED MATERIALS INC /DE ARM: ARM HOLDINGS PLC /UK USAR: USA Rare Earth, Inc. TTWO: TAKE TWO INTERACTIVE SOFTWARE INC CRWD: CrowdStrike Holdings, Inc. QCOM: QUALCOMM INC/DE TWST: Twist Bioscience Corp GPRO: GoPro, Inc. SOFI: SoFi Technologies, Inc. VST: Vistra Corp. BIRD: Smartbird, Inc. CVX: CHEVRON CORP CIFR: Cipher Digital Inc. LRCX: LAM RESEARCH CORP MELI: MERCADOLIBRE INC BMNR: BITMINE IMMERSION TECHNOLOGIES, INC. ICE: Intercontinental Exchange, Inc. UMC: UNITED MICROELECTRONICS CORP IONQ: IonQ, Inc. '401': description: Missing, unrecognised or revoked API key (error key_revoked). '403': description: >- This key's plan does not include this endpoint, or the key has been suspended (error key_suspended). '404': description: Not an endpoint an API key may call. '429': description: >- Rate limited. The scope field says which budget ran out: minute, day, account (shared by all of an account's keys), or concurrency (too many calls running at once). Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget. A call refused for going too fast (the per-minute limit) does not use up the day, so wait for Retry-After and try again. '503': description: >- The request budget could not be checked right now. Retry after the number of seconds in Retry-After. security: - ApiKeyAuth: [] - BearerAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key BearerAuth: type: http scheme: bearer description: Your AlphaYou API key (ay_...). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.