CopySonar Product Documentation

CopySonar helps you discover signals, evaluate lead trader performance, and configure paper or live copy-trading tasks according to your own parameters. This documentation covers basic workflows, parameter definitions, and operational boundaries. Actual available features and account permissions are subject to your current product UI.

This guide is designed for beta users exploring CopySonar for the first time: after reading it, you should be able to independently complete the full journey — from understanding a lead trader report and binding exchange APIs, to launching a paper copy task, deciding when live copy is appropriate, and knowing where to check when an issue occurs — without needing engineering support.

Three core boundaries apply across the entire documentation:

• This documentation describes system behavior, not profit guarantees. Leaderboard rankings, resilience scores, and simulated returns do not represent or guarantee future earnings.
• This documentation does not supersede UI prompts. Specific parameter ranges, account quotas, pre-flight warnings, and task statuses are governed by the live interface and server responses. When a discrepancy occurs, the live UI takes precedence.
• This documentation will never ask for your credentials. Any "customer service", "documentation", or "tutorial" requesting your API Key, Secret, or Passphrase is fraudulent.

Documentation Map

Page	When to Read	Stable docId
Getting Started	First time in the product; clarifying signals, paper copy, and live copy	getting-started
Add Exchange API	Preparing for live copy; connecting your exchange account	exchange-api
Create Copy · Parameters	Selecting a lead trader; configuring capital, positions, and risk limits	create-copy
FAQ	Binding failures, zero fills, or numerical discrepancies	faq
Safety & Funds	Understanding where funds reside, permission boundaries, and incident response	safety

In-site docIds are stable identifiers (e.g. create-copy.entry-risk). Product UI help tooltips link directly to these chapters. Titles may be adjusted, but identifiers remain unchanged, ensuring links in bookmarks and support tickets remain permanently valid.

Core Concepts: Understand the Entire Product in Five Terms

When first opening the product, these five terms are most commonly conflated. They often appear on the same screen, but carry distinct meanings:

Concept	What It Is	What It Is Not
Signal / Lead Trader	A trader identified in public Binance/OKX lead trading data, along with their open/close position actions	Not a platform-guaranteed "winning account"; top rankings do not equal future profits
Paper Copy (Simulation)	Simulated execution using live market data without sending any actual orders to the exchange	Not an identical rehearsal of live trading; fill prices, slippage, and fee impacts differ
Live Copy	Automated order execution in your exchange account via authorized APIs	Not managed fund custody; capital always stays in your personal exchange account
Allocated Capital	The copy trading capacity allocated to this task to calculate position sizing	Not margin occupied, nor the maximum potential loss
Risk Budget / Drawdown Stop	The threshold at which the system stops opening new risk positions	Not a stop-loss guarantee, nor an automatic market liquidation

Once you understand these five terms, the remaining settings are simply combinations. You only need to determine two things: is this lead trader worth following, and how much risk are you willing to take for this task.

Where to Start

For first-time users, we recommend reading in this sequence:

1. Getting Started: Understand the distinction between signals, simulation, and live execution.
2. Add Exchange API: Connect an account only when you are ready for live copy trading.
3. Create Copy · Parameters: Understand capital, position sizing, entry criteria, and risk parameters.

If you only have time to read one page, start with Safety & Funds. It explains where funds stay, how API permissions must be configured, and which emergency actions cause irreversible effects.

Recommended operational workflow (the first two steps require zero API keys):

1. Register and sign in. An invitation code is required during internal beta. Sign up with email (you will receive a verification link and set a password), or use Google Sign-In. Check the registration screen for invite details.
2. Scan lead traders. Navigate to lead trader reports from the Rankings or Sonar Radar. Check data freshness, drawdowns, and position visibility before deciding whether to proceed.
3. Run paper copy first. Create a simulated task with your desired parameters. Observe entry cadence, missed trade reasons, and slippage for several days. Paper copy requires no API Key.
4. Bind API and go live. Once parameters feel comfortable, bind an API Key with Read + Futures Trading permissions as described in Add Exchange API, and start your first live task with modest capital.
5. Monitor continuously. Live copy is not "set and forget." Checking positions, fills, and missed trade logs in task details daily is far more effective than post-incident reviews.

TODO 素材：此处补「从信号榜单到跟单任务的导航路径」录屏

Troubleshooting & Help

When encountering binding failures, zero fills, or abnormal task states, consult FAQ first. For questions regarding funds, permissions, or revoking connections, read Safety & Funds. Never paste your API Key, Secret, or Passphrase in support messages.

Always follow the three-step diagnostic sequence: "UI Prompt → Task Details → Exchange Status":

Symptom	Check Here First	Common Causes
Key binding fails	API Binding Failures	Permission mismatch, missing IP whitelist, missing OKX passphrase, account not in hedge mode
Cannot create live copy	Why Live Copy Is Unavailable	No live invite, expired authorization, insufficient capital quota, expired key check
Task running but no fills	Running but No Trades	No new signals, whitelist/direction filter, slippage limit too tight, chase window too short
Numbers differ from expectation	Why Simulation, Task PnL, and Balances Differ	Conflating different metrics: paper / effective capital / margin / equity / funding fees
Unknown trades or suspected leak	How to Handle Anomalies	Check exchange orders and authorization first, then handle task and keys

When submitting feedback, provide: time of occurrence (with timezone), exact on-screen error text, task ID, and redacted screenshots. Never send full API Keys, Secrets, Passphrases, verification codes, or account passwords. Official support email: support@copysonar.com.

Understand the Risks Before Using

Simulated trading does not route orders to exchanges, and its results do not guarantee live profitability. Once started, live copy automatically submits orders according to signals; leverage, slippage, liquidity fluctuations, and extreme market volatility can result in total capital loss. Historical rankings and scores do not constitute profit guarantees or investment advice.

Three market realities must be recognized:

• Execution discrepancies are inevitable. There will always be latency and slippage between your fills and the lead trader's fills. This friction is magnified during choppy market conditions. Median latency, average slippage, and follow rates in task details quantify this reality.
• Risk controls mitigate losses; they are not insurance. Drawdown stops and risk budgets halt new risk additions and allow position reduction/closure, but they do not liquidate at market for you. Actual loss may exceed the budget.
• The product is in beta. Systems may experience delays, outages, or data anomalies. Only deploy capital you can afford to lose entirely, and always retain the ability to manage positions directly on the exchange.

This service is not available to residents of Mainland China. Please confirm compliance with local laws and exchange terms before use. See the in-app risk disclosure, terms of service, and privacy policy for full legal agreements.