ccxt_skill

Overview

This skill provides practical guidance for using CCXT, the multi-language cryptocurrency trading library for exchange APIs, market data, orders, and automation across 150+ exchanges. It focuses on common patterns, options, and pitfalls developers face when integrating trading, spot, margin, and derivatives features. Use it to accelerate reliable integrations and troubleshoot typical issues without risking funds.

How this skill works

The skill inspects CCXT usage patterns, common configuration flags, and method behaviors (createOrder, market buys, conditional orders, reduceOnly, funding rates, etc.). It explains how CCXT maps unified methods to exchange-specific endpoints, how feature flags and options affect behavior, and what debugging output to collect. It also highlights recommended parameters, error-reporting steps, and where to check exchange capabilities (exchange.has and exchange.features).

When to use it

• Integrating a new exchange or building cross-exchange tooling
• Placing, canceling, or managing spot, margin, and futures orders programmatically
• Debugging unexpected order behavior or API errors
• Designing automated trading strategies or backtesting connectors
• Checking whether an exchange supports specific order types or features

Best practices

• Always call await exchange.loadMarkets() before trading to populate market metadata
• Enable verbose logging (exchange.verbose = true) when debugging and include full request/response output
• Report issues with a minimal reproducible snippet, CCXT version, language/runtime version, exchange, and full stacktrace
• Check exchange.has and exchange.features for support of specialized methods (e.g., createMarketBuyOrderWithCost, createStopLossOrder) rather than assuming behavior
• Never post API keys or secrets; redact credentials from any shared logs

Example use cases

• Place a spot market buy considering createMarketBuyRequiresPrice or use createMarketBuyOrderWithCost when supported
• Create reduceOnly orders for closing positions on derivatives markets using params={'reduceOnly': True}
• Attach takeProfit and stopLoss to a position when the exchange supports attached orders, otherwise submit separate conditional orders
• Load and inspect market contractSize for perp/swap symbols before sizing orders
• Collect verbose exchange requests/responses to debug mismatched results or unexpected error codes