orhan-swe / alphavantage-java Goto Github PK

An easy to use, fluent Java wrapper for accessing the AlphaVantage API.

To get started using this library, make sure to get an API Key from Alphavantage's website. Add the library as a dependency to your java/android project

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
dependencies {
    ...
    implementation 'com.github.crazzyghost:alphavantage-java:x.y.z'
}

<repositories>
    ...
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
    ...
</repositories>
<dependencies>
    ...
    <dependency>
        <groupId>com.github.crazzyghost</groupId>
        <artifactId>alphavantage-java</artifactId>
        <version>x.y.z</version>
    </dependency>
    ...
</dependencies>

These five steps summarize how to access data using this library

Step 1. configure the wrapper

Step 2. Select a category

Step 3. Set the parameters for the selected category

Step 4. (Optional) Add response callbacks

Step 5. fetch results

Access to the API is through the AlphaVantage Singleton which is accessed using the static api() method of the class. Initialize the singleton with a Config instance once throughout your app's lifetime.

Config cfg = Config.builder()
    .key("#&ALPHA10100DEMOKEY")
    .timeOut(10)
    .build();

Initialize the instance with the config. You will use this object to set your api key and configure the http client. Using the wrapper without setting a config or a config key will throw an exception.

AlphaVantage.api().init(cfg);

We're good to go.

Here, we choose which data category/endpoint we want to access

For example, to select the Stock Time Series:

AlphaVantage.api()
    .timeSeries()

To set the api request parameters, call the appopriate parameter methods. For instance for the function parameter function you call daily() for the TIME_SERIES_DAILY function, intraday() for the TIME_SERIES_INTRADAY, and so on.

Let's select the TIME_SERIES_INTRADAY function

AlphaVantage.api()
    .timeSeries()
    .intraday()
...

Start setting parameters by calling an appropriate function method in the selected category

To handle responses add the onSuccess() or onFailure() async callbacks. Starting from version 1.5.0, this is an optional step.

public void handleSuccess(TimeSeriesResponse response) {
    plotGraph(reponse.getStockUnits());
}
public void handleFailure(AlphaVantageException error) {
    /* uh-oh! */
}

AlphaVantage.api()
    .timeSeries()
    .intraday()
    .forSymbol("IBM")
    .interval(Interval.FIVE_MIN)
    .outputSize(OutputSize.FULL)
    .onSuccess(e->handleSuccess(e))
    .onFailure(e->hanldeFailure(e))
    ...

When you are okay with setting the parameters call the fetch() method. Simple!

AlphaVantage.api()
    .timeSeries()
    .intraday()
    .forSymbol("IBM")
    .interval(Interval.FIVE_MIN)
    .outputSize(OutputSize.FULL)
    .onSuccess(e->handleSuccess(e))
    .onFailure(e->hanldeFailure(e))
    .fetch();

If you want a synchronous response, call the fetchSync() method.

TimeSeriesResponse response = AlphaVantage.api()
    .timeSeries()
    .intraday()
    .forSymbol("IBM")
    .interval(Interval.FIVE_MIN)
    .outputSize(OutputSize.FULL)
    .fetchSync();

That's it! 🎉 See site and demo project for more examples & documentation