token_data

Developer Guide

If you are new to using nbdev here are some useful pointers to get you started.

Install token_data in Development mode

# make sure token_data package is installed in development mode
$ pip install -e .

# make changes under nbs/ directory
# ...

# compile to have changes apply to token_data
$ nbdev_prepare

Usage

Installation

Install latest from the GitHub repository:

$ pip install git+https://github.com/silvaac/token_data.git

or from pypi

$ pip install token_data

Documentation

Documentation can be found hosted on this GitHub repository’s pages. Additionally you can find package manager specific guidelines on conda and pypi respectively.

How to use

Simple example to pull ETH perpetual price history from Hyperliquid. See documents for more complex use cases.

from token_data.hyperliquid import *
from hyperliquid.utils import constants
address, info, exchange = setup(base_url=constants.MAINNET_API_URL, skip_ws=True)
manager = HyperliquidPerpManager(ticker='ETH',update=True, save=False, verbose=True,info=info)
manager.get_data()

Processing 1 perpetual tokens...
Warning: Processing 1 perpetual tokens exceeds the maximum number of requests per minute. Adjusting waiting time to 2 seconds.
Loaded 6250 rows for ETH from ../data/hyperliquid/perp/ETH_1h.parquet
Updating ETH from 2025-12-04T00:00:00Z
Retrieved 25 new rows for ETH
Added 0 new rows for ETH

For coinbase data (only spot prices are supported):

from token_data.coinbase import *
# Pull data from coinbase and save it to "./data/coinbase" folder. See function for details.
coinbase_to_file(token_list=['OP-USD'],type="parquet",all_tokens=False)

Processing OP-USD
2025-11-17 09:00:00+00:00
2025-12-05 00:32:14.730630+00:00
OP-USD is not listed.