개요

ccxt 라이브러리는 이용 가능한 암호화폐 거래소 또는 거래소 클래스의 모음입니다. 각 클래스는 특정 암호화폐 거래소의 공개 및 비공개 API를 구현합니다. 모든 거래소는 기본 Exchange 클래스에서 파생되며 공통 메서드 집합을 공유합니다. ccxt 라이브러리에서 특정 거래소에 접근하려면 해당 거래소 클래스의 인스턴스를 생성해야 합니다. 지원되는 거래소는 자주 업데이트되며 새로운 거래소가 정기적으로 추가됩니다.

라이브러리의 구조는 다음과 같이 설명할 수 있습니다:

                                 User
    +-------------------------------------------------------------+
    |                            CCXT                             |
    +------------------------------+------------------------------+
    |            Public            |           Private            |
    +=============================================================+
    │                              .                              |
    │                    The Unified CCXT API                     |
    │                              .                              |
    |       loadMarkets            .           fetchBalance       |
    |       fetchMarkets           .            createOrder       |
    |       fetchCurrencies        .            cancelOrder       |
    |       fetchTicker            .             fetchOrder       |
    |       fetchTickers           .            fetchOrders       |
    |       fetchOrderBook         .        fetchOpenOrders       |
    |       fetchOHLCV             .      fetchClosedOrders       |
    |       fetchStatus            .          fetchMyTrades       |
    |       fetchTrades            .                deposit       |
    |                              .               withdraw       |
    │                              .                              |
    +=============================================================+
    │                              .                              |
    |                     Custom Exchange API                     |
    |         (Derived Classes And Their Implicit Methods)        |
    │                              .                              |
    |       publicGet...           .          privateGet...       |
    |       publicPost...          .         privatePost...       |
    |                              .          privatePut...       |
    |                              .       privateDelete...       |
    |                              .                   sign       |
    │                              .                              |
    +=============================================================+
    │                              .                              |
    |                      Base Exchange Class                    |
    │                              .                              |
    +=============================================================+

모든 거래소의 완전한 공개 및 비공개 HTTP REST API는 JavaScript, Python, PHP, C#, Go, Java로 구현되어 있습니다. WebSocket 구현은 CCXT Pro에서 이용 가능하며, WebSocket 스트림을 지원합니다.

• 거래소
• 마켓
• 암묵적 API
• 통합 API
• 공개 API
• 비공개 API
• 오류 처리
• 문제 해결
• CCXT Pro

소셜

• 트위터에서 팔로우하세요

• Medium에서 블로그를 읽어보세요

• Discord에 참여하세요

• Telegram에서 CCXT Chat (기술 지원)

• 공지 채널:

• • 
• • 

거래소

• 인스턴스화
• 거래소 구조
• 속도 제한

logo	id	name	ver	type	certified	pro
	aftermath	AftermathFinance
	alpaca	Alpaca
	apex	Apex
	arkham	ARKHAM
	ascendex	AscendEX
	aster	Aster
	backpack	Backpack
	bequant	Bequant
	bigone	BigONE
	binance	Binance
	binancecoinm	Binance COIN-M
	binanceus	Binance US
	binanceusdm	Binance USDⓈ-M
	bingx	BingX
	bit2c	Bit2C
	bitbank	bitbank
	bitbns	Bitbns
	bitfinex	Bitfinex
	bitflyer	bitFlyer
	bitget	Bitget
	bithumb	Bithumb
	bitmart	BitMart
	bitmex	BitMEX
	bitopro	BitoPro
	bitrue	Bitrue
	bitso	Bitso
	bitstamp	Bitstamp
	bitteam	BIT.TEAM
	bittrade	BitTrade
	bitvavo	Bitvavo
	blockchaincom	Blockchain.com
	blofin	BloFin
	btcbox	BtcBox
	btcmarkets	BTC Markets
	btcturk	BTCTurk
	bullish	Bullish
	bybit	Bybit
	bybiteu	Bybit EU
	bydfi	BYDFi
	cex	CEX.IO
	coinbase	Coinbase Advanced
	coinbaseexchange	Coinbase Exchange
	coinbaseinternational	Coinbase International
	coincheck	coincheck
	coinex	CoinEx
	coinmate	CoinMate
	coinmetro	Coinmetro
	coinone	CoinOne
	coinsph	Coins.ph
	coinspot	CoinSpot
	cryptocom	Crypto.com
	cryptomus	Cryptomus
	deepcoin	DeepCoin
	delta	Delta Exchange
	deribit	Deribit
	derive	derive
	digifinex	DigiFinex
	dydx	dYdX
	exmo	EXMO
	fmfwio	FMFW.io
	foxbit	Foxbit
	gate	Gate
	gemini	Gemini
	grvt	GRVT
	hashkey	HashKey Global
	hibachi	Hibachi
	hitbtc	HitBTC
	hollaex	HollaEx
	htx	HTX
	hyperliquid	Hyperliquid
	independentreserve	Independent Reserve
	indodax	INDODAX
	kraken	Kraken
	krakenfutures	Kraken Futures
	kucoin	KuCoin
	kucoinfutures	KuCoin Futures
	latoken	Latoken
	lbank	LBank
	lighter	Lighter
	luno	luno
	mercado	Mercado Bitcoin
	mexc	MEXC Global
	modetrade	Mode Trade
	myokx	MyOKX (EEA)
	ndax	NDAX
	novadax	NovaDAX
	okx	OKX
	okxus	OKX (US)
	onetrading	One Trading
	oxfun	OXFUN
	p2b	p2b
	pacifica	Pacifica
	paradex	Paradex
	paymium	Paymium
	phemex	Phemex
	poloniex	Poloniex
	tokocrypto	Tokocrypto
	toobit	Toobit
	upbit	Upbit
	wavesexchange	Waves.Exchange
	weex	Weex
	whitebit	WhiteBit
	woo	WOO X
	woofipro	WOOFI PRO
	xt	XT
	yobit	YoBit
	zaif	Zaif
	zebpay	Zebpay

기본적인 시장가 및 지정가 주문 외에도, 일부 거래소는 마진 거래(레버리지), 다양한 파생상품(선물 계약, 옵션 등)을 제공하며, 다크 풀, OTC(장외 거래), 가맹점 API 등 훨씬 더 많은 기능을 제공합니다.

인스턴스화

거래소에 연결하고 거래를 시작하려면 ccxt 라이브러리에서 거래소 클래스를 인스턴스화해야 합니다.

지원되는 거래소의 전체 id 목록을 프로그래밍 방식으로 가져오려면:

const ccxt = require ('ccxt')
console.log (ccxt.exchanges)

거래소는 아래 예시와 같이 인스턴스화할 수 있습니다:

const ccxt = require ('ccxt')
let exchange = new ccxt.kraken () // default id
let kraken1 = new ccxt.kraken ({ id: 'kraken1' })
let kraken2 = new ccxt.kraken ({ id: 'kraken2' })
let id = 'coinbasepro'
let coinbasepro = new ccxt[id] ();

// from variable id
const exchangeId = 'binance'
    , exchangeClass = ccxt[exchangeId]
    , exchange = new exchangeClass ({
        'apiKey': 'YOUR_API_KEY',
        'secret': 'YOUR_SECRET',
    })

PHP

PHP에서 ccxt 라이브러리는 내장된 UTC/GMT 시간 함수를 사용하므로, php.ini에서 date.timezone을 설정하거나 라이브러리의 PHP 버전을 사용하기 전에 date_default_timezone_set() 함수를 호출해야 합니다. 권장 시간대 설정은 "UTC"입니다.

// PHP
date_default_timezone_set('UTC');
include 'ccxt.php';
$bitfinex = new \ccxt\bitfinex(); // default id
$bitfinex1 = new \ccxt\bitfinex(array('id' => 'bitfinex1'));
$bitfinex2 = new \ccxt\bitfinex(array('id' => 'bitfinex2'));
$id = 'kraken';
$exchange = '\\ccxt\\' . $id;
$kraken = new $exchange();

// from variable id
$exchange_id = 'binance';
$exchange_class = "\\ccxt\\$exchange_id";
$exchange = new $exchange_class(array(
    'apiKey' => 'YOUR_API_KEY',
    'secret' => 'YOUR_SECRET',
));

import (
    "github.com/ccxt/ccxt/go/v4"
)

bitfinex := ccxt.NewBitfinex(nil) // default id

// from variable id
exchange := ccxt.CreateExchange("binance", map[string]interface{}{
    "apiKey": "YOUR_API_KEY",
    "secret": "YOUR_SECRET",
})

기능(Features)

주요 거래소는 .features 속성을 제공하며, 여기서 각 마켓 유형에 대해 어떤 메서드와 기능이 지원되는지 확인할 수 있습니다(메서드가 null/undefined로 설정된 경우, 해당 메서드는 거래소에서 "지원되지 않음"을 의미합니다).

이 기능은 현재 개발 중이며 불완전할 수 있습니다. 발견된 문제는 자유롭게 보고해 주세요.

const exchange = new ccxt.binance()
console.log(exchange.features);

// outputs like:
{
  spot: {
    sandbox: true, // whether testnet is supported
    createOrder: {
      triggerPrice: true,          // if trigger order is supported
      triggerPriceType: undefined, // if trigger price type is supported (last, mark, index)
      triggerDirection: false,     // if trigger direction is supported (ascending, descending)
      stopLossPrice: true,         // if you can use createOrder to place a standalone stop-loss order (read "Stop Loss Orders" paragraph) 
      takeProfitPrice: true,       // ... similar as above
      stopLoss: {                  // if attached stopLoss can be sent together with an primary entry order
        triggerPriceType: {
            last: true,
            mark: true,
            index: true,
        },
        price: true,               // if 'limit' price is supported to be set (otherwise only market order would be supported)
      },
      takeProfit : ...,            // ... similar as above
      marginMode: true,            // if `marginMode` param is supported (cross, isolated)
      timeInForce: {               // supported TIF types
        GTC: true,
        IOC: true,
        FOK: true,
        PO: true,
        GTD: false
      },
      hedged: false,              // if `hedged` param is supported (true, false)
      leverage: false,            // if `leverage` param is supported (true, false)
      selfTradePrevention: true,  // if `selfTradePrevention` param is supported (true, false)
      trailing: true,             // if trailing order is supported
      iceberg: true,              // if iceberg order is supported
      marketBuyByCost: true,      // if creating market buy order is possible with `cost` param
      marketBuyRequiresPrice: true,// if creating market buy order (if 'cost' not used) requires `price` param to be set
    },
    createOrders: {
        'max': 50,              // if batch order creation is supported
    },
    fetchMyTrades: {
      limit: 1000,              // max limit per call
      daysBack: undefined,      // max historical period that can be accessed
      untilDays: 1              // if `until` param is supported, then this is permitted distance from `since`
    },
    fetchOrder: {
      marginMode: true,         // when supported, margin order should be fetched with this flag
      trigger: false,           // similar as above
      trailing: false           // similar as above
    },
    // other methods have similar properties
    fetchOpenOrders: {
      limit: undefined,
      marginMode: true,
      trigger: false,
      trailing: false
    },
    fetchOrders: {
      limit: 1000,
      daysBack: undefined,
      untilDays: 10000,
      marginMode: true,
      trigger: false,
      trailing: false
    },
    fetchClosedOrders: {
      limit: 1000,
      daysBackClosed: undefined, // max days-back for closed orders
      daysBackCanceled: undefined, // max days-back for canceled orders
      untilDays: 10000,
      marginMode: true,
      trigger: false,
      trailing: false
    },
    fetchOHLCV: {
      paginate: true,
      limit: 1000
    }
  },
  swap: {
    linear: { ... }, // similar to above dict
    inverse: { ... }, // similar to above dict
  }
  future: {
    linear: { ... }, // similar to above dict
    inverse: { ... }, // similar to above dict
  }
}

인스턴스화 시 거래소 속성 재정의

대부분의 거래소 속성과 특정 옵션은 아래와 같이 거래소 클래스 인스턴스화 시 또는 이후에 재정의할 수 있습니다:

const exchange = new ccxt.binance ({
    'rateLimit': 10000, // unified exchange property
    'headers': {
        'YOUR_CUSTOM_HTTP_HEADER': 'YOUR_CUSTOM_VALUE',
    },
    'options': {
        'adjustForTimeDifference': true, // exchange-specific option
    }
})
exchange.options['adjustForTimeDifference'] = false

거래소 메서드 재정의

CCXT가 지원하는 모든 언어에서 런타임 중에 인스턴스 메서드를 재정의할 수 있습니다:

const ex = new ccxt.binance ();
ex.fetch_ticker = function (symbol, params = {}) {
    // your codes go here
};
console.log (ex.fetch_ticker('BTC/USDT'));

테스트넷 및 샌드박스 환경

일부 거래소는 개발자가 무료로 가상 화폐를 거래하고 아이디어를 테스트할 수 있는 별도의 테스트용 API를 제공합니다. 이러한 API는 "테스트넷", "샌드박스" 또는 "스테이징 환경"(가상 테스트 자산 사용)이라고 불리며, 실제 자산을 사용하는 _"메인넷" 및 "프로덕션 환경"_과 구별됩니다. 샌드박스 API는 대부분 프로덕션 API의 복제본으로, 실제로는 동일한 API이지만 거래소 서버의 URL만 다릅니다.

CCXT는 이 측면을 통합하여 사용자가 거래소의 샌드박스로 전환할 수 있도록 합니다(기반 거래소에서 지원하는 경우). 샌드박스로 전환하려면 거래소를 생성한 직후, 다른 호출을 하기 전에 exchange.setSandboxMode (true) 또는 exchange.set_sandbox_mode(true)를 호출해야 합니다!

