Cryptocurrency Exchange Feed Handler
Handles multiple cryptocurrency exchange data feeds and returns normalized and standardized results to client registered callbacks for events like trades, book updates, ticker updates, etc. Utilizes websockets when possible, but can also poll data via REST endpoints if a websocket is not provided.
Supported exchanges
- Bitfinex
- bitFlyer
- Bithumb
- Bitstamp
- Bybit
- Binance
- Binance Delivery
- Binance Futures
- Binance US
- Bitget
- Coinbase
- Crypto.com
- Deribit
- Gate
- Gate Futures
- dYdX v4
- Gemini
- Hyperliquid
- HTX (formerly Huobi)
- HTX Swap (Coin-M and USDT-M)
- Independent Reserve
- Kraken
- MEXC (spot)
- Kraken Futures
- KuCoin
- OKX
- Phemex
- Poloniex
- Upbit
Basic Usage
Create a FeedHandler object and add subscriptions. For the various data channels that an exchange supports, you can supply callbacks for data events, or use provided backends (described below) to handle the data for you. Start the feed handler and you're done!
from cryptofeed import FeedHandler
# not all imports shown for clarity
fh = FeedHandler()
# ticker, trade and book are user defined coroutine functions, each taking the
# normalized object and the timestamp cryptofeed received the message at:
#
# async def trade(t, receipt_timestamp):
# print(f'{t.exchange} {t.symbol} {t.side} {t.amount} @ {t.price}')
#
# a callback must be async - wrap a synchronous one in cryptofeed.callback.ExecutorCallback
ticker_cb = {TICKER: ticker}
trade_cb = {TRADES: trade}
gemini_cb = {TRADES: trade, L2_BOOK: book}
fh.add_feed(Coinbase(symbols=['BTC-USD'], channels=[TICKER], callbacks=ticker_cb))
fh.add_feed(Bitfinex(symbols=['BTC-USD'], channels=[TICKER], callbacks=ticker_cb))
fh.add_feed(Poloniex(symbols=['BTC-USDT'], channels=[TRADES], callbacks=trade_cb))
fh.add_feed(Gemini(symbols=['BTC-USD', 'ETH-USD'], channels=[TRADES, L2_BOOK], callbacks=gemini_cb))
fh.run()
National Best Bid/Offer (NBBO)
Cryptofeed also provides a synthetic NBBO (National Best Bid/Offer) feed that aggregates the best bids and asks from the user specified feeds.
from cryptofeed import FeedHandler
from cryptofeed.exchanges import Coinbase, Gemini, Kraken
async def nbbo_update(symbol, bid, bid_size, ask, ask_size, bid_feed, ask_feed):
print(f'Pair: {symbol} Bid Price: {bid:.2f} Bid Size: {bid_size:.6f} Bid Feed: {bid_feed} Ask Price: {ask:.2f} Ask Size: {ask_size:.6f} Ask Feed: {ask_feed}')
def main():
f = FeedHandler()
f.add_nbbo([Coinbase, Kraken, Gemini], ['BTC-USD'], nbbo_update)
f.run()
Supported Channels
Cryptofeed supports the following public data channels from exchanges
- L1_BOOK - Top of book
- L2_BOOK - Price aggregated sizes. Some exchanges provide the entire depth, some provide a subset.
- L3_BOOK - Price aggregated orders. Like the L2 book, some exchanges may only provide partial depth.
- TRADES - Note this reports the taker's side, even for exchanges that report the maker side.
- TICKER
- FUNDING
- OPEN_INTEREST - Open interest data.
- LIQUIDATIONS
- INDEX
- CANDLES - Candlestick / K-Line data.
Backends
Cryptofeed supports backend callbacks that will write directly to storage or other interfaces.
Supported Backends:
- Redis (Sorted Sets, Streams and Keys)
- ZeroMQ
- UDP Sockets
- TCP Sockets
- Unix Domain Sockets
- InfluxDB v2
- MongoDB
- Kafka
- PostgreSQL
- QuestDB
Data Capture and Replay
Cryptofeed can record data from data feeds to standard pcap files for later replay
from cryptofeed import FeedHandler
# `record` is a pcap file path or a directory
fh = FeedHandler(record='sample_data/')
fh.add_feed('COINBASE', symbols=['BTC-USD'], channels=[TRADES, L2_BOOK], callbacks=...)
fh.run()
examples/record.py wraps this into a small recording tool. The pcaps are zstandaard compressed by default. Wireshark and tshark open these files natively and playback decompresses transparently. Metadata is stored in .meta.json.
Installation
Note: cryptofeed requires Python 3.13+
Cryptofeed can be installed from PyPi. (It's recommended that you install in a virtual environment of your choosing).
pip install cryptofeed
Cryptofeed has optional dependencies, depending on the backends used. You can install them individually, or all at once. To install Cryptofeed along with all its optional dependencies in one bundle:
pip install cryptofeed[all]
If you wish to clone the repository and work on it (development uses uv), run this from the root of the cloned repository:
uv sync
Alternatively, you can install from source in editable mode with pip:
pip install -e .
Performance
Measured on Python 3.14.6 based on throughput over real recorded exchange traffic.
| Operation | Result |
|---|---|
Trade construct / to_dict / from_dict |
102 ns / 214 ns / 277 ns |
Ticker / Candle / Funding construct |
70 ns / 118 ns / 141 ns |
| Book single level update / delete / top-of-book read | 89 ns / 124 ns / 140 ns |
Book to_dict, 10 / 100 levels per side |
2.4 µs / 22.2 µs |
| Checksum, Kraken / OKX format (200 levels) | 2.0 µs / 6.1 µs |
JSON decode with Decimal (msgspec / stdlib fallback) |
1.39M / 0.60M msg/s |
| JSON encode to str / bytes | 4.65M / 5.25M msg/s |
| Message handler, Kraken / Bybit / KuCoin / Kraken Futures | 161k / 134k / 122k / ~100k frames/s |
Future Work
There are a lot of planned features, new exchanges, etc planned! If you'd like to discuss ongoing development, please join the discord or open a thread in the discussions in GitHub.
Contributing
Issues and PRs are welcomed!
Cryptofeed wouldn't be possible without the help of many contributors! I owe them and all other contributors my thanks!
Donations / Support
Support and donations are appreciated but not required. You can donate via GitHub Sponsors, or via the addresses below:
- Bitcoin: bc1qm0kxz8hqacaglku5fjhfe9a5hjnuyfwk02lsyr
- Ethereum: 0x690709FEe13eEce9E7852089BB2D53Ae5D073154
1 maintainer
Release files for cryptofeed 3.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cryptofeed-3.0.1.tar.gz | 148.4 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cryptofeed-3.0.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 | Details |
| cryptofeed-3.0.1-cp314-cp314t-macosx_11_0_arm64.whl | CPython 3.14 | CPython 3.14 free-threading | macOS 11.0+ ARM64 | Details |
| cryptofeed-3.0.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 | Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 | Details |
| cryptofeed-3.0.1-cp314-cp314-macosx_11_0_arm64.whl | CPython 3.14 | CPython 3.14 | macOS 11.0+ ARM64 | Details |
| cryptofeed-3.0.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| cryptofeed-3.0.1-cp313-cp313-macosx_11_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 11.0+ ARM64 | Details |
Total release size: 4.8 MB
Release files / cryptofeed-3.0.1.tar.gz
| Download URL | cryptofeed-3.0.1.tar.gz |
|---|---|
| Size | 148.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b9b8cb7947232aada42fc1f1c21486f6b3217a7b27a4d71822e4931d4bdb9b20
|
|
BLAKE2b-256 checksum How to use checksums |
70da319fc09ad0a032079413aba6d9499667dbb26b50e416dce6fa62c2ba2b5a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency logRelease files / cryptofeed-3.0.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | cryptofeed-3.0.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
e77c4ca80b614b1fff3dad59c44bef1947ae76aff7f9bbc6efb42a4387e7ff3b
|
|
BLAKE2b-256 checksum How to use checksums |
06201c16fe60fcf4c5678737ffbd80b54726b2fcd19c09f1eb37d5b337681510
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency logRelease files / cryptofeed-3.0.1-cp314-cp314t-macosx_11_0_arm64.whl
| Download URL | cryptofeed-3.0.1-cp314-cp314t-macosx_11_0_arm64.whl |
|---|---|
| Size | 324.2 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
0e6ab3b20f3b523e7f23248d3bfd0e17b00b2519ec5eabcc5ec79799c7107c77
|
|
BLAKE2b-256 checksum How to use checksums |
20fb7ec7edd6884f4da8c5c635555b19555281aba2adad44345381e7080ac17d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency logRelease files / cryptofeed-3.0.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | cryptofeed-3.0.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
9b3958a047dd43e76486df37fd156e1ddc9e66782e605460abf006b038d8287c
|
|
BLAKE2b-256 checksum How to use checksums |
41925eb2c3d17f1ea8a504cbc9c056c729a7aae56344e556eaeecb1a9355793a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency logRelease files / cryptofeed-3.0.1-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | cryptofeed-3.0.1-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 305.5 kB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4900efdf4f1d54794817385645fe0b95f55439634f7abb69b98c35e9cbe53649
|
|
BLAKE2b-256 checksum How to use checksums |
ecd59a5a3cdd2eacb98c48f16f3e3197d2ba6b47c81a2bf31b4bfe264f433e95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency logRelease files / cryptofeed-3.0.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | cryptofeed-3.0.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
4cc2cf09605f4814f51a9afdd90830230f64f434cedc2c82368cbd7216136dd9
|
|
BLAKE2b-256 checksum How to use checksums |
003e2ed988e6200f8797b28a10435923a000b9d0cbd26eef810b37270424d14c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency logRelease files / cryptofeed-3.0.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | cryptofeed-3.0.1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 303.8 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
747a5c107e3da1a23059b53c4cf042af8c0bb0903bd92f73fdfb42fc30641188
|
|
BLAKE2b-256 checksum How to use checksums |
44db6d1d558e0ad3f32ac5b571029dfb34713964149fa8eb8e079616be360c6c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency log
