Gate MCP

Official63 toolsLive

by gate · Shell

Public Gate market data MCP for spot, futures, margin, options, delivery, earn, and alpha.

Gate MCP Server (io.github.gateio-dev/gate-mcp)

A Gate MCP (Model Context Protocol) server that enables AI agents to interact with the Gate cryptocurrency exchange for market data, trading, and account management. The server provides public Gate market data across spot, futures, margin, options, delivery, earn, and alpha.

🛠️ Key Features

Public market data for spot, futures, margin, options, delivery, earn, and alpha
Market endpoints include tickers, order books, K-line, funding rate, and liquidation history
Tool count: 63
License: MIT

🚀 Use Cases

Retrieve spot and futures market data (tickers, order books, K-line)
Access derivatives-specific data such as funding rate and liquidation history
Query additional instrument categories: margin, options, delivery, earn, and alpha

⚡ Developer Benefits

MCP integration to connect agents to Gate market data and trading/account workflows
Broad market coverage aligned to the listed categories

⚠️ Limitations

Description excerpt includes features “no ” (content truncated), so additional constraints are not available from the provided data.

Captured live from the server via tools/list.

cex_activity_list_activity_types

List activity types.

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_alpha_list_alpha_currencies

List Alpha currencies.

Parameters3

currency	string	optional	Query by currency symbol
limit	number	optional	Maximum number of records returned in a single list
page	number	optional	Page number

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "Query by currency symbol",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of records returned in a single list",
      "type": "number"
    },
    "page": {
      "description": "Page number",
      "type": "number"
    }
  }
}

cex_alpha_list_alpha_tickers

List Alpha tickers.

Parameters3

currency	string	optional	Query by specified currency name
limit	number	optional	Maximum number of records returned in a single list
page	number	optional	Page number

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "Query by specified currency name",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of records returned in a single list",
      "type": "number"
    },
    "page": {
      "description": "Page number",
      "type": "number"
    }
  }
}

cex_alpha_list_alpha_tokens

List Alpha tokens.

Parameters4

address	string	optional	Query by contract address
chain	string	optional	Chain: solana, eth, bsc, base, world, sui, arbitrum, avalanche, polygon, linea, optimism, zksync, gatelayer
launch_platform	string	optional	Launch platform: meteora_dbc, fourmeme, moonshot, pump, raydium_launchlab, letsbonk, gatefun, virtuals
page	number	optional	Page number

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Query by contract address",
      "type": "string"
    },
    "chain": {
      "description": "Chain: solana, eth, bsc, base, world, sui, arbitrum, avalanche, polygon, linea, optimism, zksync, gatelayer",
      "type": "string"
    },
    "launch_platform": {
      "description": "Launch platform: meteora_dbc, fourmeme, moonshot, pump, raydium_launchlab, letsbonk, gatefun, virtuals",
      "type": "string"
    },
    "page": {
      "description": "Page number",
      "type": "number"
    }
  }
}

cex_dc_get_dc_contract

Get delivery contract.

Parameters2

contract	string	required	Delivery contract identifier (e.g. BTC_USDT)
settle	string	optional	Settlement currency for delivery (e.g. usdt, btc)

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Delivery contract identifier (e.g. BTC_USDT)",
      "type": "string"
    },
    "settle": {
      "description": "Settlement currency for delivery (e.g. usdt, btc)",
      "type": "string"
    }
  },
  "required": [
    "contract"
  ]
}

cex_dc_list_dc_candlesticks

List delivery candlesticks.

Parameters6

contract	string	required	Delivery contract identifier (e.g. BTC_USDT; may use mark_/index_ prefix for price type)
from	number	optional	Start timestamp in seconds
interval	string	optional	Time interval for data points
limit	number	optional	Maximum number of data points to return
settle	string	optional	Settlement currency for delivery (e.g. usdt, btc)
to	number	optional	End timestamp in seconds

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Delivery contract identifier (e.g. BTC_USDT; may use mark_/index_ prefix for price type)",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "interval": {
      "description": "Time interval for data points",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of data points to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency for delivery (e.g. usdt, btc)",
      "type": "string"
    },
    "to": {
      "description": "End timestamp in seconds",
      "type": "number"
    }
  },
  "required": [
    "contract"
  ]
}

cex_dc_list_dc_contracts

List delivery contracts.

Parameters1

settle

string

optional

Settlement currency for delivery (e.g. usdt, btc)

Raw schema

{
  "type": "object",
  "properties": {
    "settle": {
      "description": "Settlement currency for delivery (e.g. usdt, btc)",
      "type": "string"
    }
  }
}

cex_dc_list_dc_insurance_ledger

List delivery insurance ledger.

Parameters2

limit	number	optional	Maximum number of records to return
settle	string	optional	Settlement currency for delivery (e.g. usdt, btc)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency for delivery (e.g. usdt, btc)",
      "type": "string"
    }
  }
}

cex_dc_list_dc_order_book

Get delivery order book.

Parameters5

contract	string	required	Delivery contract identifier (e.g. BTC_USDT)
interval	string	optional	Order depth aggregation precision. 0 means no aggregation, defaults to 0 if not specified
limit	number	optional	Maximum number of order depth levels to return
settle	string	optional	Settlement currency for delivery (e.g. usdt, btc)
with_id	boolean	optional	Whether to return order book update ID

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Delivery contract identifier (e.g. BTC_USDT)",
      "type": "string"
    },
    "interval": {
      "description": "Order depth aggregation precision. 0 means no aggregation, defaults to 0 if not specified",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of order depth levels to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency for delivery (e.g. usdt, btc)",
      "type": "string"
    },
    "with_id": {
      "description": "Whether to return order book update ID",
      "type": "boolean"
    }
  },
  "required": [
    "contract"
  ]
}

cex_dc_list_dc_risk_limit_tiers

List delivery risk limit tiers.

Parameters4

contract	string	optional	Optional delivery contract identifier; if set, risk tiers for that contract only
limit	number	optional	Maximum number of records to return
offset	number	optional	List offset, starting from 0
settle	string	optional	Settlement currency for delivery (e.g. usdt, btc)

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Optional delivery contract identifier; if set, risk tiers for that contract only",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "offset": {
      "description": "List offset, starting from 0",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency for delivery (e.g. usdt, btc)",
      "type": "string"
    }
  }
}

cex_dc_list_dc_tickers

List delivery tickers.

Parameters2

contract	string	optional	Optional delivery contract identifier; if set, only that contract's ticker is returned
settle	string	optional	Settlement currency for delivery (e.g. usdt, btc)

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Optional delivery contract identifier; if set, only that contract's ticker is returned",
      "type": "string"
    },
    "settle": {
      "description": "Settlement currency for delivery (e.g. usdt, btc)",
      "type": "string"
    }
  }
}

cex_dc_list_dc_trades

List delivery trades.

Parameters6

contract	string	required	Delivery contract identifier (e.g. BTC_USDT)
from	number	optional	Start timestamp in seconds
last_id	string	optional	Specify list starting point using the last record ID from previous request
limit	number	optional	Maximum number of records to return
settle	string	optional	Settlement currency for delivery (e.g. usdt, btc)
to	number	optional	End timestamp in seconds

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Delivery contract identifier (e.g. BTC_USDT)",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "last_id": {
      "description": "Specify list starting point using the last record ID from previous request",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency for delivery (e.g. usdt, btc)",
      "type": "string"
    },
    "to": {
      "description": "End timestamp in seconds",
      "type": "number"
    }
  },
  "required": [
    "contract"
  ]
}

