Create Copy Trade

POST

copy-trades

curl --request POST \
  --url https://api.copin.io/copy-trades \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "<string>",
  "volume": 123,
  "account": "<string>",
  "leverage": 123,
  "protocol": "<string>",
  "exchange": "<string>",
  "copyWalletId": "<string>",
  "type": "<string>",
  "excludingTokenAddresses": [
    {}
  ],
  "tokenAddresses": [
    {}
  ],
  "reverseCopy": true,
  "enableStopLoss": true,
  "stopLossType": "<string>",
  "stopLossAmount": 123,
  "volumeProtection": true,
  "lookBackOrders": 123,
  "enableTakeProfit": true,
  "takeProfitType": "<string>",
  "takeProfitAmount": 123,
  "maxVolMultiplier": 123,
  "skipLowLeverage": true,
  "lowLeverage": 123,
  "skipLowCollateral": true,
  "lowCollateral": 123,
  "skipLowSize": true,
  "lowSize": 123,
  "copyAll": true,
  "hasExclude": true,
  "multipleCopy": true,
  "side": "<string>"
}'

{
  "id": "<string>",
  "title": "<string>",
  "userId": "<string>",
  "account": "<string>",
  "accounts": [
    {}
  ],
  "copyWalletId": "<string>",
  "tokenAddresses": [
    {}
  ],
  "stopLossType": "<string>",
  "enableStopLoss": true,
  "stopLossAmount": 123,
  "takeProfitType": "<string>",
  "enableTakeProfit": true,
  "takeProfitAmount": 123,
  "maxVolMultiplier": 123,
  "leverage": 123,
  "volume": 123,
  "volumeProtection": true,
  "lookBackOrders": 123,
  "reverseCopy": true,
  "skipLowLeverage": true,
  "lowLeverage": 123,
  "skipLowCollateral": true,
  "lowCollateral": 123,
  "skipLowSize": true,
  "lowSize": 123,
  "copyAll": true,
  "status": "<string>",
  "multipleCopy": true,
  "exchange": "<string>",
  "side": "<string>",
  "type": "<string>",
  "protocol": "<string>",
  "excludingTokenAddresses": [
    {}
  ],
  "createdAt": "<string>"
}

Authentication

This endpoint requires authentication using a JWT token in the Authorization header.

Authorization

string

required

JWT token in the format: Authorization {token}

Request Body

title

string

required

Display name for the copy trade configuration

volume

number

required

Volume amount to use for copied trades

account

string

required

Address of the account to copy trades from

leverage

number

required

Leverage setting for copied trades

protocol

string

required

Protocol to use for copy trading (e.g., “KILOEX_OPBNB”)

exchange

string

required

Exchange platform to use (e.g., “HYPERLIQUID”)

copyWalletId

string

required

ID of the wallet to use for copy trading

type

string

required

Type of copy trading (e.g., “COPY_TRADER”)

excludingTokenAddresses

array

required

List of token addresses to exclude from copying

tokenAddresses

array

required

List of specific token addresses to copy trades for

reverseCopy

boolean

default:"false"

Whether to copy trades in reverse (opposite direction)

enableStopLoss

boolean

default:"false"

Enable automatic stop loss for copied positions

stopLossType

string

default:"USD"

Type of stop loss calculation (e.g., “PERCENT”, “USD”)

stopLossAmount

number

Value for stop loss (percentage or fixed amount)

volumeProtection

boolean

default:"true"

Enable volume protection to prevent over-sized positions

lookBackOrders

number

Number of past orders to analyze when starting copy trade

enableTakeProfit

boolean

default:"false"

Enable automatic take profit for copied positions

takeProfitType

string

default:"USD"

Type of take profit calculation (e.g., “PERCENT”, “USD”)

takeProfitAmount

number

Value for take profit (percentage or fixed amount)

maxVolMultiplier

number

Maximum volume multiplier for copied trades

skipLowLeverage

boolean

default:"false"

Skip copying trades with leverage below a threshold

lowLeverage

number

Minimum leverage threshold for copied trades

skipLowCollateral

boolean

default:"false"

