README

一个用于加密货币交易和电子商务的JavaScript / Python / PHP库，支持许多比特币/以太币/代币交易所市场和商家API。

安装 · 使用 · 手册 · 常见问题解答 · 示例 · 贡献 · 社交

CCXT 库用于连接和交易全球的加密货币/代币交易所和支付处理服务。它提供快速访问市场数据以进行存储、分析、可视化、指标开发、算法交易、策略回测、机器人编程、网店集成和相关软件工程。

它旨在由 程序员、开发者、技术熟练的交易者、数据科学家和金融分析师 使用，以在其之上构建交易算法。

当前功能列表

• 支持许多交易所市场，即将推出更多
• 所有交易所的公共和私有API都已完全实现
• 所有货币、代币和符号、价格、订单簿、交易、行情等...
• 可选的标准化数据，用于跨交易所或跨货币分析和对冲
• 一个开箱即用的统一所有功能API，非常易于集成
• 在Node 7.6+、Python 2和3、PHP 5.4+、网络浏览器中运行

赞助推广

想要这个位置？联系我们：info@ccxt.trade

认证加密货币交易所

支持的加密货币交易所市场

ccxt库目前支持以下132个加密货币交易所市场和解构API

上述列表经常更新，新的加密货币市场、代币交易所、错误修复、API端点定期引入和添加。有关详细信息，请参阅手册。如果您在上述列表中没有找到加密货币交易所市场，或希望添加其他交易所，请在此GitHub上打开一个问题或通过电子邮件发送链接。

此库在MIT许可证下，这意味着任何开发人员都可以免费在它之上构建商业和开源软件，但使用它时自行承担风险，无任何保证。

安装

安装ccxt库最简单的方法是使用内置包管理器

• ccxt在NPM (JavaScript / Node v7.6+)
• ccxt在PyPI (Python 2和3.5.3+)
• ccxt在Packagist/Composer (PHP 5.4+)

此库以一个所有功能模块实现的形式提供，具有最小化依赖和要求

• js/在JavaScript中
• python/ 在 Python 中（由 JS 生成）
• php/ 在 PHP 中（由 JS 生成）

您也可以从 ccxt GitHub 仓库 将其克隆到您的项目目录中

git clone https://github.com/ccxt/ccxt.git

将此库安装到您的代码中的另一种方法是手动将一个文件复制到您的当前工作目录，并使用适合您环境的语言扩展名。

JavaScript (NPM)

CCXT 的 JavaScript 版本既可以在 Node 中运行，也可以在网页浏览器中运行。需要 ES6 和 async/await 语法支持（Node 7.6.0+）。当使用 Webpack 和 Babel 编译时，请确保在您的 babel-loader 配置中 不排除 它。

NPM 中的 ccxt

npm install ccxt

var ccxt = require ('ccxt')

console.log (ccxt.exchanges) // print all available exchanges

JavaScript（用于与 <script> 标签一起使用）

一站式浏览器包（包含依赖项），由 unpkg CDN 提供，这是一个为 NPM 上的所有内容提供快速、全球内容交付网络。

<script type="text/javascript" src="https://unpkg.com/ccxt"></script>

创建全局 ccxt 对象

console.log (ccxt.exchanges) // print all available exchanges

Python

PyPI 中的 ccxt

pip install ccxt

import ccxt
print(ccxt.exchanges) # print a list of all available exchange classes

该库支持 Python 3.5.3+ 中的 asyncio 和 async/await 的并发异步模式

import ccxt.async_support as ccxt # link against the asynchronous version of ccxt

PHP

使用 Packagist/Composer 的 PHP 中的 ccxt（PHP 5.4+）

它需要常见的 PHP 模块

• cURL
• mbstring（强烈推荐使用 UTF-8）
• PCRE
• iconv
• gmp（这是 PHP 7.2+ 中的内置扩展）

include "ccxt.php";
var_dump (\ccxt\Exchange::$exchanges); // print a list of all available exchange classes

文档

阅读 手册 了解更多详情。

使用方法

简介

ccxt 库由公共部分和私有部分组成。任何人都可以在安装后立即使用公共部分。公共 API 可打开访问所有交易所的公共信息，而无需注册用户帐户和 API 密钥。

公共 API 包括以下内容