cex_earn_list_dual_investment_plans

List dual investment plans.

Parameters7

coin	string	optional	Investment currency, e.g. BTC
page	number	optional	Page number
page_size	number	optional	Items per page
plan_id	number	optional	Financial project ID (int64)
quote_currency	string	optional	Settlement currency: default USDT, optional GUSD
sort	string	optional	Sort: apy (APR desc), short-period (term asc), multiple (premium desc)
type	string	optional	put (low buy) or call (high sell)

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "description": "Investment currency, e.g. BTC",
      "type": "string"
    },
    "page": {
      "description": "Page number",
      "type": "number"
    },
    "page_size": {
      "description": "Items per page",
      "type": "number"
    },
    "plan_id": {
      "description": "Financial project ID (int64)",
      "type": "number"
    },
    "quote_currency": {
      "description": "Settlement currency: default USDT, optional GUSD",
      "type": "string"
    },
    "sort": {
      "description": "Sort: apy (APR desc), short-period (term asc), multiple (premium desc)",
      "type": "string"
    },
    "type": {
      "description": "put (low buy) or call (high sell)",
      "type": "string"
    }
  }
}

cex_earn_list_earn_fixed_term_products

List fixed-term Earn products.

Parameters4

asset	string	optional	Currency name, e.g. USDT
limit	number	required	Page size
page	number	required	Page number
type	number	optional	Product type: 1=normal, 2=vip

Raw schema

{
  "type": "object",
  "properties": {
    "asset": {
      "description": "Currency name, e.g. USDT",
      "type": "string"
    },
    "limit": {
      "description": "Page size",
      "type": "number"
    },
    "page": {
      "description": "Page number",
      "type": "number"
    },
    "type": {
      "description": "Product type: 1=normal, 2=vip",
      "type": "number"
    }
  },
  "required": [
    "page",
    "limit"
  ]
}

cex_earn_list_earn_fixed_term_products_by_asset

List fixed-term Earn products by asset.

Parameters2

asset	string	required	Currency name, e.g. USDT, BTC
type	string	optional	Product type: empty or 1=normal, 2=vip, 0=all

Raw schema

{
  "type": "object",
  "properties": {
    "asset": {
      "description": "Currency name, e.g. USDT, BTC",
      "type": "string"
    },
    "type": {
      "description": "Product type: empty or 1=normal, 2=vip, 0=all",
      "type": "string"
    }
  },
  "required": [
    "asset"
  ]
}

cex_earn_list_uni_currencies

List Simple Earn currencies.

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_fx_get_fx_candlesticks

Get futures candlestick/OHLCV data

Parameters7

contract	string	required	Futures contract name
from	number	optional	Start timestamp in seconds. Defaults to to - 100 * interval if not specified
interval	string	optional	Time interval. Note: 1w means natural week, 7d aligns with Unix epoch, 30d means natural month
limit	number	optional	Maximum number of data points to return. Mutually exclusive with from/to parameters
settle	string	optional	Settlement currency
timezone	string	optional	Timezone: all/utc0/utc8, defaults to utc0
to	number	optional	End timestamp in seconds, defaults to current time if not specified

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds. Defaults to to - 100 * interval if not specified",
      "type": "number"
    },
    "interval": {
      "description": "Time interval. Note: 1w means natural week, 7d aligns with Unix epoch, 30d means natural month",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of data points to return. Mutually exclusive with from/to parameters",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    },
    "timezone": {
      "description": "Timezone: all/utc0/utc8, defaults to utc0",
      "type": "string"
    },
    "to": {
      "description": "End timestamp in seconds, defaults to current time if not specified",
      "type": "number"
    }
  },
  "required": [
    "contract"
  ]
}

cex_fx_get_fx_contract

Get details of a single futures contract

Parameters2

contract	string	required	Futures contract name
settle	string	optional	Settlement currency

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name",
      "type": "string"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    }
  },
  "required": [
    "contract"
  ]
}

cex_fx_get_fx_funding_rate

Get funding rate history for a futures contract

Parameters5

contract	string	required	Futures contract name
from	number	optional	Start timestamp in seconds
limit	number	optional	Maximum number of records to return
settle	string	optional	Settlement currency
to	number	optional	End timestamp in seconds

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    },
    "to": {
      "description": "End timestamp in seconds",
      "type": "number"
    }
  },
  "required": [
    "contract"
  ]
}

cex_fx_get_fx_order_book

Get futures order book

Parameters5

contract	string	required	Futures contract name
interval	string	optional	Order depth aggregation precision. 0 means no aggregation, defaults to 0 if not specified
limit	number	optional	Maximum number of order depth levels to return
settle	string	optional	Settlement currency
with_id	boolean	optional	Whether to return order book update ID. ID increments by 1 on each change

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name",
      "type": "string"
    },
    "interval": {
      "description": "Order depth aggregation precision. 0 means no aggregation, defaults to 0 if not specified",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of order depth levels to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    },
    "with_id": {
      "description": "Whether to return order book update ID. ID increments by 1 on each change",
      "type": "boolean"
    }
  },
  "required": [
    "contract"
  ]
}

cex_fx_get_fx_premium_index

Get premium index (mark price minus index price) history for a contract

Parameters6

contract	string	required	Futures contract name
from	number	optional	Start timestamp in seconds. Defaults to to - 100 * interval if not specified
interval	string	optional	Time interval for data points
limit	number	optional	Maximum number of data points to return. Mutually exclusive with from/to parameters
settle	string	optional	Settlement currency
to	number	optional	End timestamp in seconds, defaults to current time if not specified

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds. Defaults to to - 100 * interval if not specified",
      "type": "number"
    },
    "interval": {
      "description": "Time interval for data points",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of data points to return. Mutually exclusive with from/to parameters",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    },
    "to": {
      "description": "End timestamp in seconds, defaults to current time if not specified",
      "type": "number"
    }
  },
  "required": [
    "contract"
  ]
}

cex_fx_get_fx_risk_limit_table

Get a specific risk limit tier table by table ID.

Parameters2

settle	string	required	Settlement currency: usdt or btc
table_id	string	required	Risk limit table ID

Raw schema

{
  "type": "object",
  "properties": {
    "settle": {
      "description": "Settlement currency: usdt or btc",
      "type": "string"
    },
    "table_id": {
      "description": "Risk limit table ID",
      "type": "string"
    }
  },
  "required": [
    "settle",
    "table_id"
  ]
}

cex_fx_get_fx_tickers

Get ticker information for futures contracts

Parameters2

contract	string	optional	Futures contract name. Only returns data for this contract if specified
settle	string	optional	Settlement currency

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name. Only returns data for this contract if specified",
      "type": "string"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    }
  }
}

cex_fx_get_fx_trades

Get recent public trades for a futures contract

Parameters7

contract	string	required	Futures contract name
from	number	optional	Start timestamp in seconds. If not specified, returns records limited by to and limit
last_id	string	optional	Specify list starting point using the last record ID from previous request
limit	number	optional	Maximum number of records to return
offset	number	optional	List offset, starting from 0
settle	string	optional	Settlement currency
to	number	optional	End timestamp in seconds, defaults to current time if not specified

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds. If not specified, returns records limited by to and limit",
      "type": "number"
    },
    "last_id": {
      "description": "Specify list starting point using the last record ID from previous request",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "offset": {
      "description": "List offset, starting from 0",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    },
    "to": {
      "description": "End timestamp in seconds, defaults to current time if not specified",
      "type": "number"
    }
  },
  "required": [
    "contract"
  ]
}

