{"id":28533797,"url":"https://github.com/epam/timebasecryptoconnectors","last_synced_at":"2025-07-07T21:31:28.534Z","repository":{"id":37435423,"uuid":"473223766","full_name":"epam/TimebaseCryptoConnectors","owner":"epam","description":"TimeBase Crypto Market Data Connectors","archived":false,"fork":false,"pushed_at":"2025-06-20T16:26:21.000Z","size":1398,"stargazers_count":33,"open_issues_count":8,"forks_count":7,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-06-20T17:34:14.340Z","etag":null,"topics":["bitfinex","bitmex","bitpanda","coinbase","crypto","cryptocurrency","cryptocurrency-prices","exchange","feed","feeds","finance","hitbtc","huobi","java","kraken","market-data","market-data-feeds","okex","trading"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/epam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-03-23T14:26:36.000Z","updated_at":"2025-06-20T16:26:24.000Z","dependencies_parsed_at":"2024-04-02T13:53:26.706Z","dependency_job_id":"66545185-aa28-4933-a721-abe92cc41613","html_url":"https://github.com/epam/TimebaseCryptoConnectors","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/epam/TimebaseCryptoConnectors","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epam%2FTimebaseCryptoConnectors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epam%2FTimebaseCryptoConnectors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epam%2FTimebaseCryptoConnectors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epam%2FTimebaseCryptoConnectors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/epam","download_url":"https://codeload.github.com/epam/TimebaseCryptoConnectors/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epam%2FTimebaseCryptoConnectors/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264149219,"owners_count":23564419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitfinex","bitmex","bitpanda","coinbase","crypto","cryptocurrency","cryptocurrency-prices","exchange","feed","feeds","finance","hitbtc","huobi","java","kraken","market-data","market-data-feeds","okex","trading"],"created_at":"2025-06-09T17:08:42.490Z","updated_at":"2025-07-07T21:31:28.528Z","avatar_url":"https://github.com/epam.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TimeBase Crypto Market Data Connectors\n\n[![Build CI](https://github.com/epam/TimebaseCryptoConnectors/actions/workflows/build.yml/badge.svg)](https://github.com/epam/TimebaseCryptoConnectors/actions/workflows/build.yml)\n\nWith [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**. \n\n![](/img/stream-monitor.png)\n\n## Quick Start - setup market data collection in 60 seconds:\n\n### Prerequisites\n\n**Windows** \n\n* [Install WSL](https://docs.microsoft.com/en-us/windows/wsl/install). \n* [Install Docker](https://docs.docker.com/desktop/windows/install/) on your Windows machine. \n\n**Linux**\n\n* [Install Docker Engine](https://docs.docker.com/engine/install/).\n* [Install Docker Compose](https://docs.docker.com/compose/install/).  \n\n### Start Connectors \n\n1. Download sample [docker-compose.yml](https://raw.githubusercontent.com/epam/TimebaseCryptoConnectors/main/docs/docker-compose.yml)\n2. Run `docker-compose up` command from the directory with your docker-compose.yml file to launch TimeBase crypto connectors. \n3. 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**):\n\nhttps://user-images.githubusercontent.com/46220620/172610668-e9fcd008-4a49-477e-93ba-45038ca9a3d4.mp4\n\n\n## Build and Run\n\nBuild the project with [Gradle](http://gradle.org/) using this\n[build.gradle](https://github.com/epam/TimebaseCryptoConnectors/blob/main/build.gradle) file.\n\nYou will require the Java 11+ and Gradle 8.6 to build:\n\nFull clean and build of all modules\n\n```shell\n    $ ./gradlew clean build\n```\n\nAnd start it\n```shell\n    $ ./bin/runner.sh\n```\n### Configuration \n\nBy 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.\n\n\u003e Refer to the [configuration](https://github.com/epam/TimebaseCryptoConnectors/blob/main/docs/configuration.md) to learn how to configure. \n\n\u003e 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. \n\n## Supported Crypto Exchanges\n\n|Exchange|Supported Contracts|\n|------|------------------|\n|[AscendEX](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/ascendex)|SPOT, Linear Futures|\n|[BYBIT](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/bybit)| SPOT, Inverse and Linear Futures, Options|\n|[BITFINEX](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/bitfinex)|SPOT, Linear Futures|\n|[BITMART](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/bitmart)|SPOT|\n|[BitMEX](java/connectors/bitmex/README.md)|Quanto Contract, Inverse Perpetual SWAP, Linear Perpetual, Quanto Perpetual, Linear Futures, Quanto Futures, Inverse Futures|\n|[Coinbase](https://github.com/epam/TimebaseCryptoConnectors/blob/main/java/connectors/coinbase/README.md)|SPOT|\n|[CRYPTOFACILITIES](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/cryptofacilities)|Linear Futures|\n|[DERIBIT](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/deribit)|Inverse and Linear Futures, Options, Perpetual|\n|[HITBTC](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/cryptofacilities)|SPOT|\n|[HUOBI FUTURES](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/huobi-futures)|Inverse Futures|\n|[HUOBI SPOT](https://github.com/epam/TimebaseCryptoConnectors/blob/main/java/connectors/huobi-spot/README.md)|SPOT|\n|[Kraken\u0026nbsp;FUTURES](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/kraken-futures)|Inverse and Linear Perpetual SWAP, Inverse Futures with Expiration|\n|[Kraken\u0026nbsp;SPOT](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/kraken-spot)|SPOT|\n|[Kucoin](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/kucoin)|SPOT, Futures|\n|[OKX](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/okx)|SPOT, Linear and Inverse SWAP, Inverse and Linear Futures|\n|[One Trading (bitpanda)](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/onetrading)|SPOT|\n|[POLONIEX](https://github.com/epam/TimebaseCryptoConnectors/tree/main/java/connectors/poloniex)|SPOT|\n|[Uniswap](https://github.com/epam/TimebaseCryptoConnectors/blob/main/docs/uniswap.md)|ERC-20 SWAP|\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepam%2Ftimebasecryptoconnectors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fepam%2Ftimebasecryptoconnectors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepam%2Ftimebasecryptoconnectors/lists"}