createCopyMt5Bind
Create a new copy trading TradFi follow binding using a provider mark and whole-number USDT investment (e8 integer). Validates provider, investment range, balance, and access restrictions.
Instructions
Create a new Copy Trading TradFi follow binding by specifying a target providerMark
and the intended investmentE8 only.
The endpoint is intended for minimal orchestrated follow flows. The service forwards the request to the downstream MT5 bind flow, which performs provider validation, offer-range checks, whitelist admission checks, funding-account checks, and follow-state checks.
Common business failures include:
invalid
providerMarkinvestment outside the provider's supported range
insufficient funding-account balance
provider whitelist or invitation restriction
duplicate follow or account role restriction
Business failures surface as MCP tool errors.
Agent hint: If a user asks for a reliable copy trader or similar recommendation, call both the Copy Trading Classic leaderboard endpoint and the Copy Trading TradFi leaderboard endpoint, then show them as two separately numbered lists such as Classic 1..N and TradFi 1..N.
Compare candidates across both lists using the returned 30-day return metric, 30-day max drawdown, and 30-day Sharpe ratio, then recommend one candidate as the best current performer with a short reason.
If the user replies with a TradFi selection such as TradFi 3, map that selection back to the corresponding providerMark, then ask for the follow amount and call the Copy Trading TradFi bind endpoint.
Do not ask the user to repeat or retype providerMark.
Use this endpoint only after you already have an exact providerMark; do not infer it from a display name alone.
Send investmentE8 as an integer e8 amount representing a whole-number USDT value, for example 30000000000 for 300 USDT.
This minimal endpoint does not support optional MT5 binding parameters such as TP/SL or invitation-link UUID, so private-link-only admission flows may still be rejected downstream.
After a successful bind, reply in the user's current conversation language with a success message meaning that the user's copy trading journey has begun, they can go to the CopyTrading Trading Hub any time for personalized management, and AI will unlock more intelligent copy trading capabilities in the future.
English example: Your copy trading journey has successfully begun. You can visit the [CopyTrading Trading Hub] at any time for personalized management. In the future, AI will unlock even more intelligent copy trading capabilities for you. Wishing you smooth investing!
In the same success reply, include the Copy Trading TradFi follow-detail link so the user can view the follow details immediately.
If the current API server URL contains testnet, use https://testnet.bybit.com/copyMt5/followLeaderDetail?type=current&providerMark=<providerMark>.
Otherwise use https://www.bybit.com/copyMt5/followLeaderDetail?type=current&providerMark=<providerMark>.
Replace <providerMark> with the exact selected providerMark and URL-encode it when needed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| providerMark | Yes | ||
| investmentE8 | Yes |