cex_fx_get_index_constituents

Get constituent assets and weights for a futures index

Parameters2

index	string	required	Index name
settle	string	optional	Settlement currency

Raw schema

{
  "type": "object",
  "properties": {
    "index": {
      "description": "Index name",
      "type": "string"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    }
  },
  "required": [
    "index"
  ]
}

cex_fx_list_batch_fx_funding_rates

Get current funding rates for multiple contracts in one request

Parameters2

contracts	string	required	Comma-separated list of contract names, e.g. BTC_USDT,ETH_USDT
settle	string	optional	Settlement currency

Raw schema

{
  "type": "object",
  "properties": {
    "contracts": {
      "description": "Comma-separated list of contract names, e.g. BTC_USDT,ETH_USDT",
      "type": "string"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    }
  },
  "required": [
    "contracts"
  ]
}

cex_fx_list_contract_stats

Get contract statistics (open interest， long/short ratio， etc.)

Parameters5

contract	string	required	Futures contract name
from	number	optional	Start timestamp in seconds
interval	string	optional	Time interval for data points
limit	number	optional	Maximum number of data points to return
settle	string	optional	Settlement currency

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "interval": {
      "description": "Time interval for data points",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of data points to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    }
  },
  "required": [
    "contract"
  ]
}

cex_fx_list_fx_contracts

List all perpetual futures contracts

Parameters3

limit	number	optional	Maximum number of records to return
offset	number	optional	List offset, starting from 0
settle	string	optional	Settlement currency

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "offset": {
      "description": "List offset, starting from 0",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    }
  }
}

cex_fx_list_fx_insurance_ledger

Get futures insurance fund history

Parameters2

limit	number	optional	Maximum number of records to return
settle	string	optional	Settlement currency

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    }
  }
}

cex_fx_list_fx_liq_orders

Get personal futures liquidation history.

Parameters5

contract	string	optional	Futures contract name. Only returns data for this contract if specified
from	number	optional	Start timestamp in seconds
limit	number	optional	Maximum number of records to return
settle	string	optional	Settlement currency
to	number	optional	End timestamp in seconds

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Futures contract name. Only returns data for this contract if specified",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "settle": {
      "description": "Settlement currency",
      "type": "string"
    },
    "to": {
      "description": "End timestamp in seconds",
      "type": "number"
    }
  }
}

cex_launch_get_candy_drop_activity_list_v4

List CandyDrop activities with optional filters (public, no auth)

Parameters6

currency	string	optional	Filter by currency name
limit	number	optional	Max rows to return, default 10, max 30
offset	number	optional	Offset for pagination, default 0
register_status	string	optional	registered \| unregistered; omit for all
rule_name	string	optional	Task type filter: spot, futures, deposit, invite, trading_bot, simple_earn, first_deposit, alpha, flash_swap, tradfi, etf
status	string	optional	ongoing \| upcoming \| ended; omit for all

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "Filter by currency name",
      "type": "string"
    },
    "limit": {
      "description": "Max rows to return, default 10, max 30",
      "type": "number"
    },
    "offset": {
      "description": "Offset for pagination, default 0",
      "type": "number"
    },
    "register_status": {
      "description": "registered | unregistered; omit for all",
      "type": "string"
    },
    "rule_name": {
      "description": "Task type filter: spot, futures, deposit, invite, trading_bot, simple_earn, first_deposit, alpha, flash_swap, tradfi, etf",
      "type": "string"
    },
    "status": {
      "description": "ongoing | upcoming | ended; omit for all",
      "type": "string"
    }
  }
}

cex_launch_get_candy_drop_activity_rules_v4

Get CandyDrop activity rules including prize pools and tasks (public). Pass activity_id OR currency (at least one required by API)

Parameters2

activity_id	number	optional	Activity ID; use with or instead of currency
currency	string	optional	Project/currency name; use with or instead of activity_id

Raw schema

{
  "type": "object",
  "properties": {
    "activity_id": {
      "description": "Activity ID; use with or instead of currency",
      "type": "number"
    },
    "currency": {
      "description": "Project/currency name; use with or instead of activity_id",
      "type": "string"
    }
  }
}

cex_launch_get_hodler_airdrop_project_list

List HODLer Airdrop campaigns with optional filters (public; logged-in users may see extra participation info)

Parameters5

join	number	optional	Participation filter: 0=all (default), 1=joined only. Omit parameter to use API default (all)
keyword	string	optional	Fuzzy match on currency or project name
page	number	optional	Page number, starting from 1
size	number	optional	Items per page, default 10
status	string	optional	Filter: ACTIVE, UNDERWAY, PREHEAT, FINISH; omit for all

Raw schema

{
  "type": "object",
  "properties": {
    "join": {
      "description": "Participation filter: 0=all (default), 1=joined only. Omit parameter to use API default (all)",
      "type": "number"
    },
    "keyword": {
      "description": "Fuzzy match on currency or project name",
      "type": "string"
    },
    "page": {
      "description": "Page number, starting from 1",
      "type": "number"
    },
    "size": {
      "description": "Items per page, default 10",
      "type": "number"
    },
    "status": {
      "description": "Filter: ACTIVE, UNDERWAY, PREHEAT, FINISH; omit for all",
      "type": "string"
    }
  }
}

cex_launch_list_launch_pool_projects

List launch pool projects with optional filters

Parameters7

limit_rule	number	optional	Limit rule: 0=Normal pool, 1=Newbie pool
mortgage_coin	string	optional	Staking currency exact match
page	number	optional	Page number, starting from 1
page_size	number	optional	Items per page, default 10, max 30
search_coin	string	optional	Reward currency & name fuzzy match
sort_type	number	optional	Sort type: 1=Max APR descending, 2=Max APR ascending
status	number	optional	Project status filter: 0=All, 1=In progress, 2=Warming up, 3=Ended, 4=In progress + Warming up

Raw schema

{
  "type": "object",
  "properties": {
    "limit_rule": {
      "description": "Limit rule: 0=Normal pool, 1=Newbie pool",
      "type": "number"
    },
    "mortgage_coin": {
      "description": "Staking currency exact match",
      "type": "string"
    },
    "page": {
      "description": "Page number, starting from 1",
      "type": "number"
    },
    "page_size": {
      "description": "Items per page, default 10, max 30",
      "type": "number"
    },
    "search_coin": {
      "description": "Reward currency & name fuzzy match",
      "type": "string"
    },
    "sort_type": {
      "description": "Sort type: 1=Max APR descending, 2=Max APR ascending",
      "type": "number"
    },
    "status": {
      "description": "Project status filter: 0=All, 1=In progress, 2=Warming up, 3=Ended, 4=In progress + Warming up",
      "type": "number"
    }
  }
}

cex_margin_get_market_margin_tier

Get margin leverage tiers for a currency pair

Parameters1

currency_pair

string

required

Currency pair, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "currency_pair": {
      "description": "Currency pair, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "currency_pair"
  ]
}

cex_margin_get_uni_currency_pair

Get details of a specific unified margin currency pair

Parameters1

currency_pair

string

required

Currency pair, e.g. ADA_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "currency_pair": {
      "description": "Currency pair, e.g. ADA_USDT",
      "type": "string"
    }
  },
  "required": [
    "currency_pair"
  ]
}

cex_margin_list_uni_currency_pairs

List all currency pairs supported for unified margin lending

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_mcl_get_multi_collateral_current_rate

Get current interest rates for specified currencies in multi-collateral loans (public)

Parameters2