• 市场数据
• 工具/交易对
• 价格馈送（汇率）
• 订单簿
• 交易历史
• 交易牌价
• 用于图表的 OHLC(V)
• 其他公共端点

对于使用私有 API 进行交易，您需要从交易所获取 API 密钥。这通常意味着在交易所注册并使用您的帐户创建 API 密钥。大多数交易所要求提供个人信息或身份证明。可能还需要进行某种验证。如果您想交易，您需要自己注册，这个库不会为您创建帐户或 API 密钥。某些交易所的 API 在代码内部公开了注册帐户的接口方法，但大多数交易所没有。您必须注册并使用他们的网站创建 API 密钥。

私有 API 允许以下操作

• 管理个人帐户信息
• 查询帐户余额
• 通过市价和限价订单进行交易
• 存入和提取法定货币和加密货币资金
• 查询个人订单
• 获取账本历史
• 在帐户之间转移资金
• 使用商户服务

此库实现了所有交易所的完整公共和私有 REST API。JavaScript、PHP、Python 和其他语言的 WebSocket 和 FIX 实现即将推出。

ccxt 库支持 camelcase 表示法（JavaScript 中首选）和下划线表示法（Python 和 PHP 中首选），因此所有方法都可以在任何语言中以任意的表示法或编码风格调用。

// both of these notations work in JavaScript/Python/PHP
exchange.methodName ()  // camelcase pseudocode
exchange.method_name () // underscore pseudocode

阅读 手册 了解更多详情。

JavaScript

'use strict';
const ccxt = require ('ccxt');

(async function () {
    let kraken    = new ccxt.kraken ()
    let bitfinex  = new ccxt.bitfinex ({ verbose: true })
    let huobi     = new ccxt.huobi ()
    let okcoinusd = new ccxt.okcoinusd ({
        apiKey: 'YOUR_PUBLIC_API_KEY',
        secret: 'YOUR_SECRET_PRIVATE_KEY',
    })

    const exchangeId = 'binance'
        , exchangeClass = ccxt[exchangeId]
        , exchange = new exchangeClass ({
            'apiKey': 'YOUR_API_KEY',
            'secret': 'YOUR_SECRET',
            'timeout': 30000,
            'enableRateLimit': true,
        })

    console.log (kraken.id,    await kraken.loadMarkets ())
    console.log (bitfinex.id,  await bitfinex.loadMarkets  ())
    console.log (huobi.id,     await huobi.loadMarkets ())

    console.log (kraken.id,    await kraken.fetchOrderBook (kraken.symbols[0]))
    console.log (bitfinex.id,  await bitfinex.fetchTicker ('BTC/USD'))
    console.log (huobi.id,     await huobi.fetchTrades ('ETH/CNY'))

    console.log (okcoinusd.id, await okcoinusd.fetchBalance ())

    // sell 1 BTC/USD for market price, sell a bitcoin for dollars immediately
    console.log (okcoinusd.id, await okcoinusd.createMarketSellOrder ('BTC/USD', 1))

    // buy 1 BTC/USD for $2500, you pay $2500 and receive ฿1 when the order is closed
    console.log (okcoinusd.id, await okcoinusd.createLimitBuyOrder ('BTC/USD', 1, 2500.00))

    // pass/redefine custom exchange-specific order params: type, amount, price or whatever
    // use a custom order type
    bitfinex.createLimitSellOrder ('BTC/USD', 1, 10, { 'type': 'trailing-stop' })

}) ();

Python

# coding=utf-8

import ccxt

hitbtc = ccxt.hitbtc({'verbose': True})
bitmex = ccxt.bitmex()
huobi  = ccxt.huobi()
exmo   = ccxt.exmo({
    'apiKey': 'YOUR_PUBLIC_API_KEY',
    'secret': 'YOUR_SECRET_PRIVATE_KEY',
})
kraken = ccxt.kraken({
    'apiKey': 'YOUR_PUBLIC_API_KEY',
    'secret': 'YOUR_SECRET_PRIVATE_KEY',
})

exchange_id = 'binance'
exchange_class = getattr(ccxt, exchange_id)
exchange = exchange_class({
    'apiKey': 'YOUR_API_KEY',
    'secret': 'YOUR_SECRET',
    'timeout': 30000,
    'enableRateLimit': True,
})

