PLC/vPLC>> finnhub-go>> 返回
项目作者： Finnhub-Stock-API

项目描述 ：
Finnhub Go API client. Finnhub API provides institutional-grade financial data to investors, fintech startups and investment firms. We support real-time stock price, global fundamentals and alternative data. https://finnhub.io/docs/api
高级语言： Shell
项目地址: git://github.com/Finnhub-Stock-API/finnhub-go.git
创建时间： 2020-05-26T21:56:11Z
项目社区：https://github.com/Finnhub-Stock-API/finnhub-go
开源协议：Apache License 2.0
下载


Go API client for finnhub.io

Overview

Installation

Using Go Modules

Make sure your project is using Go Modules (it will have a go.mod file in its
root if it already is):

  1. go mod init

Then, reference finnhub-go in a Go program with import:

  1. import (
  2.     finnhub "github.com/Finnhub-Stock-API/finnhub-go/v2"
  3. )

Run any of the normal go commands (build/install/test). The Go
toolchain will resolve and fetch the finnhub-go module automatically.

Alternatively, you can also explicitly go get the package into a project:

  1. $ go get -u github.com/Finnhub-Stock-API/finnhub-go/v2

Using go get

If you don’t want to use Go Modules, you can choose to get the library directly:

  1. $ go get -u github.com/Finnhub-Stock-API/finnhub-go

Then, reference finnhub-go in a Go program with import (Note that no /v2 at the end):

  1. import (
  2.     finnhub "github.com/Finnhub-Stock-API/finnhub-go"
  3. )

Examples

