https://github.com/sahilm8/stock_info_svc
API to fetch and return stock data. Based on the Alpha Vantage API.
https://github.com/sahilm8/stock_info_svc
jakarta-validation java-21 lombok macos-dns-resolver maven reactor-core spring-boot spring-dotenv spring-test spring-validation spring-web spring-webflux
Last synced: 27 days ago
JSON representation
API to fetch and return stock data. Based on the Alpha Vantage API.
- Host: GitHub
- URL: https://github.com/sahilm8/stock_info_svc
- Owner: sahilmemon7
- License: mit
- Created: 2024-08-14T22:01:35.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-01-21T16:36:47.000Z (3 months ago)
- Last Synced: 2025-02-27T01:52:23.068Z (about 2 months ago)
- Topics: jakarta-validation, java-21, lombok, macos-dns-resolver, maven, reactor-core, spring-boot, spring-dotenv, spring-test, spring-validation, spring-web, spring-webflux
- Language: Java
- Homepage: https://github.com/sahilm8/stock_info_svc
- Size: 112 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Stock Info API
 
API to fetch and return stock data. Based on the [Alpha Vantage API](https://www.alphavantage.co).
## Stack
- Java 21
- Maven
- Spring Boot
- Spring Web
- Spring Webflux
- Reactor Core
- Spring Validation
- Jakarta Validation
- Spring Dotenv
- Lombok
- Spring Test
- MacOS DNS Resolver
## Setup
- Install dependencies:
```
./mvnw clean install
```
- Start the application:
```
./mvnw spring-boot:run
```
## Endpoints
Requests can be made to perform the following actions:
- Get Stock
- Get Intraday Time Series (interval: 1min, 5min, 15min, 30min, 60min)
- Get Daily Time Series
- Get Weekly Time Series
- Get Monthly Time Series
### Get Stock
#### Request
```
curl --location --request GET 'localhost:8080/api/v2/stock/get-stock' \
--header 'Content-Type: application/json' \
--data '{
"symbol": "NVDA"
}'
```
#### Response
```
{
"symbol": "NVDA",
"open": 136.6900,
"high": 138.5000,
"low": 135.4649,
"price": 137.7100,
"volume": 201188760,
"latestTradingDay": "2025-01-17",
"previousClose": 133.5700,
"change": 4.1400,
"changePercent": 3.0995
}
```
### Get Intraday Time Series
#### Request
```
curl --location --request GET 'localhost:8080/api/v2/stock/get-intraday-ts' \
--header 'Content-Type: application/json' \
--data '{
"symbol": "NVDA",
"interval": "60min"
}'
```
#### Response
```
{
"timeSeries": {
"2025-01-14 09:00:00": {
"open": 135.8800,
"high": 136.3800,
"low": 133.3500,
"close": 133.5044,
"volume": 29463739
},
"2025-01-14 19:00:00": {
"open": 131.3400,
"high": 131.3900,
"low": 131.2000,
"close": 131.2999,
"volume": 354662
},
"2025-01-17 12:00:00": {
"open": 137.9800,
"high": 138.0900,
"low": 137.6300,
"close": 137.7600,
"volume": 13961753
},
...
}
}
```
### Get Daily Time Series
#### Request
```
curl --location --request GET 'localhost:8080/api/v2/stock/get-daily-ts' \
--header 'Content-Type: application/json' \
--data '{
"symbol": "NVDA"
}'
```
#### Response
```
{
"timeSeries": {
"2024-09-20": {
"open": 117.0600,
"high": 118.6181,
"low": 115.3901,
"close": 116.0000,
"volume": 382462428
},
"2024-12-31": {
"open": 138.0300,
"high": 138.0700,
"low": 133.8300,
"close": 134.2900,
"volume": 155659211
},
"2024-12-30": {
"open": 134.8300,
"high": 140.2700,
"low": 134.0200,
"close": 137.4900,
"volume": 167734700
},
...
}
}
```
### Get Weekly Time Series
#### Request
```
curl --location --request GET 'localhost:8080/api/v2/stock/get-weekly-ts' \
--header 'Content-Type: application/json' \
--data '{
"symbol": "NVDA"
}'
```
#### Response
```
{
"timeSeries": {
"2020-08-07": {
"open": 429.3000,
"high": 460.1900,
"low": 428.6100,
"close": 447.9800,
"adjustedClose": 11.1646,
"volume": 39017130,
"dividendAmount": 0.0000
},
"2011-04-15": {
"open": 17.6200,
"high": 18.9400,
"low": 16.8300,
"close": 18.7100,
"adjustedClose": 0.4290,
"volume": 109024400,
"dividendAmount": 0.0000
},
"2001-07-06": {
"open": 89.0800,
"high": 90.7000,
"low": 79.1000,
"close": 80.7000,
"adjustedClose": 0.3084,
"volume": 13621800,
"dividendAmount": 0.0000
},
...
}
}
```
### Get Monthly Time Series
#### Request
```
curl --location --request GET 'localhost:8080/api/v2/stock/get-monthly-ts' \
--header 'Content-Type: application/json' \
--data '{
"symbol": "NVDA"
}'
```
#### Response
```
{
"timeSeries": {
"2014-12-31": {
"open": 20.8800,
"high": 21.2500,
"low": 19.1000,
"close": 20.0500,
"adjustedClose": 0.4813,
"volume": 106485166,
"dividendAmount": 0.0000
},
"2007-06-29": {
"open": 35.0300,
"high": 43.8700,
"low": 34.4200,
"close": 41.3100,
"adjustedClose": 0.6315,
"volume": 241007871,
"dividendAmount": 0.0000
},
"2016-10-31": {
"open": 68.5200,
"high": 72.9500,
"low": 63.7000,
"close": 71.1600,
"adjustedClose": 1.7503,
"volume": 163789051,
"dividendAmount": 0.0000
},
...
}
}
```