dwker/lightweight-charts-python
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
06b605d3a713c6140b90a582e0fba7a4b62f4ba2
lightweight-charts-python/docs/source/polygon.md
louisnw 06b605d3a7 Enhancements and Bug Fixes 
Tables Feature
- Added the `create_table` method, which returns a `Table` object. This can be used to display watchlists, order windows, position windows and more.
- See the new page on the docs for more information!

Bugs
- Fixed a bug preventing the named column of a line to not work as a label of the series.
- Fixed a bug causing drawings loaded from the minute timeframe to not show on a daily timeframe.
- Fixed a bug causing `chart.exit` to not work.
- Fixed a bug preventing the chart from being moved after placing a ray.
- Fixed the ‘price in hoveringOver’ web console error.

Enhancements
- The date/time column can also be the `name` of the passed series object.
- Added the `label` method to `HorizontalLine`, allowing for the price line label of horizontal lines to be updated.
- `None` or an empty DataFrame can now be passed to `line.set` as a means to clear it.
- Seperate Chart objects will now run on the same pywebview instance. This means that any Chart objects created after the first will inherit the first Chart’s API.
- Reorganized the documentation for clarity.
2023-08-02 13:47:52 +01:00

4.8 KiB
Raw Blame History

Polygon.io

Polygon.io's market data API is directly integrated within lightweight-charts-python, and is easy to use within the library.

Requirements

To use data from Polygon, there are certain libraries (not listed as requirements) that must be installed:

  • Static data requires the requests library.
  • Live data requires the websockets library.

polygon

polygon is a Common Method, and can be accessed from within any chart type.

chart.polygon.<method>

The stock, option, index, forex, and crypto methods of chart.polygon have common parameters:

  • timeframe: The timeframe to be used ('1min', '5min', 'H', '2D', '5W' etc.)
  • start_date: The start date given in the format YYYY-MM-DD.
  • end_date: The end date given in the same format. By default this is 'now', which uses the time now.
  • limit: The maximum number of base aggregates to be queried to create the aggregate results.
  • live: When set to True, a websocket connection will be used to update the chart or subchart in real-time.
  • These methods will also return a boolean representing whether the request was successful.
When using live data and the standard `show` method, the `block` parameter __must__ be set to `True` in order for the data to congregate on the chart (`chart.show(block=True)`).
If `show_async` is used with live data, `block` can be either value.

Example:

from lightweight_charts import Chart

if __name__ == '__main__':
    chart = Chart()
    chart.polygon.api_key('<API-KEY>')
    chart.polygon.stock(
        symbol='AAPL',
        timeframe='5min',
        start_date='2023-06-09'
    )
    chart.show(block=True)

api_key

key: str

Sets the API key for the chart. Subsequent SubChart objects will inherit the API key given to the parent chart.

stock

symbol: str | timeframe: str | start_date: str | end_date: str | limit: int | live: bool | -> bool

Requests and displays stock data pulled from Polygon.io.

option

symbol: str | timeframe: str | start_date: str | expiration | right: 'C' | 'P' | strike: int | float | end_date: str | limit: int | live: bool | -> bool

Requests and displays option data pulled from Polygon.io.

A formatted option ticker (SPY251219C00650000) can also be given to the symbol parameter, allowing for expiration, right, and strike to be left blank.

index

symbol: str | timeframe: str | start_date: str | end_date: str | limit: int | live: bool | -> bool

Requests and displays index data pulled from Polygon.io.

forex

fiat_pair: str | timeframe: str | start_date: str | end_date: str | limit: int | live: bool | -> bool

Requests and displays a forex pair pulled from Polygon.io.

The two currencies should be separated by a '-' (USD-CAD, GBP-JPY, etc.).

crypto

crypto_pair: str | timeframe: str | start_date: str | end_date: str | limit: int | live: bool | -> bool

Requests and displays a crypto pair pulled from Polygon.io.

The two currencies should be separated by a '-' (BTC-USD, ETH-BTC, etc.).

log

info: bool

If True, informational log messages (connection, subscriptions etc.) will be displayed in the console.

Data errors will always be shown in the console.

PolygonChart

api_key: str | live: bool | num_bars: int

The PolygonChart provides an easy and complete way to use the Polygon.io API within lightweight-charts-python.

This object requires the requests library for static data, and the websockets library for live data.

All data is requested within the chart window through searching and selectors.

As well as the parameters from the Chart object, PolygonChart also has the parameters:

  • api_key: The user's Polygon.io API key.
  • num_bars: The target number of bars to be displayed on the chart
  • limit: The maximum number of base aggregates to be queried to create the aggregate results.
  • end_date: The end date of the time window.
  • timeframe_options: The selectors to be included within the timeframe selector.
  • security_options: The selectors to be included within the security selector.
  • live: If True, the chart will update in real-time.

Example:

from lightweight_charts import PolygonChart

if __name__ == '__main__':
    chart = PolygonChart(api_key='<API-KEY>',
                         num_bars=200,
                         limit=5000,
                         live=True)
    chart.show(block=True)

PolygonChart png