> ## 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. # What data exists > The catalog of datasets and the tool that returns each one, with its plan and cost. Costs no requests, so an agent can call it first to decide what to call next. Optional q filters by a word. Plans: Free, Pro. ## OpenAPI ````yaml https://alphayou.net/openapi.json get /api/v1/datasets 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/v1/datasets: get: tags: - AlphaYou summary: What data exists description: >- The catalog of datasets and the tool that returns each one, with its plan and cost. Costs no requests, so an agent can call it first to decide what to call next. Optional q filters by a word. Plans: Free, Pro. operationId: alphayou_search_datasets parameters: - name: q in: query required: false description: Filter the list by a word (up to 60 characters). schema: type: string 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. count: type: number description: How many rows this response holds. datasets: type: array items: type: object properties: id: type: string name: type: string description: type: string tool: type: string method: type: string endpoint: type: string plan: type: string costRequests: type: number source: type: string refresh: type: string example: asOf: '2026-11-05T07:20:54.350Z' source: 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. count: 9 datasets: - id: datasets name: Dataset catalog description: 'This list: what data exists and which tool returns it.' tool: alphayou_search_datasets method: GET endpoint: /api/v1/datasets plan: free costRequests: 0 source: AlphaYou refresh: Changes when a dataset ships. - id: funds name: Tracked funds description: >- Institutional investment managers whose Form 13F filings AlphaYou tracks: latest reporting period, filing date, position count, reported total value and the SEC filing link. tool: alphayou_funds method: GET endpoint: /api/v1/funds plan: free costRequests: 1 source: SEC EDGAR Form 13F-HR refresh: Quarterly, up to 45 days after quarter end. '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.