{"id":28250447,"url":"https://github.com/zackurben/alphavantage","last_synced_at":"2025-06-14T01:31:19.927Z","repository":{"id":23484755,"uuid":"99163718","full_name":"zackurben/alphavantage","owner":"zackurben","description":"A simple interface to the Alpha Vantage API.","archived":false,"fork":false,"pushed_at":"2024-01-26T09:07:07.000Z","size":1742,"stargazers_count":343,"open_issues_count":10,"forks_count":61,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-19T14:19:49.832Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zackurben.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["zackurben"]}},"created_at":"2017-08-02T21:48:33.000Z","updated_at":"2025-03-21T06:34:00.000Z","dependencies_parsed_at":"2023-10-17T01:43:14.673Z","dependency_job_id":"9089371b-5013-45db-85a7-362f6f8d9b12","html_url":"https://github.com/zackurben/alphavantage","commit_stats":{"total_commits":280,"total_committers":14,"mean_commits":20.0,"dds":0.25,"last_synced_commit":"86748a67910756f2f10e9c833224f9f3e2652a20"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/zackurben/alphavantage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackurben%2Falphavantage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackurben%2Falphavantage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackurben%2Falphavantage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackurben%2Falphavantage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zackurben","download_url":"https://codeload.github.com/zackurben/alphavantage/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackurben%2Falphavantage/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259745067,"owners_count":22905037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest"],"created_at":"2025-05-19T14:18:13.963Z","updated_at":"2025-06-14T01:31:19.922Z","avatar_url":"https://github.com/zackurben.png","language":"JavaScript","funding_links":["https://github.com/sponsors/zackurben"],"categories":[],"sub_categories":[],"readme":"# AlphaVantage\n\n[![Build Status](https://travis-ci.org/zackurben/alphavantage.svg?branch=master)](https://travis-ci.org/zackurben/alphavantage)\n[![Coverage Status](https://coveralls.io/repos/github/zackurben/alphavantage/badge.svg?branch=master)](https://coveralls.io/github/zackurben/alphavantage?branch=master)\n\nThis is a simple wrapper around the [Alpha Vantage API](https://www.alphavantage.co/documentation/) hosted on [NPM](https://www.npmjs.com/package/alphavantage). I have no affiliation with AlphaVantage. This library can be used in the browser or in node since it is packaged as a UMD module.\n\nAll contributions are welcome, see our [CONTRIBUTING.md](CONTRIBUTING.md)! This is an open source project under the MIT license, see [LICENSE.md](LICENSE.md) for additional information.\n\n`All available functions with this SDK have the same parameters as listed in the the Alpha Vantage Docs, without the \"function\" or \"apikey\". Do not include the \"function\" or \"apikey\" parameters when using this library. All functions return promises with the response data.`\n\n\u003e If you want to use a function that isn't supported yet, checkout the `alpha.experimental()` function!\n\n## Installation\n\n```bash\nnpm i alphavantage\n```\n\n## Node.js Initialization\n\n```javascript\n/**\n * Init Alpha Vantage with your API key.\n *\n * @param {String} key\n *   Your Alpha Vantage API key.\n */\nconst alpha = require('alphavantage')({ key: 'qweqweqwe' });\n```\n\n## Browser Initialization\n\n\u003e Note: Your API key will be visible in the network traffic, this should not be used for public projects.\n\n```html\n\u003cbody\u003e\n  \u003cscript src=\"path/to/alphavantage/dist/bundle.js\"\u003e\u003c/script\u003e\n  \u003cscript type=\"application/javascript\"\u003e\n    /**\n     * Init Alpha Vantage with your API key.\n     *\n     * @param {String} key\n     *   Your Alpha Vantage API key.\n     */\n    const alpha = alphavantage({ key: 'qweqweqwe' });\n  \u003c/script\u003e\n\u003c/body\u003e\n```\n\n## Usage\n\n```javascript\n// Simple examples\nalpha.data.intraday(`msft`).then((data) =\u003e {\n  console.log(data);\n});\n\nalpha.forex.rate('btc', 'usd').then((data) =\u003e {\n  console.log(data);\n});\n\nalpha.crypto.daily('btc', 'usd').then((data) =\u003e {\n  console.log(data);\n});\n\nalpha.technical.sma(`msft`, `daily`, 60, `close`).then((data) =\u003e {\n  console.log(data);\n});\n\nalpha.experimental('CRYPTO_INTRADAY', { symbol: 'ETH', market: 'USD', interval: '5min' })).then((data) =\u003e {\n  console.log(data);\n});\n```\n\n## Util\n\nData polishing\n\n- Rewrite weird data keys to be consistent across all api calls. This is an optional utility you can use with the result of any api call.\n\n```javascript\nconst polished = alpha.util.polish(data);\n```\n\n## Data\n\nSee [Alpha Vantage](https://www.alphavantage.co/documentation/#time-series-data) for the parameters.\n\n```javascript\nalpha.data.intraday(symbol, outputsize, datatype, interval);\nalpha.data.daily(symbol, outputsize, datatype, interval);\nalpha.data.daily_adjusted(symbol, outputsize, datatype, interval);\nalpha.data.weekly(symbol, outputsize, datatype, interval);\nalpha.data.weekly_adjusted(symbol, outputsize, datatype, interval);\nalpha.data.monthly(symbol, outputsize, datatype, interval);\nalpha.data.monthly_adjusted(symbol, outputsize, datatype, interval);\nalpha.data.quote(symbol, outputsize, datatype, interval);\nalpha.data.search(keywords);\n```\n\n## Forex\n\nSee [Alpha Vantage](https://www.alphavantage.co/documentation/#fx) for the parameters.\n\n```javascript\nalpha.forex.rate(from_currency, to_currency);\n```\n\n## Crypto\n\nSee [Alpha Vantage](https://www.alphavantage.co/documentation/#digital-currency) for the parameters.\n\n```javascript\nalpha.crypto.daily(symbol, market);\nalpha.crypto.weekly(symbol, market);\nalpha.crypto.monthly(symbol, market);\n```\n\n## Technicals\n\nSee [Alpha Vantage](https://www.alphavantage.co/documentation/#technical-indicators) for the parameters.\n\n```javascript\nalpha.technical.sma(symbol, interval, time_period, series_type);\nalpha.technical.ema(symbol, interval, time_period, series_type);\nalpha.technical.wma(symbol, interval, time_period, series_type);\nalpha.technical.dema(symbol, interval, time_period, series_type);\nalpha.technical.tema(symbol, interval, time_period, series_type);\nalpha.technical.trima(symbol, interval, time_period, series_type);\nalpha.technical.kama(symbol, interval, time_period, series_type);\nalpha.technical.mama(symbol, interval, series_type, fastlimit, slowlimit);\nalpha.technical.t3(symbol, interval, time_period, series_type);\nalpha.technical.macd(symbol, interval, series_type, fastperiod, slowperiod, signalperiod);\nalpha.technical.macdext(\n  symbol,\n  interval,\n  series_type,\n  fastperiod,\n  slowperiod,\n  signalperiod,\n  fastmatype,\n  slowmatype,\n  signalmatype\n);\nalpha.technical.stoch(symbol, interval, fastkperiod, slowkperiod, slowdperiod, slowkmatype, slowdmatype);\nalpha.technical.stochf(symbol, interval, fastkperiod, fastdperiod, fastdmatype);\nalpha.technical.rsi(symbol, interval, time_period, series_type);\nalpha.technical.stochrsi(symbol, interval, time_period, series_type, fastkperiod, slowdperiod, fastdmatype);\nalpha.technical.willr(symbol, interval, time_period);\nalpha.technical.adx(symbol, interval, time_period);\nalpha.technical.adxr(symbol, interval, time_period);\nalpha.technical.apo(symbol, interval, series_type, fastperiod, slowperiod, matype);\nalpha.technical.ppo(symbol, interval, series_type, fastperiod, slowperiod, matype);\nalpha.technical.mom(symbol, interval, time_period, series_type);\nalpha.technical.bop(symbol, interval);\nalpha.technical.cci(symbol, interval, time_period);\nalpha.technical.cmo(symbol, interval, time_period, series_type);\nalpha.technical.roc(symbol, interval, time_period, series_type);\nalpha.technical.rocr(symbol, interval, time_period, series_type);\nalpha.technical.aroon(symbol, interval, time_period);\nalpha.technical.aroonosc(symbol, interval, time_period);\nalpha.technical.mfi(symbol, interval, time_period);\nalpha.technical.trix(symbol, interval, time_period, series_type);\nalpha.technical.ultosc(symbol, interval, timeperiod1, timeperiod2, timeperiod3);\nalpha.technical.dx(symbol, interval, time_period);\nalpha.technical.minus_di(symbol, interval, time_period);\nalpha.technical.plus_di(symbol, interval, time_period);\nalpha.technical.minus_dm(symbol, interval, time_period);\nalpha.technical.plus_dm(symbol, interval, time_period);\nalpha.technical.bbands(symbol, interval, time_period, series_type, nbdevup, nbdevdn);\nalpha.technical.midpoint(symbol, interval, time_period, series_type);\nalpha.technical.midprice(symbol, interval, time_period);\nalpha.technical.sar(symbol, interval, acceleration, maximum);\nalpha.technical.trange(symbol, interval);\nalpha.technical.atr(symbol, interval, time_period);\nalpha.technical.natr(symbol, interval, time_period);\nalpha.technical.ad(symbol, interval);\nalpha.technical.adosc(symbol, interval, fastperiod, slowperiod);\nalpha.technical.obv(symbol, interval);\nalpha.technical.ht_trendline(symbol, interval, series_type);\nalpha.technical.ht_sine(symbol, interval, series_type);\nalpha.technical.ht_trendmode(symbol, interval, series_type);\nalpha.technical.ht_dcperiod(symbol, interval, series_type);\nalpha.technical.ht_dcphase(symbol, interval, series_type);\nalpha.technical.ht_dcphasor(symbol, interval, series_type);\n```\n\n## Experimental\n\nThis function allows you to use any AlphaVantage API that has not yet been implemented, use at your own risk! You can get the function name and params from the [API Documentation](https://www.alphavantage.co/documentation/) and it should be noted that the data polishing may be broken as you encounter new props that aren't supported yet. If you notice these props, please make a new Issue/Pull Request so we can enhance the library!\n\n```javascript\nalpha.experimental(fn, params);\nalpha.experimental('TIME_SERIES_DAILY', { symbol: 'XYZ', ...});\n```\n\n## Contact\n\n- Author: Zack Urben\n- Twitter: https://twitter.com/zackurben (better)\n- Contact: zackurben@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzackurben%2Falphavantage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzackurben%2Falphavantage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzackurben%2Falphavantage/lists"}