# OKX MCP Server (oci · ghcr.io/aahl/mcp-okx:latest)

MCP Server for okx.com

- Trust score: 33/100 (low)
- Change this week: −6
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- oci · `ghcr.io/aahl/mcp-okx:latest`: 33/100 (this document), [markdown](https://verifymcp.io/servers/aahl-mcp-okx/ghcr-io-aahl-mcp-okx-latest.md), [page](https://verifymcp.io/servers/aahl-mcp-okx/ghcr-io-aahl-mcp-okx-latest)
- pypi · `mcp-okx`: 24/100, [markdown](https://verifymcp.io/servers/aahl-mcp-okx/mcp-okx.md), [page](https://verifymcp.io/servers/aahl-mcp-okx/mcp-okx)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/aahl/mcp-okx:latest`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - CVE data not yet available for this package.
  - Install-script risk not yet assessed.
  - Dependency-health data not yet available.
- **Provenance & Transparency**: 44/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 265 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 54/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 4462 tokens (~371/item across 12 items; 11 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

**Unverified: 2 categories.** Categories scored 0 because we could not verify them: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add aahl-mcp-okx -- docker run --rm -i ghcr.io/aahl/mcp-okx:latest
```

### Codex

```bash
codex mcp add aahl-mcp-okx -- docker run --rm -i ghcr.io/aahl/mcp-okx:latest
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "aahl-mcp-okx": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/aahl/mcp-okx:latest"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  aahl-mcp-okx:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/aahl/mcp-okx:latest"]
```

### Other

```json
{
  "mcpServers": {
    "aahl-mcp-okx": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/aahl/mcp-okx:latest"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-07-31 (score 33, −6)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 39, +28)

- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: fair

### 2026-07-26 (score 11)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (11)

### `account_config` (~33 tokens)

Get account configuration

Retrieve current OKX account configuration. It is recommended to use this tool to obtain account configuration information before using all other tools

### `account_balance` (~72 tokens)

Get account balance

Retrieve a list of assets (with non-zero balance), remaining balance, and available amount in the OKX trading account

Input parameters:

- `ccy` (string): Single currency or multiple currencies (no more than 20) separated with comma, e.g. BTC or BTC,ETH.Optional, all by default if not passed

### `account_positions` (~252 tokens)

Get account positions

Retrieve information on your OKX positions. When the account is in net mode, net positions will be displayed, and when the account is in long/short mode, long or short positions will be displayed. Return in reverse chronological order using ctime.

Input parameters:

- `instId` (string): Instrument ID, e.g. `BTC-USDT-SWAP`. Single instrument ID or multiple instrument IDs (no more than 10) separated with comma. Optional, all by default if not passed
- `instType` (string): Instrument type: `SPOT`: 币币现货/`MARGIN`: 币币杠杆/`SWAP`: 永续合约/`FUTURES`: 交割合约/`OPTION`: 期权.`instId` will be checked against `instType` when both parameters are passed. Optional, all by default if not pas…
- `posId` (string): Single position ID or multiple position IDs (no more than 20) separated with comma. There is attribute expiration, the posId and position information will be cleared if it is more than 30 days after…

### `account_position_risk` (~77 tokens)

Get account position risk

Obtain the overall holding risk of the OKX account

Input parameters:

- `instType` (string): Instrument type: `MARGIN`: 币币杠杆/`SWAP`: 永续合约/`FUTURES`: 交割合约/`OPTION`: 期权. Optional, all by default if not passed

### `place_order` (~2850 tokens)

Place a new order

Place a new order on OKX for trading

Input parameters:

- `attachAlgoOrds`: TP/SL information attached when placing order.1. TP/SL algo order will be generated only when this order is filled fully, or there is no TP/SL algo order generated.2. Attaching TP/SL is neither suppo…
- `banAmend`: Whether to disallow the system from amending the size of the SPOT Market Order. Valid options: `true` or `false`. The default value is `false`. If `true`, system will not amend and reject the market…
- `ccy` (string): Margin currency. Applicable to all `isolated` `MARGIN` orders and `cross` `MARGIN` orders in `Futures mode`
- `clOrdId` (string): Client Order ID as assigned by the client.A combination of case-sensitive alphanumerics, all numbers, or all letters of up to 32 characters.Only applicable to general order. It will not be posted to…
- `instId` (string, required): Instrument ID, e.g. BTC-USDT
- `ordType` (string, required): Order type. When creating a new order, you must specify the order type. The order type you specify will affect: 1) what order parameters are required, and 2) how the matching system executes your ord…
- `posSide` (string): Position side. The default is `net` in the net mode. It is required in the `long/short` mode, and can only be `long` or `short`. Only applicable to `FUTURES`/`SWAP`. Position side, this parameter is…
- `px` (string): Order price. Only applicable to `limit`,`post_only`,`fok`,`ioc`,`mmp`,`mmp_and_post_only` order. When placing an option order, one of px/pxUsd/pxVol must be filled in, and only one can be filled in.…
- `pxUsd` (string): Place options orders in `USD`. Only applicable to options. When placing an option order, one of px/pxUsd/pxVol must be filled in, and only one can be filled in
- `pxVol` (string): Place options orders based on implied volatility, where 1 represents 100%. Only applicable to options. When placing an option order, one of px/pxUsd/pxVol must be filled in, and only one can be fille…
- `reduceOnly`: Whether orders can only reduce in position size. Valid options: `true` or `false`. The default value is `false`. Only applicable to `MARGIN` orders, and `FUTURES`/`SWAP` orders in net mode. Only appl…
- `side` (string, required): Order side, `buy`/`sell`
- `stpMode` (string): Self trade prevention mode: `cancel_maker`,`cancel_taker`,`cancel_both`. Cancel both does not support FOK. The account-level acctStpMode will be used to place orders by default. The default value of…
- `sz` (string, required): Quantity to buy or sell. For SPOT/MARGIN Buy and Sell Limit Orders, it refers to the quantity in base currency. For MARGIN Buy Market Orders, it refers to the quantity in quote currency. For MARGIN S…
- `tag` (string): Order tag. A combination of case-sensitive alphanumerics, all numbers, or all letters of up to 16 characters
- `tdMode` (string, required): Trade Mode, when placing an order, you need to specify the trade mode. Spot mode: `cash`(SPOT and OPTION buyer; 币币和期权买方) Futures mode: - `cash`(SPOT; 币币) - `cross`(Cross MARGIN/FUTURES/SWAP/OPTION; 全…
- `tgtCcy` (string): Whether the target currency uses the quote or base currency.  This parameter is used to specify the order quantity in the order request is denominated in the quantity of base or quote currency. This…

### `cancel_order` (~81 tokens)

Cancel an incomplete order

Cancel an incomplete order on OKX

Input parameters:

- `clOrdId` (string): Client Order ID as assigned by the client
- `instId` (string, required): Instrument ID, e.g. BTC-USDT
- `ordId` (string): Order ID. Either ordId or clOrdId is required. If both are passed, ordId will be used

### `get_trade_order` (~102 tokens)

Get order details

Retrieve order details on OKX. For a detailed schema of the output object, please read the resource at: `schema://trade/order`

Input parameters:

- `clOrdId` (string): Client Order ID as assigned by the client
- `instId` (string, required): Instrument ID, e.g. BTC-USDT
- `ordId` (string): Order ID. Either ordId or clOrdId is required. If both are passed, ordId will be used

### `get_order_list` (~242 tokens)

Get incomplete order list

Retrieve all incomplete orders under the current OKX account. For a detailed schema of the output object, please read the resource at: `schema://trade/order`

Input parameters:

- `instFamily` (string): Instrument family. Applicable to `FUTURES/SWAP/OPTION`
- `instId` (string): Instrument ID, e.g. BTC-USD-200927
- `instType` (string): Instrument type: `SPOT/MARGIN/SWAP/FUTURES/OPTION`
- `ordType` (string): Order type.  `market`: Market order `limit`: Limit order `post_only`: Post-only order `fok`: Fill-or-kill order `ioc`: Immediate-or-cancel order `optimal_limit_ioc`: Market order with immediate-or-ca…
- `state` (string): State: `live`/`partially_filled`

### `get_orders_history` (~342 tokens)

Get Order History

Get completed orders on OKX which are placed in the last 7 days, including those placed 7 days ago but completed in the last 7 days.The incomplete orders that have been canceled are only reserved for 2 hours. For a detailed schema of the output object, please read the resource at: `schema://trade/order`

Input parameters:

- `category` (string): Category: `twap/adl/full_liquidation/partial_liquidation/delivery`/`ddh`: Delta dynamic hedge
- `instFamily` (string): Instrument family. Applicable to `FUTURES/SWAP/OPTION`
- `instId` (string): Instrument ID, e.g. BTC-USDT
- `instType` (string, required): Instrument type: `SPOT/MARGIN/SWAP/FUTURES/OPTION`
- `limit`: Number of results per request. [1-100]. Default: 20
- `ordType` (string): Order type.  `market`: Market order `limit`: Limit order `post_only`: Post-only order `fok`: Fill-or-kill order `ioc`: Immediate-or-cancel order `optimal_limit_ioc`: Market order with immediate-or-ca…
- `state` (string): State: `canceled`/`filled`/`mmp_canceled`: Order canceled automatically due to Market Maker Protection

### `close_positions` (~265 tokens)

Close positions

Liquidate all positions in the designated trading product at market price on OKX

Input parameters:

- `autoCxl`: Whether any pending orders for closing out needs to be automatically canceled when close position via a market order.`false` or `true`, the default is `false`
- `ccy` (string): Margin currency, required in the case of closing `cross` `MARGIN` position for `Futures mode`
- `clOrdId` (string): Client-supplied ID. A combination of case-sensitive alphanumerics, all numbers, or all letters of up to 32 characters.
- `instId` (string, required): Instrument ID, e.g. BTC-USDT
- `mgnMode` (string, required): Margin mode: `cross`/`isolated`
- `posSide` (string): Position side. This parameter can be omitted in `net` mode, and the default value is `net`. You can only fill with `net`. This parameter must be filled in under the `long/short` mode. Fill in `long`…
- `tag` (string): Order tag. A combination of case-sensitive alphanumerics, all numbers, or all letters of up to 16 characters

### `market_tickers` (~124 tokens)

Get market tickers

Retrieve the latest price snapshot, best bid/ask price, and trading volume in the last 24 hours.Get the ranking of coins with the highest increase or the largest trading volume.

Input parameters:

- `instFamily` (string): Instrument family。 Applicable to FUTURES/SWAP/OPTION
- `instType` (string): Instrument type: [SPOT/SWAP/FUTURES/OPTION]
- `limit`: Number of results. Default: 30
- `sortBy` (string): Sorting method: [change24h/changeMax/last/vol24h/...]

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/aahl-mcp-okx/ghcr-io-aahl-mcp-okx-latest#diagnostics

## Score history

- 2026-08-03: 33
- 2026-08-02: 33
- 2026-08-01: 33
- 2026-07-31: 33
- 2026-07-30: 39
- 2026-07-29: 39
- 2026-07-28: 39
- 2026-07-27: 39
- 2026-07-26: 11

## Links

- Repository: https://github.com/aahl/mcp-okx
- Changelog RSS feed: https://verifymcp.io/servers/aahl-mcp-okx/ghcr-io-aahl-mcp-okx-latest/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/aahl-mcp-okx/ghcr-io-aahl-mcp-okx-latest/changelog.json
- HTML version of this page: https://verifymcp.io/servers/aahl-mcp-okx/ghcr-io-aahl-mcp-okx-latest