currencies	string	required	Currency names separated by commas, e.g. BTC,ETH,USDT. Maximum 100 items
vip_level	string	optional	VIP level, defaults to 0 if not specified

Raw schema

{
  "type": "object",
  "properties": {
    "currencies": {
      "description": "Currency names separated by commas, e.g. BTC,ETH,USDT. Maximum 100 items",
      "type": "string"
    },
    "vip_level": {
      "description": "VIP level, defaults to 0 if not specified",
      "type": "string"
    }
  },
  "required": [
    "currencies"
  ]
}

cex_mcl_get_multi_collateral_fix_rate

Get available fixed interest rates for multi-collateral loans (public)

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_mcl_get_multi_collateral_ltv

Get LTV (Loan-to-Value) ratios for multi-collateral loans (public)

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_mcl_list_multi_collateral_currencies

List all supported currencies for multi-collateral loans (public)

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_options_get_options_contract

Get details of a single options contract

Parameters1

contract

string

required

Options contract name

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Options contract name",
      "type": "string"
    }
  },
  "required": [
    "contract"
  ]
}

cex_options_get_options_settlement

Get a single options settlement record

Parameters3

at	string	required	Settlement timestamp (Unix timestamp in seconds)
contract	string	required	Options contract name
underlying	string	required	Underlying asset name, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "at": {
      "description": "Settlement timestamp (Unix timestamp in seconds)",
      "type": "string"
    },
    "contract": {
      "description": "Options contract name",
      "type": "string"
    },
    "underlying": {
      "description": "Underlying asset name, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "contract",
    "underlying",
    "at"
  ]
}

cex_options_list_options_candlesticks

Get options candlestick data

Parameters5

contract	string	required	Options contract name
from	number	optional	Start timestamp in seconds
interval	string	optional	Time interval between data points, e.g. 1m, 5m, 15m, 30m, 1h
limit	number	optional	Maximum number of records to return
to	number	optional	End timestamp in seconds

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Options contract name",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "interval": {
      "description": "Time interval between data points, e.g. 1m, 5m, 15m, 30m, 1h",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "to": {
      "description": "End timestamp in seconds",
      "type": "number"
    }
  },
  "required": [
    "contract"
  ]
}

cex_options_list_options_contracts

List all options contracts for an underlying

Parameters2

expiration	number	optional	Unix timestamp of expiration date
underlying	string	required	Underlying asset name, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "expiration": {
      "description": "Unix timestamp of expiration date",
      "type": "number"
    },
    "underlying": {
      "description": "Underlying asset name, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "underlying"
  ]
}

cex_options_list_options_expirations

List option expiration dates for an underlying

Parameters1

underlying

string

required

Underlying asset name, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "underlying": {
      "description": "Underlying asset name, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "underlying"
  ]
}

cex_options_list_options_order_book

Get options order book

Parameters4

contract	string	required	Options contract name
interval	string	optional	Price precision for merged depth. 0 means no merging
limit	number	optional	Number of depth levels
with_id	boolean	optional	Whether to return depth update ID

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Options contract name",
      "type": "string"
    },
    "interval": {
      "description": "Price precision for merged depth. 0 means no merging",
      "type": "string"
    },
    "limit": {
      "description": "Number of depth levels",
      "type": "number"
    },
    "with_id": {
      "description": "Whether to return depth update ID",
      "type": "boolean"
    }
  },
  "required": [
    "contract"
  ]
}

cex_options_list_options_settlements

List options settlement history for an underlying

Parameters5

from	number	optional	Start timestamp in seconds
limit	number	optional	Maximum number of records to return
offset	number	optional	List offset, starting from 0
to	number	optional	End timestamp in seconds
underlying	string	required	Underlying asset name, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "offset": {
      "description": "List offset, starting from 0",
      "type": "number"
    },
    "to": {
      "description": "End timestamp in seconds",
      "type": "number"
    },
    "underlying": {
      "description": "Underlying asset name, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "underlying"
  ]
}

cex_options_list_options_tickers

Get options tickers for an underlying

Parameters1

underlying

string

required

Underlying asset name, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "underlying": {
      "description": "Underlying asset name, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "underlying"
  ]
}

cex_options_list_options_trades

List public options trades

Parameters6

contract	string	optional	Options contract name
from	number	optional	Start timestamp in seconds
limit	number	optional	Maximum number of records to return
offset	number	optional	List offset, starting from 0
to	number	optional	End timestamp in seconds
type	string	optional	Option type: C for call, P for put

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "description": "Options contract name",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "offset": {
      "description": "List offset, starting from 0",
      "type": "number"
    },
    "to": {
      "description": "End timestamp in seconds",
      "type": "number"
    },
    "type": {
      "description": "Option type: C for call, P for put",
      "type": "string"
    }
  }
}

cex_options_list_options_underlying_candlesticks

Get candlestick data for an options underlying index

Parameters5

from	number	optional	Start timestamp in seconds
interval	string	optional	Time interval between data points, e.g. 1m, 5m, 15m, 30m, 1h
limit	number	optional	Maximum number of records to return
to	number	optional	End timestamp in seconds
underlying	string	required	Underlying asset name, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "interval": {
      "description": "Time interval between data points, e.g. 1m, 5m, 15m, 30m, 1h",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of records to return",
      "type": "number"
    },
    "to": {
      "description": "End timestamp in seconds",
      "type": "number"
    },
    "underlying": {
      "description": "Underlying asset name, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "underlying"
  ]
}

cex_options_list_options_underlying_tickers

Get ticker data for all contracts under an underlying

Parameters1

underlying

string

required

Underlying asset name, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "underlying": {
      "description": "Underlying asset name, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "underlying"
  ]
}

cex_options_list_options_underlyings

List all options underlying assets

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_spot_get_currency

Get details of a single currency

Parameters1

currency

string

required

Currency name

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "Currency name",
      "type": "string"
    }
  },
  "required": [
    "currency"
  ]
}

cex_spot_get_currency_pair

Get details of a single currency pair

Parameters1

currency_pair

string

required

Currency pair name, e.g. BTC_USDT

Raw schema

{
  "type": "object",
  "properties": {
    "currency_pair": {
      "description": "Currency pair name, e.g. BTC_USDT",
      "type": "string"
    }
  },
  "required": [
    "currency_pair"
  ]
}

cex_spot_get_spot_candlesticks

Get candlestick/OHLCV data for a currency pair

Parameters5

currency_pair	string	required	Currency pair
from	number	optional	Start time of K-line in Unix timestamp (seconds). Defaults to to - 100 * interval if not specified
interval	string	optional	Time interval of data points. Note: 30d represents natural month, not 30 days
limit	number	optional	Maximum number of data points to return. Mutually exclusive with from/to parameters
to	number	optional	End time of K-line in Unix timestamp (seconds). Defaults to current time if not specified

Raw schema

{
  "type": "object",
  "properties": {
    "currency_pair": {
      "description": "Currency pair",
      "type": "string"
    },
    "from": {
      "description": "Start time of K-line in Unix timestamp (seconds). Defaults to to - 100 * interval if not specified",
      "type": "number"
    },
    "interval": {
      "description": "Time interval of data points. Note: 30d represents natural month, not 30 days",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of data points to return. Mutually exclusive with from/to parameters",
      "type": "number"
    },
    "to": {
      "description": "End time of K-line in Unix timestamp (seconds). Defaults to current time if not specified",
      "type": "number"
    }
  },
  "required": [
    "currency_pair"
  ]
}

cex_spot_get_spot_order_book

Get the order book for a currency pair

