{"openapi":"3.1.0","info":{"title":"AlphaVision Developer API","description":"AlphaVision is a structured market-signal service. Signals are produced by a\nfine-tuned Vision Transformer that classifies market data heatmaps into\ndirectional outlooks across stocks, crypto, macro ETFs, sector rotation, and\nvolatility.\n\nThis API is **read-only, signal-only, and informational**. It places no trades\nand provides no personalized financial advice. Past performance does not\nguarantee future results.\n\n## Authentication\n\nPass an API key as a bearer token:\n\n```\nAuthorization: Bearer av_live_<your_key>\n```\n\nKeys are issued from your account page at\nhttps://alphavision.market/account.\nAnonymous access is permitted to SPY only.\n\n## Rate limits\n\nEach (key, ticker) pair has a 10-minute cooldown. The bulk `/v1/signals`\nendpoint has its own per-key 10-minute cooldown. Signals update weekly to\nquarterly — polling faster than this has no benefit.\n","version":"1"},"servers":[{"url":"https://api.alphavision.market"}],"paths":{"/v1/signals/{ticker}":{"get":{"tags":["v1"],"summary":"Get Signal","description":"Latest published signal for one ticker.","operationId":"get_signal_v1_signals__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"horizon","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter: weekly | monthly | quarterly | daily.","title":"Horizon"},"description":"Optional filter: weekly | monthly | quarterly | daily."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signal"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/signals":{"get":{"tags":["v1"],"summary":"List Signals","description":"Latest signal for every (model, ticker) pair the caller can access.","operationId":"list_signals_v1_signals_get","parameters":[{"name":"horizon","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional filter: weekly | monthly | quarterly | daily.","title":"Horizon"},"description":"Optional filter: weekly | monthly | quarterly | daily."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Signal"},"title":"Response List Signals V1 Signals Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tickers":{"get":{"tags":["v1"],"summary":"List Tickers","operationId":"list_tickers_v1_tickers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/TickerInfo"},"type":"array","title":"Response List Tickers V1 Tickers Get"}}}}}}},"/v1/me":{"get":{"tags":["v1"],"summary":"Get Me","operationId":"get_me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallerInfo"}}}}}}},"/v1/status":{"get":{"tags":["v1"],"summary":"Get Status","operationId":"get_status_v1_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusInfo"}}}}}}}},"components":{"schemas":{"CallerInfo":{"properties":{"authenticated":{"type":"boolean","title":"Authenticated"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Member email if authenticated; null for anonymous callers."},"tier":{"$ref":"#/components/schemas/Tier"},"key_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Prefix","description":"Display prefix of the API key in use; null for anonymous callers."},"cooldown_seconds":{"type":"integer","title":"Cooldown Seconds","description":"Minimum seconds between successive requests for the same (key, ticker)."},"bulk_cooldown_seconds":{"type":"integer","title":"Bulk Cooldown Seconds","description":"Minimum seconds between successive requests to /signals (bulk)."}},"type":"object","required":["authenticated","tier","cooldown_seconds","bulk_cooldown_seconds"],"title":"CallerInfo"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"RecentSignal":{"properties":{"signal_date":{"type":"string","title":"Signal Date","description":"ISO date the prediction was made (heatmap end_date)."},"signal":{"type":"string","title":"Signal","description":"BUY / SELL for directional, UP / DOWN for volatility."},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence","description":"Model confidence in the predicted direction (0.0–1.0)."}},"type":"object","required":["signal_date","signal"],"title":"RecentSignal"},"Signal":{"properties":{"ticker":{"type":"string","title":"Ticker"},"asset_class":{"type":"string","title":"Asset Class","description":"stocks | crypto | macro | volatility | sector"},"horizon":{"type":"string","title":"Horizon","description":"weekly | monthly | quarterly | daily"},"signal":{"type":"string","title":"Signal","description":"BUY / SELL for directional, UP / DOWN for volatility."},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"signal_date":{"type":"string","title":"Signal Date","description":"ISO date this signal was published (heatmap end_date)."},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid Until","description":"ISO date the holding period ends."},"next_signal_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Signal At","description":"ISO 8601 timestamp (Eastern Time) of the next scheduled signal publication."},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"launch_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch Date","description":"ISO date this model went live (predictions before this are backtest, after are live)."},"track_record":{"$ref":"#/components/schemas/TrackRecord"},"recent_signals":{"items":{"$ref":"#/components/schemas/RecentSignal"},"type":"array","title":"Recent Signals","description":"Up to the last 4 signals for this ticker, newest first."},"disclaimer":{"type":"string","title":"Disclaimer","default":"Informational only. Not financial advice. Do not execute trades without human review. Past performance does not guarantee future results."}},"type":"object","required":["ticker","asset_class","horizon","signal","confidence","signal_date","model_version","track_record"],"title":"Signal"},"StatusInfo":{"properties":{"asset_classes":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Asset Classes","description":"Mapping of asset_class → ISO 8601 timestamp of latest published signal."},"server_time":{"type":"string","title":"Server Time","description":"Current server time as ISO 8601 timestamp."}},"type":"object","required":["asset_classes","server_time"],"title":"StatusInfo"},"TickerInfo":{"properties":{"symbol":{"type":"string","title":"Symbol"},"asset_class":{"type":"string","title":"Asset Class"},"horizon":{"type":"string","title":"Horizon"},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"launch_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch Date"}},"type":"object","required":["symbol","asset_class","horizon","model_version","launch_date"],"title":"TickerInfo"},"Tier":{"properties":{"name":{"type":"string","title":"Name","description":"Free | Equity | Multi-Asset | Quant"},"asset_classes":{"items":{"type":"string"},"type":"array","title":"Asset Classes","description":"Asset classes this tier can access."}},"type":"object","required":["name","asset_classes"],"title":"Tier"},"TrackRecord":{"properties":{"sample_size":{"type":"integer","title":"Sample Size","description":"Number of resolved historical predictions for this ticker+model."},"win_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Win Rate","description":"Fraction of resolved predictions that were correct (0.0–1.0). Null when sample_size is 0."}},"type":"object","required":["sample_size"],"title":"TrackRecord"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}