whatisgithub

What is dex-trade-agent-kit?

dennis-bv/dex-trade-agent-kit — explained in plain English

Analysis updated 2026-05-18

129TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

An MCP server and CLI that let AI assistants place trades and check data on the OKX crypto exchange from your own machine.

Mindmap

mindmap
  root((repo))
    What it does
      Connects AI to OKX
      Local MCP server
      CLI tool
    Tech stack
      TypeScript
      Node.js
      MCP protocol
    Use cases
      Check market data
      Place trades
      Run trading bots
    Audience
      Developers
      Crypto traders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI assistant check OKX market prices and technical indicators without writing code

USE CASE 2

Place spot, swap, futures, or options orders on OKX by describing them to an AI client

USE CASE 3

Run automated grid or DCA trading bots through the CLI

USE CASE 4

Monitor account balances, positions, and smart money signals from a chat interface

What is it built with?

TypeScriptNode.jsMCP

How does it compare?

dennis-bv/dex-trade-agent-kitagutinbaigo28/financial-agent-apibananefre/finance-budget-api-agent
Stars129129129
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity3/54/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 18+ and an OKX API key.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Dex Trade Agent Kit is a toolkit that lets AI assistants like Claude or Cursor trade cryptocurrency on OKX, a crypto exchange, directly from a chat conversation. Instead of switching between an AI tool and the exchange website, you describe what you want done and the AI calls the right function to do it. The project ships as two separate packages. One is an MCP server, a small program that speaks the Model Context Protocol so AI clients such as Claude Desktop, Cursor, and VS Code can talk to it. The other is a command line tool for running the same trading actions from a terminal. Both run locally on your own computer, and your API keys for OKX stay on your machine instead of being sent to any outside service. Together the two packages expose 145 tools split across 11 areas covering the full trading process: checking market prices, placing spot and futures orders, managing algo orders such as stop loss and take profit, checking account balances, using OKX's earn and staking features, running grid or DCA trading bots, reading crypto news, and viewing signals based on what large traders are doing. Many of the market data tools work without any account or API key at all. Safety features include a read only mode that blocks any order placement, the ability to turn on only the modules you need, and a built in rate limiter to avoid hitting exchange limits too fast. The project also bundles ready made skill files that tell AI agent frameworks when to use which trading feature. Getting started requires Node.js version 18 or newer. You install the packages with npm, run a setup wizard to add your OKX API keys, then register the MCP server with whichever AI client you use, such as Claude Desktop or Cursor. From there you can ask the AI to check prices, place trades, or manage your account, and it uses the underlying CLI commands to do so. The project is open source under the MIT license and is aimed at people who want their AI assistant to trade directly on OKX rather than through a web dashboard.

Copy-paste prompts

Prompt 1
Set up the dex-trade-mcp server so Claude Desktop can check OKX market prices
Prompt 2
Show me how to run the OKX MCP server in read-only mode so I can test tools without risking funds
Prompt 3
Write a script using okx-trade-cli to check my OKX account balance
Prompt 4
Explain what the okx swap algo place command does and when I would use it

Frequently asked questions

What is dex-trade-agent-kit?

An MCP server and CLI that let AI assistants place trades and check data on the OKX crypto exchange from your own machine.

What language is dex-trade-agent-kit written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does dex-trade-agent-kit use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is dex-trade-agent-kit to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is dex-trade-agent-kit for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.