Parameters4

currency_pair	string	required	Currency pair
interval	string	optional	Order depth aggregation precision. 0 means no aggregation
limit	number	optional	Maximum number of order depth levels to return, default 10, max 100
with_id	boolean	optional	Whether to return order book update ID

Raw schema

{
  "type": "object",
  "properties": {
    "currency_pair": {
      "description": "Currency pair",
      "type": "string"
    },
    "interval": {
      "description": "Order depth aggregation precision. 0 means no aggregation",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of order depth levels to return, default 10, max 100",
      "type": "number"
    },
    "with_id": {
      "description": "Whether to return order book update ID",
      "type": "boolean"
    }
  },
  "required": [
    "currency_pair"
  ]
}

cex_spot_get_spot_tickers

Get ticker information for one or all currency pairs

Parameters2

currency_pair	string	optional	Currency pair name, e.g. BTC_USDT. Returns all pairs if not specified
timezone	string	optional	Timezone, e.g. Asia/Shanghai. Affects the time range of statistics

Raw schema

{
  "type": "object",
  "properties": {
    "currency_pair": {
      "description": "Currency pair name, e.g. BTC_USDT. Returns all pairs if not specified",
      "type": "string"
    },
    "timezone": {
      "description": "Timezone, e.g. Asia/Shanghai. Affects the time range of statistics",
      "type": "string"
    }
  }
}

cex_spot_get_spot_trades

Get recent trades for a currency pair

Parameters7

currency_pair	string	required	Currency pair
from	number	optional	Start timestamp in seconds
last_id	string	optional	Use the last record ID from previous list as starting point for next list
limit	number	optional	Maximum number of records to return, default 100
page	number	optional	Page number
reverse	boolean	optional	Whether to retrieve records less than last_id. Default returns records greater than last_id
to	number	optional	End timestamp in seconds, defaults to current time if not specified

Raw schema

{
  "type": "object",
  "properties": {
    "currency_pair": {
      "description": "Currency pair",
      "type": "string"
    },
    "from": {
      "description": "Start timestamp in seconds",
      "type": "number"
    },
    "last_id": {
      "description": "Use the last record ID from previous list as starting point for next list",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of records to return, default 100",
      "type": "number"
    },
    "page": {
      "description": "Page number",
      "type": "number"
    },
    "reverse": {
      "description": "Whether to retrieve records less than last_id. Default returns records greater than last_id",
      "type": "boolean"
    },
    "to": {
      "description": "End timestamp in seconds, defaults to current time if not specified",
      "type": "number"
    }
  },
  "required": [
    "currency_pair"
  ]
}

cex_spot_list_currencies

List all currencies supported

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_spot_list_currency_pairs

List all available spot trading pairs

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

cex_square_list_live_replay

List live stream replays from Gate Square

Parameters4

coin	string	optional	Currency name filter (e.g. BTC, ETH)
limit	number	optional	Number of results, 1~10, default 3
sort	string	optional	Sort order: hot=hottest (default), new=newest
tag	string	optional	Business type filter: Market Analysis, Hot Topics, Blockchain, Others

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "description": "Currency name filter (e.g. BTC, ETH)",
      "type": "string"
    },
    "limit": {
      "description": "Number of results, 1~10, default 3",
      "type": "number"
    },
    "sort": {
      "description": "Sort order: hot=hottest (default), new=newest",
      "type": "string"
    },
    "tag": {
      "description": "Business type filter: Market Analysis, Hot Topics, Blockchain, Others",
      "type": "string"
    }
  }
}

cex_square_list_square_ai_search

Search Gate Square content using AI (posts， analysis， signals)

Parameters6

currency	string	optional	Currency filter (exact currency code, e.g. BTC, ETH, SOL)
keyword	string	optional	Search keyword (currency name or content keyword, e.g. BTC, ETH)
limit	number	optional	Number of results, 1~50, default 10
page	number	optional	Page number for pagination, starting from 1
sort	number	optional	Sort order: 0=hottest (default), 1=newest
time_range	number	optional	Time range: 0=all (default), 1=last day, 2=last week, 3=last month

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "Currency filter (exact currency code, e.g. BTC, ETH, SOL)",
      "type": "string"
    },
    "keyword": {
      "description": "Search keyword (currency name or content keyword, e.g. BTC, ETH)",
      "type": "string"
    },
    "limit": {
      "description": "Number of results, 1~50, default 10",
      "type": "number"
    },
    "page": {
      "description": "Page number for pagination, starting from 1",
      "type": "number"
    },
    "sort": {
      "description": "Sort order: 0=hottest (default), 1=newest",
      "type": "number"
    },
    "time_range": {
      "description": "Time range: 0=all (default), 1=last day, 2=last week, 3=last month",
      "type": "number"
    }
  }
}

README.md24 KBView on GitHub

Gate MCP Server

English | 中文

A Gate MCP (Model Context Protocol) server that enables AI agents to interact with the Gate cryptocurrency exchange for market data, trading, and account management.

Features

🔍 Public Market Data - Spot, futures, margin, options, delivery, earn, alpha tickers, order books, K-line, funding rate, liquidation history (no auth required)
💹 Trading - Create/cancel/amend spot, futures, options, delivery orders; price-triggered orders; trail orders
💼 Account & Wallet - Balances, transfers, deposits, withdrawals, sub-accounts, unified account
📊 Margin & Earn - Margin loans, earn products, multi-currency flash swap
🎯 Activity & Welfare - Activity center, coupons, launch pool, square, welfare
🌍 TradFi, CrossEx, P2P - Traditional finance, cross-exchange, P2P trading
🌐 DEX - On-chain wallet, swap (single-chain & cross-chain), token info, market data across 20+ chains
📰 Info - Coin discovery, market snapshots, technical/platform metrics, on-chain and macro data
📢 News - Crypto news, social insights, market events, prediction markets
📚 Docs - Research reports, papers, and documentation search
🔐 OAuth2 - Secure authorization for trading and private tools

MCP Endpoints

The service exposes the following MCP endpoints:

Endpoint	Auth	Tools
`https://api.gatemcp.ai/mcp`	None	Public market data (58 tools: spot, futures, margin, options, delivery, earn, alpha, activity, launch pool, square, flash swap)
`https://api.gatemcp.ai/mcp/exchange`	OAuth2	CEX trading & account (400+ tools: spot/futures/options/delivery/margin trading, wallet, unified account, sub-accounts, earn, flash swap, rebate, TradFi, CrossEx, P2P, Alpha, activity center, coupon, launch pool, square, welfare)
`https://api.gatemcp.ai/mcp/dex`	Google / Gate OAuth	DEX wallet & swap (33 tools: auth, wallet, chain config, transfer, swap, market data, token info, agentic, RPC across 20+ chains)
`https://api.gatemcp.ai/mcp/info`	None	Coin info & analysis (32 tools: coins, snapshots, trends, on-chain, platform metrics, macro, market detail)
`https://api.gatemcp.ai/mcp/open/info`	None	Gate Info submission surface (exactly 7 tools: coin profile, market overview/snapshots, kline, order book, recent trades)
`https://api.gatemcp.ai/mcp/news`	None	News & research (18 tools: news/UGC/X/web, announcements, sentiment, events, prediction markets)
`https://api.gatemcp.ai/mcp/docs`	None	Docs research (3 tools: research search, coin research, papers)

