desic-okx-agent 0.1.0

package/examples/claude-code/mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "desic-okx": {
+      "command": "desic-okx",
+      "args": ["mcp"]
+    }
+  }
+}

package/examples/codex/config.toml

@@ -0,0 +1,3 @@
+[mcp_servers.desic-okx]
+command = "desic-okx"
+args = ["mcp"]

package/examples/config.example.json

@@ -0,0 +1,18 @@
+{
+  "accounts": {},
+  "market": {
+    "prewarm": ["BTC-USDT-SWAP", "ETH-USDT-SWAP"],
+    "bars": ["1m", "5m", "15m", "1H", "4H", "1D"],
+    "idleSubscriptionMs": 900000,
+    "maxSnapshotSkewMs": 1000,
+    "orderBookDepth": 50,
+    "recentTradeLimit": 1000
+  },
+  "proxy": {},
+  "intelligence": {
+    "newsPollSeconds": 120,
+    "sentimentPollMinutes": 15,
+    "smartMoneyPollMinutes": 15,
+    "retentionDays": 30
+  }
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "desic-okx-agent",
+  "version": "0.1.0",
+  "description": "Independent Desic runtime, MCP server, CLI, and agent skills for OKX",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xiazhi88/desic-okx-agent.git"
+  },
+  "homepage": "https://github.com/xiazhi88/desic-okx-agent#readme",
+  "bugs": {
+    "url": "https://github.com/xiazhi88/desic-okx-agent/issues"
+  },
+  "keywords": [
+    "okx",
+    "mcp",
+    "codex",
+    "claude-code",
+    "trading",
+    "market-data"
+  ],
+  "bin": {
+    "desic-okx": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsx src/cli/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:demo": "node scripts/run-demo-e2e.mjs",
+    "test:watch": "vitest",
+    "validate:skills": "node scripts/validate-skills.mjs",
+    "scan:sensitive": "node scripts/scan-sensitive.mjs",
+    "test:mcp": "node scripts/mcp-smoke.mjs",
+    "check": "npm run typecheck && npm run test && npm run validate:skills && npm run scan:sensitive && npm run build && npm run test:mcp",
+    "prepack": "npm run check"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "better-sqlite3": "^13.0.2",
+    "commander": "^15.0.0",
+    "crc-32": "^1.2.2",
+    "env-paths": "^4.0.0",
+    "https-proxy-agent": "^7.0.6",
+    "undici": "^7.16.0",
+    "ws": "^8.21.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.19.15",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}

package/skills/okx-account-analysis/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: okx-account-analysis
+description: Inspect configured OKX account balances, positions, pending orders, order history, fills, bills, account settings, and generic risk. Use for account-state, exposure, reconciliation, or risk-summary questions without changing exchange state.
+---
+
+# OKX Account Analysis
+
+1. Select the requested account alias; use the configured default only when no account was specified.
+2. Start with `account_get_snapshot` for current state, then use history, fills, or bills for reconciliation.
+3. Report environment and account alias with every conclusion.
+4. Distinguish equity, available balance, margin, notional exposure, realized results, and pending orders.
+5. Treat empty data as an observed empty result only when no warning or upstream error is present.
+6. Never request, print, infer, or return API credentials.
+7. Do not call any `trade_*` tool while using this read-only analysis workflow.

package/skills/okx-account-analysis/agents/openai.yaml

@@ -0,0 +1,9 @@
+interface:
+  display_name: "OKX Account Analysis"
+  short_description: "Inspect balances, positions, orders, fills, and account risk."
+  default_prompt: "Use $okx-account-analysis to summarize the selected OKX account safely."
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "desic-okx"
+      description: "Desic OKX Agent MCP server"

