Finnhub-Stock-API/finnhub-python — reverse-engineered prompt

Build me a simple Python client library for the Finnhub financial data API. I want to give it my API key once, then call friendly methods to get stock quotes, candles, company profiles, financials, earnings, analyst recommendations, news, sentiment, IPO and economic calendars, forex and crypto prices, ETF and mutual fund details, insider activity, filings, and basic bond data.

It should return normal Python dictionaries or lists so I can print results or turn them into a pandas data frame. Include a small examples file that shows common calls for tickers like AAPL, TSLA, AMZN, SPY, BTC, and EUR USD.

Make the package installable with pip, include basic error handling for bad API keys and API failures, and add tests for the client setup and a few mocked endpoints. Keep it easy to read and close to the Finnhub docs. Look up the current API docs online if you need to.