Example (check out other methods documentation here):

  1. package main
  3. import (
  4.     "context"
  5.     "fmt"
  6.     finnhub "github.com/Finnhub-Stock-API/finnhub-go/v2"
  7. )
  9. func main() {
  10.     cfg := finnhub.NewConfiguration()
  11.     cfg.AddDefaultHeader("X-Finnhub-Token", "<API_key>")
  12.     finnhubClient := finnhub.NewAPIClient(cfg).DefaultApi
  14.     //Earnings calendar
  15.     earningsCalendar, _, err := finnhubClient.EarningsCalendar(context.Background()).From("2021-07-01").To("2021-07-25").Execute()
  16.     fmt.Printf("%+v\n", earningsCalendar)
  18.     // NBBO
  19.     bboData, _, err := finnhubClient.StockNbbo(context.Background()).Symbol("AAPL").Date("2021-07-23").Limit(50).Skip(0).Execute()
  20.     fmt.Printf("%+v\n", bboData)
  22.     // Bid ask
  23.     lastBidAsk, _, err := finnhubClient.StockBidask(context.Background()).Symbol("AAPL").Execute()
  24.     fmt.Printf("%+v\n", lastBidAsk)
  26.     // Stock dividends 2
  27.     dividends2, _, err := finnhubClient.StockBasicDividends(context.Background()).Symbol("KO").Execute()
  28.     fmt.Printf("%+v\n", dividends2)
  30.     //Stock candles
  31.     stockCandles, _, err := finnhubClient.StockCandles(context.Background()).Symbol("AAPL").Resolution("D").From(1590988249).To(1591852249).Execute()
  32.     fmt.Printf("%+v\n", stockCandles)
  34.     // Example with required parameters
  35.     news, _, err := finnhubClient.CompanyNews(context.Background()).Symbol("AAPL").From("2020-05-01").To("2020-05-01").Execute()
  36.     if err != nil {
  37.         fmt.Println(err)
  38.     }
  39.     fmt.Printf("%+v\n", news)
  41.     // Example with required and optional parameters
  42.     ownerships, _, err := finnhubClient.Ownership(context.Background()).Symbol("AAPL").Execute()
  43.     fmt.Printf("%+v\n", ownerships)
  45.     // Aggregate Indicator
  46.     aggregateIndicator, _, err := finnhubClient.AggregateIndicator(context.Background()).Symbol("AAPL").Resolution("D").Execute()
  47.     fmt.Printf("%+v\n", aggregateIndicator)
  49.     // Basic financials
  50.     basicFinancials, _, err := finnhubClient.CompanyBasicFinancials(context.Background()).Symbol("MSFT").Metric("all").Execute()
  51.     fmt.Printf("%+v\n", basicFinancials)
  53.     // Company earnings
  54.     earningsSurprises, _, err := finnhubClient.CompanyEarnings(context.Background()).Symbol("AAPL").Execute()
  55.     fmt.Printf("%+v\n", earningsSurprises)
  57.     // Company EPS estimates
  58.     epsEstimate, _, err := finnhubClient.CompanyEpsEstimates(context.Background()).Symbol("AAPL").Execute()
  59.     fmt.Printf("%+v\n", epsEstimate)
  61.     // Company executive
  62.     executive, _, err := finnhubClient.CompanyExecutive(context.Background()).Symbol("AAPL").Execute()
  63.     fmt.Printf("%+v\n", executive)
  65.     // Company peers
  66.     peers, _, err := finnhubClient.CompanyPeers(context.Background()).Symbol("AAPL").Execute()
  67.     fmt.Printf("%+v\n", peers)
  69.     // Company profile
  70.     profile, _, err := finnhubClient.CompanyProfile(context.Background()).Symbol("AAPL").Execute()
  71.     fmt.Printf("%+v\n", profile)
  73.     profileISIN, _, err := finnhubClient.CompanyProfile(context.Background()).Isin("US0378331005").Execute()
  74.     fmt.Printf("%+v\n", profileISIN)
  76.     profileCusip, _, err := finnhubClient.CompanyProfile(context.Background()).Cusip("037833100").Execute()
  77.     fmt.Printf("%+v\n", profileCusip)
  79.     // Company profile2
  80.     profile2, _, err := finnhubClient.CompanyProfile2(context.Background()).Symbol("AAPL").Execute()
  81.     fmt.Printf("%+v\n", profile2)
  83.     // Revenue Estimates
  84.     revenueEstimates, _, err := finnhubClient.CompanyRevenueEstimates(context.Background()).Symbol("AAPL").Execute()
  85.     fmt.Printf("%+v\n", revenueEstimates)
  87.     // List country
  88.     countries, _, err := finnhubClient.Country(context.Background()).Execute()
  89.     fmt.Printf("%+v\n", countries)
  91.     // Covid-19
  92.     covid19, _, err := finnhubClient.Covid19(context.Background()).Execute()
  93.     fmt.Printf("%+v\n", covid19)
  95.     // FDA Calendar
  96.     fdaCalendar, _, err := finnhubClient.FdaCommitteeMeetingCalendar(context.Background()).Execute()
  97.     fmt.Printf("%+v\n", fdaCalendar)
  99.     // Crypto candles
  100.     cryptoCandles, _, err := finnhubClient.CryptoCandles(context.Background()).Symbol("BINANCE:BTCUSDT").Resolution("D").From(1590988249).To(1591852249).Execute()
  101.     fmt.Printf("%+v\n", cryptoCandles)
  103.     // Crypto exchanges
  104.     cryptoExchange, _, err := finnhubClient.CryptoExchanges(context.Background()).Execute()
  105.     fmt.Printf("%+v\n", cryptoExchange)
  107.     // Crypto symbols
  108.     cryptoSymbol, _, err := finnhubClient.CryptoSymbols(context.Background()).Exchange("BINANCE").Execute()
  109.     fmt.Printf("%+v\n", cryptoSymbol[0:5])
  111.     // Economic Calendar
  112.     economicCalendar, _, err := finnhubClient.EconomicCalendar(context.Background()).Execute()
  113.     fmt.Printf("%+v\n", economicCalendar)
  115.     // Economic code
  116.     economicCode, _, err := finnhubClient.EconomicCode(context.Background()).Execute()
  117.     fmt.Printf("%+v\n", economicCode)
  119.     // Economic data
  120.     economicData, _, err := finnhubClient.EconomicData(context.Background()).Code("MA-USA-656880").Execute()
  121.     fmt.Printf("%+v\n", economicData)
  123.     // Filings
  124.     filings, _, err := finnhubClient.Filings(context.Background()).Symbol("AAPL").Execute()
  125.     fmt.Printf("%+v\n", filings)
  127.     // International filings
  128.     internationalFilings, _, err := finnhubClient.InternationalFilings(context.Background()).Symbol("RY.TO").Execute()
  129.     fmt.Printf("%+v\n", internationalFilings)
  131.     // Filings Sentiment
  132.     filingsSentiment, _, err := finnhubClient.FilingsSentiment(context.Background()).AccessNumber("0000320193-20-000052").Execute()
  133.     fmt.Printf("%+v\n", filingsSentiment)
  135.     // Similarity Index
  136.     similarityIndex, _, err := finnhubClient.SimilarityIndex(context.Background()).Symbol("AAPL").Execute()
  137.     fmt.Printf("%+v\n", similarityIndex)
  139.     // Financials
  140.     financials, _, err := finnhubClient.Financials(context.Background()).Symbol("AAPL").Statement("bs").Freq("annual").Execute()
  141.     fmt.Printf("%+v\n", financials)
  143.     // Financials Reported
  144.     financialsReported, _, err := finnhubClient.FinancialsReported(context.Background()).Symbol("AAPL").Execute()
  145.     fmt.Printf("%+v\n", financialsReported)
  147.     // Forex candles
  148.     forexCandles, _, err := finnhubClient.ForexCandles(context.Background()).Symbol("OANDA:EUR_USD").Resolution("D").From(1590988249).To(1591852249).Execute()
  149.     fmt.Printf("%+v\n", forexCandles)
  151.     // Forex exchanges
  152.     forexExchanges, _, err := finnhubClient.ForexExchanges(context.Background()).Execute()
  153.     fmt.Printf("%+v\n", forexExchanges)
  155.     // Forex rates
  156.     forexRates, _, err := finnhubClient.ForexRates(context.Background()).Base("USD").Execute()
  157.     fmt.Printf("%+v\n", forexRates)
  159.     // Forex symbols
  160.     forexSymbols, _, err := finnhubClient.ForexSymbols(context.Background()).Exchange("OANDA").Execute()
  161.     fmt.Printf("%+v\n", forexSymbols)
  163.     // Fund ownership
  164.     fundOwnership, _, err := finnhubClient.FundOwnership(context.Background()).Symbol("AAPL").Execute()
  165.     fmt.Printf("%+v\n", fundOwnership)
  167.     // General news
  168.     generalNews, _, err := finnhubClient.MarketNews(context.Background()).Category("general").Execute()
  169.     fmt.Printf("%+v\n", generalNews)
  171.     // Ipo calendar
  172.     ipoCalendar, _, err := finnhubClient.IpoCalendar(context.Background()).From("2021-01-01").To("2021-06-30").Execute()
  173.     fmt.Printf("%+v\n", ipoCalendar)
  175.     // Press Releases
  176.     majorDevelopment, _, err := finnhubClient.PressReleases(context.Background()).Symbol("AAPL").Execute()
  177.     fmt.Printf("%+v\n", majorDevelopment)
  179.     // News sentiment
  180.     newsSentiment, _, err := finnhubClient.NewsSentiment(context.Background()).Symbol("AAPL").Execute()
  181.     fmt.Printf("%+v\n", newsSentiment)
  183.     // Pattern recognition
  184.     patterns, _, err := finnhubClient.PatternRecognition(context.Background()).Symbol("AAPL").Resolution("D").Execute()
  185.     fmt.Printf("%+v\n", patterns)
  187.     // Price target
  188.     priceTarget, _, err := finnhubClient.PriceTarget(context.Background()).Symbol("AAPL").Execute()
  189.     fmt.Printf("%+v\n", priceTarget)
  191.     // Quote
  192.     quote, _, err := finnhubClient.Quote(context.Background()).Symbol("AAPL").Execute()
  193.     fmt.Printf("%+v\n", quote)
  195.     // Recommendation trends
  196.     recommendationTrend, _, err := finnhubClient.RecommendationTrends(context.Background()).Symbol("AAPL").Execute()
  197.     fmt.Printf("%+v\n", recommendationTrend)
  199.     // Stock dividends
  200.     dividends, _, err := finnhubClient.StockDividends(context.Background()).Symbol("KO").From("2019-01-01").To("2021-01-01").Execute()
  201.     fmt.Printf("%+v\n", dividends)
  203.     // Splits
  204.     splits, _, err := finnhubClient.StockSplits(context.Background()).Symbol("AAPL").From("2000-01-01").To("2020-06-15").Execute()
  205.     fmt.Printf("%+v\n", splits)
  207.     // Stock symbols
  208.     stockSymbols, _, err := finnhubClient.StockSymbols(context.Background()).Exchange("US").Execute()
  209.     fmt.Printf("%+v\n", stockSymbols[0:5])
  211.     // Support resistance
  212.     supportResitance, _, err := finnhubClient.SupportResistance(context.Background()).Symbol("AAPL").Resolution("D").Execute()
  213.     fmt.Printf("%+v\n", supportResitance)
  215.     // Technical indicator
  216.     technicalIndicator, _, err := finnhubClient.TechnicalIndicator(context.Background()).Symbol("AAPL").Resolution("D").From(1583098857).To(1584308457).Indicator("sma").IndicatorFields(map[string]interface{}{"timeperiod": 3}).Execute()
  217.     fmt.Printf("%+v\n", technicalIndicator)
  219.     // Transcripts
  220.     transcripts, _, err := finnhubClient.Transcripts(context.Background()).Id("AAPL_162777").Execute()
  221.     fmt.Printf("%+v\n", transcripts)
  223.     // Transcripts list
  224.     transcriptsList, _, err := finnhubClient.TranscriptsList(context.Background()).Symbol("AAPL").Execute()
  225.     fmt.Printf("%+v\n", transcriptsList)
  227.     // Upgrade/downgrade
  228.     upgradeDowngrade, _, err := finnhubClient.UpgradeDowngrade(context.Background()).Symbol("BYND").Execute()
  229.     fmt.Printf("%+v\n", upgradeDowngrade)
  231.     // Tick Data
  232.     tickData, _, err := finnhubClient.StockTick(context.Background()).Symbol("AAPL").Date("2021-07-23").Limit(50).Skip(0).Execute()
  233.     fmt.Printf("%+v\n", tickData)
  235.     // Indices Constituents
  236.     indicesConstData, _, err := finnhubClient.IndicesConstituents(context.Background()).Symbol("^GSPC").Execute()
  237.     fmt.Printf("%+v\n", indicesConstData)
  239.     // Indices Historical Constituents
  240.     indicesHistoricalConstData, _, err := finnhubClient.IndicesHistoricalConstituents(context.Background()).Symbol("^GSPC").Execute()
  241.     fmt.Printf("%+v\n", indicesHistoricalConstData)
  243.     // ETFs Profile
  244.     etfsProfileData, _, err := finnhubClient.EtfsProfile(context.Background()).Symbol("SPY").Execute()
  245.     fmt.Printf("%+v\n", etfsProfileData)
  247.     // ETFs Holdings
  248.     etfsHoldingsData, _, err := finnhubClient.EtfsHoldings(context.Background()).Symbol("SPY").Execute()
  249.     fmt.Printf("%+v\n", etfsHoldingsData)
  251.     // ETFs Industry Exposure
  252.     etfsIndustryExposureData, _, err := finnhubClient.EtfsSectorExposure(context.Background()).Symbol("SPY").Execute()
  253.     fmt.Printf("%+v\n", etfsIndustryExposureData)
  255.     // ETFs Country Exposure
  256.     etfsCountryExposureData, _, err := finnhubClient.EtfsCountryExposure(context.Background()).Symbol("SPY").Execute()
  257.     fmt.Printf("%+v\n", etfsCountryExposureData)
  259.     // Mutual Funds Profile
  260.     mfProfileData, _, err := finnhubClient.MutualFundProfile(context.Background()).Symbol("VTSAX").Execute()
  261.     fmt.Printf("%+v\n", mfProfileData)
  263.     // Mutual Funds Holdings
  264.     mfHoldingsData, _, err := finnhubClient.MutualFundHoldings(context.Background()).Symbol("VTSAX").Execute()
  265.     fmt.Printf("%+v\n", mfHoldingsData)
  267.     // Mutual Funds Industry Exposure
  268.     mfIndustryExposureData, _, err := finnhubClient.MutualFundSectorExposure(context.Background()).Symbol("VTSAX").Execute()
  269.     fmt.Printf("%+v\n", mfIndustryExposureData)
  271.     // Mutual Funds Country Exposure
  272.     mfCountryExposureData, _, err := finnhubClient.MutualFundCountryExposure(context.Background()).Symbol("VTSAX").Execute()
  273.     fmt.Printf("%+v\n", mfCountryExposureData)
  275.     // Insider Transactions
  276.     insiderTransactions, _, err := finnhubClient.InsiderTransactions(context.Background()).Symbol("AAPL").From("2021-01-01").To("2021-07-30").Execute()
  277.     fmt.Printf("%+v\n", insiderTransactions)
  279.     // Revenue breakdown
  280.     revenueBreakdown, _, err := finnhubClient.RevenueBreakdown(context.Background()).Symbol("AAPL").Execute()
  281.     fmt.Printf("%+v\n", revenueBreakdown)
  283.     // Social Sentiment
  284.     socialSentiment, _, err := finnhubClient.SocialSentiment(context.Background()).Symbol("GME").Execute()
  285.     fmt.Printf("%+v\n", socialSentiment)
  287.     // Investment theme
  288.     investmentTheme, _, err := finnhubClient.InvestmentThemes(context.Background()).Theme("financialExchangesData").Execute()
  289.     fmt.Printf("%+v\n", investmentTheme)
  291.     // Supply chain
  292.     supplyChain, _, err := finnhubClient.SupplyChainRelationships(context.Background()).Symbol("AAPL").Execute()
  293.     fmt.Printf("%+v\n", supplyChain)
  295.     //Symbol lookup
  296.     searchResult, _, err := finnhubClient.SymbolSearch(context.Background()).Q("AAPL").Execute()
  297.     fmt.Printf("%+v\n", searchResult)
  299.     // Company ESG
  300.     companyESGScore, _, err := finnhubClient.CompanyEsgScore(context.Background()).Symbol("AAPL").Execute()
  301.     fmt.Printf("%+v\n", companyESGScore)
  303.     // Company Earnings Quality Score
  304.     earningsQualityScore, _, err := finnhubClient.CompanyEarningsQualityScore(context.Background()).Symbol("AAPL").Freq("quarterly").Execute()
  305.     if err != nil {
  306.         panic(err)
  307.     }
  308.     fmt.Printf("%+v\n", earningsQualityScore)   
  310.     // Crypto Profile
  311.     cryptoProfile, _, err := finnhubClient.CryptoProfile(context.Background()).Symbol("BTC").Execute()
  312.     if err != nil {
  313.         panic(err)
  314.     }
  315.     fmt.Println(objectString(cryptoProfile))
  317.     // EBITDA Estimates
  318.     ebitdaEstimates, _, err := finnhubClient.CompanyEbitdaEstimates(context.Background()).Symbol("AAPL").Freq("annual").Execute()
  319.     if err != nil {
  320.         panic(err)
  321.     }
  322.     fmt.Printf("%+v\n", ebitdaEstimates)
  324.     // EBIT Estimates
  325.     ebitEstimates, _, err := finnhubClient.CompanyEbitEstimates(context.Background()).Symbol("AAPL").Freq("annual").Execute()
  326.     if err != nil {
  327.         panic(err)
  328.     }
  329.     fmt.Printf("%+v\n", ebitEstimates)
  331.     // USPTO Patent
  332.     uspto, _, err := finnhubClient.StockUsptoPatent(context.Background()).Symbol("NVDA").From("2021-01-01").To("2021-12-31").Execute()
  333.     if err != nil {
  334.         panic(err)
  335.     }
  336.     fmt.Printf("%+v\n", uspto)
  338.     // Visa Application
  339.     visa, _, err := finnhubClient.StockVisaApplication(context.Background()).Symbol("AAPL").From("2021-01-01").To("2021-12-31").Execute()
  340.     if err != nil {
  341.         panic(err)
  342.     }
  343.     fmt.Printf("%+v\n", visa)
  345.     sectorMetric, _, err := finnhubClient.SectorMetric(context.Background()).Region("NA").Execute()
  346.     if err != nil {
  347.         panic(err)
  348.     }
  349.     fmt.Printf("%+v\n", sectorMetric)
  351. }

License

Apache License