Market data only → Use /mcp (no Gate account needed)
CEX trading, balances, transfers → Use /mcp/exchange (Gate OAuth2 required)
DEX wallet, swap, on-chain → Use /mcp/dex (Google / Gate OAuth required)
Coin info, technical analysis → Use /mcp/info (no auth)
ChatGPT / OpenAI Apps Gate Info listing → Use /mcp/open/info (7-tool allowlist; no auth)
News, announcements → Use /mcp/news (no auth)
Research docs & papers → Use /mcp/docs (no auth)

Transport: Streamable HTTP (with SSE fallback).

Authorization (OAuth2)

/mcp/exchange requires Gate OAuth2; /mcp/dex requires Google or Gate OAuth. The endpoints /mcp, /mcp/info, /mcp/open/info, /mcp/news, and /mcp/docs do not require any authentication.

Using mcporter

Prerequisites: Node.js >= 18, npm. See Quick Start - mcporter for full installation steps.

bash

# Add Private MCP (trading, requires OAuth)
mcporter config add gate-mcp --url https://api.gatemcp.ai/mcp/exchange --auth oauth

# Authorize (opens browser to log in)
mcporter auth gate-mcp

Scopes (for `/mcp/exchange`)

Scope	Use
`market`	Public market data (tickers, order books, K-line, etc.)
`profile`	Account info, orders, positions (read-only)
`trade`	Create/cancel/amend orders
`wallet`	Transfers, deposits, withdrawals
`account`	Unified account, sub-accounts

Quick Start

Prerequisites

Gate account (required only for /mcp/exchange)
MCP-compatible client (Cursor, Claude CLI, Trae, OpenClaw, etc.)
Node.js >= 18 (for mcporter, Trae, Qoder, and other npm-based clients)
Python >= 3.9 (optional, for Claude Desktop proxy)

Cursor

Method 1: One-click Install (Recommended)

Just paste the following into the Cursor AI chat — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

For full trading (OAuth on connect):

Edit ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "Gate": {
      "url": "https://api.gatemcp.ai/mcp/exchange",
      "transport": "streamable-http",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

For market data only (no auth):

json

{
  "mcpServers": {
    "Gate": {
      "url": "https://api.gatemcp.ai/mcp",
      "transport": "streamable-http",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

For DEX (on-chain wallet, swap):

json

{
  "mcpServers": {
    "Gate-Dex": {
      "url": "https://api.gatemcp.ai/mcp/dex",
      "headers": {
        "x-api-key": "MCP_AK_8W2N7Q",
        "Authorization": "Bearer ${GATE_MCP_TOKEN}"
      }
    }
  }
}

For Info & News (no auth):

json

{
  "mcpServers": {
    "Gate-Info": {
      "url": "https://api.gatemcp.ai/mcp/info"
    },
    "Gate-News": {
      "url": "https://api.gatemcp.ai/mcp/news"
    }
  }
}

See Cursor setup.

mcporter / OpenClaw

Method 1: One-click Install (Recommended)

Just paste the following into the OpenClaw AI chat — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

Prerequisites (before installing mcporter)

Node.js >= 18 (mcporter requires npm)
npm (comes with Node.js) — verify with: node -v and npm -v
Gate account (for OAuth login when using /mcp/exchange)

Install mcporter

bash

# Global install
npm install -g mcporter

# Verify installation
mcporter --version

Alternatively, run without installing: npx mcporter <command> (uses current Node.js/npm).

Add MCP and authorize

bash

# Add Private MCP (trading, OAuth)
mcporter config add gate-mcp --url https://api.gatemcp.ai/mcp/exchange --auth oauth

# Authorize (opens browser to log in)
mcporter auth gate-mcp

# Add DEX MCP
mcporter config add gate-dex --url https://api.gatemcp.ai/mcp/dex

# Add Info MCP (no auth)
mcporter config add gate-info --url https://api.gatemcp.ai/mcp/info

# Add News MCP (no auth)
mcporter config add gate-news --url https://api.gatemcp.ai/mcp/news

See OpenClaw setup for detailed steps.

Claude CLI

Method 1: One-click Install (Recommended)

Just paste the following into Claude CLI — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

bash

brew install claude-code
# Full trading (OAuth)
claude mcp add --transport http Gate https://api.gatemcp.ai/mcp/exchange
# Restart Claude CLI after authorization is complete

# Info (no auth)
claude mcp add --transport http Gate-Info https://api.gatemcp.ai/mcp/info

# News (no auth)
claude mcp add --transport http Gate-News https://api.gatemcp.ai/mcp/news

claude mcp list

Trae

Edit Trae settings. Uses mcp-remote to proxy HTTP MCP (OAuth prompt on first connect for /mcp/exchange):

json

{
  "mcpServers": {
    "gate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/exchange"
      ]
    },
    "gate-info": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/info"
      ]
    },
    "gate-news": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/news"
      ]
    }
  }
}

Qoder

Edit Qoder MCP settings (e.g. ~/.qoder/mcp.json or in Qoder settings):

json

{
  "mcpServers": {
    "gate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/exchange"
      ]
    },
    "gate-info": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/info"
      ]
    },
    "gate-news": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/news"
      ]
    }
  }
}

Claude Desktop

Claude Desktop requires a local stdio proxy.

Download the Python proxy file
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "Gate": {
      "command": "python3",
      "args": ["/path/to/gate-mcp-proxy.py"]
    }
  }
}

See Claude Desktop setup for detailed instructions.

Alternative: gate-local-mcp (local stdio with API keys)

For local development without OAuth, use gate-local-mcp (npm: gate-mcp) — a stdio MCP server that uses GATE_API_KEY / GATE_API_SECRET (optional for public market data only). Configure it as a command-based MCP server (e.g. "command": "npx", "args": ["-y", "gate-mcp"]). By default it registers 384 tools across 22 modules (spot, futures, delivery, margin, wallet, account, options, earn, flash_swap, unified, sub_account, multi_collateral_loan, p2p, tradfi, crossex, alpha, rebate, activity, coupon, launch, square, welfare). Reduce the set with GATE_MODULES or --modules=spot,futures, or enable read-only mode with GATE_READONLY=true / --readonly.

Important: Wire-level tool names use abbreviations (futures→fx, delivery→dc, sub_account→sa, etc.); they differ from the remote api.gatemcp.ai naming. Always use the names returned by tools/list.

Full tool list: gate-local-mcp-tools.md.

LobeHub (desktop)

On the LobeHub MCP marketplace this server appears as identifier gate-gate-mcp. The npm package name is gate-mcp — run npx -y gate-mcp, not gate-gate-mcp.

Per LobeHub custom MCP, stdio servers work on the desktop app only; inject environment variables for Gate API authentication. Use Import JSON when adding a custom skill.

Public endpoints only:

json

{
  "mcpServers": {
    "gate-mcp": {
      "command": "npx",
      "args": ["-y", "gate-mcp"],
      "type": "stdio"
    }
  }
}

With API key authentication:

json

{
  "mcpServers": {
    "gate-mcp": {
      "command": "npx",
      "args": ["-y", "gate-mcp"],
      "type": "stdio",
      "env": {
        "GATE_API_KEY": "your-api-key",
        "GATE_API_SECRET": "your-api-secret"
      }
    }
  }
}

You can add GATE_MODULES, GATE_READONLY, or GATE_BASE_URL inside env as needed. Click Test connection before saving.

Other Clients

Client	Guide
Claude.ai	setup
Codex App	setup
Codex CLI	setup
OpenClaw	setup
Trae	See Trae config above
Qoder	See Qoder config above

Basic Usage

Query Price

What's the current price of BTC/USDT?

Get Order Book

Show me the order book for ETH/USDT

K-line Data