const exchange = new ccxt.binance (config)
exchange.setSandboxMode (true) // enable sandbox mode

• exchange.setSandboxMode (true) / exchange.set_sandbox_mode (True)는 거래소를 생성한 직후(다른 호출 전에) 첫 번째 호출이어야 합니다.
• 샌드박스의 API 키를 얻으려면 해당 거래소의 샌드박스 웹사이트에 등록하고 샌드박스 키쌍을 생성해야 합니다.
• 샌드박스 키는 프로덕션 키와 교환하여 사용할 수 없습니다!

거래소 구조

모든 거래소에는 속성과 메서드 집합이 있으며, 대부분은 거래소 생성자에 연관 배열 형태의 파라미터를 전달하여 재정의할 수 있습니다. 서브클래스를 만들어 모든 것을 재정의하는 것도 가능합니다.

다음은 예시 값이 추가된 일반적인 거래소 속성의 개요입니다:

{
    'id':   'exchange'                   // lowercase string exchange id
    'name': 'Exchange'                   // human-readable string
    'countries': [ 'US', 'CN', 'EU' ],   // array of ISO country codes
    'urls': {
        'api': 'https://api.example.com/data',  // string or dictionary of base API URLs
        'www': 'https://www.example.com'        // string website URL
        'doc': 'https://docs.example.com/api',  // string URL or array of URLs
    },
    'version':         'v1',             // string ending with digits
    'api':             { ... },          // dictionary of api endpoints
    'has': {                             // exchange capabilities
        'CORS': false,
        'cancelOrder': true,
        'createDepositAddress': false,
        'createOrder': true,
        'fetchBalance': true,
        'fetchCanceledOrders': false,
        'fetchClosedOrder': false,
        'fetchClosedOrders': false,
        'fetchCurrencies': false,
        'fetchDepositAddress': false,
        'fetchMarkets': true,
        'fetchMyTrades': false,
        'fetchOHLCV': false,
        'fetchOpenOrder': false,
        'fetchOpenOrders': false,
        'fetchOrder': false,
        'fetchOrderBook': true,
        'fetchOrders': false,
        'fetchStatus': 'emulated',
        'fetchTicker': true,
        'fetchTickers': false,
        'fetchBidsAsks': false,
        'fetchTrades': true,
        'withdraw': false,
    },
    'timeframes': {                      // empty if the exchange.has['fetchOHLCV'] !== true
        '1m': '1minute',
        '1h': '1hour',
        '1d': '1day',
        '1M': '1month',
        '1y': '1year',
    },
    'timeout':           10000,          // number in milliseconds
    'rateLimit':         2000,           // number in milliseconds
    'userAgent':        'ccxt/1.1.1 ...' // string, HTTP User-Agent header
    'verbose':           false,          // boolean, output error details
    'markets':          { ... }          // dictionary of markets/pairs by symbol
    'symbols':          [ ... ]          // sorted list of string symbols (traded pairs)
    'currencies':       { ... }          // dictionary of currencies by currency code
    'markets_by_id':    { ... },         // dictionary of array of dictionaries (markets) by id
    'currencies_by_id': { ... },         // dictionary of dictionaries (markets) by id
    'apiKey':   '92560ffae9b8a0421...',  // string public apiKey (ASCII, hex, Base64, ...)
    'secret':   '9aHjPmW+EtRRKN/Oi...'   // string private secret key
    'password': '6kszf4aci8r',           // string password
    'uid':      '123456',                // string user id
    'options':          { ... },         // exchange-specific options
    // ... other properties here ...
}

거래소 속성

아래는 각 기본 거래소 속성에 대한 상세 설명입니다:

• id: 각 거래소에는 기본 id가 있습니다. id는 어떤 용도로도 사용되지 않으며, 사용자 영역의 거래소 인스턴스 식별 목적으로 사용되는 문자열 리터럴입니다. 동일한 거래소에 여러 링크를 가지고 id로 구별할 수 있습니다. 기본 id는 모두 소문자이며 거래소 이름에 해당합니다.

• name: 사람이 읽을 수 있는 거래소 이름을 담은 문자열 리터럴입니다.

• countries: 거래소가 운영되는 국가의 2자리 ISO 국가 코드로 이루어진 문자열 리터럴 배열입니다.

• urls['api']: API 호출을 위한 단일 문자열 리터럴 기본 URL 또는 비공개 및 공개 API에 대한 별도 URL의 연관 배열입니다.

• urls['www']: 주요 HTTP 웹사이트 URL입니다.

• urls['doc']: 거래소 웹사이트의 원본 API 문서에 대한 단일 문자열 URL 링크 또는 문서 링크 배열입니다.

• version: 현재 거래소 API의 버전 식별자를 담은 문자열 리터럴입니다. ccxt 라이브러리는 각 요청 시 이 버전 문자열을 API 기본 URL에 추가합니다. 새로운 거래소 API를 구현하는 경우가 아니라면 수정할 필요가 없습니다. 버전 식별자는 일반적으로 숫자 문자열이며, 경우에 따라 v1.1과 같이 'v'로 시작하기도 합니다. 직접 새로운 암호화폐 거래소 클래스를 구현하는 경우가 아니라면 재정의하지 마십시오.

• api: 암호화폐 거래소가 노출하는 모든 API 엔드포인트의 정의를 담은 연관 배열입니다. API 정의는 ccxt가 각 사용 가능한 엔드포인트에 대해 호출 가능한 인스턴스 메서드를 자동으로 구성하는 데 사용됩니다.

• has: 거래소 기능(예: fetchTickers, fetchOHLCV 또는 CORS)을 담은 연관 배열입니다.

• timeframes: 거래소의 fetchOHLCV 메서드에서 지원하는 시간 프레임의 연관 배열입니다. has['fetchOHLCV'] 속성이 true인 경우에만 채워집니다.

• timeout: 요청-응답 왕복에 대한 타임아웃(밀리초 단위, 기본값은 10000ms = 10초)입니다. 해당 시간 내에 응답이 수신되지 않으면 라이브러리는 RequestTimeout 예외를 발생시킵니다. 기본 타임아웃 값을 그대로 두거나 합리적인 값으로 설정할 수 있습니다. 타임아웃 없이 무한정 대기하는 것은 옵션이 아닙니다. 일반적으로 이 옵션을 재정의할 필요는 없습니다.

• rateLimit: 밀리초 단위의 속도 제한입니다. 이 값은 거래소의 속도 제한 내에 있기 위해 연속 요청 사이에 대기해야 하는 밀리초 수를 나타냅니다. 예를 들어, rateLimit이 1000이면 초당 1개의 요청이 허용됨을 의미합니다. 내장 속도 제한기는 기본적으로 활성화되어 있으며, enableRateLimit 속성을 false로 설정하여 끌 수 있습니다.

• enableRateLimit: 내장 속도 제한기를 활성화하고 연속 요청을 스로틀링하는 불리언(true/false) 값입니다. 이 설정은 기본적으로 true(활성화)입니다. 사용자는 거래소에서 차단되지 않도록 자체 속도 제한을 구현하거나 내장 속도 제한기를 활성화된 상태로 유지해야 합니다.

• userAgent: HTTP User-Agent 헤더를 설정할 객체입니다. ccxt 라이브러리는 기본적으로 User-Agent를 설정합니다. 일부 거래소는 이를 좋아하지 않을 수 있습니다. 거래소로부터 응답을 받는 데 어려움이 있고 User-Agent를 끄거나 기본값을 사용하고 싶다면, 이 값을 false, undefined 또는 빈 문자열로 설정하십시오. userAgent의 값은 아래의 HTTP headers 속성으로 재정의될 수 있습니다.

• headers: HTTP 헤더와 그 값의 연관 배열입니다. 기본값은 빈 {}입니다. 모든 헤더는 모든 요청 앞에 추가됩니다. headers 내에 User-Agent 헤더가 설정된 경우, 위의 userAgent 속성에 설정된 값을 재정의합니다.

• verbose: HTTP 요청을 stdout에 기록할지 여부를 나타내는 불리언 플래그입니다(verbose 플래그는 기본적으로 false). Python 사용자는 표준 파이썬 로거를 사용한 대안적인 DEBUG 로깅 방법이 있으며, 코드 시작 부분에 다음 두 줄을 추가하여 활성화합니다:

  import logging
  logging.basicConfig(level=logging.DEBUG)

• returnResponseHeaders: true로 설정하면 거래소의 HTTP 응답 헤더가 REST API 호출의 반환 결과에서 info 필드 내의 responseHeaders 속성에 포함됩니다. 이는 속도 제한 정보나 거래소별 헤더와 같은 메타데이터에 접근하는 데 유용할 수 있습니다. 기본값은 false이며 헤더는 응답에 포함되지 않습니다. 참고: 응답이 객체이고 리스트나 문자열이 아닌 경우에만 지원됩니다.

• markets: 일반적인 거래 쌍 또는 심볼로 인덱싱된 마켓의 연관 배열입니다. 이 속성에 접근하기 전에 마켓을 로드해야 합니다. 거래소 인스턴스에서 loadMarkets() / load_markets() 메서드를 호출하기 전까지는 마켓을 사용할 수 없습니다.

• symbols: 거래소에서 사용 가능한 심볼의 비연관 배열(목록)로, 알파벳 순서로 정렬됩니다. 이것은 markets 속성의 키입니다. 심볼은 마켓에서 로드되고 재로드됩니다. 이 속성은 모든 마켓 키에 대한 편리한 단축키입니다.

• currencies: 거래소에서 사용 가능한 코드(보통 3~4자)별 통화의 연관 배열(딕셔너리)입니다. 통화는 마켓에서 로드되고 재로드됩니다.

• markets_by_id: 거래소별 id로 인덱싱된 마켓 배열의 연관 배열입니다. 동일한 marketId를 가진 마켓이 여러 개 있지 않는 한 일반적으로 길이가 1인 배열입니다. 이 속성에 접근하기 전에 마켓을 로드해야 합니다.

• apiKey: 공개 API 키 문자열 리터럴입니다. 대부분의 거래소는 API 키 설정이 필요합니다.

• secret: 비공개 시크릿 API 키 문자열 리터럴입니다. 대부분의 거래소는 apiKey와 함께 이것도 요구합니다.

• password: 비밀번호/구문이 담긴 문자열 리터럴입니다. 일부 거래소는 거래 시 이 파라미터를 요구하지만 대부분은 그렇지 않습니다.

• uid: 계정의 고유 id입니다. 문자열 리터럴 또는 숫자일 수 있습니다. 일부 거래소도 거래 시 이것을 요구하지만 대부분은 그렇지 않습니다.

• requiredCredentials: 기반 거래소에 비공개 API 호출을 보내는 데 필요한 위의 API 자격증명을 보여주는 통합 연관 딕셔너리입니다(거래소는 특정 키 집합을 요구할 수 있습니다).

• options: 기반 거래소에서 허용되고 CCXT에서 지원하는 특수 키와 옵션을 담은 거래소별 연관 딕셔너리입니다.

• precisionMode: 거래소 십진수 정밀도 계산 모드입니다. 정밀도 및 한도에 대한 자세한 내용을 읽어보십시오.

• 프록시의 경우 - proxyUrl, httpUrl, httpsUrl, socksProxy, wsProxy, wssProxy, wsSocksProxy: 특정 프록시의 URL입니다. 자세한 내용은 프록시 섹션을 참조하십시오.

거래소 속성 재정의 섹션을 참조하십시오.

거래소 메타데이터

• has: 다음을 포함한 거래소 기능 플래그를 담은 연관 배열입니다:

  'has': {
  
      'CORS': false,  // has Cross-Origin Resource Sharing enabled (works from browser) or not
  
      // unified methods availability flags (can be true, false, or 'emulated'):
  
      'cancelOrder': true,
      'createDepositAddress': false,
      'createOrder': true,
      'fetchBalance': true,
      'fetchCanceledOrders': false,
      'fetchClosedOrder': false,
      'fetchClosedOrders': false,
      'fetchCurrencies': false,
      'fetchDepositAddress': false,
      'fetchMarkets': true,
      'fetchMyTrades': false,
      'fetchOHLCV': false,
      'fetchOpenOrder': false,
      'fetchOpenOrders': false,
      'fetchOrder': false,
      'fetchOrderBook': true,
      'fetchOrders': false,
      'fetchStatus': 'emulated',
      'fetchTicker': true,
      'fetchTickers': false,
      'fetchBidsAsks': false,
      'fetchTrades': true,
      'withdraw': false,
      ...
  }

  각 메서드의 가용성을 보여주는 각 플래그의 의미는 다음과 같습니다:

  • undefined / None / null 값은 해당 메서드가 현재 ccxt에 구현되지 않았음을 의미합니다(ccxt가 아직 통합하지 않았거나 거래소 API에서 기본적으로 사용 불가능한 경우).
  • 불리언 false는 해당 엔드포인트가 거래소 API에서 기본적으로 사용 불가능함을 의미합니다.
  • 불리언 true는 해당 엔드포인트가 거래소 API에서 기본적으로 사용 가능하고 ccxt 라이브러리에서 통합되었음을 의미합니다.
  • 'emulated' 문자열은 해당 엔드포인트가 거래소 API에서 기본적으로 사용 불가능하지만, ccxt 라이브러리가 다른 사용 가능한 true 메서드로부터 (가능한 한) 재구성했음을 의미합니다.

  모든 거래소와 지원 메서드의 전체 목록은 이 예시를 참조하십시오: https://github.com/ccxt/ccxt/blob/master/examples/js/exchange-capabilities.js

