token-data 0.0.4

Token data from a series of sources

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

<style scoped> .dataframe tbody tr th:only-of-type { vertical-align: middle; } .dataframe tbody tr th { vertical-align: top; } .dataframe thead th { text-align: right; } </style>

	datetime	open	high	low	close	volume	coin
0	2025-03-19 15:00:00	2030.7	2056.7	2026.0	2048.7	30206.2723	ETH
1	2025-03-19 16:00:00	2048.7	2049.2	2035.3	2047.4	22198.4803	ETH
2	2025-03-19 17:00:00	2047.4	2048.9	2014.3	2026.1	35909.8007	ETH
3	2025-03-19 18:00:00	2026.1	2059.9	1998.0	2045.0	84148.3569	ETH
4	2025-03-19 19:00:00	2045.1	2052.1	2020.1	2029.7	38921.5619	ETH
...	...	...	...	...	...	...	...
6245	2025-12-04 20:00:00	3117.9	3143.8	3104.4	3140.5	15553.2974	ETH
6246	2025-12-04 21:00:00	3140.2	3150.0	3117.2	3121.8	13448.5987	ETH
6247	2025-12-04 22:00:00	3122.1	3147.2	3121.5	3142.4	11888.6633	ETH
6248	2025-12-04 23:00:00	3142.6	3142.6	3127.9	3131.7	4731.0506	ETH
6249	2025-12-05 00:00:00	3131.8	3156.0	3131.4	3147.8	10836.3869	ETH

6250 rows × 7 columns

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.