English | 简体中文
DecMa is a Flutter desktop workspace for read-only Bybit Linear perpetual-market analysis. It combines a live chart, curated market news, deterministic market features, optional external data tools, and an LLM agent in one interface. It can present candidate entry, stop-loss, and take-profit levels, but it never places, amends, or cancels orders.
The three-column workspace keeps the chart, market-news feed, and agent response visible together.
Provide a risk style, intended trading window, account and loss limits, and optional position details before requesting an analysis.
Save multiple LLM connections, sign in to OpenAI Codex when selected, and enable only the MCP and API sources you need.
Control official macro feeds and optional Finnhub and Marketaux news sources separately.
- Search Bybit Linear perpetual symbols and view 1m, 5m, 15m, 1h, 4h, or 1D candlestick charts. The application loads up to 1,000 candles and refreshes the latest candles every second.
- View the chart, a filterable market-news feed, and the Trading Agent side by side in a Fluent UI desktop workspace.
- Run structured market analysis or continue in conversation mode. Conversation and previous-analysis context are kept only for the current application session.
- Build each analysis from a current Bybit market snapshot and calculated 5m, 15m, 1h, and 4h features, including EMA, MACD, RSI, ATR, VWAP, realized volatility, volume, and range-expansion metrics.
- Validate the model's structured plan before drawing its entry zone, stop loss, and take-profit levels on the active chart. Plans for another symbol or invalid price relationships are not drawn.
- Choose from Anthropic Messages, OpenAI Responses, OpenAI Chat Completions-compatible endpoints, or OpenAI Codex. Multiple named LLM connections can be saved; the Codex option uses a browser sign-in flow.
- Use optional analysis sources: Bybit MCP, OpenWebSearch MCP, Nansen MCP, and the Coinalyze API. The Bybit MCP integration exposes only explicitly public, read-only operations.
- Read macro and market-news feeds from BLS, BEA, and the Federal Reserve by default, with optional Finnhub and Marketaux sources. The feed can be filtered by current asset, category, and provider.
- Store API keys and OAuth credentials with
flutter_secure_storage; non-secret settings, cached events, saved asset profiles, and the last viewed symbol are stored separately. - Keep analysis conservative when data is missing, stale, or conflicting: the agent may return
WAIT,NO_TRADE, orDATA_INSUFFICIENTand cannot execute trades.
- Flutter SDK with Dart
^3.12.2. - A Flutter desktop target: Windows, macOS, or Linux.
- An LLM API key and model for Anthropic Messages, OpenAI Responses, or OpenAI Chat Completions; alternatively, a ChatGPT account for the OpenAI Codex sign-in option.
- Node.js and
npxwhen using the bundled Bybit MCP or OpenWebSearch MCP integrations. They are not required for charts, news feeds, Nansen MCP, or Coinalyze. - Optional API keys for Nansen, Coinalyze, Finnhub, and Marketaux when those providers are enabled.
The first request to a bundled MCP integration can download its npx package, so it requires network access.
# Fetch the Flutter packages.
flutter pub get
# Run the desktop target that matches your machine.
flutter run -d windowsReplace windows with macos or linux where appropriate.
-
Start DecMa and select the settings icon in the Trading Agent panel.
-
Create or select a saved connection, then choose its provider.
-
For Anthropic Messages, OpenAI Responses, or OpenAI Chat Completions, enter the endpoint, model, and API key. DecMa adds the following request paths to the configured endpoint:
Provider Default endpoint Request path added by DecMa Anthropic Messages https://api.anthropic.com/v1/messagesOpenAI Responses https://api.openai.com/v1/responsesOpenAI Chat Completions https://api.openai.com/v1/chat/completions -
For OpenAI Codex, sign in through the browser and select a model. The application uses the Codex endpoint and credentials from that sign-in flow.
-
Save the settings. Leaving a masked credential field unchanged keeps the credential already stored on the device.
Enable only the sources relevant to your workflow in Agent Settings:
| Source | Default | Credential | Notes |
|---|---|---|---|
| Bybit MCP | Enabled | Optional Bybit API key and secret | Requires Node.js and npx. The app admits only explicitly public, read-only MCP tools; optional account credentials are used to read fee rates. |
| OpenWebSearch MCP | Enabled | None | Requires Node.js and npx. |
| Nansen MCP | Disabled | Nansen API key | Optional on-chain context. |
| Coinalyze API | Disabled | Coinalyze API key | Optional derivatives data. The app applies a local 40-request-per-minute guard. |
Select the settings icon in Market News to enable sources and save optional API keys:
| Source | Default | Credential | Purpose |
|---|---|---|---|
| BLS | Enabled | None | Official U.S. labor releases. |
| BEA | Enabled | None | Official U.S. economic releases. |
| Federal Reserve | Enabled | None | Federal Reserve news and releases. |
| Finnhub | Disabled | Finnhub API key | Market-news feed. |
| Marketaux | Disabled | Marketaux API key | News for the current asset. |
The app checks feeds every minute, while each provider applies its own caching interval. Provider failures remain isolated from the chart and Agent.
- Search for a Linear symbol such as
BTCUSDTand select a chart interval. - Review the chart and Market News panel. Use its category and source filters to narrow the event list.
- In 分析 (Analysis) mode, describe the market directly or select 分析当前合约 (Analyze current contract) to provide structured risk and position inputs.
- Review the Agent's report, warnings, and plan card. A plan is overlaid on the chart only after its symbol and price levels pass validation.
- Switch to 对话 (Conversation) mode for follow-up questions. Select 清空 (Clear) to remove the current session's chat and analysis context.
DecMa treats Bybit as the primary source for its displayed price, mark/index price, order book, funding rate, and open interest. News and web search results are leads rather than verified facts. External data can be delayed, incomplete, unavailable, or contradictory, so outputs must be independently checked.
DecMa is an analysis and decision-support tool, not investment advice or a trade-execution system. Manage risk and make your own decisions.
lib/
├── main.dart # Application and desktop-window startup
├── models/ # Settings, market, news, and plan models
├── services/ # LLM, market data, MCP, news, and secure storage
└── ui/
├── dashboard/ # Workspace, chart controls, and Agent panel
├── chart/ # Candlestick rendering and viewport logic
├── news/ # News feed and settings dialog
└── settings/ # Agent settings dialog