속도 제한(Rate Limit)

거래소는 일반적으로 속도 제한이라고 불리는 것을 부과합니다. 거래소는 사용자의 자격증명과 IP 주소를 기억하고 추적하며, API를 너무 자주 쿼리하는 것을 허용하지 않습니다. 거래소는 부하를 균형 잡고 (D)DoS 및 오용으로부터 API 서버를 보호하기 위해 트래픽 혼잡을 제어합니다.

경고: 차단을 방지하려면 요청 속도 제한을 준수하세요!

대부분의 거래소는 초당 최대 1~2개의 요청을 허용합니다. 요청이 너무 공격적이면 거래소가 API 접근을 일시적으로 제한하거나 일정 기간 차단할 수 있습니다.

exchange.rateLimit 속성은 안전하지만 최적화되지 않은 기본값으로 설정되어 있습니다. 일부 거래소는 엔드포인트마다 다른 속도 제한을 적용할 수 있습니다. 애플리케이션의 목적에 맞게 rateLimit을 조정하는 것은 사용자의 책임입니다.

CCXT 라이브러리에는 사용자에게 투명하게 백그라운드에서 필요한 스로틀링을 수행하는 실험적인 내장 속도 제한 알고리즘이 있습니다. 경고: 사용자는 최소한 어떤 형태로든 속도 제한을 직접 구현하거나 내장 속도 제한기를 사용하여 이를 적용할 책임이 있습니다.

CCXT에는 다음과 같은 내장 속도 제한 알고리즘이 있습니다:

• 누수 버킷 방식(기본값): 요청을 대기열에 넣고 일정하고 고정된 속도로 해제하는 방식으로 작동합니다. 요청이 급증해도 즉시 실행되지 않고 시간에 걸쳐 평탄화되어 거래소 속도 제한에 걸리지 않으면서도 짧은 활동 급증을 우아하게 처리할 수 있습니다.
• 윈도우 기반 방식(선택적): 사용자가 { 'rateLimiterAlgorithm': 'rollingWindow' } 옵션을 제공하면 ccxt가 누수 버킷 모델에서 윈도우 기반 속도 제한기로 전환합니다(rollingWindowSize: X0000을 제공하여 윈도우 크기를 사용자 지정할 수 있으며, CCXT는 기본 windowSize로 60초를 사용합니다). 윈도우 기반 제한기는 고정된 시간 윈도우 내에서 최대 요청 수를 적용합니다(예: X밀리초 내 N개의 요청). 제한에 도달하면 현재 윈도우가 만료될 때까지 추가 요청이 지연됩니다.

.enableRateLimit 속성을 사용하여 내장 속도 제한기를 켜거나 끌 수 있습니다:

// enable built-in rate limiting upon instantiation of the exchange
const exchange = new ccxt.bitfinex ({
    // 'enableRateLimit': true, // enabled by default
})

// or switch the built-in rate-limiter on or off later after instantiation
exchange.enableRateLimit = true // enable
exchange.enableRateLimit = false // disable

호출이 속도 제한에 걸리거나 논스 오류가 발생하는 경우, ccxt 라이브러리는 InvalidNonce 예외를 발생시키거나, 경우에 따라 다음 유형 중 하나를 발생시킵니다:

• DDoSProtection
• ExchangeNotAvailable
• ExchangeError
• InvalidNonce

일반적으로 나중에 재시도하면 충분합니다.

속도 제한기에 관한 참고 사항

각 거래소 인스턴스당 하나의 속도 제한기

속도 제한기는 거래소 인스턴스의 속성입니다. 즉, 각 거래소 인스턴스는 다른 인스턴스를 인식하지 못하는 자체 속도 제한기를 가집니다. 많은 경우 사용자는 프로그램 전체에서 동일한 거래소 인스턴스를 재사용해야 합니다. 동일한 IP 주소에서 동일한 API 키 쌍으로 동일한 거래소의 여러 인스턴스를 사용하지 마세요.

// DO NOT DO THIS!

const binance1 = new ccxt.binance ()
const binance2 = new ccxt.binance ()
const binance3 = new ccxt.binance ()

while (true) {
    const result = await Promise.all ([
        binance1.fetchOrderBook ('BTC/USDT'),
        binance2.fetchOrderBook ('ETH/USDT'),
        binance3.fetchOrderBook ('ETH/BTC'),
    ])
    console.log (result)
}

아래와 같이 거래소 인스턴스를 최대한 재사용하세요:

// DO THIS INSTEAD:

const binance = new ccxt.binance ()

while (true) {
    const result = await Promise.all ([
        binance.fetchOrderBook ('BTC/USDT'),
        binance.fetchOrderBook ('ETH/USDT'),
        binance.fetchOrderBook ('ETH/BTC'),
    ])
    console.log (result)
}

속도 제한기는 거래소 인스턴스에 속하므로 거래소 인스턴스를 삭제하면 속도 제한기도 삭제됩니다. 속도 제한에서 가장 흔한 실수 중 하나는 거래소 인스턴스를 반복적으로 생성하고 삭제하는 것입니다. 프로그램에서 거래소 인스턴스를 여러 번 호출되는 함수 내에서 생성하고 삭제하는 경우, 속도 제한기가 반복적으로 재설정되어 결국 속도 제한을 위반하게 됩니다. 재사용하는 대신 매번 거래소 인스턴스를 재생성하면 CCXT가 매번 시장을 로드하려고 시도합니다. 따라서 마켓 로딩 섹션에서 설명된 것처럼 마켓을 강제로 반복 로드하게 됩니다. 마켓 엔드포인트를 남용하면 결국 속도 제한기도 깨지게 됩니다.

// DO NOT DO THIS!

async function tick () {
    const exchange = new ccxt.binance ()
    const response = await exchange.fetchOrderBook ('BTC/USDT')
    // ... some processing here ...
    return response
}

while (true) {
    const result = await tick ()
    console.log (result)
}

속도 제한기의 내부 작동 방식을 정확히 이해하고 자신이 하는 일을 100% 확신하지 않는 한 이 규칙을 어기지 마세요. 항상 안전하게 유지하려면 아래와 같이 함수 및 메서드 호출 체인 전체에서 거래소 인스턴스를 재사용하세요:

// DO THIS INSTEAD:

async function tick (exchange) {
    const response = await exchange.fetchOrderBook ('BTC/USDT')
    // ... some processing here ...
    return response
}

const exchange = new ccxt.binance ()
while (true) {
    const result = await tick (exchange)
    console.log (result)
}

Cloudflare / Incapsula에 의한 DDoS 보호

일부 거래소는 Cloudflare 또는 Incapsula에 의한 DDoS 보호를 받습니다. 부하가 높은 기간에는 IP가 일시적으로 차단될 수 있습니다. 때로는 전체 국가나 지역을 제한하기도 합니다. 이 경우 서버는 일반적으로 HTTP 40x 오류를 명시하거나 브라우저/캡차 테스트를 실행하고 페이지 리로드를 몇 초 지연하는 페이지를 반환합니다. 그런 다음 브라우저/핑거프린트가 일시적으로 접근이 허용되어 화이트리스트에 추가되거나 이후 사용을 위한 HTTP 쿠키를 받습니다.

DDoS 보호 문제, 속도 제한 문제 또는 위치 기반 필터링 문제의 가장 일반적인 증상:

• 모든 유형의 거래소 메서드에서 RequestTimeout 예외 발생
• HTTP 오류 코드 400, 403, 404, 429, 500, 501, 503 등과 함께 ExchangeError 또는 ExchangeNotAvailable 발생
• DNS 해석 문제, SSL 인증서 문제 및 저수준 연결 문제 발생
• 거래소에서 JSON 대신 HTML 템플릿 페이지 수신

DDoS 보호 오류가 발생하여 특정 거래소에 접근할 수 없는 경우:

• 프록시를 사용하세요 (응답이 느릴 수 있음)
• 거래소 지원팀에 화이트리스트 등록을 요청하세요
• 다른 지역의 대체 IP를 시도하세요
• 분산 서버 네트워크에서 소프트웨어를 실행하세요
• 거래소와 가까운 위치(같은 국가, 같은 도시, 같은 데이터센터, 같은 서버 랙, 같은 서버)에서 소프트웨어를 실행하세요
• ...

최대 요청 용량

비동기 프로그래밍에서 CCXT는 무제한으로 요청을 예약할 수 있습니다. 그러나 기본적으로 최대 1000개의 동시 요청으로 설정된 큐 길이 제한이 있습니다. 그 이상을 큐에 넣으려고 하면 "throttle queue is over maxCapacity" 오류가 발생합니다.

대부분의 경우, 이렇게 많은 대기 중인 작업이 있다는 것은 설계가 최적화되지 않았음을 나타내며, 새 요청은 기존 작업이 완료될 때까지 지연됩니다.

그러나 이 제한을 우회하려는 사용자는 아래와 같이 인스턴스화 시 기본 maxCapacity를 늘릴 수 있습니다:

ex = ccxt.binance({'options': {'maxRequestsQueue': 9999}})

마켓

• 통화 구조
• 마켓 구조
• 정밀도 및 한도
• 마켓 로딩
• 심볼 및 마켓 ID
• 마켓 캐시 강제 재로딩

각 거래소는 특정 종류의 가치 있는 것들을 거래하는 장소입니다. 거래소마다 이를 지칭하는 용어가 다를 수 있습니다: "통화", "자산", "코인", "토큰", "주식", "상품", "암호화폐", "법정화폐" 등. 한 자산을 다른 자산으로 거래하는 장소는 일반적으로 "마켓", "심볼", "거래 쌍", "계약" 등으로 불립니다.

ccxt 라이브러리의 관점에서, 모든 거래소는 내부에 여러 마켓을 제공합니다. 각 마켓은 두 개 이상의 통화로 정의됩니다. 마켓의 집합은 거래소마다 달라 교차 거래소 및 교차 마켓 차익 거래의 가능성을 열어줍니다.

통화 구조

{
    'id':       'btc',       // string literal for referencing within an exchange
    'code':     'BTC',       // uppercase unified string literal code of the currency
    'name':     'Bitcoin',   // string, human-readable name, if specified
    'active':    true,       // boolean, currency status (tradeable and withdrawable)
    'fee':       0.123,      // withdrawal fee, flat
    'precision': 8,          // number of decimal digits "after the dot" (depends on exchange.precisionMode)
    'deposit':   true        // boolean, deposits are available
    'withdraw':  true        // boolean, withdraws are available
    'limits': {              // value limits when placing orders on this market
        'amount': {
            'min': 0.01,     // order amount should be > min
            'max': 1000,     // order amount should be < max
        },
        'withdraw': { ... }, // withdrawal limits
        'deposit': {...},
    },
    'networks': {...}        // network structures indexed by unified network identifiers (ERC20, TRC20, BSC, etc)
    'info': { ... },         // the original unparsed currency info from the exchange
}

각 통화는 다음 키를 가진 연관 배열(딕셔너리)입니다:

• id. 거래소 내 통화의 문자열 또는 숫자 ID. 통화 ID는 요청/응답 프로세스 중 코인을 식별하기 위해 거래소 내부에서 사용됩니다.
• code. 특정 통화의 대문자 문자열 코드 표현. 통화 코드는 ccxt 라이브러리 내에서 통화를 참조하는 데 사용됩니다(아래에 설명).
• name. 통화의 사람이 읽을 수 있는 이름(대문자와 소문자의 혼합일 수 있음).
• fee. 거래소에서 지정한 출금 수수료 값. 대부분의 경우 동일한 통화로 지불되는 고정 금액을 의미합니다. 거래소가 공개 엔드포인트를 통해 이를 지정하지 않는 경우 fee는 undefined/None/null이거나 누락될 수 있습니다.
• active. 이 통화에 대한 거래 또는 펀딩(입금 또는 출금)이 현재 가능한지를 나타내는 불리언 값. 자세한 내용은 active 상태를 참고하세요.
• info. 수수료, 환율, 한도 및 기타 일반 마켓 정보를 포함하는 비공통 마켓 속성의 연관 배열. 내부 info 배열은 각 특정 마켓마다 다르며, 그 내용은 거래소에 따라 다릅니다.
• precision. 이 통화를 참조할 때 거래소에서 허용하는 값의 정밀도. 이 속성의 값은 exchange.precisionMode에 따라 다릅니다.
• limits. 금액(볼륨), 출금 및 입금에 대한 최솟값과 최댓값.

네트워크 구조

{
    'id':       'tron',         // string literal for referencing within an exchange
    'network':  'TRC20'         // unified network
    'name':     'Tron Network', // string, human-readable name, if specified
    'active':    true,          // boolean, currency status (tradeable and withdrawable)
    'fee':       0.123,         // withdrawal fee, flat
    'precision': 8,             // number of decimal digits "after the dot" (depends on exchange.precisionMode)
    'deposit':   true           // boolean, deposits are available
    'withdraw':  true           // boolean, withdraws are available
    'limits': {                 // value limits when placing orders on this market
        'amount': {
            'min': 0.01,        // order amount should be > min
            'max': 1000,        // order amount should be < max
        },
        'withdraw': { ... },    // withdrawal limits
        'deposit': {...},       // deposit limits
    },
    'info': { ... },            // the original unparsed currency info from the exchange
}

각 네트워크는 다음 키를 가진 연관 배열(딕셔너리)입니다:

