Skip to main content

Get Transfer History

Get the transfer history of Copy-trade wallet

tip

Need Wallet - "Account Transfer" permission

HTTP Request

GET /asset/v3/private/transfer/copy-trading/list/query

Request Parameters

ParameterRequiredTypeComments
transferIdfalsestringUUID, which is unique across the platform
coinfalsestringCoin name
statusfalsestringStatus. Query all by default
copyTradeTypefalseintegerThe copy-trade type. 0: all, 1: Contract copy trade, 2 (not available): Spot copy trade
startTimefalseintegerThe start timestamp (ms). Query the past 30 days by default when not passed
endTimefalseintegerThe end timestamp (ms)
limitfalseintegerLimit for data size per page. [1, 50]. Default: 20
cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

ParameterTypeComments
listarrayObject
> transferIdstringThe transfer ID
> coinstringCoin name
> amountstringAmount
> fromAccountTypestringFrom account type
> toAccountTypestringTo account type
> timestampstringTransfer timestamp
> statusstringTransfer status
> copyTradeTypeintegerCopy-trade type. 1: Contract copy trade, 2 (not available): Spot copy trade
nextPageCursorstringCursor

Request Example

GET /asset/v3/private/transfer/copy-trading/list/query?limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1679560892359
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"list": [
{
"transferId": "cb86de08-b10f-4abe-9746-7b95c4a37d307",
"coin": "USDT",
"amount": "100",
"fromAccountType": "UNIFIED",
"toAccountType": "COPYTRADE",
"timestamp": "1678861757000",
"status": "SUCCESS",
"copyTradeType": 1
}
],
"nextPageCursor": "eyJtaW5JRCI6MjY4MTAzNSwibWF4SUQiOjI2ODEwMzV9"
},
"retExtInfo": {},
"time": 1679560892812
}