Get the daily K-line data for BTC over the last 7 days

Available Tools

All tools use the cex_ prefix. Tools are split between Public MCP (no auth) and Private MCP (OAuth2).

Public MCP (`/mcp` — no auth, 58 tools)

Business	Tools	Description
Spot	8	`cex_spot_list_currencies`, `cex_spot_get_currency`, `cex_spot_list_currency_pairs`, `cex_spot_get_currency_pair`, `cex_spot_get_spot_tickers`, `cex_spot_get_spot_order_book`, `cex_spot_get_spot_trades`, `cex_spot_get_spot_candlesticks`
Futures	14	Contracts, order book, trades, candlesticks, tickers, funding rate, premium index, liquidation, contract stats, insurance ledger, index constituents, batch funding rates, risk limit tiers
Margin	3	`cex_margin_list_uni_currency_pairs`, `cex_margin_get_uni_currency_pair`, `cex_margin_get_market_margin_tier`
Options	12	Underlyings, expirations, contracts, settlements, order book, tickers, candlesticks, trades
Delivery	8	Contracts, order book, trades, candlesticks, tickers, insurance ledger, risk limit tiers
Earn	5	`cex_earn_list_dual_investment_plans`, `cex_earn_list_structured_products`, `cex_earn_list_uni_currencies`, `cex_earn_list_earn_fixed_term_products`, `cex_earn_list_earn_fixed_term_products_by_asset`
Alpha	3	`cex_alpha_list_alpha_currencies`, `cex_alpha_list_alpha_tickers`, `cex_alpha_list_alpha_tokens`
Activity	1	`cex_activity_list_activity_types`
Launch	1	`cex_launch_list_launch_pool_projects`
Square	2	`cex_square_list_square_ai_search`, `cex_square_list_live_replay`
Flash Swap	1	`cex_fc_list_fc_currency_pairs`

Private MCP (`/mcp/exchange` — OAuth2, 400+ tools)

Note: The private endpoint does not include public market data tools. Use /mcp for market data queries.

Business	Scope	Key Tools
Spot	profile / trade	Accounts, orders, trades, batch orders, price-triggered orders, countdown cancel, cross liquidate
Futures	profile / trade	Accounts, positions, orders, trades, dual positions, trail orders, price-triggered, BBO orders
Margin	profile / trade	Margin accounts, loans, auto-repay, uni loans
Options	profile / trade	Account, positions, orders, MMP settings
Delivery	profile / trade	Accounts, positions, orders, price-triggered orders
Wallet	wallet	Total balance, transfers, deposits, withdrawals, deposit address, SA balances, small balance convert
Unified	account	Unified accounts, mode, loans, risk units, borrowable, collateral, leverage config
Sub-account	account	Create/list/lock/unlock SA, API keys
Account	account	Account detail, main keys, rate limit, debit fee, STP groups
Rebate	profile	Agency/partner/broker commission history, user info
Flash Swap	profile / trade	`cex_fc_list_fc_currency_pairs`, `cex_fc_list_fc_orders`, `cex_fc_create_fc_order_v1`, multi-currency flash swap
Earn	profile / trade	Dual/structured/uni products, orders, ETH2 swap, lend records
Alpha	profile / trade	Alpha accounts, orders, quote/place
TradFi	profile / trade	Categories, symbols, MT5 account, assets, orders, positions
CrossEx	profile / trade	Rule symbols, account, positions, orders, transfers, convert
P2P	profile / trade	User info, ads, chats, transactions, confirm payment/receipt
Activity	profile	Activity types, recommended activities, user participation
Coupon	profile	User coupons, coupon details
Launch Pool	profile / trade	LaunchPool projects, pledge/redeem, reward records
Square	market	AI search, live replay
Welfare	profile	Beginner eligibility, task list and rewards

For full tool parameters, see Gate API Docs or gate-exchange-mcp.

DEX — Authentication

Tool	Description
`dex_auth_google_login_start`	Start Google OAuth login flow, returns verification URL
`dex_auth_google_login_poll`	Poll login status, returns mcp_token on success
`dex_auth_login_google_wallet`	Login with Google OAuth authorization code
`dex_auth_gate_login_start`	Start Gate OAuth login flow, returns verification URL
`dex_auth_gate_login_poll`	Poll Gate OAuth login status, returns mcp_token on success
`dex_auth_login_gate_wallet`	Login directly with Gate OAuth authorization code
`dex_auth_logout`	Revoke current session

DEX — Wallet

Tool	Description
`dex_wallet_get_addresses`	Get wallet addresses for each chain (EVM, Solana)
`dex_wallet_get_token_list`	Token balances with prices and pagination
`dex_wallet_get_total_asset`	Total portfolio value and 24h change
`dex_wallet_sign_message`	Sign a message with wallet private key (EVM / Solana)
`dex_wallet_sign_transaction`	Sign a raw transaction with wallet private key

DEX — Chain & Transactions

Tool	Description
`dex_chain_config`	Chain configuration (chain ID, capabilities)
`dex_tx_gas`	Estimate gas price and gas limit
`dex_tx_transfer_preview`	Preview transfer details before signing
`dex_tx_approve_preview`	Token approval preview: build ERC20/SPL approve transaction
`dex_tx_get_sol_unsigned`	Build unsigned Solana SOL transfer with latest blockhash
`dex_tx_send_raw_transaction`	Broadcast signed transaction on-chain
`dex_tx_quote`	Swap quote with route, price impact and gas estimation
`dex_tx_swap`	One-click swap: quote → build → sign → submit
`dex_tx_swap_detail`	Query swap order status by order ID
`dex_tx_list` / `dex_tx_detail` / `dex_tx_history_list`	Transaction & swap / bridge history

DEX — Market Data & Token Info

Tool	Description
`dex_market_get_kline`	K-line (candlestick) data: 1m, 5m, 1h, 4h, 1d
`dex_market_get_tx_stats`	Trading volume and trader statistics (5m / 1h / 4h / 24h)
`dex_market_get_pair_liquidity`	Liquidity pool add / remove events
`dex_token_list_swap_tokens`	Available tokens for swap on a given chain
`dex_token_list_cross_chain_bridge_tokens`	Bridgeable tokens for cross-chain transfers
`dex_token_get_coin_info`	Token info: price, market cap, supply, holder distribution
`dex_token_ranking`	24h top gainers / top losers
`dex_token_get_coins_range_by_created_at`	Discover new tokens by creation time range
`dex_token_get_risk_info`	Security audit: honeypot, buy/sell tax, blacklist, permissions

DEX — Agentic & RPC

Tool	Description
`dex_agentic_report`	Report agentic wallet addresses to wallet service
`dex_rpc_call`	Execute JSON-RPC call to blockchain node

For full DEX tool parameters, see gate-dex-mcp. For the Agentic Wallet subset (auth, wallet, market data, resources), see gate-agentic-wallet-mcp.

Info (`/mcp/info` — 32 tools, no auth)

Public, read-only market research. Categories (full parameter tables: gate-info-mcp):