Skip copying trades with collateral below a threshold

lowCollateral

number

Minimum collateral threshold for copied trades

skipLowSize

boolean

default:"false"

Skip copying trades with size below a threshold

lowSize

number

Minimum size threshold for copied trades

copyAll

boolean

default:"true"

Whether to copy all trades from the account

hasExclude

boolean

default:"false"

Whether exclusion rules are applied

multipleCopy

boolean

default:"false"

Whether to enable multiple copying from various accounts

side

string

default:"BOTH"

Which trade sides to copy (e.g., “BOTH”, “LONG”, “SHORT”)

Request Example

curl --request POST \
--url "https://api.copin.io/copy-trades" \
--header 'Content-Type: application/json' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IjB4MTUzNTQ4NGMxRWVjMUQyMDNmRTFBNTNFQTExYTYyMWE4ODRBRTA2NyIsInRpbWUiOjE3NDQ2MjYxNjIzODksImFjY2VzcyI6IlVmTkNiTWhMVVMxNzQ0NjI2MTYyMzkwIiwiaWF0IjoxNzQ0NjI2MTYyLCJleHAiOjE3NDUyMzA5NjJ9.LpvhBdxyfehzom-v5tKumAqCptSMkVk7HVKKVtjSpk8' \
--data '{
  "title": "Fish",
  "volume": 10,
  "tokenAddresses": [],
  "excludingTokenAddresses": [],
  "leverage": 2,
  "reverseCopy": false,
  "enableStopLoss": true,
  "stopLossType": "PERCENT",
  "stopLossAmount": 50,
  "volumeProtection": true,
  "lookBackOrders": 10,
  "enableTakeProfit": true,
  "takeProfitType": "PERCENT",
  "takeProfitAmount": 50,
  "maxVolMultiplier": 1,
  "skipLowLeverage": true,
  "lowLeverage": 5,
  "skipLowCollateral": true,
  "lowCollateral": 300,
  "skipLowSize": true,
  "lowSize": 20000,
  "protocol": "KILOEX_OPBNB",
  "exchange": "HYPERLIQUID",
  "copyWalletId": "6780e1a8cf5b4c9659f7a4cb",
  "copyAll": true,
  "hasExclude": false,
  "multipleCopy": false,
  "account": "0xa9Fec8d530AB6d96cB67E1E8fD53bA14E9A2AD79",
  "side": "BOTH",
  "type": "COPY_TRADER"
}'

Response

The API returns the created copy trade configuration object with all properties.

string

Unique identifier for the newly created copy trade

title

string

Display name of the copy trade configuration

userId

string

Identifier of the user who created this copy trade

account

string

The account address being copied

accounts

array

List of additional accounts for multiple copying

copyWalletId

string

Identifier of the wallet used for copying

tokenAddresses

array

List of specific token addresses to copy trades for

stopLossType

string

Type of stop loss calculation

enableStopLoss

boolean

Whether stop loss is enabled

stopLossAmount

number

Value for stop loss

takeProfitType

string

Type of take profit calculation

enableTakeProfit

boolean

Whether take profit is enabled

takeProfitAmount

number

Value for take profit

maxVolMultiplier

number

Maximum volume multiplier for copied trades

leverage

number

Leverage setting for copied trades

volume

number

Volume amount for copied trades

volumeProtection

boolean

Whether volume protection is enabled

lookBackOrders

number

Number of orders to look back when starting copy

reverseCopy

boolean

Whether to copy trades in reverse

skipLowLeverage

boolean

Whether to skip trades with low leverage

lowLeverage

number

Threshold for low leverage

skipLowCollateral

boolean

Whether to skip trades with low collateral

lowCollateral

number

Threshold for low collateral

skipLowSize

boolean

Whether to skip trades with low size

lowSize

number

Threshold for low size

copyAll

boolean

Whether to copy all trades from the account

status

string

Current status of the copy trade (RUNNING/STOPPED)

multipleCopy

boolean

Whether multiple copying is enabled

exchange

string

Exchange platform being used

side

string

Which trade sides to copy

type

string

Type of copy trading

protocol