• id. 거래소 내 네트워크의 문자열 또는 숫자 ID. 네트워크 ID는 요청/응답 프로세스 중 네트워크를 식별하기 위해 거래소 내부에서 사용됩니다.
• network. 특정 네트워크의 대문자 문자열 표현. 네트워크는 ccxt 라이브러리 내에서 네트워크를 참조하는 데 사용됩니다.
• name. 네트워크의 사람이 읽을 수 있는 이름(대문자와 소문자의 혼합일 수 있음).
• fee. 거래소에서 지정한 출금 수수료 값. 대부분의 경우 동일한 통화로 지불되는 고정 금액을 의미합니다. 거래소가 공개 엔드포인트를 통해 이를 지정하지 않는 경우 fee는 undefined/None/null이거나 누락될 수 있습니다.
• active. 이 통화에 대한 거래 또는 펀딩(입금 또는 출금)이 현재 가능한지를 나타내는 불리언 값. 자세한 내용은 active 상태를 참고하세요.
• info. 수수료, 환율, 한도 및 기타 일반 마켓 정보를 포함하는 비공통 마켓 속성의 연관 배열. 내부 info 배열은 각 특정 마켓마다 다르며, 그 내용은 거래소에 따라 다릅니다.
• precision. 이 통화를 참조할 때 거래소에서 허용하는 값의 정밀도. 이 속성의 값은 exchange.precisionMode에 따라 다릅니다.
• limits. 금액(볼륨), 출금 및 입금에 대한 최솟값과 최댓값.

마켓 구조

{
    'id':      'btcusd',      // string literal for referencing within an exchange
    'symbol':  'BTC/USD',     // uppercase string literal of a pair of currencies
    'base':    'BTC',         // uppercase string, unified base currency code, 3 or more letters
    'quote':   'USD',         // uppercase string, unified quote currency code, 3 or more letters
    'baseId':  'btc',         // any string, exchange-specific base currency id
    'quoteId': 'usd',         // any string, exchange-specific quote currency id
    'active':   true,         // boolean, market status
    'type':    'spot',        // spot for spot, future for expiry futures, swap for perpetual swaps, 'option' for options
    'spot':     true,         // whether the market is a spot market
    'margin':   true,         // whether the market is a margin market
    'future':   false,        // whether the market is a expiring future
    'swap':     false,        // whether the market is a perpetual swap
    'option':   false,        // whether the market is an option contract
    'contract': false,        // whether the market is a future, a perpetual swap, or an option
    'settle':   'USDT',       // the unified currency code that the contract will settle in, only set if `contract` is true
    'settleId': 'usdt',       // the currencyId of that the contract will settle in, only set if `contract` is true
    'contractSize': 1,        // the size of one contract, only used if `contract` is true
    'linear':   true,         // the contract is a linear contract (settled in quote currency)
    'inverse':  false,        // the contract is an inverse contract (settled in base currency)
    'expiry':  1641370465121, // the unix expiry timestamp in milliseconds, undefined for everything except market['type'] `future`
    'expiryDatetime': '2022-03-26T00:00:00.000Z', // The datetime contract will in iso8601 format
    'strike': 4000,           // price at which a put or call option can be exercised
    'optionType': 'call',     // call or put string, call option represents an option with the right to buy and put an option with the right to sell
    // note, 'taker' and 'maker' compose extended data for markets, however it might be better to use `fetchTradingFees` for more accuracy
    'taker':    0.002,        // taker fee rate, 0.002 = 0.2%
    'maker':    0.0016,       // maker fee rate, 0.0016 = 0.16%
    'percentage': true,       // whether the taker and maker fee rate is a multiplier or a fixed flat amount
    'tierBased': false,       // whether the fee depends on your trading tier (your trading volume)
    'feeSide': 'get',         // string literal can be 'get', 'give', 'base', 'quote', 'other'
    'precision': {            // number of decimal digits "after the dot"
        'price': 8,           // integer or float for TICK_SIZE roundingMode, might be missing if not supplied by the exchange
        'amount': 8,          // integer, might be missing if not supplied by the exchange
        'cost': 8,            // integer, very few exchanges actually have it
    },
    'limits': {               // value limits when placing orders on this market
        'amount': {
            'min': 0.01,      // order amount should be > min
            'max': 1000,      // order amount should be < max
        },
        'price': { ... },     // same min/max limits for the price of the order
        'cost':  { ... },     // same limits for order cost = price * amount
        'leverage': { ... },  // same min/max limits for the leverage of the order
    },
    'marginModes': {
        'cross': false,       // whether pair supports cross-margin trading
        'isolated': false,    // whether pair supports isolated-margin trading
    },
    'info':      { ... },     // the original unparsed market info from the exchange
}

각 마켓은 다음 키를 가진 연관 배열(딕셔너리)입니다:

• id. 거래소 내 마켓 또는 거래 수단의 문자열 또는 숫자 ID. 마켓 ID는 요청/응답 프로세스 중 거래 쌍을 식별하기 위해 거래소 내부에서 사용됩니다.
• symbol. 특정 거래 쌍 또는 수단의 대문자 문자열 코드 표현. 일반적으로 BTC/USD, LTC/CNY 또는 ETH/EUR 등과 같이 슬래시를 사용하여 기준통화/호가통화 형식으로 작성됩니다. 심볼은 ccxt 라이브러리 내에서 마켓을 참조하는 데 사용됩니다(아래에 설명).
• base. 기준 법정화폐 또는 암호화폐의 통일된 대문자 문자열 코드. 이는 CCXT 전체와 통합 CCXT API 전체에서 해당 통화나 토큰을 참조하는 데 사용되는 표준화된 통화 코드로, CCXT가 이해하는 언어입니다.
• quote. 호가 법정화폐 또는 암호화폐의 통일된 대문자 문자열 코드.
• baseId. 이 마켓의 기준 통화에 대한 거래소별 ID로, 통일되지 않았습니다. 어떤 문자열이든 될 수 있습니다. 거래소가 이해하는 언어로 거래소와 통신할 때 사용됩니다.
• quoteId. 호가 통화의 거래소별 ID로, 통일되지 않았습니다.
• active. 이 마켓의 거래가 현재 가능한지를 나타내는 불리언 값. 자세한 내용은 active 상태를 참고하세요.
• maker. 부동소수점, 0.0015 = 0.15%. 메이커 수수료는 거래소에 유동성을 제공할 때, 즉 주문을 마켓메이크하고 다른 사람이 체결할 때 지불합니다. 메이커 수수료는 일반적으로 테이커 수수료보다 낮습니다. 수수료는 음수일 수 있으며, 이는 파생상품 거래소에서 매우 일반적입니다. 음수 수수료는 거래소가 이 마켓을 거래하는 사용자에게 리베이트(보상)를 지불한다는 것을 의미합니다(참고: 'taker'와 'maker'는 공개적으로 이용 가능한 수수료이며, VIP 레벨/거래량 등을 고려하지 않습니다. 계정에 특정한 수수료를 얻으려면 fetchTradingFees를 사용하세요).
• taker. 부동소수점, 0.002 = 0.2%. 테이커 수수료는 거래소에서 유동성을 가져가며 다른 사람의 주문을 체결할 때 지불합니다.
• percentage. taker와 maker가 승수인지 고정 금액인지를 나타내는 불리언 true/false 값.
• tierBased. 수수료가 거래 등급(일반적으로 일정 기간 동안의 거래량)에 따라 달라지는지를 나타내는 불리언 true/false 값.
• info. 수수료, 환율, 한도 및 기타 일반 마켓 정보를 포함하는 비공통 마켓 속성의 연관 배열. 내부 info 배열은 각 특정 마켓마다 다르며, 그 내용은 거래소에 따라 다릅니다.
• precision. 주문 배치 시 가격, 금액 및 비용에 대해 거래소에서 허용하는 주문 값의 정밀도. (이 속성 내부의 값은 exchange.precisionMode에 따라 다릅니다).
• limits. 가격, 금액(볼륨) 및 비용(cost = price * amount)에 대한 최솟값과 최댓값.
• optionType. 옵션의 유형으로, call 옵션은 매수 권리가 있는 옵션을, put은 매도 권리가 있는 옵션을 나타냅니다.
• strike. 옵션이 행사될 때 매수 또는 매도할 수 있는 가격.

활성 상태

active 플래그는 일반적으로 currencies 및 markets에서 사용됩니다. 거래소마다 이 플래그에 약간 다른 의미를 부여할 수 있습니다. 통화가 비활성 상태인 경우, 대부분의 경우 해당하는 모든 티커, 오더북 및 기타 관련 엔드포인트는 빈 응답, 모두 0, 데이터 없음 또는 오래된 정보를 반환합니다. 사용자는 통화가 active 상태인지 확인하고 주기적으로 마켓을 다시 로드해야 합니다.

참고: active 속성의 false 값이 항상 거래, 출금 또는 입금과 같은 모든 기능이 거래소에서 비활성화되었음을 보장하지는 않습니다. 마찬가지로, true 값도 이러한 모든 기능이 거래소에서 활성화되어 있음을 보장하지 않습니다. 특정 거래소에서 active 플래그의 정확한 의미는 해당 거래소의 문서와 CCXT 코드를 확인하세요. 이 플래그는 아직 모든 마켓에서 지원되거나 구현되지 않았으며 누락될 수 있습니다.

경고! 수수료에 관한 정보는 실험적이고 불안정하며 일부만 제공되거나 전혀 제공되지 않을 수 있습니다.

정밀도와 제한

limits와 precision을 혼동하지 마세요! 정밀도는 최소 제한과 아무런 관계가 없습니다. 0.01의 정밀도가 반드시 마켓의 최소 제한이 0.01임을 의미하지는 않습니다. 반대도 마찬가지입니다: 최소 제한이 0.01이라고 해서 반드시 정밀도가 0.01인 것은 아닙니다.

예시:

market['limits']['amount']['min'] == 0.05 &&
market['precision']['amount'] == 0.0001 &&
market['precision']['price'] == 0.01

• 수량 값은 >= 0.05여야 합니다:

  + good: 0.05, 0.051, 0.0501, 0.0502, ..., 0.0599, 0.06, 0.0601, ...
  - bad: 0.04, 0.049, 0.0499

• 수량의 정밀도는 소수점 이하 최대 4자리여야 합니다 (0.0001):

  + good: 0.05, 0.0501, ..., 0.06, ..., 0.0719, ...
  - bad: 0.05001, 0.05000, 0.06001

• 가격의 정밀도는 소수점 이하 최대 2자리여야 합니다 (0.01):

  + good: 1.6, 1.61, 123.01, ..., 1234.56, ...
  - bad: 1.601, ..., 123.012, ..., 1234.567

2. (market['precision']['amount'] == -1)

   음수 정밀도는 거래소의 precisionMode가 SIGNIFICANT_DIGIT 또는 DECIMAL_PRECISION인 경우에만 이론적으로 발생할 수 있습니다. 이는 수량이 10의 (지정된 절댓값) 거듭제곱의 정수 배수여야 함을 의미합니다:

   + good: 10, 50, ..., 110, ... 1230, ..., 1000000, ..., 1234560, ...
   - bad: 9.5, ... 10.1, ..., 11, ... 200.71, ...

   -2의 경우 허용 가능한 값은 100의 배수(예: 100, 200, ...)가 되며, 이하 동일합니다.

정밀도 모드

exchange['precisionMode']에서 지원되는 정밀도 모드는 다음과 같습니다:

• TICK_SIZE – 거의 모든 거래소가 이 정밀도 모드를 사용합니다. 이 모드에서 market_or_currency['precision']의 숫자는 반올림 또는 절사를 위한 최소 정밀도 단위(소수)를 나타냅니다.
• SIGNIFICANT_DIGITS – 0이 아닌 자릿수만 계산하며, 일부 거래소(bitfinex 및 다른 몇몇 거래소)가 이 소수 계산 모드를 구현합니다. 이 정밀도 모드에서 market_or_currency['precision']의 숫자는 소수점 이후 마지막 유효(0이 아닌) 소수 자릿수의 N번째 위치를 나타냅니다.
• DECIMAL_PLACES (사용 중단됨, CCXT는 더 이상 어디서도 이 모드를 사용하지 않습니다) – 모든 자릿수를 계산합니다. 이 정밀도 모드에서 market_or_currency['precision']의 숫자는 추가 반올림 또는 절사를 위한 소수점 이후 소수 자릿수를 나타냅니다.

정밀도와 제한에 관한 참고사항

사용자는 모든 제한과 정밀도를 준수해야 합니다! 주문 값은 다음 조건을 충족해야 합니다:

• 주문 amount >= limits['amount']['min']
• 주문 amount <= limits['amount']['max']
• 주문 price >= limits['price']['min']
• 주문 price <= limits['price']['max']
• 주문 cost (amount * price) >= limits['cost']['min']
• 주문 cost (amount * price) <= limits['cost']['max']
• amount의 정밀도는 <= precision['amount']여야 합니다
• price의 정밀도는 <= precision['price']여야 합니다

위의 값들은 API에서 제한 정보를 제공하지 않거나 아직 구현되지 않은 일부 거래소에서는 누락될 수 있습니다.

소수 형식화 메서드

각 거래소마다 고유한 반올림, 계산 및 패딩 모드가 있습니다.

지원되는 반올림 모드는 다음과 같습니다:

• ROUND – 마지막 소수 자릿수를 정밀도에 맞게 반올림합니다
• TRUNCATE – 특정 정밀도 이후의 자릿수를 잘라냅니다

소수 정밀도 계산 모드는 exchange.precisionMode 속성에서 확인할 수 있습니다.

패딩 모드

지원되는 패딩 모드는 다음과 같습니다:

• NO_PADDING – 대부분의 경우 기본값
• PAD_WITH_ZERO – 정밀도까지 0 문자를 추가합니다

