https://github.com/epam/timebasecryptoconnectors
TimeBase Crypto Market Data Connectors
https://github.com/epam/timebasecryptoconnectors
bitfinex bitmex bitpanda coinbase crypto cryptocurrency cryptocurrency-prices exchange feed feeds finance hitbtc huobi java kraken market-data market-data-feeds okex trading
Last synced: 3 months ago
JSON representation
TimeBase Crypto Market Data Connectors
- Host: GitHub
- URL: https://github.com/epam/timebasecryptoconnectors
- Owner: epam
- License: apache-2.0
- Created: 2022-03-23T14:26:36.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-06-20T16:26:21.000Z (4 months ago)
- Last Synced: 2025-06-20T17:34:14.340Z (4 months ago)
- Topics: bitfinex, bitmex, bitpanda, coinbase, crypto, cryptocurrency, cryptocurrency-prices, exchange, feed, feeds, finance, hitbtc, huobi, java, kraken, market-data, market-data-feeds, okex, trading
- Language: Java
- Homepage:
- Size: 1.33 MB
- Stars: 33
- Watchers: 8
- Forks: 7
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TimeBase Crypto Market Data Connectors
[](https://github.com/epam/TimebaseCryptoConnectors/actions/workflows/build.yml)
With [TimeBase Community Edition](https://github.com/finos/TimeBase-CE) you get access to free [market data connectors](#supported-crypto-exchanges) you can use to receive normalized market data with any level of granularity (top of the book, L2) from the most popular crypto exchanges and recording it in [TimeBase](https://kb.timebase.info/) **in a matter of minutes**.
## Quick Start - setup market data collection in 60 seconds:
### Prerequisites
**Windows**
* [Install WSL](https://docs.microsoft.com/en-us/windows/wsl/install).
* [Install Docker](https://docs.docker.com/desktop/windows/install/) on your Windows machine.
**Linux**
* [Install Docker Engine](https://docs.docker.com/engine/install/).
* [Install Docker Compose](https://docs.docker.com/compose/install/).
### Start Connectors
1. Download sample [docker-compose.yml](https://raw.githubusercontent.com/epam/TimebaseCryptoConnectors/main/docs/docker-compose.yml)
2. Run `docker-compose up` command from the directory with your docker-compose.yml file to launch TimeBase crypto connectors.
3. View live and historical market data stored in [TimeBase](https://kb.timebase.info/community/development/tools/Web%20Admin/admin_guide#stream-actions-monitor) in your browser at [localhost:8099](http://localhost:8099) (default username **admin** and password **admin**):
https://user-images.githubusercontent.com/46220620/172610668-e9fcd008-4a49-477e-93ba-45038ca9a3d4.mp4
## Build and Run
Build the project with [Gradle](http://gradle.org/) using this
[build.gradle](https://github.com/epam/TimebaseCryptoConnectors/blob/main/build.gradle) file.
You will require the Java 11+ and Gradle 8.6 to build:
Full clean and build of all modules
```shell
$ ./gradlew clean build
```
And start it
```shell
$ ./bin/runner.sh
```
### Configuration
By default, we launch with the [default](https://raw.githubusercontent.com/epam/TimebaseCryptoConnectors/main/java/runner/src/main/resources/application.yaml) configuration to start all the available data connectors. Recorded market data is saved into `/timebase-home` directory. You can create custom configurations to run just the selected connectors with specific settings.
> Refer to the [configuration](https://github.com/epam/TimebaseCryptoConnectors/blob/main/docs/configuration.md) to learn how to configure.
> Refer to the [developers tutorials](https://github.com/epam/TimebaseCryptoConnectors/blob/main/docs/developer.md) for more in depth information about data model and tutorials on how to develop custom data connectors.
## Supported Crypto Exchanges
|Exchange|Supported Contracts|
|------|------------------|
|[AscendEX](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/ascendex)|SPOT, Linear Futures|
|[BYBIT](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/bybit)| SPOT, Inverse and Linear Futures, Options|
|[BITFINEX](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/bitfinex)|SPOT, Linear Futures|
|[BITMART](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/bitmart)|SPOT|
|[BitMEX](java/connectors/bitmex/README.md)|Quanto Contract, Inverse Perpetual SWAP, Linear Perpetual, Quanto Perpetual, Linear Futures, Quanto Futures, Inverse Futures|
|[Coinbase](https://github.com/epam/TimebaseCryptoConnectors/blob/main/java/connectors/coinbase/README.md)|SPOT|
|[CRYPTOFACILITIES](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/cryptofacilities)|Linear Futures|
|[DERIBIT](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/deribit)|Inverse and Linear Futures, Options, Perpetual|
|[HITBTC](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/cryptofacilities)|SPOT|
|[HUOBI FUTURES](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/huobi-futures)|Inverse Futures|
|[HUOBI SPOT](https://github.com/epam/TimebaseCryptoConnectors/blob/main/java/connectors/huobi-spot/README.md)|SPOT|
|[Kraken FUTURES](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/kraken-futures)|Inverse and Linear Perpetual SWAP, Inverse Futures with Expiration|
|[Kraken SPOT](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/kraken-spot)|SPOT|
|[Kucoin](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/kucoin)|SPOT, Futures|
|[OKX](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/okx)|SPOT, Linear and Inverse SWAP, Inverse and Linear Futures|
|[One Trading (bitpanda)](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/onetrading)|SPOT|
|[POLONIEX](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/poloniex)|SPOT|
|[Uniswap](https://github.com/epam/TimebaseCryptoConnectors/blob/main/docs/uniswap.md)|ERC-20 SWAP|