# Alpha Vantage

> alphavantage.co | Data APIs; 1 record: free tier, limits, identity cost and evidence.

HTML https://fshy.ajam.dev/p/alphavantage/ | JSON https://fshy.ajam.dev/api/v1/entity/alphavantage.json | how to read a record: https://fshy.ajam.dev/llms-full.txt

## Alpha Vantage

- `data-apis/alpha-vantage` | qualifies-with-caveat | evidence documented | binding request-rate | category market data API (stocks, forex, crypto, fundamentals, technical indicators) | tier free
- needs card no, phone no, ID no, institution no | verified 2026-11-03T00:27:51.441Z (live) | stale on 2026-12-04
- url https://www.alphavantage.co/support/
- free tier: 25 API requests per day on a free key, covering the majority of datasets; unlimited requests for verified open-source or educational projects | unit: requests | metered on: request-count | read on: 2026-10-30 | source: [1] | note: On a free key TIME_SERIES_DAILY returns only outputsize=compact, the latest 100 data points; outputsize=full needs a premium key. TIME_SERIES_WEEKLY and TIME_SERIES_MONTHLY are not marked premium and cover 25+ years of history per call. Intraday, daily adjusted, realtime bulk quotes and the index data endpoints are marked premium, and realtime and 15-minute delayed US market data is premium-only. Premium runs from 75 requests/min at USD 49.99/month to 1200 requests/min at USD 249.99/month, with no daily limit.
- per-object cap: one JSON or CSV response per call; a free key's daily series is the latest 100 data points (outputsize=compact) | source: [2] | note: The compact daily series for IBM under the demo key returned 21302 bytes of JSON with 100 data points.
- retention: not applicable
- egress: not metered in bytes; the 25 requests per day bound what a free key can pull | metered: no | source: [1]
- identity: email | detail: The free key form asks for a role (investor, software developer, educator, student, other), an organization and an email; it has no card and no phone field. The key is described as lifetime access. The documented demo key answered a TIME_SERIES_DAILY call for IBM with no signup.
- interface: rest
- limits:
  - request-rate (binding): 25 API requests per day per free key [1]
  - per-object-cap: latest 100 data points per daily series on a free key (outputsize=compact) [2]
- limits note: Bulk path: no bulk path on a free key. REALTIME_BULK_QUOTES, which accepts up to 100 tickers per request, is premium. LISTING_STATUS returns the active or delisted US stock and ETF list in one call.
- binding note: 25 requests a day is reached before any per-call cap matters; the compact cap binds only the daily series.
- interface detail: GET https://www.alphavantage.co/query with function, symbol and apikey; datatype=json (the default) or datatype=csv, which returns the series as a CSV file.
- endpoint: part of interface detail
- tooling: curl or any HTTP client; datatype=csv returns a CSV file per call
- composes with: One symbol per free call: weekly and monthly series give 25+ years each, the daily series only the latest 100 points. A wide ticker universe or full daily history needs a source with a bulk path, such as Massive flat files on its paid tiers.
- reliability: Realtime and 15-minute delayed US market data is premium-only.
- notes: The free key reaches the majority of datasets at 25 requests a day; the premium plans sell request rate, from 75 to 1200 per minute, plus the premium-marked endpoints.
- evidence note: The quota and the premium marks are documented on the support, premium and documentation pages. A demo-key probe returned 100 compact daily points; the 25-per-day cut-off needs a free key to measure.
- extras:
  - bulk_path: no bulk path
  - cutoff.http_status: 200 with a JSON body that names the limit in an Information field, not an HTTP error status (reported by third parties for the daily notice and measured for the per-second notice; no Alpha Vantage page states the status)
  - cutoff.body: a JSON object whose Information field reads: Thank you for using Alpha Vantage! Our standard API rate limit is 25 requests per day. Please subscribe to any of the premium plans at https://www.alphavantage.co/premium/ to instantly remove all daily rate limits. (reported by a third party)
  - cutoff.reset: unverified: behind a sign-up: no Alpha Vantage page states when the 25-per-day count resets, and a free key is needed to observe it
  - cutoff.burst: a JSON Information field that reads: Thank you for using Alpha Vantage! Please consider spreading out your free API requests more sparingly (1 request per second). You may subscribe to any of the premium plans at https://www.alphavantage.co/premium/ to lift the free key rate limit (25 requests per day), raise the per-second burst limit, and instantly unlock all premium endpoints; measured on simultaneous calls with one made-up key string, all but one of which got this notice