package/skills/okx-derivatives-analysis/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: okx-derivatives-analysis
+description: Analyze OKX open interest, taker flow, funding and basis, liquidations, crowding, position changes, consensus, and system stress. Use for perpetual-market positioning and derivatives-risk questions.
+---
+
+# OKX Derivatives Analysis
+
+1. Start with `derivatives_get_decision_snapshot` for a broad view, then call focused tools for evidence that needs more history.
+2. State instrument, period, sample size, timestamps, and data limitations.
+3. Distinguish account long-short ratio, top-trader account ratio, and top-trader position ratio; they measure different populations and quantities.
+4. Interpret open-interest changes together with price and taker flow. Do not assign direction from open interest alone.
+5. Interpret funding as positioning cost, not a standalone reversal signal.
+6. Treat liquidation samples and system-stress data as incomplete observations unless coverage is explicit.
+7. Present supporting evidence, contradictory evidence, likely interpretation, and invalidation conditions.

package/skills/okx-derivatives-analysis/agents/openai.yaml

@@ -0,0 +1,9 @@
+interface:
+  display_name: "OKX Derivatives Analysis"
+  short_description: "Analyze positioning, funding, flow, and crowding evidence."
+  default_prompt: "Use $okx-derivatives-analysis to assess derivatives positioning for BTC-USDT-SWAP."
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "desic-okx"
+      description: "Desic OKX Agent MCP server"

package/skills/okx-market-analysis/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: okx-market-analysis
+description: Analyze live OKX ticker, order book, trades, candles, funding, open interest, indicators, and time-aligned decision snapshots. Use for current market structure, liquidity, momentum, volatility, or watchlist analysis on OKX.
+---
+
+# OKX Market Analysis
+
+1. Call `market_get_decision_snapshot` before combining multiple live market facts.
+2. Check `consistent`, `maxTimeSkewMs`, component timestamps, and warnings. State that the snapshot is stale or inconsistent when applicable.
+3. Use `market_get_instrument` before interpreting size, tick, lot, or contract value.
+4. Use focused tools only when additional depth is needed: candles and indicators for trend, order book for current liquidity, recent trades for aggressive flow.
+5. Separate closed candles from the active candle. Do not describe an active candle as final.
+6. Report observed facts first, then interpretations, invalidation evidence, and limitations.
+7. Never treat one indicator, one order-book snapshot, or one large trade as a sufficient trading signal.

package/skills/okx-market-analysis/agents/openai.yaml

@@ -0,0 +1,9 @@
+interface:
+  display_name: "OKX Market Analysis"
+  short_description: "Analyze live OKX market structure and aligned snapshots."
+  default_prompt: "Use $okx-market-analysis to analyze BTC-USDT-SWAP market structure."
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "desic-okx"
+      description: "Desic OKX Agent MCP server"

package/skills/okx-news-intelligence/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: okx-news-intelligence
+description: Research OKX news, sources, coin sentiment, economic events, clustered events, market reactions, anomalies, and daily briefings. Use for time-sensitive crypto news or event-impact analysis with a configured live read-only OKX account.
+---
+
+# OKX News Intelligence
+
+1. Use `news_search` for a targeted question and `news_list` for current coverage.
+2. Read details when a headline is material; record source, publication time, language, and freshness.
+3. Use sentiment trends and rankings as aggregated observations, not as factual confirmation of an event.
+4. Use clustered events to consolidate repeated coverage. Preserve whether evidence comes from one or several independent sources.
+5. Use `news_read_market_reaction` only to describe observed movement around an event; do not claim causality without stronger evidence.
+6. Surface `CAPABILITY_UNAVAILABLE`, local-history fallbacks, and other warnings because the upstream intelligence interfaces are experimental.
+7. Never convert a headline directly into a trade. Require market and derivatives confirmation plus explicit risk and invalidation.

package/skills/okx-news-intelligence/agents/openai.yaml

@@ -0,0 +1,9 @@
+interface:
+  display_name: "OKX News Intelligence"
+  short_description: "Research OKX news, sentiment, events, and market reactions."
+  default_prompt: "Use $okx-news-intelligence to build an evidence-based crypto news briefing."
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "desic-okx"
+      description: "Desic OKX Agent MCP server"