정밀도로 형식화

대부분의 경우 사용자는 정밀도 형식화를 직접 처리할 필요가 없습니다. 정밀도와 제한에 설명된 규칙을 따른다면, 사용자가 주문을 하거나 출금 요청을 보낼 때 CCXT가 이를 처리해줍니다. 그러나 일부 경우에는 정밀도 형식화 세부 사항이 중요할 수 있으므로, 다음 메서드들이 사용자 코드에서 유용할 수 있습니다.

거래소 베이스 클래스에는 다양한 반올림, 계산 및 패딩 모드를 지원하여 필요한 소수 정밀도로 값을 형식화하는 데 도움이 되는 decimalToPrecision 메서드가 포함되어 있습니다.

function decimalToPrecision (x, roundingMode, numPrecisionDigits, countingMode = DECIMAL_PLACES, paddingMode = NO_PADDING)

문자열과 소수를 형식화하기 위해 decimalToPrecision을 사용하는 방법의 예시는 다음 파일들을 참조하세요:

• Typescript: https://github.com/ccxt/ccxt/blob/master/ts/src/test/base/functions/test.number.ts
• JavaScript: https://github.com/ccxt/ccxt/blob/master/js/src/test/base/functions/test.number.js
• Python: https://github.com/ccxt/ccxt/blob/master/python/ccxt/test/base/test_number.py
• PHP: https://github.com/ccxt/ccxt/blob/master/php/test/base/test_number.php

Python 경고! decimal_to_precision 메서드는 getcontext().prec에 영향을 받습니다!

사용자의 편의를 위해 CCXT 베이스 거래소 클래스는 다음 메서드들도 구현합니다:

function amountToPrecision (symbol, amount)
function priceToPrecision (symbol, price)
function costToPrecision (symbol, cost)
function currencyToPrecision (code, amount)

각 거래소마다 고유한 정밀도 설정이 있으며, 위의 메서드들은 이식 가능하고 기반 거래소에 구애받지 않는 방식으로 거래소별 정밀도 규칙에 따라 값을 형식화하는 데 도움이 됩니다. 이를 가능하게 하려면, 값을 형식화하기 전에 마켓과 통화가 먼저 로드되어 있어야 합니다.

이 메서드들을 호출하기 전에 반드시 exchange.loadMarkets()로 마켓을 로드하세요!

예를 들어:

await exchange.loadMarkets ()
const symbol = 'BTC/USDT'
const amount = 1.2345678 // amount in base currency BTC
const price = 87654.321 // price in quote currency USDT
const formattedAmount = exchange.amountToPrecision (symbol, amount)
const formattedPrice = exchange.priceToPrecision (symbol, price)
console.log (formattedAmount, formattedPrice)

exchange.precisionMode의 동작을 설명하는 더 실용적인 예시:

// case A
exchange.precisionMode = ccxt.DECIMAL_PLACES
market = exchange.market (symbol)
market['precision']['amount'] === 8 // up to 8 decimals after the dot
exchange.amountToPrecision (symbol, 0.123456789) === 0.12345678
exchange.amountToPrecision (symbol, 0.0000000000123456789) === 0.0000000 === 0.0

// case B
exchange.precisionMode = ccxt.TICK_SIZE
market = exchange.market (symbol)
market['precision']['amount'] === 0.00000001 // up to 0.00000001 precision
exchange.amountToPrecision (symbol, 0.123456789) === 0.12345678
exchange.amountToPrecision (symbol, 0.0000000000123456789) === 0.00000000 === 0.0

// case C
exchange.precisionMode = ccxt.SIGNIFICANT_DIGITS
market = exchange.market (symbol)
market['precision']['amount'] === 8 // up to 8 significant non-zero digits
exchange.amountToPrecision (symbol, 0.0000000000123456789) === 0.000000000012345678
exchange.amountToPrecision (symbol, 123.4567890123456789) === 123.45678

마켓 로드

대부분의 경우 다른 API 메서드에 접근하기 전에 특정 거래소의 마켓 및 거래 심볼 목록을 먼저 로드해야 합니다. 마켓 로드를 잊어버린 경우, ccxt 라이브러리가 통합 API에 대한 첫 번째 호출 시 자동으로 이를 수행합니다. 이 경우 두 번의 HTTP 요청이 순차적으로 전송됩니다: 첫 번째는 마켓, 두 번째는 기타 데이터를 위한 것입니다. 이러한 이유로, fetchTicker, fetchBalance 등과 같은 통합 CCXT API 메서드에 대한 첫 번째 호출은 거래소 API에서 마켓 정보를 로드하는 추가 작업을 수행해야 하므로 이후 호출보다 더 많은 시간이 걸립니다. 자세한 내용은 속도 제한기에 관한 참고사항을 참조하세요.

마켓을 미리 수동으로 로드하려면 거래소 인스턴스에서 loadMarkets () / load_markets () 메서드를 호출하세요. 이 메서드는 거래 심볼로 인덱싱된 마켓의 연관 배열을 반환합니다. 로직 실행에 대한 더 많은 제어가 필요한 경우, 수동으로 마켓을 미리 로드하는 것을 권장합니다.

(async () => {
    let kraken = new ccxt.kraken ()
    let markets = await kraken.loadMarkets ()
    console.log (kraken.id, markets)
}) ()

마켓 정보 외에도, loadMarkets() 호출은 거래소에서 통화도 로드하고 해당 정보를 .markets 및 .currencies 속성에 각각 캐시합니다.

사용자는 캐시를 우회하고 거래소 엔드포인트에서 직접 해당 정보를 가져오는 통합 메서드인 fetchMarkets()와 fetchCurrencies()를 호출할 수도 있지만, 이러한 메서드의 사용은 최종 사용자에게 권장되지 않습니다. 마켓을 미리 로드하는 권장 방법은 loadMarkets() 통합 메서드를 호출하는 것입니다. 그러나 기반 거래소에 해당 API 엔드포인트가 있는 경우, 새로운 거래소 통합은 이러한 메서드를 구현해야 합니다.

거래소 인스턴스 간 마켓 공유

메모리 사용을 최적화하고 중복 API 호출을 줄이기 위해, 동일한 거래소의 여러 인스턴스 간에 마켓 데이터를 공유할 수 있습니다. 이는 여러 거래소 인스턴스를 생성하거나 이미 로드된 마켓 데이터를 재사용하려는 경우에 특히 유용합니다.

(async () => {
    // Create first exchange instance and load markets
    let exchange1 = new ccxt.binance()
    await exchange1.loadMarkets()
    
    // Create second exchange instance
    let exchange2 = new ccxt.binance()
    
    // Share markets from first instance to second using the setMarketsFromExchange method
    exchange2.setMarketsFromExchange(exchange1)
    
    // Now exchange2 can use the shared markets without loading them
    console.log(exchange2.symbols) // Available immediately
    
    // When calling loadMarkets on exchange2, it will use cached markets
    await exchange2.loadMarkets() // No API call, uses shared markets
})()

마켓 공유의 이점:

• 메모리 효율성: 여러 거래소 인스턴스가 메모리에서 동일한 마켓 객체를 공유합니다
• 성능: 마켓 데이터에 대한 중복 API 호출을 제거합니다
• 리소스 절약: 네트워크 요청 및 API 속도 제한 사용을 줄입니다
• 지속성: 개별 거래소 인스턴스가 소멸되더라도 마켓 데이터가 계속 사용 가능합니다

간단한 직접 할당 대안:

직접 속성 할당을 선호하는 경우, markets 속성을 직접 할당하여 마켓을 공유할 수도 있습니다:

// Simple direct assignment (ensure both exchanges are of same type)
exchange2.markets = exchange1.markets;
exchange2.symbols = exchange1.symbols;  // Also copy symbols for full functionality

그러나 setMarketsFromExchange() 메서드 사용이 권장되는 이유는 다음과 같습니다:

• 두 거래소가 동일한 유형인지 검증합니다
• 관련된 모든 마켓 데이터가 적절히 복사되도록 보장합니다
• 더 나은 오류 처리를 제공합니다

중요 참고사항:

• 동일한 거래소 유형의 인스턴스 간에만 마켓을 공유하세요
• 마켓 공유는 두 인스턴스가 동일한 API 자격증명과 구성을 사용할 때 가장 효과적입니다
• 공유된 마켓 객체는 최소 하나의 참조가 존재하는 한 메모리에 유지됩니다
• setMarketsFromExchange() 메서드와 직접 할당 모두 복사본이 아닌 공유 참조를 생성합니다

심볼과 마켓 ID

통화 코드는 BTC, ETH, USD, GBP, CNY, JPY, DOGE, RUB, ZEC, XRP, XMR 등과 같이 세 자리에서 다섯 자리의 문자로 이루어진 코드입니다. 일부 거래소에는 더 긴 코드를 가진 특이한 통화가 있습니다.

심볼은 일반적으로 슬래시로 구분된 거래 통화 쌍의 대문자 문자열 리터럴 이름입니다. 슬래시 앞의 첫 번째 통화를 일반적으로 기준 통화라고 하며, 슬래시 뒤의 통화를 호가 통화라고 합니다. 심볼의 예시로는 BTC/USD, DOGE/LTC, ETH/EUR, DASH/XRP, BTC/CNY, ZEC/XMR, ETH/JPY 등이 있습니다.

마켓 ID는 REST 요청-응답 과정에서 거래소 내의 거래 쌍을 참조하는 데 사용됩니다. 마켓 ID 집합은 거래소마다 고유하며 거래소 간에 사용할 수 없습니다. 예를 들어, BTC/USD 쌍/마켓은 다양한 주요 거래소에서 btcusd, BTCUSD, XBTUSD, btc/usd, 42 (숫자 ID), BTC/USD, Btc/Usd, tBTCUSD, XXBTZUSD와 같이 다른 ID를 가질 수 있습니다. 마켓 ID를 기억하거나 사용할 필요가 없으며, 이는 거래소 구현 내부의 HTTP 요청-응답 목적을 위한 것입니다.

ccxt 라이브러리는 일반적이지 않은 마켓 ID를 공통 형식으로 표준화된 심볼로 추상화합니다. 심볼은 마켓 ID와 동일하지 않습니다. 모든 마켓은 해당하는 심볼로 참조됩니다. 심볼은 거래소 간에 공통적으로 사용되므로 차익 거래 및 다른 많은 목적에 적합합니다.

때로는 사용자가 'XBTM18' 또는 '.XRPUSDM20180101' 또는 다른 *"특수/희귀 심볼"*과 같은 심볼을 발견할 수 있습니다. 심볼이 슬래시를 가지거나 통화 쌍일 필요는 없습니다. 심볼의 문자열은 실제로 마켓 유형(현물 마켓인지 선물 마켓인지, 다크풀 마켓인지 만료된 마켓인지 등)에 따라 다릅니다. 심볼 문자열을 파싱하려는 시도는 강력히 권장되지 않으며, 심볼 형식에 의존하지 말고 마켓 속성을 사용하는 것이 권장됩니다.

마켓 구조체는 심볼과 ID로 인덱싱됩니다. 기본 거래소 클래스에는 심볼로 마켓에 접근하기 위한 내장 메서드도 있습니다. 대부분의 API 메서드는 첫 번째 인수로 심볼을 전달해야 합니다. 현재 가격을 조회하거나 주문을 생성하는 등의 작업 시 심볼을 지정해야 하는 경우가 많습니다.

대부분의 경우 사용자는 마켓 심볼을 사용하게 됩니다. 이러한 딕셔너리에서 존재하지 않는 키에 접근하면 표준 사용자 예외가 발생합니다.

마켓 및 통화 관련 메서드

(async () => {

    console.log (await exchange.loadMarkets ())

    let btcusd1 = exchange.markets['BTC/USD']     // get market structure by symbol
    let btcusd2 = exchange.market ('BTC/USD')     // same result in a slightly different way

    let btcusdId = exchange.marketId ('BTC/USD')  // get market id by symbol

    let symbols = exchange.symbols                // get an array of symbols
    let symbols2 = Object.keys (exchange.markets) // same as previous line

    console.log (exchange.id, symbols)            // print all symbols

    let currencies = exchange.currencies          // a dictionary of currencies

    let bitfinex = new ccxt.bitfinex ()
    await bitfinex.loadMarkets ()

    bitfinex.markets['BTC/USD']                   // symbol → market (get market by symbol)
    bitfinex.markets_by_id['XRPBTC'][0]           // id → market (get market by id)

    bitfinex.markets['BTC/USD']['id']             // symbol → id (get id by symbol)
    bitfinex.markets_by_id['XRPBTC'][0]['symbol'] // id → symbol (get symbol by id)

}) ()

명명 일관성

다양한 거래소에서 사용하는 용어가 다소 모호하여 신규 트레이더들에게 혼란을 줄 수 있습니다. 일부 거래소는 마켓을 *쌍(pairs)*이라고 부르고, 다른 거래소는 심볼을 *상품(products)*이라고 부릅니다. CCXT 라이브러리 관점에서, 각 거래소는 하나 이상의 트레이딩 마켓을 포함합니다. 각 마켓에는 ID와 심볼이 있습니다. 대부분의 심볼은 기준 통화(base currency)와 호가 통화(quote currency)의 쌍입니다.

→ Markets → Symbols → Currencies

역사적으로 동일한 트레이딩 쌍을 나타내기 위해 다양한 기호 이름이 사용되어 왔습니다. 일부 암호화폐(예: Dash)는 존재하는 동안 이름이 두 번 이상 변경되기도 했습니다. 거래소 간 일관성을 위해 CCXT 라이브러리는 심볼 및 통화에 대해 다음과 같은 알려진 대체 변환을 수행합니다:

