{"id":36594055,"url":"https://github.com/mainstringargs/alpha-vantage-scraper","last_synced_at":"2026-01-12T08:25:18.999Z","repository":{"id":49557900,"uuid":"160531139","full_name":"mainstringargs/alpha-vantage-scraper","owner":"mainstringargs","description":"A Java wrapper to get stock data and stock indicators from the Alpha Vantage API","archived":false,"fork":false,"pushed_at":"2021-06-14T22:03:59.000Z","size":683,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-10-17T23:38:56.056Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.alphavantage.co/","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mainstringargs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-12-05T14:33:34.000Z","updated_at":"2022-03-18T18:48:42.000Z","dependencies_parsed_at":"2022-08-19T20:31:40.032Z","dependency_job_id":null,"html_url":"https://github.com/mainstringargs/alpha-vantage-scraper","commit_stats":null,"previous_names":[],"tags_count":5,"template":null,"template_full_name":null,"purl":"pkg:github/mainstringargs/alpha-vantage-scraper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mainstringargs%2Falpha-vantage-scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mainstringargs%2Falpha-vantage-scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mainstringargs%2Falpha-vantage-scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mainstringargs%2Falpha-vantage-scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mainstringargs","download_url":"https://codeload.github.com/mainstringargs/alpha-vantage-scraper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mainstringargs%2Falpha-vantage-scraper/sbom","scorecard":{"id":612985,"data":{"date":"2025-08-11","repo":{"name":"github.com/mainstringargs/alpha-vantage-scraper","commit":"f123cf7bc5d08bdce73bfaf5aebb873225f7d4d9"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.6,"checks":[{"name":"Code-Review","score":5,"reason":"Found 4/8 approved changesets -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: gradle/wrapper/gradle-wrapper.jar:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 27 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-21T03:06:49.889Z","repository_id":49557900,"created_at":"2025-08-21T03:06:49.889Z","updated_at":"2025-08-21T03:06:49.889Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28337591,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-12T08:25:18.250Z","updated_at":"2026-01-12T08:25:18.992Z","avatar_url":"https://github.com/mainstringargs.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/patriques82/alphavantage4j.svg?branch=master)](https://travis-ci.org/patriques82/alphavantage4j) [![Maven Central](https://img.shields.io/maven-central/v/io.github.mainstringargs.alphavantagescraper/alpha-vantage-scraper.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22io.github.mainstringargs.alphavantagescraper%22%20AND%20a:%22alpha-vantage-scraper%22)\n[![license](https://img.shields.io/github/license/mainstringargs/alpha-vantage-scraper.svg)](https://github.com/mainstringargs/alpha-vantage-scraper/blob/master/LICENSE)\n\n# Alpha Vantage Scraper\n\nA Java wrapper to get stock data and stock indicators from the Alpha Vantage API.\n\n## Credit\n\nThis project started as a fork of https://github.com/patriques82/alphavantage4j which has since been abandoned.  Their initial work was amazing!\n\n## Introduction\n\nAlpha Vantage delivers a free API for real time financial data and most used finance indicators. This library implements a wrapper to the free API provided by Alpha\nVantage (http://www.alphavantage.co/). It requires an api key, that can be requested on http://www.alphavantage.co/support/#api-key. You can have a look at all the api \ncalls available in their documentation http://www.alphavantage.co/documentation.\n\n## Maven installation\n\n```xml\n    \u003cdependency\u003e\n        \u003cgroupId\u003eio.github.mainstringargs.alphavantagescraper\u003c/groupId\u003e\n        \u003cartifactId\u003ealpha-vantage-scraper\u003c/artifactId\u003e\n        \u003cversion\u003e1.5.1\u003c/version\u003e\n    \u003c/dependency\u003e\n```\n\n## Gradle installation\n\n```groovy\ndependencies {\n\tcompile \"io.github.mainstringargs.alphavantagescraper:alpha-vantage-scraper:1.5.1\"\n}\n```\n\n## Usage\n\nNow that you set up your project and have your api key you can start using the service. Here are a few examples of how you can use the service.\n\n#### Global Stock Quotes example\n\n```java\npublic class App {\n  public static void main(String[] args) {\n    String apiKey = \"50M3AP1K3Y\";\n    int timeout = 3000;\n    AlphaVantageConnector apiConnector = new AlphaVantageConnector(apiKey, timeout);\n    StockQuotes stockQuotes = new StockQuotes(apiConnector);\n    \n    try {\n      String symbol = \"MSFT\";  \n      System.out.println(\"Stock: \" + symbol);\n      StockQuotesResponse response = stockQuotes.quote(symbol);\n      StockQuote stock = response.getStockQuote();\n      System.out.printf(\"Date: %s Price: %s%n\", stock.getLatestTradingDay(), stock.getPrice());\n    } catch (AlphaVantageException e) {\n      System.out.println(\"something went wrong\");\n    }\n  }\n}\n```\n\n#### Time Series example\n```java\npublic class App {\n  public static void main(String[] args) {\n    String apiKey = \"50M3AP1K3Y\";\n    int timeout = 3000;\n    AlphaVantageConnector apiConnector = new AlphaVantageConnector(apiKey, timeout);\n    TimeSeries stockTimeSeries = new TimeSeries(apiConnector);\n    \n    try {\n      IntraDay response = stockTimeSeries.intraDay(\"MSFT\", Interval.ONE_MIN, OutputSize.COMPACT);\n      Map\u003cString, String\u003e metaData = response.getMetaData();\n      System.out.println(\"Information: \" + metaData.get(\"1. Information\"));\n      System.out.println(\"Stock: \" + metaData.get(\"2. Symbol\"));\n      \n      List\u003cStockData\u003e stockData = response.getStockData();\n      stockData.forEach(stock -\u003e {\n        System.out.println(\"date:   \" + stock.getDateTime());\n        System.out.println(\"open:   \" + stock.getOpen());\n        System.out.println(\"high:   \" + stock.getHigh());\n        System.out.println(\"low:    \" + stock.getLow());\n        System.out.println(\"close:  \" + stock.getClose());\n        System.out.println(\"volume: \" + stock.getVolume());\n      });\n    } catch (AlphaVantageException e) {\n      System.out.println(\"something went wrong\");\n    }\n  }\n}\n```\n#### Foreign Exchange example\n```java\npublic class App {\n  public static void main(String[] args) {\n    String apiKey = \"50M3AP1K3Y\";\n    int timeout = 3000;\n    AlphaVantageConnector apiConnector = new AlphaVantageConnector(apiKey, timeout);\n    ForeignExchange foreignExchange = new ForeignExchange(apiConnector);\n\n    try {\n      CurrencyExchange currencyExchange = foreignExchange.currencyExchangeRate(\"USD\", \"SEK\");\n      CurrencyExchangeData currencyExchangeData = currencyExchange.getData();\n\n      System.out.println(\"from currency code: \" + currencyExchangeData.getFromCurrencyCode());\n      System.out.println(\"from currency name: \" + currencyExchangeData.getFromCurrencyName());\n      System.out.println(\"to currency code:   \" + currencyExchangeData.getToCurrencyCode());\n      System.out.println(\"to currency name:   \" + currencyExchangeData.getToCurrencyName());\n      System.out.println(\"exchange rate:      \" + currencyExchangeData.getExchangeRate());\n      System.out.println(\"last refresh:       \" + currencyExchangeData.getTime());\n    } catch (AlphaVantageException e) {\n      System.out.println(\"something went wrong\");\n    }\n  }\n}\n```\n#### Digital/Crypto Currencies example\n```java\npublic class App {\n  public static void main(String[] args) {\n    String apiKey = \"50M3AP1K3Y\";\n    int timeout = 3000;\n    AlphaVantageConnector apiConnector = new AlphaVantageConnector(apiKey, timeout);\n    DigitalCurrencies digitalCurrencies = new DigitalCurrencies(apiConnector);\n\n    try {\n      IntraDay response = digitalCurrencies.intraDay(\"BTC\", Market.USD);\n      Map\u003cString, String\u003e metaData = response.getMetaData();\n      System.out.println(\"Information: \" + metaData.get(\"1. Information\"));\n      System.out.println(\"Digital Currency Code: \" + metaData.get(\"2. Digital Currency Code\"));\n\n      List\u003cSimpelDigitalCurrencyData\u003e digitalData = response.getDigitalData();\n      digitalData.forEach(data -\u003e {\n        System.out.println(\"date:       \" + data.getDateTime());\n        System.out.println(\"price A:    \" + data.getPriceA());\n        System.out.println(\"price B:    \" + data.getPriceB());\n        System.out.println(\"volume:     \" + data.getVolume());\n        System.out.println(\"market cap: \" + data.getMarketCap());\n      });\n    } catch (AlphaVantageException e) {\n      System.out.println(\"something went wrong\");\n    }\n  }\n}\n```\n#### Technical Indicators example\n```java\npublic class App {\n  public static void main(String[] args) {\n    String apiKey = \"50M3AP1K3Y\";\n    int timeout = 3000;\n    AlphaVantageConnector apiConnector = new AlphaVantageConnector(apiKey, timeout);\n    TechnicalIndicators technicalIndicators = new TechnicalIndicators(apiConnector);\n\n    try {\n      MACD response = technicalIndicators.macd(\"MSFT\", Interval.DAILY, TimePeriod.of(10), SeriesType.CLOSE, null, null, null);\n      Map\u003cString, String\u003e metaData = response.getMetaData();\n      System.out.println(\"Symbol: \" + metaData.get(\"1: Symbol\"));\n      System.out.println(\"Indicator: \" + metaData.get(\"2: Indicator\"));\n\n      List\u003cMACDData\u003e macdData = response.getData();\n      macdData.forEach(data -\u003e {\n        System.out.println(\"date:           \" + data.getDateTime());\n        System.out.println(\"MACD Histogram: \" + data.getHist());\n        System.out.println(\"MACD Signal:    \" + data.getSignal());\n        System.out.println(\"MACD:           \" + data.getMacd());\n      });\n    } catch (AlphaVantageException e) {\n      System.out.println(\"something went wrong\");\n    }\n  }\n}\n```\n#### Sector Performances example\n```java\npublic class App {\n  public static void main(String[] args) {\n    String apiKey = \"50M3AP1K3Y\";\n    int timeout = 3000;\n    AlphaVantageConnector apiConnector = new AlphaVantageConnector(apiKey, timeout);\n    SectorPerformances sectorPerformances = new SectorPerformances(apiConnector);\n\n    try {\n      Sectors response = sectorPerformances.sector();\n      Map\u003cString, String\u003e metaData = response.getMetaData();\n      System.out.println(\"Information: \" + metaData.get(\"Information\"));\n      System.out.println(\"Last Refreshed: \" + metaData.get(\"Last Refreshed\"));\n\n      List\u003cSectorData\u003e sectors = response.getSectors();\n      sectors.forEach(data -\u003e {\n        System.out.println(\"key:           \" + data.getKey());\n        System.out.println(\"Consumer Discretionary: \" + data.getConsumerDiscretionary());\n        System.out.println(\"Consumer Staples:       \" + data.getConsumerStaples());\n        System.out.println(\"Energy:                 \" + data.getEnergy());\n        System.out.println(\"Financials:             \" + data.getFinancials());\n        System.out.println(\"Health Care:            \" + data.getHealthCare());\n        System.out.println(\"Industrials:            \" + data.getIndustrials());\n        System.out.println(\"Information Technology: \" + data.getInformationTechnology());\n        System.out.println(\"Materials:              \" + data.getMaterials());\n        System.out.println(\"Real Estate:            \" + data.getRealEstate());\n      });\n    } catch (AlphaVantageException e) {\n      System.out.println(\"something went wrong\");\n    }\n  }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmainstringargs%2Falpha-vantage-scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmainstringargs%2Falpha-vantage-scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmainstringargs%2Falpha-vantage-scraper/lists"}