- evidence:
  - [1] 2026-10-30: the free key allows 25 API requests per day across the majority of datasets, and unlimited requests for verified open-source or educational projects | capture: sha256:6f82474b8fc7a791696c13926cbb14404e55af0b71b532d501dc39f59b260674 | quote: We are pleased to provide free stock API service covering the majority of our datasets for 25 API requests per day and unlimited API requests for verified open-source or educational projects.
  - [1] 2026-10-30: the free key form asks for an organization; the same form asks for a role and an email and has no card or phone field | capture: sha256:6f82474b8fc7a791696c13926cbb14404e55af0b71b532d501dc39f59b260674 | quote: Organization (e.g. company, university, etc.):
  - [1] 2026-10-30: the free key form asks the applicant to pick a role | capture: sha256:6f82474b8fc7a791696c13926cbb14404e55af0b71b532d501dc39f59b260674 | quote: Investor Software Developer Educator Student I am from the Trading Agents project on Github Other
  - [1] 2026-10-30: the free key is offered with lifetime access | capture: sha256:6f82474b8fc7a791696c13926cbb14404e55af0b71b532d501dc39f59b260674 | quote: Claim your free key for the [Alpha Vantage Stock API ©](https://www.alphavantage.co/) with lifetime access.
  - [1] 2026-10-30: realtime and 15-minute delayed US market data is premium-only | capture: sha256:6f82474b8fc7a791696c13926cbb14404e55af0b71b532d501dc39f59b260674 | quote: Why is your realtime and 15-minute delayed US stock market data premium-only?
  - [3] 2026-10-30: the cheapest premium plan is 75 requests per minute at USD 49.99 a month | capture: sha256:9bf6690021aa8ade25974779016470c337ecafcc0743e72166cac634617293b2 | quote: 75 requests/min + premium support: $49.99/month
  - [3] 2026-10-30: the largest listed monthly premium plan is 1200 requests per minute at USD 249.99 a month | capture: sha256:9bf6690021aa8ade25974779016470c337ecafcc0743e72166cac634617293b2 | quote: 1200 requests/min + premium support: $249.99/month
  - [3] 2026-10-30: premium plans have no daily limit | capture: sha256:9bf6690021aa8ade25974779016470c337ecafcc0743e72166cac634617293b2 | quote: ❚ No daily limits.
  - [2] 2026-10-30: a free key gets only the compact daily series; the full series needs a premium key | capture: sha256:e0b6b32cf9531eaaff105a6cbb7b6ac218c8f22052ce430f30abd9ea345b8f54 | quote: The "compact" outputsize is available to both free and premium API keys. The "full" outputsize is available to premium keys.
  - [2] 2026-10-30: the weekly series, not marked premium, covers 25+ years per call | capture: sha256:e0b6b32cf9531eaaff105a6cbb7b6ac218c8f22052ce430f30abd9ea345b8f54 | quote: This API returns weekly time series (last trading day of each week, weekly open, weekly high, weekly low, weekly close, weekly volume) of the global equity specified, covering 25+ years of historical data.
  - [2] 2026-10-30: the bulk quotes endpoint is premium | capture: sha256:e0b6b32cf9531eaaff105a6cbb7b6ac218c8f22052ce430f30abd9ea345b8f54 | quote: Realtime Bulk Quotes Premium
  - [2] 2026-10-30: the bulk quotes endpoint accepts up to 100 tickers per request | capture: sha256:e0b6b32cf9531eaaff105a6cbb7b6ac218c8f22052ce430f30abd9ea345b8f54 | quote: If you would like to query a large universe of tickers in bulk, you may want to try out our [Realtime Bulk Quotes API](#realtime-bulk-quotes), which accepts up to 100 tickers per API request.
  - [2] 2026-10-30: LISTING_STATUS returns the active or delisted US stock and ETF list | capture: sha256:e0b6b32cf9531eaaff105a6cbb7b6ac218c8f22052ce430f30abd9ea345b8f54 | quote: This API returns a list of active or delisted US stocks and ETFs, either as of the latest trading day or at a specific time in history.
  - [4] 2026-10-30:  | capture: sha256:e87ba7a3330fc41a3121b5ad8114fef05ba5319c1baf08d49fe7e44b4a906475
  - probe:https://www.alphavantage.co/query?function=TIME_SERIES_DAILY&symbol=IBM&apikey=demo 2026-10-30: the query endpoint answered HTTP 200 to a TIME_SERIES_DAILY call with the documented demo key | capture: sha256:5af03354a29dc30036301232ba0f4d67a1267b691d789d6ab8080780ba68c040 | quote: "status": 200
  - probe:https://www.alphavantage.co/query?function=TIME_SERIES_DAILY&symbol=IBM&apikey=demo 2026-10-30: the daily series returned to the demo key is the compact output | capture: sha256:8d5a8a5708cce3eb871e51b5545cab2e7ae27cdd54545bcb7d0c2156aa4df857 | quote: "4. Output Size": "Compact"
  - [5] 2026-11-02: a third-party guide reports that the quota notice of a free key arrives as HTTP 200 with an Information key | capture: sha256:6b787d16ef15709a37866ab692569a09893033a7240c2f374edd9b59fe27432b | quote: That is the quota or a premium-only endpoint. It arrives as HTTP 200, so test for the key before parsing.
  - [6] 2026-11-02: a second third-party catalogue states that error responses arrive as HTTP 200 with the message in the JSON body | capture: sha256:df8df3906525885972444076f0d0f9f1ede1dbad955c4c033d28cf7b54af3a13 | quote: Error responses return 200 with error message in JSON.
  - [7] 2026-11-02: a client library raised the Information value of a free key's over-limit response with this text | capture: sha256:515b0964f771b079f2f31fd2504f1fa4ad7b6f1f3927bcca0481aca4e892f3b1 | quote: ValueError: Thank you for using Alpha Vantage! Our standard API rate limit is 25 requests per day. Please subscribe to any of the premium plans at https://www.alphavantage.co/premium/ to instantly remove all daily rate limits.
  - [1] 2026-11-02: the support FAQ states the 25-per-day limit and names no reset instant | capture: sha256:6f82474b8fc7a791696c13926cbb14404e55af0b71b532d501dc39f59b260674 | quote: We are pleased to provide free stock API service covering the majority of our datasets for 25 API requests per day and unlimited API requests for verified open-source or educational projects.
  - probe:https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=IBM&apikey=unregistered 2026-11-02: calls made in the same second with one made-up key string were answered with this Information text in a JSON body | capture: sha256:f29918acbdaee30bae9e463365dee0d624ee6017c6229765dd69d5d11498492e | quote: "Information": "Thank you for using Alpha Vantage! Please consider spreading out your free API requests more sparingly (1 request per second). You may subscribe to any of the premium plans at https://www.alphavantage.co/premium/ to lift the free key rate limit (25 requests per day), raise the per-second burst limit, and instantly unlock all premium endpoints"
  - probe:https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=IBM&apikey=unregistered 2026-11-02: the per-second throttle notice came with HTTP 200, not an HTTP error status | capture: sha256:93e6020b329fadb932dc77954232afd0047ea95c63089b86cc8bd34169da2e7e | quote: "status": 200
  - [2] 2026-11-02: the compact daily output is the latest 100 data points and the full output is the 25+ year series | capture: sha256:e0b6b32cf9531eaaff105a6cbb7b6ac218c8f22052ce430f30abd9ea345b8f54 | quote: `compact` returns only the latest 100 data points; `full` returns the full-length time series of 25+ years of historical data.
  - [2] 2026-11-02: a free key gets the compact output; the full series needs a premium key | capture: sha256:e0b6b32cf9531eaaff105a6cbb7b6ac218c8f22052ce430f30abd9ea345b8f54 | quote: The "compact" outputsize is available to both free and premium API keys. The "full" outputsize is available to premium keys.
  - [1] 2026-11-02: the free key form collects an email address, the contact channel for the key holder | capture: sha256:6f82474b8fc7a791696c13926cbb14404e55af0b71b532d501dc39f59b260674 | quote: We highly recommend that you use a legitimate email address - this is the primary way we will contact you for feature announcements or troubleshooting (e.g., if you lose your API key).
  - [1] 2026-11-02: the free key still allows 25 API requests per day, with unlimited requests for verified open-source or educational projects | capture: sha256:6f82474b8fc7a791696c13926cbb14404e55af0b71b532d501dc39f59b260674 | quote: We are pleased to provide free stock API service covering the majority of our datasets for 25 API requests per day and unlimited API requests for verified open-source or educational projects.
- sources:
  - [1] https://www.alphavantage.co/support/
  - [2] https://www.alphavantage.co/documentation/
  - [3] https://www.alphavantage.co/premium/
  - [4] https://www.alphavantage.co/terms_of_service/
  - [5] https://financialliterature.com/data/alphavantage/
  - [6] https://data.clawrxiv.org/sources/alpha-vantage
  - [7] https://github.com/home-assistant/core/issues/109153