• XBT → BTC: XBT는 더 새로운 표기이지만 BTC가 거래소 사이에서 더 일반적이며 비트코인처럼 들립니다 (자세히 보기).
• BCC → BCH: 비트코인 캐시 포크는 종종 두 가지 다른 기호 이름인 BCC와 BCH로 불립니다. BCC라는 이름은 비트코인 캐시에 대해 모호하며 BitConnect와 혼동됩니다. CCXT 라이브러리는 적절한 경우 BCC를 BCH로 변환합니다(일부 거래소와 애그리게이터가 이를 혼동합니다).
• DRK → DASH: DASH는 Darkcoin이었다가 Dash가 되었습니다 (자세히 보기).
• BCHABC → BCH: 2018년 11월 15일 비트코인 캐시가 두 번째로 포크되어, 현재 BCH(BCH ABC용)와 BSV(BCH SV용)가 존재합니다.
• BCHSV → BSV: 비트코인 캐시 SV 포크에 대한 일반적인 대체 매핑입니다(일부 거래소는 BSV, 다른 곳은 BCHSV라고 부르며, 우리는 전자를 사용합니다).
• DSH → DASH: 심볼과 통화를 혼동하지 않도록 주의하세요. DSH(Dashcoin)은 DASH(Dash)와 다릅니다. 일부 거래소에서는 DASH를 DSH로 일관성 없이 표기하는데, CCXT 라이브러리는 이에 대해서도 수정을 수행합니다(DSH → DASH). 단, 이 두 통화를 혼동하는 특정 거래소에서만 해당되며, 대부분의 거래소는 둘 다 올바르게 표기합니다. DASH/BTC와 DSH/BTC는 서로 다른 마켓임을 기억하세요.
• XRB → NANO: NANO는 RaiBlocks의 새로운 코드이므로, CCXT 통합 API는 필요에 따라 구 코드인 XRB를 NANO로 대체합니다. https://hackernoon.com/nano-rebrand-announcement-9101528a7b76
• USD → USDT: Bitfinex, HitBTC 등 일부 거래소는 목록에서 통화를 USD라고 표기하지만, 해당 마켓은 실제로 USDT를 거래합니다. 이러한 혼동은 심볼 이름의 3글자 제한이나 다른 이유에서 비롯될 수 있습니다. 거래되는 통화가 실제로 USDT이고 USD가 아닌 경우, CCXT 라이브러리는 USD → USDT 변환을 수행합니다. 단, 일부 거래소(예: Kraken)는 USD와 USDT 심볼을 모두 보유하고 있으며 USDT/USD 거래 쌍도 존재합니다.

명명 일관성에 관한 참고 사항

각 거래소는 exchange.commonCurrencies 속성에 암호화폐 기호 코드에 대한 대체 연관 배열을 보유하고 있습니다. 예:

'commonCurrencies' : {
    'XBT': 'BTC',
    'OPTIMISM': 'OP',
    // ... etc
}

여기서 키는 거래소 엔진이 해당 코인을 참조하는 실제 이름을 나타내고, 값은 CCXT를 통해 참조하고자 하는 이름을 나타냅니다.

때로는 코드에서 대소문자가 섞이고 공백이 있는 특이한 심볼 이름을 볼 수 있습니다. 이러한 이름을 갖게 된 논리는 하나 이상의 통화가 서로 다른 거래소에서 동일한 기호 코드를 사용할 때 명명 및 통화 코딩에서 충돌을 해결하기 위한 규칙으로 설명됩니다:

• 먼저, 거래소 자체에서 문제가 되는 통화 코드에 대해 이용 가능한 모든 정보를 수집합니다. 거래소는 보통 API, 문서, 지식 기반 또는 웹사이트 어딘가에 코인 목록에 대한 설명을 제공합니다.
• 통화 코드 뒤에 있는 각 특정 암호화폐를 식별한 후, CoinMarketCap에서 조회합니다.
• 가장 높은 시가총액을 가진 통화가 통화 코드를 획득하고 유지합니다. 예를 들어, HOT은 종종 Holo 또는 Hydro Protocol을 나타냅니다. 이 경우 Holo가 코드 HOT을 유지하고, Hydro Protocol은 그 이름 자체인 Hydro Protocol이 코드가 됩니다. 따라서 HOT/USD(Holo용)와 Hydro Protocol/USD와 같은 심볼의 거래 쌍이 존재할 수 있으며, 이는 서로 다른 마켓입니다.
• 특정 코인의 시가총액을 알 수 없거나 승자를 결정하기에 충분하지 않은 경우, 거래량 및 기타 요소도 고려합니다.
• 승자가 결정되면 다른 모든 경쟁 통화는 .commonCurrencies를 통해 충돌하는 거래소 내에서 코드 이름이 적절히 재매핑되고 대체됩니다. 참고: 이는 '.loadMarkets()'가 실행되기 전에 정의되어야 합니다!
• 안타깝게도 이는 진행 중인 작업입니다. 매일 새로운 통화가 등록되고 새로운 거래소가 수시로 추가되기 때문에, 일반적으로 이는 빠르게 변화하는 환경에서 *"라이브 모드"*로 진행되는 끝없는 자가 수정 과정입니다. 발견하실 수 있는 모든 충돌 및 불일치 보고에 감사드립니다.

명명 일관성에 관한 질문

심볼이 변경될 수 있나요?

간단히 말하면, 그렇습니다, 때로는 그러나 드물게 변경됩니다. 기호 매핑은 절대적으로 필요하고 피할 수 없는 경우 변경될 수 있습니다. 그러나 지금까지의 모든 기호 변경은 충돌 또는 포크 해결과 관련이 있었습니다. CCXT에서 한 코인의 시가총액이 동일한 기호 코드를 가진 다른 코인을 추월한 선례는 아직 없습니다.

항상 동일한 심볼로 동일한 암호화폐를 목록에 올릴 수 있다고 신뢰할 수 있나요?

어느 정도는요 ) 우선, 이 라이브러리는 진행 중인 작업이며 끊임없이 변화하는 현실에 적응하려고 노력하고 있으므로, 향후 일부 매핑을 변경하여 수정할 충돌이 있을 수 있습니다. 궁극적으로 라이선스에는 "무보증, 사용자 책임"이라고 명시되어 있습니다. 그러나 우리도 그 결과를 이해하고 라이브러리를 신뢰하고 싶으며 하위 호환성을 깨는 것을 전혀 좋아하지 않기 때문에, 임의로 여기저기서 기호 매핑을 변경하지는 않습니다.

주요 토큰의 심볼이 포크되거나 변경되어야 하는 경우, 제어권은 여전히 사용자에게 있습니다. exchange.commonCurrencies 속성은 다른 거래소 속성과 마찬가지로 초기화 시 또는 이후에 재정의할 수 있습니다. 중요한 토큰이 관련된 경우, 일반적으로 생성자 매개변수에 몇 줄을 추가하여 이전 동작을 유지하는 방법에 대한 안내를 게시합니다.

기준 및 호가 통화의 일관성

사용 중인 거래소에 따라 다르지만, 일부 거래소는 base와 quote가 반전된(일관성 없는) 쌍을 가지고 있습니다. 실제로 기준 통화와 호가 통화가 잘못 배치되어 있습니다(교환/반전됨). 이 경우 마켓 하위 구조에서 파싱된 base 및 quote 통화 값과 파싱되지 않은 info 사이에 차이가 나타납니다.

이러한 거래소의 경우 CCXT는 거래소 응답을 파싱할 때 기준 통화와 호가 통화의 양쪽을 전환하고 정규화하는 수정을 수행합니다. 이 로직은 재무적으로나 용어적으로 올바릅니다. 혼동을 줄이려면 다음 규칙을 기억하세요: 기준 통화는 항상 슬래시 앞에, 호가 통화는 항상 슬래시 뒤에 위치합니다. 이는 모든 심볼과 모든 마켓에서 동일합니다.

base currency ↓
             BTC / USDT
             ETH / BTC
            DASH / ETH
                    ↑ quote currency

계약 명명 규칙

현재 통합된 BASE/QUOTE 심볼 스키마로 현물 마켓을 .markets 매핑에 심볼로 인덱싱하여 로드합니다. 이로 인해 현물 마켓과 동일한 심볼을 가진 선물 및 기타 파생 상품에서 명명 충돌이 발생할 수 있습니다. .markets에서 두 가지 유형의 마켓을 모두 수용하려면 '선물' 마켓과 '현물' 마켓 간의 심볼이 구별되어야 하며, '선형' 계약과 '역방향' 계약 간의 심볼도 구별되어야 합니다.

다음 공지사항을 확인하세요: 통합 계약 명명 규칙

CCXT는 다음 유형의 파생 계약을 지원합니다:

