ccxt / Installation

ccxt 安装与部署:pip / npm 两种官方方式

ccxt 官方提供两种安装方式:Python 用 pip install ccxt,JavaScript/Node.js 用 npm install ccxt。选择前先确认你的运行环境是 Python 还是 Node.js。

Python:pip install ccxtJavaScript:npm install ccxt来源:官方 README
pip install ccxtPython 环境
npm install ccxtJavaScript / Node.js
ccxt 安装入口示意(pip / npm),基于官方 README。
Python

方式一:pip 安装(Python)

面向 Python 用户的官方安装命令。

pip install ccxt
前置:需要可用的 Python 环境与 pip。ccxt 官方 README 未硬性限定单一 Python 版本,以你环境的 pip 能否成功解析依赖为准。本站不编造具体版本号要求。
JavaScript

方式二:npm 安装(JavaScript / Node.js)

面向 JavaScript / TypeScript 用户的官方安装命令。

npm install ccxt
说明:以上命令来自 ccxt 官方 README(2026-08 核验)。
Next

安装后如何验证与首次运行

安装完成后,跑一个最小示例验证可用,再决定是否配置 API key 走私有接口。

  1. 验证安装

    在 Python 中 import ccxt 或 Node 中 require('ccxt'),无报错即安装成功。

  2. 初始化交易所

    exchange = ccxt.binance(),创建交易所实例。

  3. 拉取公开行情

    调用 exchange.fetchTicker('BTC/USDT') 验证网络与接口连通。

  4. (可选)配置 API key

    需要私有接口时再申请并配置 API key,见交易页。

Environment & errors

环境要求与常见报错排查

安装或导入时报错,多数是环境、网络或版本问题。下表给出定位思路。

现象常见原因处理
pip/npm 下载慢或超时网络/镜像源换国内镜像源或重试
import ccxt 报 ModuleNotFoundError装到了别的环境/虚拟环境未激活核对 pip 与 python 是否同一环境
fetch 请求超时/连接失败网络不可达交易所或需代理配置 proxies 或检查网络
版本行为不一致ccxt 版本过旧升级到最新版后重试
说明:ccxt 主包为纯代码、依赖简单;报错多集中在网络与版本。具体报错以官方 issue 与文档为准。
Troubleshooting

常见安装问题

pip 安装失败怎么办?

通常是网络或 pip 版本问题,可尝试升级 pip 或换用国内镜像源;ccxt 本身是纯 Python 包,依赖较简单。

不想自己装环境,怎么研究加密货币与量化?

可以。EasyClaw 内置量化研究类 Skill(量化分析、财经数据、技术分析等),可免自行维护 Python/Node 环境;两者解决不同任务,不代表 ccxt 已集成 EasyClaw。

装好就能直接交易吗?

公开行情接口装好即可用;下单等私有接口需要交易所账号、API key 与权限配置,且需自行承担交易风险。

不想维护环境?

ccxt 需要自行管理 Python/Node 环境、交易所接口与 API key。如果你更想直接提出一个行情/选股/量化分析任务,可看 EasyClaw 量化 Skill 路线对比。