Category	Tools
Coin	`info_coin_get_coin_info`, `info_coin_search_coins`, `info_coin_get_coin_rankings`
Market snapshot	`info_marketsnapshot_get_market_snapshot`, `info_marketsnapshot_batch_market_snapshot`, `info_marketsnapshot_get_market_overview`, `info_marketsnapshot_get_institutional_metrics`
Market trend	`info_markettrend_get_kline`, `info_markettrend_get_indicator_history`, `info_markettrend_get_technical_analysis`
On-chain	`info_onchain_get_address_info`, `info_onchain_get_address_transactions`, `info_onchain_get_transaction`, `info_onchain_get_token_onchain`
Compliance	`info_compliance_check_token_security`
Platform metrics	`info_platformmetrics_get_platform_info`, `info_platformmetrics_search_platforms`, `info_platformmetrics_get_defi_overview`, `info_platformmetrics_get_stablecoin_info`, `info_platformmetrics_get_bridge_metrics`, `info_platformmetrics_get_yield_pools`, `info_platformmetrics_get_platform_history`, `info_platformmetrics_get_exchange_reserves`, `info_platformmetrics_get_liquidation_heatmap`, `info_platformmetrics_get_cex_orderbook_depth`, `info_platformmetrics_get_chain_activity`
Macro	`info_macro_get_macro_indicator`, `info_macro_get_economic_calendar`, `info_macro_get_macro_summary`
Market detail	`info_marketdetail_get_orderbook`, `info_marketdetail_get_recent_trades`, `info_marketdetail_get_kline`

Open Info (`/mcp/open/info` — 7 tools, no auth)

ChatGPT / OpenAI Apps submission allowlist only. Full parameter tables: gate-open-info-mcp.

Category	Tools
Coin	`info_coin_get_coin_info`
Market snapshot	`info_marketsnapshot_get_market_overview`, `info_marketsnapshot_get_market_snapshot`, `info_marketsnapshot_batch_market_snapshot`
Market detail	`info_marketdetail_get_kline`, `info_marketdetail_get_orderbook`, `info_marketdetail_get_recent_trades`

News (`/mcp/news` — 18 tools, no auth)

Public, read-only news and social research. Categories (full parameter tables: gate-news-mcp):

Category	Tools
News feed	`news_feed_search_news`, `news_feed_web_search`, `news_feed_search_x`, `news_feed_search_ugc`, `news_feed_get_exchange_announcements`, `news_feed_get_social_sentiment`, `news_feed_get_mention_burst`, `news_feed_get_hot_topics`
Events	`news_events_get_latest_events`, `news_events_get_event_detail`, `news_events_explain_market_move`, `news_events_get_market_move_report`, `news_events_list_market_move_reports`
Prediction	`news_prediction_get_volume_delta_ranking`, `news_prediction_get_fastest_rising_ranking`, `news_prediction_get_market_orderbook`, `news_prediction_search_events`, `news_prediction_get_event_signal`

MCP Resources

The /mcp and /mcp/exchange endpoints also expose MCP Resources for static reference data:

Resource URI	Description
`gate://spot/currency_pairs`	All spot trading pairs
`gate://spot/currencies`	All supported currencies
`gate://futures/contracts/usdt`	USDT-settled futures contracts
`gate://futures/contracts/btc`	BTC-settled futures contracts
`gate://futures/contracts/{settle}`	Futures contracts by settlement currency

FAQ

Q: Do I need a Gate account?

A: Only for CEX trading and DEX wallet. /mcp, /mcp/info, /mcp/open/info, /mcp/news, and /mcp/docs are fully public — no account needed. /mcp/exchange (CEX trading, balances, transfers) requires Gate OAuth2. /mcp/dex (on-chain wallet, swap) requires Google or Gate OAuth.

Q: Does it support trading?

A: Yes. Connect to https://api.gatemcp.ai/mcp/exchange with OAuth2. The server supports spot and futures trading, account management, wallet transfers, and sub-accounts. Each tool requires the appropriate scope (e.g. trade, wallet).

Q: How often is the data updated?

A: Data is queried in real-time from Gate's API.

Privacy & Security

OAuth2 authorization via Gate account (no API keys stored in config)
All API calls use HTTPS
See Gate Privacy Policy

Support & Feedback

API Documentation: Gate API Docs
Issue Reporting: Please contact Gate support
Business Inquiries: Contact Gate official channels

Contributing

See CONTRIBUTING.md.

License

MIT © gate.com

Install

Tools (63)

cex_activity_list_activity_typescex_alpha_list_alpha_currenciescex_alpha_list_alpha_tickerscex_alpha_list_alpha_tokenscex_dc_get_dc_contractcex_dc_list_dc_candlestickscex_dc_list_dc_contractscex_dc_list_dc_insurance_ledger

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.gatemcp.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "gate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.gatemcp.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Gate MCP Server (io.github.gateio-dev/gate-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

cex_activity_list_activity_types

cex_alpha_list_alpha_currencies

cex_alpha_list_alpha_tickers

cex_alpha_list_alpha_tokens

cex_dc_get_dc_contract

cex_dc_list_dc_candlesticks

cex_dc_list_dc_contracts

cex_dc_list_dc_insurance_ledger

cex_dc_list_dc_order_book

cex_dc_list_dc_risk_limit_tiers

cex_dc_list_dc_tickers

cex_dc_list_dc_trades

cex_earn_list_dual_investment_plans

cex_earn_list_earn_fixed_term_products

cex_earn_list_earn_fixed_term_products_by_asset

cex_earn_list_uni_currencies

cex_fx_get_fx_candlesticks

cex_fx_get_fx_contract

cex_fx_get_fx_funding_rate

cex_fx_get_fx_order_book

cex_fx_get_fx_premium_index

cex_fx_get_fx_risk_limit_table

cex_fx_get_fx_tickers

cex_fx_get_fx_trades

cex_fx_get_index_constituents

cex_fx_list_batch_fx_funding_rates

cex_fx_list_contract_stats

cex_fx_list_fx_contracts

cex_fx_list_fx_insurance_ledger

cex_fx_list_fx_liq_orders

cex_launch_get_candy_drop_activity_list_v4

cex_launch_get_candy_drop_activity_rules_v4

cex_launch_get_hodler_airdrop_project_list

cex_launch_list_launch_pool_projects

cex_margin_get_market_margin_tier

cex_margin_get_uni_currency_pair

cex_margin_list_uni_currency_pairs

cex_mcl_get_multi_collateral_current_rate

cex_mcl_get_multi_collateral_fix_rate

cex_mcl_get_multi_collateral_ltv

cex_mcl_list_multi_collateral_currencies

cex_options_get_options_contract

cex_options_get_options_settlement

cex_options_list_options_candlesticks

cex_options_list_options_contracts

cex_options_list_options_expirations

cex_options_list_options_order_book

cex_options_list_options_settlements

cex_options_list_options_tickers

cex_options_list_options_trades

cex_options_list_options_underlying_candlesticks

cex_options_list_options_underlying_tickers

cex_options_list_options_underlyings

cex_spot_get_currency

cex_spot_get_currency_pair

cex_spot_get_spot_candlesticks

cex_spot_get_spot_order_book

cex_spot_get_spot_tickers

cex_spot_get_spot_trades

cex_spot_list_currencies

cex_spot_list_currency_pairs

cex_square_list_live_replay

cex_square_list_square_ai_search

Gate MCP Server

Features

MCP Endpoints

Authorization (OAuth2)

Using mcporter

Scopes (for /mcp/exchange)

Quick Start

Prerequisites

Cursor

Method 1: One-click Install (Recommended)

Method 2: Manual Configuration

mcporter / OpenClaw

Scopes (for `/mcp/exchange`)

Public MCP (`/mcp` — no auth, 58 tools)

Private MCP (`/mcp/exchange` — OAuth2, 400+ tools)

Info (`/mcp/info` — 32 tools, no auth)

Open Info (`/mcp/open/info` — 7 tools, no auth)

News (`/mcp/news` — 18 tools, no auth)