Skip to content

Miensoap/KISHelper

Repository files navigation

KISHelper

License: MIT

KISHelper is a Java library for interacting with the Korea Investment Open API.
This library simplifies the process of accessing and using the API,
providing a more efficient way to integrate financial data into your applications.

"This project is under ongoing development. For more details, please visit this branch or this blog."

Table of Contents

Features

  • Easy integration with the Korea Investment Open API
  • Simplified data retrieval
  • Lightweight and efficient

Installation

Add the following to your build.gradle file to include KISHelper in your project:

repositories {
    mavenCentral()
}

dependencies {
    implementation 'io.github.miensoap:KISHelper:0.1.0'
}

Add your KIS Open API key to resources/kish.yml file:

appkey: 'your_appkey'
appsecret: 'your_secret_key'
accessToken: 'your_access_token' (optional)

How to get your accessToken

Usage

Example

// Example usage of KISHelper library
import io.github.miensoap.kishelper.core.KISClient;

import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        KISClient client = KISClient.getInstance();
        System.out.println(client.getOverseasDailyPrice("AMS", "SOXL", false).size());

        // version 0.2.3
        Stock soxl = new Stock("SOXL", AMEX);
        System.out.println(soxl.getPriceOfDate(LocalDate.of(2024, 8, 2), true));

        // version 0.2.4
        System.out.println(soxl.getDetails().englishName());
    }
}

For more detailed usage, please refer to the documentation.

Contributing

We welcome contributions to the KISHelper project. Please read our Contributing Guidelines for more information on how to get started.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact

Developer: Miensoap
Email: miensop51@gmail.com
GitHub: Miensoap

Acknowledgements

Special thanks to all the contributors who helped in making this project better.


Feel free to customize this README file further as per your needs.