package/skills/okx-smart-money-analysis/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: okx-smart-money-analysis
+description: Analyze OKX public trader rankings, performance, positions, histories, and Smart Money signal trends. Use to compare trader cohorts or investigate positioning with a configured live read-only OKX account.
+---
+
+# OKX Smart Money Analysis
+
+1. Define the period, sort field, filters, and sample size before comparing traders.
+2. Use performance to shortlist; inspect current positions and history before interpreting behavior.
+3. Separate current positions, closed-position history, public order history, signal overview, and signal trend.
+4. Check whether results were refreshed remotely or returned from local history, and report limitations.
+5. Surface `CAPABILITY_UNAVAILABLE` and compatibility warnings because the upstream interfaces are experimental.
+6. Compare several traders or a defined cohort. Do not generalize from one account.
+7. Look for disagreement between performance, current exposure, derivatives flow, and price action.
+8. Do not blindly copy positions or imply that past ranking predicts future returns.

package/skills/okx-smart-money-analysis/agents/openai.yaml

@@ -0,0 +1,9 @@
+interface:
+  display_name: "OKX Smart Money Analysis"
+  short_description: "Analyze public trader performance, positions, and signal trends."
+  default_prompt: "Use $okx-smart-money-analysis to compare Smart Money signals without blindly following them."
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "desic-okx"
+      description: "Desic OKX Agent MCP server"

package/skills/okx-trading/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: okx-trading
+description: Precheck and execute direct OKX leverage, ordinary-order, algo-order, amend, cancel, and position-close operations. Use when the user explicitly requests an OKX trading action and has configured an API key with the required official permission.
+---
+
+# OKX Trading
+
+1. Identify the account alias, environment, instrument, side, margin mode, position side, order type, price, and size from the user's request. Do not invent missing trading intent.
+2. Call `market_get_instrument`; treat `size` as contracts for derivatives and respect `lotSz`, `minSz`, and `tickSz`.
+3. Call `market_get_decision_snapshot`. Do not proceed when `consistent` is false.
+4. Call `trade_evaluate_plan`, then `trade_precheck_order` for ordinary orders or `trade_precheck_algo_order` for strategy orders. Resolve every blocker before submitting.
+5. Create a stable, unique `executionKey` for each intended mutation. Reuse it only when retrying the exact same intent.
+6. Call the narrowest write tool that matches the request. Do not substitute batch cancellation or full position closure for a narrower action.
+7. If a result is `AMBIGUOUS_WRITE`, inspect remote order state. Never retry with a new execution key until the original outcome is resolved.
+8. Report the exchange environment, returned order identifiers, status, reconciliation state, and any warnings.
+9. Never use or propose withdrawal, transfer, deposit, or API-key-management operations.

package/skills/okx-trading/agents/openai.yaml

@@ -0,0 +1,9 @@
+interface:
+  display_name: "OKX Trading"
+  short_description: "Precheck and execute direct OKX orders with explicit parameters."
+  default_prompt: "Use $okx-trading to precheck and submit the requested OKX order."
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "desic-okx"
+      description: "Desic OKX Agent MCP server"

package/skills/trading-philosophy/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: trading-philosophy
+description: Apply evidence-first, probabilistic, risk-aware reasoning to trading theses and post-trade reviews. Use when forming, challenging, explaining, or reviewing a market view, setup, decision, or outcome.
+---
+
+# Trading Philosophy
+
+1. Separate observed facts, interpretations, assumptions, and unknowns.
+2. Express a thesis as a conditional scenario rather than certainty.
+3. State invalidation conditions before discussing entry or expected return.
+4. Seek contradictory evidence and plausible alternative explanations.
+5. Evaluate liquidity, sizing, loss at invalidation, execution risk, and data freshness.
+6. Do not promote a single indicator, headline, trader, funding rate, or order-book imbalance into a complete thesis.
+7. After an outcome, evaluate decision quality, execution quality, and randomness separately.

package/skills/trading-philosophy/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Trading Philosophy"
+  short_description: "Apply evidence, invalidation, and risk-aware trading reasoning."
+  default_prompt: "Use $trading-philosophy to critique a trading thesis and its invalidation conditions."