• future – 인도/결제 날짜가 있는 만기 선물 계약
• swap – 인도 날짜가 없는 영구 스왑 선물
• option – 옵션 계약 (https://en.wikipedia.org/wiki/Option_contract)

선물(Future)

선물 마켓 심볼은 기초 통화, 호가 통화, 결제 통화 및 임의 식별자로 구성됩니다. 대부분의 경우 식별자는 YYMMDD 형식의 선물 계약 결제일입니다:

//
// base asset or currency
// ↓
// ↓  quote asset or currency
// ↓  ↓
// ↓  ↓    settlement asset or currency
// ↓  ↓    ↓
// ↓  ↓    ↓     identifier (settlement date)
// ↓  ↓    ↓     ↓
// ↓  ↓    ↓     ↓
'BTC/USDT:BTC-211225'  // BTC/USDT futures contract settled in BTC (inverse) on 2021-12-25
'BTC/USDT:USDT-211225' // BTC/USDT futures contract settled in USDT (linear, vanilla) on 2021-12-25
'ETH/USDT:ETH-210625'  // ETH/USDT futures contract settled in ETH (inverse) on 2021-06-25
'ETH/USDT:USDT-210625' // ETH/USDT futures contract settled in USDT (linear, vanilla) on 2021-06-25

무기한 스왑(Perpetual Swap) (무기한 선물)

// base asset or currency
// ↓
// ↓  quote asset or currency
// ↓  ↓
// ↓  ↓    settlement asset or currency
// ↓  ↓    ↓
// ↓  ↓    ↓
'BTC/USDT:BTC'  // BTC/USDT inverse perpetual swap contract funded in BTC
'BTC/USDT:USDT' // BTC/USDT linear perpetual swap contract funded in USDT
'ETH/USDT:ETH'  // ETH/USDT inverse perpetual swap contract funded in ETH
'ETH/USDT:USDT' // ETH/USDT linear perpetual swap contract funded in USDT

옵션(Option)

//
// base asset or currency
// ↓
// ↓  quote asset or currency
// ↓  ↓
// ↓  ↓    settlement asset or currency
// ↓  ↓    ↓
// ↓  ↓    ↓       identifier (settlement date)
// ↓  ↓    ↓       ↓
// ↓  ↓    ↓       ↓   strike price
// ↓  ↓    ↓       ↓   ↓
// ↓  ↓    ↓       ↓   ↓   type, put (P) or call (C)
// ↓  ↓    ↓       ↓   ↓   ↓
'BTC/USDT:BTC-211225-60000-P'  // BTC/USDT put option contract strike price 60000 USDT settled in BTC (inverse) on 2021-12-25
'ETH/USDT:USDT-211225-40000-C' // BTC/USDT call option contract strike price 40000 USDT settled in USDT (linear, vanilla) on 2021-12-25
'ETH/USDT:ETH-210625-5000-P'   // ETH/USDT put option contract strike price 5000 USDT settled in ETH (inverse) on 2021-06-25
'ETH/USDT:USDT-210625-5000-C'  // ETH/USDT call option contract strike price 5000 USDT settled in USDT (linear, vanilla) on 2021-06-25

통합 네트워크

마켓 캐시 강제 새로고침

loadMarkets () / load_markets ()는 거래소 인스턴스에 마켓 배열을 저장하는 부작용이 있는 더티 메서드이기도 합니다. 거래소당 한 번만 호출하면 됩니다. 동일한 메서드에 대한 이후 모든 호출은 로컬에 저장된(캐시된) 마켓 배열을 반환합니다.

거래소 마켓이 로드되면 markets 속성을 통해 언제든지 마켓 정보에 접근할 수 있습니다. 이 속성에는 심볼로 인덱싱된 마켓의 연관 배열이 포함됩니다. 이미 마켓을 로드한 후 마켓 목록을 강제로 새로고침해야 하는 경우, 동일한 메서드에 reload = true 플래그를 다시 전달하세요.

(async () => {
    let kraken = new ccxt.kraken ({ verbose: true }) // log HTTP requests
    await kraken.loadMarkets () // request markets
    console.log (kraken.id, kraken.markets)    // output a full list of all loaded markets
    console.log (Object.keys (kraken.markets)) // output a short list of market symbols
    console.log (kraken.markets['BTC/USD'])    // output single market details
    await kraken.loadMarkets () // return a locally cached version, no reload
    let reloadedMarkets = await kraken.loadMarkets (true) // force HTTP reload = true
    console.log (reloadedMarkets['ETH/BTC'])
}) ()

암묵적 API

• API 메서드 / 엔드포인트
• 암묵적 API 메서드
• 공개/비공개 API
• 동기 vs 비동기 호출
• API 메서드에 파라미터 전달

API 메서드 / 엔드포인트

각 거래소는 API 메서드 집합을 제공합니다. API의 각 메서드를 엔드포인트라고 합니다. 엔드포인트는 다양한 유형의 정보를 조회하기 위한 HTTP URL입니다. 모든 엔드포인트는 클라이언트 요청에 대한 응답으로 JSON을 반환합니다.

일반적으로 거래소에서 마켓 목록을 가져오는 엔드포인트, 특정 마켓의 오더북을 조회하는 엔드포인트, 거래 내역을 조회하는 엔드포인트, 주문을 생성하고 취소하는 엔드포인트, 입출금 엔드포인트 등이 있습니다. 기본적으로 특정 거래소 내에서 수행할 수 있는 모든 종류의 작업에는 API가 제공하는 별도의 엔드포인트 URL이 있습니다.

메서드 집합이 거래소마다 다르기 때문에 ccxt 라이브러리는 다음을 구현합니다:

• 가능한 모든 URL과 메서드에 대한 공개 및 비공개 API
• 공통 메서드의 하위 집합을 지원하는 통합 API

엔드포인트 URL은 각 거래소의 api 속성에 미리 정의되어 있습니다. 새로운 거래소 API를 구현하는 경우가 아니라면 이를 재정의할 필요가 없습니다(적어도 자신이 무엇을 하는지 알아야 합니다).

대부분의 거래소별 API 메서드는 암묵적입니다. 즉, 코드 어디에도 명시적으로 정의되어 있지 않습니다. 라이브러리는 암묵적(비통합) 거래소 API 메서드를 정의하기 위한 선언적 방식을 구현합니다.

암묵적 API 메서드

API의 각 메서드에는 보통 자체 엔드포인트가 있습니다. 라이브러리는 각 특정 거래소의 모든 엔드포인트를 .api 속성에 정의합니다. 거래소 생성 시 .api 엔드포인트 목록의 각 엔드포인트에 대해 거래소 인스턴스의 defineRestApi()/define_rest_api() 내부에 암묵적인 매직 메서드(일명 부분 함수 또는 클로저)가 생성됩니다. 이는 모든 거래소에 대해 보편적으로 수행됩니다. 생성된 각 메서드는 camelCase와 under_score 표기법 모두로 접근할 수 있습니다.

엔드포인트 정의는 거래소가 노출하는 모든 API URL의 전체 목록입니다. 이 목록은 거래소 인스턴스화 시 호출 가능한 메서드로 변환됩니다. API 엔드포인트 목록의 각 URL은 해당하는 호출 가능한 메서드를 가집니다. 이는 모든 거래소에 대해 자동으로 수행되므로 ccxt 라이브러리는 암호화폐 거래소가 제공하는 모든 가능한 URL을 지원합니다.

각 암묵적 메서드는 .api 정의에서 구성된 고유한 이름을 가집니다. 예를 들어, 비공개 HTTPS PUT https://api.exchange.com/order/{id}/cancel 엔드포인트는 .privatePutOrderIdCancel()/.private_put_order_id_cancel()라는 이름의 거래소 메서드를 가집니다. 공개 HTTPS GET https://api.exchange.com/market/ticker/{pair} 엔드포인트는 .publicGetTickerPair()/.public_get_ticker_pair()라는 이름의 메서드를 가집니다.

암묵적 메서드는 파라미터 딕셔너리를 받아 거래소에 요청을 보내고 API에서 거래소별 JSON 결과를 있는 그대로, 파싱하지 않고 반환합니다. 파라미터를 전달하려면 파라미터 이름과 동일한 키 아래에 딕셔너리에 명시적으로 추가하세요. 위의 예시에서는 .privatePutOrderIdCancel ({ id: '41987a2b-...' })과 .publicGetTickerPair ({ pair: 'BTC/USD' })와 같이 사용합니다.

거래소와 작업할 때 권장되는 방식은 거래소별 암묵적 메서드를 사용하는 것이 아니라 통합 ccxt 메서드를 사용하는 것입니다. 거래소별 메서드는 해당 통합 메서드가 아직 사용 가능하지 않은 경우 대안으로 사용해야 합니다.

암묵적 메서드와 통합 메서드를 포함하여 거래소 인스턴스에서 사용 가능한 모든 메서드 목록을 얻으려면 다음과 같이 하면 됩니다:

console.log (new ccxt.kraken ())   // JavaScript
print(dir(ccxt.kraken()))           # Python
var_dump (new \ccxt\kraken ()); // PHP

공개/비공개 API

API URL은 종종 마켓 데이터를 위한 공개 API와 거래 및 계정 접근을 위한 비공개 API라는 두 가지 메서드 집합으로 그룹화됩니다. 이러한 API 메서드 그룹은 일반적으로 'public' 또는 'private'라는 단어가 접두사로 붙습니다.

공개 API는 마켓 데이터에 접근하는 데 사용되며 어떠한 인증도 필요하지 않습니다. 대부분의 거래소는 (속도 제한 하에) 모든 사람에게 마켓 데이터를 공개적으로 제공합니다. ccxt 라이브러리를 사용하면 누구나 거래소에 등록하거나 계정 키와 비밀번호를 설정하지 않고도 바로 마켓 데이터에 접근할 수 있습니다.

공개 API에는 다음이 포함됩니다:

• 상품/거래 페어
• 가격 피드(환율)
• 오더북(L1, L2, L3...)
• 거래 내역(체결 주문, 트랜잭션, 실행)
• 티커(현물 / 24시간 가격)
• 차트용 OHLCV 시리즈
• 기타 공개 엔드포인트

비공개 API는 주로 거래 및 계정별 비공개 데이터에 접근하는 데 사용되므로 인증이 필요합니다. 거래소에서 비공개 API 키를 발급받아야 합니다. 이는 종종 거래소 웹사이트에 등록하고 계정에 대한 API 키를 생성하는 것을 의미합니다. 대부분의 거래소는 개인 정보나 신원 확인을 요구합니다. 일부 거래소는 KYC 인증 완료 후에만 거래를 허용합니다. 비공개 API를 통해 다음을 수행할 수 있습니다:

• 개인 계정 정보 관리
• 계정 잔액 조회
• 시장가 및 지정가 주문으로 거래
• 입금 주소 생성 및 계정 자금 추가
• 법정화폐 및 암호화폐 출금 요청
• 개인 미체결/체결 주문 조회
• 마진/레버리지 거래 포지션 조회
• 원장 내역 조회
• 계정 간 자금 이체
• 판매자 서비스 이용

일부 거래소는 동일한 로직을 다른 이름으로 제공합니다. 예를 들어, 공개 API는 market data, basic, market, mapi, api, price 등으로도 불립니다. 이 모두는 공개적으로 사용 가능한 데이터에 접근하기 위한 메서드 집합을 의미합니다. 비공개 API는 trading, trade, tapi, exchange, account 등으로도 불립니다.

일부 거래소는 고객으로부터 인보이스를 생성하고 암호화폐 및 법정화폐 결제를 수락할 수 있는 판매자 API도 노출합니다. 이러한 종류의 API는 종종 merchant, wallet, payment, ecapi(전자상거래용)라고 불립니다.

거래소 인스턴스에서 사용 가능한 모든 메서드 목록을 얻으려면 다음과 같이 하면 됩니다:

console.log (new ccxt.kraken ())   // JavaScript
print(dir(ccxt.kraken()))           # Python
var_dump (new \ccxt\kraken ()); // PHP

계약 전용 및 마진 전용

• 이 문서에서 계약 전용 또는 마진 전용으로 표시된 메서드는 각각 계약 거래 및 마진 거래에만 사용하도록 의도되어 있습니다. 다른 유형의 마켓에서 거래할 때도 작동할 수 있지만 관련 없는 정보를 반환할 가능성이 높습니다.

동기 vs 비동기 호출

Javascript

CCXT의 JavaScript 버전에서는 모든 메서드가 비동기적이며 디코딩된 JSON 객체로 resolve되는 Promises를 반환합니다. CCXT에서는 Promises를 다루기 위해 현대적인 async/await 문법을 사용합니다. 해당 문법에 익숙하지 않다면 여기에서 더 자세히 읽을 수 있습니다.

// JavaScript

(async () => {
    let pairs = await kraken.publicGetSymbolsDetails ()
    let marketIds = Object.keys (pairs['result'])
    let marketId = marketIds[0]
    let ticker = await kraken.publicGetTicker ({ pair: marketId })
    console.log (kraken.id, marketId, ticker)
}) ()

Python

ccxt 라이브러리는 async/await 문법을 사용하여 Python 3.5+에서 비동기 동시성 모드를 지원합니다. 비동기 Python 버전은 aiohttp와 함께 순수 asyncio를 사용합니다. 비동기 모드에서는 동일한 속성과 메서드를 모두 가지지만 대부분의 메서드에 async 키워드가 데코레이터로 붙습니다. 비동기 모드를 사용하려면 다음 예시와 같이 ccxt.async_support 서브패키지에 링크해야 합니다:

# Python

import asyncio
import ccxt.async_support as ccxt

async def print_poloniex_ethbtc_ticker():
    poloniex = ccxt.poloniex()
    print(await poloniex.fetch_ticker('ETH/BTC'))
    await polonix.close()  # close the exchange instance when you don't need it anymore

asyncio.run(print_poloniex_ethbtc_ticker())

PHP

CCXT는 PHP 8+ 버전을 지원합니다. 라이브러리에는 동기 및 비동기 버전이 모두 있습니다. 동기 버전을 사용하려면 \ccxt 네임스페이스(즉, new ccxt\binance())를 사용하고, 비동기 버전을 사용하려면 \ccxt\async 네임스페이스(즉, new ccxt\async\binance())를 사용하세요. 비동기 버전은 백그라운드에서 ReactPHP 라이브러리를 사용합니다. 비동기 모드에서는 동일한 속성과 메서드를 모두 가지지만 모든 네트워킹 API 메서드는 \React\Async\await 키워드로 데코레이터를 달아야 하며 스크립트는 ReactPHP 래퍼 안에 있어야 합니다:

// PHP
<?php
include 'vendor/autoload.php';

use function React\Async\await;

$okx = new \ccxt\async\okx();
while (true) {
    $result = await($okx->fetch_ticker('ETH/BTC'));
    var_dump($result);
}

examples/php 디렉토리에서 추가 예시를 확인하세요. async 단어가 포함된 파일명을 찾아보세요. 또한 composer require recoil/recoil clue/buzz-react react/event-loop recoil/react react/http를 사용하여 필요한 의존성을 설치했는지 확인하세요. 마지막으로, 이 글은 여기서 사용된 메서드에 대한 좋은 소개를 제공합니다. 문법적으로 변경이 간단하지만(즉, 관련 메서드 앞에 yield 키워드만 사용), 동시성은 코드의 전체적인 설계에 중요한 영향을 미칩니다.

Go

Go에서 모든 네트워킹 메서드는 동기적이며 (value, error) 쌍을 반환합니다 — 비동기 변형이 없습니다. 값을 사용하기 전에 반환된 error를 항상 확인하세요:

// Go

exchange := ccxt.NewKraken(nil)
ticker, err := exchange.FetchTicker("ETH/BTC")
if err != nil {
    fmt.Println(err)
    return
}
fmt.Println(exchange.GetId(), ticker.Last)

C#

C#에서 모든 네트워킹 메서드는 비동기적이며 await하는 Task<T>를 반환합니다. 통합 메서드는 네이티브 async/await를 사용합니다:

// C#

var exchange = new Kraken();
var ticker = await exchange.FetchTicker("ETH/BTC");
Console.WriteLine(exchange.id + " " + ticker.last);

Java

Java에서 각 거래소는 자체 타입이 지정된 서브클래스를 가집니다. 모든 타입이 지정된 메서드는 블로킹 동기 오버로드와 비블로킹 CompletableFuture를 반환하는 비동기 오버로드를 모두 제공합니다 — REST fetch* / fetch*Async 및 WS watch* / watch*Async에 대해 대칭적입니다:

// Java

import io.github.ccxt.exchanges.Kraken;
import io.github.ccxt.types.Ticker;
import java.util.concurrent.CompletableFuture;

Kraken kraken = new Kraken();
kraken.loadMarkets(false);

// REST — synchronous
Ticker ticker = kraken.fetchTicker("BTC/USDT");
System.out.println(ticker.last);

// REST — asynchronous
CompletableFuture<Ticker> future = kraken.fetchTickerAsync("BTC/USDT", null);
future.thenAccept(t -> System.out.println(t.last));

동일한 동기/비동기 쌍은 pro(WebSocket) 클래스에도 적용됩니다 — watchTicker는 하나의 업데이트를 위해 블로킹하고; watchTickerAsync는 다음 업데이트 시 완료되는 CompletableFuture<Ticker>를 반환합니다:

import io.github.ccxt.exchanges.pro.Binance;

var ws = new Binance();
ws.loadMarkets(false);

// WS — synchronous (blocks for one update)
Ticker tick = ws.watchTicker("BTC/USDT");

// WS — asynchronous (composable with allOf, anyOf, thenApply, ...)
CompletableFuture<Ticker> stream = ws.watchTickerAsync("BTC/USDT", null);

반환된 JSON 객체

모든 공개 및 비공개 API 메서드는 거래소에서 있는 그대로, 수정 없이 원시 디코딩된 JSON 객체를 응답으로 반환합니다. 통합 API는 모든 거래소에 걸쳐 공통 형식으로 균일하게 구조화된 JSON 디코딩 객체를 반환합니다.

API 메서드에 파라미터 전달

가능한 모든 API 엔드포인트 집합은 거래소마다 다릅니다. 대부분의 메서드는 키-값 파라미터의 단일 연관 배열(또는 Python dict)을 받습니다. 파라미터는 다음과 같이 전달됩니다:

bitso.publicGetTicker ({ book: 'eth_mxn' })                 // JavaScript
ccxt.zaif().public_get_ticker_pair ({ 'pair': 'btc_jpy' })  # Python
$luno->public_get_ticker (array ('pair' => 'XBTIDR'));      // PHP

거래소의 통합 메서드는 다음과 같이 기능에 영향을 미치는 다양한 params를 예상하고 수락할 수 있습니다:

params = {'type':'margin', 'isIsolated': 'TRUE'}  # --------------┑
# params will go as the last argument to the unified method       |
#                                                                 v
binance.create_order('BTC/USDT', 'limit', 'buy', amount, price, params)

거래소는 다른 거래소의 파라미터를 수락하지 않으며, 서로 호환되지 않습니다. 수락되는 파라미터 목록은 각 특정 거래소에 의해 정의됩니다.

통합 메서드에 전달할 수 있는 파라미터를 찾으려면:

• 거래소별 구현 파일을 열고 원하는 함수(예: createOrder)를 검색하여 params 사용법의 세부 사항을 확인하거나
• 거래소의 API 문서로 이동하여 특정 함수나 엔드포인트(예: order)에 대한 파라미터 목록을 읽어보세요

각 거래소의 허용되는 메서드 파라미터 전체 목록은 API 문서를 참조하십시오.

API 메서드 명명 규칙

거래소 메서드 이름은 유형(공개 또는 비공개), HTTP 메서드(GET, POST, PUT, DELETE), 엔드포인트 URL 경로를 연결한 문자열로, 아래 예시와 같습니다:

ccxt 라이브러리는 카멜케이스 표기법(JavaScript에서 선호)과 언더스코어 표기법(Python 및 PHP에서 선호)을 모두 지원하므로, 모든 메서드는 어느 언어에서든 두 가지 표기법이나 코딩 스타일로 호출할 수 있습니다. 다음 두 가지 표기법 모두 JavaScript, Python, PHP에서 작동합니다:

exchange.methodName ()  // camelcase pseudocode
exchange.method_name()  // underscore pseudocode

거래소 인스턴스에서 사용 가능한 모든 메서드 목록을 가져오려면 다음과 같이 하면 됩니다:

console.log (new ccxt.kraken ())   // JavaScript
print(dir(ccxt.hitbtc()))           # Python
var_dump (new \ccxt\okcoin ()); // PHP

통합 API

• 통합 API 파라미터 재정의
• 페이지네이션
• 자동 페이지네이션

통합 ccxt API는 거래소들 간에 공통적인 메서드의 부분집합입니다. 현재 다음과 같은 메서드들을 포함하고 있습니다:

• fetchMarkets (): 거래소에서 사용 가능한 모든 시장 목록을 가져와 시장 구조에 정의된 Market 객체 배열(symbol, base, quote 등의 속성 포함)을 반환합니다. 일부 거래소는 온라인 API를 통해 시장 목록을 얻는 수단이 없습니다. 해당 거래소의 경우 시장 목록이 하드코딩되어 있습니다.
• fetchCurrencies (): 거래소에서 사용 가능한 모든 통화를 가져와 통화의 연관 딕셔너리(code, name 등의 속성을 가진 객체)를 반환합니다. 일부 거래소는 온라인 API를 통해 통화를 얻는 수단이 없습니다. 해당 거래소의 경우 통화는 마켓 페어에서 추출되거나 하드코딩됩니다.
• loadMarkets ([reload]): 심볼로 인덱싱된 객체로 시장 목록을 반환하고 거래소 인스턴스와 함께 캐싱합니다. 이미 로드된 경우 캐시된 시장을 반환하며, reload = true 플래그가 강제되지 않는 한 그대로 유지됩니다.
• fetchOrderBook (symbol, limit = undefined, params = {}): 특정 마켓 거래 심볼에 대한 L2/L3 호가창을 가져옵니다.
• fetchStatus (params = {}): 거래소 인스턴스에 하드코딩된 정보 또는 API(사용 가능한 경우)에서 거래소 상태에 관한 정보를 반환합니다.
• fetchL2OrderBook (symbol, limit = undefined, params): 특정 심볼에 대한 레벨 2(가격 집계) 호가창입니다.
• fetchTrades (symbol, since, limit, params): 특정 거래 심볼의 최근 거래 내역을 가져옵니다.
• fetchTicker (symbol): 거래 심볼별 최신 티커 데이터를 가져옵니다.
• fetchBalance (): 잔고를 가져옵니다.
• createOrder (symbol, type, side, amount, price, params)
• createOrders(orders, params)
• createLimitBuyOrder (symbol, amount, price, param)
• createLimitSellOrder (symbol, amount, price, param)
• createMarketBuyOrder (symbol, amount, param)
• createMarketSellOrder (symbol, amount, param)
• cancelOrder (id, symbol, params)
• fetchOrder (id, symbol, params)
• fetchOrders (symbol, since, limit, params)
• fetchOpenOrders (symbol, since, limit, params)
• fetchCanceledOrders (symbol, since, limit, params)
• fetchClosedOrders (symbol, since, limit, params)
• fetchMyTrades (symbol, since, limit, params)
• fetchOpenInterest (symbol, params)
• fetchVolatilityHistory (code, params)
• fetchUnderlyingAssets ()
• fetchSettlementHistory (symbol, since, limit, params)
• fetchLiquidations (symbol, since, limit, params)
• fetchMyLiquidations (symbol, since, limit, params)
• fetchGreeks (symbol, params)
• fetchAllGreeks (symbols, params)
• fetchCrossBorrowRate (code, params)
• fetchCrossBorrowRates (params)
• fetchIsolatedBorrowRate (symbol, params)
• fetchIsolatedBorrowRates (params)
• fetchOption (symbol, params)
• fetchOptionChain (code, params)
• fetchConvertQuote (fromCode, toCode, amount, params)
• createConvertTrade (id, fromCode, toCode, amount, params)
• fetchFundingRate (symbol, params)
• fetchFundingRates (symbols, params)
• fetchFundingRateHistory (symbol, since, limit, params)
• fetchFundingRateInterval (symbol, params)
• fetchFundingRateIntervals (symbols, params)
• fetchLongShortRatio (symbol, params)
• fetchAutoDeLeverageRank (symbol, params)
• fetchPositionAutoDeLeverageRank (symbol, params)
• fetchPositionsAutoDeLeverageRank (symbols, params)
• ...

TODO: better formatting

통합 API 파라미터 재정의

대부분의 통합 API 메서드는 선택적 params 인수를 받습니다. 이는 재정의하려는 파라미터를 담은 연관 배열(딕셔너리, 기본값은 비어있음)입니다. params의 내용은 거래소별로 다르므로, 지원되는 필드와 값은 거래소의 API 문서를 참조하십시오. 통합 쿼리에 사용자 정의 설정이나 선택적 파라미터를 전달해야 할 경우 params 딕셔너리를 사용하십시오.

(async () => {

    const params = {
        'foo': 'bar',      // exchange-specific overrides in unified queries
        'Hello': 'World!', // see their docs for more details on parameter names
    }

    // the overrides go into the last argument to the unified call ↓ HERE
    const result = await exchange.fetchOrderBook (symbol, length, params)
}) ()

페이지네이션

대부분의 통합 메서드는 단일 객체 또는 객체의 일반 배열(거래, 주문, 트랜잭션 등의 목록)을 반환합니다. 그러나 모든 주문, 모든 거래, 모든 OHLCV 캔들 또는 모든 트랜잭션을 한 번에 반환하는 거래소는 거의 없습니다(있더라도 극히 드뭅니다). 대부분의 거래소 API는 가장 최근 객체의 일정 수로 출력을 limit합니다. 단 한 번의 호출로 시간의 시작부터 현재까지 모든 객체를 가져올 수는 없습니다. 실질적으로 이를 허용하거나 용인하는 거래소는 매우 드뭅니다.

과거 주문이나 거래 내역을 가져오려면 사용자가 데이터를 조각(또는 객체의 "페이지") 단위로 순회해야 합니다. 페이지네이션은 종종 루프 안에서 *"데이터 조각을 하나씩 가져오는 것"*을 의미합니다.

대부분의 경우 사용자는 일관된 결과를 얻기 위해 최소한 어느 정도의 페이지네이션을 사용해야 합니다. 사용자가 페이지네이션을 적용하지 않으면 대부분의 메서드는 거래소의 기본값을 반환하는데, 이는 역사의 시작부터 시작되거나 최근 객체의 일부일 수 있습니다. (페이지네이션 없이) 기본 동작은 거래소마다 다릅니다! 페이지네이션 수단은 특히 다음 메서드들과 함께 자주 사용됩니다:

• fetchTrades()
• fetchOHLCV()
• fetchOrders()
• fetchCanceledOrders()
• fetchClosedOrder()
• fetchClosedOrders()
• fetchOpenOrder()
• fetchOpenOrders()
• fetchMyTrades()
• fetchTransactions()
• fetchDeposit()
• fetchDeposits()
• fetchWithdrawals()

객체 목록을 반환하는 메서드에서 거래소는 하나 이상의 페이지네이션 유형을 제공할 수 있습니다. CCXT는 기본적으로 날짜 기반 페이지네이션을 통합하며, 라이브러리 전체에서 타임스탬프는 밀리초 단위입니다.

자동 페이지네이션

경고: 이 기능은 실험적이며 일부 경우에 예상치 못하거나 잘못된 결과를 생성할 수 있습니다.

최근 CCXT는 params 안에 paginate 플래그만 제공하면 여러 결과를 자동으로 페이지네이션하는 방법을 도입했습니다. 이를 통해 사용자 영역에서의 작업이 줄어듭니다. 대부분의 주요 거래소가 이를 지원하며 앞으로 더 많은 거래소가 추가될 예정이지만, 확인하는 가장 쉬운 방법은 메서드의 문서에서 pagination 파라미터를 검색하는 것입니다. 항상 예외는 있으며, 일부 엔드포인트는 타임스탬프나 커서를 통한 페이지네이션 방법을 제공하지 않을 수 있고, 그런 경우 CCXT로는 해결할 방법이 없습니다.

현재 세 가지 다른 페이지네이션 방식이 있습니다:

• 동적/시간 기반: until 및 since 파라미터를 사용하여 동적 결과(거래, 주문, 트랜잭션 등)를 페이지네이션합니다. 가져올 수 있는 항목 수를 사전에 알 수 없으므로, 데이터의 끝에 도달하거나 최대 페이지네이션 호출 수(옵션으로 구성 가능)에 도달할 때까지 한 번에 하나씩 요청을 수행합니다.
• 결정론적: 각 페이지의 경계를 미리 계산할 수 있을 때, 최대 성능을 위해 요청을 동시에 수행합니다. OHLCV, 펀딩 레이트, 미결제약정에 적용되며 paginationCalls 옵션도 적용됩니다.
• 커서 기반: 거래소가 응답 내에 커서를 제공할 때, 커서를 추출하여 데이터의 끝에 도달하거나 최대 페이지네이션 호출 수에 도달할 때까지 후속 요청을 수행합니다.

사용자는 페이지네이션 방법을 선택할 수 없으며, 거래소 API의 기능을 고려하여 구현마다 다르게 결정됩니다.

페이지네이션 파라미터

무한한 수의 요청을 수행할 수 없으며, 일부는 다양한 이유로 오류를 발생시킬 수 있으므로, 사용자가 이러한 변수 및 기타 페이지네이션 세부 사항을 제어할 수 있는 몇 가지 옵션이 있습니다.

아래의 모든 옵션은 params 내에 제공해야 합니다. 아래 예시에서 확인할 수 있습니다

• paginate: (boolean) 사용자가 더 많은 데이터를 얻기 위해 여러 페이지를 페이지네이션하려는 것을 나타냅니다. 기본값은 false입니다.
• paginationCalls: (integer) 데이터를 페이지네이션하기 위한 최대 요청 수를 제어할 수 있습니다. 레이트 제한으로 인해 이 값은 너무 높게 설정하지 않는 것이 좋습니다. 기본값은 10입니다.
• maxRetries: (integer) 오류 발생 시 페이지네이션 메커니즘이 재시도하는 횟수입니다. 기본값은 3입니다.
• paginationDirection: (string) 동적 페이지네이션에만 적용되며, forward(과거의 특정 시점부터 시작하여 앞으로 페이지네이션) 또는 backward(가장 최근 시간부터 시작하여 뒤로 페이지네이션)일 수 있습니다. forward가 선택되면 since 파라미터도 반드시 제공해야 합니다. 기본값은 backward입니다.
• maxEntriesPerRequest: (integer): 호출당 검색되는 데이터를 최대화하기 위한 요청당 최대 항목 수입니다. 엔드포인트마다 다르며 CCXT가 이 값을 채워줍니다. 필요한 경우 재정의할 수 있습니다.

예시

trades = await binance.fetch_trades("BTC/USDT", params = {"paginate": True}) # dynamic/time-based

ohlcv = await binance.fetch_ohlcv("BTC/USDT", params = {"paginate": True, "paginationCalls": 5}) # deterministic-pagination will perform 5 requests

trades = await binance.fetch_trades("BTC/USDT", since = 1664812416000, params = {"paginate": True, "paginationDirection": "forward"}) # dynamic/time-based pagination starting from 1664812416000

ledger = await bybit.fetch_ledger(params = {"paginate": True}) # bybit returns a cursor so the pagination will be cursor-based

funding_rates = await binance.fetch_funding_rate_history("BTC/USDT:USDT", params = {"paginate": True, "maxEntriesPerRequest": 50}) # customizes the number of entries per request