{"openapi":"3.1.0","info":{"title":"AlphaYou API","version":"1.0.0","description":"Read-only access to AlphaYou's smart-money record: what insiders, funds and politicians disclosed, what AlphaYou published on the back of it, and how those calls turned out against the S&P 500.\n\nThe thing no comparable API sells is the last part. Others will tell you what was filed. This tells you which sources have historically been worth following, with the evidence attached.\n\nPlans:\n- Free: 3 tools, 500 requests a day, free.\n- Starter: 5 tools, 10,000 requests a day, $29 a month.\n- Scale: 7 tools, 50,000 requests a day, $79 a month.\n\nCreate a free key at https://alphayou.net/developers. Send it as the x-api-key header.\n\nEvery 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.","contact":{"name":"AlphaYou","url":"https://alphayou.net/developers"}},"servers":[{"url":"https://api-production-1187.up.railway.app"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/api/mcp/whoami":{"get":{"operationId":"whoami","summary":"What this key can do","description":"Returns the tier a key resolves to and the tools it may call. The published MCP package calls this at startup to decide which tools to register, so it answers on the lowest tier.\n\nPlans: Free, Starter, Scale.","tags":["AlphaYou"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"The requested records."},"401":{"description":"Missing or unrecognised API key."},"403":{"description":"This key's plan does not include this endpoint."},"404":{"description":"Not an endpoint an API key may call."},"429":{"description":"Rate limited. Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget."}}}},"/api/signals/alpha":{"get":{"operationId":"alphayou_track_record","summary":"Headline track record","description":"The complete published record of AlphaYou buy calls: how many there are, how they performed against the S&P 500 over their own horizon, the best and the worst, and how many finished negative.\n\nPlans: Free, Starter, Scale.","tags":["AlphaYou"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"The requested records."},"401":{"description":"Missing or unrecognised API key."},"403":{"description":"This key's plan does not include this endpoint."},"404":{"description":"Not an endpoint an API key may call."},"429":{"description":"Rate limited. Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget."}}}},"/api/signals/recent":{"get":{"operationId":"alphayou_calls","summary":"Recent buy calls","description":"Published buy calls, newest first. On a free key these are delayed by 24 hours; a paid key sees them as published.\n\nPlans: Free, Starter, Scale.","tags":["AlphaYou"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"The requested records."},"401":{"description":"Missing or unrecognised API key."},"403":{"description":"This key's plan does not include this endpoint."},"404":{"description":"Not an endpoint an API key may call."},"429":{"description":"Rate limited. Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget."}}}},"/api/signals/actors/track-record":{"get":{"operationId":"alphayou_actor_track_record","summary":"Track record by actor","description":"Realised return and margin over the benchmark for an individual politician, insider or fund, measured from the day each of their trades became public.\n\nPlans: Starter, Scale.","tags":["AlphaYou"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"window","in":"query","required":false,"description":"Measurement window.","schema":{"type":"string"}},{"name":"min","in":"query","required":false,"description":"Minimum trades to report a row.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum rows.","schema":{"type":"string"}}],"responses":{"200":{"description":"The requested records."},"401":{"description":"Missing or unrecognised API key."},"403":{"description":"This key's plan does not include this endpoint."},"404":{"description":"Not an endpoint an API key may call."},"429":{"description":"Rate limited. Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget."}}}},"/api/signals/sources/track-record":{"get":{"operationId":"alphayou_source_track_record","summary":"Track record by source","description":"Which kinds of evidence have actually predicted a move, grouped by source or by source type. This is the scoreboard behind the public one, and the thing no comparable API sells.\n\nPlans: Scale.","tags":["AlphaYou"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"window","in":"query","required":false,"description":"Measurement window.","schema":{"type":"string"}},{"name":"grouping","in":"query","required":false,"description":"source or source_type.","schema":{"type":"string"}},{"name":"min","in":"query","required":false,"description":"Minimum observations to report a row.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum rows.","schema":{"type":"string"}}],"responses":{"200":{"description":"The requested records."},"401":{"description":"Missing or unrecognised API key."},"403":{"description":"This key's plan does not include this endpoint."},"404":{"description":"Not an endpoint an API key may call."},"429":{"description":"Rate limited. Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget."}}}},"/api/signals/recommendations/{id}/receipt":{"get":{"operationId":"alphayou_signal_receipt","summary":"Proof receipt for one call","description":"The full evidence chain behind a single published call: the source events that contributed, the checkpoints, and when each was recorded.\n\nPlans: Scale.","tags":["AlphaYou"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Recommendation id.","schema":{"type":"string"}}],"responses":{"200":{"description":"The requested records."},"401":{"description":"Missing or unrecognised API key."},"403":{"description":"This key's plan does not include this endpoint."},"404":{"description":"Not an endpoint an API key may call."},"429":{"description":"Rate limited. Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget."}}}}}}