OmniTrade is a modular and extensible platform designed to integrate with multiple cryptocurrency exchanges.
It supports authentication, account information, balances, open positions, and order history.
The architecture is built to serve as the foundation for an AI-driven trading system.
The main goals of this project are:
- β Centralize integration with multiple crypto exchanges.
- β Provide a unified interface for accessing accounts, balances, positions, and orders.
- β Enable future implementation of AI-based trading logic.
- β Be secure, modular, and easy to maintain.
src/
βββ core/
β βββ ExchangeManager.ts # Main class to manage exchanges
βββ providers/
β βββ MercadoBitcoinProvider.ts # Implementation for Mercado Bitcoin
βββ config/
β βββ index.ts # Environment config loader
βββ types/ # Type interfaces
βββ index.ts # Entry point
| Feature | Status |
|---|---|
| Mercado Bitcoin Integration | β |
| Fetching Accounts | β |
| Fetching Balances | β |
| Fetching Positions | π In Progress |
| Fetching Orders | π In Progress |
| Binance Integration | π² Planned |
| AI Trading Logic (API) | π² Planned |
- Clone the repository:
git clone https://github.com/raphaelvserafim/omnitrade.git
- Navigate into the folder:
cd omnitrade
- Install dependencies:
npm install
Create a .env file in the root directory and set your credentials:
MB_CLIENT_ID=your_client_id
MB_CLIENT_SECRET=your_client_secret
These are loaded in the config module.
Using tsx:
npx tsx index.ts
Using ts-node:
npx ts-node index.ts
const MBProvider = new MercadoBitcoinProvider(clientId, clientSecret); const authenticate = await MBProvider.authenticate(); if (!authenticate) { console.log("Authentication failed"); return; } console.log("Authentication successful", authenticate.access_token); MBProvider.setAccessToken(authenticate.access_token); const manager = new ExchangeManager(MBProvider); console.log(manager.getExchangeName()); const accounts = await manager.fetchAllAccounts(); console.dir(accounts, { depth: null }); const balances = await manager.fetchAllBalances(); console.dir(balances, { depth: null });
- Create a new file in
src/providers(e.g.,BinanceProvider.ts) - Implement the
IExchangeProviderinterface - Inject the provider into
ExchangeManager
- Authentication for Mercado Bitcoin
- Account and balance fetching
- Position and order fetching
- Binance, KuCoin, OKX support
- AI integration (e.g., TensorFlow.js, GPT API)
- Web dashboard
MIT Β© Raphael Serafim
Pull requests are welcome.
Please open an issue to discuss major changes or improvements.