Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/m1/go-finnhub

Simple and easy to use client for stock market, forex and crypto data from finnhub.io written in Go. Access real-time financial market data from 60+ stock exchanges, 10 forex brokers, and 15+ crypto exchanges
https://github.com/m1/go-finnhub

crytpocurrency financial-data financial-markets finnhub forex forex-data forex-market forex-trading go go-library golang golang-crypto golang-library

Last synced: about 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/m1/go-finnhub
Owner: m1
License: mit
Archived: true
Created: 2020-01-13T20:47:13.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2020-02-01T14:53:23.000Z (almost 5 years ago)
Last Synced: 2024-07-30T20:43:01.438Z (5 months ago)
Topics: crytpocurrency, financial-data, financial-markets, finnhub, forex, forex-data, forex-market, forex-trading, go, go-library, golang, golang-crypto, golang-library
Language: Go
Homepage:
Size: 37.1 KB
Stars: 90
Watchers: 6
Forks: 19
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

awesome-go - go-finnhub - Client for stock market, forex and crypto data from finnhub.io. Access real-time financial market data from 60+ stock exchanges, 10 forex brokers, and 15+ crypto exchanges. (Financial / Search and Analytic Databases)
awesome-go-extra - ARCHIVED - time financial market data from 60+ stock exchanges, 10 forex brokers, and 15+ crypto exchanges|74|15|0|2020-01-13T20:47:13Z|2020-02-01T14:53:23Z| (Financial / Advanced Console UIs)

README

        # go-finnhub

[![GoDoc](https://godoc.org/github.com/m1/go-finnhub?status.svg)](https://godoc.org/github.com/m1/go-finnhub)

[![Build Status](https://travis-ci.org/m1/go-finnhub.svg?branch=master)](https://travis-ci.org/m1/go-finnhub)

[![Go Report Card](https://goreportcard.com/badge/github.com/m1/go-finnhub)](https://goreportcard.com/report/github.com/m1/go-finnhub)

[![Release](https://img.shields.io/github/release/m1/go-finnhub.svg)](https://github.com/m1/go-finnhub/releases/latest)

[![codecov](https://codecov.io/gh/m1/go-finnhub/branch/master/graph/badge.svg)](https://codecov.io/gh/m1/go-finnhub)

__Simple and easy to use client for stock, forex and crpyto data from [finnhub.io](https://finnhub.io/) written in Go. Access real-time market data from 60+ stock exchanges, 10 forex brokers, and 15+ crypto exchanges__

## Installation

`go get github.com/m1/go-finnhub`

## Usage

First sign up for your api token here [finnhub.io](https://finnhub.io/)

Follow this basic example, for more in-depth documentation see the [docs](https://godoc.org/github.com/m1/go-finnhub):

```go

c := client.New("your_token_here")

// Stocks

company, err := c.Stock.GetProfile("AAPL")

ceo, err := c.Stock.GetCEO("AAPL")

recommendation, err := c.Stock.GetRecommendations("AAPL")

target, err := c.Stock.GetPriceTarget("AAPL")

options, err := c.Stock.GetOptionChain("DBD")

peers, err := c.Stock.GetPeers("AAPL")

earnings, err := c.Stock.GetEarnings("AAPL")

candle, err := c.Stock.GetCandle("AAPL", finnhub.CandleResolutionDay, nil)

exchanges, err := c.Stock.GetExchanges()

symbols, err := c.Stock.GetSymbols("US")

gradings, err := c.Stock.GetGradings(&finnhub.GradingParams{Symbol: "AAPL"})

// Crypto

exchanges, err := c.Crypto.GetExchanges()

symbols, err := c.Crypto.GetSymbols("Binance")

candle, err := c.Crypto.GetCandle("BINANCE:BEAMUSDT", finnhub.CandleResolutionMonth, nil)

// Forex

exchanges, err := c.Forex.GetExchanges()

symbols, err := c.Forex.GetSymbols("oanda")

candle, err := c.Forex.GetCandle("OANDA:XAU_GBP", finnhub.CandleResolutionMonth, nil)

// News

news, err := c.News.Get(nil)

news, err = c.News.Get(&finnhub.NewsParams{Category: finnhub.NewsCategoryCrypto})

news, err = c.News.GetCompany("AAPL")

sentiment, err := c.News.GetSentiment("AAPL")

```