hitbtc_markets = hitbtc.load_markets()

print(hitbtc.id, hitbtc_markets)
print(bitmex.id, bitmex.load_markets())
print(huobi.id, huobi.load_markets())

print(hitbtc.fetch_order_book(hitbtc.symbols[0]))
print(bitmex.fetch_ticker('BTC/USD'))
print(huobi.fetch_trades('LTC/CNY'))

print(exmo.fetch_balance())

# sell one ฿ for market price and receive $ right now
print(exmo.id, exmo.create_market_sell_order('BTC/USD', 1))

# limit buy BTC/EUR, you pay €2500 and receive ฿1  when the order is closed
print(exmo.id, exmo.create_limit_buy_order('BTC/EUR', 1, 2500.00))

# pass/redefine custom exchange-specific order params: type, amount, price, flags, etc...
kraken.create_market_buy_order('BTC/USD', 1, {'trading_agreement': 'agree'})

PHP

include 'ccxt.php';

$poloniex = new \ccxt\poloniex ();
$bittrex  = new \ccxt\bittrex  (array ('verbose' => true));
$quoinex  = new \ccxt\quoinex   ();
$zaif     = new \ccxt\zaif     (array (
    'apiKey' => 'YOUR_PUBLIC_API_KEY',
    'secret' => 'YOUR_SECRET_PRIVATE_KEY',
));
$hitbtc   = new \ccxt\hitbtc   (array (
    'apiKey' => 'YOUR_PUBLIC_API_KEY',
    'secret' => 'YOUR_SECRET_PRIVATE_KEY',
));

$exchange_id = 'binance';
$exchange_class = "\\ccxt\\$exchange_id";
$exchange = new $exchange_class (array (
    'apiKey' => 'YOUR_API_KEY',
    'secret' => 'YOUR_SECRET',
    'timeout' => 30000,
    'enableRateLimit' => true,
));

$poloniex_markets = $poloniex->load_markets ();

var_dump ($poloniex_markets);
var_dump ($bittrex->load_markets ());
var_dump ($quoinex->load_markets ());

var_dump ($poloniex->fetch_order_book ($poloniex->symbols[0]));
var_dump ($bittrex->fetch_trades ('BTC/USD'));
var_dump ($quoinex->fetch_ticker ('ETH/EUR'));
var_dump ($zaif->fetch_ticker ('BTC/JPY'));

var_dump ($zaif->fetch_balance ());

// sell 1 BTC/JPY for market price, you pay ¥ and receive ฿ immediately
var_dump ($zaif->id, $zaif->create_market_sell_order ('BTC/JPY', 1));

// buy BTC/JPY, you receive ฿1 for ¥285000 when the order closes
var_dump ($zaif->id, $zaif->create_limit_buy_order ('BTC/JPY', 1, 285000));

// set a custom user-defined id to your order
$hitbtc->create_order ('BTC/USD', 'limit', 'buy', 1, 3000, array ('clientOrderId' => '123'));

贡献

在修改您希望被采纳的代码之前，请阅读贡献指南文档。同时，阅读手册获取更多详细信息。

支持开发者团队

我们在该库的开发上投入了大量的时间。如果CCXT使您的生活变得更轻松，您喜欢它，并希望帮助我们进一步改进它，或者如果您想加快新功能和交易所的添加，请通过小费支持我们。我们感激所有贡献！

赞助商

通过成为赞助商来支持此项目。您的标志将在这里显示，并带有链接到您的网站。

[成为赞助商]

支持者

感谢所有支持者！ [成为支持者]

加密货币

ETH 0x26a3CB49578F07000575405a57888681249c35Fd (ETH only!)
BTC 33RmVRfhK2WZVQR1R83h2e9yXoqRNDvJva
BCH 1GN9p233TvNcNQFthCgfiHUnj5JRKEc2Ze
LTC LbT8mkAqQBphc4yxLXEDgYDfEax74et3bP

谢谢！

社交

• 在Twitter上关注我们
• 在Medium上阅读我们的博客

团队

• Igor Kroitor
• Vitaly Gordon
• Denis Voropaev
• Carlo Revelli

联系我们

商务咨询：info@ccxt.trade