string

Protocol being used for trading

excludingTokenAddresses

array

List of token addresses to exclude from copying

createdAt

string

Timestamp when the copy trade was created

Response Example

{
  "id": "67fe0ee36c6729db9c4b75f1",
  "title": "Fish",
  "userId": "654849d04857e1f744646cdd",
  "account": "0xa9Fec8d530AB6d96cB67E1E8fD53bA14E9A2AD79",
  "accounts": [],
  "copyWalletId": "6780e1a8cf5b4c9659f7a4cb",
  "tokenAddresses": [],
  "stopLossType": "PERCENT",
  "enableStopLoss": true,
  "stopLossAmount": 50,
  "takeProfitType": "PERCENT",
  "enableTakeProfit": true,
  "takeProfitAmount": 50,
  "maxVolMultiplier": 1,
  "leverage": 2,
  "volume": 10,
  "volumeProtection": true,
  "lookBackOrders": 10,
  "reverseCopy": false,
  "skipLowLeverage": true,
  "lowLeverage": 5,
  "skipLowCollateral": true,
  "lowCollateral": 300,
  "skipLowSize": true,
  "lowSize": 20000,
  "copyAll": true,
  "status": "RUNNING",
  "multipleCopy": false,
  "exchange": "HYPERLIQUID",
  "side": "BOTH",
  "type": "COPY_TRADER",
  "protocol": "KILOEX_OPBNB",
  "excludingTokenAddresses": [],
  "createdAt": "2025-04-15T07:46:43.940Z"
}

Copy Orders Update Copy Trade

curl --request POST \
  --url https://api.copin.io/copy-trades \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "<string>",
  "volume": 123,
  "account": "<string>",
  "leverage": 123,
  "protocol": "<string>",
  "exchange": "<string>",
  "copyWalletId": "<string>",
  "type": "<string>",
  "excludingTokenAddresses": [
    {}
  ],
  "tokenAddresses": [
    {}
  ],
  "reverseCopy": true,
  "enableStopLoss": true,
  "stopLossType": "<string>",
  "stopLossAmount": 123,
  "volumeProtection": true,
  "lookBackOrders": 123,
  "enableTakeProfit": true,
  "takeProfitType": "<string>",
  "takeProfitAmount": 123,
  "maxVolMultiplier": 123,
  "skipLowLeverage": true,
  "lowLeverage": 123,
  "skipLowCollateral": true,
  "lowCollateral": 123,
  "skipLowSize": true,
  "lowSize": 123,
  "copyAll": true,
  "hasExclude": true,
  "multipleCopy": true,
  "side": "<string>"
}'

{
  "id": "<string>",
  "title": "<string>",
  "userId": "<string>",
  "account": "<string>",
  "accounts": [
    {}
  ],
  "copyWalletId": "<string>",
  "tokenAddresses": [
    {}
  ],
  "stopLossType": "<string>",
  "enableStopLoss": true,
  "stopLossAmount": 123,
  "takeProfitType": "<string>",
  "enableTakeProfit": true,
  "takeProfitAmount": 123,
  "maxVolMultiplier": 123,
  "leverage": 123,
  "volume": 123,
  "volumeProtection": true,
  "lookBackOrders": 123,
  "reverseCopy": true,
  "skipLowLeverage": true,
  "lowLeverage": 123,
  "skipLowCollateral": true,
  "lowCollateral": 123,
  "skipLowSize": true,
  "lowSize": 123,
  "copyAll": true,
  "status": "<string>",
  "multipleCopy": true,
  "exchange": "<string>",
  "side": "<string>",
  "type": "<string>",
  "protocol": "<string>",
  "excludingTokenAddresses": [
    {}
  ],
  "createdAt": "<string>"
}

Getting Started

Traders

Positions

Auths

Copy Trades

Position Statistics

Wallets

Authentication

Request Body

Request Example

Response

Response Example

Getting Started

Traders

Positions

Auths

Copy Trades

Position Statistics

Wallets

​Authentication

​Request Body

​Request Example

​Response

​Response Example

Authentication

Request Body

Request Example

Response

Response Example