diff --git a/404.html b/404.html index 18b981f371..d639668a5b 100644 --- a/404.html +++ b/404.html @@ -4,13 +4,13 @@ Page Not Found | Bybit API Documentation - +
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

- + \ No newline at end of file diff --git a/account-asset/all-balance.html b/account-asset/all-balance.html index bbbb73ca96..e4e7b04004 100644 --- a/account-asset/all-balance.html +++ b/account-asset/all-balance.html @@ -4,13 +4,13 @@ Get All Coins Balance | Bybit API Documentation - +
Skip to main content

Get All Coins Balance

You could get all coins balance of all account types under the master account, and sub account.

Important

It is not allowed to get master account coin balance via sub account api key.

HTTP Request​

GET /asset/v3/private/transfer/account-coins/balance/query

Request Parameters​

ParameterRequiredTypeComments
memberIdfalsestringUser Id. It is required when you use master api key to check sub account coin balance
accountTypetruestringAccount type
coinfalsestringCoin name
  • Query all coins if not passed
  • Can query multiple coins, separated by comma. USDT,USDC,ETH
withBonusfalsestringWhether query bonus or not. 0(default)：false; 1：true

Response Parameters​

ParameterTypeComments
accountTypestringAccount type
memberIdstringUserID
balancearrayObject
> coinstringCurrency type
> walletBalancestringWallet balance
> transferBalancestringTransferable balance
> bonusstringThe bonus

Request Example​

GET /asset/v3/private/transfer/account-coins/balance/query?accountType=FUND&coin=USDT,USDC HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1675865289817
X-BAPI-RECV-WINDOW: 50000

Response Example​

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "memberId": "533285",
        "accountType": "FUND",
        "balance": [
            {
                "coin": "USDT",
                "transferBalance": "1010",
                "walletBalance": "1010",
                "bonus": ""
            },
            {
                "coin": "USDC",
                "transferBalance": "0",
                "walletBalance": "0",
                "bonus": ""
            }
        ]
    },
    "retExtInfo": {},
    "time": 1675865290069
}
- + \ No newline at end of file diff --git a/account-asset/apikey-info.html b/account-asset/apikey-info.html index ba42211727..3f66ca2c10 100644 --- a/account-asset/apikey-info.html +++ b/account-asset/apikey-info.html @@ -4,13 +4,13 @@ Get API Key Information | Bybit API Documentation - +
Skip to main content

Get API Key Information

Get the information of the api key. Use the api key pending to be checked to call the endpoint. Both master and sub user's api key are applicable.

tip

Any permission can access this endpoint.

HTTP Request​

GET /user/v3/private/query-api

Request Parameters​

None

Response Parameters​

ParameterTypeComments
idstringUnique id. Internal used
notestringThe remark
apiKeystringApi key
readOnlyinteger0：Read and Write. 1：Read only
secretstringAlways ""
permissionsObjectThe types of permission
> ContractTradearrayPermission of contract trade
> SpotarrayPermission of spot
> WalletarrayPermission of wallet
> OptionsarrayPermission of USDC Contract. It supports trade option and usdc perpetual.
> DerivativesarrayPermission of derivatives
> CopyTradingarrayPermission of copytrade. Not applicable to sub account, always []
> BlockTradearrayPermission of blocktrade. Not applicable to sub account, always []
> ExchangearrayPermission of exchange
> NFTarrayPermission of NFT. Not applicable to sub account, always []
ipsarrayIP bound
typeintegerThe type of api key. 1：personal, 2：connected to the third-party app
deadlineDayintegerThe remaining valid days of api key. Only for those api key with no IP bound or the password has been changed
expiredAtdatetimeThe expiry day of the api key. Only for those api key with no IP bound or the password has been changed
createdAtdatetimeThe create day of the api key
unifiedintegerWhether the account to which the api key belongs is a unified account. 0：regular account; 1：unified margin account
utaintegerWhether the account to which the account upgrade to unified trade account. 0：regular account; 1：unified trade account
userIDintegerUser ID
inviterIDintegerInviter ID (the UID of the account which invited this account to the platform)
vipLevelstringVIP Level
mktMakerLevelstringMarket maker level
affiliateIDintegerAffiliate Id. 0 represents that there is no binding relationship.
rsaPublicKeystringRsa public key
isMasterbooleanIf this api key belongs to master account or not
parentUidstringThe main account uid. Returns "0" when the endpoint is called by main account

Request Example​

GET /user/v3/private/query-api HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671177977555
X-BAPI-RECV-WINDOW: 50000

Response Example​

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "id": "13770661",
        "note": "XXXXXX",
        "apiKey": "XXXXXX",
        "readOnly": 0,
        "secret": "",
        "permissions": {
            "ContractTrade": [
                "Order",
                "Position"
            ],
            "Spot": [
                "SpotTrade"
            ],
            "Wallet": [
                "AccountTransfer",
                "SubMemberTransfer"
            ],
            "Options": [
                "OptionsTrade"
            ],
            "Derivatives": [
                "DerivativesTrade"
            ],
            "CopyTrading": [
                "CopyTrading"
            ],
            "BlockTrade": [],
            "Exchange": [
                "ExchangeHistory"
            ],
            "NFT": [
                "NFTQueryProductList"
            ]
        },
        "ips": [
            "*"
        ],
        "type": 1,
        "deadlineDay": 83,
        "expiredAt": "2023-05-15T03:21:05Z",
        "createdAt": "2022-10-16T02:24:40Z",
        "unified": 0,
        "uta": 0,
        "userID": 24600000,
        "inviterID": 0,
        "vipLevel": "No VIP",
        "mktMakerLevel": "0",
        "affiliateID": 0,
        "rsaPublicKey": "",
        "isMaster": false,
        "parentUid": "24617703"
    },
    "retExtInfo": {},
    "time": 1676891757649
}
- + \ No newline at end of file diff --git a/account-asset/asset-info.html b/account-asset/asset-info.html index 983b03e8ec..d83d081ea3 100644 --- a/account-asset/asset-info.html +++ b/account-asset/asset-info.html @@ -4,13 +4,13 @@ Get Asset Info | Bybit API Documentation - +
Skip to main content

Get Asset Info

tip

Can query SPOT asset information only

HTTP Request​

GET /asset/v3/private/transfer/asset-info/query

Request Parameters​

ParameterRequiredTypeComments
accountTypefalsestringAccount type, SPOT in default
coinfalsestringCurrency type

Response Parameters​

ParameterTypeComments
spotObject
> statusstring
  • ACCOUNT_STATUS_NORMAL -- NORMAL
  • ACCOUNT_STATUS_UNSPECIFIED -- ABNORMAL
> assetsarrayObject
>> coinstringCurrency type
>> frozenstringFreeze amount
>> freestringFree balance
>> withdrawstringAmount in withdrawing

Request Example​

GET /asset/v3/private/transfer/asset-info/query?coin=USDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: XXXXXXXXXXX
X-BAPI-TIMESTAMP: 1670924059987
X-BAPI-RECV-WINDOW: 50000
X-BAPI-SIGN: XXXXXXXXXXX

Response Example​

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "spot": {
            "status": "ACCOUNT_STATUS_NORMAL",
            "assets": [
                {
                    "coin": "USDT",
                    "frozen": "0",
                    "free": "61.1428",
                    "withdraw": ""
                }
            ]
        }
    },
    "retExtInfo": {},
    "time": 1670924060108
}
- + \ No newline at end of file diff --git a/account-asset/cancel-withdraw.html b/account-asset/cancel-withdraw.html index 2843f3d0b0..53833295aa 100644 --- a/account-asset/cancel-withdraw.html +++ b/account-asset/cancel-withdraw.html @@ -4,13 +4,13 @@ Cancel withdrawal | Bybit API Documentation - +
Skip to main content

Cancel withdrawal

Cancel withdrawal

HTTP Request​

POST /asset/v3/private/withdraw/cancel

Request Parameters​

ParameterRequiredTypeComments
idtrueintegerWithdrawal ID. (withdraw request ID in Response Parameters of Withdrawal endpoint)

Response Parameters​

ParameterTypeComments
statusintegerCancel application result:
  • 1: SUCCESS
  • 0: FAIL

Request Example​

POST /asset/v3/private/withdraw/cancel HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671173665186
X-BAPI-RECV-WINDOW: 50000
Content-Type: application/json
Content-Length: 24

{
    "id": 1234567890
}

Response Example​

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "status": 1
      },
    "retExtInfo": {},
    "time": 1671173665252
}
- + \ No newline at end of file diff --git a/account-asset/coin-balance.html b/account-asset/coin-balance.html index 12610431f8..8fd637d6fe 100644 --- a/account-asset/coin-balance.html +++ b/account-asset/coin-balance.html @@ -4,7 +4,7 @@ Get Single Coin Balance | Bybit API Documentation - + @@ -12,7 +12,7 @@
Skip to main content

Get Single Coin Balance

You could get a single coin balance under the master account, and sub account coin balance. Also, you can check the transferable amount from master to sub account, sub to master account or sub to sub account, especially for user who has an institutional loan.

Important

It is not allowed to get master account coin balance via sub account api key.

HTTP Request​

GET /asset/v3/private/transfer/account-coin/balance/query

Request Parameters​

ParameterRequiredTypeComments
memberIdfalsestringUser Id. It is required when you use master api key to check sub account coin balance
toMemberIdfalsestringUID. Required when querying the transferable balance between different uids
accountTypetruestringAccount type
toAccountTypefalsestringTo account type. Required when querying the transferable balance between different account types
cointruestringCoin name
withBonusfalseintegerWhether query bonus or not. 0(default)：false; 1：true
withTransferSafeAmountfalseintegerWhether query delay withdraw/transfer safe amount
withLtvTransferSafeAmountfalseintegerFor OTC loan users in particular, you can check the transferable amount under risk level
  • 0(default)：false, 1：true
  • toAccountType is mandatory

Response Parameters​

ParameterTypeComments
accountTypestringAccount type
bizTypeintegerAccount business subtype
accountIdstringAccountID
memberIdstringUserID
balanceObject
> coinstringCurrency type
> walletBalancestringWallet balance
> transferBalancestringTransferable balance
> bonusstringThe bonus
> transferSafeAmountstringSafe amount to transfer. Keep "" if not query
> ltvTransferSafeAmountstringTransferable amount for ins loan account. Keep "" if not query

Request Example​

GET /asset/v3/private/transfer/account-coin/balance/query?accountType=CONTRACT&coin=USDT&withTransferSafeAmount=1&withBonus=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1678794085278
X-BAPI-RECV-WINDOW: 50000

Response Example​

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "accountType": "CONTRACT",
        "bizType": 1,
        "accountId": "533285",
        "memberId": "533285",
        "balance": {
            "coin": "USDT",
            "walletBalance": "0",
            "transferBalance": "-995.3506",
            "bonus": "995.3506",
            "transferSafeAmount": "-995.3506",
            "ltvTransferSafeAmount": ""
        }
    },
    "retExtInfo": {},
    "time": 1678794085705
}
- + \ No newline at end of file diff --git a/account-asset/coin-info.html b/account-asset/coin-info.html index f7f3d91a2b..3ef9230c67 100644 --- a/account-asset/coin-info.html +++ b/account-asset/coin-info.html @@ -4,13 +4,13 @@ Get Coin Information | Bybit API Documentation - +
Skip to main content

Get Coin Information

Query Coin Information

HTTP Request​

GET /asset/v3/private/coin-info/query

Request Parameters​

ParameterRequiredTypeComments
coinfalsestringcoin name

Response Parameters​

ParameterTypeComments
rowsarrayObject
> namestringName
> coinstringCoin name
> remainAmountstringCurrent maximum withdrawal amount
> chainsarrayObject
>> chainTypestringchain type
>> confirmationstringdeposit confirmation number
>> withdrawFeestringwithdraw fee
  • If withdraw fee is empty, It means that this coin does not support withdrawal
  • If withdraw fee is zero, the fee might be calculated by percentage, we will add a new field later
>> depositMinstringminimum deposit amount
>> withdrawMinstringminimum withdrawal amount
>> chainstringchain name
>> chainDepositstringThe chain status of deposit. 0：suspend; 1：normal
>> chainWithdrawstringThe chain status of deposit. 0：suspend; 1：normal
>> minAccuracystringThe precision of withdraw or deposit
>> withdrawPercentageFeestringThe withdraw fee percentage. It is a real figure, e.g., 0.022 means 2.2%

Request Example​

GET /asset/v3/private/coin-info/query?coin=ETH HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671172180432
X-BAPI-RECV-WINDOW: 50000
X-BAPI-SIGN: xxxxxxxxxxx

Response Example​

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "rows": [
            {
                "name": "ETH",
                "coin": "ETH",
                "remainAmount": "1020000",
                "chains": [
                    {
                        "chainType": "ETH",
                        "confirmation": "10000",
                        "withdrawFee": "0.005",
                        "depositMin": "0.01",
                        "withdrawMin": "0.02",
                        "chain": "ETH",
                        "chainDeposit": "1",
                        "chainWithdraw": "1",
                        "minAccuracy": "8",
                        "withdrawPercentageFee": "0.022"
                    },
                    {
                        "chainType": "Arbitrum One",
                        "confirmation": "10",
                        "withdrawFee": "0.01",
                        "depositMin": "0.001",
                        "withdrawMin": "0.1",
                        "chain": "ARBI",
                        "chainDeposit": "1",
                        "chainWithdraw": "1",
                        "minAccuracy": "8",
                        "withdrawPercentageFee": "0"
                    }
                ]
            }
        ]
    },
    "retExtInfo": {},
    "time": 1677478088215
}
- + \ No newline at end of file diff --git a/account-asset/create-subuid-apikey.html b/account-asset/create-subuid-apikey.html index 6e16bce9b7..ef25f48eb4 100644 --- a/account-asset/create-subuid-apikey.html +++ b/account-asset/create-subuid-apikey.html @@ -4,13 +4,13 @@ Create Sub UID API Key | Bybit API Documentation - +
Skip to main content

Create Sub UID API Key

To create new API key for those newly created sub UID. Use master user's api key only.

tip

The API key must have one of the below permissions in order to call this endpoint..

  • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

HTTP Request​

POST /user/v3/private/create-sub-api

Request Parameters​

ParameterRequiredTypeComments
subuidtrueintegerSub user Id
notefalsestringSet a remark
readOnlytrueinteger0：Read and Write. 1：Read only
ipsfalsestringSet the IP bind. example: "192.168.0.1,192.168.0.2"note:
  • don't pass ips or pass with "*" means no bind
  • No ip bound api key will be invalid after 90 days
  • api key without IP bound will be invalid after 7 days once the account password is changed
permissionstrueObjectTick the types of permission.
  • one of below types must be passed, otherwise the error is thrown
> ContractTradefalsearrayContract Trade. ["Order","Position"]
> SpotfalsearraySpot Trade. ["SpotTrade"]
> WalletfalsearrayWallet. ["AccountTransfer","SubMemberTransferList"]
> OptionsfalsearrayUSDC Contract. ["OptionsTrade"]
> DerivativesfalsearrayThis param is depreciated because system will automatically add this permission according to your account is UTA or Classic
> ExchangefalsearrayExchange. ["ExchangeHistory"]
> CopyTradingfalsearrayCopytrade. ["CopyTrading"]

Response Parameters​

ParameterTypeComments
idstringUnique id. Internal used
notestringThe remark
apiKeystringApi key
readOnlyinteger0：Read and Write. 1：Read only
secretstringThe secret paired with api key.
  • The secret can't be queried by GET api. Please keep it properly
permissionsObjectThe types of permission
> ContractTradearrayPermisson of contract trade
> SpotarrayPermisson of spot
> WalletarrayPermisson of wallet
> OptionsarrayPermission of USDC Contract. It supports trade option and usdc perpetual.
> DerivativesarrayPermission of Unified account
> CopyTradingarrayPermission of copytrade
> BlockTradearrayPermission of blocktrade. Not applicable to sub account, always []
> ExchangearrayPermission of exchange
> NFTarrayPermission of NFT. Not applicable to sub account, always []

Request Example​

POST /user/v3/private/create-sub-api HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671176685767
X-BAPI-RECV-WINDOW: 50000
Content-Type: application/json
Content-Length: 796

{
    "subuid": 1111111111,
    "note": "mytest",
    "readOnly": 1,
    "ips": "*",
    "permissions": {
            "ContractTrade": [
                "Order",
                "Position"
            ],
            "Spot": [
                "SpotTrade"
            ],
            "Wallet": [
                "AccountTransfer"
            ],
            "Options": [
                "OptionsTrade"
            ],
            "CopyTrading": [],
            "BlockTrade": [],
            "Exchange": [],
            "NFT": []
        }
}

Response Example​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "id": "1111111111",
        "note": "mytest",
        "apiKey": "xxxxxxxxxxxxx",
        "readOnly": 1,
        "secret": "xxxxxxxxxxxxx",
        "permissions": {
            "ContractTrade": [
                "Order",
                "Position"
            ],
            "Spot": [
                "SpotTrade"
            ],
            "Wallet": [
                "AccountTransfer"
            ],
            "Options": [
                "OptionsTrade"
            ],
            "Derivatives": [
                "DerivativesTrade"
            ],
            "CopyTrading": [],
            "BlockTrade": [],
            "Exchange": [
                "ExchangeHistory"
            ],
            "NFT": []
        }
    },
    "retExtInfo": {},
    "time": 1671176685954
}
- + \ No newline at end of file diff --git a/account-asset/create-subuid.html b/account-asset/create-subuid.html index 56c570c682..beaf616037 100644 --- a/account-asset/create-subuid.html +++ b/account-asset/create-subuid.html @@ -4,13 +4,13 @@ Create Sub UID | Bybit API Documentation - +
Skip to main content

Create Sub UID

Create a new sub user id. Use master user's api key only.

tip

The API key must have one of the below permissions in order to call this endpoint..

  • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

HTTP Request​

POST /user/v3/private/create-sub-member

Request Parameters​

ParameterRequiredTypeComments
usernametruestringGive a username of the new sub user id.
  • 6-16 characters, must include both numbers and letters.
  • cannot be the same as the exist or deleted one.
passwordfalsestringSet the password for the new sub user id.
  • 8-30 characters, must include numbers, upper and lowercase letters.
memberTypetrueinteger1: normal sub account, 6: custodial sub account
switchfalseinteger
  • 0: turn off quick login (default)
  • 1: turn on quick login.
isUtafalseboolean
  • true: create UTA account
  • false(default): create classic account
notefalsestringSet a remark

Response Parameters​

ParameterTypeComments
uidstringSub user Id
usernamestringGive a username of the new sub user id.
  • 6-16 characters, must include both numbers and letters.
  • cannot be the same as the exist or deleted one.
memberTypeinteger1: normal sub account, 6: custodial sub account
statusintegerThe status of the user account
  • 1: normal
  • 2: login banned
  • 4: frozen
remarkstringThe remark

Request Example​

POST /user/v3/private/create-sub-member HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671174837503
X-BAPI-RECV-WINDOW: 50000
Content-Type: application/json
Content-Length: 109

{
    "username": "testsubaccount",
    "memberType": 1,
    "switch": 1,
    "note": "testnet subaccount"
}

Response Example​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "uid": "111111111",
        "username": "testsubaccount",
        "memberType": 1,
        "status": 1,
        "remark": "testnet subaccount"
    },
    "retExtInfo": {},
    "time": 1671174837668
}
- + \ No newline at end of file diff --git a/account-asset/delay-amount.html b/account-asset/delay-amount.html index 60ce3582ca..e54c788e2b 100644 --- a/account-asset/delay-amount.html +++ b/account-asset/delay-amount.html @@ -4,13 +4,13 @@ Get Delay Withdraw Amount | Bybit API Documentation - +
Skip to main content

Get Delay Withdraw Amount

info

How can partial funds be subject to delayed withdrawal requests?

  • On-chain deposit: If the number of on-chain confirmations has not reached a risk-controlled level, a portion of the funds will be frozen for a period of time until they are unfrozen.
  • Buying crypto: If there is a risk, the funds will be frozen for a certain period of time and cannot be withdrawn.

HTTP Request​

GET /asset/v3/private/withdraw/withdrawable-amount

Request Parameters​

ParameterRequiredTypeComments
cointruestringCoin name

Response Parameters​

ParameterTypeComments
limitAmountUsdstringThe frozen amount due to risk, in USD
withdrawableAmountarrayObject
> SPOTObjectSpot wallet, it is not returned if spot wallet is removed
>> coinstringCoin name
>> withdrawableAmountstringAmount that can be withdrawn
>> availableBalancestringAvailable balance
> FUNDObjectFunding wallet
>> coinstringCoin name
>> withdrawableAmountstringAmount that can be withdrawn
>> availableBalancestringAvailable balance

Request Example​

GET /asset/v3/private/withdraw/withdrawable-amount?coin=USDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1677565621998
X-BAPI-RECV-WINDOW: 50000
X-BAPI-SIGN: XXXXXX

Response Example​

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "limitAmountUsd": "52853.5551",
        "withdrawableAmount": {
            "FUND": {
                "coin": "USDT",
                "withdrawableAmount": "11135.0596",
                "availableBalance": "11135.0596"
            },
            "SPOT": {
                "coin": "USDT",
                "withdrawableAmount": "0",
                "availableBalance": "0"
            }
        }
    },
    "retExtInfo": {},
    "time": 1677565632151
}
- + \ No newline at end of file diff --git a/account-asset/deposit-record.html b/account-asset/deposit-record.html index 12f69cd053..1c0800d5c7 100644 --- a/account-asset/deposit-record.html +++ b/account-asset/deposit-record.html @@ -4,13 +4,13 @@ Get Deposit Records (on chain) | Bybit API Documentation - +
Skip to main content

Get Deposit Records (on chain)

Query Deposit Records

Rules
  • The maximum difference between the start time and the end time is 30 days.
  • Support to get deposit records by Master or Sub Member Api Key

    • HTTP Request​

    GET /asset/v3/private/deposit/record/query

    Request Parameters​

    ParameterRequiredTypeComments
    startTimefalseintegerStart time (ms). Default value: 30 days before the current time
    endTimefalseintegerEnd time (ms). Default value: current time
    coinfalsestringCoin name: for example, BTC. Default value: all
    cursorfalsestringCursor, used for pagination
    limitfalseintegerNumber of items per page, [1, 50]. Default value: 50

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > coinstringdeposit coin
    > chainstringchain name
    > amountstringdeposit amount
    > txIDstringtransaction ID. It is "" when deposit failed or deposit cancelled
    > statusinteger
    • 0=unknown
    • 1=ToBeConfirmed
    • 2=processing
    • 3=success
    • 4=deposit failed
    > toAddressstringdeposit target address
    > tagstringtag of deposit target address
    > depositFeestringdeposit fee
    > successAtstringlast updated time
    > confirmationsstringnumber of confirmation blocks
    > txIndexstringtransaction sequence number
    > blockHashstringhash number on the chain
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit
    > depositTypeintegerThe deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
    nextPageCursorstringcursor information: used for pagination. Default value: ""

    Request Example​

    GET /asset/v3/private/deposit/record/query?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671166430580
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "10000",
                    "txID": "1234567890",
                    "status": 3,
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "",
                    "depositFee": "",
                    "successAt": "1671018256000",
                    "confirmations": "10000",
                    "txIndex": "",
                    "blockHash": "",
                    "batchReleaseLimit": "-1",
                    "depositType": 0
                },
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "10000",
                    "txID": "01234567890",
                    "status": 3,
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "",
                    "depositFee": "",
                    "successAt": "1669197900000",
                    "confirmations": "10000",
                    "txIndex": "",
                    "blockHash": "",
                    "batchReleaseLimit": "-1",
                    "depositType": 0
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTAwNTYwNiwibWF4SUQiOjEwMzE1MjN9"
        },
        "retExtInfo": {},
        "time": 1671166430718
    }
    - + \ No newline at end of file diff --git a/account-asset/deposit-spec.html b/account-asset/deposit-spec.html index e8345114ae..4ee0e1c537 100644 --- a/account-asset/deposit-spec.html +++ b/account-asset/deposit-spec.html @@ -4,13 +4,13 @@ Get Deposit Spec | Bybit API Documentation - +
    Skip to main content

    Get Deposit Spec

    Query deposit spec.

    Information
    • It is a public endpoints, no authentication needed.
    • Coin and chain must be paired in the input parameter. Otherwise, it is regarded as an unconditional query.

    HTTP Request​

    GET /asset/v3/public/deposit/allowed-deposit-list/query

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringDeposit Coin. Coin and chain must be paired. Otherwise, it is regarded as an unconditional query
    chainfalsestringDeposit Chain Name. Coin and chain must be paired. Otherwise, it is regarded as an unconditional query
    cursorfalsestringcursor information: used for pagination
    limitfalseintegerNumber of items per page, [1, 50]. Default value: 50

    Response Parameters​

    ParameterTypeComments
    configListarrayObject
    > coinstringdeposit coin
    > chainstringchain name
    > coinShowNamestringCoin show name
    > chainTypestringchain type
    > blockConfirmNumberintegerdeposit confirmation number
    > minDepositAmountstringMinimum Deposit Amount
    nextPageCursorstringcursor information: used for pagination. Default value: ""

    Request Example​

    GET /asset/v3/public/deposit/allowed-deposit-list/query?coin=BTC&chain=BTC HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "configList": [
                {
                    "coin": "BTC",
                    "chain": "BTC",
                    "coinShowName": "BTC",
                    "chainType": "BTC",
                    "blockConfirmNumber": 10000,
                    "minDepositAmount": "0.0005"
                }
            ],
            "nextPageCursor": "eyJwYWdlIjoyLCJsaW1pdCI6MTB9"
        },
        "retExtInfo": {},
        "time": 1671165256048
    }
    - + \ No newline at end of file diff --git a/account-asset/enable-unitransfer.html b/account-asset/enable-unitransfer.html index 94ad97c4e2..b8b2d145f1 100644 --- a/account-asset/enable-unitransfer.html +++ b/account-asset/enable-unitransfer.html @@ -4,13 +4,13 @@ Enable Universal Transfer (Depreciated) | Bybit API Documentation - +
    Skip to main content

    Enable Universal Transfer (Depreciated)

    Enable Universal Transfer

    info

    No need to configure transferable sub uids. Any sub uids can be transferred universally.

    tip

    A universal transfer enables you to transfer funds directly between two sub accounts, or master-sub account and any accountType (CONTRACT, SPOT, etc).

    Use this endpoint to enable subaccounts to take part in a universal transfer. It is a one-time switch which, once thrown, enables a subaccount permanently. If not set, your subaccounts cannot use universal tranfers.

    HTTP Request​

    POST /asset/v3/private/transfer/transfer-sub-member-save

    Request Parameters​

    ParameterRequiredTypeComments
    subMemberIdsfalsestringA comma-separated list of subaccount UIDs, for example "123,45,14,26,46"
    • If not passed, it means that remove the universal transfer ability of sub uid

    Response Parameters​

    None

    Request Example​

    POST /asset/v3/private/transfer/transfer-sub-member-save HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670928736473
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 43

    {
        "subMemberIds": ["1111111","2222222"]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {},
        "retExtInfo": {},
        "time": 1670928736727
    }
    - + \ No newline at end of file diff --git a/account-asset/enum.html b/account-asset/enum.html index 7457752e07..1900f06294 100644 --- a/account-asset/enum.html +++ b/account-asset/enum.html @@ -4,13 +4,13 @@ Enums Definitions | Bybit API Documentation - +
    Skip to main content

    Enums Definitions

    accountType​

    • CONTRACT Derivatives Account
    • SPOT Spot Account
    • INVESTMENT ByFi Account (The service has been offline)
    • OPTION USDC Account
    • UNIFIED UTA or UMA
    • FUND Funding Account

    coin​

    • BTC
    • ETH
    • USDT
    • XRP
    • ...

    chain​

    • BTC
    • ETH
    • TRX
    • XLM
    • LTC
    • ...

    transferStatus​

    • SUCCESS
    • PENDING
    • FAILED

    withdrawStatus​

    • SecurityCheck
    • Pending
    • success
    • CancelByUser
    • Reject
    • Fail
    • BlockchainConfirmed
    • MoreInformationRequired
    - + \ No newline at end of file diff --git a/account-asset/error.html b/account-asset/error.html index b4bc701bb2..6374ca9c96 100644 --- a/account-asset/error.html +++ b/account-asset/error.html @@ -4,13 +4,13 @@ Error Code | Bybit API Documentation - +
    Skip to main content

    Error Code

    CodeDescription
    0SUCCESS
    131084Withdraw failed because of Uta Upgrading
    131200Service error
    131201Internal error
    131202Invalid memberId
    131203Request parameter error
    131204Account info error
    131205Query transfer error
    131206Fail to transfer
    131207Account not exist
    131208Forbid transfer
    131209Get subMember relation error
    131210Amount accuracy error
    131211fromAccountType can't be the same as toAccountType
    131212Insufficient balance
    131213TransferLTV check error
    131214TransferId exist
    131215Amount error
    131216Query balance error
    131217Risk check error
    131001Service error
    131002Parameter error
    131003Interal error
    131004KYC needed
    131085Withdrawal amount is greater than your availale balance (the deplayed withdrawal is triggered)
    131086Withdrawal amount exceeds risk limit (the risk limit of margin trade is triggered)
    131088The withdrawal amount exceeds the remaining withdrawal limit of your identity verification level. The current available amount for withdrawal : %s
    131089User sensitive operation, withdrawal is prohibited within 24 hours
    131090User withdraw has been banned
    131091Blocked login status does not allow withdrawals
    131092User status is abnormal
    131093The withdrawal address is not in the whitelist
    131094UserId is not in the whitelist
    131095Withdrawl amount exceeds the 24 hour platform limit
    131096Withdraw amount does not satify the lower limit or upper limit
    131097Withdrawal of this currency has been closed
    131098Withdrawal currently is not availble from new address
    131099Hot wallet status can cancel the withdraw
    131227Sub-account do not have universal transfer permission
    131228your balance is not enough. Please check transfer safe amount
    131229Due to compliance requirements, the current currency is not allowed to transfer
    131087Do not input memo/tag,please
    - + \ No newline at end of file diff --git a/account-asset/froze-subuid.html b/account-asset/froze-subuid.html index 16e705ad01..aa6e4b0d5f 100644 --- a/account-asset/froze-subuid.html +++ b/account-asset/froze-subuid.html @@ -4,13 +4,13 @@ Froze Sub UID | Bybit API Documentation - +
    Skip to main content

    Froze Sub UID

    Froze sub uid. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

    HTTP Request​

    POST /user/v3/private/frozen-sub-member

    Request Parameters​

    ParameterRequiredTypeComments
    subuidtrueintegerSub user Id
    frozentrueinteger0：unfreeze, 1：freeze

    Response Parameters​

    None

    Request Example​

    POST /user/v3/private/frozen-sub-member HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671177689823
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 42

    {
        "subuid": 111111111,
        "frozen": 1
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1671177689999
    }
    - + \ No newline at end of file diff --git a/account-asset/internal-deposit-record.html b/account-asset/internal-deposit-record.html index cb04c4c3f2..c51e52cea9 100644 --- a/account-asset/internal-deposit-record.html +++ b/account-asset/internal-deposit-record.html @@ -4,13 +4,13 @@ Get Internal Deposit Records (across Bybit) | Bybit API Documentation - +
    Skip to main content

    Get Internal Deposit Records (across Bybit)

    Query deposit records through Bybit platform

    Rules
  • The maximum difference between the start time and the end time is 30 days.
  • Support to get deposit records by Master or Sub Member Api Key

    • HTTP Request​

    GET /asset/v3/private/deposit/internal-deposit-record/query

    Request Parameters​

    ParameterRequiredTypeComments
    txIDfalsestringInternal transfer transaction ID
    startTimefalseintegerStart time (ms). Default value: 30 days before the current time
    endTimefalseintegerEnd time (ms). Default value: current time
    coinfalsestringCoin name: for example, BTC. Default value: all
    cursorfalsestringCursor, used for pagination
    limitfalseintegerNumber of items per page, [1, 50]. Default value: 50

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > idstringID
    > typeinteger1: Internal deposit
    > coinstringDeposit coin
    > amountstringDeposit amount
    > statusinteger
    • 1=Processing
    • 2=Success
    • 3=deposit failed
    > addressstringEmail address or phone number
    > createdTimestringDeposit created timestamp
    > txIDstringInternal transfer transaction ID
    nextPageCursorstringcursor information: used for pagination. Default value: ""

    Request Example​

    GET /asset/v3/private/deposit/internal-deposit-record/query HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1705395811647
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "id": "1103",
                    "amount": "0.1",
                    "type": 1,
                    "coin": "ETH",
                    "address": "xxxxx***@gmail.com",
                    "status": 2,
                    "createdTime": "1705393280",
                    "txID": "77c37e5c-d9fa-41e5-bd13-c9b59d95"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTEwMywibWF4SUQiOjExMDN9"
        },
        "retExtInfo": {},
        "time": 1705395814405
    }
    - + \ No newline at end of file diff --git a/account-asset/internal-transfer-list.html b/account-asset/internal-transfer-list.html index fc1cd5100e..12b4505bc5 100644 --- a/account-asset/internal-transfer-list.html +++ b/account-asset/internal-transfer-list.html @@ -4,13 +4,13 @@ Get Internal Transfer List | Bybit API Documentation - +
    Skip to main content

    Get Internal Transfer List

    Query Internal Transfer List

    info

    When both startTime & endTime are not passed, API returns 30 days data by default

    HTTP Request​

    GET /asset/v3/private/transfer/inter-transfer/list/query

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdtruestringUUID, which is unique across the platform
    cointruestringCurrency
    statusfalsestringTransfer status
    startTimefalseintegerThe start timestamp (ms) Note: the query logic is actually effective based on second level
    endTimefalseintegerThe end timestamp (ms) Note: the query logic is actually effective based on second level
    limitfalseintegerLimit of data size
    cursorfalsestringCursor, used for pagination

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > transferIdstringUUID, which is unique across the platform
    > coinstringCurrency
    > amountstringTransfer amount
    > fromAccountTypestringFrom account type
    > toAccountTypestringTo account type
    > timestampstringCreated timestamp (ms)
    > statusstringTransfer status
    nextPageCursorstringCursor, used for pagination

    Request Example​

    GET /asset/v3/private/transfer/inter-transfer/list/query?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670926842754
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: xxxxxxxxxxxxxxx

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "transferId": "22b168ef-1917-4bbe-a8bd-4ea729ec5887",
                    "coin": "USDT",
                    "amount": "1",
                    "fromAccountType": "SPOT",
                    "toAccountType": "UNIFIED",
                    "timestamp": "1668749670000",
                    "status": "SUCCESS"
                },
                {
                    "transferId": "selfTransfer_4420a136-5610-44d3-97bb-a3d0551869a9",
                    "coin": "USDT",
                    "amount": "1",
                    "fromAccountType": "UNIFIED",
                    "toAccountType": "SPOT",
                    "timestamp": "1668570868000",
                    "status": "SUCCESS"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6NTYxMzUxLCJtYXhJRCI6MTU2Mzg4OX0="
        },
        "retExtInfo": {},
        "time": 1670926842908
    }
    - + \ No newline at end of file diff --git a/account-asset/internal-transfer.html b/account-asset/internal-transfer.html index 81a1ebd806..b9dd15f9ae 100644 --- a/account-asset/internal-transfer.html +++ b/account-asset/internal-transfer.html @@ -4,13 +4,13 @@ Create Internal Transfer | Bybit API Documentation - +
    Skip to main content

    Create Internal Transfer

    Transfers funds between the different sections of an individual's account (not between subaccounts). For example, between the spot and derivatives accounts.

    To send a transfer which is accountType & parent/sub agnostic, use the Create Universal Transfer endpoint.

    tip
    • The transferIn and transferOut account types cannot be the same.
    • You may transfer USDT from SPOT only after upgraded to Unified Margin Account.
    • Currently, the funding wallet only supports outgoing transfers in cryptocurrency, not in fiat currency.

    HTTP Request​

    POST /asset/v3/private/transfer/inter-transfer

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdtruestringUUID, which is unique across the platform
    cointruestringCurrency type
    amounttruestringExchange to amount
    fromAccountTypetruestringAccount type
    toAccountTypetruestringAccount type

    Response Parameters​

    ParameterTypeComments
    transferIdstringUUID, which is unique across the platform
    statusstringTransfer status
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

    • Request Example​

    POST /asset/v3/private/transfer/inter-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670925348932
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 164

    {
        "transferId": "42c0cfb0-6bca-c242-bc73-4e6df6cbcb06",
        "coin": "USDT",
        "amount": "10",
        "fromAccountType": "CONTRACT",
        "toAccountType": "SPOT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "42c0cfb0-6bca-c242-bc73-4e6df6cbcb06",
            "status": "SUCCESS"
        },
        "retExtInfo": {},
        "time": 1670925349100
    }
    - + \ No newline at end of file diff --git a/account-asset/master-deposit-addr.html b/account-asset/master-deposit-addr.html index bd46251978..266fd820c0 100644 --- a/account-asset/master-deposit-addr.html +++ b/account-asset/master-deposit-addr.html @@ -4,13 +4,13 @@ Get Master Acct Deposit Address Info | Bybit API Documentation - +
    Skip to main content

    Get Master Acct Deposit Address Info

    Query Master Acct Deposit Address Information

    HTTP Request​

    GET /asset/v3/private/deposit/address/query

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringcoin name
    chainTypefalsestringChain name. Return all if not passed.
    • pass chain name, e.g. ETH instead of ERC20

    Response Parameters​

    ParameterTypeComments
    coinstringCoin name
    chainsarrayObject
    > chainTypestringchain type
    > addressDepositstringdeposit address
    > tagDepositstringdeposit tag
    > chainstringchain name
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit

    Request Example​

    GET /asset/v3/private/deposit/address/query?coin=USDT&chainType=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671174181320
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/x-www-form-urlencoded

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "USDT",
            "chains": [
                {
                    "chainType": "ERC20",
                    "addressDeposit": "xxxxxxxxxxx",
                    "tagDeposit": "",
                    "chain": "ETH",
                    "batchReleaseLimit": "-1"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1671174181514
    }
    - + \ No newline at end of file diff --git a/account-asset/modify-master-apikey.html b/account-asset/modify-master-apikey.html index c65ebdc7b6..d6efb5bfba 100644 --- a/account-asset/modify-master-apikey.html +++ b/account-asset/modify-master-apikey.html @@ -4,13 +4,13 @@ Modify Master API Key | Bybit API Documentation - +
    Skip to main content

    Modify Master API Key

    Modify the settings of master api key. Use the api key pending to be modified to call the endpoint. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"
    info

    Only the api key that calls this interface can be modified

    HTTP Request​

    POST /user/v3/private/update-api

    Request Parameters​

    ParameterRequiredTypeComments
    readOnlyfalseinteger0 (default)：Read and Write. 1：Read only
    ipsfalsestringSet the IP bind. example: "192.168.0.1,192.168.0.2"note:
    • don't pass ips or pass with "*" means no bind
    • No ip bound api key will be invalid after 90 days
    • api key without IP bound will be invalid after 7 days once the account password is changed
    permissionsfalseObjectTick the types of permission. Don't send this param if you don't want to change the permission
    > ContractTradefalsearrayContract Trade. ["Order","Position"]
    > SpotfalsearraySpot Trade. ["SpotTrade"]
    > WalletfalsearrayWallet. ["AccountTransfer","SubMemberTransfer"]
    > OptionsfalsearrayUSDC Contract. ["OptionsTrade"]
    > DerivativesfalsearrayThis param is depreciated because system will automatically add this permission according to your account is UTA or Classic
    > CopyTradingfalsearrayCopytrade. ["CopyTrading"]
    > BlockTradefalsearrayBlocktrade. ["BlockTrade"]
    > ExchangefalsearrayExchange. ["ExchangeHistory"]
    > NFTfalsearrayNFT. ["NFTQueryProductList"]

    Response Parameters​

    ParameterTypeComments
    idstringUnique id. Internal used
    notestringThe remark
    apiKeystringApi key
    readOnlyinteger0：Read and Write. 1：Read only
    secretstringAlways ""
    permissionsObjectThe types of permission
    > ContractTradearrayPermisson of contract trade
    > SpotarrayPermisson of spot
    > WalletarrayPermisson of wallet
    > OptionsarrayPermission of USDC Contract. It supports trade option and usdc perpetual.
    > DerivativesarrayPermission of Unified account
    > CopyTradingarrayPermission of copytrade. Not applicable to sub account, always []
    > BlockTradearrayPermission of blocktrade. Not applicable to sub account, always []
    > ExchangearrayPermission of exchange
    > NFTarrayPermission of NFT. Not applicable to sub account, always []
    ipsarrayIP bound

    Request Example​

    POST /user/v3/private/update-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671179084116
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 741

    {
        "readOnly": 0,
        "ips": "xxx.xxx.xxx.xx",
        "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": ["BlockTrade"],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": ["NFTQueryProductList"]
            }
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "id": "341509",
            "note": "TESTING12SEP",
            "apiKey": "xxxxxxxxxxxxx",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": [
                    "BlockTrade"
                ],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": [
                    "NFTQueryProductList"
                ]
            },
            "ips": [
                "xxx.xxx.xxx.xxx"
            ]
        },
        "retExtInfo": {},
        "time": 1671179084363
    }
    - + \ No newline at end of file diff --git a/account-asset/modify-sub-apikey.html b/account-asset/modify-sub-apikey.html index 9b0e9e0867..f9e4249f12 100644 --- a/account-asset/modify-sub-apikey.html +++ b/account-asset/modify-sub-apikey.html @@ -4,14 +4,14 @@ Modify Sub API Key | Bybit API Documentation - +
    Skip to main content

    Modify Sub API Key

    Modify the settings of sub api key. Use the sub account api key pending to be modified to call the endpoint or use master account api key to manage its sub account api key.

    tip

    The API key must have one of the below permissions in order to call this endpoint

    • sub API key: "Account Transfer", "Sub Member Transfer"
    • master API Key: "Account Transfer", "Sub Member Transfer", "Withdrawal"

    HTTP Request​

    POST /user/v3/private/update-sub-api

    Request Parameters​

    ParameterRequiredTypeComments
    apikeyfalsestringSub account api key
    • You must pass this param when you use master account manage sub account api key settings
    • If you use corresponding sub uid api key call this endpoint, apikey param cannot be passed, otherwise throwing an error
    readOnlyfalseinteger0 (default)：Read and Write. 1：Read only
    ipsfalsestringSet the IP bind. example: "192.168.0.1,192.168.0.2"note:
    • don't pass ips or pass with "*" means no bind
    • No ip bound api key will be invalid after 90 days
    • api key will be invalid after 7 days once the account password is changed
    permissionsfalseObjectTick the types of permission. Don't send this param if you don't want to change the permission
    > ContractTradefalsearrayContract Trade. ["Order","Position"]
    > SpotfalsearraySpot Trade. ["SpotTrade"]
    > WalletfalsearrayWallet. ["AccountTransfer","SubMemberTransferList"]
    > OptionsfalsearrayUSDC Contract. ["OptionsTrade"]
    > DerivativesfalsearrayThis param is depreciated because system will automatically add this permission according to your account is UTA or Classic
    > ExchangefalsearrayExchange. ["ExchangeHistory"]
    > CopyTradingfalsearrayCopytrade. ["CopyTrading"]

    Response Parameters​

    ParameterTypeComments
    idstringUnique id. Internal used
    notestringThe remark
    apiKeystringApi key
    readOnlyinteger0：Read and Write. 1：Read only
    secretstringAlways ""
    permissionsObjectThe types of permission
    > ContractTradearrayPermisson of contract trade
    > SpotarrayPermisson of spot
    > WalletarrayPermisson of wallet
    > OptionsarrayPermission of USDC Contract. It supports trade option and usdc perpetual.
    > DerivativesarrayPermission of Unified account
    > CopyTradingarrayPermission of copytrade
    > BlockTradearrayPermission of blocktrade. Not applicable to sub account, always []
    > ExchangearrayPermission of exchange
    > NFTarrayPermission of NFT. Not applicable to sub account, always []
    ipsarrayIP bound

    Request Example​

    POST /user/v3/private/update-sub-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671180069231
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 531

    {
        "readOnly": 0,
        "ips": "*",
        "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Exchange": [
                    "ExchangeHistory"
                ]
            }
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "id": "111111111",
            "note": "TESTNET subacc testing",
            "apiKey": "xxxxxxxxxxxxx",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [
                    "DerivativesTrade"
                ],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": []
            },
            "ips": [
                "*"
            ]
        },
        "retExtInfo": {},
        "time": 1671180069386
    }
    - + \ No newline at end of file diff --git a/account-asset/rate-limit.html b/account-asset/rate-limit.html index b3d0f11d84..b168f0d28f 100644 --- a/account-asset/rate-limit.html +++ b/account-asset/rate-limit.html @@ -4,7 +4,7 @@ Rate Limit | Bybit API Documentation - + @@ -15,7 +15,7 @@ in an unexpected violation.

    note

    All traffic to api.bybit.com or api.bytick.com share this limit regardless of if it accesses Spot, Derivatives or Options.

    After violating the limit your IP will be banned for a set period of time (usually 30 minutes). Continually violating the limit will result in a permanent ban. We cannot undo permanent bans or shorten temporary bans.

    API Rate Limit​

    caution

    If you receive "ret_msg": "Too many visits!" in the JSON response, you have hit the API rate limit.

    The API rate limit is based on the rolling time window per minute and UID. In other words, it is per minute per UID. Every request to the API returns response header shown in the code panel:

    Http Response Header Example

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    API Rate Limit Table​

    Transfer​

    PathLimit
    /asset/v3/private/transfer/sub-member-transfer20 req/min
    /asset/v3/private/transfer/transfer-sub-member-save
    /asset/v3/private/transfer/universal-transfer5 req/sec
    /asset/v3/private/transfer/inter-transfer/list/query60 req/min
    /asset/v3/private/transfer/inter-transfer
    /asset/v3/private/transfer/sub-member-transfer/list/query
    /asset/v3/private/transfer/transfer-coin/list/query
    /asset/v3/private/transfer/sub-member/list/query
    /asset/v3/private/transfer/account-coin/balance/query
    /asset/v3/private/transfer/asset-info/query
    /asset/v3/private/transfer/universal-transfer/list/query5 req/sec
    /asset/v3/private/transfer/account-coins/balance/query5 req/sec

    Withdraw and Deposit​

    PathLimit
    /asset/v3/private/deposit/sub-member-record/query300 req/min
    /asset/v3/private/deposit/record/query
    /asset/v3/private/withdraw/record/query
    /asset/v3/private/deposit/address/query
    /asset/v3/private/deposit/sub-member-address/query
    /asset/v3/private/coin-info/query5 req/sec
    /asset/v3/private/withdraw/cancel60 req/min
    /asset/v3/private/withdraw/create1 req/s

    Master-Sub User​

    PathLimit
    /user/v3/private/create-sub-member5 req/sec
    /user/v3/private/create-sub-api
    /user/v3/private/frozen-sub-member
    /user/v3/private/update-api
    /user/v3/private/delete-api
    /user/v3/private/update-sub-api
    /user/v3/private/delete-sub-api
    /user/v3/private/query-sub-members10 req/sec
    /user/v3/private/query-api
    - + \ No newline at end of file diff --git a/account-asset/rm-master-apikey.html b/account-asset/rm-master-apikey.html index 8440a5cc6c..5eb308bd3e 100644 --- a/account-asset/rm-master-apikey.html +++ b/account-asset/rm-master-apikey.html @@ -4,13 +4,13 @@ Delete Master API Key | Bybit API Documentation - +
    Skip to main content

    Delete Master API Key

    Delete the api key of master account. Use the api key pending to be delete to call the endpoint. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"
    danger

    BE CAREFUL! The API key used to call this interface will be invalid immediately.

    HTTP Request​

    POST /user/v3/private/delete-api

    Request Parameters​

    None

    Response Parameters​

    None

    Request Example​

    POST /user/v3/private/delete-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671180438117
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 4
    {
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1671180438209
    }
    - + \ No newline at end of file diff --git a/account-asset/rm-sub-apikey.html b/account-asset/rm-sub-apikey.html index 1115c329d2..9bb7437dfa 100644 --- a/account-asset/rm-sub-apikey.html +++ b/account-asset/rm-sub-apikey.html @@ -4,14 +4,14 @@ Delete Sub API Key | Bybit API Documentation - +
    Skip to main content

    Delete Sub API Key

    Delete the api key of sub account. Use the sub api key pending to be delete to call the endpoint or use the master api key to delete corresponding sub account api key

    tip

    The API key must have one of the below permissions in order to call this endpoint.

    • sub API key: "Account Transfer", "Sub Member Transfer"
    • master API Key: "Account Transfer", "Sub Member Transfer", "Withdrawal"
    danger

    BE CAREFUL! The Sub account API key will be invalid immediately after calling the endpoint.

    HTTP Request​

    POST /user/v3/private/delete-sub-api

    Request Parameters​

    ParameterRequiredTypeComments
    apikeyfalsestringSub account api key
    • You must pass this param when you use master account manage sub account api key settings
    • If you use corresponding sub uid api key call this endpoint, apikey param cannot be passed, otherwise throwing an error

    Response Parameters​

    None

    Request Example​

    POST /user/v3/private/delete-sub-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671180557996
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    {}

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1671180558095
    }
    - + \ No newline at end of file diff --git a/account-asset/set-deposit-acct.html b/account-asset/set-deposit-acct.html index 0b8971bb86..85cb1855e6 100644 --- a/account-asset/set-deposit-acct.html +++ b/account-asset/set-deposit-acct.html @@ -4,13 +4,13 @@ Set Deposit Account | Bybit API Documentation - +
    Skip to main content

    Set Deposit Account

    Set auto transfer account after deposit. The same function as the setting for Deposit on web GUI.

    info
    • Your funds will be deposited into FUND wallet by default. You can set the wallet for auto-transfer after deposit by this API.
    • Only main UID can access.
    tip
    • Unified trading account has FUND, UNIFIED, CONTRACT(for inverse derivatives), SPOT(will be merged into UNIFIED by the end of Feb)
    • Unified margin account has FUND, UNIFIED, CONTRACT(for inverse derivatives), SPOT
    • Classic account has FUND, OPTION(USDC account), CONTRACT(for inverse derivatives and derivatives), SPOT

    HTTP Request​

    POST /asset/v3/private/deposit/deposit-to-account

    Request Parameters​

    ParameterRequiredTypeComments
    accountTypetruestringAccount type
    • UNIFIED
    • SPOT
    • OPTION
    • CONTRACT
    • FUND

    Response Parameters​

    ParameterTypeComments
    statusintegerRequest result:
    • 1: SUCCESS
    • 0: FAIL

    Request Example​

    POST /asset/v3/private/deposit/deposit-to-account HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676887913670
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
        "accountType": "CONTRACT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "status": 1
        },
        "retExtInfo": {},
        "time": 1676887914363
    }
    - + \ No newline at end of file diff --git a/account-asset/sub-deposit-addr.html b/account-asset/sub-deposit-addr.html index 85804cb85c..5cf01fbdb2 100644 --- a/account-asset/sub-deposit-addr.html +++ b/account-asset/sub-deposit-addr.html @@ -4,13 +4,13 @@ Get Sub Acct Deposit Address Info | Bybit API Documentation - +
    Skip to main content

    Get Sub Acct Deposit Address Info

    Query Sub Acct Deposit Address Information

    info

    Get the deposit address information of sub account. Use master user's api key only.

    HTTP Request​

    GET /asset/v3/private/deposit/sub-member-address/query

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name
    chainTypefalsestringChain name. Return all if not passed.
    • pass chain name, e.g. ETH instead of ERC20
    subMemberIdtruestringSub UID

    Response Parameters​

    ParameterTypeComments
    coinstringCoin name
    chainsarrayObject
    > chainTypestringChain type
    > addressDepositstringDeposit address
    > tagDepositstringDeposit tag
    > chainstringChain name
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit

    Request Example​

    GET /asset/v3/private/deposit/sub-member-address/query?coin=USDT&chainType=ETH&subMemberId=407767 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671174486288
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "USDT",
            "chains": {
                "chainType": "ERC20",
                "addressDeposit": "xxxxxxxxxxx",
                "tagDeposit": "",
                "chain": "ETH",
                "batchReleaseLimit": "-1"
            }
        },
        "retExtInfo": {},
        "time": 1671174486505
    }
    - + \ No newline at end of file diff --git a/account-asset/sub-deposit-record.html b/account-asset/sub-deposit-record.html index e4737122b7..b1efb0ba99 100644 --- a/account-asset/sub-deposit-record.html +++ b/account-asset/sub-deposit-record.html @@ -4,13 +4,13 @@ Get Sub Deposit Records (on chain) | Bybit API Documentation - +
    Skip to main content

    Get Sub Deposit Records (on chain)

    Query Sub Deposit Records By Master Key

    Rules

    Rules: Query sub account deposit records by master account api key. If you want to use sub account api key to query, please use Query Deposit Records endpoint

    HTTP Request​

    GET /asset/v3/private/deposit/sub-member-record/query

    Request Parameters​

    ParameterRequiredTypeComments
    subMemberIdtrueintegerSub user Id
    startTimefalseintegerThe start time (ms). Default value: 30 days before the current time
    endTimefalseintegerTbe end time (ms). Default value: current time
    coinfalsestringCoin name: for example, BTC. Default value: all
    cursorfalsestringCursor, used for pagination
    limitfalseintegerNumber of items per page, [1, 50]. Default value: 50

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > coinstringdeposit coin
    > chainstringchain name
    > amountstringdeposit amount
    > txIDstringtransaction ID. It is "" when deposit failed or deposit cancelled
    > statusinteger
    • 0=unknown
    • 1=ToBeConfirmed
    • 2=processing
    • 3=success
    • 4=deposit failed
    > toAddressstringdeposit target address
    > tagstringtag of deposit target address
    > depositFeestringdeposit fee
    > successAtstringlast updated time
    > confirmationsstringnumber of confirmation blocks
    > txIndexstringtransaction sequence number
    > blockHashstringhash number on the chain
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit
    > depositTypeintegerThe deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
    nextPageCursorstringcursor information: used for pagination. Default value: ""

    Request Example​

    GET /asset/v3/private/deposit/sub-member-record/query?subMemberId=xxxxxxxxxxx HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671169682466
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "10000",
                    "txID": "1234567890",
                    "status": 3,
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "11234567890",
                    "depositFee": "",
                    "successAt": "1671018256000",
                    "confirmations": "10000",
                    "txIndex": "",
                    "blockHash": "",
                    "batchReleaseLimit": "-1",
                    "depositType": 0
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTAwNTYwNiwibWF4SUQiOjEwMzE1MjN9"
        },
        "retExtInfo": {},
        "time": 1671166430718
    }
    - + \ No newline at end of file diff --git a/account-asset/sub-transfer-list.html b/account-asset/sub-transfer-list.html index 3e06db5ea4..9a26335bdb 100644 --- a/account-asset/sub-transfer-list.html +++ b/account-asset/sub-transfer-list.html @@ -4,13 +4,13 @@ Get Master-Sub Transfer List | Bybit API Documentation - +
    Skip to main content

    Get Master-Sub Transfer List

    Query subaccount transfer list

    caution

    Can use master api key to query only

    HTTP Request​

    GET /asset/v3/private/transfer/sub-member-transfer/list/query

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdfalsestringUUID, which is unique across the platform
    coinfalsestringCurrency type
    statusfalsestringTransfer status
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit of data size
    cursorfalsestringCursor, used for pagination

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > transferIdstringUUID, which is unique across the platform
    > coinstringCurrency
    > amountstringTransfer amount
    > memberIdintegerMaster account UID
    > subMemberIdintegerSubaccount UID
    > timestampstringCreated timestamp (ms)
    > statusstringTransfer status
    > typestringDetermines the direction of transfer.
    • IN transfer from main account to subaccount
    • OUT transfer from subaccount to main account
    nextPageCursorstringCursor, used for pagination

    Request Example​

    GET /asset/v3/private/transfer/sub-member-transfer/list/query?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670927635525
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f",
                    "coin": "USDT",
                    "amount": "5",
                    "memberId": xxxxxxx,
                    "subMemberId": xxxxxxx,
                    "timestamp": "1670925916000",
                    "status": "SUCCESS",
                    "type": "IN"
                },
                {
                    "transferId": "11ff9144-2d5d-4233-913d-4595c9ad2170",
                    "coin": "USDT",
                    "amount": "100",
                    "memberId": xxxxxxx,
                    "subMemberId": xxxxxxx,
                    "timestamp": "1658732947000",
                    "status": "SUCCESS",
                    "type": "OUT"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MzU2MTA0LCJtYXhJRCI6MTcyMDk2OH0="
        },
        "retExtInfo": {},
        "time": 1670927635641
    }
    - + \ No newline at end of file diff --git a/account-asset/sub-transfer.html b/account-asset/sub-transfer.html index d105265450..7895dd2c67 100644 --- a/account-asset/sub-transfer.html +++ b/account-asset/sub-transfer.html @@ -4,13 +4,13 @@ Create Subaccount Transfer | Bybit API Documentation - +
    Skip to main content

    Create Subaccount Transfer

    Transfer funds between the parent and child (sub) accounts.

    To send a transfer which is accountType & parent/sub agnostic, use the Create Universal Transfer endpoint.

    tip
    • Please note that the transferId field in the incoming request data of this interface is UUID globally unique
    • This interface can only be used for transfer between parent and child accounts
    • A subaccount can only be attributed to a parent account.
    • If you encounter errorCode: 131228 and msg: your balance is not enough, please go to Get Single Coin Balance to check transfer safe amount.
    • It's mandatory to utilize the API key of the main account

    HTTP Request​

    POST /asset/v3/private/transfer/sub-member-transfer

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdtruestringUUID, which is unique across the platform
    cointruestringCurrency type
    amounttruestringExchange to amount
    subMemberIdtrueintegerSubaccount userid
    typetruestringDetermines the direction of transfer.
    • IN transfer from main account to subaccount
    • OUT transfer from subaccount to main account

    Response Parameters​

    ParameterTypeComments
    transferIdstringUUID, which is unique across the platform

    Request Example​

    POST /asset/v3/private/transfer/sub-member-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670925915816
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: xxxxxxxxxxxxx
    Content-Type: application/json
    Content-Length: 144

    {
        "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f",
        "coin": "USDT",
        "amount": "5",
        "subMemberId": 554137,
        "type": "IN"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f"
        },
        "retExtInfo": {},
        "time": 1670925915979
    }
    - + \ No newline at end of file diff --git a/account-asset/sub-uid-list.html b/account-asset/sub-uid-list.html index 45e320721e..6ebf03aedf 100644 --- a/account-asset/sub-uid-list.html +++ b/account-asset/sub-uid-list.html @@ -4,13 +4,13 @@ Get Subaccount UID List | Bybit API Documentation - +
    Skip to main content

    Get Subaccount UID List

    Query Subaccount List

    HTTP Request​

    GET /asset/v3/private/transfer/sub-member/list/query

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    subMemberIdsarray<string>List of all subaccounts
    transferableSubMemberIdsarray<string>List of subaccounts that are universal transfer-enabled

    Request Example​

    GET /asset/v3/private/transfer/sub-member/list/query HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670928351923
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "subMemberIds": [
                "111111",
                "2222222",
                "3333333"
            ],
            "transferableSubMemberIds": [
                "111111",
                "2222222",
                "3333333"
            ]
        },
        "retExtInfo": {},
        "time": 1670928352175
    }
    - + \ No newline at end of file diff --git a/account-asset/subuid-list.html b/account-asset/subuid-list.html index ec77fdc9b2..62374ad021 100644 --- a/account-asset/subuid-list.html +++ b/account-asset/subuid-list.html @@ -4,13 +4,13 @@ Get Sub UID List | Bybit API Documentation - +
    Skip to main content

    Get Sub UID List

    Get all sub uid of master account. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

    HTTP Request​

    GET /user/v3/private/query-sub-members

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    subMembersarrayObject
    > uidstringSub user Id
    > usernamestringUsername
    > memberTypeinteger1: normal sub account, 6: custodial sub account
    > statusintegerThe status of the user account
    • 1: normal
    • 2: login banned
    • 4: frozen
    > remarkstringThe remark

    Request Example​

    GET /user/v3/private/query-sub-members HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430318405
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "subMembers": [
                {
                    "uid": "53888001",
                    "username": "xxx001",
                    "memberType": 1,
                    "status": 1,
                    "remark": "test"
                },
                {
                    "uid": "53888002",
                    "username": "xxx002",
                    "memberType": 6,
                    "status": 1,
                    "remark": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1676430319452
    }
    - + \ No newline at end of file diff --git a/account-asset/transferable-coin-list.html b/account-asset/transferable-coin-list.html index 8462d4e987..0042be9983 100644 --- a/account-asset/transferable-coin-list.html +++ b/account-asset/transferable-coin-list.html @@ -4,13 +4,13 @@ Get Transferable Coin List | Bybit API Documentation - +
    Skip to main content

    Get Transferable Coin List

    Transferable coin list

    You can confirm transferable coins between different account types under the UID to which the current API key belongs

    HTTP Request​

    GET /asset/v3/private/transfer/transfer-coin/list/query

    Request Parameters​

    ParameterRequiredTypeComments
    fromAccountTypetruestringAccount type
    toAccountTypetruestringAccount type

    Response Parameters​

    ParameterTypeComments
    listarrayThe coins are allowed to transfer between accounts

    Request Example​

    GET /asset/v3/private/transfer/transfer-coin/list/query?fromAccountType=SPOT&toAccountType=CONTRACT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671163888641
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                "ETH",
                "EOS",
                "USDT",
                "ADA",
                "BIT",
                "BTC",
                "DAI",
                "DOT",
                "LTC",
                "MANA",
                "XRP"
            ]
        },
        "retExtInfo": {},
        "time": 1671163888818
    }
    - + \ No newline at end of file diff --git a/account-asset/uni-transfer-list.html b/account-asset/uni-transfer-list.html index 0a09ca0bfb..f658254c4b 100644 --- a/account-asset/uni-transfer-list.html +++ b/account-asset/uni-transfer-list.html @@ -4,13 +4,13 @@ Get Universal Transfer List | Bybit API Documentation - +
    Skip to main content

    Get Universal Transfer List

    Query Universal Transfer List

    Only transfers made with the universal transfer API or web transfer will be returned by this endpoint. Transfers made by other endpoints will not be returned.

    tip
    • Main acct api key or Sub acct api key are both supported
    • Main acct api key needs "SubMemberTransfer" permission
    • Sub acct api key needs "SubMemberTransferList" permission
    info

    When both startTime & endTime are not passed, API returns 30 days data by default

    HTTP Request​

    GET /asset/v3/private/transfer/universal-transfer/list/query

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdtruestringUUID, which is unique across the platform
    cointruestringCurrency type
    statusfalsestringTransfer status
    startTimefalseintegerThe start timestamp (ms) Note: the query logic is actually effective based on second level
    endTimefalseintegerThe end timestamp (ms) Note: the query logic is actually effective based on second level
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 20
    cursorfalsestringCursor, used for pagination

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > transferIdstringUUID, which is unique across the platform
    > coinstringCurrency type
    > amountstringTransfer amount
    > timestampstringCreated timestamp (ms)
    > statusstringstatus
    > fromAccountTypestringFrom account type
    > toAccountTypestringTo account type
    > fromMemberIdstringFrom UID
    > toMemberIdstringTo UID
    nextPageCursorstringCursor, used for pagination.

    Request Example​

    GET /asset/v3/private/transfer/universal-transfer/list/query?coin=USDT&status=SUCCESS HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671163509262
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06",
                    "coin": "USDT",
                    "amount": "10",
                    "timestamp": "1671163374000",
                    "status": "SUCCESS",
                    "fromAccountType": "UNIFIED",
                    "toAccountType": "SPOT",
                    "fromMemberId": "11111111",
                    "toMemberId": "22222222"
                },
                {
                    "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f",
                    "coin": "USDT",
                    "amount": "5",
                    "timestamp": "1670925916000",
                    "status": "SUCCESS",
                    "fromAccountType": "SPOT",
                    "toAccountType": "SPOT",
                    "fromMemberId": "111111111",
                    "toMemberId": "33333333"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MzU2MTA0LCJtYXhJRCI6MTczNDQ5Mn0="
        },
        "retExtInfo": {},
        "time": 1671163509474
    }
    - + \ No newline at end of file diff --git a/account-asset/uni-transfer.html b/account-asset/uni-transfer.html index 38699dd776..2809c9e64b 100644 --- a/account-asset/uni-transfer.html +++ b/account-asset/uni-transfer.html @@ -4,13 +4,13 @@ Create Universal Transfer | Bybit API Documentation - +
    Skip to main content

    Create Universal Transfer

    Create Universal Transfer

    It allows to transfer funds between sub accounts, or master-sub account.

    caution
    • Can use master or sub acct api key to request
      • To use sub acct api key, it must have "SubMemberTransferList" permission
      • When use sub acct api key, it can only transfer to main account
    • If you encounter errorCode: 131228 and msg: your balance is not enough, please go to Get Single Coin Balance to check transfer safe amount.
    • Currently, the funding wallet only supports outgoing transfers in cryptocurrency, not in fiat currency.

    HTTP Request​

    POST /asset/v3/private/transfer/universal-transfer

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdtruestringUUID, which is unique across the platform
    cointruestringCurrency type
    amounttruestringExchange to amount
    fromMemberIdtruestringFrom UserID. fromMemberId cannot be the same as toMemberId
    toMemberIdtruestringTo UserID. fromMemberId cannot be the same as toMemberId
    fromAccountTypetruestringAccount type
    toAccountTypetruestringAccount type

    Response Parameters​

    ParameterTypeComments
    transferIdstringUUID, which is unique across the platform
    statusstringTransfer status
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

    • Request Example​

    POST /asset/v3/private/transfer/universal-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671163372208
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 219

    {
        "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06",
        "coin": "USDT",
        "amount": "10",
        "fromMemberId":"111111",
        "toMemberId":"222222",
        "fromAccountType": "UNIFIED",
        "toAccountType": "SPOT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06",
            "status": "SUCCESS"
        },
        "retExtInfo": {},
        "time": 1671163373537
    }
    - + \ No newline at end of file diff --git a/account-asset/vasp-list.html b/account-asset/vasp-list.html index 0aa4d4fa8a..27996c64d4 100644 --- a/account-asset/vasp-list.html +++ b/account-asset/vasp-list.html @@ -4,13 +4,13 @@ Get Exchange Entity List | Bybit API Documentation - +
    Skip to main content

    Get Exchange Entity List

    This endpoint is particularly used for kyc=KOR users. When withdraw funds, you need to fill entity id.

    HTTP Request​

    GET /asset/v3/private/withdraw/vasp/list

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    vasparrayExchange entity info
    > vaspEntityIdstringReceiver platform id. When transfer to Upbit or other exchanges that not in the list, please use vaspEntityId='others'
    > vaspNamestringReceiver platform name

    Request Example​

    GET /asset/v3/private/withdraw/vasp/list HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1715067106163
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "vasp": [
                {
                    "vaspEntityId": "basic-finance",
                    "vaspName": "Basic-finance"
                },
                {
                    "vaspEntityId": "beeblock",
                    "vaspName": "Beeblock"
                },
                {
                    "vaspEntityId": "bithumb",
                    "vaspName": "bithumb"
                },
                {
                    "vaspEntityId": "cardo",
                    "vaspName": "cardo"
                },
                {
                    "vaspEntityId": "codevasp",
                    "vaspName": "codevasp"
                },
                {
                    "vaspEntityId": "codexchange-kor",
                    "vaspName": "CODExchange-kor"
                },
                {
                    "vaspEntityId": "coinone",
                    "vaspName": "coinone"
                },
                {
                    "vaspEntityId": "dummy",
                    "vaspName": "Dummy"
                },
                {
                    "vaspEntityId": "flata-exchange",
                    "vaspName": "flataexchange"
                },
                {
                    "vaspEntityId": "fobl",
                    "vaspName": "Foblgate"
                },
                {
                    "vaspEntityId": "hanbitco",
                    "vaspName": "hanbitco"
                },
                {
                    "vaspEntityId": "hexlant",
                    "vaspName": "hexlant"
                },
                {
                    "vaspEntityId": "inex",
                    "vaspName": "INEX"
                },
                {
                    "vaspEntityId": "infiniteblock-corp",
                    "vaspName": "InfiniteBlock Corp"
                },
                {
                    "vaspEntityId": "kdac",
                    "vaspName": "kdac"
                },
                {
                    "vaspEntityId": "korbit",
                    "vaspName": "korbit"
                },
                {
                    "vaspEntityId": "paycoin",
                    "vaspName": "Paycoin"
                },
                {
                    "vaspEntityId": "qbit",
                    "vaspName": "Qbit"
                },
                {
                    "vaspEntityId": "tennten",
                    "vaspName": "TENNTEN"
                },
                {
                    "vaspEntityId": "others",
                    "vaspName": "Others (including Upbit)"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1715067106537
    }
    - + \ No newline at end of file diff --git a/account-asset/wallet-type.html b/account-asset/wallet-type.html index ed2f05c8ba..e55771626e 100644 --- a/account-asset/wallet-type.html +++ b/account-asset/wallet-type.html @@ -4,13 +4,13 @@ Get UID Wallet Type | Bybit API Documentation - +
    Skip to main content

    Get UID Wallet Type

    Get available wallet types for the master account or sub account

    tip
    • Master api key: you can get master account and appointed sub account available wallet types, and support up to 200 sub uid in one request.
    • Sub api key: you can get its own available wallet types
    PRACTICE

    "FUND" - If you never deposit or transfer capital into it, this wallet type will not be shown in the array, but your account indeed has this wallet.

    • ["SPOT","OPTION","FUND","CONTRACT"] : Classic account and Funding wallet was operated before
    • ["SPOT","OPTION","CONTRACT"] : Classic account and Funding wallet is never operated
    • ["SPOT","UNIFIED","FUND","CONTRACT"] : UMA account and Funding wallet was operated before. (No UMA account after we forced upgrade to UTA)
    • ["SPOT","UNIFIED","CONTRACT"] : UMA account and Funding wallet is never operated. (No UMA account after we forced upgrade to UTA)
    • ["UNIFIED""FUND","CONTRACT"] : UTA account and Funding wallet was operated before.
    • ["UNIFIED","CONTRACT"] : UTA account and Funding wallet is never operated.

    HTTP Request​

    GET /user/v3/private/get-member-type

    Request Parameters​

    ParameterRequiredTypeComments
    memberIdsfalsestring
    • Query itself wallet types when not passed
    • When use master api key to query sub uid, master uid data is always returned in the top of the array
    • Multiple sub uid are supported, separated by commas, and up to 200 uids
    • This param is ignored when you use sub account api key

    Response Parameters​

    ParameterTypeComments
    accountsarrayObject
    > uidstringMaster/Sub user Id
    > accountTypearrayWallets array. SPOT, CONTRACT, FUND, OPTION, UNIFIED. Please check above practice to understand the value

    Request Example​

    GET /user/v3/private/get-member-type HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686882546210
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "accounts": [
                {
                    "uid": "XXXXX",
                    "accountType": [
                        "SPOT",
                        "OPTION",
                        "FUND",
                        "CONTRACT"
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686880658551
    }
    - + \ No newline at end of file diff --git a/account-asset/withdraw-record.html b/account-asset/withdraw-record.html index 68191c61e2..049ac3fb21 100644 --- a/account-asset/withdraw-record.html +++ b/account-asset/withdraw-record.html @@ -4,13 +4,13 @@ Get Withdraw Records | Bybit API Documentation - +
    Skip to main content

    Get Withdraw Records

    Query Withdraw Records

    Rules

    Rules: order by id in reverse order. The maximum difference between the start time and the end time is 30 days.

    HTTP Request​

    GET /asset/v3/private/withdraw/record/query

    Request Parameters​

    ParameterRequiredTypeComments
    withdrawIDfalseintegerwithdrawal id. (withdraw request ID in Response Parameters of Withdrawal endpoint)
    txIDfalsestringTransaction hash ID
    startTimefalseintegerThe start time (ms). Default value: 30 days before the current time
    endTimefalseintegerThe end time (ms). Default value: current time
    coinfalsestringcoin name: for example, BTC. Default value: all
    withdrawTypefalsestring
    • 0 (default)：on chain.
    • 1：off chain.
    • 2：on and off chain
    cursorfalsestringCursor, used for pagination
    limitfalseintegerNumber of items per page. [1, 50] Default value: 50

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > coinstringwithdrawal coin
    > chainstringchain name
    > amountstringwithdrawal quantity
    > txIDstringtransaction ID. It returns "" when withdrawal failed, withdrawal cancelled
    > statusstringstatus
    > toAddressstringwithdrawal target address. It shows email or mobile number for internal transfer
    > tagstringtag of withdrawal target address
    > withdrawFeestringwithdrawal fee
    > createTimestringwithdrawal create time
    > updateTimestringwithdrawal status updated time
    > withdrawIdstringwithdrawal id. (withdraw request ID in Response Parameters of Withdrawal endpoint)
    > withdrawTypeintegerWithdraw type.
    • 0：on chain;
    • 1：internal address transfer
    nextPageCursorstringcursor information, used for pagination

    Request Example​

    GET /asset/v3/private/withdraw/record/query HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671171632559
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "TRX",
                    "amount": "10",
                    "txID": "",
                    "status": "CancelByUser",
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "",
                    "withdrawFee": "1",
                    "createTime": "1670906044000",
                    "updateTime": "1670906050000",
                    "withdrawId": "9965",
                    "withdrawType": 0
                },
                {
                    "coin": "USDT",
                    "chain": "TRX",
                    "amount": "10",
                    "txID": "",
                    "status": "CancelByUser",
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "",
                    "withdrawFee": "1",
                    "createTime": "1670905993000",
                    "updateTime": "1670906001000",
                    "withdrawId": "9964",
                    "withdrawType": 0
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6OTk2NCwibWF4SUQiOjk5NjV9"
        },
        "retExtInfo": {},
        "time": 1671171632649
    }
    - + \ No newline at end of file diff --git a/account-asset/withdraw.html b/account-asset/withdraw.html index 9a096996e3..8408265c1f 100644 --- a/account-asset/withdraw.html +++ b/account-asset/withdraw.html @@ -4,14 +4,14 @@ Withdraw | Bybit API Documentation - +
    Skip to main content

    Withdraw

    Withdraw assets from your Bybit account. You can make an off-chain transfer if the target wallet address is from Bybit. This means that no blockchain fee will be charged.

    danger
    • For UTA users, please note that Bybit will merge SPOT account into UNIFIED account (est.end of Feb), so please adjust your withdrawal logic by transferring funds to FUND account first, then call withdraw API.
    • How do I know if my account is a UTA account? Call this endpoint, and if uta=1, then it is a UTA account.
    caution
    • Make sure you have whitelisted your wallet address here
    • Can query by the master UID's api key only
    formula

    feeType=0:

    • withdrawPercentageFee != 0: handlingFee = inputAmount / (1 - withdrawPercentageFee) * withdrawPercentageFee + withdrawFee
    • withdrawPercentageFee = 0: handlingFee = withdrawFee

    feeType=1:

    • withdrawPercentageFee != 0: handlingFee = withdrawFee + (inputAmount - withdrawFee) * withdrawPercentageFee
    • withdrawPercentageFee = 0: handlingFee = withdrawFee

    HTTP Request​

    POST /asset/v3/private/withdraw/create

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringcoin name
    chaintruestringchain name
    addresstruestringWithdraw address. Please note that the address is case sensitive, so use the exact same address added in address book
    tagfalsestringNeed to fill in if there is a memo/tag when adding the wallet address. Note: please do not set a tag/memo in the address book if the chain does not support tag
    amounttruestringwithdraw amounts. The minimum withdrawal amount can be obtained from the Coin Info Query API
    timestamptrueintegerCurrent timestamp
    forceChainfalseintegerForce to withdraw on chain or not.
    • 0(default)：If parsed as internal address, then internal transfer
    • 1：Force withdraw on chain
    accountTypefalsestringSelect the wallet to be withdrawn from
    • SPOT(default)：spot wallet
    • FUND：Funding wallet
    feeTypefalseintegerHandling fee option
    • 0(default): input amount is the actual amount received, so you have to calculate handling fee manually
    • 1: input amount is not the actual amount you received, the system will help to deduct the handling fee automatically
    requestIdfalsestringCustomised ID, globally unique, it is used for idempotent verification
  • A combination of letters (case sensitive) and numbers, which can be pure letters or pure numbers and the length must be between 1 and 32 digits
    • beneficiaryfalseObjectTravel rule info, only required for kyc=KOR (korean) users
    > vaspEntityIdtruestringReceiver exchange entity Id. Please call this endpoint to get this ID
    > beneficiaryNamefalsestringReceiver exchange user KYC name, like John Wilson or Wilson John
  • Please refer to target exchange kyc name
  • When vaspEntityId="others", this field can be null

    • Response Parameters​

    ParameterTypeComments
    idstringWithdrawal ID

    Request Example​

    POST /asset/v3/private/withdraw/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671172758674
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 193

    {
        "coin": "USDT",
        "chain": "ETH",
        "address": "xxxxxxxxxxx",
        "tag": null,
        "amount": "10",
        "timestamp": 1670919612851,
        "forceChain": 1,
        "accountType": "FUND"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "id": "xxxxxxxxxxx"
          },
        "retExtInfo": {},
        "time": 1671172180550
    }
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/account-info.html b/api-explorer/v5/account/account-info.html index f080727df5..97c7e2c0c6 100644 --- a/api-explorer/v5/account/account-info.html +++ b/api-explorer/v5/account/account-info.html @@ -4,13 +4,13 @@ Get Account Info | Bybit API Documentation - +
    Skip to main content

    Get Account Info​

    Get account info

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/account.html b/api-explorer/v5/account/account.html index e6c78454d4..72fc3b95c2 100644 --- a/api-explorer/v5/account/account.html +++ b/api-explorer/v5/account/account.html @@ -4,13 +4,13 @@ Account | Bybit API Documentation - +
    Skip to main content

    Account

    Account endpoints

    - + \ No newline at end of file diff --git a/api-explorer/v5/account/borrow-history.html b/api-explorer/v5/account/borrow-history.html index c0d9506b1e..d2dea0e2a4 100644 --- a/api-explorer/v5/account/borrow-history.html +++ b/api-explorer/v5/account/borrow-history.html @@ -4,13 +4,13 @@ Get Borrow History | Bybit API Documentation - +
    Skip to main content

    Get Borrow History​

    Get borrow history

    Query Parameters
    • currency string

      e.g., USDC, USDT, BTC, ETH

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 20

      Limit per page. 1-50

    • cursor string

      Cusor, used for pagiation

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/coin-greeks.html b/api-explorer/v5/account/coin-greeks.html index 1594d81ad3..0e33cb1755 100644 --- a/api-explorer/v5/account/coin-greeks.html +++ b/api-explorer/v5/account/coin-greeks.html @@ -4,13 +4,13 @@ Get Coin Greeks | Bybit API Documentation - +
    Skip to main content

    Get Coin Greeks​

    Get coin greek info

    Query Parameters
    • baseCoin string

      Base coin

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/collateral-info.html b/api-explorer/v5/account/collateral-info.html index d532d1de35..ec2bad216d 100644 --- a/api-explorer/v5/account/collateral-info.html +++ b/api-explorer/v5/account/collateral-info.html @@ -4,13 +4,13 @@ Get Collateral Info | Bybit API Documentation - +
    Skip to main content

    Get Collateral Info​

    Get collateral info

    Query Parameters
    • currency string

      Collateral asset

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/fee-rate.html b/api-explorer/v5/account/fee-rate.html index 0d915b9926..5952250041 100644 --- a/api-explorer/v5/account/fee-rate.html +++ b/api-explorer/v5/account/fee-rate.html @@ -4,13 +4,13 @@ Get Fee Rate | Bybit API Documentation - +
    Skip to main content

    Get Fee Rate​

    Get fee rate

    Query Parameters
    • category string required

      Possible values: [spot, linear, inverse, option]

      Product type. working for spot and option

    • symbol string

      Symbol name. valid for linear,inverse and spot

    • baseCoin string

      Possible values: [SOL, BTC, ETH]

      Base coin. Valid for option

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/set-collateral.html b/api-explorer/v5/account/set-collateral.html index 5e215e7927..67c3cc51e3 100644 --- a/api-explorer/v5/account/set-collateral.html +++ b/api-explorer/v5/account/set-collateral.html @@ -4,13 +4,13 @@ Set Collateral Coin | Bybit API Documentation - +
    Skip to main content

    Set Collateral Coin​

    Set collateral coin

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • coin string required

      coin

    • collateralSwitch string required

      Possible values: [ON, OFF]

      coin

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/set-margin-mode.html b/api-explorer/v5/account/set-margin-mode.html index 13859f73b1..7db87c1a23 100644 --- a/api-explorer/v5/account/set-margin-mode.html +++ b/api-explorer/v5/account/set-margin-mode.html @@ -4,13 +4,13 @@ Set Margin Mode | Bybit API Documentation - +
    Skip to main content

    Set Margin Mode​

    Set margin mode

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • setMarginMode string required

      Possible values: [REGULAR_MARGIN, ISOLATED_MARGIN, PORTFOLIO_MARGIN]

      Margin mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/set-spot-hedge.html b/api-explorer/v5/account/set-spot-hedge.html index 98b93cad34..d8e039f436 100644 --- a/api-explorer/v5/account/set-spot-hedge.html +++ b/api-explorer/v5/account/set-spot-hedge.html @@ -4,13 +4,13 @@ Set Spot Hedging | Bybit API Documentation - +
    Skip to main content

    Set Spot Hedging​

    Set spot hedging for Portfolio margin

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • setHedgingMode string required

      Possible values: [ON, OFF]

      on or off spot hedging mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/transaction-log.html b/api-explorer/v5/account/transaction-log.html index 66832e3817..449d21aca3 100644 --- a/api-explorer/v5/account/transaction-log.html +++ b/api-explorer/v5/account/transaction-log.html @@ -4,13 +4,13 @@ Get Transaction Log | Bybit API Documentation - +
    Skip to main content

    Get Transaction Log​

    Get transaction log

    Query Parameters
    • accountType string

      Possible values: [UNIFIED]

      Support UNIFIED for now

    • category string

      Possible values: [spot, linear, option]

      Product category

    • currency string

      Currency

    • baseCoin string

      Base coin

    • type string

      Possible values: [TRANSFER_IN, TRANSFER_OUT, TRADE, SETTLEMENT, DELIVERY, LIQUIDATION, BONUS, FEE_REFUND, INTEREST, CURRENCY_BUY, CURRENCY_SELL]

      Transaction log type

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 20

      Limit size for each page. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/upgrade-unified-account.html b/api-explorer/v5/account/upgrade-unified-account.html index 65f5ac9723..a637496c4b 100644 --- a/api-explorer/v5/account/upgrade-unified-account.html +++ b/api-explorer/v5/account/upgrade-unified-account.html @@ -4,13 +4,13 @@ Upgrade to Unified Account | Bybit API Documentation - +
    Skip to main content

    Upgrade to Unified Account​

    Upgrade to UTA

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • object
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/account/wallet.html b/api-explorer/v5/account/wallet.html index 5da000cc01..86954d128a 100644 --- a/api-explorer/v5/account/wallet.html +++ b/api-explorer/v5/account/wallet.html @@ -4,13 +4,13 @@ Get Wallet Balance | Bybit API Documentation - +
    Skip to main content

    Get Wallet Balance​

    Get wallet balance

    Query Parameters
    • accountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT]

      Account type

    • coin string

      Coin name. You can pass mutiple coins like USDT,USDC

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/account-coin-balance.html b/api-explorer/v5/asset/account-coin-balance.html index ce4b64d335..c2510d5634 100644 --- a/api-explorer/v5/asset/account-coin-balance.html +++ b/api-explorer/v5/asset/account-coin-balance.html @@ -4,13 +4,13 @@ Get Single Coin Balance | Bybit API Documentation - +
    Skip to main content

    Get Single Coin Balance​

    Get Single Coin Balance

    Query Parameters
    • memberId string

      If query sub user balance, please input sub uid

    • accountType string required

      Possible values: [SPOT, CONTRACT, UNIFIED, OPTION, INVESTMENT, FUND]

      Account type

    • coin string required

      Coin name

    • withBonus integer

      Possible values: [0, 1]

      Query bonus or not. 0=false, 1=true

    • withTransferSafeAmount integer

      Possible values: [0, 1]

      Whether query delay withdraw/transfer safe amount. 0：false, 1；true

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/all-balance.html b/api-explorer/v5/asset/all-balance.html index d94578059a..43a26f73e0 100644 --- a/api-explorer/v5/asset/all-balance.html +++ b/api-explorer/v5/asset/all-balance.html @@ -4,13 +4,13 @@ Get All Coins Balance | Bybit API Documentation - +
    Skip to main content

    Get All Coins Balance​

    Get All Coins Balance

    Query Parameters
    • memberId string

      If query sub user balance, please input sub uid

    • accountType string required

      Possible values: [SPOT, CONTRACT, UNIFIED, OPTION, INVESTMENT, FUND]

      Account type

    • coin string

      Coin name

    • withBonus integer

      Possible values: [0, 1]

      Query bonus or not. 0=false, 1=true

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/asset-info.html b/api-explorer/v5/asset/asset-info.html index ef78af0fe8..d5c9e11cab 100644 --- a/api-explorer/v5/asset/asset-info.html +++ b/api-explorer/v5/asset/asset-info.html @@ -4,13 +4,13 @@ Get Asset Info (Spot) | Bybit API Documentation - +
    Skip to main content

    Get Asset Info (Spot)​

    Get spot asset

    Query Parameters
    • accountType string required

      Possible values: [SPOT]

      Account type

    • coin string

      Coin name

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/asset.html b/api-explorer/v5/asset/asset.html index 5704b29cd1..7c1eb01a79 100644 --- a/api-explorer/v5/asset/asset.html +++ b/api-explorer/v5/asset/asset.html @@ -4,13 +4,13 @@ Asset | Bybit API Documentation - +
    Skip to main content

    Asset

    Asset endpoints

    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/coin-info.html b/api-explorer/v5/asset/coin-info.html index 2e65195594..86175d206f 100644 --- a/api-explorer/v5/asset/coin-info.html +++ b/api-explorer/v5/asset/coin-info.html @@ -4,13 +4,13 @@ Get Coin Info | Bybit API Documentation - +
    Skip to main content

    Get Coin Info​

    Get coin info

    Query Parameters
    • coin string

      Coin name

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/create-inter-transfer.html b/api-explorer/v5/asset/create-inter-transfer.html index b651505e2f..1e08f20c3d 100644 --- a/api-explorer/v5/asset/create-inter-transfer.html +++ b/api-explorer/v5/asset/create-inter-transfer.html @@ -4,13 +4,13 @@ Create Internal Transfer | Bybit API Documentation - +
    Skip to main content

    Create Internal Transfer​

    Create internal transfer

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • transferId string required

      UUID

    • coin string required

      Coin

    • amount string required

      Amount

    • fromAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, INVESTMENT, FUND]

      From account type

    • toAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, INVESTMENT, FUND]

      To account type

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/delivery.html b/api-explorer/v5/asset/delivery.html index ee672320af..d9452a1555 100644 --- a/api-explorer/v5/asset/delivery.html +++ b/api-explorer/v5/asset/delivery.html @@ -4,13 +4,13 @@ Get Delivery Record | Bybit API Documentation - +
    Skip to main content

    Get Delivery Record​

    Get delivery record

    Query Parameters
    • category string required

      Possible values: [option, linear]

      Product type

    • symbol string

      Symbol name

    • expDate string

      expired date

    • limit integer

      Default value: 20

      1-50. max 50

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/deposit-coin-spec.html b/api-explorer/v5/asset/deposit-coin-spec.html index b05ed829ba..1f042d9883 100644 --- a/api-explorer/v5/asset/deposit-coin-spec.html +++ b/api-explorer/v5/asset/deposit-coin-spec.html @@ -4,13 +4,13 @@ Get Allowed Deposit Coin Info | Bybit API Documentation - +
    Skip to main content

    Get Allowed Deposit Coin Info​

    Get allowed deposit coin info

    Query Parameters
    • coin string

      Coin name. coin and chain must be paired if passed

    • chain string

      Chain name. coin and chain must be paired if passed

    • limit integer

      Default value: 10

      Limit size. 1-35

    • cursor string

      Cursor, used for pagination

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/deposit-record.html b/api-explorer/v5/asset/deposit-record.html index 435ff706f4..33abc24647 100644 --- a/api-explorer/v5/asset/deposit-record.html +++ b/api-explorer/v5/asset/deposit-record.html @@ -4,13 +4,13 @@ Get Deposit Record (on-chain) | Bybit API Documentation - +
    Skip to main content

    Get Deposit Record (on-chain)​

    Get deposit record

    Query Parameters
    • coin string

      Coin name

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      Limit size. 1-50

    • cursor string

      Cursor, used to pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/exchange.html b/api-explorer/v5/asset/exchange.html index 63dd2c6c3a..06d6f92779 100644 --- a/api-explorer/v5/asset/exchange.html +++ b/api-explorer/v5/asset/exchange.html @@ -4,13 +4,13 @@ Get Coin Exchange Records | Bybit API Documentation - +
    Skip to main content

    Get Coin Exchange Records​

    Get exchange records

    Query Parameters
    • fromCoin string

      From coin

    • toCoin string

      To coin

    • limit integer required

      Default value: 20

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/inter-transfer-list.html b/api-explorer/v5/asset/inter-transfer-list.html index ea0098b23b..7f46eeae59 100644 --- a/api-explorer/v5/asset/inter-transfer-list.html +++ b/api-explorer/v5/asset/inter-transfer-list.html @@ -4,13 +4,13 @@ Get Internal Transfer Records | Bybit API Documentation - +
    Skip to main content

    Get Internal Transfer Records​

    Get internal transfer records

    Query Parameters
    • transferId string

      Transfer id

    • coin string

      Coin name

    • status string

      Possible values: [SUCCESS, PENDING, FAILED]

      Status

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 20

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/internal-deposit-record.html b/api-explorer/v5/asset/internal-deposit-record.html index 0fdd2f6bbe..3b062ff6b7 100644 --- a/api-explorer/v5/asset/internal-deposit-record.html +++ b/api-explorer/v5/asset/internal-deposit-record.html @@ -4,13 +4,13 @@ Get Internal Deposit Records (off-chain) | Bybit API Documentation - +
    Skip to main content

    Get Internal Deposit Records (off-chain)​

    Get deposit records through Bybit platform

    Query Parameters
    • coin string

      Coin name

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/master-deposit-addr.html b/api-explorer/v5/asset/master-deposit-addr.html index b6c1416093..8deb81e61d 100644 --- a/api-explorer/v5/asset/master-deposit-addr.html +++ b/api-explorer/v5/asset/master-deposit-addr.html @@ -4,13 +4,13 @@ Get Master Deposit Address | Bybit API Documentation - +
    Skip to main content

    Get Master Deposit Address​

    Get master deposit address

    Query Parameters
    • coin string required

      Coin name

    • chainType string

      Chain name

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/set-deposit-acct.html b/api-explorer/v5/asset/set-deposit-acct.html index 90edcc422c..5caaaf7a30 100644 --- a/api-explorer/v5/asset/set-deposit-acct.html +++ b/api-explorer/v5/asset/set-deposit-acct.html @@ -4,13 +4,13 @@ Set Deposit Account | Bybit API Documentation - +
    Skip to main content

    Set Deposit Account​

    Set Deposit Account

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Request Body
    • AccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, FUND]

      From account type

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/settlement.html b/api-explorer/v5/asset/settlement.html index 4081864839..a7e3d9e4e5 100644 --- a/api-explorer/v5/asset/settlement.html +++ b/api-explorer/v5/asset/settlement.html @@ -4,13 +4,13 @@ Get USDC Session Settlement | Bybit API Documentation - +
    Skip to main content

    Get USDC Session Settlement​

    Get usdc session settlement record.

    Query Parameters
    • category string required

      Possible values: [linear]

      Product type

    • symbol string

      Symbol name. USDC perp or USDC futures

    • limit integer

      Default value: 20

      1-50. max 50

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/sub-deposit-addr.html b/api-explorer/v5/asset/sub-deposit-addr.html index 9371e791f4..6920c0ccf7 100644 --- a/api-explorer/v5/asset/sub-deposit-addr.html +++ b/api-explorer/v5/asset/sub-deposit-addr.html @@ -4,13 +4,13 @@ Get Sub Deposit Address | Bybit API Documentation - +
    Skip to main content

    Get Sub Deposit Address​

    Get sub deposit address

    Query Parameters
    • coin string required

      Coin name

    • chainType string required

      Chain name

    • subMemberId string required

      Sub UID

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/sub-deposit-record.html b/api-explorer/v5/asset/sub-deposit-record.html index 742e9db802..448691e467 100644 --- a/api-explorer/v5/asset/sub-deposit-record.html +++ b/api-explorer/v5/asset/sub-deposit-record.html @@ -4,13 +4,13 @@ Get Sub Account Deposit Records (on-chain) | Bybit API Documentation - +
    Skip to main content

    Get Sub Account Deposit Records (on-chain)​

    Get sub account deposit record

    Query Parameters
    • subMemberId string required

      Sub UID

    • coin string

      Coin name

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/sub-uid-list.html b/api-explorer/v5/asset/sub-uid-list.html index 4944a62638..489de08bd7 100644 --- a/api-explorer/v5/asset/sub-uid-list.html +++ b/api-explorer/v5/asset/sub-uid-list.html @@ -4,13 +4,13 @@ Get Sub UID | Bybit API Documentation - +
    Skip to main content

    Get Sub UID​

    Get sub uid

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api key

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/transferable-coin.html b/api-explorer/v5/asset/transferable-coin.html index eba3c28e8d..1ce5a56148 100644 --- a/api-explorer/v5/asset/transferable-coin.html +++ b/api-explorer/v5/asset/transferable-coin.html @@ -4,13 +4,13 @@ Get Transferable Coin | Bybit API Documentation - +
    Skip to main content

    Get Transferable Coin​

    Get transferable coins

    Query Parameters
    • fromAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, INVESTMENT, FUND]

      From account type

    • toAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, INVESTMENT, FUND]

      To account type

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/unitransfer-list.html b/api-explorer/v5/asset/unitransfer-list.html index c3d2c6c9dc..efc3c6ab7a 100644 --- a/api-explorer/v5/asset/unitransfer-list.html +++ b/api-explorer/v5/asset/unitransfer-list.html @@ -4,13 +4,13 @@ Get Universal Transfer Records | Bybit API Documentation - +
    Skip to main content

    Get Universal Transfer Records​

    Get universal transfer record

    Query Parameters
    • transferId string

      Transfer id

    • coin string

      Coin name

    • status string

      Possible values: [SUCCESS, FAILED, PENDING]

      Status

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 20

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/unitransfer.html b/api-explorer/v5/asset/unitransfer.html index 8b01145d83..28e509f875 100644 --- a/api-explorer/v5/asset/unitransfer.html +++ b/api-explorer/v5/asset/unitransfer.html @@ -4,13 +4,13 @@ Create Universal Transfer | Bybit API Documentation - +
    Skip to main content

    Create Universal Transfer​

    Create universal transfer

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Request Body
    • transferId sting required

      Transfer id. UUID

    • coin sting required

      Coin name

    • amount sting required

      Amount

    • fromMemberId intger required

      From UID

    • toMemberId integer required

      To UID

    • fromAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, INVESTMENT, OPTION, FUND]

      From account type

    • toAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, INVESTMENT, OPTION, FUND]

      To account type

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/asset/withdraw-record.html b/api-explorer/v5/asset/withdraw-record.html index 375c435058..a4f8f1d556 100644 --- a/api-explorer/v5/asset/withdraw-record.html +++ b/api-explorer/v5/asset/withdraw-record.html @@ -4,13 +4,13 @@ Get Withdraw Records | Bybit API Documentation - +
    Skip to main content

    Get Withdraw Records​

    Get withdraw record

    Query Parameters
    • withdrawID string

      Withdraw ID

    • coin string

      Coin name

    • withdrawType integer

      Possible values: [0, 1, 2]

      Withdraw type. 0=on chain, 1=off chain, 2=all

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      Limit size. 1-50

    • cursor string

      Cursor, used to pagination

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/category.html b/api-explorer/v5/category.html index b4385014bb..ce33063c7a 100644 --- a/api-explorer/v5/category.html +++ b/api-explorer/v5/category.html @@ -4,13 +4,13 @@ V5 API | Bybit API Documentation - +
    Skip to main content

    V5 API

    - + \ No newline at end of file diff --git a/api-explorer/v5/lt/etp.html b/api-explorer/v5/lt/etp.html index 4b8db4bd83..9c07921313 100644 --- a/api-explorer/v5/lt/etp.html +++ b/api-explorer/v5/lt/etp.html @@ -4,13 +4,13 @@ Spot Leverage Token | Bybit API Documentation - +
    Skip to main content
    - + \ No newline at end of file diff --git a/api-explorer/v5/lt/leverage-token-info.html b/api-explorer/v5/lt/leverage-token-info.html index 9aecee5886..b2dc8f90f2 100644 --- a/api-explorer/v5/lt/leverage-token-info.html +++ b/api-explorer/v5/lt/leverage-token-info.html @@ -4,13 +4,13 @@ Get Leverage Token Info | Bybit API Documentation - +
    Skip to main content

    Get Leverage Token Info​

    Get lt information

    Query Parameters
    • ltCoin string

      Levearage coin name. e.g., BTC3L

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/lt/leverage-token-reference.html b/api-explorer/v5/lt/leverage-token-reference.html index 59b616117c..1f52d16a45 100644 --- a/api-explorer/v5/lt/leverage-token-reference.html +++ b/api-explorer/v5/lt/leverage-token-reference.html @@ -4,13 +4,13 @@ Get Leverage Token Market | Bybit API Documentation - +
    Skip to main content

    Get Leverage Token Market​

    Get lt market information

    Query Parameters
    • ltCoin string required

      Levearage coin name. e.g., BTC3L

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/lt/order-record.html b/api-explorer/v5/lt/order-record.html index 490fde4381..dcf1fd868e 100644 --- a/api-explorer/v5/lt/order-record.html +++ b/api-explorer/v5/lt/order-record.html @@ -4,13 +4,13 @@ Get Purchase or Redeem Records | Bybit API Documentation - +
    Skip to main content

    Get Purchase or Redeem Records​

    Get the order history of purchase or redeem

    Query Parameters
    • ltCoin string

      Levearage coin name. e.g., BTC3L

    • orderId string

      Order id

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 100

      Limit size of each page. 1-500

    • ltOrderType integer

      Possible values: [1, 2]

      LT order type. 1=purchase, 2=redeem

    • serialNo string

      Serial number

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/lt/purchase.html b/api-explorer/v5/lt/purchase.html index 1d8bda3175..05c8f97e71 100644 --- a/api-explorer/v5/lt/purchase.html +++ b/api-explorer/v5/lt/purchase.html @@ -4,13 +4,13 @@ Purchase | Bybit API Documentation - +
    Skip to main content

    Purchase​

    Purchase leverage token

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • ltCoin string

      Levearage coin name. e.g., BTC3L

    • ltAmount string

      Purchase amount

    • serialNo string

      Serial number, customised order id

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/lt/redeem.html b/api-explorer/v5/lt/redeem.html index 43a479e4f8..4a8b3cd863 100644 --- a/api-explorer/v5/lt/redeem.html +++ b/api-explorer/v5/lt/redeem.html @@ -4,13 +4,13 @@ Redeem | Bybit API Documentation - +
    Skip to main content

    Redeem​

    Redeem leverage token

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • ltCoin string

      Levearage coin name. e.g., BTC3L

    • quantity string

      Redeem quantity

    • serialNo string

      Serial number, customised order id

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/delivery-price.html b/api-explorer/v5/market/delivery-price.html index 55828a8fa3..8b47c9741e 100644 --- a/api-explorer/v5/market/delivery-price.html +++ b/api-explorer/v5/market/delivery-price.html @@ -4,13 +4,13 @@ Get Delivery Price | Bybit API Documentation - +
    Skip to main content

    Get Delivery Price​

    Get delivery price

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option]

      Product type. linear, inverse, option

    • symbol string

      Symbol name

    • baseCoin string

      Default value: BTC

      Base coin, for option only. Return BTC by default

    • limit string

      Default value: 50

      Maximum 200

    • cursor string

      The cursor, used for pagination

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/history-fund-rate.html b/api-explorer/v5/market/history-fund-rate.html index 0634ef6421..7af3cd07a9 100644 --- a/api-explorer/v5/market/history-fund-rate.html +++ b/api-explorer/v5/market/history-fund-rate.html @@ -4,13 +4,13 @@ Get Funding Rate History | Bybit API Documentation - +
    Skip to main content

    Get Funding Rate History​

    Get historical funding rate

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • startTime integer

      The start timstamp (ms)

    • endTime integer

      The end timstamp (ms)

    • limit integer

      Default value: 200

      Maximum 200

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/index-kline.html b/api-explorer/v5/market/index-kline.html index 603fb8b58e..f4af7b807e 100644 --- a/api-explorer/v5/market/index-kline.html +++ b/api-explorer/v5/market/index-kline.html @@ -4,13 +4,13 @@ Get Index Price Kline | Bybit API Documentation - +
    Skip to main content

    Get Index Price Kline​

    Get Index Price Kline data

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • interval string[] required

      Possible values: [1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, M, W]

      kline interval

    • start integer

      start timestamp (ms). e.g., 1669852800000 (1 DEC 2022 UTC 0:00)

    • end integer

      end timestamp (ms). e.g., 1671062400000 (15 DEC 2022 UTC 0:00)

    • limit integer

      Default value: 200

      Maximum 1000

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/instrument.html b/api-explorer/v5/market/instrument.html index 48fc98bcd4..58c94aee1b 100644 --- a/api-explorer/v5/market/instrument.html +++ b/api-explorer/v5/market/instrument.html @@ -4,13 +4,13 @@ Get Instrument Info | Bybit API Documentation - +
    Skip to main content

    Get Instrument Info​

    Get launched instruments information.

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string

      Symbol name

    • status string

      Possible values: [PreLaunch, Trading, Settling, Delivering, Closed]

      Status filter

    • baseCoin string

      for linear, invere and option ONLY

    • limit integer

      Default value: 500

      Maximum 1000. spot does not have pagination

    • cursor string

      pass cursor from the response param "nagePageCursor" to paginate

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/insurance.html b/api-explorer/v5/market/insurance.html index 4832577cef..ba07e0aefc 100644 --- a/api-explorer/v5/market/insurance.html +++ b/api-explorer/v5/market/insurance.html @@ -4,13 +4,13 @@ Get Insurance | Bybit API Documentation - +
    Skip to main content

    Get Insurance​

    Get Insurance

    Query Parameters
    • coin string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/iv.html b/api-explorer/v5/market/iv.html index 7dc1b2c81f..2057f75bbd 100644 --- a/api-explorer/v5/market/iv.html +++ b/api-explorer/v5/market/iv.html @@ -4,13 +4,13 @@ Get Historical Volatility | Bybit API Documentation - +
    Skip to main content

    Get Historical Volatility​

    Get historical volatility

    Query Parameters
    • category string[] required

      Possible values: [option]

      Product type

    • baseCoin string

      Default value: BTC

      Base coin. If not passed, BTC returned by default

    • period integer[]

      Possible values: [7, 14, 21, 30, 60, 90, 180, 270]

      Period. If not passed, it returns 7 days by default. SOL does not have 180 and 270

    • startTime integer

      The start timstamp (ms)

    • endTime integer

      The end timstamp (ms)

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/kline.html b/api-explorer/v5/market/kline.html index 8727e10424..c0f10e17e6 100644 --- a/api-explorer/v5/market/kline.html +++ b/api-explorer/v5/market/kline.html @@ -4,13 +4,13 @@ Get Kline | Bybit API Documentation - +
    Skip to main content

    Get Kline​

    Get kline data

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, spot]

      Product type

    • symbol string required

      Symbol name

    • interval string[] required

      Possible values: [1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, M, W]

      kline interval

    • start integer

      start timestamp (ms). e.g., 1669852800000 (1 DEC 2022 UTC 0:00)

    • end integer

      end timestamp (ms). e.g., 1671062400000 (15 DEC 2022 UTC 0:00)

    • limit integer

      Default value: 200

      Maximum 1000

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/long-short-ratio.html b/api-explorer/v5/market/long-short-ratio.html index 1949870e6a..2b67678c25 100644 --- a/api-explorer/v5/market/long-short-ratio.html +++ b/api-explorer/v5/market/long-short-ratio.html @@ -4,13 +4,13 @@ Get Long Short Ratio | Bybit API Documentation - +
    Skip to main content

    Get Long Short Ratio​

    Get long short ratio

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • period string[] required

      Possible values: [5min, 15min, 30min, 1h, 4h, 1d]

      period

    • limit integer

      Default value: 50

      Maximum 500

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/mark-kline.html b/api-explorer/v5/market/mark-kline.html index 14552dea72..928238e17a 100644 --- a/api-explorer/v5/market/mark-kline.html +++ b/api-explorer/v5/market/mark-kline.html @@ -4,13 +4,13 @@ Get Mark Price Kline | Bybit API Documentation - +
    Skip to main content

    Get Mark Price Kline​

    Get Mark Price Kline data

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, spot]

      Product type

    • symbol string required

      Symbol name

    • interval string[] required

      Possible values: [1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, M, W]

      kline interval

    • start integer

      start timestamp (ms). e.g., 1669852800000 (1 DEC 2022 UTC 0:00)

    • end integer

      end timestamp (ms). e.g., 1671062400000 (15 DEC 2022 UTC 0:00)

    • limit integer

      Default value: 200

      Maximum 1000

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/market.html b/api-explorer/v5/market/market.html index 2784603311..2447ab724b 100644 --- a/api-explorer/v5/market/market.html +++ b/api-explorer/v5/market/market.html @@ -4,13 +4,13 @@ Market | Bybit API Documentation - +
    Skip to main content

    Market

    Market endpoints

    - + \ No newline at end of file diff --git a/api-explorer/v5/market/open-interest.html b/api-explorer/v5/market/open-interest.html index 49e6d12e65..42326264f4 100644 --- a/api-explorer/v5/market/open-interest.html +++ b/api-explorer/v5/market/open-interest.html @@ -4,13 +4,13 @@ Get Open Interest | Bybit API Documentation - +
    Skip to main content

    Get Open Interest​

    Get open interest

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • intervalTime string[] required

      Possible values: [5min, 15min, 30min, 1h, 4h, 1d]

      interval time

    • startTime integer

      The start timstamp (ms)

    • endTime integer

      The end timstamp (ms)

    • limit integer

      Default value: 50

      Maximum 200

    • cursor string

      pass cursor from the response param "nagePageCursor" to paginate

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/orderbook.html b/api-explorer/v5/market/orderbook.html index f7a7cdd1c6..18dea54960 100644 --- a/api-explorer/v5/market/orderbook.html +++ b/api-explorer/v5/market/orderbook.html @@ -4,13 +4,13 @@ Get Orderbook | Bybit API Documentation - +
    Skip to main content

    Get Orderbook​

    Get order book data

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name

    • limit integer

      spot：1-50，default：1. linear&inverse：1-200，default：25. option：1-25，default：1

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/premium-index-kline.html b/api-explorer/v5/market/premium-index-kline.html index a227e201cf..564dbb69ca 100644 --- a/api-explorer/v5/market/premium-index-kline.html +++ b/api-explorer/v5/market/premium-index-kline.html @@ -4,13 +4,13 @@ Get Premium Index Price Kline | Bybit API Documentation - +
    Skip to main content

    Get Premium Index Price Kline​

    Get Premium Index Price Kline data

    Query Parameters
    • category string[] required

      Possible values: [linear]

      Product type

    • symbol string required

      Symbol name

    • interval string[] required

      Possible values: [1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, M, W]

      kline interval

    • start integer

      start timestamp (ms). e.g., 1669852800000 (1 DEC 2022 UTC 0:00)

    • end integer

      end timestamp (ms). e.g., 1671062400000 (15 DEC 2022 UTC 0:00)

    • limit integer

      Default value: 200

      Maximum 1000

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/recent-trade.html b/api-explorer/v5/market/recent-trade.html index c36505f500..79ff8f4caf 100644 --- a/api-explorer/v5/market/recent-trade.html +++ b/api-explorer/v5/market/recent-trade.html @@ -4,13 +4,13 @@ Get Public Recent Trading History | Bybit API Documentation - +
    Skip to main content

    Get Public Recent Trading History​

    Get public trade

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name.

    • baseCoin string

      Default value: BTC

      Base coin. Valid for option. Default is BTC

    • optionType string

      Possible values: [Call, Put]

      Option type. Valid for option.

    • limit integer

      Maximum 60 for spot. Maximum 1000 for others

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/risk-limit.html b/api-explorer/v5/market/risk-limit.html index 966cce79bf..3f173ff93d 100644 --- a/api-explorer/v5/market/risk-limit.html +++ b/api-explorer/v5/market/risk-limit.html @@ -4,13 +4,13 @@ Get Risk Limit | Bybit API Documentation - +
    Skip to main content

    Get Risk Limit​

    Get risk limit

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string

      Symbol name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/tickers.html b/api-explorer/v5/market/tickers.html index be64ab1fc9..d1bc35a2b0 100644 --- a/api-explorer/v5/market/tickers.html +++ b/api-explorer/v5/market/tickers.html @@ -4,13 +4,13 @@ Get Tickers | Bybit API Documentation - +
    Skip to main content

    Get Tickers​

    Get all latest information of symbols. All parameters are needed for OPTION

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option, spot]

      Product type

    • baseCoin string

      for option ONLY, baseCoin or symbol must be passed when query option

    • expDate string

      Expiry date. For option only. Default is all, and the parameter format is 25MAR22.

    • symbol string

      Symbol name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/market/time.html b/api-explorer/v5/market/time.html index 3dcbb59438..1113b83589 100644 --- a/api-explorer/v5/market/time.html +++ b/api-explorer/v5/market/time.html @@ -4,13 +4,13 @@ Get Bybit Server Time | Bybit API Documentation - +
    Skip to main content

    Get Bybit Server Time​

    Get server time

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/auto-add-margin.html b/api-explorer/v5/position/auto-add-margin.html index d8a834d6f9..6cf2fa55aa 100644 --- a/api-explorer/v5/position/auto-add-margin.html +++ b/api-explorer/v5/position/auto-add-margin.html @@ -4,13 +4,13 @@ Set Auto Add Margin | Bybit API Documentation - +
    Skip to main content

    Set Auto Add Margin​

    Set Auto Add Margin

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • autoAddMargin integer required

      0 - turn off, 1 - turn on

    • positionIdx integer required

      Possible values: [0, 1, 2]

      Position index. 0=one-way-mode, 1=buy-hedge-mode, 2=sell-hedege-mode. REQUIRED for hedge-mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/close-pnl.html b/api-explorer/v5/position/close-pnl.html index 232ca6569e..c373335bdd 100644 --- a/api-explorer/v5/position/close-pnl.html +++ b/api-explorer/v5/position/close-pnl.html @@ -4,13 +4,13 @@ Get Closed PnL | Bybit API Documentation - +
    Skip to main content

    Get Closed PnL​

    Get closed pnl

    Query Parameters
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string

      Symbol name

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      1-200. max 200

    • cursor string

      cursor for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/cross-isolate.html b/api-explorer/v5/position/cross-isolate.html index fde4eeda3f..9534195c7f 100644 --- a/api-explorer/v5/position/cross-isolate.html +++ b/api-explorer/v5/position/cross-isolate.html @@ -4,13 +4,13 @@ Switch Cross/Isolated Margin | Bybit API Documentation - +
    Skip to main content

    Switch Cross/Isolated Margin​

    Select cross margin mode or isolated margin mode

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • tradeMode integer required

      Possible values: [0, 1]

      0 - cross margin, 1 - isolated margin

    • buyLeverage string

      Buy side leverage

    • sellLeverage string

      Sell side leverage

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/execution.html b/api-explorer/v5/position/execution.html index c86bfe4971..a5790a549d 100644 --- a/api-explorer/v5/position/execution.html +++ b/api-explorer/v5/position/execution.html @@ -4,13 +4,13 @@ Get Execution (2 years) | Bybit API Documentation - +
    Skip to main content

    Get Execution (2 years)​

    Get execution list

    Query Parameters
    • category string required

      Possible values: [linear, inverse, spot, option]

      Product type

    • symbol string

      Symbol name

    • baseCoin string

      Base coin

    • orderId string
    • orderLinkId string

      User customised order id

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • execType string

      Possible values: [Trade, AdlTrade, Funding, BustTrade, Settle]

      Execution type

    • limit integer

      Default value: 50

      1-100. max 100

    • cursor string

      cursor to pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/leverage.html b/api-explorer/v5/position/leverage.html index 1779b23f80..f1abe6f8a0 100644 --- a/api-explorer/v5/position/leverage.html +++ b/api-explorer/v5/position/leverage.html @@ -4,13 +4,13 @@ Set Leverage | Bybit API Documentation - +
    Skip to main content

    Set Leverage​

    Set levearage.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • buyLeverage string

      Buy side leverage

    • sellLeverage string

      Sell side leverage

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/manual-add-margin.html b/api-explorer/v5/position/manual-add-margin.html index 1f15560034..7075c60dc2 100644 --- a/api-explorer/v5/position/manual-add-margin.html +++ b/api-explorer/v5/position/manual-add-margin.html @@ -4,13 +4,13 @@ Add Or Reduce Margin | Bybit API Documentation - +
    Skip to main content

    Add Or Reduce Margin​

    Manually add or reduce margin for isolated margin position

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • margin string required

      10 - add, -10 - reduce

    • positionIdx integer required

      Possible values: [0, 1, 2]

      Position index. 0=one-way-mode, 1=buy-hedge-mode, 2=sell-hedege-mode. REQUIRED for hedge-mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/position-info.html b/api-explorer/v5/position/position-info.html index 20b12de076..40a567c946 100644 --- a/api-explorer/v5/position/position-info.html +++ b/api-explorer/v5/position/position-info.html @@ -4,13 +4,13 @@ Get Position Info | Bybit API Documentation - +
    Skip to main content

    Get Position Info​

    Get Position Info

    Query Parameters
    • category string required

      Possible values: [linear, inverse, option]

      Product type

    • symbol string

      Symbol name

    • baseCoin string

      Base coin. For option only

    • settleCoin string

      Used for linear & inverse, symbol or settleCoin is required

    • limit integer

      Default value: 20

      1-200. max 200

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/position-mode.html b/api-explorer/v5/position/position-mode.html index 30b942f806..c48712fab9 100644 --- a/api-explorer/v5/position/position-mode.html +++ b/api-explorer/v5/position/position-mode.html @@ -4,13 +4,13 @@ Switch Position Mode | Bybit API Documentation - +
    Skip to main content

    Switch Position Mode​

    Switch Position Mode

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string

      Symbol name

    • coin string

      Coin name

    • mode integer required

      Possible values: [0, 3]

      Position mode. 0 - Merged single, 3 - Both sides

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/position.html b/api-explorer/v5/position/position.html index efea6907af..ae13357fc3 100644 --- a/api-explorer/v5/position/position.html +++ b/api-explorer/v5/position/position.html @@ -4,13 +4,13 @@ Position | Bybit API Documentation - +
    Skip to main content

    Position

    All Position v5 REST API.

    - + \ No newline at end of file diff --git a/api-explorer/v5/position/set-risk-limit.html b/api-explorer/v5/position/set-risk-limit.html index 85fa5e5b0f..49c6eb204f 100644 --- a/api-explorer/v5/position/set-risk-limit.html +++ b/api-explorer/v5/position/set-risk-limit.html @@ -4,13 +4,13 @@ Set Risk Limit | Bybit API Documentation - +
    Skip to main content

    Set Risk Limit​

    Set risk limit.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • riskId integer required

      Risk limit id

    • positionIdx integer

      Possible values: [0, 1, 2]

      Position index. 0=one-way-mode, 1=buy-hedge-mode, 2=sell-hedege-mode. REQUIRED for hedge-mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/tpsl-mode.html b/api-explorer/v5/position/tpsl-mode.html index 9f67ea2375..c2a87d610a 100644 --- a/api-explorer/v5/position/tpsl-mode.html +++ b/api-explorer/v5/position/tpsl-mode.html @@ -4,13 +4,13 @@ Set TP/SL Mode | Bybit API Documentation - +
    Skip to main content

    Set TP/SL Mode​

    Set tp/sl mode.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • tpSlMode string required

      Possible values: [Full, Partial]

      Full = full position TP/SL, Partial = partial mode tp/sl

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/position/trading-stop.html b/api-explorer/v5/position/trading-stop.html index c2f75c975e..694079afec 100644 --- a/api-explorer/v5/position/trading-stop.html +++ b/api-explorer/v5/position/trading-stop.html @@ -4,13 +4,13 @@ Set Trading Stop | Bybit API Documentation - +
    Skip to main content

    Set Trading Stop​

    Set trade stop.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • takeProfit string

      Take profit price

    • stopLoss string

      Stop loss price

    • tpSize string

      Take profit size

    • slSize string

      Stop loss size

    • tpTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Take profit trigger price type

    • slTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Stop loss trigger price type

    • trailingStop string

      Trailing stop

    • activePrice string

      Trailing stop trigger price

    • positionIdx integer required

      Possible values: [0, 1, 2]

      Position index. 0=one-way-mode, 1=buy-hedge-mode, 2=sell-hedege-mode. REQUIRED for hedge-mode

    • tpLimitPrice string

      The limit order price when take profit price is triggered

    • slLimitPrice string

      The limit order price when stop loss price is triggered

    • tpOrderType string

      Possible values: [Market, Limit]

      The order type when take profit is triggered

    • slOrderType string

      Possible values: [Market, Limit]

      The order type when stop loss is triggered

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/account-info.html b/api-explorer/v5/spot-margin-normal/account-info.html index 00dd5b292c..849e0b4692 100644 --- a/api-explorer/v5/spot-margin-normal/account-info.html +++ b/api-explorer/v5/spot-margin-normal/account-info.html @@ -4,13 +4,13 @@ Get Loan Account Info | Bybit API Documentation - +
    Skip to main content

    Get Loan Account Info​

    Get Loan Account Info

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/borrow-order.html b/api-explorer/v5/spot-margin-normal/borrow-order.html index 6a0cee4d64..758fd4e544 100644 --- a/api-explorer/v5/spot-margin-normal/borrow-order.html +++ b/api-explorer/v5/spot-margin-normal/borrow-order.html @@ -4,13 +4,13 @@ Get Borrow Order Detail | Bybit API Documentation - +
    Skip to main content

    Get Borrow Order Detail​

    Get Borrow Order Detail

    Query Parameters
    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • coin string

      Coin name

    • status string

      Possible values: [0, 1, 2]

      Status filter. 0：get all kinds of status, 1：uncleared, 2：cleared

    • limit integer

      Limit for data size per page. 1 - 500. Default：500

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/borrow.html b/api-explorer/v5/spot-margin-normal/borrow.html index 5064d718b1..ee4d56198d 100644 --- a/api-explorer/v5/spot-margin-normal/borrow.html +++ b/api-explorer/v5/spot-margin-normal/borrow.html @@ -4,13 +4,13 @@ Borrow | Bybit API Documentation - +
    Skip to main content

    Borrow​

    Borrow

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Request Body
    • coin string

      Coin name

    • qty string

      Amount to borrow

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/borrowable-data.html b/api-explorer/v5/spot-margin-normal/borrowable-data.html index d3acbe5a2f..2eac2e6485 100644 --- a/api-explorer/v5/spot-margin-normal/borrowable-data.html +++ b/api-explorer/v5/spot-margin-normal/borrowable-data.html @@ -4,13 +4,13 @@ Get Borrowable Coin Info | Bybit API Documentation - +
    Skip to main content

    Get Borrowable Coin Info​

    Get Borrowable Coin Info

    Query Parameters
    • coin string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/interest-quota.html b/api-explorer/v5/spot-margin-normal/interest-quota.html index 763d518038..0254a5cadd 100644 --- a/api-explorer/v5/spot-margin-normal/interest-quota.html +++ b/api-explorer/v5/spot-margin-normal/interest-quota.html @@ -4,13 +4,13 @@ Get Interest & Quota | Bybit API Documentation - +
    Skip to main content

    Get Interest & Quota​

    Get Interest & Quota

    Query Parameters
    • coin string required

      Coin name

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/margin-data.html b/api-explorer/v5/spot-margin-normal/margin-data.html index b299540196..c8d60b7725 100644 --- a/api-explorer/v5/spot-margin-normal/margin-data.html +++ b/api-explorer/v5/spot-margin-normal/margin-data.html @@ -4,13 +4,13 @@ Get Margin Coin Info | Bybit API Documentation - +
    Skip to main content

    Get Margin Coin Info​

    Get Margin Coin Info

    Query Parameters
    • coin string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/normal-margin-trade.html b/api-explorer/v5/spot-margin-normal/normal-margin-trade.html index c8e5d9d883..38b7772e5d 100644 --- a/api-explorer/v5/spot-margin-normal/normal-margin-trade.html +++ b/api-explorer/v5/spot-margin-normal/normal-margin-trade.html @@ -4,13 +4,13 @@ Spot Margin Trade (Classic) | Bybit API Documentation - +
    Skip to main content

    Spot Margin Trade (Classic)

    Spot margin trade (Classic) endpoints

    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/repay-order.html b/api-explorer/v5/spot-margin-normal/repay-order.html index 49d8ab19ae..3d86603037 100644 --- a/api-explorer/v5/spot-margin-normal/repay-order.html +++ b/api-explorer/v5/spot-margin-normal/repay-order.html @@ -4,13 +4,13 @@ Get Repayment Order Detail | Bybit API Documentation - +
    Skip to main content

    Get Repayment Order Detail​

    Get Repayment Order Detail

    Query Parameters
    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • coin string

      Coin name

    • limit integer

      Limit for data size per page. 1 - 500. Default：500

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/repay.html b/api-explorer/v5/spot-margin-normal/repay.html index 388e68e2a0..9c2c3f4ac9 100644 --- a/api-explorer/v5/spot-margin-normal/repay.html +++ b/api-explorer/v5/spot-margin-normal/repay.html @@ -4,13 +4,13 @@ Repay | Bybit API Documentation - +
    Skip to main content

    Repay​

    Repay

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Request Body
    • coin string

      Coin name

    • qty string

      Amount to repay

    • completeRepayment integer

      Possible values: [0, 1]

      Whether to pay off all debts. 0：false, 1：true

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/switch-mode.html b/api-explorer/v5/spot-margin-normal/switch-mode.html index 97bca378b6..7695657378 100644 --- a/api-explorer/v5/spot-margin-normal/switch-mode.html +++ b/api-explorer/v5/spot-margin-normal/switch-mode.html @@ -4,13 +4,13 @@ Toggle Margin Trade | Bybit API Documentation - +
    Skip to main content

    Toggle Margin Trade​

    Toggle Margin Trade

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Request Body
    • switch integer

      1：on, 0：off

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-normal/vip-margin.html b/api-explorer/v5/spot-margin-normal/vip-margin.html index f7f3f32474..24b1ba360c 100644 --- a/api-explorer/v5/spot-margin-normal/vip-margin.html +++ b/api-explorer/v5/spot-margin-normal/vip-margin.html @@ -4,13 +4,13 @@ Get VIP Margin Data | Bybit API Documentation - +
    Skip to main content

    Get VIP Margin Data​

    Get vip margin data

    Query Parameters
    • vipLevel string[]

      Possible values: [No VIP, VIP-1, VIP-2, VIP-3, VIP-4, VIP-5, PRO-1, PRO-2, PRO-3, PRO-4, PRO-5]

      VIP level

    • currency string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-uta/set-leverage.html b/api-explorer/v5/spot-margin-uta/set-leverage.html index bf7bff0b9b..7a7af11734 100644 --- a/api-explorer/v5/spot-margin-uta/set-leverage.html +++ b/api-explorer/v5/spot-margin-uta/set-leverage.html @@ -4,13 +4,13 @@ Set Leverage | Bybit API Documentation - +
    Skip to main content

    Set Leverage​

    Set leverage for margin trade

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • leverage integer

      Possible values: [2, 3, 4, 5, 6, 7, 8, 9, 10]

      Levearge, support 2-10

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-uta/status.html b/api-explorer/v5/spot-margin-uta/status.html index 4060eaff02..db34056ea7 100644 --- a/api-explorer/v5/spot-margin-uta/status.html +++ b/api-explorer/v5/spot-margin-uta/status.html @@ -4,13 +4,13 @@ Get Status And Leverage | Bybit API Documentation - +
    Skip to main content

    Get Status And Leverage​

    Get status and leverage

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-uta/switch-mode.html b/api-explorer/v5/spot-margin-uta/switch-mode.html index ad328f3a17..0b6efebe95 100644 --- a/api-explorer/v5/spot-margin-uta/switch-mode.html +++ b/api-explorer/v5/spot-margin-uta/switch-mode.html @@ -4,13 +4,13 @@ Toggle Margin Trade | Bybit API Documentation - +
    Skip to main content

    Toggle Margin Trade​

    Toggle margin trade

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • spotMarginMode integer

      Possible values: [0, 1]

      Margin mode. 0=off, 1=on

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-uta/uta-margin-trade.html b/api-explorer/v5/spot-margin-uta/uta-margin-trade.html index 3db53b7a9c..7c1bc67c02 100644 --- a/api-explorer/v5/spot-margin-uta/uta-margin-trade.html +++ b/api-explorer/v5/spot-margin-uta/uta-margin-trade.html @@ -4,13 +4,13 @@ Spot Margin Trade (UTA) | Bybit API Documentation - +
    Skip to main content
    - + \ No newline at end of file diff --git a/api-explorer/v5/spot-margin-uta/vip-margin.html b/api-explorer/v5/spot-margin-uta/vip-margin.html index 90097d3bec..ac2a975835 100644 --- a/api-explorer/v5/spot-margin-uta/vip-margin.html +++ b/api-explorer/v5/spot-margin-uta/vip-margin.html @@ -4,13 +4,13 @@ Get VIP Margin Data | Bybit API Documentation - +
    Skip to main content

    Get VIP Margin Data​

    Get vip margin data

    Query Parameters
    • vipLevel string[]

      Possible values: [No VIP, VIP-1, VIP-2, VIP-3, VIP-4, VIP-5, PRO-1, PRO-2, PRO-3, PRO-4, PRO-5]

      VIP level

    • currency string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/amend-order.html b/api-explorer/v5/trade/amend-order.html index 19b378450b..c29052d867 100644 --- a/api-explorer/v5/trade/amend-order.html +++ b/api-explorer/v5/trade/amend-order.html @@ -4,13 +4,13 @@ Amend Order | Bybit API Documentation - +
    Skip to main content

    Amend Order​

    Amend an order.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name

    • orderId string

      Either orderId or orderLinkId is required

    • orderLinkId string

      Either orderId or orderLinkId is required

    • qty string

      Modify the order qty

    • price string

      Modify the order price

    • orderIv string

      Modify option order iv

    • triggerPrice string

      Modify StopOrder trigger price

    • tpslMode string

      Possible values: [Full, Partial]

      Full：TPSL for full size, Partial：TPSL for partial size

    • takeProfit string

      Modify take profit price

    • stopLoss string

      Modify stop loss price

    • triggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Modify the type of trigger price

    • tpTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Modify trigger take profit price price type

    • slTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Modify trigger stop loss price price type

    • tpLimitPrice string

      The limit order price when take profit price is triggered

    • slLimitPrice string

      The limit order price when stop loss price is triggered

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/batch-amend.html b/api-explorer/v5/trade/batch-amend.html index 6aaa7ae35d..3f39f8a46e 100644 --- a/api-explorer/v5/trade/batch-amend.html +++ b/api-explorer/v5/trade/batch-amend.html @@ -4,13 +4,13 @@ Batch Amend Order | Bybit API Documentation - +
    Skip to main content

    Batch Amend Order​

    Batch amend orders

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [option, linear]

      Product type

    • request object[] required

      Possible values: <= 10

    • symbol string required

      Symbol name

    • orderId string

      Either orderId or orderLinkId is required

    • orderLinkId string

      Either orderId or orderLinkId is required

    • qty string

      Modify the order qty

    • price string

      Modify the order price

    • orderIv string

      Modify option order iv

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/batch-cancel.html b/api-explorer/v5/trade/batch-cancel.html index 8cce83a952..456ccab5c8 100644 --- a/api-explorer/v5/trade/batch-cancel.html +++ b/api-explorer/v5/trade/batch-cancel.html @@ -4,13 +4,13 @@ Batch Cancel Order | Bybit API Documentation - +
    Skip to main content

    Batch Cancel Order​

    Batch cancel orders

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [option, linear]

      Product type

    • request object[] required

      Possible values: <= 10

    • symbol string required

      Symbol name

    • orderId string

      Either orderId or orderLinkId is required

    • orderLinkId string

      Either orderId or orderLinkId is required

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/batch-place.html b/api-explorer/v5/trade/batch-place.html index 2ea39bb0d8..8c07175ae6 100644 --- a/api-explorer/v5/trade/batch-place.html +++ b/api-explorer/v5/trade/batch-place.html @@ -4,13 +4,13 @@ Batch Place Order | Bybit API Documentation - +
    Skip to main content

    Batch Place Order​

    Batch place orders

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [option, linear]

      Product type. linear, option

    • request object[] required

      Possible values: <= 10

    • symbol string required

      Symbol name

    • side string required

      Possible values: [Buy, Sell]

    • orderType string required

      Possible values: [Market, Limit]

      Order type

    • qty string required
    • price string
    • orderIv string
    • timeInForce string required

      Possible values: [GTC, IOC, FOK, PostOnly]

      Time in force

    • positionIdx integer

      Possible values: [0]

      Position mode. one-way mode only for unified.

    • orderLinkId string required

      REQUIRED param when place an option order

    • reduceOnly boolean

      Possible values: [true, false]

      specify true if a close position order

    • mmp boolean

      Possible values: [true, false]

      enable market marker protection

    • smpType string

      Possible values: [None, CancelMaker, CancelTaker, CancelBoth]

      Smp execution type

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/cancel-all.html b/api-explorer/v5/trade/cancel-all.html index 3f3c20b8c1..f222676a2e 100644 --- a/api-explorer/v5/trade/cancel-all.html +++ b/api-explorer/v5/trade/cancel-all.html @@ -4,13 +4,13 @@ Cancel All Orders | Bybit API Documentation - +
    Skip to main content

    Cancel All Orders​

    Cancel all orders.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string

      Symbol name. Required if not passing baseCoin or settleCoin

    • baseCoin string

      Cancel by base coin. Required if not passing symbol or settleCoin

    • settleCoin string

      Cancel by settle coin. Does not support spot. Required if not passing symbol or baseCoin

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/cancel-order.html b/api-explorer/v5/trade/cancel-order.html index dd782c0675..a060ca2d28 100644 --- a/api-explorer/v5/trade/cancel-order.html +++ b/api-explorer/v5/trade/cancel-order.html @@ -4,13 +4,13 @@ Cancel Order | Bybit API Documentation - +
    Skip to main content

    Cancel Order​

    Cancel a single order.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name

    • orderId string

      Either orderId or orderLinkId is required

    • orderLinkId string

      Either orderId or orderLinkId is required

    • orderFilter string

      Possible values: [Order, tpslOrder, StopOrder]

      Default value: Order

      Take profit stop loss or ordinary order. Only valid for spot.

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/create-order.html b/api-explorer/v5/trade/create-order.html index 4d517745da..63f7c391e6 100644 --- a/api-explorer/v5/trade/create-order.html +++ b/api-explorer/v5/trade/create-order.html @@ -4,13 +4,13 @@ Place Order | Bybit API Documentation - +
    Skip to main content

    Place Order​

    Place an order.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name

    • isLeverage integer

      Possible values: [0, 1]

      Whether to loan, only for spot. 0:No;1:Yes.

    • side string required

      Possible values: [Buy, Sell]

    • orderType string required

      Possible values: [Market, Limit]

      Order type

    • qty string required

      Order qty

    • price string

      ignore it if Market order

    • triggerPrice string

      param for StopOrder

    • triggerDirection integer

      param for StopOrder. 1=rise, 2=fall

    • triggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      param for StopOrder

    • orderFilter string

      Possible values: [Order, tpslOrder, StopOrder]

      Default value: Order

      Take profit stop loss, normal order or conditional order. Only valid for spot.

    • orderIv string

      Implied volatility. param for option order

    • timeInForce string

      Possible values: [GTC, IOC, FOK, PostOnly]

      Time in force

    • positionIdx integer

      Possible values: [0, 1, 2]

      0=one-way mode, 1=buy-hedge-mode, 2=sell-hedge-mode

    • orderLinkId string

      required param for option order

    • takeProfit string

      Take profit price

    • stopLoss string

      Stop loss price

    • tpTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Trigger take profit price price type

    • slTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Trigger stop loss price price type

    • reduceOnly boolean

      Possible values: [true, false]

      specify true if a close position order

    • closeOnTrigger boolean

      Possible values: [true, false]

      close on trigger

    • smpType string

      Possible values: [None, CancelMaker, CancelTaker, CancelBoth]

      Smp execution type

    • mmp boolean

      Possible values: [true, false]

      market marker protection. for option order

    • tpslMode string

      Possible values: [Full, Partial]

      TP/SL mode

    • tpLimitPrice string

      The limit order price when take profit price is triggered

    • slLimitPrice string

      The limit order price when stop loss price is triggered

    • tpOrderType string

      Possible values: [Market, Limit]

      The order type when take profit is triggered

    • slOrderType string

      Possible values: [Market, Limit]

      The order type when stop loss is triggered

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/open-order.html b/api-explorer/v5/trade/open-order.html index 65a1312c09..413de2ad68 100644 --- a/api-explorer/v5/trade/open-order.html +++ b/api-explorer/v5/trade/open-order.html @@ -4,13 +4,13 @@ Get Open Orders (real-time) | Bybit API Documentation - +
    Skip to main content

    Get Open Orders (real-time)​

    Get unfilled orders or partially filled orders

    Query Parameters
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string

      Symbol name

    • baseCoin string

      Base coin

    • settleCoin string

      Settle coin. Spot is not available

    • orderId string
    • orderLinkId string

      User customised order id

    • orderFilter string

      Possible values: [Order, StopOrder, tpslOrder]

      Order filter. Default：all kinds of orders

    • openOnly integer

      Possible values: [0, 1, 2]

      Whether to only query active orders, if openOnly = 0, only get active orders. If it is 1, return only the order data of the final status (cancelled/rejected/completely filled, etc.) in the last 10 minutes

    • limit integer

      Default value: 20

      1-50. max 50

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/order-list.html b/api-explorer/v5/trade/order-list.html index 78e3b6a920..64b7c31561 100644 --- a/api-explorer/v5/trade/order-list.html +++ b/api-explorer/v5/trade/order-list.html @@ -4,13 +4,13 @@ Get Order History (2 years) | Bybit API Documentation - +
    Skip to main content

    Get Order History (2 years)​

    Get order history.

    Query Parameters
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string

      Symbol name

    • baseCoin string

      Base coin

    • orderId string
    • orderLinkId string

      User customised order id

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • orderStatus string

      Possible values: [Created, New, Rejected, PartiallyFilled, PartillyFilledCancelled, Filled, PendingCancel, Cancelled, Untriggered, Triggered, Deactivated, Active]

      Order status

    • orderFilter string

      Possible values: [Order, StopOrder, tpslOrder]

      Order filter

    • limit integer

      Default value: 20

      1-50. max 50

    • cursor string

      cursor to pagnition

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/query-spot-quota.html b/api-explorer/v5/trade/query-spot-quota.html index 5cc49c4dd2..fa804f4b9c 100644 --- a/api-explorer/v5/trade/query-spot-quota.html +++ b/api-explorer/v5/trade/query-spot-quota.html @@ -4,13 +4,13 @@ Get Borrow Quota (Spot) | Bybit API Documentation - +
    Skip to main content

    Get Borrow Quota (Spot)​

    Query user's spot available quota

    Query Parameters
    • category string required

      Possible values: [spot]

      Product type

    • symbol string required

      Symbol name

    • side string required

      Possible values: [Buy, Sell]

      Buy or Sell

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/trade/trade.html b/api-explorer/v5/trade/trade.html index f7b3e92aa7..779a0ae925 100644 --- a/api-explorer/v5/trade/trade.html +++ b/api-explorer/v5/trade/trade.html @@ -4,13 +4,13 @@ Trade | Bybit API Documentation - +
    Skip to main content

    Trade

    All trade v5 REST API.

    - + \ No newline at end of file diff --git a/api-explorer/v5/user/affiliate-info.html b/api-explorer/v5/user/affiliate-info.html index 0fdb091ade..c4d483ce4e 100644 --- a/api-explorer/v5/user/affiliate-info.html +++ b/api-explorer/v5/user/affiliate-info.html @@ -4,13 +4,13 @@ Get Affiliate User Info | Bybit API Documentation - +
    Skip to main content

    Get Affiliate User Info​

    Get affiliate user info

    Query Parameters
    • uid string required

      The main UID of referral

    Header Parameters
    • apiKey string

      Please use the key with "Affiliate" permission

    • secret string

      Please use the key with "Affiliate" permission

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/user/apikey-info.html b/api-explorer/v5/user/apikey-info.html index 162f141ac0..0e11b92ba8 100644 --- a/api-explorer/v5/user/apikey-info.html +++ b/api-explorer/v5/user/apikey-info.html @@ -4,13 +4,13 @@ Get API Key Information | Bybit API Documentation - +
    Skip to main content

    Get API Key Information​

    Get API Key Information

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/user/list-sub-apikeys.html b/api-explorer/v5/user/list-sub-apikeys.html index fb20c28759..0d2f1c244e 100644 --- a/api-explorer/v5/user/list-sub-apikeys.html +++ b/api-explorer/v5/user/list-sub-apikeys.html @@ -4,13 +4,13 @@ Get Sub Account All API Keys | Bybit API Documentation - +
    Skip to main content

    Get Sub Account All API Keys​

    Get Sub Account All API Keys

    Query Parameters
    • subMemberId string required

      Sub UID

    • limit integer

      Default value: 20

      1-20. max 20

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string required

      Please use main account API key

    • secret string required

      Please use main account secret key

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/api-explorer/v5/user/user.html b/api-explorer/v5/user/user.html index b74b9d1174..3b0ca44c2e 100644 --- a/api-explorer/v5/user/user.html +++ b/api-explorer/v5/user/user.html @@ -4,13 +4,13 @@ User | Bybit API Documentation - +
    Skip to main content
    - + \ No newline at end of file diff --git a/api-explorer/v5/user/wallet-type.html b/api-explorer/v5/user/wallet-type.html index 46dce7a7d6..eef9fc12e8 100644 --- a/api-explorer/v5/user/wallet-type.html +++ b/api-explorer/v5/user/wallet-type.html @@ -4,13 +4,13 @@ Get UID Wallet Type | Bybit API Documentation - +
    Skip to main content

    Get UID Wallet Type​

    Get uid wallet type

    Query Parameters
    • memberIds string

      Main UID or Sub UIDs

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/assets/js/0b0bc04d.2a5c979f.js b/assets/js/0b0bc04d.d6ad61d8.js similarity index 96% rename from assets/js/0b0bc04d.2a5c979f.js rename to assets/js/0b0bc04d.d6ad61d8.js index f4ab93bea0..9aa8ad9016 100644 --- a/assets/js/0b0bc04d.2a5c979f.js +++ b/assets/js/0b0bc04d.d6ad61d8.js @@ -1 +1 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[12717],{3905:(t,e,l)=>{l.d(e,{Zo:()=>s,kt:()=>p});var n=l(67294);function r(t,e,l){return e in t?Object.defineProperty(t,e,{value:l,enumerable:!0,configurable:!0,writable:!0}):t[e]=l,t}function a(t,e){var l=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),l.push.apply(l,n)}return l}function i(t){for(var e=1;e=0||(r[l]=t[l]);return r}(t,e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(t,l)&&(r[l]=t[l])}return r}var k=n.createContext({}),u=function(t){var e=n.useContext(k),l=e;return t&&(l="function"==typeof t?t(e):i(i({},e),t)),l},s=function(t){var e=u(t.components);return n.createElement(k.Provider,{value:e},t.children)},o={inlineCode:"code",wrapper:function(t){var e=t.children;return n.createElement(n.Fragment,{},e)}},c=n.forwardRef((function(t,e){var l=t.components,r=t.mdxType,a=t.originalType,k=t.parentName,s=d(t,["components","mdxType","originalType","parentName"]),c=u(l),p=r,m=c["".concat(k,".").concat(p)]||c[p]||o[p]||a;return l?n.createElement(m,i(i({ref:e},s),{},{components:l})):n.createElement(m,i({ref:e},s))}));function p(t,e){var l=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var a=l.length,i=new Array(a);i[0]=c;var d={};for(var k in e)hasOwnProperty.call(e,k)&&(d[k]=e[k]);d.originalType=t,d.mdxType="string"==typeof t?t:r,i[1]=d;for(var u=2;u{l.r(e),l.d(e,{assets:()=>k,contentTitle:()=>i,default:()=>m,frontMatter:()=>a,metadata:()=>d,toc:()=>u});var n=l(87462),r=(l(67294),l(3905));const a={title:"Rate Limit",sidebar_label:"Rate Limit"},i=void 0,d={unversionedId:"v5/rate-limit",id:"v5/rate-limit",title:"Rate Limit",description:"IP Rate Limit",source:"@site/docs/v5/rate-limit.mdx",sourceDirName:"v5",slug:"/v5/rate-limit",permalink:"/docs/v5/rate-limit",draft:!1,tags:[],version:"current",frontMatter:{title:"Rate Limit",sidebar_label:"Rate Limit"},sidebar:"v5SideBar",previous:{title:"Websocket Trade Guideline",permalink:"/docs/v5/websocket/trade/guideline"},next:{title:"Enums Definitions",permalink:"/docs/v5/enum"}},k={},u=[{value:"IP Rate Limit",id:"ip-rate-limit",level:2},{value:"API Rate Limit",id:"api-rate-limit",level:2},{value:"API Rate Limit Table",id:"api-rate-limit-table",level:3},{value:"Trade",id:"trade",level:4},{value:"Position",id:"position",level:4},{value:"Account",id:"account",level:4},{value:"Asset",id:"asset",level:4},{value:"User",id:"user",level:4},{value:"Spot Leverage Token",id:"spot-leverage-token",level:4},{value:"Spot Margin Trade (UTA)",id:"spot-margin-trade-uta",level:4},{value:"Spot Margin Trade (Classic)",id:"spot-margin-trade-classic",level:4},{value:"API Rate Limit Rules For VIPs/PROs",id:"api-rate-limit-rules-for-vipspros",level:2},{value:"How to increase API Limit",id:"how-to-increase-api-limit",level:2}],s=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,r.kt)("div",e)},o=s("Tabs"),c=s("TabItem"),p={toc:u};function m(t){let{components:e,...l}=t;return(0,r.kt)("wrapper",(0,n.Z)({},p,l,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("h2",{id:"ip-rate-limit"},"IP Rate Limit"),(0,r.kt)("admonition",{type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"If you receive an ",(0,r.kt)("strong",{parentName:"p"},"HTTP 403")," (Access Denied) response, your IP has been either temporarily or permanently banned.\n",(0,r.kt)("strong",{parentName:"p"},"You should immediately review the below guidelines to ensure your application does not continue to violate the limit."),"\nIf you are still banned after 30 minutes, you likely have a permanent ban.")),(0,r.kt)("p",null,"We do not recommend running your application at the very edge of these limits in case abnormal network activity results\nin an unexpected violation."),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"GET"),"/",(0,r.kt)("inlineCode",{parentName:"li"},"POST")," method (shared):",(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"No more than 600 requests are allowed in any 5-second window.")))),(0,r.kt)("admonition",{type:"note"},(0,r.kt)("p",{parentName:"admonition"},"All traffic to ",(0,r.kt)("inlineCode",{parentName:"p"},"api.bybit.com")," or ",(0,r.kt)("inlineCode",{parentName:"p"},"api.bytick.com")," share this limit regardless of if it accesses Spot, Derivatives or Options.")),(0,r.kt)("p",null,"After violating the limit your IP will be banned for a set period of time (usually 30 minutes). Continually violating\nthe limit will result in a permanent ban. We cannot undo permanent bans or shorten temporary bans."),(0,r.kt)("h2",{id:"api-rate-limit"},"API Rate Limit"),(0,r.kt)("admonition",{type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"If you receive ",(0,r.kt)("inlineCode",{parentName:"p"},'"ret_msg": "Too many visits!"')," in the JSON response, you have hit the API rate limit.")),(0,r.kt)("p",null,"The API rate limit is based on the ",(0,r.kt)("strong",{parentName:"p"},"rolling time window per second and UID"),". In other words, it is per second per UID.\nEvery request to the API returns response header shown in the code panel:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit-Status")," - your remaining requests for current endpoint"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit")," - your current limit for current endpoint"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit-Reset-Timestamp")," - the timestamp indicating when your request limit resets if you have exceeded your rate_limit. Otherwise, this is just the current timestamp (it may not exactly match ",(0,r.kt)("inlineCode",{parentName:"li"},"timeNow"),").")),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},"Http Response Header Example")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-http"},"\u25b6Response Headers\nContent-Type: application/json; charset=utf-8\nContent-Length: 141\nX-Bapi-Limit: 100\nX-Bapi-Limit-Status: 99\nX-Bapi-Limit-Reset-Timestamp: 1672738134824\n")),(0,r.kt)("h3",{id:"api-rate-limit-table"},"API Rate Limit Table"),(0,r.kt)("h4",{id:"trade"},"Trade"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"Classic account",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"Method"),(0,r.kt)("th",{rowSpan:"2"},"Path"),(0,r.kt)("th",{colSpan:"3",align:"center"},"Classic account"),(0,r.kt)("th",{rowSpan:"2"},"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"4"},"POST"),(0,r.kt)("td",null,"/v5/order/create"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-all"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"GET"),(0,r.kt)("td",null,"/v5/order/realtime"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/history"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/execution/list"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"Method"),(0,r.kt)("th",{rowSpan:"2"},"Path"),(0,r.kt)("th",{colSpan:"4",align:"center"},"UTA Pro"),(0,r.kt)("th",{rowSpan:"2"},"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"option"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"8"},"POST"),(0,r.kt)("td",null,"/v5/order/create"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-all"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"1/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/create-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/disconnected-cancel-all"),(0,r.kt)("td",{colSpan:"2",align:"center"},"-"),(0,r.kt)("td",{align:"center"},"1/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"4"},"GET"),(0,r.kt)("td",null,"/v5/order/realtime"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/history"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/execution/list"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/spot-borrow-check"),(0,r.kt)("td",{colSpan:"3",align:"center"},"-"),(0,r.kt)("td",{align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"position"},"Position"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"Classic account",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"Method"),(0,r.kt)("th",{rowSpan:"2"},"Path"),(0,r.kt)("th",{colSpan:"3",align:"center"},"Classic account"),(0,r.kt)("th",{rowSpan:"2"},"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"GET"),(0,r.kt)("td",null,"/v5/position/list"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/position/closed-pnl"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"POST"),(0,r.kt)("td",null,"/v5/position/set-leverage"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"Method"),(0,r.kt)("th",{rowSpan:"2"},"Path"),(0,r.kt)("th",{colSpan:"4",align:"center"},"UTA Pro"),(0,r.kt)("th",{rowSpan:"2"},"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"option"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"GET"),(0,r.kt)("td",null,"/v5/position/list"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"2",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/position/closed-pnl"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"POST"),(0,r.kt)("td",null,"/v5/position/set-leverage"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"account"},"Account"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"Classic account",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"Method"),(0,r.kt)("th",null,"Path"),(0,r.kt)("th",null),(0,r.kt)("th",null,"Limit"),(0,r.kt)("th",null,"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"6"},"GET"),(0,r.kt)("td",null,"/v5/account/contract-transaction-log"),(0,r.kt)("td",null),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"/v5/account/wallet-balance"),(0,r.kt)("td",null,"accountType=SPOT"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"accountType=CONTRACT"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"/v5/account/fee-rate"),(0,r.kt)("td",null,"category=linear"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=spot"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=option"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"Method"),(0,r.kt)("th",null,"Path"),(0,r.kt)("th",null),(0,r.kt)("th",null,"Limit"),(0,r.kt)("th",null,"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"9"},"GET"),(0,r.kt)("td",{rowSpan:"2"},"/v5/account/wallet-balance"),(0,r.kt)("td",null,"accountType=CONTRACT"),(0,r.kt)("td",{rowSpan:"2"},"50/s"),(0,r.kt)("td",{rowSpan:"2",align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"accountType=UNIFIED")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/borrow-history"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/collateral-info"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/coin-greeks"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/transaction-log"),(0,r.kt)("td",null,"accountType=UNIFIED"),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"/v5/account/fee-rate"),(0,r.kt)("td",null,"category=linear"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=spot"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=option"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"asset"},"Asset"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"Method"),(0,r.kt)("th",null,"Path"),(0,r.kt)("th",null,"Limit"),(0,r.kt)("th",null,"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"13"},"GET"),(0,r.kt)("td",null,"/v5/asset/transfer/query-asset-info"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-transfer-coin-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-inter-transfer-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-sub-member-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-universal-transfer-list"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-account-coins-balance"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-record"),(0,r.kt)("td",null,"100 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-sub-member-record"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-address"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-sub-member-address"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/query-record"),(0,r.kt)("td",null,"300 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/coin/query-info"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/exchange/order-record"),(0,r.kt)("td",null,"600 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"5"},"POST"),(0,r.kt)("td",null,"/v5/asset/transfer/inter-transfer"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/save-transfer-sub-member"),(0,r.kt)("td",null,"20 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/universal-transfer"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/create"),(0,r.kt)("td",null,"1 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/cancel"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")))),(0,r.kt)("h4",{id:"user"},"User"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"Method"),(0,r.kt)("th",null,"Path"),(0,r.kt)("th",null,"Limit"),(0,r.kt)("td",null,"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"7"},"POST"),(0,r.kt)("td",null,"v5/user/create-sub-member"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/create-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/frozen-sub-member"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/update-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/update-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/delete-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/delete-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"GET"),(0,r.kt)("td",null,"/v5/user/query-sub-members"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/query-api"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/aff-customer-info"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")))),(0,r.kt)("h4",{id:"spot-leverage-token"},"Spot Leverage Token"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Method"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Path"),(0,r.kt)("th",{parentName:"tr",align:null},"Limit"),(0,r.kt)("th",{parentName:"tr",align:null},"Upgradable"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/order-record"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/purchase"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/redeem"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N"))))),(0,r.kt)("h4",{id:"spot-margin-trade-uta"},"Spot Margin Trade (UTA)"),(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("td",null,"For now, there is no limit for endpoints under this category"))),(0,r.kt)("h4",{id:"spot-margin-trade-classic"},"Spot Margin Trade (Classic)"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Method"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Path"),(0,r.kt)("th",{parentName:"tr",align:null},"Limit"),(0,r.kt)("th",{parentName:"tr",align:null},"Upgradable"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/loan-info"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/account"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/orders"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/repay-history"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/loan"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/repay"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/switch"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N"))))),(0,r.kt)("h2",{id:"api-rate-limit-rules-for-vipspros"},"API Rate Limit Rules For VIPs/PROs"),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"The values in the table represent the application upper limit of the corresponding level, and do not mean that users at\nthis level will automatically enjoy the corresponding API Rate Limit by default.")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"Classic account does not support USDC derivatives trading")))),(0,r.kt)("admonition",{title:"instructions for batch endpoints ",type:"tip"},(0,r.kt)("p",{parentName:"admonition"},"The batch order endpoint, which includes operations for creating, amending, and canceling, has its own rate limit and\ndoes not share it with single requests, ",(0,r.kt)("em",{parentName:"p"},"e.g., let's say the rate limit of single create order endpoint is 100/s, and batch create order endpoint\nis 100/s, so in this case, I can place 200 linear orders in one second if I use both endpoints to place orders")),(0,r.kt)("h4",{parentName:"admonition",id:"when-category--linear-or-spot"},"When category = linear or spot"),(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"API for batch create/amend/cancel order, the frequency of the API will be consistent with the current configuration,\nbut the counting consumption will be consumed according to the actual number of orders. (Number of consumption = number\nof requests * number of orders included in a single request), and the configuration of business lines is independent of each other.")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"The batch APIs allows 1-10 orders/request. For example, if a batch order request is made once and contains 5 orders,\nthen the request limit will consume 5.")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"If part of the last batch of orders requested within 1s exceeds the limit, the part that exceeds the limit will fail, and\nthe part that does not exceed the limit will succeed. For example, in the 1 second, the remaining limit is 5, but a batch request\ncontaining 8 orders is placed at this time, then the first 5 orders will be successfully placed, and the 6-8th orders\nwill report an error exceeding the limit, and these orders will fail.")))),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{class:"custom_table"},(0,r.kt)("tr",null,(0,r.kt)("th",null),(0,r.kt)("th",{colSpan:"3",align:"center"},"Classic account & UTA"),(0,r.kt)("th",{colSpan:"3"},"UTA Pro")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"Level\\Product"),(0,r.kt)("td",null,(0,r.kt)("b",null,"Futures")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Option")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Spot")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Futures")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Option")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Spot"))),(0,r.kt)("tr",null,(0,r.kt)("td",null,"Default"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"20/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 1"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"25/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"25/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 2"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"30/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"30/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 3"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 4"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 5"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP Supreme"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO1"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO2"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"75/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO3"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"250/s"),(0,r.kt)("td",null,"250/s"),(0,r.kt)("td",null,"250/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO4"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO5"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")))),(0,r.kt)("h2",{id:"how-to-increase-api-limit"},"How to increase API Limit"),(0,r.kt)("p",null,"Please contact your client manager or email to ",(0,r.kt)("a",{parentName:"p",href:"mailto:institutional_services@bybit.com"},"institutional_services@bybit.com")," with the following information. We will reply within 1-4 working days:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Your name and your company details"),(0,r.kt)("li",{parentName:"ol"},"Your Bybit UID or registered email, and the assets you are trading"),(0,r.kt)("li",{parentName:"ol"},"General description of your trading strategy and reasons for higher rate limits"),(0,r.kt)("li",{parentName:"ol"},"Screenshot of previous monthly trading volume (maker/taker) on other platforms"),(0,r.kt)("li",{parentName:"ol"},"Optional: your order history in CSV format")))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[12717],{3905:(t,e,l)=>{l.d(e,{Zo:()=>s,kt:()=>p});var n=l(67294);function r(t,e,l){return e in t?Object.defineProperty(t,e,{value:l,enumerable:!0,configurable:!0,writable:!0}):t[e]=l,t}function a(t,e){var l=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),l.push.apply(l,n)}return l}function i(t){for(var e=1;e=0||(r[l]=t[l]);return r}(t,e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(t,l)&&(r[l]=t[l])}return r}var k=n.createContext({}),u=function(t){var e=n.useContext(k),l=e;return t&&(l="function"==typeof t?t(e):i(i({},e),t)),l},s=function(t){var e=u(t.components);return n.createElement(k.Provider,{value:e},t.children)},o={inlineCode:"code",wrapper:function(t){var e=t.children;return n.createElement(n.Fragment,{},e)}},c=n.forwardRef((function(t,e){var l=t.components,r=t.mdxType,a=t.originalType,k=t.parentName,s=d(t,["components","mdxType","originalType","parentName"]),c=u(l),p=r,m=c["".concat(k,".").concat(p)]||c[p]||o[p]||a;return l?n.createElement(m,i(i({ref:e},s),{},{components:l})):n.createElement(m,i({ref:e},s))}));function p(t,e){var l=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var a=l.length,i=new Array(a);i[0]=c;var d={};for(var k in e)hasOwnProperty.call(e,k)&&(d[k]=e[k]);d.originalType=t,d.mdxType="string"==typeof t?t:r,i[1]=d;for(var u=2;u{l.r(e),l.d(e,{assets:()=>k,contentTitle:()=>i,default:()=>m,frontMatter:()=>a,metadata:()=>d,toc:()=>u});var n=l(87462),r=(l(67294),l(3905));const a={title:"Rate Limit",sidebar_label:"Rate Limit"},i=void 0,d={unversionedId:"v5/rate-limit",id:"v5/rate-limit",title:"Rate Limit",description:"IP Rate Limit",source:"@site/docs/v5/rate-limit.mdx",sourceDirName:"v5",slug:"/v5/rate-limit",permalink:"/docs/v5/rate-limit",draft:!1,tags:[],version:"current",frontMatter:{title:"Rate Limit",sidebar_label:"Rate Limit"},sidebar:"v5SideBar",previous:{title:"Websocket Trade Guideline",permalink:"/docs/v5/websocket/trade/guideline"},next:{title:"Enums Definitions",permalink:"/docs/v5/enum"}},k={},u=[{value:"IP Rate Limit",id:"ip-rate-limit",level:2},{value:"API Rate Limit",id:"api-rate-limit",level:2},{value:"API Rate Limit Table",id:"api-rate-limit-table",level:3},{value:"Trade",id:"trade",level:4},{value:"Position",id:"position",level:4},{value:"Account",id:"account",level:4},{value:"Asset",id:"asset",level:4},{value:"User",id:"user",level:4},{value:"Spot Leverage Token",id:"spot-leverage-token",level:4},{value:"Spot Margin Trade (UTA)",id:"spot-margin-trade-uta",level:4},{value:"Spot Margin Trade (Classic)",id:"spot-margin-trade-classic",level:4},{value:"API Rate Limit Rules For VIPs/PROs",id:"api-rate-limit-rules-for-vipspros",level:2},{value:"How to increase API Limit",id:"how-to-increase-api-limit",level:2}],s=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,r.kt)("div",e)},o=s("Tabs"),c=s("TabItem"),p={toc:u};function m(t){let{components:e,...l}=t;return(0,r.kt)("wrapper",(0,n.Z)({},p,l,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("h2",{id:"ip-rate-limit"},"IP Rate Limit"),(0,r.kt)("admonition",{type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"If you receive an ",(0,r.kt)("strong",{parentName:"p"},"HTTP 403")," (Access Denied) response, your IP has been either temporarily or permanently banned.\n",(0,r.kt)("strong",{parentName:"p"},"You should immediately review the below guidelines to ensure your application does not continue to violate the limit."),"\nIf you are still banned after 30 minutes, you likely have a permanent ban.")),(0,r.kt)("p",null,"We do not recommend running your application at the very edge of these limits in case abnormal network activity results\nin an unexpected violation."),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"GET"),"/",(0,r.kt)("inlineCode",{parentName:"li"},"POST")," method (shared):",(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"No more than 600 requests are allowed in any 5-second window.")))),(0,r.kt)("admonition",{type:"note"},(0,r.kt)("p",{parentName:"admonition"},"All traffic to ",(0,r.kt)("inlineCode",{parentName:"p"},"api.bybit.com")," or ",(0,r.kt)("inlineCode",{parentName:"p"},"api.bytick.com")," share this limit regardless of if it accesses Spot, Derivatives or Options.")),(0,r.kt)("p",null,"After violating the limit your IP will be banned for a set period of time (usually 30 minutes). Continually violating\nthe limit will result in a permanent ban. We cannot undo permanent bans or shorten temporary bans."),(0,r.kt)("h2",{id:"api-rate-limit"},"API Rate Limit"),(0,r.kt)("admonition",{type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"If you receive ",(0,r.kt)("inlineCode",{parentName:"p"},'"ret_msg": "Too many visits!"')," in the JSON response, you have hit the API rate limit.")),(0,r.kt)("p",null,"The API rate limit is based on the ",(0,r.kt)("strong",{parentName:"p"},"rolling time window per second and UID"),". In other words, it is per second per UID.\nEvery request to the API returns response header shown in the code panel:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit-Status")," - your remaining requests for current endpoint"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit")," - your current limit for current endpoint"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit-Reset-Timestamp")," - the timestamp indicating when your request limit resets if you have exceeded your rate_limit. Otherwise, this is just the current timestamp (it may not exactly match ",(0,r.kt)("inlineCode",{parentName:"li"},"timeNow"),").")),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},"Http Response Header Example")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-http"},"\u25b6Response Headers\nContent-Type: application/json; charset=utf-8\nContent-Length: 141\nX-Bapi-Limit: 100\nX-Bapi-Limit-Status: 99\nX-Bapi-Limit-Reset-Timestamp: 1672738134824\n")),(0,r.kt)("h3",{id:"api-rate-limit-table"},"API Rate Limit Table"),(0,r.kt)("h4",{id:"trade"},"Trade"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"Classic account",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"Method"),(0,r.kt)("th",{rowSpan:"2"},"Path"),(0,r.kt)("th",{colSpan:"3",align:"center"},"Classic account"),(0,r.kt)("th",{rowSpan:"2"},"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"4"},"POST"),(0,r.kt)("td",null,"/v5/order/create"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-all"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"GET"),(0,r.kt)("td",null,"/v5/order/realtime"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/history"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/execution/list"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"Method"),(0,r.kt)("th",{rowSpan:"2"},"Path"),(0,r.kt)("th",{colSpan:"4",align:"center"},"UTA Pro"),(0,r.kt)("th",{rowSpan:"2"},"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"option"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"8"},"POST"),(0,r.kt)("td",null,"/v5/order/create"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-all"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"1/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/create-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/disconnected-cancel-all"),(0,r.kt)("td",{colSpan:"2",align:"center"},"-"),(0,r.kt)("td",{align:"center"},"1/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"4"},"GET"),(0,r.kt)("td",null,"/v5/order/realtime"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/history"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/execution/list"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/spot-borrow-check"),(0,r.kt)("td",{colSpan:"3",align:"center"},"-"),(0,r.kt)("td",{align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"position"},"Position"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"Classic account",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"Method"),(0,r.kt)("th",{rowSpan:"2"},"Path"),(0,r.kt)("th",{colSpan:"3",align:"center"},"Classic account"),(0,r.kt)("th",{rowSpan:"2"},"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"GET"),(0,r.kt)("td",null,"/v5/position/list"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/position/closed-pnl"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"POST"),(0,r.kt)("td",null,"/v5/position/set-leverage"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"Method"),(0,r.kt)("th",{rowSpan:"2"},"Path"),(0,r.kt)("th",{colSpan:"4",align:"center"},"UTA Pro"),(0,r.kt)("th",{rowSpan:"2"},"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"option"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"GET"),(0,r.kt)("td",null,"/v5/position/list"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"2",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/position/closed-pnl"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"POST"),(0,r.kt)("td",null,"/v5/position/set-leverage"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"account"},"Account"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"Classic account",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"Method"),(0,r.kt)("th",null,"Path"),(0,r.kt)("th",null),(0,r.kt)("th",null,"Limit"),(0,r.kt)("th",null,"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"6"},"GET"),(0,r.kt)("td",null,"/v5/account/contract-transaction-log"),(0,r.kt)("td",null),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"/v5/account/wallet-balance"),(0,r.kt)("td",null,"accountType=SPOT"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"accountType=CONTRACT"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"/v5/account/fee-rate"),(0,r.kt)("td",null,"category=linear"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=spot"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=option"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"Method"),(0,r.kt)("th",null,"Path"),(0,r.kt)("th",null),(0,r.kt)("th",null,"Limit"),(0,r.kt)("th",null,"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"9"},"GET"),(0,r.kt)("td",{rowSpan:"2"},"/v5/account/wallet-balance"),(0,r.kt)("td",null,"accountType=CONTRACT"),(0,r.kt)("td",{rowSpan:"2"},"50/s"),(0,r.kt)("td",{rowSpan:"2",align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"accountType=UNIFIED")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/borrow-history"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/collateral-info"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/coin-greeks"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/transaction-log"),(0,r.kt)("td",null,"accountType=UNIFIED"),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"/v5/account/fee-rate"),(0,r.kt)("td",null,"category=linear"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=spot"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=option"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"asset"},"Asset"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"Method"),(0,r.kt)("th",null,"Path"),(0,r.kt)("th",null,"Limit"),(0,r.kt)("th",null,"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"13"},"GET"),(0,r.kt)("td",null,"/v5/asset/transfer/query-asset-info"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-transfer-coin-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-inter-transfer-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-sub-member-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-universal-transfer-list"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-account-coins-balance"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-record"),(0,r.kt)("td",null,"100 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-sub-member-record"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-address"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-sub-member-address"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/query-record"),(0,r.kt)("td",null,"300 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/coin/query-info"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/exchange/order-record"),(0,r.kt)("td",null,"600 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"5"},"POST"),(0,r.kt)("td",null,"/v5/asset/transfer/inter-transfer"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/save-transfer-sub-member"),(0,r.kt)("td",null,"20 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/universal-transfer"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/create"),(0,r.kt)("td",null,"1 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/cancel"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")))),(0,r.kt)("h4",{id:"user"},"User"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"Method"),(0,r.kt)("th",null,"Path"),(0,r.kt)("th",null,"Limit"),(0,r.kt)("td",null,"upgradable")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"7"},"POST"),(0,r.kt)("td",null,"v5/user/create-sub-member"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/create-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/frozen-sub-member"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/update-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/update-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/delete-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/delete-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"GET"),(0,r.kt)("td",null,"/v5/user/query-sub-members"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/query-api"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/aff-customer-info"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")))),(0,r.kt)("h4",{id:"spot-leverage-token"},"Spot Leverage Token"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Method"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Path"),(0,r.kt)("th",{parentName:"tr",align:null},"Limit"),(0,r.kt)("th",{parentName:"tr",align:null},"Upgradable"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/order-record"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/purchase"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/redeem"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N"))))),(0,r.kt)("h4",{id:"spot-margin-trade-uta"},"Spot Margin Trade (UTA)"),(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("td",null,"For now, there is no limit for endpoints under this category"))),(0,r.kt)("h4",{id:"spot-margin-trade-classic"},"Spot Margin Trade (Classic)"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Method"),(0,r.kt)("th",{parentName:"tr",align:"center"},"Path"),(0,r.kt)("th",{parentName:"tr",align:null},"Limit"),(0,r.kt)("th",{parentName:"tr",align:null},"Upgradable"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/loan-info"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/account"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/orders"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/repay-history"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/loan"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/repay"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/switch"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N"))))),(0,r.kt)("h2",{id:"api-rate-limit-rules-for-vipspros"},"API Rate Limit Rules For VIPs/PROs"),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"The values in the table represent the application upper limit of the corresponding level, and do not mean that users at\nthis level will automatically enjoy the corresponding API Rate Limit by default.")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"Classic account does not support USDC derivatives trading")))),(0,r.kt)("admonition",{title:"instructions for batch endpoints ",type:"tip"},(0,r.kt)("p",{parentName:"admonition"},"The batch order endpoint, which includes operations for creating, amending, and canceling, has its own rate limit and\ndoes not share it with single requests, ",(0,r.kt)("em",{parentName:"p"},"e.g., let's say the rate limit of single create order endpoint is 100/s, and batch create order endpoint\nis 100/s, so in this case, I can place 200 linear orders in one second if I use both endpoints to place orders")),(0,r.kt)("h4",{parentName:"admonition",id:"when-category--linear-or-spot"},"When category = linear or spot"),(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"API for batch create/amend/cancel order, the frequency of the API will be consistent with the current configuration,\nbut the counting consumption will be consumed according to the actual number of orders. (Number of consumption = number\nof requests * number of orders included in a single request), and the configuration of business lines is independent of each other.")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"The batch APIs allows 1-10 orders/request. For example, if a batch order request is made once and contains 5 orders,\nthen the request limit will consume 5.")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"If part of the last batch of orders requested within 1s exceeds the limit, the part that exceeds the limit will fail, and\nthe part that does not exceed the limit will succeed. For example, in the 1 second, the remaining limit is 5, but a batch request\ncontaining 8 orders is placed at this time, then the first 5 orders will be successfully placed, and the 6-8th orders\nwill report an error exceeding the limit, and these orders will fail.")))),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{class:"custom_table"},(0,r.kt)("tr",null,(0,r.kt)("th",null),(0,r.kt)("th",{colSpan:"3",align:"center"},"Classic account & UTA"),(0,r.kt)("th",{colSpan:"3"},"UTA Pro")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"Level\\Product"),(0,r.kt)("td",null,(0,r.kt)("b",null,"Futures")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Option")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Spot")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Futures")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Option")),(0,r.kt)("td",null,(0,r.kt)("b",null,"Spot"))),(0,r.kt)("tr",null,(0,r.kt)("td",null,"Default"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"20/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 1"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"25/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"25/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 2"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"30/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"30/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 3"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 4"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 5"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP Supreme"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO1"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO2"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"75/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO3"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"250/s"),(0,r.kt)("td",null,"250/s"),(0,r.kt)("td",null,"250/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO4"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO5"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO6"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")))),(0,r.kt)("h2",{id:"how-to-increase-api-limit"},"How to increase API Limit"),(0,r.kt)("p",null,"Please contact your client manager or email to ",(0,r.kt)("a",{parentName:"p",href:"mailto:institutional_services@bybit.com"},"institutional_services@bybit.com")," with the following information. We will reply within 1-4 working days:"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Your name and your company details"),(0,r.kt)("li",{parentName:"ol"},"Your Bybit UID or registered email, and the assets you are trading"),(0,r.kt)("li",{parentName:"ol"},"General description of your trading strategy and reasons for higher rate limits"),(0,r.kt)("li",{parentName:"ol"},"Screenshot of previous monthly trading volume (maker/taker) on other platforms"),(0,r.kt)("li",{parentName:"ol"},"Optional: your order history in CSV format")))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0d16b667.6657d22f.js b/assets/js/0d16b667.6657d22f.js deleted file mode 100644 index 82c52f783e..0000000000 --- a/assets/js/0d16b667.6657d22f.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[83616],{3905:(t,e,a)=>{a.d(e,{Zo:()=>s,kt:()=>c});var r=a(67294);function n(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function o(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,r)}return a}function l(t){for(var e=1;e=0||(n[a]=t[a]);return n}(t,e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(t);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(n[a]=t[a])}return n}var p=r.createContext({}),m=function(t){var e=r.useContext(p),a=e;return t&&(a="function"==typeof t?t(e):l(l({},e),t)),a},s=function(t){var e=m(t.components);return r.createElement(p.Provider,{value:e},t.children)},u={inlineCode:"code",wrapper:function(t){var e=t.children;return r.createElement(r.Fragment,{},e)}},d=r.forwardRef((function(t,e){var a=t.components,n=t.mdxType,o=t.originalType,p=t.parentName,s=i(t,["components","mdxType","originalType","parentName"]),d=m(a),c=n,b=d["".concat(p,".").concat(c)]||d[c]||u[c]||o;return a?r.createElement(b,l(l({ref:e},s),{},{components:a})):r.createElement(b,l({ref:e},s))}));function c(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var o=a.length,l=new Array(o);l[0]=d;var i={};for(var p in e)hasOwnProperty.call(e,p)&&(i[p]=e[p]);i.originalType=t,i.mdxType="string"==typeof t?t:n,l[1]=i;for(var m=2;m{a.r(e),a.d(e,{assets:()=>p,contentTitle:()=>l,default:()=>y,frontMatter:()=>o,metadata:()=>i,toc:()=>m});var r=a(87462),n=(a(67294),a(3905));const o={title:"Get Borrow Quota (Spot)",sidebar_label:"Get Borrow Quota (Spot)",sidebar_position:10},l=void 0,i={unversionedId:"v5/order/spot-borrow-quota",id:"v5/order/spot-borrow-quota",title:"Get Borrow Quota (Spot)",description:"Query the available balance for Spot trading and Margin trading",source:"@site/docs/v5/order/spot-borrow-quota.mdx",sourceDirName:"v5/order",slug:"/v5/order/spot-borrow-quota",permalink:"/docs/v5/order/spot-borrow-quota",draft:!1,tags:[],version:"current",sidebarPosition:10,frontMatter:{title:"Get Borrow Quota (Spot)",sidebar_label:"Get Borrow Quota (Spot)",sidebar_position:10},sidebar:"v5SideBar",previous:{title:"Batch Cancel Order",permalink:"/docs/v5/order/batch-cancel"},next:{title:"Set DCP (Options)",permalink:"/docs/v5/order/dcp"}},p={},m=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],s=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,n.kt)("div",e)},u=s("Button"),d=s("Tabs"),c=s("TabItem"),b={toc:m};function y(t){let{components:e,...a}=t;return(0,n.kt)("wrapper",(0,r.Z)({},b,a,{components:e,mdxType:"MDXLayout"}),(0,n.kt)("p",null,"Query the available balance for Spot trading and Margin trading"),(0,n.kt)("blockquote",null,(0,n.kt)("p",{parentName:"blockquote"},(0,n.kt)("strong",{parentName:"p"},"Covers: Spot (Unified Account)"))),(0,n.kt)("h3",{id:"http-request"},"HTTP Request"),(0,n.kt)("p",null,"GET ",(0,n.kt)("inlineCode",{parentName:"p"},"/v5/order/spot-borrow-check")),(0,n.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,n.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("a",{parentName:"td",href:"../enum#category"},"category")),(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("strong",{parentName:"td"},"true")),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Product type. ",(0,n.kt)("inlineCode",{parentName:"td"},"spot"))),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("strong",{parentName:"td"},"true")),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Symbol name")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"side"),(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("strong",{parentName:"td"},"true")),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Transaction side. ",(0,n.kt)("inlineCode",{parentName:"td"},"Buy"),",",(0,n.kt)("inlineCode",{parentName:"td"},"Sell"))))),(0,n.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,n.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,n.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"side"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Side")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"maxTradeQty"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"The maximum base coin qty can be traded",(0,n.kt)("ul",null,(0,n.kt)("li",null,"If spot margin trade on and symbol is margin trading pair, it returns available balance + max.borrowable quantity = min(The maximum quantity that a single user can borrow on the platform, The maximum quantity that can be borrowed calculated by IMR MMR of UTA account, The available quantity of the platform's capital pool) "),(0,n.kt)("li",null,"Otherwise, it returns actual available balance"),(0,n.kt)("li",null,"up to 4 decimals")))),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"maxTradeAmount"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"The maximum quote coin amount can be traded",(0,n.kt)("ul",null,(0,n.kt)("li",null,"If spot margin trade on and symbol is margin trading pair, it returns available balance + max.borrowable amount = min(The maximum amount that a single user can borrow on the platform, The maximum amount that can be borrowed calculated by IMR MMR of UTA account, The available amount of the platform's capital pool) "),(0,n.kt)("li",null,"Otherwise, it returns actual available balance"),(0,n.kt)("li",null,"up to 8 decimals")))),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"spotMaxTradeQty"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"No matter your Spot margin switch on or not, it always returns actual qty of base coin you can trade or you have (borrowable qty is not included), up to 4 decimals")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"spotMaxTradeAmount"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"No matter your Spot margin switch on or not, it always returns actual amount of quote coin you can trade or you have (borrowable amount is not included), up to 8 decimals")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"borrowCoin"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Borrow coin")))),(0,n.kt)("a",{href:"/api-explorer/v5/trade/query-spot-quota"},(0,n.kt)(u,{mdxType:"Button"},"RUN >>")),(0,n.kt)("hr",null),(0,n.kt)("h3",{id:"request-example"},"Request Example"),(0,n.kt)(d,{groupId:"programming-languages",mdxType:"Tabs"},(0,n.kt)(c,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/order/spot-borrow-check?category=spot&symbol=BTCUSDT&side=Buy HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672228522214\nX-BAPI-RECV-WINDOW: 5000\n"))),(0,n.kt)(c,{value:"python",label:"Python",mdxType:"TabItem"},(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_borrow_quota(\n category="spot",\n symbol="BTCUSDT",\n side="Buy",\n))\n'))),(0,n.kt)(c,{value:"java",label:"Java",mdxType:"TabItem"},(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar getBorrowQuotaRequest = TradeOrderRequest.builder().category(CategoryType.SPOT).symbol("BTCUSDT").side(Side.BUY).build();\nSystem.out.println(client.getBorrowQuota(getBorrowQuotaRequest));\n'))),(0,n.kt)(c,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getSpotBorrowCheck('BTCUSDT', 'Buy')\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,n.kt)("h3",{id:"response-example"},"Response Example"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "symbol": "BTCUSDT",\n "maxTradeQty": "6.6065",\n "side": "Buy",\n "spotMaxTradeAmount": "9004.75628594",\n "maxTradeAmount": "218014.01330797",\n "borrowCoin": "USDT",\n "spotMaxTradeQty": "0.2728"\n },\n "retExtInfo": {},\n "time": 1698895841534\n}\n')))}y.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0d16b667.9d81d0d4.js b/assets/js/0d16b667.9d81d0d4.js new file mode 100644 index 0000000000..27c5d6328f --- /dev/null +++ b/assets/js/0d16b667.9d81d0d4.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[83616],{3905:(t,e,a)=>{a.d(e,{Zo:()=>s,kt:()=>c});var r=a(67294);function n(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function o(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,r)}return a}function l(t){for(var e=1;e=0||(n[a]=t[a]);return n}(t,e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(t);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(n[a]=t[a])}return n}var p=r.createContext({}),m=function(t){var e=r.useContext(p),a=e;return t&&(a="function"==typeof t?t(e):l(l({},e),t)),a},s=function(t){var e=m(t.components);return r.createElement(p.Provider,{value:e},t.children)},u={inlineCode:"code",wrapper:function(t){var e=t.children;return r.createElement(r.Fragment,{},e)}},d=r.forwardRef((function(t,e){var a=t.components,n=t.mdxType,o=t.originalType,p=t.parentName,s=i(t,["components","mdxType","originalType","parentName"]),d=m(a),c=n,b=d["".concat(p,".").concat(c)]||d[c]||u[c]||o;return a?r.createElement(b,l(l({ref:e},s),{},{components:a})):r.createElement(b,l({ref:e},s))}));function c(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var o=a.length,l=new Array(o);l[0]=d;var i={};for(var p in e)hasOwnProperty.call(e,p)&&(i[p]=e[p]);i.originalType=t,i.mdxType="string"==typeof t?t:n,l[1]=i;for(var m=2;m{a.r(e),a.d(e,{assets:()=>p,contentTitle:()=>l,default:()=>y,frontMatter:()=>o,metadata:()=>i,toc:()=>m});var r=a(87462),n=(a(67294),a(3905));const o={title:"Get Borrow Quota (Spot)",sidebar_label:"Get Borrow Quota (Spot)",sidebar_position:10},l=void 0,i={unversionedId:"v5/order/spot-borrow-quota",id:"v5/order/spot-borrow-quota",title:"Get Borrow Quota (Spot)",description:"Query the available balance for Spot trading and Margin trading",source:"@site/docs/v5/order/spot-borrow-quota.mdx",sourceDirName:"v5/order",slug:"/v5/order/spot-borrow-quota",permalink:"/docs/v5/order/spot-borrow-quota",draft:!1,tags:[],version:"current",sidebarPosition:10,frontMatter:{title:"Get Borrow Quota (Spot)",sidebar_label:"Get Borrow Quota (Spot)",sidebar_position:10},sidebar:"v5SideBar",previous:{title:"Batch Cancel Order",permalink:"/docs/v5/order/batch-cancel"},next:{title:"Set DCP",permalink:"/docs/v5/order/dcp"}},p={},m=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],s=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,n.kt)("div",e)},u=s("Button"),d=s("Tabs"),c=s("TabItem"),b={toc:m};function y(t){let{components:e,...a}=t;return(0,n.kt)("wrapper",(0,r.Z)({},b,a,{components:e,mdxType:"MDXLayout"}),(0,n.kt)("p",null,"Query the available balance for Spot trading and Margin trading"),(0,n.kt)("blockquote",null,(0,n.kt)("p",{parentName:"blockquote"},(0,n.kt)("strong",{parentName:"p"},"Covers: Spot (Unified Account)"))),(0,n.kt)("h3",{id:"http-request"},"HTTP Request"),(0,n.kt)("p",null,"GET ",(0,n.kt)("inlineCode",{parentName:"p"},"/v5/order/spot-borrow-check")),(0,n.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,n.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("a",{parentName:"td",href:"../enum#category"},"category")),(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("strong",{parentName:"td"},"true")),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Product type. ",(0,n.kt)("inlineCode",{parentName:"td"},"spot"))),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("strong",{parentName:"td"},"true")),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Symbol name")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"side"),(0,n.kt)("td",{parentName:"tr",align:"left"},(0,n.kt)("strong",{parentName:"td"},"true")),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Transaction side. ",(0,n.kt)("inlineCode",{parentName:"td"},"Buy"),",",(0,n.kt)("inlineCode",{parentName:"td"},"Sell"))))),(0,n.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,n.kt)("table",null,(0,n.kt)("thead",{parentName:"table"},(0,n.kt)("tr",{parentName:"thead"},(0,n.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,n.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,n.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,n.kt)("tbody",{parentName:"table"},(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,n.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"side"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Side")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"maxTradeQty"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"The maximum base coin qty can be traded",(0,n.kt)("ul",null,(0,n.kt)("li",null,"If spot margin trade on and symbol is margin trading pair, it returns available balance + max.borrowable quantity = min(The maximum quantity that a single user can borrow on the platform, The maximum quantity that can be borrowed calculated by IMR MMR of UTA account, The available quantity of the platform's capital pool) "),(0,n.kt)("li",null,"Otherwise, it returns actual available balance"),(0,n.kt)("li",null,"up to 4 decimals")))),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"maxTradeAmount"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"The maximum quote coin amount can be traded",(0,n.kt)("ul",null,(0,n.kt)("li",null,"If spot margin trade on and symbol is margin trading pair, it returns available balance + max.borrowable amount = min(The maximum amount that a single user can borrow on the platform, The maximum amount that can be borrowed calculated by IMR MMR of UTA account, The available amount of the platform's capital pool) "),(0,n.kt)("li",null,"Otherwise, it returns actual available balance"),(0,n.kt)("li",null,"up to 8 decimals")))),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"spotMaxTradeQty"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"No matter your Spot margin switch on or not, it always returns actual qty of base coin you can trade or you have (borrowable qty is not included), up to 4 decimals")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"spotMaxTradeAmount"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"No matter your Spot margin switch on or not, it always returns actual amount of quote coin you can trade or you have (borrowable amount is not included), up to 8 decimals")),(0,n.kt)("tr",{parentName:"tbody"},(0,n.kt)("td",{parentName:"tr",align:"left"},"borrowCoin"),(0,n.kt)("td",{parentName:"tr",align:"left"},"string"),(0,n.kt)("td",{parentName:"tr",align:null},"Borrow coin")))),(0,n.kt)("a",{href:"/api-explorer/v5/trade/query-spot-quota"},(0,n.kt)(u,{mdxType:"Button"},"RUN >>")),(0,n.kt)("hr",null),(0,n.kt)("h3",{id:"request-example"},"Request Example"),(0,n.kt)(d,{groupId:"programming-languages",mdxType:"Tabs"},(0,n.kt)(c,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/order/spot-borrow-check?category=spot&symbol=BTCUSDT&side=Buy HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672228522214\nX-BAPI-RECV-WINDOW: 5000\n"))),(0,n.kt)(c,{value:"python",label:"Python",mdxType:"TabItem"},(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_borrow_quota(\n category="spot",\n symbol="BTCUSDT",\n side="Buy",\n))\n'))),(0,n.kt)(c,{value:"java",label:"Java",mdxType:"TabItem"},(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar getBorrowQuotaRequest = TradeOrderRequest.builder().category(CategoryType.SPOT).symbol("BTCUSDT").side(Side.BUY).build();\nSystem.out.println(client.getBorrowQuota(getBorrowQuotaRequest));\n'))),(0,n.kt)(c,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getSpotBorrowCheck('BTCUSDT', 'Buy')\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,n.kt)("h3",{id:"response-example"},"Response Example"),(0,n.kt)("pre",null,(0,n.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "symbol": "BTCUSDT",\n "maxTradeQty": "6.6065",\n "side": "Buy",\n "spotMaxTradeAmount": "9004.75628594",\n "maxTradeAmount": "218014.01330797",\n "borrowCoin": "USDT",\n "spotMaxTradeQty": "0.2728"\n },\n "retExtInfo": {},\n "time": 1698895841534\n}\n')))}y.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/197a4930.553e892b.js b/assets/js/197a4930.553e892b.js deleted file mode 100644 index db8669b807..0000000000 --- a/assets/js/197a4930.553e892b.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[26912],{3905:(t,e,n)=>{n.d(e,{Zo:()=>d,kt:()=>k});var a=n(67294);function r(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}function i(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);e&&(a=a.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,a)}return n}function l(t){for(var e=1;e=0||(r[n]=t[n]);return r}(t,e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(r[n]=t[n])}return r}var s=a.createContext({}),p=function(t){var e=a.useContext(s),n=e;return t&&(n="function"==typeof t?t(e):l(l({},e),t)),n},d=function(t){var e=p(t.components);return a.createElement(s.Provider,{value:e},t.children)},m={inlineCode:"code",wrapper:function(t){var e=t.children;return a.createElement(a.Fragment,{},e)}},u=a.forwardRef((function(t,e){var n=t.components,r=t.mdxType,i=t.originalType,s=t.parentName,d=o(t,["components","mdxType","originalType","parentName"]),u=p(n),k=r,g=u["".concat(s,".").concat(k)]||u[k]||m[k]||i;return n?a.createElement(g,l(l({ref:e},d),{},{components:n})):a.createElement(g,l({ref:e},d))}));function k(t,e){var n=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var i=n.length,l=new Array(i);l[0]=u;var o={};for(var s in e)hasOwnProperty.call(e,s)&&(o[s]=e[s]);o.originalType=t,o.mdxType="string"==typeof t?t:r,l[1]=o;for(var p=2;p{n.r(e),n.d(e,{assets:()=>s,contentTitle:()=>l,default:()=>N,frontMatter:()=>i,metadata:()=>o,toc:()=>p});var a=n(87462),r=(n(67294),n(3905));const i={title:"Get Position Info",sidebar_label:"Get Position Info",sidebar_position:1},l=void 0,o={unversionedId:"v5/position/position",id:"v5/position/position",title:"Get Position Info",description:"Query real-time position data, such as position size, cumulative realizedPNL.",source:"@site/docs/v5/position/position.mdx",sourceDirName:"v5/position",slug:"/v5/position/",permalink:"/docs/v5/position/",draft:!1,tags:[],version:"current",sidebarPosition:1,frontMatter:{title:"Get Position Info",sidebar_label:"Get Position Info",sidebar_position:1},sidebar:"v5SideBar",previous:{title:"Set DCP (Options)",permalink:"/docs/v5/order/dcp"},next:{title:"Set Leverage",permalink:"/docs/v5/position/leverage"}},s={},p=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],d=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,r.kt)("div",e)},m=d("Button"),u=d("Tabs"),k=d("TabItem"),g={toc:p};function N(t){let{components:e,...n}=t;return(0,r.kt)("wrapper",(0,a.Z)({},g,n,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"Query real-time position data, such as position size, cumulative realizedPNL."),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},(0,r.kt)("strong",{parentName:"p"},"Unified account covers: USDT perpetual / USDC contract / Inverse contract / Options"),(0,r.kt)("br",null),"\n",(0,r.kt)("strong",{parentName:"p"},"Classic account covers: USDT perpetual / Inverse contract"))),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("p",{parentName:"admonition"},"Regarding inverse contracts,"),(0,r.kt)("ol",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ol"},'you can query all holding positions with "/v5/position/list?category=inverse";'),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("inlineCode",{parentName:"li"},"symbol")," parameter is supported to be passed with multiple symbols up to 10"))),(0,r.kt)("h3",{id:"http-request"},"HTTP Request"),(0,r.kt)("p",null,"GET ",(0,r.kt)("inlineCode",{parentName:"p"},"/v5/position/list")),(0,r.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,r.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("a",{parentName:"td",href:"../v5/enum#category"},"category")),(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("strong",{parentName:"td"},"true")),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Product type ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Unified account: ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"option")),(0,r.kt)("li",null,"Classic account: ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,r.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only",(0,r.kt)("ul",null,(0,r.kt)("li",null,"If ",(0,r.kt)("inlineCode",{parentName:"td"},"symbol")," passed, it returns data regardless of having position or not."),(0,r.kt)("li",null,"If ",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),"=null and ",(0,r.kt)("inlineCode",{parentName:"td"},"settleCoin")," specified, it returns position size greater than zero.")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"baseCoin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Base coin, uppercase only. ",(0,r.kt)("inlineCode",{parentName:"td"},"option")," ",(0,r.kt)("strong",{parentName:"td"},"only"),". Return all option positions if not passed")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"settleCoin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Settle coin. For ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),", either ",(0,r.kt)("inlineCode",{parentName:"td"},"symbol")," or ",(0,r.kt)("inlineCode",{parentName:"td"},"settleCoin")," is ",(0,r.kt)("strong",{parentName:"td"},"required"),". ",(0,r.kt)("inlineCode",{parentName:"td"},"symbol")," has a higher priority")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"limit"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Limit for data size per page. ","[",(0,r.kt)("inlineCode",{parentName:"td"},"1"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"200"),"]",". Default: ",(0,r.kt)("inlineCode",{parentName:"td"},"20"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"cursor"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Cursor. Use the ",(0,r.kt)("inlineCode",{parentName:"td"},"nextPageCursor")," token from the response to retrieve the next page of the result set")))),(0,r.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,r.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("a",{parentName:"td",href:"../v5/enum#category"},"category")),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Product type")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"list"),(0,r.kt)("td",{parentName:"tr",align:"left"},"array"),(0,r.kt)("td",{parentName:"tr",align:null},"Object")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#positionidx"},"positionIdx")),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Position idx, used to identify positions in different position modes",(0,r.kt)("ul",null,(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"0"),": One-Way Mode"),(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"1"),": Buy side of both side mode"),(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"2"),": Sell side of both side mode")," "))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> riskId"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Risk limit ID. ",(0,r.kt)("em",{parentName:"td"},"Note: for portfolio margin mode, this field returns 0, which means risk limit rules are invalid"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> riskLimitValue"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Risk limit value. ",(0,r.kt)("em",{parentName:"td"},"Note: for portfolio margin mode, this field returns 0, which means risk limit rules are invalid"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> symbol"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Symbol name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> side"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position side. ",(0,r.kt)("inlineCode",{parentName:"td"},"Buy"),": long, ",(0,r.kt)("inlineCode",{parentName:"td"},"Sell"),": short ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Classic account in one-way mode & Unified account (inverse), an empty position returns ",(0,r.kt)("inlineCode",{parentName:"td"},"None"),"."),(0,r.kt)("li",null,"UTA account(linear contracts), either one-way or hedge mode returns an empty string for an empty position.")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> size"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position size")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> avgPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Average entry price ",(0,r.kt)("li",null,"For USDC Perp & Futures, it indicates average entry price, and it will not be changed with 8-hour session settlement"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionValue"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position value")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> tradeMode"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Trade mode ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Classic & UTA (inverse): ",(0,r.kt)("inlineCode",{parentName:"td"},"0"),": cross-margin, ",(0,r.kt)("inlineCode",{parentName:"td"},"1"),": isolated margin"),(0,r.kt)("li",null,"UTA: depreciated, always ",(0,r.kt)("inlineCode",{parentName:"td"},"0"))))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> autoAddMargin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to add margin automatically. ",(0,r.kt)("inlineCode",{parentName:"td"},"0"),": false, ",(0,r.kt)("inlineCode",{parentName:"td"},"1"),": true. For UTA, it is meaningful only when UTA enables ",(0,r.kt)("inlineCode",{parentName:"td"},"ISOLATED_MARGIN"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#positionstatus"},"positionStatus")),(0,r.kt)("td",{parentName:"tr",align:"left"},"String"),(0,r.kt)("td",{parentName:"tr",align:null},"Position status. ",(0,r.kt)("inlineCode",{parentName:"td"},"Normal"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"Liq"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"Adl"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> leverage"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position leverage. Valid for contract. ",(0,r.kt)("em",{parentName:"td"},'Note: for portfolio margin mode, this field returns "", which means leverage rules are invalid'))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> markPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Last mark price")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> liqPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position liquidation price ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"UTA (inverse) & UTA (isolated margin enabled) & Classic account: it is the real price for isolated and cross positions, and keeps ",(0,r.kt)("inlineCode",{parentName:"td"},'""')," when liqPrice <= minPrice or liqPrice >= maxPrice"),(0,r.kt)("li",null,"UTA (Cross margin mode): it is an estimated price for cross positions(because the unified mode controls the risk rate according to the account), and keeps ",(0,r.kt)("inlineCode",{parentName:"td"},'""')," when liqPrice <= minPrice or liqPrice >= maxPrice")),"However, this field is empty for Portfolio Margin Mode, and no liquidation price will be provided")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> bustPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Bankruptcy price. ",(0,r.kt)("em",{parentName:"td"},"Note: Unified mode returns ",(0,r.kt)("inlineCode",{parentName:"em"},'""'),", no position bankruptcy price (exclude inverse trade under UTA)"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionIM"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},'Initial margin. For portfolio margin mode, it returns ""')),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionMM"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},'Maintenance margin. For portfolio margin mode, it returns ""')),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionBalance"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position margin ",(0,r.kt)("li",null,"UTA(linear): Only meaningful for isolated margin mode"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> tpslMode"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},'Depreciated, meaningless here, always "Full". Spot does not return this field. Option returns ""')),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> takeProfit"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Take profit price")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> stopLoss"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Stop loss price")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> trailingStop"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Trailing stop (The distance from market price)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> sessionAvgPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"USDC contract session avg price, it is the same figure as avg entry price shown in the web UI")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> delta"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Delta, unique field for ",(0,r.kt)("inlineCode",{parentName:"td"},"option"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> gamma"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Gamma, unique field for ",(0,r.kt)("inlineCode",{parentName:"td"},"option"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> vega"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Vega, unique field for ",(0,r.kt)("inlineCode",{parentName:"td"},"option"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> theta"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Theta, unique field for ",(0,r.kt)("inlineCode",{parentName:"td"},"option"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> unrealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Unrealised PnL")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> curRealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"The realised PnL for the current holding position")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> cumRealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Cumulative realised pnl ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Futures & Perp: it is the all time cumulative realised P&L"),(0,r.kt)("li",null,'Option: always "", meaningless')))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#adlrankindicator"},"adlRankIndicator")),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Auto-deleverage rank indicator. ",(0,r.kt)("a",{href:"https://www.bybit.com/en-US/help-center/s/article/What-is-Auto-Deleveraging-ADL"},"What is Auto-Deleveraging?"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> isReduceOnly"),(0,r.kt)("td",{parentName:"tr",align:"left"},"boolean"),(0,r.kt)("td",{parentName:"tr",align:null},"Useful when Bybit lower the risk limit ",(0,r.kt)("ul",null,(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"true"),": Only allowed to reduce the position. You can consider a series of measures, e.g., lower the risk limit, decrease leverage or reduce the position, add margin, or cancel orders, after these operations, you can call ",(0,r.kt)("a",{parentName:"td",href:"../v5/position/confirm-mmr#"},"confirm new risk limit")," endpoint to check if your position can be removed the reduceOnly mark"),(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"false"),": There is no restriction, and it means your position is under the risk when the risk limit is systematically adjusted"),(0,r.kt)("li",null,"Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> mmrSysUpdatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Useful when Bybit lower the risk limit ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"When isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"true"),": the timestamp (ms) when the MMR will be forcibly adjusted by the system"),"When isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"false"),": the timestamp when the MMR had been adjusted by system",(0,r.kt)("li",null,"It returns the timestamp when the system operates, and if you manually operate, there is no timestamp"),(0,r.kt)("li",null,"Keeps ",(0,r.kt)("inlineCode",{parentName:"td"},'""')," by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp"),(0,r.kt)("li",null,"Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> leverageSysUpdatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Useful when Bybit lower the risk limit ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"When isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"true"),": the timestamp (ms) when the leverage will be forcibly adjusted by the system"),"When isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"false"),": the timestamp when the leverage had been adjusted by system",(0,r.kt)("li",null,"It returns the timestamp when the system operates, and if you manually operate, there is no timestamp"),(0,r.kt)("li",null,"Keeps ",(0,r.kt)("inlineCode",{parentName:"td"},'""')," by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp"),(0,r.kt)("li",null,"Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> createdTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Timestamp of the first time a position was created on this symbol (ms)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> updatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position updated timestamp (ms)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> seq"),(0,r.kt)("td",{parentName:"tr",align:"left"},"long"),(0,r.kt)("td",{parentName:"tr",align:null},"Cross sequence, used to associate each fill and each position update",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Different symbols may have the same seq, please use seq + symbol to check unique"),(0,r.kt)("li",null,"Returns ",(0,r.kt)("inlineCode",{parentName:"td"},'"-1"')," if the symbol has never been traded"),(0,r.kt)("li",null,"Returns the seq updated by the last transaction when there are settings like leverage, risk limit")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"nextPageCursor"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Refer to the ",(0,r.kt)("inlineCode",{parentName:"td"},"cursor")," request parameter")))),(0,r.kt)("a",{href:"/api-explorer/v5/position/position-info"},(0,r.kt)(m,{mdxType:"Button"},"RUN >>")),(0,r.kt)("hr",null),(0,r.kt)("h3",{id:"request-example"},"Request Example"),(0,r.kt)(u,{groupId:"programming-languages",mdxType:"Tabs"},(0,r.kt)(k,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/position/list?category=inverse&symbol=BTCUSD HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672280218882\nX-BAPI-RECV-WINDOW: 5000\n"))),(0,r.kt)(k,{value:"python",label:"Python",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_positions(\n category="inverse",\n symbol="BTCUSD",\n))\n'))),(0,r.kt)(k,{value:"java",label:"Java",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.position.*;\nimport com.bybit.api.client.domain.position.request.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance().newAsyncPositionRestClient();\nvar positionListRequest = PositionDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").build();\nclient.getPositionInfo(positionListRequest, System.out::println);\n'))),(0,r.kt)(k,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getPositionInfo({\n category: 'inverse',\n symbol: 'BTCUSD',\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,r.kt)("h3",{id:"response-example"},"Response Example"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "list": [\n {\n "positionIdx": 0,\n "riskId": 1,\n "riskLimitValue": "150",\n "symbol": "BTCUSD",\n "side": "Sell",\n "size": "300",\n "avgPrice": "27464.50441675",\n "positionValue": "0.01092319",\n "tradeMode": 0,\n "positionStatus": "Normal",\n "autoAddMargin": 1,\n "adlRankIndicator": 2,\n "leverage": "10",\n "positionBalance": "0.00139186",\n "markPrice": "28224.50",\n "liqPrice": "",\n "bustPrice": "999999.00",\n "positionMM": "0.0000015",\n "positionIM": "0.00010923",\n "tpslMode": "Full",\n "takeProfit": "0.00",\n "stopLoss": "0.00",\n "trailingStop": "0.00",\n "unrealisedPnl": "-0.00029413",\n "curRealisedPnl": "0.00013123",\n "cumRealisedPnl": "-0.00096902",\n "seq": 5723621632,\n "isReduceOnly": false,\n "mmrSysUpdateTime": "",\n "leverageSysUpdatedTime": "",\n "sessionAvgPrice": "",\n "createdTime": "1676538056258",\n "updatedTime": "1697673600012"\n }\n ],\n "nextPageCursor": "",\n "category": "inverse"\n },\n "retExtInfo": {},\n "time": 1697684980172\n}\n')))}N.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/197a4930.acba2158.js b/assets/js/197a4930.acba2158.js new file mode 100644 index 0000000000..a26c16c880 --- /dev/null +++ b/assets/js/197a4930.acba2158.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[26912],{3905:(t,e,n)=>{n.d(e,{Zo:()=>d,kt:()=>k});var a=n(67294);function r(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}function i(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);e&&(a=a.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,a)}return n}function l(t){for(var e=1;e=0||(r[n]=t[n]);return r}(t,e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(r[n]=t[n])}return r}var s=a.createContext({}),p=function(t){var e=a.useContext(s),n=e;return t&&(n="function"==typeof t?t(e):l(l({},e),t)),n},d=function(t){var e=p(t.components);return a.createElement(s.Provider,{value:e},t.children)},m={inlineCode:"code",wrapper:function(t){var e=t.children;return a.createElement(a.Fragment,{},e)}},u=a.forwardRef((function(t,e){var n=t.components,r=t.mdxType,i=t.originalType,s=t.parentName,d=o(t,["components","mdxType","originalType","parentName"]),u=p(n),k=r,g=u["".concat(s,".").concat(k)]||u[k]||m[k]||i;return n?a.createElement(g,l(l({ref:e},d),{},{components:n})):a.createElement(g,l({ref:e},d))}));function k(t,e){var n=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var i=n.length,l=new Array(i);l[0]=u;var o={};for(var s in e)hasOwnProperty.call(e,s)&&(o[s]=e[s]);o.originalType=t,o.mdxType="string"==typeof t?t:r,l[1]=o;for(var p=2;p{n.r(e),n.d(e,{assets:()=>s,contentTitle:()=>l,default:()=>N,frontMatter:()=>i,metadata:()=>o,toc:()=>p});var a=n(87462),r=(n(67294),n(3905));const i={title:"Get Position Info",sidebar_label:"Get Position Info",sidebar_position:1},l=void 0,o={unversionedId:"v5/position/position",id:"v5/position/position",title:"Get Position Info",description:"Query real-time position data, such as position size, cumulative realizedPNL.",source:"@site/docs/v5/position/position.mdx",sourceDirName:"v5/position",slug:"/v5/position/",permalink:"/docs/v5/position/",draft:!1,tags:[],version:"current",sidebarPosition:1,frontMatter:{title:"Get Position Info",sidebar_label:"Get Position Info",sidebar_position:1},sidebar:"v5SideBar",previous:{title:"Set DCP",permalink:"/docs/v5/order/dcp"},next:{title:"Set Leverage",permalink:"/docs/v5/position/leverage"}},s={},p=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],d=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,r.kt)("div",e)},m=d("Button"),u=d("Tabs"),k=d("TabItem"),g={toc:p};function N(t){let{components:e,...n}=t;return(0,r.kt)("wrapper",(0,a.Z)({},g,n,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"Query real-time position data, such as position size, cumulative realizedPNL."),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},(0,r.kt)("strong",{parentName:"p"},"Unified account covers: USDT perpetual / USDC contract / Inverse contract / Options"),(0,r.kt)("br",null),"\n",(0,r.kt)("strong",{parentName:"p"},"Classic account covers: USDT perpetual / Inverse contract"))),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("p",{parentName:"admonition"},"Regarding inverse contracts,"),(0,r.kt)("ol",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ol"},'you can query all holding positions with "/v5/position/list?category=inverse";'),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("inlineCode",{parentName:"li"},"symbol")," parameter is supported to be passed with multiple symbols up to 10"))),(0,r.kt)("h3",{id:"http-request"},"HTTP Request"),(0,r.kt)("p",null,"GET ",(0,r.kt)("inlineCode",{parentName:"p"},"/v5/position/list")),(0,r.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,r.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("a",{parentName:"td",href:"../v5/enum#category"},"category")),(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("strong",{parentName:"td"},"true")),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Product type ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Unified account: ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"option")),(0,r.kt)("li",null,"Classic account: ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,r.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only",(0,r.kt)("ul",null,(0,r.kt)("li",null,"If ",(0,r.kt)("inlineCode",{parentName:"td"},"symbol")," passed, it returns data regardless of having position or not."),(0,r.kt)("li",null,"If ",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),"=null and ",(0,r.kt)("inlineCode",{parentName:"td"},"settleCoin")," specified, it returns position size greater than zero.")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"baseCoin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Base coin, uppercase only. ",(0,r.kt)("inlineCode",{parentName:"td"},"option")," ",(0,r.kt)("strong",{parentName:"td"},"only"),". Return all option positions if not passed")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"settleCoin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Settle coin. For ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),", either ",(0,r.kt)("inlineCode",{parentName:"td"},"symbol")," or ",(0,r.kt)("inlineCode",{parentName:"td"},"settleCoin")," is ",(0,r.kt)("strong",{parentName:"td"},"required"),". ",(0,r.kt)("inlineCode",{parentName:"td"},"symbol")," has a higher priority")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"limit"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Limit for data size per page. ","[",(0,r.kt)("inlineCode",{parentName:"td"},"1"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"200"),"]",". Default: ",(0,r.kt)("inlineCode",{parentName:"td"},"20"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"cursor"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Cursor. Use the ",(0,r.kt)("inlineCode",{parentName:"td"},"nextPageCursor")," token from the response to retrieve the next page of the result set")))),(0,r.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,r.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("a",{parentName:"td",href:"../v5/enum#category"},"category")),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Product type")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"list"),(0,r.kt)("td",{parentName:"tr",align:"left"},"array"),(0,r.kt)("td",{parentName:"tr",align:null},"Object")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#positionidx"},"positionIdx")),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Position idx, used to identify positions in different position modes",(0,r.kt)("ul",null,(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"0"),": One-Way Mode"),(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"1"),": Buy side of both side mode"),(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"2"),": Sell side of both side mode")," "))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> riskId"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Risk limit ID. ",(0,r.kt)("em",{parentName:"td"},"Note: for portfolio margin mode, this field returns 0, which means risk limit rules are invalid"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> riskLimitValue"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Risk limit value. ",(0,r.kt)("em",{parentName:"td"},"Note: for portfolio margin mode, this field returns 0, which means risk limit rules are invalid"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> symbol"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Symbol name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> side"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position side. ",(0,r.kt)("inlineCode",{parentName:"td"},"Buy"),": long, ",(0,r.kt)("inlineCode",{parentName:"td"},"Sell"),": short ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Classic account in one-way mode & Unified account (inverse), an empty position returns ",(0,r.kt)("inlineCode",{parentName:"td"},"None"),"."),(0,r.kt)("li",null,"UTA account(linear contracts), either one-way or hedge mode returns an empty string for an empty position.")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> size"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position size")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> avgPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Average entry price ",(0,r.kt)("li",null,"For USDC Perp & Futures, it indicates average entry price, and it will not be changed with 8-hour session settlement"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionValue"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position value")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> tradeMode"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Trade mode ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Classic & UTA (inverse): ",(0,r.kt)("inlineCode",{parentName:"td"},"0"),": cross-margin, ",(0,r.kt)("inlineCode",{parentName:"td"},"1"),": isolated margin"),(0,r.kt)("li",null,"UTA: depreciated, always ",(0,r.kt)("inlineCode",{parentName:"td"},"0"))))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> autoAddMargin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to add margin automatically. ",(0,r.kt)("inlineCode",{parentName:"td"},"0"),": false, ",(0,r.kt)("inlineCode",{parentName:"td"},"1"),": true. For UTA, it is meaningful only when UTA enables ",(0,r.kt)("inlineCode",{parentName:"td"},"ISOLATED_MARGIN"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#positionstatus"},"positionStatus")),(0,r.kt)("td",{parentName:"tr",align:"left"},"String"),(0,r.kt)("td",{parentName:"tr",align:null},"Position status. ",(0,r.kt)("inlineCode",{parentName:"td"},"Normal"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"Liq"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"Adl"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> leverage"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position leverage. Valid for contract. ",(0,r.kt)("em",{parentName:"td"},'Note: for portfolio margin mode, this field returns "", which means leverage rules are invalid'))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> markPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Last mark price")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> liqPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position liquidation price ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"UTA (inverse) & UTA (isolated margin enabled) & Classic account: it is the real price for isolated and cross positions, and keeps ",(0,r.kt)("inlineCode",{parentName:"td"},'""')," when liqPrice <= minPrice or liqPrice >= maxPrice"),(0,r.kt)("li",null,"UTA (Cross margin mode): it is an estimated price for cross positions(because the unified mode controls the risk rate according to the account), and keeps ",(0,r.kt)("inlineCode",{parentName:"td"},'""')," when liqPrice <= minPrice or liqPrice >= maxPrice")),"However, this field is empty for Portfolio Margin Mode, and no liquidation price will be provided")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> bustPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Bankruptcy price. ",(0,r.kt)("em",{parentName:"td"},"Note: Unified mode returns ",(0,r.kt)("inlineCode",{parentName:"em"},'""'),", no position bankruptcy price (exclude inverse trade under UTA)"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionIM"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},'Initial margin. For portfolio margin mode, it returns ""')),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionMM"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},'Maintenance margin. For portfolio margin mode, it returns ""')),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionBalance"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position margin ",(0,r.kt)("li",null,"UTA(linear): Only meaningful for isolated margin mode"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> tpslMode"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},'Depreciated, meaningless here, always "Full". Spot does not return this field. Option returns ""')),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> takeProfit"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Take profit price")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> stopLoss"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Stop loss price")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> trailingStop"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Trailing stop (The distance from market price)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> sessionAvgPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"USDC contract session avg price, it is the same figure as avg entry price shown in the web UI")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> delta"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Delta, unique field for ",(0,r.kt)("inlineCode",{parentName:"td"},"option"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> gamma"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Gamma, unique field for ",(0,r.kt)("inlineCode",{parentName:"td"},"option"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> vega"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Vega, unique field for ",(0,r.kt)("inlineCode",{parentName:"td"},"option"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> theta"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Theta, unique field for ",(0,r.kt)("inlineCode",{parentName:"td"},"option"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> unrealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Unrealised PnL")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> curRealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"The realised PnL for the current holding position")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> cumRealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Cumulative realised pnl ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Futures & Perp: it is the all time cumulative realised P&L"),(0,r.kt)("li",null,'Option: always "", meaningless')))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#adlrankindicator"},"adlRankIndicator")),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"Auto-deleverage rank indicator. ",(0,r.kt)("a",{href:"https://www.bybit.com/en-US/help-center/s/article/What-is-Auto-Deleveraging-ADL"},"What is Auto-Deleveraging?"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> isReduceOnly"),(0,r.kt)("td",{parentName:"tr",align:"left"},"boolean"),(0,r.kt)("td",{parentName:"tr",align:null},"Useful when Bybit lower the risk limit ",(0,r.kt)("ul",null,(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"true"),": Only allowed to reduce the position. You can consider a series of measures, e.g., lower the risk limit, decrease leverage or reduce the position, add margin, or cancel orders, after these operations, you can call ",(0,r.kt)("a",{parentName:"td",href:"../v5/position/confirm-mmr#"},"confirm new risk limit")," endpoint to check if your position can be removed the reduceOnly mark"),(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"false"),": There is no restriction, and it means your position is under the risk when the risk limit is systematically adjusted"),(0,r.kt)("li",null,"Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> mmrSysUpdatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Useful when Bybit lower the risk limit ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"When isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"true"),": the timestamp (ms) when the MMR will be forcibly adjusted by the system"),"When isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"false"),": the timestamp when the MMR had been adjusted by system",(0,r.kt)("li",null,"It returns the timestamp when the system operates, and if you manually operate, there is no timestamp"),(0,r.kt)("li",null,"Keeps ",(0,r.kt)("inlineCode",{parentName:"td"},'""')," by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp"),(0,r.kt)("li",null,"Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> leverageSysUpdatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Useful when Bybit lower the risk limit ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"When isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"true"),": the timestamp (ms) when the leverage will be forcibly adjusted by the system"),"When isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"false"),": the timestamp when the leverage had been adjusted by system",(0,r.kt)("li",null,"It returns the timestamp when the system operates, and if you manually operate, there is no timestamp"),(0,r.kt)("li",null,"Keeps ",(0,r.kt)("inlineCode",{parentName:"td"},'""')," by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp"),(0,r.kt)("li",null,"Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> createdTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Timestamp of the first time a position was created on this symbol (ms)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> updatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Position updated timestamp (ms)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> seq"),(0,r.kt)("td",{parentName:"tr",align:"left"},"long"),(0,r.kt)("td",{parentName:"tr",align:null},"Cross sequence, used to associate each fill and each position update",(0,r.kt)("ul",null,(0,r.kt)("li",null,"Different symbols may have the same seq, please use seq + symbol to check unique"),(0,r.kt)("li",null,"Returns ",(0,r.kt)("inlineCode",{parentName:"td"},'"-1"')," if the symbol has never been traded"),(0,r.kt)("li",null,"Returns the seq updated by the last transaction when there are settings like leverage, risk limit")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"nextPageCursor"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Refer to the ",(0,r.kt)("inlineCode",{parentName:"td"},"cursor")," request parameter")))),(0,r.kt)("a",{href:"/api-explorer/v5/position/position-info"},(0,r.kt)(m,{mdxType:"Button"},"RUN >>")),(0,r.kt)("hr",null),(0,r.kt)("h3",{id:"request-example"},"Request Example"),(0,r.kt)(u,{groupId:"programming-languages",mdxType:"Tabs"},(0,r.kt)(k,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/position/list?category=inverse&symbol=BTCUSD HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672280218882\nX-BAPI-RECV-WINDOW: 5000\n"))),(0,r.kt)(k,{value:"python",label:"Python",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_positions(\n category="inverse",\n symbol="BTCUSD",\n))\n'))),(0,r.kt)(k,{value:"java",label:"Java",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.position.*;\nimport com.bybit.api.client.domain.position.request.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance().newAsyncPositionRestClient();\nvar positionListRequest = PositionDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").build();\nclient.getPositionInfo(positionListRequest, System.out::println);\n'))),(0,r.kt)(k,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getPositionInfo({\n category: 'inverse',\n symbol: 'BTCUSD',\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,r.kt)("h3",{id:"response-example"},"Response Example"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "list": [\n {\n "positionIdx": 0,\n "riskId": 1,\n "riskLimitValue": "150",\n "symbol": "BTCUSD",\n "side": "Sell",\n "size": "300",\n "avgPrice": "27464.50441675",\n "positionValue": "0.01092319",\n "tradeMode": 0,\n "positionStatus": "Normal",\n "autoAddMargin": 1,\n "adlRankIndicator": 2,\n "leverage": "10",\n "positionBalance": "0.00139186",\n "markPrice": "28224.50",\n "liqPrice": "",\n "bustPrice": "999999.00",\n "positionMM": "0.0000015",\n "positionIM": "0.00010923",\n "tpslMode": "Full",\n "takeProfit": "0.00",\n "stopLoss": "0.00",\n "trailingStop": "0.00",\n "unrealisedPnl": "-0.00029413",\n "curRealisedPnl": "0.00013123",\n "cumRealisedPnl": "-0.00096902",\n "seq": 5723621632,\n "isReduceOnly": false,\n "mmrSysUpdateTime": "",\n "leverageSysUpdatedTime": "",\n "sessionAvgPrice": "",\n "createdTime": "1676538056258",\n "updatedTime": "1697673600012"\n }\n ],\n "nextPageCursor": "",\n "category": "inverse"\n },\n "retExtInfo": {},\n "time": 1697684980172\n}\n')))}N.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/84002310.200735d8.js b/assets/js/84002310.200735d8.js deleted file mode 100644 index 75ab878026..0000000000 --- a/assets/js/84002310.200735d8.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[783],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>u});var r=n(67294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function l(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=r.createContext({}),s=function(e){var t=r.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},d=function(e){var t=s(e.components);return r.createElement(p.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,l=e.originalType,p=e.parentName,d=o(e,["components","mdxType","originalType","parentName"]),m=s(n),u=a,k=m["".concat(p,".").concat(u)]||m[u]||c[u]||l;return n?r.createElement(k,i(i({ref:t},d),{},{components:n})):r.createElement(k,i({ref:t},d))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var l=n.length,i=new Array(l);i[0]=m;var o={};for(var p in t)hasOwnProperty.call(t,p)&&(o[p]=t[p]);o.originalType=e,o.mdxType="string"==typeof e?e:a,i[1]=o;for(var s=2;s{n.r(t),n.d(t,{assets:()=>p,contentTitle:()=>i,default:()=>N,frontMatter:()=>l,metadata:()=>o,toc:()=>s});var r=n(87462),a=(n(67294),n(3905));const l={title:"Cancel All Orders",sidebar_label:"Cancel All Orders",sidebar_position:5},i=void 0,o={unversionedId:"v5/order/cancel-all",id:"v5/order/cancel-all",title:"Cancel All Orders",description:"Cancel all open orders",source:"@site/docs/v5/order/cancel-all.mdx",sourceDirName:"v5/order",slug:"/v5/order/cancel-all",permalink:"/docs/v5/order/cancel-all",draft:!1,tags:[],version:"current",sidebarPosition:5,frontMatter:{title:"Cancel All Orders",sidebar_label:"Cancel All Orders",sidebar_position:5},sidebar:"v5SideBar",previous:{title:"Get Open & Closed Orders (real-time)",permalink:"/docs/v5/order/open-order"},next:{title:"Get Order History (2 years)",permalink:"/docs/v5/order/order-list"}},p={},s=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],d=e=>function(t){return console.warn("Component "+e+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",t)},c=d("Button"),m=d("Tabs"),u=d("TabItem"),k={toc:s};function N(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,r.Z)({},k,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("p",null,"Cancel all open orders"),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options"),(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Classic account covers: Spot / USDT perpetual / Inverse contract"))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"Support cancel orders by ",(0,a.kt)("inlineCode",{parentName:"li"},"symbol"),"/",(0,a.kt)("inlineCode",{parentName:"li"},"baseCoin"),"/",(0,a.kt)("inlineCode",{parentName:"li"},"settleCoin"),". If you pass multiple of these params, the system will process one of param, which priority is ",(0,a.kt)("inlineCode",{parentName:"li"},"symbol")," > ",(0,a.kt)("inlineCode",{parentName:"li"},"baseCoin")," > ",(0,a.kt)("inlineCode",{parentName:"li"},"settleCoin"),"."),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("strong",{parentName:"li"},"NOTE"),": ",(0,a.kt)("inlineCode",{parentName:"li"},"category"),"=",(0,a.kt)("em",{parentName:"li"},"option"),", you can cancel all option open orders without passing any of those three params. However, for ",(0,a.kt)("inlineCode",{parentName:"li"},"linear")," and ",(0,a.kt)("inlineCode",{parentName:"li"},"inverse"),", you must specify one of those three params."),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("strong",{parentName:"li"},"NOTE"),": ",(0,a.kt)("inlineCode",{parentName:"li"},"category"),"=",(0,a.kt)("em",{parentName:"li"},"spot"),", you can cancel all spot open orders (normal order by default) without passing other params."))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("p",{parentName:"admonition"},(0,a.kt)("strong",{parentName:"p"},"Spot"),": Classic account - cancel up to 500 orders; Unified account - no limit",(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Futures"),": Classic account - cancel up to 500 orders; Unified account - cancel up to 500 orders",(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Options"),": Unified account - no limit")),(0,a.kt)("h3",{id:"http-request"},"HTTP Request"),(0,a.kt)("p",null,"POST ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/cancel-all")),(0,a.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("a",{parentName:"td",href:"../enum#category"},"category")),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Product type ",(0,a.kt)("ul",null,(0,a.kt)("li",null,"Unified account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"option")),(0,a.kt)("li",null,"Classic account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,a.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only. ",(0,a.kt)("inlineCode",{parentName:"td"},"linear")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),": ",(0,a.kt)("strong",{parentName:"td"},"Required")," if not passing baseCoin or settleCoin")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"baseCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Base coin, uppercase only ",(0,a.kt)("ul",null,(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"linear")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),"(Classic account): If cancel all by baseCoin, it will cancel all linear & inverse orders. ",(0,a.kt)("strong",{parentName:"td"},"Required")," if not passing symbol or settleCoin"),(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"linear")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),"(Unified account): If cancel all by baseCoin, it will cancel all corresponding category orders. ",(0,a.kt)("strong",{parentName:"td"},"Required")," if not passing symbol or settleCoin"),(0,a.kt)("li",null,"Classic ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),": invalid")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"settleCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Settle coin, uppercase only ",(0,a.kt)("ul",null,(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"linear")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),": ",(0,a.kt)("strong",{parentName:"td"},"Required")," if not passing symbol or baseCoin"),(0,a.kt)("li",null,"Does not support ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"))))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderFilter"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("ul",null,(0,a.kt)("li",null,"category=",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", you can pass ",(0,a.kt)("inlineCode",{parentName:"td"},"Order"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"tpslOrder"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"OcoOrder"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"BidirectionalTpslOrder"),". If not passed, ",(0,a.kt)("inlineCode",{parentName:"td"},"Order")," by default"),(0,a.kt)("li",null,"category=",(0,a.kt)("inlineCode",{parentName:"td"},"linear")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),", you can pass ",(0,a.kt)("inlineCode",{parentName:"td"},"Order"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),". If not passed, all kinds of orders will be cancelled, like active order, conditional order, TP/SL order and trailing stop order"),(0,a.kt)("li",null,"category=",(0,a.kt)("inlineCode",{parentName:"td"},"option"),", you can pass ",(0,a.kt)("inlineCode",{parentName:"td"},"Order"),". No matter it is passed or not, always cancel all orders")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("a",{parentName:"td",href:"../enum#stopordertype"},"stopOrderType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Stop order type ",(0,a.kt)("inlineCode",{parentName:"td"},"Stop")," ",(0,a.kt)("li",null,"Only used for category=",(0,a.kt)("inlineCode",{parentName:"td"},"linear")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse")," and orderFilter=",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),",you can cancel conditional orders except TP/SL order and Trailing stop orders with this param"))))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("p",{parentName:"admonition"},"The ack of cancel-all order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status")),(0,a.kt)("a",{href:"/api-explorer/v5/trade/cancel-all"},(0,a.kt)(c,{mdxType:"Button"},"RUN >>")),(0,a.kt)("hr",null),(0,a.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"list"),(0,a.kt)("td",{parentName:"tr",align:"left"},"array"),(0,a.kt)("td",{parentName:"tr",align:null},"Object")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"success"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},'"1": success, "0": fail')))),(0,a.kt)("h3",{id:"request-example"},"Request Example"),(0,a.kt)(m,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(u,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},'POST /v5/order/cancel-all HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672219779140\nX-BAPI-RECV-WINDOW: 5000\nContent-Type: application/json\n\n{\n "category": "linear",\n "symbol": null,\n "settleCoin": "USDT"\n}\n'))),(0,a.kt)(u,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.cancel_all_orders(\n category="linear",\n settleCoin="USDT",\n))\n'))),(0,a.kt)(u,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.restApi.BybitApiTradeRestClient;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nBybitApiClientFactory factory = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET");\nBybitApiAsyncTradeRestClient client = factory.newAsyncTradeRestClient();\nvar cancelAllOrdersRequest = TradeOrderRequest.builder().category(ProductType.LINEAR).baseCoin("USDT").build();\nclient.cancelAllOrder(cancelAllOrdersRequest, System.out::println);\n'))),(0,a.kt)(u,{value:"DotNet",label:".Net",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-c#"},'using bybit.net.api.ApiServiceImp;\nusing bybit.net.api.Models.Trade;\nBybitTradeService tradeService = new(apiKey: "xxxxxxxxxxxxxx", apiSecret: "xxxxxxxxxxxxxxxxxxxxx");\nvar orderInfoString = await TradeService.CancelAllOrder(category: Category.LINEAR, baseCoin:"USDT");\nConsole.WriteLine(orderInfoString);\n'))),(0,a.kt)(u,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .cancelAllOrders({\n category: 'linear',\n settleCoin: 'USDT',\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"response-example"},"Response Example"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "list": [\n {\n "orderId": "1616024329462743808",\n "orderLinkId": "1616024329462743809"\n },\n {\n "orderId": "1616024287544869632",\n "orderLinkId": "1616024287544869633"\n }\n ],\n "success": "1"\n },\n "retExtInfo": {},\n "time": 1707381118116\n}\n')))}N.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/84002310.2a4dac02.js b/assets/js/84002310.2a4dac02.js new file mode 100644 index 0000000000..749a6d4716 --- /dev/null +++ b/assets/js/84002310.2a4dac02.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[783],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>u});var r=n(67294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function l(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=r.createContext({}),s=function(e){var t=r.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},d=function(e){var t=s(e.components);return r.createElement(p.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,l=e.originalType,p=e.parentName,d=o(e,["components","mdxType","originalType","parentName"]),m=s(n),u=a,k=m["".concat(p,".").concat(u)]||m[u]||c[u]||l;return n?r.createElement(k,i(i({ref:t},d),{},{components:n})):r.createElement(k,i({ref:t},d))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var l=n.length,i=new Array(l);i[0]=m;var o={};for(var p in t)hasOwnProperty.call(t,p)&&(o[p]=t[p]);o.originalType=e,o.mdxType="string"==typeof e?e:a,i[1]=o;for(var s=2;s{n.r(t),n.d(t,{assets:()=>p,contentTitle:()=>i,default:()=>N,frontMatter:()=>l,metadata:()=>o,toc:()=>s});var r=n(87462),a=(n(67294),n(3905));const l={title:"Cancel All Orders",sidebar_label:"Cancel All Orders",sidebar_position:5},i=void 0,o={unversionedId:"v5/order/cancel-all",id:"v5/order/cancel-all",title:"Cancel All Orders",description:"Cancel all open orders",source:"@site/docs/v5/order/cancel-all.mdx",sourceDirName:"v5/order",slug:"/v5/order/cancel-all",permalink:"/docs/v5/order/cancel-all",draft:!1,tags:[],version:"current",sidebarPosition:5,frontMatter:{title:"Cancel All Orders",sidebar_label:"Cancel All Orders",sidebar_position:5},sidebar:"v5SideBar",previous:{title:"Get Open & Closed Orders",permalink:"/docs/v5/order/open-order"},next:{title:"Get Order History (2 years)",permalink:"/docs/v5/order/order-list"}},p={},s=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],d=e=>function(t){return console.warn("Component "+e+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",t)},c=d("Button"),m=d("Tabs"),u=d("TabItem"),k={toc:s};function N(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,r.Z)({},k,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("p",null,"Cancel all open orders"),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options"),(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Classic account covers: Spot / USDT perpetual / Inverse contract"))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"Support cancel orders by ",(0,a.kt)("inlineCode",{parentName:"li"},"symbol"),"/",(0,a.kt)("inlineCode",{parentName:"li"},"baseCoin"),"/",(0,a.kt)("inlineCode",{parentName:"li"},"settleCoin"),". If you pass multiple of these params, the system will process one of param, which priority is ",(0,a.kt)("inlineCode",{parentName:"li"},"symbol")," > ",(0,a.kt)("inlineCode",{parentName:"li"},"baseCoin")," > ",(0,a.kt)("inlineCode",{parentName:"li"},"settleCoin"),"."),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("strong",{parentName:"li"},"NOTE"),": ",(0,a.kt)("inlineCode",{parentName:"li"},"category"),"=",(0,a.kt)("em",{parentName:"li"},"option"),", you can cancel all option open orders without passing any of those three params. However, for ",(0,a.kt)("inlineCode",{parentName:"li"},"linear")," and ",(0,a.kt)("inlineCode",{parentName:"li"},"inverse"),", you must specify one of those three params."),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("strong",{parentName:"li"},"NOTE"),": ",(0,a.kt)("inlineCode",{parentName:"li"},"category"),"=",(0,a.kt)("em",{parentName:"li"},"spot"),", you can cancel all spot open orders (normal order by default) without passing other params."))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("p",{parentName:"admonition"},(0,a.kt)("strong",{parentName:"p"},"Spot"),": Classic account - cancel up to 500 orders; Unified account - no limit",(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Futures"),": Classic account - cancel up to 500 orders; Unified account - cancel up to 500 orders",(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Options"),": Unified account - no limit")),(0,a.kt)("h3",{id:"http-request"},"HTTP Request"),(0,a.kt)("p",null,"POST ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/cancel-all")),(0,a.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("a",{parentName:"td",href:"../enum#category"},"category")),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Product type ",(0,a.kt)("ul",null,(0,a.kt)("li",null,"Unified account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"option")),(0,a.kt)("li",null,"Classic account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,a.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only. ",(0,a.kt)("inlineCode",{parentName:"td"},"linear")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),": ",(0,a.kt)("strong",{parentName:"td"},"Required")," if not passing baseCoin or settleCoin")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"baseCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Base coin, uppercase only ",(0,a.kt)("ul",null,(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"linear")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),"(Classic account): If cancel all by baseCoin, it will cancel all linear & inverse orders. ",(0,a.kt)("strong",{parentName:"td"},"Required")," if not passing symbol or settleCoin"),(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"linear")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),"(Unified account): If cancel all by baseCoin, it will cancel all corresponding category orders. ",(0,a.kt)("strong",{parentName:"td"},"Required")," if not passing symbol or settleCoin"),(0,a.kt)("li",null,"Classic ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),": invalid")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"settleCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Settle coin, uppercase only ",(0,a.kt)("ul",null,(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"linear")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),": ",(0,a.kt)("strong",{parentName:"td"},"Required")," if not passing symbol or baseCoin"),(0,a.kt)("li",null,"Does not support ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"))))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderFilter"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("ul",null,(0,a.kt)("li",null,"category=",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", you can pass ",(0,a.kt)("inlineCode",{parentName:"td"},"Order"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"tpslOrder"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"OcoOrder"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"BidirectionalTpslOrder"),". If not passed, ",(0,a.kt)("inlineCode",{parentName:"td"},"Order")," by default"),(0,a.kt)("li",null,"category=",(0,a.kt)("inlineCode",{parentName:"td"},"linear")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),", you can pass ",(0,a.kt)("inlineCode",{parentName:"td"},"Order"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),". If not passed, all kinds of orders will be cancelled, like active order, conditional order, TP/SL order and trailing stop order"),(0,a.kt)("li",null,"category=",(0,a.kt)("inlineCode",{parentName:"td"},"option"),", you can pass ",(0,a.kt)("inlineCode",{parentName:"td"},"Order"),". No matter it is passed or not, always cancel all orders")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("a",{parentName:"td",href:"../enum#stopordertype"},"stopOrderType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Stop order type ",(0,a.kt)("inlineCode",{parentName:"td"},"Stop")," ",(0,a.kt)("li",null,"Only used for category=",(0,a.kt)("inlineCode",{parentName:"td"},"linear")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse")," and orderFilter=",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),",you can cancel conditional orders except TP/SL order and Trailing stop orders with this param"))))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("p",{parentName:"admonition"},"The ack of cancel-all order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status")),(0,a.kt)("a",{href:"/api-explorer/v5/trade/cancel-all"},(0,a.kt)(c,{mdxType:"Button"},"RUN >>")),(0,a.kt)("hr",null),(0,a.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"list"),(0,a.kt)("td",{parentName:"tr",align:"left"},"array"),(0,a.kt)("td",{parentName:"tr",align:null},"Object")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"success"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},'"1": success, "0": fail')))),(0,a.kt)("h3",{id:"request-example"},"Request Example"),(0,a.kt)(m,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(u,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},'POST /v5/order/cancel-all HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672219779140\nX-BAPI-RECV-WINDOW: 5000\nContent-Type: application/json\n\n{\n "category": "linear",\n "symbol": null,\n "settleCoin": "USDT"\n}\n'))),(0,a.kt)(u,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.cancel_all_orders(\n category="linear",\n settleCoin="USDT",\n))\n'))),(0,a.kt)(u,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.restApi.BybitApiTradeRestClient;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nBybitApiClientFactory factory = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET");\nBybitApiAsyncTradeRestClient client = factory.newAsyncTradeRestClient();\nvar cancelAllOrdersRequest = TradeOrderRequest.builder().category(ProductType.LINEAR).baseCoin("USDT").build();\nclient.cancelAllOrder(cancelAllOrdersRequest, System.out::println);\n'))),(0,a.kt)(u,{value:"DotNet",label:".Net",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-c#"},'using bybit.net.api.ApiServiceImp;\nusing bybit.net.api.Models.Trade;\nBybitTradeService tradeService = new(apiKey: "xxxxxxxxxxxxxx", apiSecret: "xxxxxxxxxxxxxxxxxxxxx");\nvar orderInfoString = await TradeService.CancelAllOrder(category: Category.LINEAR, baseCoin:"USDT");\nConsole.WriteLine(orderInfoString);\n'))),(0,a.kt)(u,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .cancelAllOrders({\n category: 'linear',\n settleCoin: 'USDT',\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"response-example"},"Response Example"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "list": [\n {\n "orderId": "1616024329462743808",\n "orderLinkId": "1616024329462743809"\n },\n {\n "orderId": "1616024287544869632",\n "orderLinkId": "1616024287544869633"\n }\n ],\n "success": "1"\n },\n "retExtInfo": {},\n "time": 1707381118116\n}\n')))}N.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/935f2afb.44108aeb.js b/assets/js/935f2afb.44108aeb.js new file mode 100644 index 0000000000..20108cf1f7 --- /dev/null +++ b/assets/js/935f2afb.44108aeb.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[80053],{1109:e=>{e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"v3SideBar":[{"type":"link","label":"Introduction","href":"/docs/v3/intro","docId":"v3/intro"},{"type":"link","label":"Bybit Server Time","href":"/docs/v3/server-time","docId":"v3/server-time"},{"type":"link","label":"Self Match Prevention","href":"/docs/v3/smp","docId":"v3/smp"},{"type":"category","label":"Derivatives","items":[{"type":"category","label":"REST API","items":[{"type":"category","label":"Market data","items":[{"type":"link","label":"Kline","href":"/docs/derivatives/public/kline","docId":"v3/derivatives/rest-public/kline"},{"type":"link","label":"Mark Price Kline","href":"/docs/derivatives/public/mark-kline","docId":"v3/derivatives/rest-public/mark-kline"},{"type":"link","label":"Index Price Kline","href":"/docs/derivatives/public/index-kline","docId":"v3/derivatives/rest-public/index-kline"},{"type":"link","label":"Premium Index Price Kline","href":"/docs/derivatives/public/premium-index-kline","docId":"v3/derivatives/rest-public/premium-index-kline"},{"type":"link","label":"Order Book","href":"/docs/derivatives/public/orderbook","docId":"v3/derivatives/rest-public/orderbook"},{"type":"link","label":"Ticker Info","href":"/docs/derivatives/public/ticker","docId":"v3/derivatives/rest-public/ticker-info"},{"type":"link","label":"Instrument Info","href":"/docs/derivatives/public/instrument-info","docId":"v3/derivatives/rest-public/instrument-info"},{"type":"link","label":"Public Trading History","href":"/docs/derivatives/public/trade","docId":"v3/derivatives/rest-public/public-trade"},{"type":"link","label":"Risk Limit","href":"/docs/derivatives/public/risk-limit","docId":"v3/derivatives/rest-public/risk-limit"},{"type":"link","label":"Funding Rate History","href":"/docs/derivatives/public/funding-rate","docId":"v3/derivatives/rest-public/fund-rate-history"},{"type":"link","label":"Open Interest","href":"/docs/derivatives/public/open-interest","docId":"v3/derivatives/rest-public/open-interest"},{"type":"link","label":"Option Delivery Price","href":"/docs/derivatives/public/option-delivery","docId":"v3/derivatives/rest-public/delivery-price"},{"type":"link","label":"Get Long Short Ratio","href":"/docs/derivatives/public/long-short-ratio","docId":"v3/derivatives/rest-public/long-short-ratio"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Contract","items":[{"type":"category","label":"Order","items":[{"type":"link","label":"Place Order","href":"/docs/derivatives/contract/place-order","docId":"v3/derivatives/rest-contract/order/place-order"},{"type":"link","label":"Get Open Orders","href":"/docs/derivatives/contract/open-order","docId":"v3/derivatives/rest-contract/order/open-order"},{"type":"link","label":"Replace Order","href":"/docs/derivatives/contract/replace-order","docId":"v3/derivatives/rest-contract/order/replace-order"},{"type":"link","label":"Cancel Order","href":"/docs/derivatives/contract/cancel","docId":"v3/derivatives/rest-contract/order/cancel-order"},{"type":"link","label":"Cancel All Order","href":"/docs/derivatives/contract/cancel-all","docId":"v3/derivatives/rest-contract/order/cancel-all"},{"type":"link","label":"Get Order List","href":"/docs/derivatives/contract/order-list","docId":"v3/derivatives/rest-contract/order/order-list"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Position","items":[{"type":"link","label":"My Position","href":"/docs/derivatives/contract/position-list","docId":"v3/derivatives/rest-contract/position/position-info"},{"type":"link","label":"Set Auto Add Margin","href":"/docs/derivatives/contract/auto-margin","docId":"v3/derivatives/rest-contract/position/auto-margin"},{"type":"link","label":"Switch Cross/Isolated Margin","href":"/docs/derivatives/contract/cross-isolated","docId":"v3/derivatives/rest-contract/position/cross-isolated-margin"},{"type":"link","label":"Switch Position Mode","href":"/docs/derivatives/contract/position-mode","docId":"v3/derivatives/rest-contract/position/position-mode"},{"type":"link","label":"Switch TP/SL Mode","href":"/docs/derivatives/contract/tpsl-mode","docId":"v3/derivatives/rest-contract/position/tpsl-mode"},{"type":"link","label":"Set Leverage","href":"/docs/derivatives/contract/leverage","docId":"v3/derivatives/rest-contract/position/leverage"},{"type":"link","label":"Set Trading Stop","href":"/docs/derivatives/contract/trading-stop","docId":"v3/derivatives/rest-contract/position/trading-stop"},{"type":"link","label":"Set Risk Limit (Depreciated)","href":"/docs/derivatives/contract/set-risk-limit","docId":"v3/derivatives/rest-contract/position/set-risk-limit"},{"type":"link","label":"Get Execution List","href":"/docs/derivatives/contract/execution-list","docId":"v3/derivatives/rest-contract/position/execution"},{"type":"link","label":"Get Closed PnL","href":"/docs/derivatives/contract/closepnl","docId":"v3/derivatives/rest-contract/position/close-pnl"},{"type":"link","label":"Confirm New Risk Limit","href":"/docs/derivatives/contract/confirm-mmr","docId":"v3/derivatives/rest-contract/position/confirm-mmr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Account","items":[{"type":"link","label":"Wallet Balance","href":"/docs/derivatives/contract/wallet","docId":"v3/derivatives/rest-contract/account/wallet-balance"},{"type":"link","label":"Get Trading Fee Rate","href":"/docs/derivatives/contract/fee-rate","docId":"v3/derivatives/rest-contract/account/trading-fee"},{"type":"link","label":"Get Wallet Fund Records","href":"/docs/derivatives/contract/wallet-fund","docId":"v3/derivatives/rest-contract/account/wallet-fund-record"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket Stream","items":[{"type":"link","label":"Connect","href":"/docs/derivatives/ws/connect","docId":"v3/derivatives/wss-authentication"},{"type":"category","label":"Public Channel","items":[{"type":"link","label":"Orderbook","href":"/docs/derivatives/ws-public/orderbook","docId":"v3/derivatives/wss-public/orderbook"},{"type":"link","label":"Public Trade","href":"/docs/derivatives/ws-public/trade","docId":"v3/derivatives/wss-public/trade"},{"type":"link","label":"Tickers","href":"/docs/derivatives/ws-public/ticker","docId":"v3/derivatives/wss-public/tickers"},{"type":"link","label":"Kline","href":"/docs/derivatives/ws-public/kline","docId":"v3/derivatives/wss-public/kline"},{"type":"link","label":"Liquidation","href":"/docs/derivatives/ws-public/liquidation","docId":"v3/derivatives/wss-public/liquidation"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Private Channel (contract)","items":[{"type":"link","label":"Position","href":"/docs/derivatives/ws-contract/position","docId":"v3/derivatives/wss-contract/position"},{"type":"link","label":"Execution","href":"/docs/derivatives/ws-contract/execution","docId":"v3/derivatives/wss-contract/execution"},{"type":"link","label":"Order","href":"/docs/derivatives/ws-contract/order","docId":"v3/derivatives/wss-contract/order"},{"type":"link","label":"Wallet","href":"/docs/derivatives/ws-contract/wallet","docId":"v3/derivatives/wss-contract/wallet"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"Rate Limit","href":"/docs/derivatives/rate-limit","docId":"v3/derivatives/rate-limit"},{"type":"link","label":"Enums Definitions","href":"/docs/derivatives/enum","docId":"v3/derivatives/enum"},{"type":"link","label":"Error Code","href":"/docs/derivatives/error","docId":"v3/derivatives/error"}],"collapsed":true,"collapsible":true,"href":"/docs/category/derivatives"},{"type":"category","label":"Spot","items":[{"type":"category","label":"REST API","items":[{"type":"category","label":"Market data","items":[{"type":"link","label":"Instrument Info","href":"/docs/spot/public/instrument","docId":"v3/spot/rest-public/instrument-info"},{"type":"link","label":"Order Book","href":"/docs/spot/public/depth","docId":"v3/spot/rest-public/orderbook"},{"type":"link","label":"Merged Order Book","href":"/docs/spot/public/merge-depth","docId":"v3/spot/rest-public/merge-orderbook"},{"type":"link","label":"Kline","href":"/docs/spot/public/kline","docId":"v3/spot/rest-public/kline"},{"type":"link","label":"Public Trading Records","href":"/docs/spot/public/recent-trade","docId":"v3/spot/rest-public/public-trade"},{"type":"link","label":"Best Bid/Ask Price","href":"/docs/spot/public/bid-ask","docId":"v3/spot/rest-public/best-bid-ask"},{"type":"link","label":"Last Traded Price","href":"/docs/spot/public/last-price","docId":"v3/spot/rest-public/last-trade-price"},{"type":"link","label":"Tickers","href":"/docs/spot/public/tickers","docId":"v3/spot/rest-public/ticker-info"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Trade","items":[{"type":"link","label":"Place Order","href":"/docs/spot/trade/place-order","docId":"v3/spot/rest-spot/place-order"},{"type":"link","label":"Get Order","href":"/docs/spot/trade/get-order","docId":"v3/spot/rest-spot/get-order"},{"type":"link","label":"Cancel Order","href":"/docs/spot/trade/cancel","docId":"v3/spot/rest-spot/cancel-order"},{"type":"link","label":"Open Orders","href":"/docs/spot/trade/open-order","docId":"v3/spot/rest-spot/open-order"},{"type":"link","label":"Batch Cancel Order","href":"/docs/spot/trade/batch-cancel","docId":"v3/spot/rest-spot/batch-cancel"},{"type":"link","label":"Batch Cancel Order By Id","href":"/docs/spot/trade/cancel-by-id","docId":"v3/spot/rest-spot/batch-cancel-by-id"},{"type":"link","label":"Order History","href":"/docs/spot/trade/order-history","docId":"v3/spot/rest-spot/order-history"},{"type":"link","label":"Trade History","href":"/docs/spot/trade/my-trades","docId":"v3/spot/rest-spot/trade-history"}],"collapsed":true,"collapsible":true},{"type":"link","label":"Get Wallet Balance","href":"/docs/spot/wallet","docId":"v3/spot/wallet"},{"type":"category","label":"Leveraged Token","items":[{"type":"link","label":"All Asset Info","href":"/docs/spot/etp/asset-info","docId":"v3/spot/rest-etp/asset-info"},{"type":"link","label":"Market Info","href":"/docs/spot/etp/market-info","docId":"v3/spot/rest-etp/market-info"},{"type":"link","label":"Purchase & Redeem History","href":"/docs/spot/etp/order-history","docId":"v3/spot/rest-etp/purchase-redeem-history"},{"type":"link","label":"Purchase","href":"/docs/spot/etp/purchase","docId":"v3/spot/rest-etp/purchase"},{"type":"link","label":"Redeem","href":"/docs/spot/etp/redeem","docId":"v3/spot/rest-etp/redeem"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Cross Margin Trade","items":[{"type":"link","label":"Get Loan Account Info","href":"/docs/spot/margin/account","docId":"v3/spot/rest-spot-margin/account-info"},{"type":"link","label":"Get Borrow Order Detail","href":"/docs/spot/margin/borrow-history","docId":"v3/spot/rest-spot-margin/borrow-info"},{"type":"link","label":"Borrow","href":"/docs/spot/margin/borrow","docId":"v3/spot/rest-spot-margin/borrow"},{"type":"link","label":"Get Borrowable Coin Info","href":"/docs/spot/margin/borrowable-coin","docId":"v3/spot/rest-spot-margin/borrowable-data"},{"type":"link","label":"Get Interest & Quota","href":"/docs/spot/margin/interest","docId":"v3/spot/rest-spot-margin/interest-quota"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/spot/margin/margin-data","docId":"v3/spot/rest-spot-margin/margin-data"},{"type":"link","label":"Get Repayment Order Detail","href":"/docs/spot/margin/repay-history","docId":"v3/spot/rest-spot-margin/repay-history"},{"type":"link","label":"Repay","href":"/docs/spot/margin/repay","docId":"v3/spot/rest-spot-margin/repay"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/spot/margin/toggle","docId":"v3/spot/rest-spot-margin/switch-mode"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Institution Loan","items":[{"type":"link","label":"Get Margin Product Info","href":"/docs/spot/otc/product-info","docId":"v3/spot/rest-institution-loan/margin-product-info"},{"type":"link","label":"Margin Coin Info","href":"/docs/spot/otc/coin-info","docId":"v3/spot/rest-institution-loan/margin-coin-info"},{"type":"link","label":"Get Loan Info","href":"/docs/spot/otc/loan-info","docId":"v3/spot/rest-institution-loan/loan-info"},{"type":"link","label":"Get Repay Info","href":"/docs/spot/otc/repay-info","docId":"v3/spot/rest-institution-loan/repay-info"},{"type":"link","label":"Get LTV","href":"/docs/spot/otc/ltv","docId":"v3/spot/rest-institution-loan/ltv"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket Stream","items":[{"type":"link","label":"Connect","href":"/docs/spot/ws/connect","docId":"v3/spot/wss-authentication"},{"type":"category","label":"Public Channel","items":[{"type":"link","label":"Orderbook","href":"/docs/spot/ws-public/orderbook","docId":"v3/spot/wss-public/orderbook"},{"type":"link","label":"Kline","href":"/docs/spot/ws-public/kline","docId":"v3/spot/wss-public/kline"},{"type":"link","label":"Tickers","href":"/docs/spot/ws-public/ticker","docId":"v3/spot/wss-public/tickers"},{"type":"link","label":"Bookticker","href":"/docs/spot/ws-public/bookticker","docId":"v3/spot/wss-public/bookticker"},{"type":"link","label":"Public trade","href":"/docs/spot/ws-public/public-trade","docId":"v3/spot/wss-public/trade"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Private Channel","items":[{"type":"link","label":"Order","href":"/docs/spot/ws-private/order","docId":"v3/spot/wss-private/order"},{"type":"link","label":"Stop Order","href":"/docs/spot/ws-private/stop-order","docId":"v3/spot/wss-private/stop-order"},{"type":"link","label":"Execution","href":"/docs/spot/ws-private/execution","docId":"v3/spot/wss-private/ticket-info"},{"type":"link","label":"Wallet","href":"/docs/spot/ws-private/wallet","docId":"v3/spot/wss-private/outbound-account-info"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"Rate Limit","href":"/docs/spot/rate-limit","docId":"v3/spot/rate-limit"},{"type":"link","label":"Enums Definitions","href":"/docs/spot/enum","docId":"v3/spot/enum"},{"type":"link","label":"Error Code","href":"/docs/spot/error","docId":"v3/spot/error"}],"collapsed":true,"collapsible":true,"href":"/docs/category/spot"},{"type":"category","label":"Account Asset","collapsed":true,"items":[{"type":"category","label":"Transfer Endpoint","collapsed":true,"items":[{"type":"link","label":"Create Internal Transfer","href":"/docs/account-asset/internal-transfer","docId":"v3/account-asset/transfer/internal-transfer"},{"type":"link","label":"Get Internal Transfer List","href":"/docs/account-asset/internal-transfer-list","docId":"v3/account-asset/transfer/internal-transfer-list"},{"type":"link","label":"Create Subaccount Transfer","href":"/docs/account-asset/sub-transfer","docId":"v3/account-asset/transfer/subacct-transfer"},{"type":"link","label":"Get Master-Sub Transfer List","href":"/docs/account-asset/sub-transfer-list","docId":"v3/account-asset/transfer/subacct-transfer-list"},{"type":"link","label":"Get Subaccount UID List","href":"/docs/account-asset/sub-uid-list","docId":"v3/account-asset/transfer/subacct-list"},{"type":"link","label":"Enable Universal Transfer (Depreciated)","href":"/docs/account-asset/enable-unitransfer","docId":"v3/account-asset/transfer/enable-uni-transfer"},{"type":"link","label":"Create Universal Transfer","href":"/docs/account-asset/uni-transfer","docId":"v3/account-asset/transfer/uni-transfer"},{"type":"link","label":"Get Universal Transfer List","href":"/docs/account-asset/uni-transfer-list","docId":"v3/account-asset/transfer/uni-transfer-list"},{"type":"link","label":"Get Transferable Coin List","href":"/docs/account-asset/transferable-coin-list","docId":"v3/account-asset/transfer/transferable-coin-list"},{"type":"link","label":"Get Single Coin Balance","href":"/docs/account-asset/coin-balance","docId":"v3/account-asset/transfer/coin-balance"},{"type":"link","label":"Get All Coins Balance","href":"/docs/account-asset/all-balance","docId":"v3/account-asset/transfer/all-balance"},{"type":"link","label":"Get Asset Info (Spot)","href":"/docs/account-asset/asset-info","docId":"v3/account-asset/transfer/asset-info"}],"collapsible":true},{"type":"category","label":"Withdraw and Deposit endpoint","collapsed":true,"items":[{"type":"link","label":"Get Deposit Spec","href":"/docs/account-asset/deposit-spec","docId":"v3/account-asset/withdraw-deposit/deposit-spec"},{"type":"link","label":"Set Deposit Account","href":"/docs/account-asset/set-deposit-acct","docId":"v3/account-asset/withdraw-deposit/set-deposit-acct"},{"type":"link","label":"Get Deposit Records (on chain)","href":"/docs/account-asset/deposit-record","docId":"v3/account-asset/withdraw-deposit/master-deposit-record"},{"type":"link","label":"Get Sub Deposit Records (on chain)","href":"/docs/account-asset/sub-deposit-record","docId":"v3/account-asset/withdraw-deposit/sub-deposit-record"},{"type":"link","label":"Get Bybit Internal Deposit Records (across Bybit)","href":"/docs/account-asset/internal-deposit-record","docId":"v3/account-asset/withdraw-deposit/internal-deposit-record"},{"type":"link","label":"Get Withdraw Records","href":"/docs/account-asset/withdraw-record","docId":"v3/account-asset/withdraw-deposit/withdraw-record"},{"type":"link","label":"Get Coin Information","href":"/docs/account-asset/coin-info","docId":"v3/account-asset/withdraw-deposit/coin-info"},{"type":"link","label":"Get Delay Withdraw Amount","href":"/docs/account-asset/delay-amount","docId":"v3/account-asset/withdraw-deposit/deplay-amount"},{"type":"link","label":"Get Exchange Entity List (KOR)","href":"/docs/account-asset/vasp-list","docId":"v3/account-asset/withdraw-deposit/vasp-list"},{"type":"link","label":"Withdraw","href":"/docs/account-asset/withdraw","docId":"v3/account-asset/withdraw-deposit/withdraw"},{"type":"link","label":"Cancel withdrawal","href":"/docs/account-asset/cancel-withdraw","docId":"v3/account-asset/withdraw-deposit/cancel-withdraw"},{"type":"link","label":"Get Master Acct Deposit Address Info","href":"/docs/account-asset/master-deposit-addr","docId":"v3/account-asset/withdraw-deposit/master-deposit-addr"},{"type":"link","label":"Get Sub Acct Deposit Address Info","href":"/docs/account-asset/sub-deposit-addr","docId":"v3/account-asset/withdraw-deposit/sub-deposit-addr"}],"collapsible":true},{"type":"category","label":"Master-Sub User Endpoint","collapsed":true,"items":[{"type":"link","label":"Create Sub UID","href":"/docs/account-asset/create-subuid","docId":"v3/account-asset/user/create-subuid"},{"type":"link","label":"Create Sub UID API Key","href":"/docs/account-asset/create-subuid-apikey","docId":"v3/account-asset/user/create-subuid-apikey"},{"type":"link","label":"Get Sub UID List","href":"/docs/account-asset/subuid-list","docId":"v3/account-asset/user/subuid-list"},{"type":"link","label":"Froze Sub UID","href":"/docs/account-asset/froze-subuid","docId":"v3/account-asset/user/froze-subuid"},{"type":"link","label":"Get API Key Information","href":"/docs/account-asset/apikey-info","docId":"v3/account-asset/user/apikey-info"},{"type":"link","label":"Get UID Wallet Type","href":"/docs/account-asset/wallet-type","docId":"v3/account-asset/user/wallet-type"},{"type":"link","label":"Modify Master API Key","href":"/docs/account-asset/modify-master-apikey","docId":"v3/account-asset/user/modify-master-apikey"},{"type":"link","label":"Modify Sub API Key","href":"/docs/account-asset/modify-sub-apikey","docId":"v3/account-asset/user/modify-sub-apikey"},{"type":"link","label":"Delete Master API Key","href":"/docs/account-asset/rm-master-apikey","docId":"v3/account-asset/user/rm-master-apikey"},{"type":"link","label":"Delete Sub API Key","href":"/docs/account-asset/rm-sub-apikey","docId":"v3/account-asset/user/rm-sub-apikey"}],"collapsible":true},{"type":"link","label":"Rate Limit","href":"/docs/account-asset/rate-limit","docId":"v3/account-asset/rate-limit"},{"type":"link","label":"Enums Definitions","href":"/docs/account-asset/enum","docId":"v3/account-asset/enum"},{"type":"link","label":"Error Code","href":"/docs/account-asset/error","docId":"v3/account-asset/error"}],"collapsible":true},{"type":"category","label":"Tax","items":[{"type":"link","label":"Get User Register Date","href":"/docs/tax/time","docId":"v3/tax/register-time"},{"type":"link","label":"Request Export Report","href":"/docs/tax/report","docId":"v3/tax/request-report"},{"type":"link","label":"Get Export Report Status","href":"/docs/tax/status","docId":"v3/tax/report-status"},{"type":"link","label":"Retrieve Data Export","href":"/docs/tax/data-export","docId":"v3/tax/data-export"},{"type":"link","label":"Data Explanation","href":"/docs/tax/explain","docId":"v3/tax/data-explain"},{"type":"link","label":"Enums Definitions","href":"/docs/tax/enum","docId":"v3/tax/enum"}],"collapsed":true,"collapsible":true}],"v5SideBar":[{"type":"link","label":"Introduction","href":"/docs/v5/intro","docId":"v5/intro"},{"type":"link","label":"Integration Guidance","href":"/docs/v5/guide","docId":"v5/guide"},{"type":"link","label":"Get Announcement","href":"/docs/v5/announcement","docId":"v5/announcement"},{"type":"link","label":"Self Match Prevention","href":"/docs/v5/smp","docId":"v5/smp"},{"type":"link","label":"How To Start Copy Trading","href":"/docs/v5/copytrade","docId":"v5/copytrade"},{"type":"link","label":"Demo Trading Service","href":"/docs/v5/demo","docId":"v5/demo"},{"type":"category","label":"Market","items":[{"type":"link","label":"Get Bybit Server Time","href":"/docs/v5/market/time","docId":"v5/market/time"},{"type":"link","label":"Get Kline","href":"/docs/v5/market/kline","docId":"v5/market/kline"},{"type":"link","label":"Get Mark Price Kline","href":"/docs/v5/market/mark-kline","docId":"v5/market/mark-kline"},{"type":"link","label":"Get Index Price Kline","href":"/docs/v5/market/index-kline","docId":"v5/market/index-kline"},{"type":"link","label":"Get Premium Index Price Kline","href":"/docs/v5/market/preimum-index-kline","docId":"v5/market/preimum-index-kline"},{"type":"link","label":"Get Instruments Info","href":"/docs/v5/market/instrument","docId":"v5/market/instrument"},{"type":"link","label":"Get Orderbook","href":"/docs/v5/market/orderbook","docId":"v5/market/orderbook"},{"type":"link","label":"Get Tickers","href":"/docs/v5/market/tickers","docId":"v5/market/tickers"},{"type":"link","label":"Get Funding Rate History","href":"/docs/v5/market/history-fund-rate","docId":"v5/market/history-fund-rate"},{"type":"link","label":"Get Public Recent Trading History","href":"/docs/v5/market/recent-trade","docId":"v5/market/recent-trade"},{"type":"link","label":"Get Open Interest","href":"/docs/v5/market/open-interest","docId":"v5/market/open-interest"},{"type":"link","label":"Get Historical Volatility","href":"/docs/v5/market/iv","docId":"v5/market/iv"},{"type":"link","label":"Get Insurance","href":"/docs/v5/market/insurance","docId":"v5/market/insurance"},{"type":"link","label":"Get Risk Limit","href":"/docs/v5/market/risk-limit","docId":"v5/market/risk-limit"},{"type":"link","label":"Get Delivery Price","href":"/docs/v5/market/delivery-price","docId":"v5/market/delivery-price"},{"type":"link","label":"Get Long Short Ratio","href":"/docs/v5/market/long-short-ratio","docId":"v5/market/long-short-ratio"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Trade","items":[{"type":"link","label":"Place Order","href":"/docs/v5/order/create-order","docId":"v5/order/create-order"},{"type":"link","label":"Amend Order","href":"/docs/v5/order/amend-order","docId":"v5/order/amend-order"},{"type":"link","label":"Cancel Order","href":"/docs/v5/order/cancel-order","docId":"v5/order/cancel-order"},{"type":"link","label":"Get Open & Closed Orders","href":"/docs/v5/order/open-order","docId":"v5/order/open-order"},{"type":"link","label":"Cancel All Orders","href":"/docs/v5/order/cancel-all","docId":"v5/order/cancel-all"},{"type":"link","label":"Get Order History (2 years)","href":"/docs/v5/order/order-list","docId":"v5/order/order-list"},{"type":"link","label":"Get Trade History (2 years)","href":"/docs/v5/order/execution","docId":"v5/order/execution"},{"type":"link","label":"Batch Place Order","href":"/docs/v5/order/batch-place","docId":"v5/order/batch-place"},{"type":"link","label":"Batch Amend Order","href":"/docs/v5/order/batch-amend","docId":"v5/order/batch-amend"},{"type":"link","label":"Batch Cancel Order","href":"/docs/v5/order/batch-cancel","docId":"v5/order/batch-cancel"},{"type":"link","label":"Get Borrow Quota (Spot)","href":"/docs/v5/order/spot-borrow-quota","docId":"v5/order/spot-borrow-quota"},{"type":"link","label":"Set DCP","href":"/docs/v5/order/dcp","docId":"v5/order/dcp"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Position","items":[{"type":"link","label":"Get Position Info","href":"/docs/v5/position/","docId":"v5/position/position"},{"type":"link","label":"Set Leverage","href":"/docs/v5/position/leverage","docId":"v5/position/leverage"},{"type":"link","label":"Switch Cross/Isolated Margin","href":"/docs/v5/position/cross-isolate","docId":"v5/position/cross-isolate"},{"type":"link","label":"Set TP/SL Mode","href":"/docs/v5/position/tpsl-mode","docId":"v5/position/tpsl-mode"},{"type":"link","label":"Switch Position Mode","href":"/docs/v5/position/position-mode","docId":"v5/position/position-mode"},{"type":"link","label":"Set Risk Limit (Depreciated)","href":"/docs/v5/position/set-risk-limit","docId":"v5/position/set-risk-limit"},{"type":"link","label":"Set Trading Stop","href":"/docs/v5/position/trading-stop","docId":"v5/position/trading-stop"},{"type":"link","label":"Set Auto Add Margin","href":"/docs/v5/position/auto-add-margin","docId":"v5/position/auto-add-margin"},{"type":"link","label":"Add Or Reduce Margin","href":"/docs/v5/position/manual-add-margin","docId":"v5/position/manual-add-margin"},{"type":"link","label":"Get Closed PnL (2 years)","href":"/docs/v5/position/close-pnl","docId":"v5/position/close-pnl"},{"type":"link","label":"Move Position","href":"/docs/v5/position/move-position","docId":"v5/position/move-position"},{"type":"link","label":"Get Move Position History","href":"/docs/v5/position/move-position-history","docId":"v5/position/move-position-history"},{"type":"link","label":"Confirm New Risk Limit","href":"/docs/v5/position/confirm-mmr","docId":"v5/position/confirm-mmr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Pre-upgrade","items":[{"type":"link","label":"Get Pre-upgrade Order History","href":"/docs/v5/pre-upgrade/order-list","docId":"v5/pre-upgrade/order-list"},{"type":"link","label":"Get Pre-upgrade Trade History","href":"/docs/v5/pre-upgrade/execution","docId":"v5/pre-upgrade/execution"},{"type":"link","label":"Get Pre-upgrade Closed PnL","href":"/docs/v5/pre-upgrade/close-pnl","docId":"v5/pre-upgrade/close-pnl"},{"type":"link","label":"Get Pre-upgrade Transaction Log","href":"/docs/v5/pre-upgrade/transaction-log","docId":"v5/pre-upgrade/transaction-log"},{"type":"link","label":"Get Pre-upgrade Option Delivery Record","href":"/docs/v5/pre-upgrade/delivery","docId":"v5/pre-upgrade/delivery"},{"type":"link","label":"Get Pre-upgrade USDC Session Settlement","href":"/docs/v5/pre-upgrade/settlement","docId":"v5/pre-upgrade/settlement"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Account","items":[{"type":"link","label":"Get Wallet Balance","href":"/docs/v5/account/wallet-balance","docId":"v5/account/wallet-balance"},{"type":"link","label":"Upgrade to Unified Account","href":"/docs/v5/account/upgrade-unified-account","docId":"v5/account/upgrade-unified-account"},{"type":"link","label":"Get Borrow History (2 years)","href":"/docs/v5/account/borrow-history","docId":"v5/account/borrow-history"},{"type":"link","label":"Repay Liability","href":"/docs/v5/account/repay-liability","docId":"v5/account/repay-liability"},{"type":"link","label":"Set Collateral Coin","href":"/docs/v5/account/set-collateral","docId":"v5/account/set-collateral"},{"type":"link","label":"Batch Set Collateral Coin","href":"/docs/v5/account/batch-set-collateral","docId":"v5/account/batch-set-collateral"},{"type":"link","label":"Get Collateral Info","href":"/docs/v5/account/collateral-info","docId":"v5/account/collateral-info"},{"type":"link","label":"Get Coin Greeks","href":"/docs/v5/account/coin-greeks","docId":"v5/account/coin-greeks"},{"type":"link","label":"Get Fee Rate","href":"/docs/v5/account/fee-rate","docId":"v5/account/fee-rate"},{"type":"link","label":"Get Account Info","href":"/docs/v5/account/account-info","docId":"v5/account/account-info"},{"type":"link","label":"Get DCP Info","href":"/docs/v5/account/dcp-info","docId":"v5/account/dcp-info"},{"type":"link","label":"Get Transaction Log (UTA)","href":"/docs/v5/account/transaction-log","docId":"v5/account/transaction-log"},{"type":"link","label":"Get Transaction Log (Classic)","href":"/docs/v5/account/contract-transaction-log","docId":"v5/account/contract-transaction-log"},{"type":"link","label":"Get SMP Group ID","href":"/docs/v5/account/smp-group","docId":"v5/account/smp-group"},{"type":"link","label":"Set Margin Mode","href":"/docs/v5/account/set-margin-mode","docId":"v5/account/set-margin-mode"},{"type":"link","label":"Set Spot Hedging","href":"/docs/v5/account/set-spot-hedge","docId":"v5/account/set-spot-hedge"},{"type":"link","label":"Set MMP","href":"/docs/v5/account/set-mmp","docId":"v5/account/set-mmp"},{"type":"link","label":"Reset MMP","href":"/docs/v5/account/reset-mmp","docId":"v5/account/reset-mmp"},{"type":"link","label":"Get MMP State","href":"/docs/v5/account/get-mmp-state","docId":"v5/account/get-mmp-state"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Asset","items":[{"type":"link","label":"Get Delivery Record (2 years)","href":"/docs/v5/asset/delivery","docId":"v5/asset/delivery"},{"type":"link","label":"Get USDC Session Settlement (2 years)","href":"/docs/v5/asset/settlement","docId":"v5/asset/settlement"},{"type":"link","label":"Get Coin Exchange Records","href":"/docs/v5/asset/exchange","docId":"v5/asset/exchange"},{"type":"link","label":"Get Coin Info","href":"/docs/v5/asset/coin-info","docId":"v5/asset/coin-info"},{"type":"link","label":"Get Sub UID","href":"/docs/v5/asset/sub-uid-list","docId":"v5/asset/sub-uid-list"},{"type":"category","label":"Balances","items":[{"type":"link","label":"Get Asset Info (Spot)","href":"/docs/v5/asset/balance/asset-info","docId":"v5/asset/balance/asset-info"},{"type":"link","label":"Get All Coins Balance","href":"/docs/v5/asset/balance/all-balance","docId":"v5/asset/balance/all-balance"},{"type":"link","label":"Get Single Coin Balance","href":"/docs/v5/asset/balance/account-coin-balance","docId":"v5/asset/balance/account-coin-balance"},{"type":"link","label":"Get Withdrawable Amount","href":"/docs/v5/asset/balance/delay-amount","docId":"v5/asset/balance/delay-amount"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Transfer","items":[{"type":"link","label":"Get Transferable Coin","href":"/docs/v5/asset/transfer/transferable-coin","docId":"v5/asset/transfer/transferable-coin"},{"type":"link","label":"Create Internal Transfer","href":"/docs/v5/asset/transfer/create-inter-transfer","docId":"v5/asset/transfer/create-inter-transfer"},{"type":"link","label":"Get Internal Transfer Records","href":"/docs/v5/asset/transfer/inter-transfer-list","docId":"v5/asset/transfer/inter-transfer-list"},{"type":"link","label":"Create Universal Transfer","href":"/docs/v5/asset/transfer/unitransfer","docId":"v5/asset/transfer/unitransfer"},{"type":"link","label":"Get Universal Transfer Records","href":"/docs/v5/asset/transfer/unitransfer-list","docId":"v5/asset/transfer/unitransfer-list"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Deposit","items":[{"type":"link","label":"Get Allowed Deposit Coin Info","href":"/docs/v5/asset/deposit/deposit-coin-spec","docId":"v5/asset/deposit/deposit-coin-spec"},{"type":"link","label":"Set Deposit Account","href":"/docs/v5/asset/deposit/set-deposit-acct","docId":"v5/asset/deposit/set-deposit-acct"},{"type":"link","label":"Get Deposit Records (on-chain)","href":"/docs/v5/asset/deposit/deposit-record","docId":"v5/asset/deposit/deposit-record"},{"type":"link","label":"Get Sub Deposit Records (on-chain)","href":"/docs/v5/asset/deposit/sub-deposit-record","docId":"v5/asset/deposit/sub-deposit-record"},{"type":"link","label":"Get Internal Deposit Records (off-chain)","href":"/docs/v5/asset/deposit/internal-deposit-record","docId":"v5/asset/deposit/internal-deposit-record"},{"type":"link","label":"Get Master Deposit Address","href":"/docs/v5/asset/deposit/master-deposit-addr","docId":"v5/asset/deposit/master-deposit-addr"},{"type":"link","label":"Get Sub Deposit Address","href":"/docs/v5/asset/deposit/sub-deposit-addr","docId":"v5/asset/deposit/sub-deposit-addr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Withdraw","items":[{"type":"link","label":"Get Withdrawal Records","href":"/docs/v5/asset/withdraw/withdraw-record","docId":"v5/asset/withdraw/withdraw-record"},{"type":"link","label":"Get Exchange Entity List (KOR)","href":"/docs/v5/asset/withdraw/vasp-list","docId":"v5/asset/withdraw/vasp-list"},{"type":"link","label":"Withdraw","href":"/docs/v5/asset/withdraw/","docId":"v5/asset/withdraw/withdraw"},{"type":"link","label":"Cancel Withdrawal","href":"/docs/v5/asset/withdraw/cancel-withdraw","docId":"v5/asset/withdraw/cancel-withdraw"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Convert","items":[{"type":"link","label":"Guideline","href":"/docs/v5/asset/convert/guideline","docId":"v5/asset/convert/guideline"},{"type":"link","label":"Get Convert Coin List","href":"/docs/v5/asset/convert/convert-coin-list","docId":"v5/asset/convert/convert-coin-list"},{"type":"link","label":"Request a Quote","href":"/docs/v5/asset/convert/apply-quote","docId":"v5/asset/convert/apply-quote"},{"type":"link","label":"Confirm a Quote","href":"/docs/v5/asset/convert/confirm-quote","docId":"v5/asset/convert/confirm-quote"},{"type":"link","label":"Get Convert Status","href":"/docs/v5/asset/convert/get-convert-result","docId":"v5/asset/convert/get-convert-result"},{"type":"link","label":"Get Convert history","href":"/docs/v5/asset/convert/get-convert-history","docId":"v5/asset/convert/get-convert-history"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"User","items":[{"type":"link","label":"Create Sub UID","href":"/docs/v5/user/create-subuid","docId":"v5/user/create-subuid"},{"type":"link","label":"Create Sub UID API Key","href":"/docs/v5/user/create-subuid-apikey","docId":"v5/user/create-subuid-apikey"},{"type":"link","label":"Get Sub UID List (Limited)","href":"/docs/v5/user/subuid-list","docId":"v5/user/subuid-list"},{"type":"link","label":"Get Sub UID List (Unlimited)","href":"/docs/v5/user/page-subuid","docId":"v5/user/page-subuid"},{"type":"link","label":"Freeze Sub UID","href":"/docs/v5/user/froze-subuid","docId":"v5/user/froze-subuid"},{"type":"link","label":"Get API Key Information","href":"/docs/v5/user/apikey-info","docId":"v5/user/apikey-info"},{"type":"link","label":"Get Sub Account All API Keys","href":"/docs/v5/user/list-sub-apikeys","docId":"v5/user/list-sub-apikeys"},{"type":"link","label":"Get UID Wallet Type","href":"/docs/v5/user/wallet-type","docId":"v5/user/wallet-type"},{"type":"link","label":"Modify Master API Key","href":"/docs/v5/user/modify-master-apikey","docId":"v5/user/modify-master-apikey"},{"type":"link","label":"Modify Sub API Key","href":"/docs/v5/user/modify-sub-apikey","docId":"v5/user/modify-sub-apikey"},{"type":"link","label":"Delete Sub UID","href":"/docs/v5/user/rm-subuid","docId":"v5/user/rm-subuid"},{"type":"link","label":"Delete Master API Key","href":"/docs/v5/user/rm-master-apikey","docId":"v5/user/rm-master-apikey"},{"type":"link","label":"Delete Sub API Key","href":"/docs/v5/user/rm-sub-apikey","docId":"v5/user/rm-sub-apikey"},{"type":"link","label":"Get Affiliate User Info","href":"/docs/v5/user/affiliate-info","docId":"v5/user/affiliate-info"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Spot Leverage Token","items":[{"type":"link","label":"Get Leverage Token Info","href":"/docs/v5/lt/leverage-token-info","docId":"v5/lt/leverage-token-info"},{"type":"link","label":"Get Leveraged Token Market","href":"/docs/v5/lt/leverage-token-reference","docId":"v5/lt/leverage-token-reference"},{"type":"link","label":"Purchase","href":"/docs/v5/lt/purchase","docId":"v5/lt/purchase"},{"type":"link","label":"Redeem","href":"/docs/v5/lt/redeem","docId":"v5/lt/redeem"},{"type":"link","label":"Get Purchase/Redemption Records","href":"/docs/v5/lt/order-record","docId":"v5/lt/order-record"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Spot Margin Trade (UTA)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/v5/spot-margin-uta/vip-margin","docId":"v5/spot-margin-uta/vip-margin"},{"type":"link","label":"Get Historical Interest Rate","href":"/docs/v5/spot-margin-uta/historical-interest","docId":"v5/spot-margin-uta/historical-interest"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/v5/spot-margin-uta/switch-mode","docId":"v5/spot-margin-uta/switch-mode"},{"type":"link","label":"Set Leverage","href":"/docs/v5/spot-margin-uta/set-leverage","docId":"v5/spot-margin-uta/set-leverage"},{"type":"link","label":"Get Status And Leverage","href":"/docs/v5/spot-margin-uta/status","docId":"v5/spot-margin-uta/status"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Institutional Loan","items":[{"type":"link","label":"Get Product Info","href":"/docs/v5/otc/margin-product-info","docId":"v5/otc/margin-product-info"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/v5/otc/margin-coin-convert-info","docId":"v5/otc/margin-coin-convert-info"},{"type":"link","label":"Get Loan Orders","href":"/docs/v5/otc/loan-info","docId":"v5/otc/loan-info"},{"type":"link","label":"Get Repayment Orders","href":"/docs/v5/otc/repay-info","docId":"v5/otc/repay-info"},{"type":"link","label":"Get LTV","href":"/docs/v5/otc/ltv-convert","docId":"v5/otc/ltv-convert"},{"type":"link","label":"Bind Or Unbind UID","href":"/docs/v5/otc/bind-uid","docId":"v5/otc/bind-uid"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Broker","items":[{"type":"link","label":"Get Exchange Broker Earning","href":"/docs/v5/broker/exchange-earning","docId":"v5/broker/exchange-earning"},{"type":"link","label":"Get Exchange Broker Account Info","href":"/docs/v5/broker/account-info","docId":"v5/broker/account-info"},{"type":"link","label":"Get Sub Account Deposit Records","href":"/docs/v5/broker/sub-deposit-record","docId":"v5/broker/sub-deposit-record"}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket Stream","items":[{"type":"link","label":"Connect","href":"/docs/v5/ws/connect","docId":"v5/websocket/wss-authentication"},{"type":"category","label":"Public","items":[{"type":"link","label":"Orderbook","href":"/docs/v5/websocket/public/orderbook","docId":"v5/websocket/public/orderbook"},{"type":"link","label":"Trade","href":"/docs/v5/websocket/public/trade","docId":"v5/websocket/public/trade"},{"type":"link","label":"Ticker","href":"/docs/v5/websocket/public/ticker","docId":"v5/websocket/public/ticker"},{"type":"link","label":"Kline","href":"/docs/v5/websocket/public/kline","docId":"v5/websocket/public/kline"},{"type":"link","label":"Liquidation","href":"/docs/v5/websocket/public/liquidation","docId":"v5/websocket/public/liquidation"},{"type":"link","label":"LT Kline","href":"/docs/v5/websocket/public/etp-kline","docId":"v5/websocket/public/etp-kline"},{"type":"link","label":"LT Ticker","href":"/docs/v5/websocket/public/etp-ticker","docId":"v5/websocket/public/etp-ticker"},{"type":"link","label":"LT Nav","href":"/docs/v5/websocket/public/etp-nav","docId":"v5/websocket/public/etp-nav"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Private","items":[{"type":"link","label":"Position","href":"/docs/v5/websocket/private/position","docId":"v5/websocket/private/position"},{"type":"link","label":"Execution","href":"/docs/v5/websocket/private/execution","docId":"v5/websocket/private/execution"},{"type":"link","label":"Fast Execution","href":"/docs/v5/websocket/private/fast-execution","docId":"v5/websocket/private/fast-execution"},{"type":"link","label":"Order","href":"/docs/v5/websocket/private/order","docId":"v5/websocket/private/order"},{"type":"link","label":"Wallet","href":"/docs/v5/websocket/private/wallet","docId":"v5/websocket/private/wallet"},{"type":"link","label":"Greek","href":"/docs/v5/websocket/private/greek","docId":"v5/websocket/private/greek"},{"type":"link","label":"Dcp","href":"/docs/v5/websocket/private/dcp","docId":"v5/websocket/private/dcp"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Trade","items":[{"type":"link","label":"Websocket Trade Guideline","href":"/docs/v5/websocket/trade/guideline","docId":"v5/websocket/trade/guideline"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"Rate Limit","href":"/docs/v5/rate-limit","docId":"v5/rate-limit"},{"type":"link","label":"Enums Definitions","href":"/docs/v5/enum","docId":"v5/enum"},{"type":"link","label":"Error Codes","href":"/docs/v5/error","docId":"v5/error"},{"type":"category","label":"Abandoned Endpoints","items":[{"type":"link","label":"Get Lending Coin Info","href":"/docs/v5/abandon/coin-info","docId":"v5/abandon/coin-info"},{"type":"link","label":"Get LTV","href":"/docs/v5/abandon/ltv","docId":"v5/abandon/ltv"},{"type":"link","label":"Deposit Funds","href":"/docs/v5/abandon/deposit","docId":"v5/abandon/deposit"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/v5/abandon/margin-coin-info","docId":"v5/abandon/margin-coin-info"},{"type":"link","label":"Enable Universal Transfer for Sub UID","href":"/docs/v5/abandon/enable-unitransfer-subuid","docId":"v5/abandon/enable-unitransfer-subuid"},{"type":"link","label":"Redeem Funds","href":"/docs/v5/abandon/redeem","docId":"v5/abandon/redeem"},{"type":"link","label":"Cancel Redeem","href":"/docs/v5/abandon/cancel-redeem","docId":"v5/abandon/cancel-redeem"},{"type":"link","label":"Get Broker Earning","href":"/docs/v5/abandon/earning","docId":"v5/abandon/earning"},{"type":"link","label":"Get Order Records","href":"/docs/v5/abandon/order-record","docId":"v5/abandon/order-record"},{"type":"link","label":"Get Lending Account Info","href":"/docs/v5/abandon/account-info","docId":"v5/abandon/account-info"}],"collapsed":true,"collapsible":true}],"apiExplorerSideBar":[{"type":"category","label":"V5","items":[{"type":"category","label":"Market","items":[{"type":"link","label":"Get Bybit Server Time","href":"/docs/api-explorer/v5/market/time","className":"api-method get","docId":"api-explorer/v5/market/time"},{"type":"link","label":"Get Kline","href":"/docs/api-explorer/v5/market/kline","className":"api-method get","docId":"api-explorer/v5/market/kline"},{"type":"link","label":"Get Mark Price Kline","href":"/docs/api-explorer/v5/market/mark-kline","className":"api-method get","docId":"api-explorer/v5/market/mark-kline"},{"type":"link","label":"Get Index Price Kline","href":"/docs/api-explorer/v5/market/index-kline","className":"api-method get","docId":"api-explorer/v5/market/index-kline"},{"type":"link","label":"Get Premium Index Price Kline","href":"/docs/api-explorer/v5/market/premium-index-kline","className":"api-method get","docId":"api-explorer/v5/market/premium-index-kline"},{"type":"link","label":"Get Instrument Info","href":"/docs/api-explorer/v5/market/instrument","className":"api-method get","docId":"api-explorer/v5/market/instrument"},{"type":"link","label":"Get Orderbook","href":"/docs/api-explorer/v5/market/orderbook","className":"api-method get","docId":"api-explorer/v5/market/orderbook"},{"type":"link","label":"Get Tickers","href":"/docs/api-explorer/v5/market/tickers","className":"api-method get","docId":"api-explorer/v5/market/tickers"},{"type":"link","label":"Get Funding Rate History","href":"/docs/api-explorer/v5/market/history-fund-rate","className":"api-method get","docId":"api-explorer/v5/market/history-fund-rate"},{"type":"link","label":"Get Public Recent Trading History","href":"/docs/api-explorer/v5/market/recent-trade","className":"api-method get","docId":"api-explorer/v5/market/recent-trade"},{"type":"link","label":"Get Open Interest","href":"/docs/api-explorer/v5/market/open-interest","className":"api-method get","docId":"api-explorer/v5/market/open-interest"},{"type":"link","label":"Get Historical Volatility","href":"/docs/api-explorer/v5/market/iv","className":"api-method get","docId":"api-explorer/v5/market/iv"},{"type":"link","label":"Get Insurance","href":"/docs/api-explorer/v5/market/insurance","className":"api-method get","docId":"api-explorer/v5/market/insurance"},{"type":"link","label":"Get Risk Limit","href":"/docs/api-explorer/v5/market/risk-limit","className":"api-method get","docId":"api-explorer/v5/market/risk-limit"},{"type":"link","label":"Get Delivery Price","href":"/docs/api-explorer/v5/market/delivery-price","className":"api-method get","docId":"api-explorer/v5/market/delivery-price"},{"type":"link","label":"Get Long Short Ratio","href":"/docs/api-explorer/v5/market/long-short-ratio","className":"api-method get","docId":"api-explorer/v5/market/long-short-ratio"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/market/market"},{"type":"category","label":"Trade","items":[{"type":"link","label":"Place Order","href":"/docs/api-explorer/v5/trade/create-order","className":"api-method post","docId":"api-explorer/v5/trade/create-order"},{"type":"link","label":"Amend Order","href":"/docs/api-explorer/v5/trade/amend-order","className":"api-method post","docId":"api-explorer/v5/trade/amend-order"},{"type":"link","label":"Cancel Order","href":"/docs/api-explorer/v5/trade/cancel-order","className":"api-method post","docId":"api-explorer/v5/trade/cancel-order"},{"type":"link","label":"Get Open Orders (real-time)","href":"/docs/api-explorer/v5/trade/open-order","className":"api-method get","docId":"api-explorer/v5/trade/open-order"},{"type":"link","label":"Cancel All Orders","href":"/docs/api-explorer/v5/trade/cancel-all","className":"api-method post","docId":"api-explorer/v5/trade/cancel-all"},{"type":"link","label":"Get Order History (2 years)","href":"/docs/api-explorer/v5/trade/order-list","className":"api-method get","docId":"api-explorer/v5/trade/order-list"},{"type":"link","label":"Batch Place Order","href":"/docs/api-explorer/v5/trade/batch-place","className":"api-method post","docId":"api-explorer/v5/trade/batch-place"},{"type":"link","label":"Batch Amend Order","href":"/docs/api-explorer/v5/trade/batch-amend","className":"api-method post","docId":"api-explorer/v5/trade/batch-amend"},{"type":"link","label":"Batch Cancel Order","href":"/docs/api-explorer/v5/trade/batch-cancel","className":"api-method post","docId":"api-explorer/v5/trade/batch-cancel"},{"type":"link","label":"Get Borrow Quota (Spot)","href":"/docs/api-explorer/v5/trade/query-spot-quota","className":"api-method get","docId":"api-explorer/v5/trade/query-spot-quota"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/trade/trade"},{"type":"category","label":"Position","items":[{"type":"link","label":"Get Position Info","href":"/docs/api-explorer/v5/position/position-info","className":"api-method get","docId":"api-explorer/v5/position/position-info"},{"type":"link","label":"Set Leverage","href":"/docs/api-explorer/v5/position/leverage","className":"api-method post","docId":"api-explorer/v5/position/leverage"},{"type":"link","label":"Switch Cross/Isolated Margin","href":"/docs/api-explorer/v5/position/cross-isolate","className":"api-method post","docId":"api-explorer/v5/position/cross-isolate"},{"type":"link","label":"Set TP/SL Mode","href":"/docs/api-explorer/v5/position/tpsl-mode","className":"api-method post","docId":"api-explorer/v5/position/tpsl-mode"},{"type":"link","label":"Switch Position Mode","href":"/docs/api-explorer/v5/position/position-mode","className":"api-method post","docId":"api-explorer/v5/position/position-mode"},{"type":"link","label":"Set Risk Limit","href":"/docs/api-explorer/v5/position/set-risk-limit","className":"api-method post","docId":"api-explorer/v5/position/set-risk-limit"},{"type":"link","label":"Set Trading Stop","href":"/docs/api-explorer/v5/position/trading-stop","className":"api-method post","docId":"api-explorer/v5/position/trading-stop"},{"type":"link","label":"Set Auto Add Margin","href":"/docs/api-explorer/v5/position/auto-add-margin","className":"api-method post","docId":"api-explorer/v5/position/auto-add-margin"},{"type":"link","label":"Add Or Reduce Margin","href":"/docs/api-explorer/v5/position/manual-add-margin","className":"api-method post","docId":"api-explorer/v5/position/manual-add-margin"},{"type":"link","label":"Get Execution (2 years)","href":"/docs/api-explorer/v5/position/execution","className":"api-method get","docId":"api-explorer/v5/position/execution"},{"type":"link","label":"Get Closed PnL","href":"/docs/api-explorer/v5/position/close-pnl","className":"api-method get","docId":"api-explorer/v5/position/close-pnl"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/position/position"},{"type":"category","label":"Account","items":[{"type":"link","label":"Get Wallet Balance","href":"/docs/api-explorer/v5/account/wallet","className":"api-method get","docId":"api-explorer/v5/account/wallet"},{"type":"link","label":"Upgrade to Unified Account","href":"/docs/api-explorer/v5/account/upgrade-unified-account","className":"api-method post","docId":"api-explorer/v5/account/upgrade-unified-account"},{"type":"link","label":"Set Collateral Coin","href":"/docs/api-explorer/v5/account/set-collateral","className":"api-method post","docId":"api-explorer/v5/account/set-collateral"},{"type":"link","label":"Get Borrow History","href":"/docs/api-explorer/v5/account/borrow-history","className":"api-method get","docId":"api-explorer/v5/account/borrow-history"},{"type":"link","label":"Get Collateral Info","href":"/docs/api-explorer/v5/account/collateral-info","className":"api-method get","docId":"api-explorer/v5/account/collateral-info"},{"type":"link","label":"Get Coin Greeks","href":"/docs/api-explorer/v5/account/coin-greeks","className":"api-method get","docId":"api-explorer/v5/account/coin-greeks"},{"type":"link","label":"Get Fee Rate","href":"/docs/api-explorer/v5/account/fee-rate","className":"api-method get","docId":"api-explorer/v5/account/fee-rate"},{"type":"link","label":"Get Account Info","href":"/docs/api-explorer/v5/account/account-info","className":"api-method get","docId":"api-explorer/v5/account/account-info"},{"type":"link","label":"Get Transaction Log","href":"/docs/api-explorer/v5/account/transaction-log","className":"api-method get","docId":"api-explorer/v5/account/transaction-log"},{"type":"link","label":"Set Margin Mode","href":"/docs/api-explorer/v5/account/set-margin-mode","className":"api-method post","docId":"api-explorer/v5/account/set-margin-mode"},{"type":"link","label":"Set Spot Hedging","href":"/docs/api-explorer/v5/account/set-spot-hedge","className":"api-method post","docId":"api-explorer/v5/account/set-spot-hedge"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/account/account"},{"type":"category","label":"Asset","items":[{"type":"link","label":"Get Coin Exchange Records","href":"/docs/api-explorer/v5/asset/exchange","className":"api-method get","docId":"api-explorer/v5/asset/exchange"},{"type":"link","label":"Get Delivery Record","href":"/docs/api-explorer/v5/asset/delivery","className":"api-method get","docId":"api-explorer/v5/asset/delivery"},{"type":"link","label":"Get USDC Session Settlement","href":"/docs/api-explorer/v5/asset/settlement","className":"api-method get","docId":"api-explorer/v5/asset/settlement"},{"type":"link","label":"Get Asset Info (Spot)","href":"/docs/api-explorer/v5/asset/asset-info","className":"api-method get","docId":"api-explorer/v5/asset/asset-info"},{"type":"link","label":"Get All Coins Balance","href":"/docs/api-explorer/v5/asset/all-balance","className":"api-method get","docId":"api-explorer/v5/asset/all-balance"},{"type":"link","label":"Get Single Coin Balance","href":"/docs/api-explorer/v5/asset/account-coin-balance","className":"api-method get","docId":"api-explorer/v5/asset/account-coin-balance"},{"type":"link","label":"Get Transferable Coin","href":"/docs/api-explorer/v5/asset/transferable-coin","className":"api-method get","docId":"api-explorer/v5/asset/transferable-coin"},{"type":"link","label":"Create Internal Transfer","href":"/docs/api-explorer/v5/asset/create-inter-transfer","className":"api-method post","docId":"api-explorer/v5/asset/create-inter-transfer"},{"type":"link","label":"Get Internal Transfer Records","href":"/docs/api-explorer/v5/asset/inter-transfer-list","className":"api-method get","docId":"api-explorer/v5/asset/inter-transfer-list"},{"type":"link","label":"Get Sub UID","href":"/docs/api-explorer/v5/asset/sub-uid-list","className":"api-method get","docId":"api-explorer/v5/asset/sub-uid-list"},{"type":"link","label":"Create Universal Transfer","href":"/docs/api-explorer/v5/asset/unitransfer","className":"api-method post","docId":"api-explorer/v5/asset/unitransfer"},{"type":"link","label":"Get Universal Transfer Records","href":"/docs/api-explorer/v5/asset/unitransfer-list","className":"api-method get","docId":"api-explorer/v5/asset/unitransfer-list"},{"type":"link","label":"Get Allowed Deposit Coin Info","href":"/docs/api-explorer/v5/asset/deposit-coin-spec","className":"api-method get","docId":"api-explorer/v5/asset/deposit-coin-spec"},{"type":"link","label":"Set Deposit Account","href":"/docs/api-explorer/v5/asset/set-deposit-acct","className":"api-method post","docId":"api-explorer/v5/asset/set-deposit-acct"},{"type":"link","label":"Get Deposit Record (on-chain)","href":"/docs/api-explorer/v5/asset/deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/deposit-record"},{"type":"link","label":"Get Sub Account Deposit Records (on-chain)","href":"/docs/api-explorer/v5/asset/sub-deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/sub-deposit-record"},{"type":"link","label":"Get Internal Deposit Records (off-chain)","href":"/docs/api-explorer/v5/asset/internal-deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/internal-deposit-record"},{"type":"link","label":"Get Master Deposit Address","href":"/docs/api-explorer/v5/asset/master-deposit-addr","className":"api-method get","docId":"api-explorer/v5/asset/master-deposit-addr"},{"type":"link","label":"Get Sub Deposit Address","href":"/docs/api-explorer/v5/asset/sub-deposit-addr","className":"api-method get","docId":"api-explorer/v5/asset/sub-deposit-addr"},{"type":"link","label":"Get Coin Info","href":"/docs/api-explorer/v5/asset/coin-info","className":"api-method get","docId":"api-explorer/v5/asset/coin-info"},{"type":"link","label":"Get Withdraw Records","href":"/docs/api-explorer/v5/asset/withdraw-record","className":"api-method get","docId":"api-explorer/v5/asset/withdraw-record"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/asset/asset"},{"type":"category","label":"User","items":[{"type":"link","label":"Get API Key Information","href":"/docs/api-explorer/v5/user/apikey-info","className":"api-method get","docId":"api-explorer/v5/user/apikey-info"},{"type":"link","label":"Get Sub Account All API Keys","href":"/docs/api-explorer/v5/user/list-sub-apikeys","className":"api-method get","docId":"api-explorer/v5/user/list-sub-apikeys"},{"type":"link","label":"Get UID Wallet Type","href":"/docs/api-explorer/v5/user/wallet-type","className":"api-method get","docId":"api-explorer/v5/user/wallet-type"},{"type":"link","label":"Get Affiliate User Info","href":"/docs/api-explorer/v5/user/affiliate-info","className":"api-method get","docId":"api-explorer/v5/user/affiliate-info"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/user/user"},{"type":"category","label":"Spot Leverage Token","items":[{"type":"link","label":"Get Leverage Token Info","href":"/docs/api-explorer/v5/lt/leverage-token-info","className":"api-method get","docId":"api-explorer/v5/lt/leverage-token-info"},{"type":"link","label":"Get Leverage Token Market","href":"/docs/api-explorer/v5/lt/leverage-token-reference","className":"api-method get","docId":"api-explorer/v5/lt/leverage-token-reference"},{"type":"link","label":"Purchase","href":"/docs/api-explorer/v5/lt/purchase","className":"api-method post","docId":"api-explorer/v5/lt/purchase"},{"type":"link","label":"Redeem","href":"/docs/api-explorer/v5/lt/redeem","className":"api-method post","docId":"api-explorer/v5/lt/redeem"},{"type":"link","label":"Get Purchase or Redeem Records","href":"/docs/api-explorer/v5/lt/order-record","className":"api-method get","docId":"api-explorer/v5/lt/order-record"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/lt/etp"},{"type":"category","label":"Spot Margin Trade (UTA)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/api-explorer/v5/spot-margin-uta/vip-margin","className":"api-method get","docId":"api-explorer/v5/spot-margin-uta/vip-margin"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/api-explorer/v5/spot-margin-uta/switch-mode","className":"api-method post","docId":"api-explorer/v5/spot-margin-uta/switch-mode"},{"type":"link","label":"Set Leverage","href":"/docs/api-explorer/v5/spot-margin-uta/set-leverage","className":"api-method post","docId":"api-explorer/v5/spot-margin-uta/set-leverage"},{"type":"link","label":"Get Status And Leverage","href":"/docs/api-explorer/v5/spot-margin-uta/status","className":"api-method get","docId":"api-explorer/v5/spot-margin-uta/status"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/spot-margin-uta/uta-margin-trade"},{"type":"category","label":"Spot Margin Trade (Classic)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/api-explorer/v5/spot-margin-normal/vip-margin","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/vip-margin"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/api-explorer/v5/spot-margin-normal/margin-data","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/margin-data"},{"type":"link","label":"Get Borrowable Coin Info","href":"/docs/api-explorer/v5/spot-margin-normal/borrowable-data","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/borrowable-data"},{"type":"link","label":"Get Interest & Quota","href":"/docs/api-explorer/v5/spot-margin-normal/interest-quota","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/interest-quota"},{"type":"link","label":"Get Loan Account Info","href":"/docs/api-explorer/v5/spot-margin-normal/account-info","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/account-info"},{"type":"link","label":"Borrow","href":"/docs/api-explorer/v5/spot-margin-normal/borrow","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/borrow"},{"type":"link","label":"Repay","href":"/docs/api-explorer/v5/spot-margin-normal/repay","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/repay"},{"type":"link","label":"Get Borrow Order Detail","href":"/docs/api-explorer/v5/spot-margin-normal/borrow-order","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/borrow-order"},{"type":"link","label":"Get Repayment Order Detail","href":"/docs/api-explorer/v5/spot-margin-normal/repay-order","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/repay-order"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/api-explorer/v5/spot-margin-normal/switch-mode","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/switch-mode"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/spot-margin-normal/normal-margin-trade"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/category/"}],"changelogSidebar":[{"type":"link","label":"V5","href":"/docs/changelog/v5","docId":"changelog/v5"},{"type":"link","label":"Derivatives V3","href":"/docs/changelog/derivatives-v3","docId":"changelog/derivatives-v3"},{"type":"link","label":"Spot V3","href":"/docs/changelog/spot-v3","docId":"changelog/spot-v3"},{"type":"link","label":"Account Asset V3","href":"/docs/changelog/asset-v3","docId":"changelog/asset-v3"},{"type":"link","label":"Copy Trading","href":"/docs/changelog/copytrade","docId":"changelog/copytrade"}]},"docs":{"api-explorer/v5/account/account":{"id":"api-explorer/v5/account/account","title":"Account","description":"Account","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/account-info":{"id":"api-explorer/v5/account/account-info","title":"Get Account Info","description":"Get account info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/borrow-history":{"id":"api-explorer/v5/account/borrow-history","title":"Get Borrow History","description":"Get borrow history","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/coin-greeks":{"id":"api-explorer/v5/account/coin-greeks","title":"Get Coin Greeks","description":"Get coin greek info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/collateral-info":{"id":"api-explorer/v5/account/collateral-info","title":"Get Collateral Info","description":"Get collateral info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/fee-rate":{"id":"api-explorer/v5/account/fee-rate","title":"Get Fee Rate","description":"Get fee rate","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-collateral":{"id":"api-explorer/v5/account/set-collateral","title":"Set Collateral Coin","description":"Set collateral coin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-margin-mode":{"id":"api-explorer/v5/account/set-margin-mode","title":"Set Margin Mode","description":"Set margin mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-spot-hedge":{"id":"api-explorer/v5/account/set-spot-hedge","title":"Set Spot Hedging","description":"Set spot hedging for Portfolio margin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/transaction-log":{"id":"api-explorer/v5/account/transaction-log","title":"Get Transaction Log","description":"Get transaction log","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/upgrade-unified-account":{"id":"api-explorer/v5/account/upgrade-unified-account","title":"Upgrade to Unified Account","description":"Upgrade to UTA","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/wallet":{"id":"api-explorer/v5/account/wallet","title":"Get Wallet Balance","description":"Get wallet balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/account-coin-balance":{"id":"api-explorer/v5/asset/account-coin-balance","title":"Get Single Coin Balance","description":"Get Single Coin Balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/all-balance":{"id":"api-explorer/v5/asset/all-balance","title":"Get All Coins Balance","description":"Get All Coins Balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/asset":{"id":"api-explorer/v5/asset/asset","title":"Asset","description":"Asset","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/asset-info":{"id":"api-explorer/v5/asset/asset-info","title":"Get Asset Info (Spot)","description":"Get spot asset","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/coin-info":{"id":"api-explorer/v5/asset/coin-info","title":"Get Coin Info","description":"Get coin info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/create-inter-transfer":{"id":"api-explorer/v5/asset/create-inter-transfer","title":"Create Internal Transfer","description":"Create internal transfer","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/delivery":{"id":"api-explorer/v5/asset/delivery","title":"Get Delivery Record","description":"Get delivery record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/deposit-coin-spec":{"id":"api-explorer/v5/asset/deposit-coin-spec","title":"Get Allowed Deposit Coin Info","description":"Get allowed deposit coin info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/deposit-record":{"id":"api-explorer/v5/asset/deposit-record","title":"Get Deposit Record (on-chain)","description":"Get deposit record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/exchange":{"id":"api-explorer/v5/asset/exchange","title":"Get Coin Exchange Records","description":"Get exchange records","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/inter-transfer-list":{"id":"api-explorer/v5/asset/inter-transfer-list","title":"Get Internal Transfer Records","description":"Get internal transfer records","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/internal-deposit-record":{"id":"api-explorer/v5/asset/internal-deposit-record","title":"Get Internal Deposit Records (off-chain)","description":"Get deposit records through Bybit platform","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/master-deposit-addr":{"id":"api-explorer/v5/asset/master-deposit-addr","title":"Get Master Deposit Address","description":"Get master deposit address","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/set-deposit-acct":{"id":"api-explorer/v5/asset/set-deposit-acct","title":"Set Deposit Account","description":"Set Deposit Account","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/settlement":{"id":"api-explorer/v5/asset/settlement","title":"Get USDC Session Settlement","description":"Get usdc session settlement record.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-deposit-addr":{"id":"api-explorer/v5/asset/sub-deposit-addr","title":"Get Sub Deposit Address","description":"Get sub deposit address","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-deposit-record":{"id":"api-explorer/v5/asset/sub-deposit-record","title":"Get Sub Account Deposit Records (on-chain)","description":"Get sub account deposit record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-uid-list":{"id":"api-explorer/v5/asset/sub-uid-list","title":"Get Sub UID","description":"Get sub uid","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/transferable-coin":{"id":"api-explorer/v5/asset/transferable-coin","title":"Get Transferable Coin","description":"Get transferable coins","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/unitransfer":{"id":"api-explorer/v5/asset/unitransfer","title":"Create Universal Transfer","description":"Create universal transfer","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/unitransfer-list":{"id":"api-explorer/v5/asset/unitransfer-list","title":"Get Universal Transfer Records","description":"Get universal transfer record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/withdraw-record":{"id":"api-explorer/v5/asset/withdraw-record","title":"Get Withdraw Records","description":"Get withdraw record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/etp":{"id":"api-explorer/v5/lt/etp","title":"Spot Leverage Token","description":"Spot Leverage Token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/leverage-token-info":{"id":"api-explorer/v5/lt/leverage-token-info","title":"Get Leverage Token Info","description":"Get lt information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/leverage-token-reference":{"id":"api-explorer/v5/lt/leverage-token-reference","title":"Get Leverage Token Market","description":"Get lt market information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/order-record":{"id":"api-explorer/v5/lt/order-record","title":"Get Purchase or Redeem Records","description":"Get the order history of purchase or redeem","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/purchase":{"id":"api-explorer/v5/lt/purchase","title":"Purchase","description":"Purchase leverage token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/redeem":{"id":"api-explorer/v5/lt/redeem","title":"Redeem","description":"Redeem leverage token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/delivery-price":{"id":"api-explorer/v5/market/delivery-price","title":"Get Delivery Price","description":"Get delivery price","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/history-fund-rate":{"id":"api-explorer/v5/market/history-fund-rate","title":"Get Funding Rate History","description":"Get historical funding rate","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/index-kline":{"id":"api-explorer/v5/market/index-kline","title":"Get Index Price Kline","description":"Get Index Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/instrument":{"id":"api-explorer/v5/market/instrument","title":"Get Instrument Info","description":"Get launched instruments information.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/insurance":{"id":"api-explorer/v5/market/insurance","title":"Get Insurance","description":"Get Insurance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/iv":{"id":"api-explorer/v5/market/iv","title":"Get Historical Volatility","description":"Get historical volatility","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/kline":{"id":"api-explorer/v5/market/kline","title":"Get Kline","description":"Get kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/long-short-ratio":{"id":"api-explorer/v5/market/long-short-ratio","title":"Get Long Short Ratio","description":"Get long short ratio","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/mark-kline":{"id":"api-explorer/v5/market/mark-kline","title":"Get Mark Price Kline","description":"Get Mark Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/market":{"id":"api-explorer/v5/market/market","title":"Market","description":"Market","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/open-interest":{"id":"api-explorer/v5/market/open-interest","title":"Get Open Interest","description":"Get open interest","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/orderbook":{"id":"api-explorer/v5/market/orderbook","title":"Get Orderbook","description":"Get order book data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/premium-index-kline":{"id":"api-explorer/v5/market/premium-index-kline","title":"Get Premium Index Price Kline","description":"Get Premium Index Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/recent-trade":{"id":"api-explorer/v5/market/recent-trade","title":"Get Public Recent Trading History","description":"Get public trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/risk-limit":{"id":"api-explorer/v5/market/risk-limit","title":"Get Risk Limit","description":"Get risk limit","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/tickers":{"id":"api-explorer/v5/market/tickers","title":"Get Tickers","description":"Get all latest information of symbols. All parameters are needed for OPTION","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/time":{"id":"api-explorer/v5/market/time","title":"Get Bybit Server Time","description":"Get server time","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/auto-add-margin":{"id":"api-explorer/v5/position/auto-add-margin","title":"Set Auto Add Margin","description":"Set Auto Add Margin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/close-pnl":{"id":"api-explorer/v5/position/close-pnl","title":"Get Closed PnL","description":"Get closed pnl","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/cross-isolate":{"id":"api-explorer/v5/position/cross-isolate","title":"Switch Cross/Isolated Margin","description":"Select cross margin mode or isolated margin mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/execution":{"id":"api-explorer/v5/position/execution","title":"Get Execution (2 years)","description":"Get execution list","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/leverage":{"id":"api-explorer/v5/position/leverage","title":"Set Leverage","description":"Set levearage.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/manual-add-margin":{"id":"api-explorer/v5/position/manual-add-margin","title":"Add Or Reduce Margin","description":"Manually add or reduce margin for isolated margin position","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position":{"id":"api-explorer/v5/position/position","title":"Position","description":"Position","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position-info":{"id":"api-explorer/v5/position/position-info","title":"Get Position Info","description":"Get Position Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position-mode":{"id":"api-explorer/v5/position/position-mode","title":"Switch Position Mode","description":"Switch Position Mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/set-risk-limit":{"id":"api-explorer/v5/position/set-risk-limit","title":"Set Risk Limit","description":"Set risk limit.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/tpsl-mode":{"id":"api-explorer/v5/position/tpsl-mode","title":"Set TP/SL Mode","description":"Set tp/sl mode.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/trading-stop":{"id":"api-explorer/v5/position/trading-stop","title":"Set Trading Stop","description":"Set trade stop.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/account-info":{"id":"api-explorer/v5/spot-margin-normal/account-info","title":"Get Loan Account Info","description":"Get Loan Account Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrow":{"id":"api-explorer/v5/spot-margin-normal/borrow","title":"Borrow","description":"Borrow","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrow-order":{"id":"api-explorer/v5/spot-margin-normal/borrow-order","title":"Get Borrow Order Detail","description":"Get Borrow Order Detail","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrowable-data":{"id":"api-explorer/v5/spot-margin-normal/borrowable-data","title":"Get Borrowable Coin Info","description":"Get Borrowable Coin Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/interest-quota":{"id":"api-explorer/v5/spot-margin-normal/interest-quota","title":"Get Interest & Quota","description":"Get Interest & Quota","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/margin-data":{"id":"api-explorer/v5/spot-margin-normal/margin-data","title":"Get Margin Coin Info","description":"Get Margin Coin Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/normal-margin-trade":{"id":"api-explorer/v5/spot-margin-normal/normal-margin-trade","title":"Spot Margin Trade (Classic)","description":"Spot Margin Trade (Classic)","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/repay":{"id":"api-explorer/v5/spot-margin-normal/repay","title":"Repay","description":"Repay","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/repay-order":{"id":"api-explorer/v5/spot-margin-normal/repay-order","title":"Get Repayment Order Detail","description":"Get Repayment Order Detail","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/switch-mode":{"id":"api-explorer/v5/spot-margin-normal/switch-mode","title":"Toggle Margin Trade","description":"Toggle Margin Trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/vip-margin":{"id":"api-explorer/v5/spot-margin-normal/vip-margin","title":"Get VIP Margin Data","description":"Get vip margin data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/set-leverage":{"id":"api-explorer/v5/spot-margin-uta/set-leverage","title":"Set Leverage","description":"Set leverage for margin trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/status":{"id":"api-explorer/v5/spot-margin-uta/status","title":"Get Status And Leverage","description":"Get status and leverage","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/switch-mode":{"id":"api-explorer/v5/spot-margin-uta/switch-mode","title":"Toggle Margin Trade","description":"Toggle margin trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/uta-margin-trade":{"id":"api-explorer/v5/spot-margin-uta/uta-margin-trade","title":"Spot Margin Trade (UTA)","description":"Spot Margin Trade (UTA)","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/vip-margin":{"id":"api-explorer/v5/spot-margin-uta/vip-margin","title":"Get VIP Margin Data","description":"Get vip margin data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/amend-order":{"id":"api-explorer/v5/trade/amend-order","title":"Amend Order","description":"Amend an order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-amend":{"id":"api-explorer/v5/trade/batch-amend","title":"Batch Amend Order","description":"Batch amend orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-cancel":{"id":"api-explorer/v5/trade/batch-cancel","title":"Batch Cancel Order","description":"Batch cancel orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-place":{"id":"api-explorer/v5/trade/batch-place","title":"Batch Place Order","description":"Batch place orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/cancel-all":{"id":"api-explorer/v5/trade/cancel-all","title":"Cancel All Orders","description":"Cancel all orders.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/cancel-order":{"id":"api-explorer/v5/trade/cancel-order","title":"Cancel Order","description":"Cancel a single order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/create-order":{"id":"api-explorer/v5/trade/create-order","title":"Place Order","description":"Place an order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/open-order":{"id":"api-explorer/v5/trade/open-order","title":"Get Open Orders (real-time)","description":"Get unfilled orders or partially filled orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/order-list":{"id":"api-explorer/v5/trade/order-list","title":"Get Order History (2 years)","description":"Get order history.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/query-spot-quota":{"id":"api-explorer/v5/trade/query-spot-quota","title":"Get Borrow Quota (Spot)","description":"Query user\'s spot available quota","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/trade":{"id":"api-explorer/v5/trade/trade","title":"Trade","description":"Trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/affiliate-info":{"id":"api-explorer/v5/user/affiliate-info","title":"Get Affiliate User Info","description":"Get affiliate user info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/apikey-info":{"id":"api-explorer/v5/user/apikey-info","title":"Get API Key Information","description":"Get API Key Information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/list-sub-apikeys":{"id":"api-explorer/v5/user/list-sub-apikeys","title":"Get Sub Account All API Keys","description":"Get Sub Account All API Keys","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/user":{"id":"api-explorer/v5/user/user","title":"User","description":"User","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/wallet-type":{"id":"api-explorer/v5/user/wallet-type","title":"Get UID Wallet Type","description":"Get uid wallet type","sidebar":"apiExplorerSideBar"},"changelog/asset-v3":{"id":"changelog/asset-v3","title":"Account Asset V3","description":"2024-05-09","sidebar":"changelogSidebar"},"changelog/copytrade":{"id":"changelog/copytrade","title":"Copy Trading","description":"2023-06-24","sidebar":"changelogSidebar"},"changelog/derivatives-v3":{"id":"changelog/derivatives-v3","title":"Derivatives V3","description":"2024-05-09","sidebar":"changelogSidebar"},"changelog/spot-v3":{"id":"changelog/spot-v3","title":"Spot V3","description":"2023-04-20","sidebar":"changelogSidebar"},"changelog/v5":{"id":"changelog/v5","title":"V5","description":"2024-08-13","sidebar":"changelogSidebar"},"faq":{"id":"faq","title":"Frequently Asked Questions","description":"Where are Bybit\'s servers located?"},"pilot-feature/pilot":{"id":"pilot-feature/pilot","title":"Pilot Features","description":"Open API Supports Demo Trading"},"v3/account-asset/enum":{"id":"v3/account-asset/enum","title":"Enums Definitions","description":"accountType","sidebar":"v3SideBar"},"v3/account-asset/error":{"id":"v3/account-asset/error","title":"Error Code","description":"|Code |Description |","sidebar":"v3SideBar"},"v3/account-asset/rate-limit":{"id":"v3/account-asset/rate-limit","title":"Rate Limit","description":"IP Rate Limit","sidebar":"v3SideBar"},"v3/account-asset/transfer/all-balance":{"id":"v3/account-asset/transfer/all-balance","title":"Get All Coins Balance","description":"You could get all coins balance of all account types under the master account, and sub account.","sidebar":"v3SideBar"},"v3/account-asset/transfer/asset-info":{"id":"v3/account-asset/transfer/asset-info","title":"Get Asset Info","description":"Can query SPOT asset information only","sidebar":"v3SideBar"},"v3/account-asset/transfer/coin-balance":{"id":"v3/account-asset/transfer/coin-balance","title":"Get Single Coin Balance","description":"You could get a single coin balance under the master account, and sub account coin balance.","sidebar":"v3SideBar"},"v3/account-asset/transfer/enable-uni-transfer":{"id":"v3/account-asset/transfer/enable-uni-transfer","title":"Enable Universal Transfer (Depreciated)","description":"Enable Universal Transfer","sidebar":"v3SideBar"},"v3/account-asset/transfer/internal-transfer":{"id":"v3/account-asset/transfer/internal-transfer","title":"Create Internal Transfer","description":"Transfers funds between the different sections of an individual\'s account (not between subaccounts). For example, between the spot and derivatives accounts.","sidebar":"v3SideBar"},"v3/account-asset/transfer/internal-transfer-list":{"id":"v3/account-asset/transfer/internal-transfer-list","title":"Get Internal Transfer List","description":"Query Internal Transfer List","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-list":{"id":"v3/account-asset/transfer/subacct-list","title":"Get Subaccount UID List","description":"Query Subaccount List","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-transfer":{"id":"v3/account-asset/transfer/subacct-transfer","title":"Create Subaccount Transfer","description":"Transfer funds between the parent and child (sub) accounts.","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-transfer-list":{"id":"v3/account-asset/transfer/subacct-transfer-list","title":"Get Master-Sub Transfer List","description":"Query subaccount transfer list","sidebar":"v3SideBar"},"v3/account-asset/transfer/transferable-coin-list":{"id":"v3/account-asset/transfer/transferable-coin-list","title":"Get Transferable Coin List","description":"Transferable coin list","sidebar":"v3SideBar"},"v3/account-asset/transfer/uni-transfer":{"id":"v3/account-asset/transfer/uni-transfer","title":"Create Universal Transfer","description":"Create Universal Transfer","sidebar":"v3SideBar"},"v3/account-asset/transfer/uni-transfer-list":{"id":"v3/account-asset/transfer/uni-transfer-list","title":"Get Universal Transfer List","description":"Query Universal Transfer List","sidebar":"v3SideBar"},"v3/account-asset/user/apikey-info":{"id":"v3/account-asset/user/apikey-info","title":"Get API Key Information","description":"Get the information of the api key. Use the api key pending to be checked to call the endpoint. Both master and sub user\'s api key are applicable.","sidebar":"v3SideBar"},"v3/account-asset/user/create-subuid":{"id":"v3/account-asset/user/create-subuid","title":"Create Sub UID","description":"Create a new sub user id. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/create-subuid-apikey":{"id":"v3/account-asset/user/create-subuid-apikey","title":"Create Sub UID API Key","description":"To create new API key for those newly created sub UID. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/froze-subuid":{"id":"v3/account-asset/user/froze-subuid","title":"Froze Sub UID","description":"Froze sub uid. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/modify-master-apikey":{"id":"v3/account-asset/user/modify-master-apikey","title":"Modify Master API Key","description":"Modify the settings of master api key. Use the api key pending to be modified to call the endpoint. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/modify-sub-apikey":{"id":"v3/account-asset/user/modify-sub-apikey","title":"Modify Sub API Key","description":"Modify the settings of sub api key. Use the sub account api key pending to be modified to call the endpoint or use master","sidebar":"v3SideBar"},"v3/account-asset/user/rm-master-apikey":{"id":"v3/account-asset/user/rm-master-apikey","title":"Delete Master API Key","description":"Delete the api key of master account. Use the api key pending to be delete to call the endpoint. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/rm-sub-apikey":{"id":"v3/account-asset/user/rm-sub-apikey","title":"Delete Sub API Key","description":"Delete the api key of sub account. Use the sub api key pending to be delete to call the endpoint or use the master api key","sidebar":"v3SideBar"},"v3/account-asset/user/subuid-list":{"id":"v3/account-asset/user/subuid-list","title":"Get Sub UID List","description":"Get all sub uid of master account. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/wallet-type":{"id":"v3/account-asset/user/wallet-type","title":"Get UID Wallet Type","description":"Get available wallet types for the master account or sub account","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/cancel-withdraw":{"id":"v3/account-asset/withdraw-deposit/cancel-withdraw","title":"Cancel withdrawal","description":"Cancel withdrawal","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/coin-info":{"id":"v3/account-asset/withdraw-deposit/coin-info","title":"Get Coin Information","description":"Query Coin Information","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/deplay-amount":{"id":"v3/account-asset/withdraw-deposit/deplay-amount","title":"Get Delay Withdraw Amount","description":"How can partial funds be subject to delayed withdrawal requests?","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/deposit-spec":{"id":"v3/account-asset/withdraw-deposit/deposit-spec","title":"Get Deposit Spec","description":"Query deposit spec.","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/internal-deposit-record":{"id":"v3/account-asset/withdraw-deposit/internal-deposit-record","title":"Get Internal Deposit Records (across Bybit)","description":"Query deposit records through Bybit platform","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/master-deposit-addr":{"id":"v3/account-asset/withdraw-deposit/master-deposit-addr","title":"Get Master Acct Deposit Address Info","description":"Query Master Acct Deposit Address Information","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/master-deposit-record":{"id":"v3/account-asset/withdraw-deposit/master-deposit-record","title":"Get Deposit Records (on chain)","description":"Query Deposit Records","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/set-deposit-acct":{"id":"v3/account-asset/withdraw-deposit/set-deposit-acct","title":"Set Deposit Account","description":"Set auto transfer account after deposit. The same function as the setting for Deposit on web GUI.","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/sub-deposit-addr":{"id":"v3/account-asset/withdraw-deposit/sub-deposit-addr","title":"Get Sub Acct Deposit Address Info","description":"Query Sub Acct Deposit Address Information","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/sub-deposit-record":{"id":"v3/account-asset/withdraw-deposit/sub-deposit-record","title":"Get Sub Deposit Records (on chain)","description":"Query Sub Deposit Records By Master Key","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/vasp-list":{"id":"v3/account-asset/withdraw-deposit/vasp-list","title":"Get Exchange Entity List","description":"This endpoint is particularly used for kyc=KOR users. When withdraw funds, you need to fill entity id.","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/withdraw":{"id":"v3/account-asset/withdraw-deposit/withdraw","title":"Withdraw","description":"Withdraw assets from your Bybit account. You can make an off-chain transfer if the target wallet address is from Bybit. This means that no blockchain fee will be charged.","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/withdraw-record":{"id":"v3/account-asset/withdraw-deposit/withdraw-record","title":"Get Withdraw Records","description":"Query Withdraw Records","sidebar":"v3SideBar"},"v3/copy-trade/enum":{"id":"v3/copy-trade/enum","title":"Enums Definitions","description":"accountType"},"v3/copy-trade/error":{"id":"v3/copy-trade/error","title":"Error Code","description":"|Code |Description |"},"v3/copy-trade/rate-limit":{"id":"v3/copy-trade/rate-limit","title":"Rate Limit","description":"IP Rate Limit"},"v3/copy-trade/rest-public/symbol-info":{"id":"v3/copy-trade/rest-public/symbol-info","title":"Instrument Info","description":"Get the spec of trading symbols"},"v3/copy-trade/rest-trade/account/transfer":{"id":"v3/copy-trade/rest-trade/account/transfer","title":"Transfer","description":"Transfer"},"v3/copy-trade/rest-trade/account/transfer-list":{"id":"v3/copy-trade/rest-trade/account/transfer-list","title":"Get Transfer History","description":"Get the transfer history of Copy-trade wallet"},"v3/copy-trade/rest-trade/account/wallet":{"id":"v3/copy-trade/rest-trade/account/wallet","title":"Get Wallet Balance","description":"Get CopyTrading Wallet Balance"},"v3/copy-trade/rest-trade/order/cancel-order":{"id":"v3/copy-trade/rest-trade/order/cancel-order","title":"Cancel Order","description":"Cancel Order"},"v3/copy-trade/rest-trade/order/close-order":{"id":"v3/copy-trade/rest-trade/order/close-order","title":"Create Close Position Order","description":"Create a specific close order"},"v3/copy-trade/rest-trade/order/order-list":{"id":"v3/copy-trade/rest-trade/order/order-list","title":"Get Orders","description":"Query orders"},"v3/copy-trade/rest-trade/order/place-order":{"id":"v3/copy-trade/rest-trade/order/place-order","title":"Create Order","description":"Create Order"},"v3/copy-trade/rest-trade/order/set-trading-stop":{"id":"v3/copy-trade/rest-trade/order/set-trading-stop","title":"Set Trading Stop","description":"Set Trading Stop"},"v3/copy-trade/rest-trade/position/close-position":{"id":"v3/copy-trade/rest-trade/position/close-position","title":"Close All Positions","description":"Close Position"},"v3/copy-trade/rest-trade/position/execution":{"id":"v3/copy-trade/rest-trade/position/execution","title":"Get Execution List (2 years)","description":"Query users\' execution list, sort by execTime in descending order"},"v3/copy-trade/rest-trade/position/position-info":{"id":"v3/copy-trade/rest-trade/position/position-info","title":"Position List","description":"Position List"},"v3/copy-trade/rest-trade/position/set-leverage":{"id":"v3/copy-trade/rest-trade/position/set-leverage","title":"Set Leverage","description":"Set Leverage"},"v3/copy-trade/wss-authentication":{"id":"v3/copy-trade/wss-authentication","title":"Connect","description":"Note that currently Copy Trading only supports USDT perpetual and the following endpoints only apply to USDT Perpetual"},"v3/copy-trade/wss-private/execution":{"id":"v3/copy-trade/wss-private/execution","title":"Execution","description":"Topic:"},"v3/copy-trade/wss-private/order":{"id":"v3/copy-trade/wss-private/order","title":"Order","description":"Topic:"},"v3/copy-trade/wss-private/position":{"id":"v3/copy-trade/wss-private/position","title":"Position","description":"Topic:"},"v3/copy-trade/wss-private/wallet":{"id":"v3/copy-trade/wss-private/wallet","title":"Wallet","description":"Topic:"},"v3/copy-trade/wss-public/kline":{"id":"v3/copy-trade/wss-public/kline","title":"Kline","description":"Interval supported:"},"v3/copy-trade/wss-public/liquidation":{"id":"v3/copy-trade/wss-public/liquidation","title":"Liquidation","description":"Get recent liquidation orders in Bybit."},"v3/copy-trade/wss-public/orderbook":{"id":"v3/copy-trade/wss-public/orderbook","title":"Orderbook","description":"Get different depth"},"v3/copy-trade/wss-public/tickers":{"id":"v3/copy-trade/wss-public/tickers","title":"Tickers","description":"Get latest information of the symbol"},"v3/copy-trade/wss-public/trade":{"id":"v3/copy-trade/wss-public/trade","title":"Public Trade","description":"Get recent public trades data in Bybit."},"v3/derivatives/enum":{"id":"v3/derivatives/enum","title":"Enums Definitions","description":"category","sidebar":"v3SideBar"},"v3/derivatives/error":{"id":"v3/derivatives/error","title":"Error Code","description":"Unified Margin","sidebar":"v3SideBar"},"v3/derivatives/rate-limit":{"id":"v3/derivatives/rate-limit","title":"Rate Limit","description":"IP Rate Limit","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/trading-fee":{"id":"v3/derivatives/rest-contract/account/trading-fee","title":"Get Trading Fee Rate","description":"Get user trading fee rate.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/wallet-balance":{"id":"v3/derivatives/rest-contract/account/wallet-balance","title":"Wallet Balance","description":"Get wallet balance, including Derivatives account and USDC account.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/wallet-fund-record":{"id":"v3/derivatives/rest-contract/account/wallet-fund-record","title":"Get Wallet Fund Records","description":"Get wallet fund records. This endpoint also shows exchanges from the Asset Exchange, where the types for the exchange are ExchangeOrderWithdraw and ExchangeOrderDeposit.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/cancel-all":{"id":"v3/derivatives/rest-contract/order/cancel-all","title":"Cancel All Order","description":"This endpoint enables to cancel all open orders.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/cancel-order":{"id":"v3/derivatives/rest-contract/order/cancel-order","title":"Cancel Order","description":"You could cancel those unfilled or partially filled orders.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/open-order":{"id":"v3/derivatives/rest-contract/order/open-order","title":"Get Open Orders","description":"Query unfilled or partially filled orders in real-time.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/order-list":{"id":"v3/derivatives/rest-contract/order/order-list","title":"Get Order List","description":"Query order list.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/place-order":{"id":"v3/derivatives/rest-contract/order/place-order","title":"Place Order","description":"- Market order: A traditional market order, which will be filled at the current optimal price. Only when the market","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/replace-order":{"id":"v3/derivatives/rest-contract/order/replace-order","title":"Replace Order","description":"You could modify those unfilled or partially filled orders.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/auto-margin":{"id":"v3/derivatives/rest-contract/position/auto-margin","title":"Set Auto Add Margin","description":"Turn on/off auto add position margin. To understand more, please read here","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/close-pnl":{"id":"v3/derivatives/rest-contract/position/close-pnl","title":"Get Closed PnL","description":"Query user\'s closed profit and loss records. The results are sorted by updatedTime in descending order.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/confirm-mmr":{"id":"v3/derivatives/rest-contract/position/confirm-mmr","title":"Confirm New Risk Limit","description":"It is only applicable when the user is marked as only reducing positions (please see the isReduceOnly field in","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/cross-isolated-margin":{"id":"v3/derivatives/rest-contract/position/cross-isolated-margin","title":"Switch Cross/Isolated Margin","description":"Switch cross margin mode / isolated margin mode. To understand more, please read here","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/execution":{"id":"v3/derivatives/rest-contract/position/execution","title":"Get Execution List","description":"Query users\' execution list, sort by execTime in descending order. Support USDT Perpetual, Inverse Perpetual, Inverse Future, USDC Perpetual and USDC Option.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/leverage":{"id":"v3/derivatives/rest-contract/position/leverage","title":"Set Leverage","description":"Set the leverage.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/position-info":{"id":"v3/derivatives/rest-contract/position/position-info","title":"My Position","description":"Get real-time position data","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/position-mode":{"id":"v3/derivatives/rest-contract/position/position-mode","title":"Switch Position Mode","description":"It supports to switch the position mode for USDT perpetual and Inverse futures. If you are in one-way Mode, you can only open one position on Buy or Sell side. If you are in hedge mode, you can open both Buy and Sell side positions simultaneously.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/set-risk-limit":{"id":"v3/derivatives/rest-contract/position/set-risk-limit","title":"Set Risk Limit","description":"Since bybit has launched auto risk limit on 12 March 2024, please click here to learn more, so it will not take effect even you set it successfully.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/tpsl-mode":{"id":"v3/derivatives/rest-contract/position/tpsl-mode","title":"Switch TP/SL Mode","description":"_To some extent, this endpoint is depreciated because now tpsl is based on order level. This API was used for position level","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/trading-stop":{"id":"v3/derivatives/rest-contract/position/trading-stop","title":"Set Trading Stop","description":"Set the take profit, stop loss or trailing stop for the position.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/delivery-price":{"id":"v3/derivatives/rest-public/delivery-price","title":"Option Delivery Price","description":"Get the delivery price for option","sidebar":"v3SideBar"},"v3/derivatives/rest-public/fund-rate-history":{"id":"v3/derivatives/rest-public/fund-rate-history","title":"Funding Rate History","description":"Get historical funding rate","sidebar":"v3SideBar"},"v3/derivatives/rest-public/index-kline":{"id":"v3/derivatives/rest-public/index-kline","title":"Index Price Kline","description":"Get index price kline data","sidebar":"v3SideBar"},"v3/derivatives/rest-public/instrument-info":{"id":"v3/derivatives/rest-public/instrument-info","title":"Instrument Info","description":"Get launched instruments information.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/kline":{"id":"v3/derivatives/rest-public/kline","title":"Kline","description":"Get kline data","sidebar":"v3SideBar"},"v3/derivatives/rest-public/long-short-ratio":{"id":"v3/derivatives/rest-public/long-short-ratio","title":"Get Long Short Ratio","description":"HTTP Request","sidebar":"v3SideBar"},"v3/derivatives/rest-public/mark-kline":{"id":"v3/derivatives/rest-public/mark-kline","title":"Mark Price Kline","description":"Get mark price kline data","sidebar":"v3SideBar"},"v3/derivatives/rest-public/open-interest":{"id":"v3/derivatives/rest-public/open-interest","title":"Open Interest","description":"Get open interest of each symbol in Bybit","sidebar":"v3SideBar"},"v3/derivatives/rest-public/orderbook":{"id":"v3/derivatives/rest-public/orderbook","title":"Order Book","description":"Get order book data.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/premium-index-kline":{"id":"v3/derivatives/rest-public/premium-index-kline","title":"Premium Index Price Kline","description":"Get premium index price kline data","sidebar":"v3SideBar"},"v3/derivatives/rest-public/public-trade":{"id":"v3/derivatives/rest-public/public-trade","title":"Public Trading History","description":"Get recent public trading records in Bybit. You could download archived USDT contract trade records here.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/risk-limit":{"id":"v3/derivatives/rest-public/risk-limit","title":"Risk Limit","description":"Get risk limit","sidebar":"v3SideBar"},"v3/derivatives/rest-public/ticker-info":{"id":"v3/derivatives/rest-public/ticker-info","title":"Ticker Info","description":"Get all latest information of symbols.","sidebar":"v3SideBar"},"v3/derivatives/rest-unified/account/account-info":{"id":"v3/derivatives/rest-unified/account/account-info","title":"Account Info","description":"Query the configuration under the account."},"v3/derivatives/rest-unified/account/borrow-history":{"id":"v3/derivatives/rest-unified/account/borrow-history","title":"Borrow History","description":"HTTP Request"},"v3/derivatives/rest-unified/account/borrow-rate":{"id":"v3/derivatives/rest-unified/account/borrow-rate","title":"Get Borrow Rate","description":"HTTP Request"},"v3/derivatives/rest-unified/account/dcp":{"id":"v3/derivatives/rest-unified/account/dcp","title":"Set Disconnect Cancel All","description":"What is Disconnection Protect (DCP)?"},"v3/derivatives/rest-unified/account/exchange":{"id":"v3/derivatives/rest-unified/account/exchange","title":"Get Exchange Records","description":"Query the coin exchange records."},"v3/derivatives/rest-unified/account/get-dcp":{"id":"v3/derivatives/rest-unified/account/get-dcp","title":"Get DCP Info","description":"HTTP Request"},"v3/derivatives/rest-unified/account/get-mmp-state":{"id":"v3/derivatives/rest-unified/account/get-mmp-state","title":"Get MMP State","description":"HTTP Request"},"v3/derivatives/rest-unified/account/reset-mmp":{"id":"v3/derivatives/rest-unified/account/reset-mmp","title":"Reset MMP","description":"Once the mmp triggered, you can unfreeze the account by this endpoint"},"v3/derivatives/rest-unified/account/set-margin-mode":{"id":"v3/derivatives/rest-unified/account/set-margin-mode","title":"Set Margin Mode","description":"Default is the regular margin mode. This mode is valid for USDT Perp, USDC Perp and Option."},"v3/derivatives/rest-unified/account/set-mmp":{"id":"v3/derivatives/rest-unified/account/set-mmp","title":"Set MMP","description":"What is MMP?"},"v3/derivatives/rest-unified/account/transaction-log":{"id":"v3/derivatives/rest-unified/account/transaction-log","title":"Transaction Log","description":"Query transaction logs in Unified account."},"v3/derivatives/rest-unified/account/upgrade-unified-account":{"id":"v3/derivatives/rest-unified/account/upgrade-unified-account","title":"Upgrade To Unified Margin Account","description":"Upgrade to unified margin account (UMA)"},"v3/derivatives/rest-unified/account/wallet-balance":{"id":"v3/derivatives/rest-unified/account/wallet-balance","title":"Wallet Balance","description":"Get wallet balance"},"v3/derivatives/rest-unified/order/batch-cancel":{"id":"v3/derivatives/rest-unified/order/batch-cancel","title":"Batch Cancel Order","description":"This endpoint provides the batch order mode to cancel a bunch of open orders."},"v3/derivatives/rest-unified/order/batch-place":{"id":"v3/derivatives/rest-unified/order/batch-place","title":"Batch Place Order","description":"This endpoint provides the batch order mode to place a bunch of orders."},"v3/derivatives/rest-unified/order/batch-replace":{"id":"v3/derivatives/rest-unified/order/batch-replace","title":"Batch Replace Order","description":"This endpoint provides the batch order mode to replace a bunch of open orders."},"v3/derivatives/rest-unified/order/cancel-all":{"id":"v3/derivatives/rest-unified/order/cancel-all","title":"Cancel All Orders","description":"This endpoint enables to cancel all open orders."},"v3/derivatives/rest-unified/order/cancel-order":{"id":"v3/derivatives/rest-unified/order/cancel-order","title":"Cancel Order","description":"You could cancel those unfilled or partially filled orders."},"v3/derivatives/rest-unified/order/open-order":{"id":"v3/derivatives/rest-unified/order/open-order","title":"Get Open Orders","description":"Query unfilled or partially filled orders in real-time."},"v3/derivatives/rest-unified/order/order-list":{"id":"v3/derivatives/rest-unified/order/order-list","title":"Get Order List","description":"Query order list."},"v3/derivatives/rest-unified/order/place-order":{"id":"v3/derivatives/rest-unified/order/place-order","title":"Place Order","description":"- Market order: A traditional market order, which will be filled at the current optimal price. Only when the market"},"v3/derivatives/rest-unified/order/replace-order":{"id":"v3/derivatives/rest-unified/order/replace-order","title":"Replace Order","description":"You could modify those unfilled or partially filled orders."},"v3/derivatives/rest-unified/position/execution-list":{"id":"v3/derivatives/rest-unified/position/execution-list","title":"Get Execution Record","description":"Query users\' execution records, sort by execTime in descending order"},"v3/derivatives/rest-unified/position/full-partial-tpsl":{"id":"v3/derivatives/rest-unified/position/full-partial-tpsl","title":"Switch TP/SL Mode","description":"Set take profit / stop loss mode of the position, such as FULL TP/SL mode or PARTIAL TP/SL mode"},"v3/derivatives/rest-unified/position/leverage":{"id":"v3/derivatives/rest-unified/position/leverage","title":"Set Leverage","description":"Set the leverage."},"v3/derivatives/rest-unified/position/option-delivery":{"id":"v3/derivatives/rest-unified/position/option-delivery","title":"Get Option Delivery Record","description":"Query option delivery records, sort by deliveryTime in descending order"},"v3/derivatives/rest-unified/position/position-info":{"id":"v3/derivatives/rest-unified/position/position-info","title":"My Position","description":"Get real-time position data"},"v3/derivatives/rest-unified/position/set-risk-limit":{"id":"v3/derivatives/rest-unified/position/set-risk-limit","title":"Set Risk Limit","description":"The risk limit will limit the maximum position value you can hold under different margin requirements."},"v3/derivatives/rest-unified/position/trading-stop":{"id":"v3/derivatives/rest-unified/position/trading-stop","title":"Set Trading Stop","description":"Pass the following parameters, then the system will create conditional orders. If the position is closed, the system will cancel these orders, and adjust the position size."},"v3/derivatives/rest-unified/position/usdc-settlement":{"id":"v3/derivatives/rest-unified/position/usdc-settlement","title":"Get USDC Perpetual Settlement","description":"Query session settlement records of USDC perpetual"},"v3/derivatives/wss-authentication":{"id":"v3/derivatives/wss-authentication","title":"Connect","description":"Base endpoints:","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/execution":{"id":"v3/derivatives/wss-contract/execution","title":"Execution","description":"Subscribe to the execution stream to see when an open order gets filled or partially filled.","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/order":{"id":"v3/derivatives/wss-contract/order","title":"Order","description":"Subscribe to the order stream to see new orders, when an order\'s order status changes, etc.","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/position":{"id":"v3/derivatives/wss-contract/position","title":"Position","description":"Subscribe to the position stream to see changes to your position size, position setting changes, etc.","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/wallet":{"id":"v3/derivatives/wss-contract/wallet","title":"Wallet","description":"Subscribe to the wallet stream to see changes to your wallet in real-time.","sidebar":"v3SideBar"},"v3/derivatives/wss-public/kline":{"id":"v3/derivatives/wss-public/kline","title":"Kline","description":"Covers: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future","sidebar":"v3SideBar"},"v3/derivatives/wss-public/liquidation":{"id":"v3/derivatives/wss-public/liquidation","title":"Liquidation","description":"Get recent liquidation orders in Bybit, at most one order is published per second per symbol","sidebar":"v3SideBar"},"v3/derivatives/wss-public/orderbook":{"id":"v3/derivatives/wss-public/orderbook","title":"Orderbook","description":"Get different depth","sidebar":"v3SideBar"},"v3/derivatives/wss-public/tickers":{"id":"v3/derivatives/wss-public/tickers","title":"Tickers","description":"Cover: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future, Option","sidebar":"v3SideBar"},"v3/derivatives/wss-public/trade":{"id":"v3/derivatives/wss-public/trade","title":"Public Trade","description":"Get recent public trades data in Bybit.","sidebar":"v3SideBar"},"v3/derivatives/wss-unified/execution":{"id":"v3/derivatives/wss-unified/execution","title":"Execution","description":"Subscribe to the execution stream. Will not push funding payments unless they occur on a USDT perpetual, eg BTCUSDT."},"v3/derivatives/wss-unified/greek":{"id":"v3/derivatives/wss-unified/greek","title":"Greek","description":"Subscribe to the user greeks stream, option only."},"v3/derivatives/wss-unified/order":{"id":"v3/derivatives/wss-unified/order","title":"Order","description":"Subscribe to the order stream to see new orders, when an order\'s order status changes, etc."},"v3/derivatives/wss-unified/position":{"id":"v3/derivatives/wss-unified/position","title":"Position","description":"Subscribe to the position stream to see changes to your position size, position setting changes, etc."},"v3/derivatives/wss-unified/wallet":{"id":"v3/derivatives/wss-unified/wallet","title":"Wallet","description":"Subscribe to the wallet stream to see changes to your wallet in real-time."},"v3/intro":{"id":"v3/intro","title":"Introduction","description":"Bybit V3 API allow users to select different collections to build their API model.","sidebar":"v3SideBar"},"v3/server-time":{"id":"v3/server-time","title":"Bybit Server Time","description":"Get the Bybit server timestamp","sidebar":"v3SideBar"},"v3/smp":{"id":"v3/smp","title":"Self Match Prevention","description":"What is SMP?","sidebar":"v3SideBar"},"v3/spot/enum":{"id":"v3/spot/enum","title":"Enums Definitions","description":"side","sidebar":"v3SideBar"},"v3/spot/error":{"id":"v3/spot/error","title":"Error Code","description":"|Code |Description |","sidebar":"v3SideBar"},"v3/spot/rate-limit":{"id":"v3/spot/rate-limit","title":"Rate Limit","description":"IP Rate Limit","sidebar":"v3SideBar"},"v3/spot/rest-etp/asset-info":{"id":"v3/spot/rest-etp/asset-info","title":"All Asset Info","description":"It is a public endpoint, and no need to authenticate.","sidebar":"v3SideBar"},"v3/spot/rest-etp/market-info":{"id":"v3/spot/rest-etp/market-info","title":"Market Info","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-etp/purchase":{"id":"v3/spot/rest-etp/purchase","title":"Purchase","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-etp/purchase-redeem-history":{"id":"v3/spot/rest-etp/purchase-redeem-history","title":"Purchase & Redeem History","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-etp/redeem":{"id":"v3/spot/rest-etp/redeem","title":"Redeem","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/loan-info":{"id":"v3/spot/rest-institution-loan/loan-info","title":"Get Loan Info","description":"Get loan orders information","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/ltv":{"id":"v3/spot/rest-institution-loan/ltv","title":"Get LTV","description":"Get LTV. Please head here to get LTV if this API returns empty data.","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/margin-coin-info":{"id":"v3/spot/rest-institution-loan/margin-coin-info","title":"Margin Coin Info","description":"This is a public endpoint, so it does not need to authenticate.","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/margin-product-info":{"id":"v3/spot/rest-institution-loan/margin-product-info","title":"Get Margin Product Info","description":"This is a public endpoint, so it does not need to authenticate.","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/repay-info":{"id":"v3/spot/rest-institution-loan/repay-info","title":"Get Repay Info","description":"Get repaid order information. Authentication needed.","sidebar":"v3SideBar"},"v3/spot/rest-public/best-bid-ask":{"id":"v3/spot/rest-public/best-bid-ask","title":"Best Bid/Ask Price","description":"If symbol is not specified, the best order price from all symbols will be returned","sidebar":"v3SideBar"},"v3/spot/rest-public/instrument-info":{"id":"v3/spot/rest-public/instrument-info","title":"Instrument Info","description":"Get the spec of symbol information","sidebar":"v3SideBar"},"v3/spot/rest-public/kline":{"id":"v3/spot/rest-public/kline","title":"Kline","description":"It only returns the results from latest 1000 candles regardless of what interval is specified","sidebar":"v3SideBar"},"v3/spot/rest-public/last-trade-price":{"id":"v3/spot/rest-public/last-trade-price","title":"Last Traded Price","description":"If symbol is not specified, the price from all symbols will be returned","sidebar":"v3SideBar"},"v3/spot/rest-public/merge-orderbook":{"id":"v3/spot/rest-public/merge-orderbook","title":"Merged Order Book","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-public/orderbook":{"id":"v3/spot/rest-public/orderbook","title":"Order Book","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-public/public-trade":{"id":"v3/spot/rest-public/public-trade","title":"Public Trading Records","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-public/ticker-info":{"id":"v3/spot/rest-public/ticker-info","title":"Tickers","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/account-info":{"id":"v3/spot/rest-spot-margin/account-info","title":"Get Loan Account Info","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrow":{"id":"v3/spot/rest-spot-margin/borrow","title":"Borrow","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrow-info":{"id":"v3/spot/rest-spot-margin/borrow-info","title":"Get Borrow Order Detail","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrowable-data":{"id":"v3/spot/rest-spot-margin/borrowable-data","title":"Get Borrowable Coin Info","description":"This is public endpoint, so do not need an authentication","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/interest-quota":{"id":"v3/spot/rest-spot-margin/interest-quota","title":"Get Interest & Quota","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/margin-data":{"id":"v3/spot/rest-spot-margin/margin-data","title":"Get Margin Coin Info","description":"This is public endpoint, so do not need an authentication","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/repay":{"id":"v3/spot/rest-spot-margin/repay","title":"Repay","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/repay-history":{"id":"v3/spot/rest-spot-margin/repay-history","title":"Get Repayment Order Detail","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/switch-mode":{"id":"v3/spot/rest-spot-margin/switch-mode","title":"Toggle Margin Trade","description":"Turn on / off spot margin trade","sidebar":"v3SideBar"},"v3/spot/rest-spot/batch-cancel":{"id":"v3/spot/rest-spot/batch-cancel","title":"Batch Cancel Order","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/batch-cancel-by-id":{"id":"v3/spot/rest-spot/batch-cancel-by-id","title":"Batch Cancel Order By Id","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/cancel-order":{"id":"v3/spot/rest-spot/cancel-order","title":"Cancel Order","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/get-order":{"id":"v3/spot/rest-spot/get-order","title":"Get Order","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/open-order":{"id":"v3/spot/rest-spot/open-order","title":"Open Orders","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/order-history":{"id":"v3/spot/rest-spot/order-history","title":"Order History","description":"- If startTime and endTime are both not specified, it returns last 7 days records by default.","sidebar":"v3SideBar"},"v3/spot/rest-spot/place-order":{"id":"v3/spot/rest-spot/place-order","title":"Place Order","description":"Do not use the duplicate orderLinkId in normal order & TP/SL order","sidebar":"v3SideBar"},"v3/spot/rest-spot/trade-history":{"id":"v3/spot/rest-spot/trade-history","title":"Trade History","description":"* If startTime is not specified, you can only query for records in the last 7 days.","sidebar":"v3SideBar"},"v3/spot/wallet":{"id":"v3/spot/wallet","title":"Get Wallet Balance","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/wss-authentication":{"id":"v3/spot/wss-authentication","title":"Connect","description":"Note that the following endpoints only apply to Spot. To listen to other websockets, go to:","sidebar":"v3SideBar"},"v3/spot/wss-private/order":{"id":"v3/spot/wss-private/order","title":"Order","description":"This topic pushes order information\uff0cavg.filledPrice = Z / z","sidebar":"v3SideBar"},"v3/spot/wss-private/outbound-account-info":{"id":"v3/spot/wss-private/outbound-account-info","title":"Wallet","description":"This topic pushes spot wallet information","sidebar":"v3SideBar"},"v3/spot/wss-private/stop-order":{"id":"v3/spot/wss-private/stop-order","title":"Stop Order","description":"This topic pushes conditional order, TP/SL order information placed by web/app channel, and TP/SL order information placed by open api channel. It\'ll be triggered as long as order status is changed","sidebar":"v3SideBar"},"v3/spot/wss-private/ticket-info":{"id":"v3/spot/wss-private/ticket-info","title":"Execution","description":"This topic pushes filled trades information. When an order is filled, you will receive two messages: one from ticketInfo, and one from order / stopOrder","sidebar":"v3SideBar"},"v3/spot/wss-public/bookticker":{"id":"v3/spot/wss-public/bookticker","title":"Bookticker","description":"Best bid price and best ask price","sidebar":"v3SideBar"},"v3/spot/wss-public/kline":{"id":"v3/spot/wss-public/kline","title":"Kline","description":"Subscribe the kline stream. Please find desired kline interval here.","sidebar":"v3SideBar"},"v3/spot/wss-public/orderbook":{"id":"v3/spot/wss-public/orderbook","title":"Orderbook","description":"Market depth data for a trading pair:","sidebar":"v3SideBar"},"v3/spot/wss-public/tickers":{"id":"v3/spot/wss-public/tickers","title":"Tickers","description":"The 24-hr statistics of a trading pair.","sidebar":"v3SideBar"},"v3/spot/wss-public/trade":{"id":"v3/spot/wss-public/trade","title":"Public trade","description":"This topic pushes raw trade information; each trade has a unique buyer and seller.","sidebar":"v3SideBar"},"v3/tax/data-explain":{"id":"v3/tax/data-explain","title":"Data Explanation","description":"Trade History","sidebar":"v3SideBar"},"v3/tax/data-export":{"id":"v3/tax/data-export","title":"Retrieve Data Export","description":"Retrieve data export","sidebar":"v3SideBar"},"v3/tax/enum":{"id":"v3/tax/enum","title":"Enums Definitions","description":"ReportType","sidebar":"v3SideBar"},"v3/tax/register-time":{"id":"v3/tax/register-time","title":"Get User Register Date","description":"Get User Register Date","sidebar":"v3SideBar"},"v3/tax/report-status":{"id":"v3/tax/report-status","title":"Get Export Report Status","description":"Get Export Report Status","sidebar":"v3SideBar"},"v3/tax/request-report":{"id":"v3/tax/request-report","title":"Request Export Report","description":"Request to export report","sidebar":"v3SideBar"},"v5/abandon/account-info":{"id":"v5/abandon/account-info","title":"Get Lending Account Info","description":"HTTP Request","sidebar":"v5SideBar"},"v5/abandon/cancel-redeem":{"id":"v5/abandon/cancel-redeem","title":"Cancel Redeem","description":"Cancel the withdrawal operation.","sidebar":"v5SideBar"},"v5/abandon/coin-info":{"id":"v5/abandon/coin-info","title":"Get Lending Coin Info","description":"Get the basic information of lending coins","sidebar":"v5SideBar"},"v5/abandon/deposit":{"id":"v5/abandon/deposit","title":"Deposit Funds","description":"Lending funds to Bybit asset pool","sidebar":"v5SideBar"},"v5/abandon/earning":{"id":"v5/abandon/earning","title":"Get Broker Earning","description":"This endpoint has been depreciated, please move to new Get Exchange Broker Earning","sidebar":"v5SideBar"},"v5/abandon/enable-unitransfer-subuid":{"id":"v5/abandon/enable-unitransfer-subuid","title":"Enable Universal Transfer for Sub UID","description":"You no longer need to configure transferable sub UIDs. Now, all sub UIDs are automatically enabled for universal transfer.","sidebar":"v5SideBar"},"v5/abandon/ltv":{"id":"v5/abandon/ltv","title":"Get LTV","description":"HTTP Request","sidebar":"v5SideBar"},"v5/abandon/margin-coin-info":{"id":"v5/abandon/margin-coin-info","title":"Get Margin Coin Info","description":"HTTP Request","sidebar":"v5SideBar"},"v5/abandon/order-record":{"id":"v5/abandon/order-record","title":"Get Order Records","description":"Get lending or redeem history","sidebar":"v5SideBar"},"v5/abandon/redeem":{"id":"v5/abandon/redeem","title":"Redeem Funds","description":"Withdraw funds from the Bybit asset pool.","sidebar":"v5SideBar"},"v5/account/account-info":{"id":"v5/account/account-info","title":"Get Account Info","description":"Query the margin mode configuration of the account.","sidebar":"v5SideBar"},"v5/account/batch-set-collateral":{"id":"v5/account/batch-set-collateral","title":"Batch Set Collateral Coin","description":"HTTP Request","sidebar":"v5SideBar"},"v5/account/borrow-history":{"id":"v5/account/borrow-history","title":"Get Borrow History","description":"Get interest records, sorted in reverse order of creation time.","sidebar":"v5SideBar"},"v5/account/coin-greeks":{"id":"v5/account/coin-greeks","title":"Get Coin Greeks","description":"Get current account Greeks information","sidebar":"v5SideBar"},"v5/account/collateral-info":{"id":"v5/account/collateral-info","title":"Get Collateral Info","description":"Get the collateral information of the current unified margin account, including loan interest rate, loanable amount, collateral conversion rate, whether it can be mortgaged as margin, etc.","sidebar":"v5SideBar"},"v5/account/contract-transaction-log":{"id":"v5/account/contract-transaction-log","title":"Get Transaction Log","description":"Query transaction logs in the derivatives wallet (classic account), and inverse derivatives wallet (upgraded to UTA)","sidebar":"v5SideBar"},"v5/account/dcp-info":{"id":"v5/account/dcp-info","title":"Get DCP Info","description":"Query the DCP configuration of the account\'s contracts (USDT perpetual, USDC perpetual and USDC Futures) / spot / options. Before calling the interface, please make sure you have applied for the UTA account DCP configuration with your account manager","sidebar":"v5SideBar"},"v5/account/fee-rate":{"id":"v5/account/fee-rate","title":"Get Fee Rate","description":"Get the trading fee rate.","sidebar":"v5SideBar"},"v5/account/get-mmp-state":{"id":"v5/account/get-mmp-state","title":"Get MMP State","description":"HTTP Request","sidebar":"v5SideBar"},"v5/account/repay-liability":{"id":"v5/account/repay-liability","title":"Repay Liability","description":"You can manually repay the liabilities of Unified account","sidebar":"v5SideBar"},"v5/account/reset-mmp":{"id":"v5/account/reset-mmp","title":"Reset MMP","description":"* Once the mmp triggered, you can unfreeze the account by this endpoint, then qtyLimit and deltaLimit will be reset to 0.","sidebar":"v5SideBar"},"v5/account/set-collateral":{"id":"v5/account/set-collateral","title":"Set Collateral Coin","description":"You can decide whether the assets in the Unified account needs to be collateral coins.","sidebar":"v5SideBar"},"v5/account/set-margin-mode":{"id":"v5/account/set-margin-mode","title":"Set Margin Mode","description":"Default is regular margin mode","sidebar":"v5SideBar"},"v5/account/set-mmp":{"id":"v5/account/set-mmp","title":"Set MMP","description":"What is MMP?","sidebar":"v5SideBar"},"v5/account/set-spot-hedge":{"id":"v5/account/set-spot-hedge","title":"Set Spot Hedging","description":"You can turn on/off Spot hedging feature in Portfolio margin for Unified account.","sidebar":"v5SideBar"},"v5/account/smp-group":{"id":"v5/account/smp-group","title":"Get SMP Group ID","description":"Query the SMP group ID of self match prevention","sidebar":"v5SideBar"},"v5/account/transaction-log":{"id":"v5/account/transaction-log","title":"Get Transaction Log","description":"Query transaction logs in Unified account, it supports up to 2 years data","sidebar":"v5SideBar"},"v5/account/upgrade-unified-account":{"id":"v5/account/upgrade-unified-account","title":"Upgrade to Unified Account","description":"Upgrade Unified Account","sidebar":"v5SideBar"},"v5/account/wallet-balance":{"id":"v5/account/wallet-balance","title":"Get Wallet Balance","description":"Obtain wallet balance, query asset information of each currency, and account risk rate information. By default, currency","sidebar":"v5SideBar"},"v5/announcement":{"id":"v5/announcement","title":"Get Announcement","description":"HTTP Request","sidebar":"v5SideBar"},"v5/asset/balance/account-coin-balance":{"id":"v5/asset/balance/account-coin-balance","title":"Get Single Coin Balance","description":"Query the balance of a specific coin in a specific account type. Supports querying sub UID\'s balance.","sidebar":"v5SideBar"},"v5/asset/balance/all-balance":{"id":"v5/asset/balance/all-balance","title":"Get All Coins Balance","description":"You could get all coin balance of all account types under the master account, and sub account.","sidebar":"v5SideBar"},"v5/asset/balance/asset-info":{"id":"v5/asset/balance/asset-info","title":"Get Asset Info","description":"Query asset information","sidebar":"v5SideBar"},"v5/asset/balance/delay-amount":{"id":"v5/asset/balance/delay-amount","title":"Get Withdrawable Amount","description":"How can partial funds be subject to delayed withdrawal requests?","sidebar":"v5SideBar"},"v5/asset/coin-info":{"id":"v5/asset/coin-info","title":"Get Coin Info","description":"Query coin information, including chain information, withdraw and deposit status.","sidebar":"v5SideBar"},"v5/asset/convert/apply-quote":{"id":"v5/asset/convert/apply-quote","title":"Request a Quote","description":"HTTP Request","sidebar":"v5SideBar"},"v5/asset/convert/confirm-quote":{"id":"v5/asset/convert/confirm-quote","title":"Confirm a Quote","description":"1. The exchange is async, please check the final status by calling query result API.","sidebar":"v5SideBar"},"v5/asset/convert/convert-coin-list":{"id":"v5/asset/convert/convert-coin-list","title":"Get Convert Coin List","description":"You can query the coin list of convert from (to).","sidebar":"v5SideBar"},"v5/asset/convert/get-convert-history":{"id":"v5/asset/convert/get-convert-history","title":"Get Convert history","description":"Those confirmed quotes no matter status are showns by this API.","sidebar":"v5SideBar"},"v5/asset/convert/get-convert-result":{"id":"v5/asset/convert/get-convert-result","title":"Get Convert Status","description":"You can query the exchange result by sending quoteTxId.","sidebar":"v5SideBar"},"v5/asset/convert/guideline":{"id":"v5/asset/convert/guideline","title":"Convert Guideline","description":"* All convert api need authentication","sidebar":"v5SideBar"},"v5/asset/delivery":{"id":"v5/asset/delivery","title":"Get Delivery Record","description":"Query delivery records of USDC futures and Options, sorted by deliveryTime in descending order","sidebar":"v5SideBar"},"v5/asset/deposit/deposit-coin-spec":{"id":"v5/asset/deposit/deposit-coin-spec","title":"Get Allowed Deposit Coin Info","description":"Query allowed deposit coin information. To find out paired chain of coin, please refer coin info api.","sidebar":"v5SideBar"},"v5/asset/deposit/deposit-record":{"id":"v5/asset/deposit/deposit-record","title":"Get Deposit Records (on-chain)","description":"Query deposit records.","sidebar":"v5SideBar"},"v5/asset/deposit/internal-deposit-record":{"id":"v5/asset/deposit/internal-deposit-record","title":"Get Internal Deposit Records (off-chain)","description":"Query deposit records within the Bybit platform. These transactions are not on the blockchain.","sidebar":"v5SideBar"},"v5/asset/deposit/master-deposit-addr":{"id":"v5/asset/deposit/master-deposit-addr","title":"Get Master Deposit Address","description":"Query the deposit address information of MASTER account.","sidebar":"v5SideBar"},"v5/asset/deposit/set-deposit-acct":{"id":"v5/asset/deposit/set-deposit-acct","title":"Set Deposit Account","description":"Set auto transfer account after deposit. The same function as the setting for Deposit on web GUI","sidebar":"v5SideBar"},"v5/asset/deposit/sub-deposit-addr":{"id":"v5/asset/deposit/sub-deposit-addr","title":"Get Sub Deposit Address","description":"Query the deposit address information of SUB account.","sidebar":"v5SideBar"},"v5/asset/deposit/sub-deposit-record":{"id":"v5/asset/deposit/sub-deposit-record","title":"Get Sub Deposit Records (on-chain)","description":"Query subaccount\'s deposit records by main UID\'s API key.","sidebar":"v5SideBar"},"v5/asset/exchange":{"id":"v5/asset/exchange","title":"Get Coin Exchange Records","description":"Query the coin exchange records.","sidebar":"v5SideBar"},"v5/asset/settlement":{"id":"v5/asset/settlement","title":"Get USDC Session Settlement","description":"Query session settlement records of USDC perpetual and futures","sidebar":"v5SideBar"},"v5/asset/sub-uid-list":{"id":"v5/asset/sub-uid-list","title":"Get Sub UID","description":"Query the sub UIDs under a main UID. It returns up to 2000 sub accounts, if you need more, please call this endpoint.","sidebar":"v5SideBar"},"v5/asset/transfer/create-inter-transfer":{"id":"v5/asset/transfer/create-inter-transfer","title":"Create Internal Transfer","description":"Create the internal transfer between different account types under the same UID.","sidebar":"v5SideBar"},"v5/asset/transfer/inter-transfer-list":{"id":"v5/asset/transfer/inter-transfer-list","title":"Get Internal Transfer Records","description":"Query the internal transfer records between different account types under the same UID.","sidebar":"v5SideBar"},"v5/asset/transfer/transferable-coin":{"id":"v5/asset/transfer/transferable-coin","title":"Get Transferable Coin","description":"Query the transferable coin list between each account type","sidebar":"v5SideBar"},"v5/asset/transfer/unitransfer":{"id":"v5/asset/transfer/unitransfer","title":"Create Universal Transfer","description":"Transfer between sub-sub or main-sub.","sidebar":"v5SideBar"},"v5/asset/transfer/unitransfer-list":{"id":"v5/asset/transfer/unitransfer-list","title":"Get Universal Transfer Records","description":"Query universal transfer records","sidebar":"v5SideBar"},"v5/asset/withdraw/cancel-withdraw":{"id":"v5/asset/withdraw/cancel-withdraw","title":"Cancel Withdrawal","description":"Cancel the withdrawal","sidebar":"v5SideBar"},"v5/asset/withdraw/vasp-list":{"id":"v5/asset/withdraw/vasp-list","title":"Get Exchange Entity List","description":"This endpoint is particularly used for kyc=KOR users. When withdraw funds, you need to fill entity id.","sidebar":"v5SideBar"},"v5/asset/withdraw/withdraw":{"id":"v5/asset/withdraw/withdraw","title":"Withdraw","description":"Withdraw assets from your Bybit account. You can make an off-chain transfer if the target wallet address is from Bybit. This means that no blockchain fee will be charged.","sidebar":"v5SideBar"},"v5/asset/withdraw/withdraw-record":{"id":"v5/asset/withdraw/withdraw-record","title":"Get Withdrawal Records","description":"Query withdrawal records.","sidebar":"v5SideBar"},"v5/backup/set-pledge-token":{"id":"v5/backup/set-pledge-token","title":"Set Pledge Token","description":"Set Pledge Token in cross margin"},"v5/broker/account-info":{"id":"v5/broker/account-info","title":"Get Exchange Broker Account Info","description":"* Use exchange broker master account to query","sidebar":"v5SideBar"},"v5/broker/exchange-earning":{"id":"v5/broker/exchange-earning","title":"Get Exchange Broker Earning","description":"* Use exchange broker master account to query","sidebar":"v5SideBar"},"v5/broker/sub-deposit-record":{"id":"v5/broker/sub-deposit-record","title":"Get Sub Account Deposit Records","description":"Exchange broker can query subaccount\'s deposit records by main UID\'s API key without specifying uid.","sidebar":"v5SideBar"},"v5/copytrade":{"id":"v5/copytrade","title":"How To Start Copy Trading","description":"Become A Master Trader","sidebar":"v5SideBar"},"v5/demo":{"id":"v5/demo","title":"Demo Trading Service","description":"Introduction","sidebar":"v5SideBar"},"v5/enum":{"id":"v5/enum","title":"Enums Definitions","description":"locale","sidebar":"v5SideBar"},"v5/error":{"id":"v5/error","title":"Error Codes","description":"HTTP Code","sidebar":"v5SideBar"},"v5/guide":{"id":"v5/guide","title":"Integration Guidance","description":"To learn more about the V5 API, please read the Introduction.","sidebar":"v5SideBar"},"v5/intro":{"id":"v5/intro","title":"Introduction","description":"Overview","sidebar":"v5SideBar"},"v5/lt/leverage-token-info":{"id":"v5/lt/leverage-token-info","title":"Get Leverage Token Info","description":"Query leverage token information","sidebar":"v5SideBar"},"v5/lt/leverage-token-reference":{"id":"v5/lt/leverage-token-reference","title":"Get Leveraged Token Market","description":"Get leverage token market information","sidebar":"v5SideBar"},"v5/lt/order-record":{"id":"v5/lt/order-record","title":"Get Purchase/Redemption Records","description":"Get purchase or redeem history","sidebar":"v5SideBar"},"v5/lt/purchase":{"id":"v5/lt/purchase","title":"Purchase","description":"Purchase levearge token","sidebar":"v5SideBar"},"v5/lt/redeem":{"id":"v5/lt/redeem","title":"Redeem","description":"Redeem leverage token","sidebar":"v5SideBar"},"v5/market/delivery-price":{"id":"v5/market/delivery-price","title":"Get Delivery Price","description":"Get the delivery price.","sidebar":"v5SideBar"},"v5/market/history-fund-rate":{"id":"v5/market/history-fund-rate","title":"Get Funding Rate History","description":"Query for historical funding rates. Each symbol has a different funding interval. For example, if the interval is 8 hours and the current time is UTC 12, then it returns the last funding rate, which settled at UTC 8.","sidebar":"v5SideBar"},"v5/market/index-kline":{"id":"v5/market/index-kline","title":"Get Index Price Kline","description":"Query for historical index price klines. Charts are returned in groups based on the requested interval.","sidebar":"v5SideBar"},"v5/market/instrument":{"id":"v5/market/instrument","title":"Get Instruments Info","description":"Query for the instrument specification of online trading pairs.","sidebar":"v5SideBar"},"v5/market/insurance":{"id":"v5/market/insurance","title":"Get Insurance","description":"Query for Bybit insurance pool data (BTC/USDT/USDC etc). The data is updated every 24 hours.","sidebar":"v5SideBar"},"v5/market/iv":{"id":"v5/market/iv","title":"Get Historical Volatility","description":"Query option historical volatility","sidebar":"v5SideBar"},"v5/market/kline":{"id":"v5/market/kline","title":"Get Kline","description":"Query for historical klines (also known as candles/candlesticks). Charts are returned in groups based on the requested interval.","sidebar":"v5SideBar"},"v5/market/long-short-ratio":{"id":"v5/market/long-short-ratio","title":"Get Long Short Ratio","description":"HTTP Request","sidebar":"v5SideBar"},"v5/market/mark-kline":{"id":"v5/market/mark-kline","title":"Get Mark Price Kline","description":"Query for historical mark price klines. Charts are returned in groups based on the requested interval.","sidebar":"v5SideBar"},"v5/market/open-interest":{"id":"v5/market/open-interest","title":"Get Open Interest","description":"Get the open interest of each symbol.","sidebar":"v5SideBar"},"v5/market/orderbook":{"id":"v5/market/orderbook","title":"Get Orderbook","description":"Query for orderbook depth data.","sidebar":"v5SideBar"},"v5/market/preimum-index-kline":{"id":"v5/market/preimum-index-kline","title":"Get Premium Index Price Kline","description":"Query for historical premium index klines. Charts are returned in groups based on the requested interval.","sidebar":"v5SideBar"},"v5/market/recent-trade":{"id":"v5/market/recent-trade","title":"Get Public Recent Trading History","description":"Query recent public trading data in Bybit.","sidebar":"v5SideBar"},"v5/market/risk-limit":{"id":"v5/market/risk-limit","title":"Get Risk Limit","description":"Query for the risk limit.","sidebar":"v5SideBar"},"v5/market/tickers":{"id":"v5/market/tickers","title":"Get Tickers","description":"Query for the latest price snapshot, best bid/ask price, and trading volume in the last 24 hours.","sidebar":"v5SideBar"},"v5/market/time":{"id":"v5/market/time","title":"Get Bybit Server Time","description":"HTTP Request","sidebar":"v5SideBar"},"v5/order/amend-order":{"id":"v5/order/amend-order","title":"Amend Order","description":"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option","sidebar":"v5SideBar"},"v5/order/batch-amend":{"id":"v5/order/batch-amend","title":"Batch Amend Order","description":"Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)","sidebar":"v5SideBar"},"v5/order/batch-cancel":{"id":"v5/order/batch-cancel","title":"Batch Cancel Order","description":"This endpoint allows you to cancel more than one open order in a single request.","sidebar":"v5SideBar"},"v5/order/batch-place":{"id":"v5/order/batch-place","title":"Batch Place Order","description":"Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)","sidebar":"v5SideBar"},"v5/order/cancel-all":{"id":"v5/order/cancel-all","title":"Cancel All Orders","description":"Cancel all open orders","sidebar":"v5SideBar"},"v5/order/cancel-order":{"id":"v5/order/cancel-order","title":"Cancel Order","description":"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options","sidebar":"v5SideBar"},"v5/order/create-order":{"id":"v5/order/create-order","title":"Place Order","description":"This endpoint supports to create the order for spot, spot margin, USDT perpetual, USDC perpetual, USDC futures, inverse futures and options.","sidebar":"v5SideBar"},"v5/order/dcp":{"id":"v5/order/dcp","title":"Set Disconnect Cancel All","description":"Covers: Futures / Spot / Option (Unified Account)","sidebar":"v5SideBar"},"v5/order/execution":{"id":"v5/order/execution","title":"Get Trade History","description":"Query users\' execution records, sorted by execTime in descending order. However, for Classic spot, they are sorted by execId in descending order.","sidebar":"v5SideBar"},"v5/order/open-order":{"id":"v5/order/open-order","title":"Get Open & Closed Orders","description":"Primarily query unfilled or partially filled orders in real-time, but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param openOnly.","sidebar":"v5SideBar"},"v5/order/order-list":{"id":"v5/order/order-list","title":"Get Order History","description":"Query order history. As order creation/cancellation is asynchronous, the data returned from this endpoint may delay. If you want to get","sidebar":"v5SideBar"},"v5/order/spot-borrow-quota":{"id":"v5/order/spot-borrow-quota","title":"Get Borrow Quota (Spot)","description":"Query the available balance for Spot trading and Margin trading","sidebar":"v5SideBar"},"v5/otc/bind-uid":{"id":"v5/otc/bind-uid","title":"Bind Or Unbind UID","description":"For the institutional loan product, you can bind new UIDs to the risk unit or unbind UID from the risk unit.","sidebar":"v5SideBar"},"v5/otc/loan-info":{"id":"v5/otc/loan-info","title":"Get Loan Orders","description":"Get loan orders information","sidebar":"v5SideBar"},"v5/otc/ltv-convert":{"id":"v5/otc/ltv-convert","title":"Get LTV","description":"Get your loan-to-value (LTV) ratio.","sidebar":"v5SideBar"},"v5/otc/margin-coin-convert-info":{"id":"v5/otc/margin-coin-convert-info","title":"Get Margin Coin Info","description":"* This endpoint can be queried without api key and secret, then it returns public margin data","sidebar":"v5SideBar"},"v5/otc/margin-product-info":{"id":"v5/otc/margin-product-info","title":"Get Product Info","description":"* This endpoint can be queried without api key and secret, then it returns public product data","sidebar":"v5SideBar"},"v5/otc/repay-info":{"id":"v5/otc/repay-info","title":"Get Repayment Orders","description":"Get a list of your loan repayment orders (orders which repaid the loan).","sidebar":"v5SideBar"},"v5/position/auto-add-margin":{"id":"v5/position/auto-add-margin","title":"Set Auto Add Margin","description":"Turn on/off auto-add-margin for isolated margin position","sidebar":"v5SideBar"},"v5/position/close-pnl":{"id":"v5/position/close-pnl","title":"Get Closed PnL","description":"Query user\'s closed profit and loss records","sidebar":"v5SideBar"},"v5/position/confirm-mmr":{"id":"v5/position/confirm-mmr","title":"Confirm New Risk Limit","description":"It is only applicable when the user is marked as only reducing positions (please see the isReduceOnly field in","sidebar":"v5SideBar"},"v5/position/cross-isolate":{"id":"v5/position/cross-isolate","title":"Switch Cross/Isolated Margin","description":"Select cross margin mode or isolated margin mode per symbol level","sidebar":"v5SideBar"},"v5/position/leverage":{"id":"v5/position/leverage","title":"Set Leverage","description":"Set the leverage","sidebar":"v5SideBar"},"v5/position/manual-add-margin":{"id":"v5/position/manual-add-margin","title":"Add Or Reduce Margin","description":"Manually add or reduce margin for isolated margin position","sidebar":"v5SideBar"},"v5/position/move-position":{"id":"v5/position/move-position","title":"Move Position","description":"You can move positions between sub-master, master-sub, or sub-sub UIDs when necessary","sidebar":"v5SideBar"},"v5/position/move-position-history":{"id":"v5/position/move-position-history","title":"Get Move Position History","description":"You can query moved position data by master UID api key","sidebar":"v5SideBar"},"v5/position/position":{"id":"v5/position/position","title":"Get Position Info","description":"Query real-time position data, such as position size, cumulative realizedPNL.","sidebar":"v5SideBar"},"v5/position/position-mode":{"id":"v5/position/position-mode","title":"Switch Position Mode","description":"It supports to switch the position mode for USDT perpetual and Inverse futures. If you are in one-way Mode, you can only open one position on Buy or Sell side. If you are in hedge mode, you can open both Buy and Sell side positions simultaneously.","sidebar":"v5SideBar"},"v5/position/set-risk-limit":{"id":"v5/position/set-risk-limit","title":"Set Risk Limit","description":"Since bybit has launched auto risk limit on 12 March 2024, please click here to learn more, so it will not take effect even you set it successfully.","sidebar":"v5SideBar"},"v5/position/tpsl-mode":{"id":"v5/position/tpsl-mode","title":"Set TP/SL Mode","description":"_To some extent, this endpoint is depreciated because now tpsl is based on order level. This API was used for position level","sidebar":"v5SideBar"},"v5/position/trading-stop":{"id":"v5/position/trading-stop","title":"Set Trading Stop","description":"Set the take profit, stop loss or trailing stop for the position.","sidebar":"v5SideBar"},"v5/pre-upgrade/close-pnl":{"id":"v5/pre-upgrade/close-pnl","title":"Get Pre-upgrade Closed PnL","description":"Query user\'s closed profit and loss records from before you upgraded the account to a Unified account. The results are sorted by updatedTime in descending order.","sidebar":"v5SideBar"},"v5/pre-upgrade/delivery":{"id":"v5/pre-upgrade/delivery","title":"Get Pre-upgrade Option Delivery Record","description":"Query delivery records of Option before you upgraded the account to a Unified account, sorted by deliveryTime in descending order","sidebar":"v5SideBar"},"v5/pre-upgrade/execution":{"id":"v5/pre-upgrade/execution","title":"Get Pre-upgrade Trade History","description":"Get users\' execution records which occurred before you upgraded the account to a Unified account, sorted by execTime in descending order","sidebar":"v5SideBar"},"v5/pre-upgrade/order-list":{"id":"v5/pre-upgrade/order-list","title":"Get Pre-upgrade Order History","description":"After the account is upgraded to a Unified account, you can get the orders which occurred before the upgrade.","sidebar":"v5SideBar"},"v5/pre-upgrade/settlement":{"id":"v5/pre-upgrade/settlement","title":"Get Pre-upgrade USDC Session Settlement","description":"Query session settlement records of USDC perpetual before you upgrade the account to Unified account.","sidebar":"v5SideBar"},"v5/pre-upgrade/transaction-log":{"id":"v5/pre-upgrade/transaction-log","title":"Get Pre-upgrade Transaction Log","description":"Query transaction logs which occurred in the USDC Derivatives wallet before the account was upgraded to a Unified account.","sidebar":"v5SideBar"},"v5/rate-limit":{"id":"v5/rate-limit","title":"Rate Limit","description":"IP Rate Limit","sidebar":"v5SideBar"},"v5/smp":{"id":"v5/smp","title":"Self Match Prevention","description":"What is SMP?","sidebar":"v5SideBar"},"v5/spot-margin-normal/account-info":{"id":"v5/spot-margin-normal/account-info","title":"Get Loan Account Info","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/borrow":{"id":"v5/spot-margin-normal/borrow","title":"Borrow","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/borrow-order":{"id":"v5/spot-margin-normal/borrow-order","title":"Get Borrow Order Detail","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/borrowable-data":{"id":"v5/spot-margin-normal/borrowable-data","title":"Get Borrowable Coin Info","description":"Do not need authentication"},"v5/spot-margin-normal/interest-quota":{"id":"v5/spot-margin-normal/interest-quota","title":"Get Interest & Quota","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/margin-data":{"id":"v5/spot-margin-normal/margin-data","title":"Get Margin Coin Info","description":"Do not need authentication"},"v5/spot-margin-normal/repay":{"id":"v5/spot-margin-normal/repay","title":"Repay","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/repay-order":{"id":"v5/spot-margin-normal/repay-order","title":"Get Repayment Order Detail","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/switch-mode":{"id":"v5/spot-margin-normal/switch-mode","title":"Toggle Margin Trade","description":"Turn on / off spot margin trade"},"v5/spot-margin-normal/vip-margin":{"id":"v5/spot-margin-normal/vip-margin","title":"Get VIP Margin Data","description":"This margin data is for Classic account in particular."},"v5/spot-margin-uta/historical-interest":{"id":"v5/spot-margin-uta/historical-interest","title":"Get Historical Interest Rate","description":"You can query up to six months borrowing interest rate of Margin trading.","sidebar":"v5SideBar"},"v5/spot-margin-uta/set-leverage":{"id":"v5/spot-margin-uta/set-leverage","title":"Set Leverage","description":"Set the user\'s maximum leverage in spot cross margin","sidebar":"v5SideBar"},"v5/spot-margin-uta/status":{"id":"v5/spot-margin-uta/status","title":"Get Status And Leverage","description":"Query the Spot margin status and leverage of Unified account","sidebar":"v5SideBar"},"v5/spot-margin-uta/switch-mode":{"id":"v5/spot-margin-uta/switch-mode","title":"Toggle Margin Trade","description":"Turn on / off spot margin trade","sidebar":"v5SideBar"},"v5/spot-margin-uta/vip-margin":{"id":"v5/spot-margin-uta/vip-margin","title":"Get VIP Margin Data","description":"This margin data is for Unified account in particular.","sidebar":"v5SideBar"},"v5/user/affiliate-info":{"id":"v5/user/affiliate-info","title":"Get Affiliate User Info","description":"To use this endpoint, you should have an affiliate account and only tick \\"affiliate\\" permission while creating the API key.","sidebar":"v5SideBar"},"v5/user/apikey-info":{"id":"v5/user/apikey-info","title":"Get API Key Information","description":"Get the information of the api key. Use the api key pending to be checked to call the endpoint. Both master and sub user\'s api key are applicable.","sidebar":"v5SideBar"},"v5/user/create-subuid":{"id":"v5/user/create-subuid","title":"Create Sub UID","description":"Create a new sub user id. Use master account\'s api key.","sidebar":"v5SideBar"},"v5/user/create-subuid-apikey":{"id":"v5/user/create-subuid-apikey","title":"Create Sub UID API Key","description":"To create new API key for those newly created sub UID. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/froze-subuid":{"id":"v5/user/froze-subuid","title":"Freeze Sub UID","description":"Freeze Sub UID. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/list-sub-apikeys":{"id":"v5/user/list-sub-apikeys","title":"Get Sub Account All API Keys","description":"Query all api keys information of a sub UID.","sidebar":"v5SideBar"},"v5/user/modify-master-apikey":{"id":"v5/user/modify-master-apikey","title":"Modify Master API Key","description":"Modify the settings of master api key. Use the api key pending to be modified to call the endpoint. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/modify-sub-apikey":{"id":"v5/user/modify-sub-apikey","title":"Modify Sub API Key","description":"Modify the settings of sub api key. Use the sub account api key pending to be modified to call the endpoint or use master","sidebar":"v5SideBar"},"v5/user/page-subuid":{"id":"v5/user/page-subuid","title":"Get Sub UID List (Unlimited)","description":"This API is applicable to the client who has over 10k sub accounts. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/rm-master-apikey":{"id":"v5/user/rm-master-apikey","title":"Delete Master API Key","description":"Delete the api key of master account. Use the api key pending to be delete to call the endpoint. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/rm-sub-apikey":{"id":"v5/user/rm-sub-apikey","title":"Delete Sub API Key","description":"Delete the api key of sub account. Use the sub api key pending to be delete to call the endpoint or use the master api key","sidebar":"v5SideBar"},"v5/user/rm-subuid":{"id":"v5/user/rm-subuid","title":"Delete Sub UID","description":"Delete a sub UID. Before deleting the UID, please make sure there is no asset.","sidebar":"v5SideBar"},"v5/user/subuid-list":{"id":"v5/user/subuid-list","title":"Get Sub UID List (Limited)","description":"Get at most 10k sub UID of master account. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/wallet-type":{"id":"v5/user/wallet-type","title":"Get UID Wallet Type","description":"Get available wallet types for the master account or sub account","sidebar":"v5SideBar"},"v5/websocket/private/dcp":{"id":"v5/websocket/private/dcp","title":"Dcp","description":"Subscribe to the dcp stream to trigger DCP function.","sidebar":"v5SideBar"},"v5/websocket/private/execution":{"id":"v5/websocket/private/execution","title":"Execution","description":"Subscribe to the execution stream to see your executions in real-time.","sidebar":"v5SideBar"},"v5/websocket/private/fast-execution":{"id":"v5/websocket/private/fast-execution","title":"Fast Execution","description":"Fast execution stream significantly reduces data latency compared original \\"execution\\" stream. However, it pushes limited","sidebar":"v5SideBar"},"v5/websocket/private/greek":{"id":"v5/websocket/private/greek","title":"Greek","description":"Subscribe to the greeks stream to see changes to your greeks data in real-time. option only.","sidebar":"v5SideBar"},"v5/websocket/private/order":{"id":"v5/websocket/private/order","title":"Order","description":"Subscribe to the order stream to see changes to your orders in real-time.","sidebar":"v5SideBar"},"v5/websocket/private/position":{"id":"v5/websocket/private/position","title":"Position","description":"Subscribe to the position stream to see changes to your position data in real-time.","sidebar":"v5SideBar"},"v5/websocket/private/wallet":{"id":"v5/websocket/private/wallet","title":"Wallet","description":"Subscribe to the wallet stream to see changes to your wallet in real-time.","sidebar":"v5SideBar"},"v5/websocket/public/etp-kline":{"id":"v5/websocket/public/etp-kline","title":"LT Kline","description":"Subscribe to the leveraged token kline stream.","sidebar":"v5SideBar"},"v5/websocket/public/etp-nav":{"id":"v5/websocket/public/etp-nav","title":"LT Nav","description":"Subscribe to the leveraged token nav stream.","sidebar":"v5SideBar"},"v5/websocket/public/etp-ticker":{"id":"v5/websocket/public/etp-ticker","title":"LT Ticker","description":"Subscribe to the leveraged token ticker stream.","sidebar":"v5SideBar"},"v5/websocket/public/kline":{"id":"v5/websocket/public/kline","title":"Kline","description":"Subscribe to the klines stream.","sidebar":"v5SideBar"},"v5/websocket/public/liquidation":{"id":"v5/websocket/public/liquidation","title":"Liquidation","description":"Subscribe to the liquidation stream, at most one order is published per second per symbol","sidebar":"v5SideBar"},"v5/websocket/public/orderbook":{"id":"v5/websocket/public/orderbook","title":"Orderbook","description":"Subscribe to the orderbook stream. Supports different depths.","sidebar":"v5SideBar"},"v5/websocket/public/ticker":{"id":"v5/websocket/public/ticker","title":"Ticker","description":"Subscribe to the ticker stream.","sidebar":"v5SideBar"},"v5/websocket/public/trade":{"id":"v5/websocket/public/trade","title":"Trade","description":"Subscribe to the recent trades stream.","sidebar":"v5SideBar"},"v5/websocket/trade/guideline":{"id":"v5/websocket/trade/guideline","title":"Websocket Trade Guideline","description":"URL","sidebar":"v5SideBar"},"v5/websocket/wss-authentication":{"id":"v5/websocket/wss-authentication","title":"Connect","description":"WebSocket public stream:","sidebar":"v5SideBar"}}}')}}]); \ No newline at end of file diff --git a/assets/js/935f2afb.a30cc0bf.js b/assets/js/935f2afb.a30cc0bf.js deleted file mode 100644 index ea9094421f..0000000000 --- a/assets/js/935f2afb.a30cc0bf.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[80053],{1109:e=>{e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"v3SideBar":[{"type":"link","label":"Introduction","href":"/docs/v3/intro","docId":"v3/intro"},{"type":"link","label":"Bybit Server Time","href":"/docs/v3/server-time","docId":"v3/server-time"},{"type":"link","label":"Self Match Prevention","href":"/docs/v3/smp","docId":"v3/smp"},{"type":"category","label":"Derivatives","items":[{"type":"category","label":"REST API","items":[{"type":"category","label":"Market data","items":[{"type":"link","label":"Kline","href":"/docs/derivatives/public/kline","docId":"v3/derivatives/rest-public/kline"},{"type":"link","label":"Mark Price Kline","href":"/docs/derivatives/public/mark-kline","docId":"v3/derivatives/rest-public/mark-kline"},{"type":"link","label":"Index Price Kline","href":"/docs/derivatives/public/index-kline","docId":"v3/derivatives/rest-public/index-kline"},{"type":"link","label":"Premium Index Price Kline","href":"/docs/derivatives/public/premium-index-kline","docId":"v3/derivatives/rest-public/premium-index-kline"},{"type":"link","label":"Order Book","href":"/docs/derivatives/public/orderbook","docId":"v3/derivatives/rest-public/orderbook"},{"type":"link","label":"Ticker Info","href":"/docs/derivatives/public/ticker","docId":"v3/derivatives/rest-public/ticker-info"},{"type":"link","label":"Instrument Info","href":"/docs/derivatives/public/instrument-info","docId":"v3/derivatives/rest-public/instrument-info"},{"type":"link","label":"Public Trading History","href":"/docs/derivatives/public/trade","docId":"v3/derivatives/rest-public/public-trade"},{"type":"link","label":"Risk Limit","href":"/docs/derivatives/public/risk-limit","docId":"v3/derivatives/rest-public/risk-limit"},{"type":"link","label":"Funding Rate History","href":"/docs/derivatives/public/funding-rate","docId":"v3/derivatives/rest-public/fund-rate-history"},{"type":"link","label":"Open Interest","href":"/docs/derivatives/public/open-interest","docId":"v3/derivatives/rest-public/open-interest"},{"type":"link","label":"Option Delivery Price","href":"/docs/derivatives/public/option-delivery","docId":"v3/derivatives/rest-public/delivery-price"},{"type":"link","label":"Get Long Short Ratio","href":"/docs/derivatives/public/long-short-ratio","docId":"v3/derivatives/rest-public/long-short-ratio"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Contract","items":[{"type":"category","label":"Order","items":[{"type":"link","label":"Place Order","href":"/docs/derivatives/contract/place-order","docId":"v3/derivatives/rest-contract/order/place-order"},{"type":"link","label":"Get Open Orders","href":"/docs/derivatives/contract/open-order","docId":"v3/derivatives/rest-contract/order/open-order"},{"type":"link","label":"Replace Order","href":"/docs/derivatives/contract/replace-order","docId":"v3/derivatives/rest-contract/order/replace-order"},{"type":"link","label":"Cancel Order","href":"/docs/derivatives/contract/cancel","docId":"v3/derivatives/rest-contract/order/cancel-order"},{"type":"link","label":"Cancel All Order","href":"/docs/derivatives/contract/cancel-all","docId":"v3/derivatives/rest-contract/order/cancel-all"},{"type":"link","label":"Get Order List","href":"/docs/derivatives/contract/order-list","docId":"v3/derivatives/rest-contract/order/order-list"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Position","items":[{"type":"link","label":"My Position","href":"/docs/derivatives/contract/position-list","docId":"v3/derivatives/rest-contract/position/position-info"},{"type":"link","label":"Set Auto Add Margin","href":"/docs/derivatives/contract/auto-margin","docId":"v3/derivatives/rest-contract/position/auto-margin"},{"type":"link","label":"Switch Cross/Isolated Margin","href":"/docs/derivatives/contract/cross-isolated","docId":"v3/derivatives/rest-contract/position/cross-isolated-margin"},{"type":"link","label":"Switch Position Mode","href":"/docs/derivatives/contract/position-mode","docId":"v3/derivatives/rest-contract/position/position-mode"},{"type":"link","label":"Switch TP/SL Mode","href":"/docs/derivatives/contract/tpsl-mode","docId":"v3/derivatives/rest-contract/position/tpsl-mode"},{"type":"link","label":"Set Leverage","href":"/docs/derivatives/contract/leverage","docId":"v3/derivatives/rest-contract/position/leverage"},{"type":"link","label":"Set Trading Stop","href":"/docs/derivatives/contract/trading-stop","docId":"v3/derivatives/rest-contract/position/trading-stop"},{"type":"link","label":"Set Risk Limit (Depreciated)","href":"/docs/derivatives/contract/set-risk-limit","docId":"v3/derivatives/rest-contract/position/set-risk-limit"},{"type":"link","label":"Get Execution List","href":"/docs/derivatives/contract/execution-list","docId":"v3/derivatives/rest-contract/position/execution"},{"type":"link","label":"Get Closed PnL","href":"/docs/derivatives/contract/closepnl","docId":"v3/derivatives/rest-contract/position/close-pnl"},{"type":"link","label":"Confirm New Risk Limit","href":"/docs/derivatives/contract/confirm-mmr","docId":"v3/derivatives/rest-contract/position/confirm-mmr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Account","items":[{"type":"link","label":"Wallet Balance","href":"/docs/derivatives/contract/wallet","docId":"v3/derivatives/rest-contract/account/wallet-balance"},{"type":"link","label":"Get Trading Fee Rate","href":"/docs/derivatives/contract/fee-rate","docId":"v3/derivatives/rest-contract/account/trading-fee"},{"type":"link","label":"Get Wallet Fund Records","href":"/docs/derivatives/contract/wallet-fund","docId":"v3/derivatives/rest-contract/account/wallet-fund-record"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket Stream","items":[{"type":"link","label":"Connect","href":"/docs/derivatives/ws/connect","docId":"v3/derivatives/wss-authentication"},{"type":"category","label":"Public Channel","items":[{"type":"link","label":"Orderbook","href":"/docs/derivatives/ws-public/orderbook","docId":"v3/derivatives/wss-public/orderbook"},{"type":"link","label":"Public Trade","href":"/docs/derivatives/ws-public/trade","docId":"v3/derivatives/wss-public/trade"},{"type":"link","label":"Tickers","href":"/docs/derivatives/ws-public/ticker","docId":"v3/derivatives/wss-public/tickers"},{"type":"link","label":"Kline","href":"/docs/derivatives/ws-public/kline","docId":"v3/derivatives/wss-public/kline"},{"type":"link","label":"Liquidation","href":"/docs/derivatives/ws-public/liquidation","docId":"v3/derivatives/wss-public/liquidation"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Private Channel (contract)","items":[{"type":"link","label":"Position","href":"/docs/derivatives/ws-contract/position","docId":"v3/derivatives/wss-contract/position"},{"type":"link","label":"Execution","href":"/docs/derivatives/ws-contract/execution","docId":"v3/derivatives/wss-contract/execution"},{"type":"link","label":"Order","href":"/docs/derivatives/ws-contract/order","docId":"v3/derivatives/wss-contract/order"},{"type":"link","label":"Wallet","href":"/docs/derivatives/ws-contract/wallet","docId":"v3/derivatives/wss-contract/wallet"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"Rate Limit","href":"/docs/derivatives/rate-limit","docId":"v3/derivatives/rate-limit"},{"type":"link","label":"Enums Definitions","href":"/docs/derivatives/enum","docId":"v3/derivatives/enum"},{"type":"link","label":"Error Code","href":"/docs/derivatives/error","docId":"v3/derivatives/error"}],"collapsed":true,"collapsible":true,"href":"/docs/category/derivatives"},{"type":"category","label":"Spot","items":[{"type":"category","label":"REST API","items":[{"type":"category","label":"Market data","items":[{"type":"link","label":"Instrument Info","href":"/docs/spot/public/instrument","docId":"v3/spot/rest-public/instrument-info"},{"type":"link","label":"Order Book","href":"/docs/spot/public/depth","docId":"v3/spot/rest-public/orderbook"},{"type":"link","label":"Merged Order Book","href":"/docs/spot/public/merge-depth","docId":"v3/spot/rest-public/merge-orderbook"},{"type":"link","label":"Kline","href":"/docs/spot/public/kline","docId":"v3/spot/rest-public/kline"},{"type":"link","label":"Public Trading Records","href":"/docs/spot/public/recent-trade","docId":"v3/spot/rest-public/public-trade"},{"type":"link","label":"Best Bid/Ask Price","href":"/docs/spot/public/bid-ask","docId":"v3/spot/rest-public/best-bid-ask"},{"type":"link","label":"Last Traded Price","href":"/docs/spot/public/last-price","docId":"v3/spot/rest-public/last-trade-price"},{"type":"link","label":"Tickers","href":"/docs/spot/public/tickers","docId":"v3/spot/rest-public/ticker-info"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Trade","items":[{"type":"link","label":"Place Order","href":"/docs/spot/trade/place-order","docId":"v3/spot/rest-spot/place-order"},{"type":"link","label":"Get Order","href":"/docs/spot/trade/get-order","docId":"v3/spot/rest-spot/get-order"},{"type":"link","label":"Cancel Order","href":"/docs/spot/trade/cancel","docId":"v3/spot/rest-spot/cancel-order"},{"type":"link","label":"Open Orders","href":"/docs/spot/trade/open-order","docId":"v3/spot/rest-spot/open-order"},{"type":"link","label":"Batch Cancel Order","href":"/docs/spot/trade/batch-cancel","docId":"v3/spot/rest-spot/batch-cancel"},{"type":"link","label":"Batch Cancel Order By Id","href":"/docs/spot/trade/cancel-by-id","docId":"v3/spot/rest-spot/batch-cancel-by-id"},{"type":"link","label":"Order History","href":"/docs/spot/trade/order-history","docId":"v3/spot/rest-spot/order-history"},{"type":"link","label":"Trade History","href":"/docs/spot/trade/my-trades","docId":"v3/spot/rest-spot/trade-history"}],"collapsed":true,"collapsible":true},{"type":"link","label":"Get Wallet Balance","href":"/docs/spot/wallet","docId":"v3/spot/wallet"},{"type":"category","label":"Leveraged Token","items":[{"type":"link","label":"All Asset Info","href":"/docs/spot/etp/asset-info","docId":"v3/spot/rest-etp/asset-info"},{"type":"link","label":"Market Info","href":"/docs/spot/etp/market-info","docId":"v3/spot/rest-etp/market-info"},{"type":"link","label":"Purchase & Redeem History","href":"/docs/spot/etp/order-history","docId":"v3/spot/rest-etp/purchase-redeem-history"},{"type":"link","label":"Purchase","href":"/docs/spot/etp/purchase","docId":"v3/spot/rest-etp/purchase"},{"type":"link","label":"Redeem","href":"/docs/spot/etp/redeem","docId":"v3/spot/rest-etp/redeem"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Cross Margin Trade","items":[{"type":"link","label":"Get Loan Account Info","href":"/docs/spot/margin/account","docId":"v3/spot/rest-spot-margin/account-info"},{"type":"link","label":"Get Borrow Order Detail","href":"/docs/spot/margin/borrow-history","docId":"v3/spot/rest-spot-margin/borrow-info"},{"type":"link","label":"Borrow","href":"/docs/spot/margin/borrow","docId":"v3/spot/rest-spot-margin/borrow"},{"type":"link","label":"Get Borrowable Coin Info","href":"/docs/spot/margin/borrowable-coin","docId":"v3/spot/rest-spot-margin/borrowable-data"},{"type":"link","label":"Get Interest & Quota","href":"/docs/spot/margin/interest","docId":"v3/spot/rest-spot-margin/interest-quota"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/spot/margin/margin-data","docId":"v3/spot/rest-spot-margin/margin-data"},{"type":"link","label":"Get Repayment Order Detail","href":"/docs/spot/margin/repay-history","docId":"v3/spot/rest-spot-margin/repay-history"},{"type":"link","label":"Repay","href":"/docs/spot/margin/repay","docId":"v3/spot/rest-spot-margin/repay"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/spot/margin/toggle","docId":"v3/spot/rest-spot-margin/switch-mode"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Institution Loan","items":[{"type":"link","label":"Get Margin Product Info","href":"/docs/spot/otc/product-info","docId":"v3/spot/rest-institution-loan/margin-product-info"},{"type":"link","label":"Margin Coin Info","href":"/docs/spot/otc/coin-info","docId":"v3/spot/rest-institution-loan/margin-coin-info"},{"type":"link","label":"Get Loan Info","href":"/docs/spot/otc/loan-info","docId":"v3/spot/rest-institution-loan/loan-info"},{"type":"link","label":"Get Repay Info","href":"/docs/spot/otc/repay-info","docId":"v3/spot/rest-institution-loan/repay-info"},{"type":"link","label":"Get LTV","href":"/docs/spot/otc/ltv","docId":"v3/spot/rest-institution-loan/ltv"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket Stream","items":[{"type":"link","label":"Connect","href":"/docs/spot/ws/connect","docId":"v3/spot/wss-authentication"},{"type":"category","label":"Public Channel","items":[{"type":"link","label":"Orderbook","href":"/docs/spot/ws-public/orderbook","docId":"v3/spot/wss-public/orderbook"},{"type":"link","label":"Kline","href":"/docs/spot/ws-public/kline","docId":"v3/spot/wss-public/kline"},{"type":"link","label":"Tickers","href":"/docs/spot/ws-public/ticker","docId":"v3/spot/wss-public/tickers"},{"type":"link","label":"Bookticker","href":"/docs/spot/ws-public/bookticker","docId":"v3/spot/wss-public/bookticker"},{"type":"link","label":"Public trade","href":"/docs/spot/ws-public/public-trade","docId":"v3/spot/wss-public/trade"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Private Channel","items":[{"type":"link","label":"Order","href":"/docs/spot/ws-private/order","docId":"v3/spot/wss-private/order"},{"type":"link","label":"Stop Order","href":"/docs/spot/ws-private/stop-order","docId":"v3/spot/wss-private/stop-order"},{"type":"link","label":"Execution","href":"/docs/spot/ws-private/execution","docId":"v3/spot/wss-private/ticket-info"},{"type":"link","label":"Wallet","href":"/docs/spot/ws-private/wallet","docId":"v3/spot/wss-private/outbound-account-info"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"Rate Limit","href":"/docs/spot/rate-limit","docId":"v3/spot/rate-limit"},{"type":"link","label":"Enums Definitions","href":"/docs/spot/enum","docId":"v3/spot/enum"},{"type":"link","label":"Error Code","href":"/docs/spot/error","docId":"v3/spot/error"}],"collapsed":true,"collapsible":true,"href":"/docs/category/spot"},{"type":"category","label":"Account Asset","collapsed":true,"items":[{"type":"category","label":"Transfer Endpoint","collapsed":true,"items":[{"type":"link","label":"Create Internal Transfer","href":"/docs/account-asset/internal-transfer","docId":"v3/account-asset/transfer/internal-transfer"},{"type":"link","label":"Get Internal Transfer List","href":"/docs/account-asset/internal-transfer-list","docId":"v3/account-asset/transfer/internal-transfer-list"},{"type":"link","label":"Create Subaccount Transfer","href":"/docs/account-asset/sub-transfer","docId":"v3/account-asset/transfer/subacct-transfer"},{"type":"link","label":"Get Master-Sub Transfer List","href":"/docs/account-asset/sub-transfer-list","docId":"v3/account-asset/transfer/subacct-transfer-list"},{"type":"link","label":"Get Subaccount UID List","href":"/docs/account-asset/sub-uid-list","docId":"v3/account-asset/transfer/subacct-list"},{"type":"link","label":"Enable Universal Transfer (Depreciated)","href":"/docs/account-asset/enable-unitransfer","docId":"v3/account-asset/transfer/enable-uni-transfer"},{"type":"link","label":"Create Universal Transfer","href":"/docs/account-asset/uni-transfer","docId":"v3/account-asset/transfer/uni-transfer"},{"type":"link","label":"Get Universal Transfer List","href":"/docs/account-asset/uni-transfer-list","docId":"v3/account-asset/transfer/uni-transfer-list"},{"type":"link","label":"Get Transferable Coin List","href":"/docs/account-asset/transferable-coin-list","docId":"v3/account-asset/transfer/transferable-coin-list"},{"type":"link","label":"Get Single Coin Balance","href":"/docs/account-asset/coin-balance","docId":"v3/account-asset/transfer/coin-balance"},{"type":"link","label":"Get All Coins Balance","href":"/docs/account-asset/all-balance","docId":"v3/account-asset/transfer/all-balance"},{"type":"link","label":"Get Asset Info (Spot)","href":"/docs/account-asset/asset-info","docId":"v3/account-asset/transfer/asset-info"}],"collapsible":true},{"type":"category","label":"Withdraw and Deposit endpoint","collapsed":true,"items":[{"type":"link","label":"Get Deposit Spec","href":"/docs/account-asset/deposit-spec","docId":"v3/account-asset/withdraw-deposit/deposit-spec"},{"type":"link","label":"Set Deposit Account","href":"/docs/account-asset/set-deposit-acct","docId":"v3/account-asset/withdraw-deposit/set-deposit-acct"},{"type":"link","label":"Get Deposit Records (on chain)","href":"/docs/account-asset/deposit-record","docId":"v3/account-asset/withdraw-deposit/master-deposit-record"},{"type":"link","label":"Get Sub Deposit Records (on chain)","href":"/docs/account-asset/sub-deposit-record","docId":"v3/account-asset/withdraw-deposit/sub-deposit-record"},{"type":"link","label":"Get Bybit Internal Deposit Records (across Bybit)","href":"/docs/account-asset/internal-deposit-record","docId":"v3/account-asset/withdraw-deposit/internal-deposit-record"},{"type":"link","label":"Get Withdraw Records","href":"/docs/account-asset/withdraw-record","docId":"v3/account-asset/withdraw-deposit/withdraw-record"},{"type":"link","label":"Get Coin Information","href":"/docs/account-asset/coin-info","docId":"v3/account-asset/withdraw-deposit/coin-info"},{"type":"link","label":"Get Delay Withdraw Amount","href":"/docs/account-asset/delay-amount","docId":"v3/account-asset/withdraw-deposit/deplay-amount"},{"type":"link","label":"Get Exchange Entity List (KOR)","href":"/docs/account-asset/vasp-list","docId":"v3/account-asset/withdraw-deposit/vasp-list"},{"type":"link","label":"Withdraw","href":"/docs/account-asset/withdraw","docId":"v3/account-asset/withdraw-deposit/withdraw"},{"type":"link","label":"Cancel withdrawal","href":"/docs/account-asset/cancel-withdraw","docId":"v3/account-asset/withdraw-deposit/cancel-withdraw"},{"type":"link","label":"Get Master Acct Deposit Address Info","href":"/docs/account-asset/master-deposit-addr","docId":"v3/account-asset/withdraw-deposit/master-deposit-addr"},{"type":"link","label":"Get Sub Acct Deposit Address Info","href":"/docs/account-asset/sub-deposit-addr","docId":"v3/account-asset/withdraw-deposit/sub-deposit-addr"}],"collapsible":true},{"type":"category","label":"Master-Sub User Endpoint","collapsed":true,"items":[{"type":"link","label":"Create Sub UID","href":"/docs/account-asset/create-subuid","docId":"v3/account-asset/user/create-subuid"},{"type":"link","label":"Create Sub UID API Key","href":"/docs/account-asset/create-subuid-apikey","docId":"v3/account-asset/user/create-subuid-apikey"},{"type":"link","label":"Get Sub UID List","href":"/docs/account-asset/subuid-list","docId":"v3/account-asset/user/subuid-list"},{"type":"link","label":"Froze Sub UID","href":"/docs/account-asset/froze-subuid","docId":"v3/account-asset/user/froze-subuid"},{"type":"link","label":"Get API Key Information","href":"/docs/account-asset/apikey-info","docId":"v3/account-asset/user/apikey-info"},{"type":"link","label":"Get UID Wallet Type","href":"/docs/account-asset/wallet-type","docId":"v3/account-asset/user/wallet-type"},{"type":"link","label":"Modify Master API Key","href":"/docs/account-asset/modify-master-apikey","docId":"v3/account-asset/user/modify-master-apikey"},{"type":"link","label":"Modify Sub API Key","href":"/docs/account-asset/modify-sub-apikey","docId":"v3/account-asset/user/modify-sub-apikey"},{"type":"link","label":"Delete Master API Key","href":"/docs/account-asset/rm-master-apikey","docId":"v3/account-asset/user/rm-master-apikey"},{"type":"link","label":"Delete Sub API Key","href":"/docs/account-asset/rm-sub-apikey","docId":"v3/account-asset/user/rm-sub-apikey"}],"collapsible":true},{"type":"link","label":"Rate Limit","href":"/docs/account-asset/rate-limit","docId":"v3/account-asset/rate-limit"},{"type":"link","label":"Enums Definitions","href":"/docs/account-asset/enum","docId":"v3/account-asset/enum"},{"type":"link","label":"Error Code","href":"/docs/account-asset/error","docId":"v3/account-asset/error"}],"collapsible":true},{"type":"category","label":"Tax","items":[{"type":"link","label":"Get User Register Date","href":"/docs/tax/time","docId":"v3/tax/register-time"},{"type":"link","label":"Request Export Report","href":"/docs/tax/report","docId":"v3/tax/request-report"},{"type":"link","label":"Get Export Report Status","href":"/docs/tax/status","docId":"v3/tax/report-status"},{"type":"link","label":"Retrieve Data Export","href":"/docs/tax/data-export","docId":"v3/tax/data-export"},{"type":"link","label":"Data Explanation","href":"/docs/tax/explain","docId":"v3/tax/data-explain"},{"type":"link","label":"Enums Definitions","href":"/docs/tax/enum","docId":"v3/tax/enum"}],"collapsed":true,"collapsible":true}],"v5SideBar":[{"type":"link","label":"Introduction","href":"/docs/v5/intro","docId":"v5/intro"},{"type":"link","label":"Integration Guidance","href":"/docs/v5/guide","docId":"v5/guide"},{"type":"link","label":"Get Announcement","href":"/docs/v5/announcement","docId":"v5/announcement"},{"type":"link","label":"Self Match Prevention","href":"/docs/v5/smp","docId":"v5/smp"},{"type":"link","label":"How To Start Copy Trading","href":"/docs/v5/copytrade","docId":"v5/copytrade"},{"type":"link","label":"Demo Trading Service","href":"/docs/v5/demo","docId":"v5/demo"},{"type":"category","label":"Market","items":[{"type":"link","label":"Get Bybit Server Time","href":"/docs/v5/market/time","docId":"v5/market/time"},{"type":"link","label":"Get Kline","href":"/docs/v5/market/kline","docId":"v5/market/kline"},{"type":"link","label":"Get Mark Price Kline","href":"/docs/v5/market/mark-kline","docId":"v5/market/mark-kline"},{"type":"link","label":"Get Index Price Kline","href":"/docs/v5/market/index-kline","docId":"v5/market/index-kline"},{"type":"link","label":"Get Premium Index Price Kline","href":"/docs/v5/market/preimum-index-kline","docId":"v5/market/preimum-index-kline"},{"type":"link","label":"Get Instruments Info","href":"/docs/v5/market/instrument","docId":"v5/market/instrument"},{"type":"link","label":"Get Orderbook","href":"/docs/v5/market/orderbook","docId":"v5/market/orderbook"},{"type":"link","label":"Get Tickers","href":"/docs/v5/market/tickers","docId":"v5/market/tickers"},{"type":"link","label":"Get Funding Rate History","href":"/docs/v5/market/history-fund-rate","docId":"v5/market/history-fund-rate"},{"type":"link","label":"Get Public Recent Trading History","href":"/docs/v5/market/recent-trade","docId":"v5/market/recent-trade"},{"type":"link","label":"Get Open Interest","href":"/docs/v5/market/open-interest","docId":"v5/market/open-interest"},{"type":"link","label":"Get Historical Volatility","href":"/docs/v5/market/iv","docId":"v5/market/iv"},{"type":"link","label":"Get Insurance","href":"/docs/v5/market/insurance","docId":"v5/market/insurance"},{"type":"link","label":"Get Risk Limit","href":"/docs/v5/market/risk-limit","docId":"v5/market/risk-limit"},{"type":"link","label":"Get Delivery Price","href":"/docs/v5/market/delivery-price","docId":"v5/market/delivery-price"},{"type":"link","label":"Get Long Short Ratio","href":"/docs/v5/market/long-short-ratio","docId":"v5/market/long-short-ratio"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Trade","items":[{"type":"link","label":"Place Order","href":"/docs/v5/order/create-order","docId":"v5/order/create-order"},{"type":"link","label":"Amend Order","href":"/docs/v5/order/amend-order","docId":"v5/order/amend-order"},{"type":"link","label":"Cancel Order","href":"/docs/v5/order/cancel-order","docId":"v5/order/cancel-order"},{"type":"link","label":"Get Open & Closed Orders (real-time)","href":"/docs/v5/order/open-order","docId":"v5/order/open-order"},{"type":"link","label":"Cancel All Orders","href":"/docs/v5/order/cancel-all","docId":"v5/order/cancel-all"},{"type":"link","label":"Get Order History (2 years)","href":"/docs/v5/order/order-list","docId":"v5/order/order-list"},{"type":"link","label":"Get Trade History (2 years)","href":"/docs/v5/order/execution","docId":"v5/order/execution"},{"type":"link","label":"Batch Place Order","href":"/docs/v5/order/batch-place","docId":"v5/order/batch-place"},{"type":"link","label":"Batch Amend Order","href":"/docs/v5/order/batch-amend","docId":"v5/order/batch-amend"},{"type":"link","label":"Batch Cancel Order","href":"/docs/v5/order/batch-cancel","docId":"v5/order/batch-cancel"},{"type":"link","label":"Get Borrow Quota (Spot)","href":"/docs/v5/order/spot-borrow-quota","docId":"v5/order/spot-borrow-quota"},{"type":"link","label":"Set DCP (Options)","href":"/docs/v5/order/dcp","docId":"v5/order/dcp"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Position","items":[{"type":"link","label":"Get Position Info","href":"/docs/v5/position/","docId":"v5/position/position"},{"type":"link","label":"Set Leverage","href":"/docs/v5/position/leverage","docId":"v5/position/leverage"},{"type":"link","label":"Switch Cross/Isolated Margin","href":"/docs/v5/position/cross-isolate","docId":"v5/position/cross-isolate"},{"type":"link","label":"Set TP/SL Mode","href":"/docs/v5/position/tpsl-mode","docId":"v5/position/tpsl-mode"},{"type":"link","label":"Switch Position Mode","href":"/docs/v5/position/position-mode","docId":"v5/position/position-mode"},{"type":"link","label":"Set Risk Limit (Depreciated)","href":"/docs/v5/position/set-risk-limit","docId":"v5/position/set-risk-limit"},{"type":"link","label":"Set Trading Stop","href":"/docs/v5/position/trading-stop","docId":"v5/position/trading-stop"},{"type":"link","label":"Set Auto Add Margin","href":"/docs/v5/position/auto-add-margin","docId":"v5/position/auto-add-margin"},{"type":"link","label":"Add Or Reduce Margin","href":"/docs/v5/position/manual-add-margin","docId":"v5/position/manual-add-margin"},{"type":"link","label":"Get Closed PnL (2 years)","href":"/docs/v5/position/close-pnl","docId":"v5/position/close-pnl"},{"type":"link","label":"Move Position","href":"/docs/v5/position/move-position","docId":"v5/position/move-position"},{"type":"link","label":"Get Move Position History","href":"/docs/v5/position/move-position-history","docId":"v5/position/move-position-history"},{"type":"link","label":"Confirm New Risk Limit","href":"/docs/v5/position/confirm-mmr","docId":"v5/position/confirm-mmr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Pre-upgrade","items":[{"type":"link","label":"Get Pre-upgrade Order History","href":"/docs/v5/pre-upgrade/order-list","docId":"v5/pre-upgrade/order-list"},{"type":"link","label":"Get Pre-upgrade Trade History","href":"/docs/v5/pre-upgrade/execution","docId":"v5/pre-upgrade/execution"},{"type":"link","label":"Get Pre-upgrade Closed PnL","href":"/docs/v5/pre-upgrade/close-pnl","docId":"v5/pre-upgrade/close-pnl"},{"type":"link","label":"Get Pre-upgrade Transaction Log","href":"/docs/v5/pre-upgrade/transaction-log","docId":"v5/pre-upgrade/transaction-log"},{"type":"link","label":"Get Pre-upgrade Option Delivery Record","href":"/docs/v5/pre-upgrade/delivery","docId":"v5/pre-upgrade/delivery"},{"type":"link","label":"Get Pre-upgrade USDC Session Settlement","href":"/docs/v5/pre-upgrade/settlement","docId":"v5/pre-upgrade/settlement"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Account","items":[{"type":"link","label":"Get Wallet Balance","href":"/docs/v5/account/wallet-balance","docId":"v5/account/wallet-balance"},{"type":"link","label":"Upgrade to Unified Account","href":"/docs/v5/account/upgrade-unified-account","docId":"v5/account/upgrade-unified-account"},{"type":"link","label":"Get Borrow History (2 years)","href":"/docs/v5/account/borrow-history","docId":"v5/account/borrow-history"},{"type":"link","label":"Repay Liability","href":"/docs/v5/account/repay-liability","docId":"v5/account/repay-liability"},{"type":"link","label":"Set Collateral Coin","href":"/docs/v5/account/set-collateral","docId":"v5/account/set-collateral"},{"type":"link","label":"Batch Set Collateral Coin","href":"/docs/v5/account/batch-set-collateral","docId":"v5/account/batch-set-collateral"},{"type":"link","label":"Get Collateral Info","href":"/docs/v5/account/collateral-info","docId":"v5/account/collateral-info"},{"type":"link","label":"Get Coin Greeks","href":"/docs/v5/account/coin-greeks","docId":"v5/account/coin-greeks"},{"type":"link","label":"Get Fee Rate","href":"/docs/v5/account/fee-rate","docId":"v5/account/fee-rate"},{"type":"link","label":"Get Account Info","href":"/docs/v5/account/account-info","docId":"v5/account/account-info"},{"type":"link","label":"Get DCP Info","href":"/docs/v5/account/dcp-info","docId":"v5/account/dcp-info"},{"type":"link","label":"Get Transaction Log (UTA)","href":"/docs/v5/account/transaction-log","docId":"v5/account/transaction-log"},{"type":"link","label":"Get Transaction Log (Classic)","href":"/docs/v5/account/contract-transaction-log","docId":"v5/account/contract-transaction-log"},{"type":"link","label":"Get SMP Group ID","href":"/docs/v5/account/smp-group","docId":"v5/account/smp-group"},{"type":"link","label":"Set Margin Mode","href":"/docs/v5/account/set-margin-mode","docId":"v5/account/set-margin-mode"},{"type":"link","label":"Set Spot Hedging","href":"/docs/v5/account/set-spot-hedge","docId":"v5/account/set-spot-hedge"},{"type":"link","label":"Set MMP","href":"/docs/v5/account/set-mmp","docId":"v5/account/set-mmp"},{"type":"link","label":"Reset MMP","href":"/docs/v5/account/reset-mmp","docId":"v5/account/reset-mmp"},{"type":"link","label":"Get MMP State","href":"/docs/v5/account/get-mmp-state","docId":"v5/account/get-mmp-state"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Asset","items":[{"type":"link","label":"Get Delivery Record (2 years)","href":"/docs/v5/asset/delivery","docId":"v5/asset/delivery"},{"type":"link","label":"Get USDC Session Settlement (2 years)","href":"/docs/v5/asset/settlement","docId":"v5/asset/settlement"},{"type":"link","label":"Get Coin Exchange Records","href":"/docs/v5/asset/exchange","docId":"v5/asset/exchange"},{"type":"link","label":"Get Coin Info","href":"/docs/v5/asset/coin-info","docId":"v5/asset/coin-info"},{"type":"link","label":"Get Sub UID","href":"/docs/v5/asset/sub-uid-list","docId":"v5/asset/sub-uid-list"},{"type":"category","label":"Balances","items":[{"type":"link","label":"Get Asset Info (Spot)","href":"/docs/v5/asset/balance/asset-info","docId":"v5/asset/balance/asset-info"},{"type":"link","label":"Get All Coins Balance","href":"/docs/v5/asset/balance/all-balance","docId":"v5/asset/balance/all-balance"},{"type":"link","label":"Get Single Coin Balance","href":"/docs/v5/asset/balance/account-coin-balance","docId":"v5/asset/balance/account-coin-balance"},{"type":"link","label":"Get Withdrawable Amount","href":"/docs/v5/asset/balance/delay-amount","docId":"v5/asset/balance/delay-amount"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Transfer","items":[{"type":"link","label":"Get Transferable Coin","href":"/docs/v5/asset/transfer/transferable-coin","docId":"v5/asset/transfer/transferable-coin"},{"type":"link","label":"Create Internal Transfer","href":"/docs/v5/asset/transfer/create-inter-transfer","docId":"v5/asset/transfer/create-inter-transfer"},{"type":"link","label":"Get Internal Transfer Records","href":"/docs/v5/asset/transfer/inter-transfer-list","docId":"v5/asset/transfer/inter-transfer-list"},{"type":"link","label":"Create Universal Transfer","href":"/docs/v5/asset/transfer/unitransfer","docId":"v5/asset/transfer/unitransfer"},{"type":"link","label":"Get Universal Transfer Records","href":"/docs/v5/asset/transfer/unitransfer-list","docId":"v5/asset/transfer/unitransfer-list"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Deposit","items":[{"type":"link","label":"Get Allowed Deposit Coin Info","href":"/docs/v5/asset/deposit/deposit-coin-spec","docId":"v5/asset/deposit/deposit-coin-spec"},{"type":"link","label":"Set Deposit Account","href":"/docs/v5/asset/deposit/set-deposit-acct","docId":"v5/asset/deposit/set-deposit-acct"},{"type":"link","label":"Get Deposit Records (on-chain)","href":"/docs/v5/asset/deposit/deposit-record","docId":"v5/asset/deposit/deposit-record"},{"type":"link","label":"Get Sub Deposit Records (on-chain)","href":"/docs/v5/asset/deposit/sub-deposit-record","docId":"v5/asset/deposit/sub-deposit-record"},{"type":"link","label":"Get Internal Deposit Records (off-chain)","href":"/docs/v5/asset/deposit/internal-deposit-record","docId":"v5/asset/deposit/internal-deposit-record"},{"type":"link","label":"Get Master Deposit Address","href":"/docs/v5/asset/deposit/master-deposit-addr","docId":"v5/asset/deposit/master-deposit-addr"},{"type":"link","label":"Get Sub Deposit Address","href":"/docs/v5/asset/deposit/sub-deposit-addr","docId":"v5/asset/deposit/sub-deposit-addr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Withdraw","items":[{"type":"link","label":"Get Withdrawal Records","href":"/docs/v5/asset/withdraw/withdraw-record","docId":"v5/asset/withdraw/withdraw-record"},{"type":"link","label":"Get Exchange Entity List (KOR)","href":"/docs/v5/asset/withdraw/vasp-list","docId":"v5/asset/withdraw/vasp-list"},{"type":"link","label":"Withdraw","href":"/docs/v5/asset/withdraw/","docId":"v5/asset/withdraw/withdraw"},{"type":"link","label":"Cancel Withdrawal","href":"/docs/v5/asset/withdraw/cancel-withdraw","docId":"v5/asset/withdraw/cancel-withdraw"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Convert","items":[{"type":"link","label":"Guideline","href":"/docs/v5/asset/convert/guideline","docId":"v5/asset/convert/guideline"},{"type":"link","label":"Get Convert Coin List","href":"/docs/v5/asset/convert/convert-coin-list","docId":"v5/asset/convert/convert-coin-list"},{"type":"link","label":"Request a Quote","href":"/docs/v5/asset/convert/apply-quote","docId":"v5/asset/convert/apply-quote"},{"type":"link","label":"Confirm a Quote","href":"/docs/v5/asset/convert/confirm-quote","docId":"v5/asset/convert/confirm-quote"},{"type":"link","label":"Get Convert Status","href":"/docs/v5/asset/convert/get-convert-result","docId":"v5/asset/convert/get-convert-result"},{"type":"link","label":"Get Convert history","href":"/docs/v5/asset/convert/get-convert-history","docId":"v5/asset/convert/get-convert-history"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"User","items":[{"type":"link","label":"Create Sub UID","href":"/docs/v5/user/create-subuid","docId":"v5/user/create-subuid"},{"type":"link","label":"Create Sub UID API Key","href":"/docs/v5/user/create-subuid-apikey","docId":"v5/user/create-subuid-apikey"},{"type":"link","label":"Get Sub UID List (Limited)","href":"/docs/v5/user/subuid-list","docId":"v5/user/subuid-list"},{"type":"link","label":"Get Sub UID List (Unlimited)","href":"/docs/v5/user/page-subuid","docId":"v5/user/page-subuid"},{"type":"link","label":"Freeze Sub UID","href":"/docs/v5/user/froze-subuid","docId":"v5/user/froze-subuid"},{"type":"link","label":"Get API Key Information","href":"/docs/v5/user/apikey-info","docId":"v5/user/apikey-info"},{"type":"link","label":"Get Sub Account All API Keys","href":"/docs/v5/user/list-sub-apikeys","docId":"v5/user/list-sub-apikeys"},{"type":"link","label":"Get UID Wallet Type","href":"/docs/v5/user/wallet-type","docId":"v5/user/wallet-type"},{"type":"link","label":"Modify Master API Key","href":"/docs/v5/user/modify-master-apikey","docId":"v5/user/modify-master-apikey"},{"type":"link","label":"Modify Sub API Key","href":"/docs/v5/user/modify-sub-apikey","docId":"v5/user/modify-sub-apikey"},{"type":"link","label":"Delete Sub UID","href":"/docs/v5/user/rm-subuid","docId":"v5/user/rm-subuid"},{"type":"link","label":"Delete Master API Key","href":"/docs/v5/user/rm-master-apikey","docId":"v5/user/rm-master-apikey"},{"type":"link","label":"Delete Sub API Key","href":"/docs/v5/user/rm-sub-apikey","docId":"v5/user/rm-sub-apikey"},{"type":"link","label":"Get Affiliate User Info","href":"/docs/v5/user/affiliate-info","docId":"v5/user/affiliate-info"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Spot Leverage Token","items":[{"type":"link","label":"Get Leverage Token Info","href":"/docs/v5/lt/leverage-token-info","docId":"v5/lt/leverage-token-info"},{"type":"link","label":"Get Leveraged Token Market","href":"/docs/v5/lt/leverage-token-reference","docId":"v5/lt/leverage-token-reference"},{"type":"link","label":"Purchase","href":"/docs/v5/lt/purchase","docId":"v5/lt/purchase"},{"type":"link","label":"Redeem","href":"/docs/v5/lt/redeem","docId":"v5/lt/redeem"},{"type":"link","label":"Get Purchase/Redemption Records","href":"/docs/v5/lt/order-record","docId":"v5/lt/order-record"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Spot Margin Trade (UTA)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/v5/spot-margin-uta/vip-margin","docId":"v5/spot-margin-uta/vip-margin"},{"type":"link","label":"Get Historical Interest Rate","href":"/docs/v5/spot-margin-uta/historical-interest","docId":"v5/spot-margin-uta/historical-interest"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/v5/spot-margin-uta/switch-mode","docId":"v5/spot-margin-uta/switch-mode"},{"type":"link","label":"Set Leverage","href":"/docs/v5/spot-margin-uta/set-leverage","docId":"v5/spot-margin-uta/set-leverage"},{"type":"link","label":"Get Status And Leverage","href":"/docs/v5/spot-margin-uta/status","docId":"v5/spot-margin-uta/status"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Institutional Loan","items":[{"type":"link","label":"Get Product Info","href":"/docs/v5/otc/margin-product-info","docId":"v5/otc/margin-product-info"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/v5/otc/margin-coin-convert-info","docId":"v5/otc/margin-coin-convert-info"},{"type":"link","label":"Get Loan Orders","href":"/docs/v5/otc/loan-info","docId":"v5/otc/loan-info"},{"type":"link","label":"Get Repayment Orders","href":"/docs/v5/otc/repay-info","docId":"v5/otc/repay-info"},{"type":"link","label":"Get LTV","href":"/docs/v5/otc/ltv-convert","docId":"v5/otc/ltv-convert"},{"type":"link","label":"Bind Or Unbind UID","href":"/docs/v5/otc/bind-uid","docId":"v5/otc/bind-uid"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Broker","items":[{"type":"link","label":"Get Exchange Broker Earning","href":"/docs/v5/broker/exchange-earning","docId":"v5/broker/exchange-earning"},{"type":"link","label":"Get Exchange Broker Account Info","href":"/docs/v5/broker/account-info","docId":"v5/broker/account-info"},{"type":"link","label":"Get Sub Account Deposit Records","href":"/docs/v5/broker/sub-deposit-record","docId":"v5/broker/sub-deposit-record"}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket Stream","items":[{"type":"link","label":"Connect","href":"/docs/v5/ws/connect","docId":"v5/websocket/wss-authentication"},{"type":"category","label":"Public","items":[{"type":"link","label":"Orderbook","href":"/docs/v5/websocket/public/orderbook","docId":"v5/websocket/public/orderbook"},{"type":"link","label":"Trade","href":"/docs/v5/websocket/public/trade","docId":"v5/websocket/public/trade"},{"type":"link","label":"Ticker","href":"/docs/v5/websocket/public/ticker","docId":"v5/websocket/public/ticker"},{"type":"link","label":"Kline","href":"/docs/v5/websocket/public/kline","docId":"v5/websocket/public/kline"},{"type":"link","label":"Liquidation","href":"/docs/v5/websocket/public/liquidation","docId":"v5/websocket/public/liquidation"},{"type":"link","label":"LT Kline","href":"/docs/v5/websocket/public/etp-kline","docId":"v5/websocket/public/etp-kline"},{"type":"link","label":"LT Ticker","href":"/docs/v5/websocket/public/etp-ticker","docId":"v5/websocket/public/etp-ticker"},{"type":"link","label":"LT Nav","href":"/docs/v5/websocket/public/etp-nav","docId":"v5/websocket/public/etp-nav"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Private","items":[{"type":"link","label":"Position","href":"/docs/v5/websocket/private/position","docId":"v5/websocket/private/position"},{"type":"link","label":"Execution","href":"/docs/v5/websocket/private/execution","docId":"v5/websocket/private/execution"},{"type":"link","label":"Fast Execution","href":"/docs/v5/websocket/private/fast-execution","docId":"v5/websocket/private/fast-execution"},{"type":"link","label":"Order","href":"/docs/v5/websocket/private/order","docId":"v5/websocket/private/order"},{"type":"link","label":"Wallet","href":"/docs/v5/websocket/private/wallet","docId":"v5/websocket/private/wallet"},{"type":"link","label":"Greek","href":"/docs/v5/websocket/private/greek","docId":"v5/websocket/private/greek"},{"type":"link","label":"Dcp","href":"/docs/v5/websocket/private/dcp","docId":"v5/websocket/private/dcp"}],"collapsed":true,"collapsible":true},{"type":"category","label":"Trade","items":[{"type":"link","label":"Websocket Trade Guideline","href":"/docs/v5/websocket/trade/guideline","docId":"v5/websocket/trade/guideline"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"Rate Limit","href":"/docs/v5/rate-limit","docId":"v5/rate-limit"},{"type":"link","label":"Enums Definitions","href":"/docs/v5/enum","docId":"v5/enum"},{"type":"link","label":"Error Codes","href":"/docs/v5/error","docId":"v5/error"},{"type":"category","label":"Abandoned Endpoints","items":[{"type":"link","label":"Get Lending Coin Info","href":"/docs/v5/abandon/coin-info","docId":"v5/abandon/coin-info"},{"type":"link","label":"Get LTV","href":"/docs/v5/abandon/ltv","docId":"v5/abandon/ltv"},{"type":"link","label":"Deposit Funds","href":"/docs/v5/abandon/deposit","docId":"v5/abandon/deposit"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/v5/abandon/margin-coin-info","docId":"v5/abandon/margin-coin-info"},{"type":"link","label":"Enable Universal Transfer for Sub UID","href":"/docs/v5/abandon/enable-unitransfer-subuid","docId":"v5/abandon/enable-unitransfer-subuid"},{"type":"link","label":"Redeem Funds","href":"/docs/v5/abandon/redeem","docId":"v5/abandon/redeem"},{"type":"link","label":"Cancel Redeem","href":"/docs/v5/abandon/cancel-redeem","docId":"v5/abandon/cancel-redeem"},{"type":"link","label":"Get Broker Earning","href":"/docs/v5/abandon/earning","docId":"v5/abandon/earning"},{"type":"link","label":"Get Order Records","href":"/docs/v5/abandon/order-record","docId":"v5/abandon/order-record"},{"type":"link","label":"Get Lending Account Info","href":"/docs/v5/abandon/account-info","docId":"v5/abandon/account-info"}],"collapsed":true,"collapsible":true}],"apiExplorerSideBar":[{"type":"category","label":"V5","items":[{"type":"category","label":"Market","items":[{"type":"link","label":"Get Bybit Server Time","href":"/docs/api-explorer/v5/market/time","className":"api-method get","docId":"api-explorer/v5/market/time"},{"type":"link","label":"Get Kline","href":"/docs/api-explorer/v5/market/kline","className":"api-method get","docId":"api-explorer/v5/market/kline"},{"type":"link","label":"Get Mark Price Kline","href":"/docs/api-explorer/v5/market/mark-kline","className":"api-method get","docId":"api-explorer/v5/market/mark-kline"},{"type":"link","label":"Get Index Price Kline","href":"/docs/api-explorer/v5/market/index-kline","className":"api-method get","docId":"api-explorer/v5/market/index-kline"},{"type":"link","label":"Get Premium Index Price Kline","href":"/docs/api-explorer/v5/market/premium-index-kline","className":"api-method get","docId":"api-explorer/v5/market/premium-index-kline"},{"type":"link","label":"Get Instrument Info","href":"/docs/api-explorer/v5/market/instrument","className":"api-method get","docId":"api-explorer/v5/market/instrument"},{"type":"link","label":"Get Orderbook","href":"/docs/api-explorer/v5/market/orderbook","className":"api-method get","docId":"api-explorer/v5/market/orderbook"},{"type":"link","label":"Get Tickers","href":"/docs/api-explorer/v5/market/tickers","className":"api-method get","docId":"api-explorer/v5/market/tickers"},{"type":"link","label":"Get Funding Rate History","href":"/docs/api-explorer/v5/market/history-fund-rate","className":"api-method get","docId":"api-explorer/v5/market/history-fund-rate"},{"type":"link","label":"Get Public Recent Trading History","href":"/docs/api-explorer/v5/market/recent-trade","className":"api-method get","docId":"api-explorer/v5/market/recent-trade"},{"type":"link","label":"Get Open Interest","href":"/docs/api-explorer/v5/market/open-interest","className":"api-method get","docId":"api-explorer/v5/market/open-interest"},{"type":"link","label":"Get Historical Volatility","href":"/docs/api-explorer/v5/market/iv","className":"api-method get","docId":"api-explorer/v5/market/iv"},{"type":"link","label":"Get Insurance","href":"/docs/api-explorer/v5/market/insurance","className":"api-method get","docId":"api-explorer/v5/market/insurance"},{"type":"link","label":"Get Risk Limit","href":"/docs/api-explorer/v5/market/risk-limit","className":"api-method get","docId":"api-explorer/v5/market/risk-limit"},{"type":"link","label":"Get Delivery Price","href":"/docs/api-explorer/v5/market/delivery-price","className":"api-method get","docId":"api-explorer/v5/market/delivery-price"},{"type":"link","label":"Get Long Short Ratio","href":"/docs/api-explorer/v5/market/long-short-ratio","className":"api-method get","docId":"api-explorer/v5/market/long-short-ratio"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/market/market"},{"type":"category","label":"Trade","items":[{"type":"link","label":"Place Order","href":"/docs/api-explorer/v5/trade/create-order","className":"api-method post","docId":"api-explorer/v5/trade/create-order"},{"type":"link","label":"Amend Order","href":"/docs/api-explorer/v5/trade/amend-order","className":"api-method post","docId":"api-explorer/v5/trade/amend-order"},{"type":"link","label":"Cancel Order","href":"/docs/api-explorer/v5/trade/cancel-order","className":"api-method post","docId":"api-explorer/v5/trade/cancel-order"},{"type":"link","label":"Get Open Orders (real-time)","href":"/docs/api-explorer/v5/trade/open-order","className":"api-method get","docId":"api-explorer/v5/trade/open-order"},{"type":"link","label":"Cancel All Orders","href":"/docs/api-explorer/v5/trade/cancel-all","className":"api-method post","docId":"api-explorer/v5/trade/cancel-all"},{"type":"link","label":"Get Order History (2 years)","href":"/docs/api-explorer/v5/trade/order-list","className":"api-method get","docId":"api-explorer/v5/trade/order-list"},{"type":"link","label":"Batch Place Order","href":"/docs/api-explorer/v5/trade/batch-place","className":"api-method post","docId":"api-explorer/v5/trade/batch-place"},{"type":"link","label":"Batch Amend Order","href":"/docs/api-explorer/v5/trade/batch-amend","className":"api-method post","docId":"api-explorer/v5/trade/batch-amend"},{"type":"link","label":"Batch Cancel Order","href":"/docs/api-explorer/v5/trade/batch-cancel","className":"api-method post","docId":"api-explorer/v5/trade/batch-cancel"},{"type":"link","label":"Get Borrow Quota (Spot)","href":"/docs/api-explorer/v5/trade/query-spot-quota","className":"api-method get","docId":"api-explorer/v5/trade/query-spot-quota"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/trade/trade"},{"type":"category","label":"Position","items":[{"type":"link","label":"Get Position Info","href":"/docs/api-explorer/v5/position/position-info","className":"api-method get","docId":"api-explorer/v5/position/position-info"},{"type":"link","label":"Set Leverage","href":"/docs/api-explorer/v5/position/leverage","className":"api-method post","docId":"api-explorer/v5/position/leverage"},{"type":"link","label":"Switch Cross/Isolated Margin","href":"/docs/api-explorer/v5/position/cross-isolate","className":"api-method post","docId":"api-explorer/v5/position/cross-isolate"},{"type":"link","label":"Set TP/SL Mode","href":"/docs/api-explorer/v5/position/tpsl-mode","className":"api-method post","docId":"api-explorer/v5/position/tpsl-mode"},{"type":"link","label":"Switch Position Mode","href":"/docs/api-explorer/v5/position/position-mode","className":"api-method post","docId":"api-explorer/v5/position/position-mode"},{"type":"link","label":"Set Risk Limit","href":"/docs/api-explorer/v5/position/set-risk-limit","className":"api-method post","docId":"api-explorer/v5/position/set-risk-limit"},{"type":"link","label":"Set Trading Stop","href":"/docs/api-explorer/v5/position/trading-stop","className":"api-method post","docId":"api-explorer/v5/position/trading-stop"},{"type":"link","label":"Set Auto Add Margin","href":"/docs/api-explorer/v5/position/auto-add-margin","className":"api-method post","docId":"api-explorer/v5/position/auto-add-margin"},{"type":"link","label":"Add Or Reduce Margin","href":"/docs/api-explorer/v5/position/manual-add-margin","className":"api-method post","docId":"api-explorer/v5/position/manual-add-margin"},{"type":"link","label":"Get Execution (2 years)","href":"/docs/api-explorer/v5/position/execution","className":"api-method get","docId":"api-explorer/v5/position/execution"},{"type":"link","label":"Get Closed PnL","href":"/docs/api-explorer/v5/position/close-pnl","className":"api-method get","docId":"api-explorer/v5/position/close-pnl"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/position/position"},{"type":"category","label":"Account","items":[{"type":"link","label":"Get Wallet Balance","href":"/docs/api-explorer/v5/account/wallet","className":"api-method get","docId":"api-explorer/v5/account/wallet"},{"type":"link","label":"Upgrade to Unified Account","href":"/docs/api-explorer/v5/account/upgrade-unified-account","className":"api-method post","docId":"api-explorer/v5/account/upgrade-unified-account"},{"type":"link","label":"Set Collateral Coin","href":"/docs/api-explorer/v5/account/set-collateral","className":"api-method post","docId":"api-explorer/v5/account/set-collateral"},{"type":"link","label":"Get Borrow History","href":"/docs/api-explorer/v5/account/borrow-history","className":"api-method get","docId":"api-explorer/v5/account/borrow-history"},{"type":"link","label":"Get Collateral Info","href":"/docs/api-explorer/v5/account/collateral-info","className":"api-method get","docId":"api-explorer/v5/account/collateral-info"},{"type":"link","label":"Get Coin Greeks","href":"/docs/api-explorer/v5/account/coin-greeks","className":"api-method get","docId":"api-explorer/v5/account/coin-greeks"},{"type":"link","label":"Get Fee Rate","href":"/docs/api-explorer/v5/account/fee-rate","className":"api-method get","docId":"api-explorer/v5/account/fee-rate"},{"type":"link","label":"Get Account Info","href":"/docs/api-explorer/v5/account/account-info","className":"api-method get","docId":"api-explorer/v5/account/account-info"},{"type":"link","label":"Get Transaction Log","href":"/docs/api-explorer/v5/account/transaction-log","className":"api-method get","docId":"api-explorer/v5/account/transaction-log"},{"type":"link","label":"Set Margin Mode","href":"/docs/api-explorer/v5/account/set-margin-mode","className":"api-method post","docId":"api-explorer/v5/account/set-margin-mode"},{"type":"link","label":"Set Spot Hedging","href":"/docs/api-explorer/v5/account/set-spot-hedge","className":"api-method post","docId":"api-explorer/v5/account/set-spot-hedge"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/account/account"},{"type":"category","label":"Asset","items":[{"type":"link","label":"Get Coin Exchange Records","href":"/docs/api-explorer/v5/asset/exchange","className":"api-method get","docId":"api-explorer/v5/asset/exchange"},{"type":"link","label":"Get Delivery Record","href":"/docs/api-explorer/v5/asset/delivery","className":"api-method get","docId":"api-explorer/v5/asset/delivery"},{"type":"link","label":"Get USDC Session Settlement","href":"/docs/api-explorer/v5/asset/settlement","className":"api-method get","docId":"api-explorer/v5/asset/settlement"},{"type":"link","label":"Get Asset Info (Spot)","href":"/docs/api-explorer/v5/asset/asset-info","className":"api-method get","docId":"api-explorer/v5/asset/asset-info"},{"type":"link","label":"Get All Coins Balance","href":"/docs/api-explorer/v5/asset/all-balance","className":"api-method get","docId":"api-explorer/v5/asset/all-balance"},{"type":"link","label":"Get Single Coin Balance","href":"/docs/api-explorer/v5/asset/account-coin-balance","className":"api-method get","docId":"api-explorer/v5/asset/account-coin-balance"},{"type":"link","label":"Get Transferable Coin","href":"/docs/api-explorer/v5/asset/transferable-coin","className":"api-method get","docId":"api-explorer/v5/asset/transferable-coin"},{"type":"link","label":"Create Internal Transfer","href":"/docs/api-explorer/v5/asset/create-inter-transfer","className":"api-method post","docId":"api-explorer/v5/asset/create-inter-transfer"},{"type":"link","label":"Get Internal Transfer Records","href":"/docs/api-explorer/v5/asset/inter-transfer-list","className":"api-method get","docId":"api-explorer/v5/asset/inter-transfer-list"},{"type":"link","label":"Get Sub UID","href":"/docs/api-explorer/v5/asset/sub-uid-list","className":"api-method get","docId":"api-explorer/v5/asset/sub-uid-list"},{"type":"link","label":"Create Universal Transfer","href":"/docs/api-explorer/v5/asset/unitransfer","className":"api-method post","docId":"api-explorer/v5/asset/unitransfer"},{"type":"link","label":"Get Universal Transfer Records","href":"/docs/api-explorer/v5/asset/unitransfer-list","className":"api-method get","docId":"api-explorer/v5/asset/unitransfer-list"},{"type":"link","label":"Get Allowed Deposit Coin Info","href":"/docs/api-explorer/v5/asset/deposit-coin-spec","className":"api-method get","docId":"api-explorer/v5/asset/deposit-coin-spec"},{"type":"link","label":"Set Deposit Account","href":"/docs/api-explorer/v5/asset/set-deposit-acct","className":"api-method post","docId":"api-explorer/v5/asset/set-deposit-acct"},{"type":"link","label":"Get Deposit Record (on-chain)","href":"/docs/api-explorer/v5/asset/deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/deposit-record"},{"type":"link","label":"Get Sub Account Deposit Records (on-chain)","href":"/docs/api-explorer/v5/asset/sub-deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/sub-deposit-record"},{"type":"link","label":"Get Internal Deposit Records (off-chain)","href":"/docs/api-explorer/v5/asset/internal-deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/internal-deposit-record"},{"type":"link","label":"Get Master Deposit Address","href":"/docs/api-explorer/v5/asset/master-deposit-addr","className":"api-method get","docId":"api-explorer/v5/asset/master-deposit-addr"},{"type":"link","label":"Get Sub Deposit Address","href":"/docs/api-explorer/v5/asset/sub-deposit-addr","className":"api-method get","docId":"api-explorer/v5/asset/sub-deposit-addr"},{"type":"link","label":"Get Coin Info","href":"/docs/api-explorer/v5/asset/coin-info","className":"api-method get","docId":"api-explorer/v5/asset/coin-info"},{"type":"link","label":"Get Withdraw Records","href":"/docs/api-explorer/v5/asset/withdraw-record","className":"api-method get","docId":"api-explorer/v5/asset/withdraw-record"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/asset/asset"},{"type":"category","label":"User","items":[{"type":"link","label":"Get API Key Information","href":"/docs/api-explorer/v5/user/apikey-info","className":"api-method get","docId":"api-explorer/v5/user/apikey-info"},{"type":"link","label":"Get Sub Account All API Keys","href":"/docs/api-explorer/v5/user/list-sub-apikeys","className":"api-method get","docId":"api-explorer/v5/user/list-sub-apikeys"},{"type":"link","label":"Get UID Wallet Type","href":"/docs/api-explorer/v5/user/wallet-type","className":"api-method get","docId":"api-explorer/v5/user/wallet-type"},{"type":"link","label":"Get Affiliate User Info","href":"/docs/api-explorer/v5/user/affiliate-info","className":"api-method get","docId":"api-explorer/v5/user/affiliate-info"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/user/user"},{"type":"category","label":"Spot Leverage Token","items":[{"type":"link","label":"Get Leverage Token Info","href":"/docs/api-explorer/v5/lt/leverage-token-info","className":"api-method get","docId":"api-explorer/v5/lt/leverage-token-info"},{"type":"link","label":"Get Leverage Token Market","href":"/docs/api-explorer/v5/lt/leverage-token-reference","className":"api-method get","docId":"api-explorer/v5/lt/leverage-token-reference"},{"type":"link","label":"Purchase","href":"/docs/api-explorer/v5/lt/purchase","className":"api-method post","docId":"api-explorer/v5/lt/purchase"},{"type":"link","label":"Redeem","href":"/docs/api-explorer/v5/lt/redeem","className":"api-method post","docId":"api-explorer/v5/lt/redeem"},{"type":"link","label":"Get Purchase or Redeem Records","href":"/docs/api-explorer/v5/lt/order-record","className":"api-method get","docId":"api-explorer/v5/lt/order-record"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/lt/etp"},{"type":"category","label":"Spot Margin Trade (UTA)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/api-explorer/v5/spot-margin-uta/vip-margin","className":"api-method get","docId":"api-explorer/v5/spot-margin-uta/vip-margin"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/api-explorer/v5/spot-margin-uta/switch-mode","className":"api-method post","docId":"api-explorer/v5/spot-margin-uta/switch-mode"},{"type":"link","label":"Set Leverage","href":"/docs/api-explorer/v5/spot-margin-uta/set-leverage","className":"api-method post","docId":"api-explorer/v5/spot-margin-uta/set-leverage"},{"type":"link","label":"Get Status And Leverage","href":"/docs/api-explorer/v5/spot-margin-uta/status","className":"api-method get","docId":"api-explorer/v5/spot-margin-uta/status"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/spot-margin-uta/uta-margin-trade"},{"type":"category","label":"Spot Margin Trade (Classic)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/api-explorer/v5/spot-margin-normal/vip-margin","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/vip-margin"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/api-explorer/v5/spot-margin-normal/margin-data","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/margin-data"},{"type":"link","label":"Get Borrowable Coin Info","href":"/docs/api-explorer/v5/spot-margin-normal/borrowable-data","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/borrowable-data"},{"type":"link","label":"Get Interest & Quota","href":"/docs/api-explorer/v5/spot-margin-normal/interest-quota","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/interest-quota"},{"type":"link","label":"Get Loan Account Info","href":"/docs/api-explorer/v5/spot-margin-normal/account-info","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/account-info"},{"type":"link","label":"Borrow","href":"/docs/api-explorer/v5/spot-margin-normal/borrow","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/borrow"},{"type":"link","label":"Repay","href":"/docs/api-explorer/v5/spot-margin-normal/repay","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/repay"},{"type":"link","label":"Get Borrow Order Detail","href":"/docs/api-explorer/v5/spot-margin-normal/borrow-order","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/borrow-order"},{"type":"link","label":"Get Repayment Order Detail","href":"/docs/api-explorer/v5/spot-margin-normal/repay-order","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/repay-order"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/api-explorer/v5/spot-margin-normal/switch-mode","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/switch-mode"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/spot-margin-normal/normal-margin-trade"}],"collapsed":true,"collapsible":true,"href":"/docs/api-explorer/v5/category/"}],"changelogSidebar":[{"type":"link","label":"V5","href":"/docs/changelog/v5","docId":"changelog/v5"},{"type":"link","label":"Derivatives V3","href":"/docs/changelog/derivatives-v3","docId":"changelog/derivatives-v3"},{"type":"link","label":"Spot V3","href":"/docs/changelog/spot-v3","docId":"changelog/spot-v3"},{"type":"link","label":"Account Asset V3","href":"/docs/changelog/asset-v3","docId":"changelog/asset-v3"},{"type":"link","label":"Copy Trading","href":"/docs/changelog/copytrade","docId":"changelog/copytrade"}]},"docs":{"api-explorer/v5/account/account":{"id":"api-explorer/v5/account/account","title":"Account","description":"Account","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/account-info":{"id":"api-explorer/v5/account/account-info","title":"Get Account Info","description":"Get account info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/borrow-history":{"id":"api-explorer/v5/account/borrow-history","title":"Get Borrow History","description":"Get borrow history","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/coin-greeks":{"id":"api-explorer/v5/account/coin-greeks","title":"Get Coin Greeks","description":"Get coin greek info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/collateral-info":{"id":"api-explorer/v5/account/collateral-info","title":"Get Collateral Info","description":"Get collateral info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/fee-rate":{"id":"api-explorer/v5/account/fee-rate","title":"Get Fee Rate","description":"Get fee rate","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-collateral":{"id":"api-explorer/v5/account/set-collateral","title":"Set Collateral Coin","description":"Set collateral coin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-margin-mode":{"id":"api-explorer/v5/account/set-margin-mode","title":"Set Margin Mode","description":"Set margin mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-spot-hedge":{"id":"api-explorer/v5/account/set-spot-hedge","title":"Set Spot Hedging","description":"Set spot hedging for Portfolio margin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/transaction-log":{"id":"api-explorer/v5/account/transaction-log","title":"Get Transaction Log","description":"Get transaction log","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/upgrade-unified-account":{"id":"api-explorer/v5/account/upgrade-unified-account","title":"Upgrade to Unified Account","description":"Upgrade to UTA","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/wallet":{"id":"api-explorer/v5/account/wallet","title":"Get Wallet Balance","description":"Get wallet balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/account-coin-balance":{"id":"api-explorer/v5/asset/account-coin-balance","title":"Get Single Coin Balance","description":"Get Single Coin Balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/all-balance":{"id":"api-explorer/v5/asset/all-balance","title":"Get All Coins Balance","description":"Get All Coins Balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/asset":{"id":"api-explorer/v5/asset/asset","title":"Asset","description":"Asset","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/asset-info":{"id":"api-explorer/v5/asset/asset-info","title":"Get Asset Info (Spot)","description":"Get spot asset","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/coin-info":{"id":"api-explorer/v5/asset/coin-info","title":"Get Coin Info","description":"Get coin info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/create-inter-transfer":{"id":"api-explorer/v5/asset/create-inter-transfer","title":"Create Internal Transfer","description":"Create internal transfer","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/delivery":{"id":"api-explorer/v5/asset/delivery","title":"Get Delivery Record","description":"Get delivery record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/deposit-coin-spec":{"id":"api-explorer/v5/asset/deposit-coin-spec","title":"Get Allowed Deposit Coin Info","description":"Get allowed deposit coin info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/deposit-record":{"id":"api-explorer/v5/asset/deposit-record","title":"Get Deposit Record (on-chain)","description":"Get deposit record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/exchange":{"id":"api-explorer/v5/asset/exchange","title":"Get Coin Exchange Records","description":"Get exchange records","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/inter-transfer-list":{"id":"api-explorer/v5/asset/inter-transfer-list","title":"Get Internal Transfer Records","description":"Get internal transfer records","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/internal-deposit-record":{"id":"api-explorer/v5/asset/internal-deposit-record","title":"Get Internal Deposit Records (off-chain)","description":"Get deposit records through Bybit platform","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/master-deposit-addr":{"id":"api-explorer/v5/asset/master-deposit-addr","title":"Get Master Deposit Address","description":"Get master deposit address","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/set-deposit-acct":{"id":"api-explorer/v5/asset/set-deposit-acct","title":"Set Deposit Account","description":"Set Deposit Account","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/settlement":{"id":"api-explorer/v5/asset/settlement","title":"Get USDC Session Settlement","description":"Get usdc session settlement record.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-deposit-addr":{"id":"api-explorer/v5/asset/sub-deposit-addr","title":"Get Sub Deposit Address","description":"Get sub deposit address","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-deposit-record":{"id":"api-explorer/v5/asset/sub-deposit-record","title":"Get Sub Account Deposit Records (on-chain)","description":"Get sub account deposit record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-uid-list":{"id":"api-explorer/v5/asset/sub-uid-list","title":"Get Sub UID","description":"Get sub uid","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/transferable-coin":{"id":"api-explorer/v5/asset/transferable-coin","title":"Get Transferable Coin","description":"Get transferable coins","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/unitransfer":{"id":"api-explorer/v5/asset/unitransfer","title":"Create Universal Transfer","description":"Create universal transfer","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/unitransfer-list":{"id":"api-explorer/v5/asset/unitransfer-list","title":"Get Universal Transfer Records","description":"Get universal transfer record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/withdraw-record":{"id":"api-explorer/v5/asset/withdraw-record","title":"Get Withdraw Records","description":"Get withdraw record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/etp":{"id":"api-explorer/v5/lt/etp","title":"Spot Leverage Token","description":"Spot Leverage Token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/leverage-token-info":{"id":"api-explorer/v5/lt/leverage-token-info","title":"Get Leverage Token Info","description":"Get lt information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/leverage-token-reference":{"id":"api-explorer/v5/lt/leverage-token-reference","title":"Get Leverage Token Market","description":"Get lt market information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/order-record":{"id":"api-explorer/v5/lt/order-record","title":"Get Purchase or Redeem Records","description":"Get the order history of purchase or redeem","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/purchase":{"id":"api-explorer/v5/lt/purchase","title":"Purchase","description":"Purchase leverage token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/redeem":{"id":"api-explorer/v5/lt/redeem","title":"Redeem","description":"Redeem leverage token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/delivery-price":{"id":"api-explorer/v5/market/delivery-price","title":"Get Delivery Price","description":"Get delivery price","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/history-fund-rate":{"id":"api-explorer/v5/market/history-fund-rate","title":"Get Funding Rate History","description":"Get historical funding rate","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/index-kline":{"id":"api-explorer/v5/market/index-kline","title":"Get Index Price Kline","description":"Get Index Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/instrument":{"id":"api-explorer/v5/market/instrument","title":"Get Instrument Info","description":"Get launched instruments information.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/insurance":{"id":"api-explorer/v5/market/insurance","title":"Get Insurance","description":"Get Insurance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/iv":{"id":"api-explorer/v5/market/iv","title":"Get Historical Volatility","description":"Get historical volatility","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/kline":{"id":"api-explorer/v5/market/kline","title":"Get Kline","description":"Get kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/long-short-ratio":{"id":"api-explorer/v5/market/long-short-ratio","title":"Get Long Short Ratio","description":"Get long short ratio","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/mark-kline":{"id":"api-explorer/v5/market/mark-kline","title":"Get Mark Price Kline","description":"Get Mark Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/market":{"id":"api-explorer/v5/market/market","title":"Market","description":"Market","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/open-interest":{"id":"api-explorer/v5/market/open-interest","title":"Get Open Interest","description":"Get open interest","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/orderbook":{"id":"api-explorer/v5/market/orderbook","title":"Get Orderbook","description":"Get order book data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/premium-index-kline":{"id":"api-explorer/v5/market/premium-index-kline","title":"Get Premium Index Price Kline","description":"Get Premium Index Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/recent-trade":{"id":"api-explorer/v5/market/recent-trade","title":"Get Public Recent Trading History","description":"Get public trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/risk-limit":{"id":"api-explorer/v5/market/risk-limit","title":"Get Risk Limit","description":"Get risk limit","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/tickers":{"id":"api-explorer/v5/market/tickers","title":"Get Tickers","description":"Get all latest information of symbols. All parameters are needed for OPTION","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/time":{"id":"api-explorer/v5/market/time","title":"Get Bybit Server Time","description":"Get server time","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/auto-add-margin":{"id":"api-explorer/v5/position/auto-add-margin","title":"Set Auto Add Margin","description":"Set Auto Add Margin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/close-pnl":{"id":"api-explorer/v5/position/close-pnl","title":"Get Closed PnL","description":"Get closed pnl","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/cross-isolate":{"id":"api-explorer/v5/position/cross-isolate","title":"Switch Cross/Isolated Margin","description":"Select cross margin mode or isolated margin mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/execution":{"id":"api-explorer/v5/position/execution","title":"Get Execution (2 years)","description":"Get execution list","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/leverage":{"id":"api-explorer/v5/position/leverage","title":"Set Leverage","description":"Set levearage.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/manual-add-margin":{"id":"api-explorer/v5/position/manual-add-margin","title":"Add Or Reduce Margin","description":"Manually add or reduce margin for isolated margin position","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position":{"id":"api-explorer/v5/position/position","title":"Position","description":"Position","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position-info":{"id":"api-explorer/v5/position/position-info","title":"Get Position Info","description":"Get Position Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position-mode":{"id":"api-explorer/v5/position/position-mode","title":"Switch Position Mode","description":"Switch Position Mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/set-risk-limit":{"id":"api-explorer/v5/position/set-risk-limit","title":"Set Risk Limit","description":"Set risk limit.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/tpsl-mode":{"id":"api-explorer/v5/position/tpsl-mode","title":"Set TP/SL Mode","description":"Set tp/sl mode.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/trading-stop":{"id":"api-explorer/v5/position/trading-stop","title":"Set Trading Stop","description":"Set trade stop.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/account-info":{"id":"api-explorer/v5/spot-margin-normal/account-info","title":"Get Loan Account Info","description":"Get Loan Account Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrow":{"id":"api-explorer/v5/spot-margin-normal/borrow","title":"Borrow","description":"Borrow","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrow-order":{"id":"api-explorer/v5/spot-margin-normal/borrow-order","title":"Get Borrow Order Detail","description":"Get Borrow Order Detail","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrowable-data":{"id":"api-explorer/v5/spot-margin-normal/borrowable-data","title":"Get Borrowable Coin Info","description":"Get Borrowable Coin Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/interest-quota":{"id":"api-explorer/v5/spot-margin-normal/interest-quota","title":"Get Interest & Quota","description":"Get Interest & Quota","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/margin-data":{"id":"api-explorer/v5/spot-margin-normal/margin-data","title":"Get Margin Coin Info","description":"Get Margin Coin Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/normal-margin-trade":{"id":"api-explorer/v5/spot-margin-normal/normal-margin-trade","title":"Spot Margin Trade (Classic)","description":"Spot Margin Trade (Classic)","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/repay":{"id":"api-explorer/v5/spot-margin-normal/repay","title":"Repay","description":"Repay","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/repay-order":{"id":"api-explorer/v5/spot-margin-normal/repay-order","title":"Get Repayment Order Detail","description":"Get Repayment Order Detail","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/switch-mode":{"id":"api-explorer/v5/spot-margin-normal/switch-mode","title":"Toggle Margin Trade","description":"Toggle Margin Trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/vip-margin":{"id":"api-explorer/v5/spot-margin-normal/vip-margin","title":"Get VIP Margin Data","description":"Get vip margin data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/set-leverage":{"id":"api-explorer/v5/spot-margin-uta/set-leverage","title":"Set Leverage","description":"Set leverage for margin trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/status":{"id":"api-explorer/v5/spot-margin-uta/status","title":"Get Status And Leverage","description":"Get status and leverage","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/switch-mode":{"id":"api-explorer/v5/spot-margin-uta/switch-mode","title":"Toggle Margin Trade","description":"Toggle margin trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/uta-margin-trade":{"id":"api-explorer/v5/spot-margin-uta/uta-margin-trade","title":"Spot Margin Trade (UTA)","description":"Spot Margin Trade (UTA)","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/vip-margin":{"id":"api-explorer/v5/spot-margin-uta/vip-margin","title":"Get VIP Margin Data","description":"Get vip margin data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/amend-order":{"id":"api-explorer/v5/trade/amend-order","title":"Amend Order","description":"Amend an order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-amend":{"id":"api-explorer/v5/trade/batch-amend","title":"Batch Amend Order","description":"Batch amend orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-cancel":{"id":"api-explorer/v5/trade/batch-cancel","title":"Batch Cancel Order","description":"Batch cancel orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-place":{"id":"api-explorer/v5/trade/batch-place","title":"Batch Place Order","description":"Batch place orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/cancel-all":{"id":"api-explorer/v5/trade/cancel-all","title":"Cancel All Orders","description":"Cancel all orders.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/cancel-order":{"id":"api-explorer/v5/trade/cancel-order","title":"Cancel Order","description":"Cancel a single order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/create-order":{"id":"api-explorer/v5/trade/create-order","title":"Place Order","description":"Place an order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/open-order":{"id":"api-explorer/v5/trade/open-order","title":"Get Open Orders (real-time)","description":"Get unfilled orders or partially filled orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/order-list":{"id":"api-explorer/v5/trade/order-list","title":"Get Order History (2 years)","description":"Get order history.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/query-spot-quota":{"id":"api-explorer/v5/trade/query-spot-quota","title":"Get Borrow Quota (Spot)","description":"Query user\'s spot available quota","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/trade":{"id":"api-explorer/v5/trade/trade","title":"Trade","description":"Trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/affiliate-info":{"id":"api-explorer/v5/user/affiliate-info","title":"Get Affiliate User Info","description":"Get affiliate user info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/apikey-info":{"id":"api-explorer/v5/user/apikey-info","title":"Get API Key Information","description":"Get API Key Information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/list-sub-apikeys":{"id":"api-explorer/v5/user/list-sub-apikeys","title":"Get Sub Account All API Keys","description":"Get Sub Account All API Keys","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/user":{"id":"api-explorer/v5/user/user","title":"User","description":"User","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/wallet-type":{"id":"api-explorer/v5/user/wallet-type","title":"Get UID Wallet Type","description":"Get uid wallet type","sidebar":"apiExplorerSideBar"},"changelog/asset-v3":{"id":"changelog/asset-v3","title":"Account Asset V3","description":"2024-05-09","sidebar":"changelogSidebar"},"changelog/copytrade":{"id":"changelog/copytrade","title":"Copy Trading","description":"2023-06-24","sidebar":"changelogSidebar"},"changelog/derivatives-v3":{"id":"changelog/derivatives-v3","title":"Derivatives V3","description":"2024-05-09","sidebar":"changelogSidebar"},"changelog/spot-v3":{"id":"changelog/spot-v3","title":"Spot V3","description":"2023-04-20","sidebar":"changelogSidebar"},"changelog/v5":{"id":"changelog/v5","title":"V5","description":"2024-08-13","sidebar":"changelogSidebar"},"faq":{"id":"faq","title":"Frequently Asked Questions","description":"Where are Bybit\'s servers located?"},"pilot-feature/pilot":{"id":"pilot-feature/pilot","title":"Pilot Features","description":"Open API Supports Demo Trading"},"v3/account-asset/enum":{"id":"v3/account-asset/enum","title":"Enums Definitions","description":"accountType","sidebar":"v3SideBar"},"v3/account-asset/error":{"id":"v3/account-asset/error","title":"Error Code","description":"|Code |Description |","sidebar":"v3SideBar"},"v3/account-asset/rate-limit":{"id":"v3/account-asset/rate-limit","title":"Rate Limit","description":"IP Rate Limit","sidebar":"v3SideBar"},"v3/account-asset/transfer/all-balance":{"id":"v3/account-asset/transfer/all-balance","title":"Get All Coins Balance","description":"You could get all coins balance of all account types under the master account, and sub account.","sidebar":"v3SideBar"},"v3/account-asset/transfer/asset-info":{"id":"v3/account-asset/transfer/asset-info","title":"Get Asset Info","description":"Can query SPOT asset information only","sidebar":"v3SideBar"},"v3/account-asset/transfer/coin-balance":{"id":"v3/account-asset/transfer/coin-balance","title":"Get Single Coin Balance","description":"You could get a single coin balance under the master account, and sub account coin balance.","sidebar":"v3SideBar"},"v3/account-asset/transfer/enable-uni-transfer":{"id":"v3/account-asset/transfer/enable-uni-transfer","title":"Enable Universal Transfer (Depreciated)","description":"Enable Universal Transfer","sidebar":"v3SideBar"},"v3/account-asset/transfer/internal-transfer":{"id":"v3/account-asset/transfer/internal-transfer","title":"Create Internal Transfer","description":"Transfers funds between the different sections of an individual\'s account (not between subaccounts). For example, between the spot and derivatives accounts.","sidebar":"v3SideBar"},"v3/account-asset/transfer/internal-transfer-list":{"id":"v3/account-asset/transfer/internal-transfer-list","title":"Get Internal Transfer List","description":"Query Internal Transfer List","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-list":{"id":"v3/account-asset/transfer/subacct-list","title":"Get Subaccount UID List","description":"Query Subaccount List","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-transfer":{"id":"v3/account-asset/transfer/subacct-transfer","title":"Create Subaccount Transfer","description":"Transfer funds between the parent and child (sub) accounts.","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-transfer-list":{"id":"v3/account-asset/transfer/subacct-transfer-list","title":"Get Master-Sub Transfer List","description":"Query subaccount transfer list","sidebar":"v3SideBar"},"v3/account-asset/transfer/transferable-coin-list":{"id":"v3/account-asset/transfer/transferable-coin-list","title":"Get Transferable Coin List","description":"Transferable coin list","sidebar":"v3SideBar"},"v3/account-asset/transfer/uni-transfer":{"id":"v3/account-asset/transfer/uni-transfer","title":"Create Universal Transfer","description":"Create Universal Transfer","sidebar":"v3SideBar"},"v3/account-asset/transfer/uni-transfer-list":{"id":"v3/account-asset/transfer/uni-transfer-list","title":"Get Universal Transfer List","description":"Query Universal Transfer List","sidebar":"v3SideBar"},"v3/account-asset/user/apikey-info":{"id":"v3/account-asset/user/apikey-info","title":"Get API Key Information","description":"Get the information of the api key. Use the api key pending to be checked to call the endpoint. Both master and sub user\'s api key are applicable.","sidebar":"v3SideBar"},"v3/account-asset/user/create-subuid":{"id":"v3/account-asset/user/create-subuid","title":"Create Sub UID","description":"Create a new sub user id. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/create-subuid-apikey":{"id":"v3/account-asset/user/create-subuid-apikey","title":"Create Sub UID API Key","description":"To create new API key for those newly created sub UID. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/froze-subuid":{"id":"v3/account-asset/user/froze-subuid","title":"Froze Sub UID","description":"Froze sub uid. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/modify-master-apikey":{"id":"v3/account-asset/user/modify-master-apikey","title":"Modify Master API Key","description":"Modify the settings of master api key. Use the api key pending to be modified to call the endpoint. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/modify-sub-apikey":{"id":"v3/account-asset/user/modify-sub-apikey","title":"Modify Sub API Key","description":"Modify the settings of sub api key. Use the sub account api key pending to be modified to call the endpoint or use master","sidebar":"v3SideBar"},"v3/account-asset/user/rm-master-apikey":{"id":"v3/account-asset/user/rm-master-apikey","title":"Delete Master API Key","description":"Delete the api key of master account. Use the api key pending to be delete to call the endpoint. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/rm-sub-apikey":{"id":"v3/account-asset/user/rm-sub-apikey","title":"Delete Sub API Key","description":"Delete the api key of sub account. Use the sub api key pending to be delete to call the endpoint or use the master api key","sidebar":"v3SideBar"},"v3/account-asset/user/subuid-list":{"id":"v3/account-asset/user/subuid-list","title":"Get Sub UID List","description":"Get all sub uid of master account. Use master user\'s api key only.","sidebar":"v3SideBar"},"v3/account-asset/user/wallet-type":{"id":"v3/account-asset/user/wallet-type","title":"Get UID Wallet Type","description":"Get available wallet types for the master account or sub account","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/cancel-withdraw":{"id":"v3/account-asset/withdraw-deposit/cancel-withdraw","title":"Cancel withdrawal","description":"Cancel withdrawal","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/coin-info":{"id":"v3/account-asset/withdraw-deposit/coin-info","title":"Get Coin Information","description":"Query Coin Information","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/deplay-amount":{"id":"v3/account-asset/withdraw-deposit/deplay-amount","title":"Get Delay Withdraw Amount","description":"How can partial funds be subject to delayed withdrawal requests?","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/deposit-spec":{"id":"v3/account-asset/withdraw-deposit/deposit-spec","title":"Get Deposit Spec","description":"Query deposit spec.","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/internal-deposit-record":{"id":"v3/account-asset/withdraw-deposit/internal-deposit-record","title":"Get Internal Deposit Records (across Bybit)","description":"Query deposit records through Bybit platform","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/master-deposit-addr":{"id":"v3/account-asset/withdraw-deposit/master-deposit-addr","title":"Get Master Acct Deposit Address Info","description":"Query Master Acct Deposit Address Information","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/master-deposit-record":{"id":"v3/account-asset/withdraw-deposit/master-deposit-record","title":"Get Deposit Records (on chain)","description":"Query Deposit Records","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/set-deposit-acct":{"id":"v3/account-asset/withdraw-deposit/set-deposit-acct","title":"Set Deposit Account","description":"Set auto transfer account after deposit. The same function as the setting for Deposit on web GUI.","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/sub-deposit-addr":{"id":"v3/account-asset/withdraw-deposit/sub-deposit-addr","title":"Get Sub Acct Deposit Address Info","description":"Query Sub Acct Deposit Address Information","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/sub-deposit-record":{"id":"v3/account-asset/withdraw-deposit/sub-deposit-record","title":"Get Sub Deposit Records (on chain)","description":"Query Sub Deposit Records By Master Key","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/vasp-list":{"id":"v3/account-asset/withdraw-deposit/vasp-list","title":"Get Exchange Entity List","description":"This endpoint is particularly used for kyc=KOR users. When withdraw funds, you need to fill entity id.","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/withdraw":{"id":"v3/account-asset/withdraw-deposit/withdraw","title":"Withdraw","description":"Withdraw assets from your Bybit account. You can make an off-chain transfer if the target wallet address is from Bybit. This means that no blockchain fee will be charged.","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/withdraw-record":{"id":"v3/account-asset/withdraw-deposit/withdraw-record","title":"Get Withdraw Records","description":"Query Withdraw Records","sidebar":"v3SideBar"},"v3/copy-trade/enum":{"id":"v3/copy-trade/enum","title":"Enums Definitions","description":"accountType"},"v3/copy-trade/error":{"id":"v3/copy-trade/error","title":"Error Code","description":"|Code |Description |"},"v3/copy-trade/rate-limit":{"id":"v3/copy-trade/rate-limit","title":"Rate Limit","description":"IP Rate Limit"},"v3/copy-trade/rest-public/symbol-info":{"id":"v3/copy-trade/rest-public/symbol-info","title":"Instrument Info","description":"Get the spec of trading symbols"},"v3/copy-trade/rest-trade/account/transfer":{"id":"v3/copy-trade/rest-trade/account/transfer","title":"Transfer","description":"Transfer"},"v3/copy-trade/rest-trade/account/transfer-list":{"id":"v3/copy-trade/rest-trade/account/transfer-list","title":"Get Transfer History","description":"Get the transfer history of Copy-trade wallet"},"v3/copy-trade/rest-trade/account/wallet":{"id":"v3/copy-trade/rest-trade/account/wallet","title":"Get Wallet Balance","description":"Get CopyTrading Wallet Balance"},"v3/copy-trade/rest-trade/order/cancel-order":{"id":"v3/copy-trade/rest-trade/order/cancel-order","title":"Cancel Order","description":"Cancel Order"},"v3/copy-trade/rest-trade/order/close-order":{"id":"v3/copy-trade/rest-trade/order/close-order","title":"Create Close Position Order","description":"Create a specific close order"},"v3/copy-trade/rest-trade/order/order-list":{"id":"v3/copy-trade/rest-trade/order/order-list","title":"Get Orders","description":"Query orders"},"v3/copy-trade/rest-trade/order/place-order":{"id":"v3/copy-trade/rest-trade/order/place-order","title":"Create Order","description":"Create Order"},"v3/copy-trade/rest-trade/order/set-trading-stop":{"id":"v3/copy-trade/rest-trade/order/set-trading-stop","title":"Set Trading Stop","description":"Set Trading Stop"},"v3/copy-trade/rest-trade/position/close-position":{"id":"v3/copy-trade/rest-trade/position/close-position","title":"Close All Positions","description":"Close Position"},"v3/copy-trade/rest-trade/position/execution":{"id":"v3/copy-trade/rest-trade/position/execution","title":"Get Execution List (2 years)","description":"Query users\' execution list, sort by execTime in descending order"},"v3/copy-trade/rest-trade/position/position-info":{"id":"v3/copy-trade/rest-trade/position/position-info","title":"Position List","description":"Position List"},"v3/copy-trade/rest-trade/position/set-leverage":{"id":"v3/copy-trade/rest-trade/position/set-leverage","title":"Set Leverage","description":"Set Leverage"},"v3/copy-trade/wss-authentication":{"id":"v3/copy-trade/wss-authentication","title":"Connect","description":"Note that currently Copy Trading only supports USDT perpetual and the following endpoints only apply to USDT Perpetual"},"v3/copy-trade/wss-private/execution":{"id":"v3/copy-trade/wss-private/execution","title":"Execution","description":"Topic:"},"v3/copy-trade/wss-private/order":{"id":"v3/copy-trade/wss-private/order","title":"Order","description":"Topic:"},"v3/copy-trade/wss-private/position":{"id":"v3/copy-trade/wss-private/position","title":"Position","description":"Topic:"},"v3/copy-trade/wss-private/wallet":{"id":"v3/copy-trade/wss-private/wallet","title":"Wallet","description":"Topic:"},"v3/copy-trade/wss-public/kline":{"id":"v3/copy-trade/wss-public/kline","title":"Kline","description":"Interval supported:"},"v3/copy-trade/wss-public/liquidation":{"id":"v3/copy-trade/wss-public/liquidation","title":"Liquidation","description":"Get recent liquidation orders in Bybit."},"v3/copy-trade/wss-public/orderbook":{"id":"v3/copy-trade/wss-public/orderbook","title":"Orderbook","description":"Get different depth"},"v3/copy-trade/wss-public/tickers":{"id":"v3/copy-trade/wss-public/tickers","title":"Tickers","description":"Get latest information of the symbol"},"v3/copy-trade/wss-public/trade":{"id":"v3/copy-trade/wss-public/trade","title":"Public Trade","description":"Get recent public trades data in Bybit."},"v3/derivatives/enum":{"id":"v3/derivatives/enum","title":"Enums Definitions","description":"category","sidebar":"v3SideBar"},"v3/derivatives/error":{"id":"v3/derivatives/error","title":"Error Code","description":"Unified Margin","sidebar":"v3SideBar"},"v3/derivatives/rate-limit":{"id":"v3/derivatives/rate-limit","title":"Rate Limit","description":"IP Rate Limit","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/trading-fee":{"id":"v3/derivatives/rest-contract/account/trading-fee","title":"Get Trading Fee Rate","description":"Get user trading fee rate.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/wallet-balance":{"id":"v3/derivatives/rest-contract/account/wallet-balance","title":"Wallet Balance","description":"Get wallet balance, including Derivatives account and USDC account.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/wallet-fund-record":{"id":"v3/derivatives/rest-contract/account/wallet-fund-record","title":"Get Wallet Fund Records","description":"Get wallet fund records. This endpoint also shows exchanges from the Asset Exchange, where the types for the exchange are ExchangeOrderWithdraw and ExchangeOrderDeposit.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/cancel-all":{"id":"v3/derivatives/rest-contract/order/cancel-all","title":"Cancel All Order","description":"This endpoint enables to cancel all open orders.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/cancel-order":{"id":"v3/derivatives/rest-contract/order/cancel-order","title":"Cancel Order","description":"You could cancel those unfilled or partially filled orders.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/open-order":{"id":"v3/derivatives/rest-contract/order/open-order","title":"Get Open Orders","description":"Query unfilled or partially filled orders in real-time.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/order-list":{"id":"v3/derivatives/rest-contract/order/order-list","title":"Get Order List","description":"Query order list.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/place-order":{"id":"v3/derivatives/rest-contract/order/place-order","title":"Place Order","description":"- Market order: A traditional market order, which will be filled at the current optimal price. Only when the market","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/replace-order":{"id":"v3/derivatives/rest-contract/order/replace-order","title":"Replace Order","description":"You could modify those unfilled or partially filled orders.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/auto-margin":{"id":"v3/derivatives/rest-contract/position/auto-margin","title":"Set Auto Add Margin","description":"Turn on/off auto add position margin. To understand more, please read here","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/close-pnl":{"id":"v3/derivatives/rest-contract/position/close-pnl","title":"Get Closed PnL","description":"Query user\'s closed profit and loss records. The results are sorted by updatedTime in descending order.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/confirm-mmr":{"id":"v3/derivatives/rest-contract/position/confirm-mmr","title":"Confirm New Risk Limit","description":"It is only applicable when the user is marked as only reducing positions (please see the isReduceOnly field in","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/cross-isolated-margin":{"id":"v3/derivatives/rest-contract/position/cross-isolated-margin","title":"Switch Cross/Isolated Margin","description":"Switch cross margin mode / isolated margin mode. To understand more, please read here","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/execution":{"id":"v3/derivatives/rest-contract/position/execution","title":"Get Execution List","description":"Query users\' execution list, sort by execTime in descending order. Support USDT Perpetual, Inverse Perpetual, Inverse Future, USDC Perpetual and USDC Option.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/leverage":{"id":"v3/derivatives/rest-contract/position/leverage","title":"Set Leverage","description":"Set the leverage.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/position-info":{"id":"v3/derivatives/rest-contract/position/position-info","title":"My Position","description":"Get real-time position data","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/position-mode":{"id":"v3/derivatives/rest-contract/position/position-mode","title":"Switch Position Mode","description":"It supports to switch the position mode for USDT perpetual and Inverse futures. If you are in one-way Mode, you can only open one position on Buy or Sell side. If you are in hedge mode, you can open both Buy and Sell side positions simultaneously.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/set-risk-limit":{"id":"v3/derivatives/rest-contract/position/set-risk-limit","title":"Set Risk Limit","description":"Since bybit has launched auto risk limit on 12 March 2024, please click here to learn more, so it will not take effect even you set it successfully.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/tpsl-mode":{"id":"v3/derivatives/rest-contract/position/tpsl-mode","title":"Switch TP/SL Mode","description":"_To some extent, this endpoint is depreciated because now tpsl is based on order level. This API was used for position level","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/trading-stop":{"id":"v3/derivatives/rest-contract/position/trading-stop","title":"Set Trading Stop","description":"Set the take profit, stop loss or trailing stop for the position.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/delivery-price":{"id":"v3/derivatives/rest-public/delivery-price","title":"Option Delivery Price","description":"Get the delivery price for option","sidebar":"v3SideBar"},"v3/derivatives/rest-public/fund-rate-history":{"id":"v3/derivatives/rest-public/fund-rate-history","title":"Funding Rate History","description":"Get historical funding rate","sidebar":"v3SideBar"},"v3/derivatives/rest-public/index-kline":{"id":"v3/derivatives/rest-public/index-kline","title":"Index Price Kline","description":"Get index price kline data","sidebar":"v3SideBar"},"v3/derivatives/rest-public/instrument-info":{"id":"v3/derivatives/rest-public/instrument-info","title":"Instrument Info","description":"Get launched instruments information.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/kline":{"id":"v3/derivatives/rest-public/kline","title":"Kline","description":"Get kline data","sidebar":"v3SideBar"},"v3/derivatives/rest-public/long-short-ratio":{"id":"v3/derivatives/rest-public/long-short-ratio","title":"Get Long Short Ratio","description":"HTTP Request","sidebar":"v3SideBar"},"v3/derivatives/rest-public/mark-kline":{"id":"v3/derivatives/rest-public/mark-kline","title":"Mark Price Kline","description":"Get mark price kline data","sidebar":"v3SideBar"},"v3/derivatives/rest-public/open-interest":{"id":"v3/derivatives/rest-public/open-interest","title":"Open Interest","description":"Get open interest of each symbol in Bybit","sidebar":"v3SideBar"},"v3/derivatives/rest-public/orderbook":{"id":"v3/derivatives/rest-public/orderbook","title":"Order Book","description":"Get order book data.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/premium-index-kline":{"id":"v3/derivatives/rest-public/premium-index-kline","title":"Premium Index Price Kline","description":"Get premium index price kline data","sidebar":"v3SideBar"},"v3/derivatives/rest-public/public-trade":{"id":"v3/derivatives/rest-public/public-trade","title":"Public Trading History","description":"Get recent public trading records in Bybit. You could download archived USDT contract trade records here.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/risk-limit":{"id":"v3/derivatives/rest-public/risk-limit","title":"Risk Limit","description":"Get risk limit","sidebar":"v3SideBar"},"v3/derivatives/rest-public/ticker-info":{"id":"v3/derivatives/rest-public/ticker-info","title":"Ticker Info","description":"Get all latest information of symbols.","sidebar":"v3SideBar"},"v3/derivatives/rest-unified/account/account-info":{"id":"v3/derivatives/rest-unified/account/account-info","title":"Account Info","description":"Query the configuration under the account."},"v3/derivatives/rest-unified/account/borrow-history":{"id":"v3/derivatives/rest-unified/account/borrow-history","title":"Borrow History","description":"HTTP Request"},"v3/derivatives/rest-unified/account/borrow-rate":{"id":"v3/derivatives/rest-unified/account/borrow-rate","title":"Get Borrow Rate","description":"HTTP Request"},"v3/derivatives/rest-unified/account/dcp":{"id":"v3/derivatives/rest-unified/account/dcp","title":"Set Disconnect Cancel All","description":"What is Disconnection Protect (DCP)?"},"v3/derivatives/rest-unified/account/exchange":{"id":"v3/derivatives/rest-unified/account/exchange","title":"Get Exchange Records","description":"Query the coin exchange records."},"v3/derivatives/rest-unified/account/get-dcp":{"id":"v3/derivatives/rest-unified/account/get-dcp","title":"Get DCP Info","description":"HTTP Request"},"v3/derivatives/rest-unified/account/get-mmp-state":{"id":"v3/derivatives/rest-unified/account/get-mmp-state","title":"Get MMP State","description":"HTTP Request"},"v3/derivatives/rest-unified/account/reset-mmp":{"id":"v3/derivatives/rest-unified/account/reset-mmp","title":"Reset MMP","description":"Once the mmp triggered, you can unfreeze the account by this endpoint"},"v3/derivatives/rest-unified/account/set-margin-mode":{"id":"v3/derivatives/rest-unified/account/set-margin-mode","title":"Set Margin Mode","description":"Default is the regular margin mode. This mode is valid for USDT Perp, USDC Perp and Option."},"v3/derivatives/rest-unified/account/set-mmp":{"id":"v3/derivatives/rest-unified/account/set-mmp","title":"Set MMP","description":"What is MMP?"},"v3/derivatives/rest-unified/account/transaction-log":{"id":"v3/derivatives/rest-unified/account/transaction-log","title":"Transaction Log","description":"Query transaction logs in Unified account."},"v3/derivatives/rest-unified/account/upgrade-unified-account":{"id":"v3/derivatives/rest-unified/account/upgrade-unified-account","title":"Upgrade To Unified Margin Account","description":"Upgrade to unified margin account (UMA)"},"v3/derivatives/rest-unified/account/wallet-balance":{"id":"v3/derivatives/rest-unified/account/wallet-balance","title":"Wallet Balance","description":"Get wallet balance"},"v3/derivatives/rest-unified/order/batch-cancel":{"id":"v3/derivatives/rest-unified/order/batch-cancel","title":"Batch Cancel Order","description":"This endpoint provides the batch order mode to cancel a bunch of open orders."},"v3/derivatives/rest-unified/order/batch-place":{"id":"v3/derivatives/rest-unified/order/batch-place","title":"Batch Place Order","description":"This endpoint provides the batch order mode to place a bunch of orders."},"v3/derivatives/rest-unified/order/batch-replace":{"id":"v3/derivatives/rest-unified/order/batch-replace","title":"Batch Replace Order","description":"This endpoint provides the batch order mode to replace a bunch of open orders."},"v3/derivatives/rest-unified/order/cancel-all":{"id":"v3/derivatives/rest-unified/order/cancel-all","title":"Cancel All Orders","description":"This endpoint enables to cancel all open orders."},"v3/derivatives/rest-unified/order/cancel-order":{"id":"v3/derivatives/rest-unified/order/cancel-order","title":"Cancel Order","description":"You could cancel those unfilled or partially filled orders."},"v3/derivatives/rest-unified/order/open-order":{"id":"v3/derivatives/rest-unified/order/open-order","title":"Get Open Orders","description":"Query unfilled or partially filled orders in real-time."},"v3/derivatives/rest-unified/order/order-list":{"id":"v3/derivatives/rest-unified/order/order-list","title":"Get Order List","description":"Query order list."},"v3/derivatives/rest-unified/order/place-order":{"id":"v3/derivatives/rest-unified/order/place-order","title":"Place Order","description":"- Market order: A traditional market order, which will be filled at the current optimal price. Only when the market"},"v3/derivatives/rest-unified/order/replace-order":{"id":"v3/derivatives/rest-unified/order/replace-order","title":"Replace Order","description":"You could modify those unfilled or partially filled orders."},"v3/derivatives/rest-unified/position/execution-list":{"id":"v3/derivatives/rest-unified/position/execution-list","title":"Get Execution Record","description":"Query users\' execution records, sort by execTime in descending order"},"v3/derivatives/rest-unified/position/full-partial-tpsl":{"id":"v3/derivatives/rest-unified/position/full-partial-tpsl","title":"Switch TP/SL Mode","description":"Set take profit / stop loss mode of the position, such as FULL TP/SL mode or PARTIAL TP/SL mode"},"v3/derivatives/rest-unified/position/leverage":{"id":"v3/derivatives/rest-unified/position/leverage","title":"Set Leverage","description":"Set the leverage."},"v3/derivatives/rest-unified/position/option-delivery":{"id":"v3/derivatives/rest-unified/position/option-delivery","title":"Get Option Delivery Record","description":"Query option delivery records, sort by deliveryTime in descending order"},"v3/derivatives/rest-unified/position/position-info":{"id":"v3/derivatives/rest-unified/position/position-info","title":"My Position","description":"Get real-time position data"},"v3/derivatives/rest-unified/position/set-risk-limit":{"id":"v3/derivatives/rest-unified/position/set-risk-limit","title":"Set Risk Limit","description":"The risk limit will limit the maximum position value you can hold under different margin requirements."},"v3/derivatives/rest-unified/position/trading-stop":{"id":"v3/derivatives/rest-unified/position/trading-stop","title":"Set Trading Stop","description":"Pass the following parameters, then the system will create conditional orders. If the position is closed, the system will cancel these orders, and adjust the position size."},"v3/derivatives/rest-unified/position/usdc-settlement":{"id":"v3/derivatives/rest-unified/position/usdc-settlement","title":"Get USDC Perpetual Settlement","description":"Query session settlement records of USDC perpetual"},"v3/derivatives/wss-authentication":{"id":"v3/derivatives/wss-authentication","title":"Connect","description":"Base endpoints:","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/execution":{"id":"v3/derivatives/wss-contract/execution","title":"Execution","description":"Subscribe to the execution stream to see when an open order gets filled or partially filled.","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/order":{"id":"v3/derivatives/wss-contract/order","title":"Order","description":"Subscribe to the order stream to see new orders, when an order\'s order status changes, etc.","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/position":{"id":"v3/derivatives/wss-contract/position","title":"Position","description":"Subscribe to the position stream to see changes to your position size, position setting changes, etc.","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/wallet":{"id":"v3/derivatives/wss-contract/wallet","title":"Wallet","description":"Subscribe to the wallet stream to see changes to your wallet in real-time.","sidebar":"v3SideBar"},"v3/derivatives/wss-public/kline":{"id":"v3/derivatives/wss-public/kline","title":"Kline","description":"Covers: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future","sidebar":"v3SideBar"},"v3/derivatives/wss-public/liquidation":{"id":"v3/derivatives/wss-public/liquidation","title":"Liquidation","description":"Get recent liquidation orders in Bybit, at most one order is published per second per symbol","sidebar":"v3SideBar"},"v3/derivatives/wss-public/orderbook":{"id":"v3/derivatives/wss-public/orderbook","title":"Orderbook","description":"Get different depth","sidebar":"v3SideBar"},"v3/derivatives/wss-public/tickers":{"id":"v3/derivatives/wss-public/tickers","title":"Tickers","description":"Cover: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future, Option","sidebar":"v3SideBar"},"v3/derivatives/wss-public/trade":{"id":"v3/derivatives/wss-public/trade","title":"Public Trade","description":"Get recent public trades data in Bybit.","sidebar":"v3SideBar"},"v3/derivatives/wss-unified/execution":{"id":"v3/derivatives/wss-unified/execution","title":"Execution","description":"Subscribe to the execution stream. Will not push funding payments unless they occur on a USDT perpetual, eg BTCUSDT."},"v3/derivatives/wss-unified/greek":{"id":"v3/derivatives/wss-unified/greek","title":"Greek","description":"Subscribe to the user greeks stream, option only."},"v3/derivatives/wss-unified/order":{"id":"v3/derivatives/wss-unified/order","title":"Order","description":"Subscribe to the order stream to see new orders, when an order\'s order status changes, etc."},"v3/derivatives/wss-unified/position":{"id":"v3/derivatives/wss-unified/position","title":"Position","description":"Subscribe to the position stream to see changes to your position size, position setting changes, etc."},"v3/derivatives/wss-unified/wallet":{"id":"v3/derivatives/wss-unified/wallet","title":"Wallet","description":"Subscribe to the wallet stream to see changes to your wallet in real-time."},"v3/intro":{"id":"v3/intro","title":"Introduction","description":"Bybit V3 API allow users to select different collections to build their API model.","sidebar":"v3SideBar"},"v3/server-time":{"id":"v3/server-time","title":"Bybit Server Time","description":"Get the Bybit server timestamp","sidebar":"v3SideBar"},"v3/smp":{"id":"v3/smp","title":"Self Match Prevention","description":"What is SMP?","sidebar":"v3SideBar"},"v3/spot/enum":{"id":"v3/spot/enum","title":"Enums Definitions","description":"side","sidebar":"v3SideBar"},"v3/spot/error":{"id":"v3/spot/error","title":"Error Code","description":"|Code |Description |","sidebar":"v3SideBar"},"v3/spot/rate-limit":{"id":"v3/spot/rate-limit","title":"Rate Limit","description":"IP Rate Limit","sidebar":"v3SideBar"},"v3/spot/rest-etp/asset-info":{"id":"v3/spot/rest-etp/asset-info","title":"All Asset Info","description":"It is a public endpoint, and no need to authenticate.","sidebar":"v3SideBar"},"v3/spot/rest-etp/market-info":{"id":"v3/spot/rest-etp/market-info","title":"Market Info","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-etp/purchase":{"id":"v3/spot/rest-etp/purchase","title":"Purchase","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-etp/purchase-redeem-history":{"id":"v3/spot/rest-etp/purchase-redeem-history","title":"Purchase & Redeem History","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-etp/redeem":{"id":"v3/spot/rest-etp/redeem","title":"Redeem","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/loan-info":{"id":"v3/spot/rest-institution-loan/loan-info","title":"Get Loan Info","description":"Get loan orders information","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/ltv":{"id":"v3/spot/rest-institution-loan/ltv","title":"Get LTV","description":"Get LTV. Please head here to get LTV if this API returns empty data.","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/margin-coin-info":{"id":"v3/spot/rest-institution-loan/margin-coin-info","title":"Margin Coin Info","description":"This is a public endpoint, so it does not need to authenticate.","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/margin-product-info":{"id":"v3/spot/rest-institution-loan/margin-product-info","title":"Get Margin Product Info","description":"This is a public endpoint, so it does not need to authenticate.","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/repay-info":{"id":"v3/spot/rest-institution-loan/repay-info","title":"Get Repay Info","description":"Get repaid order information. Authentication needed.","sidebar":"v3SideBar"},"v3/spot/rest-public/best-bid-ask":{"id":"v3/spot/rest-public/best-bid-ask","title":"Best Bid/Ask Price","description":"If symbol is not specified, the best order price from all symbols will be returned","sidebar":"v3SideBar"},"v3/spot/rest-public/instrument-info":{"id":"v3/spot/rest-public/instrument-info","title":"Instrument Info","description":"Get the spec of symbol information","sidebar":"v3SideBar"},"v3/spot/rest-public/kline":{"id":"v3/spot/rest-public/kline","title":"Kline","description":"It only returns the results from latest 1000 candles regardless of what interval is specified","sidebar":"v3SideBar"},"v3/spot/rest-public/last-trade-price":{"id":"v3/spot/rest-public/last-trade-price","title":"Last Traded Price","description":"If symbol is not specified, the price from all symbols will be returned","sidebar":"v3SideBar"},"v3/spot/rest-public/merge-orderbook":{"id":"v3/spot/rest-public/merge-orderbook","title":"Merged Order Book","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-public/orderbook":{"id":"v3/spot/rest-public/orderbook","title":"Order Book","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-public/public-trade":{"id":"v3/spot/rest-public/public-trade","title":"Public Trading Records","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-public/ticker-info":{"id":"v3/spot/rest-public/ticker-info","title":"Tickers","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/account-info":{"id":"v3/spot/rest-spot-margin/account-info","title":"Get Loan Account Info","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrow":{"id":"v3/spot/rest-spot-margin/borrow","title":"Borrow","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrow-info":{"id":"v3/spot/rest-spot-margin/borrow-info","title":"Get Borrow Order Detail","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrowable-data":{"id":"v3/spot/rest-spot-margin/borrowable-data","title":"Get Borrowable Coin Info","description":"This is public endpoint, so do not need an authentication","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/interest-quota":{"id":"v3/spot/rest-spot-margin/interest-quota","title":"Get Interest & Quota","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/margin-data":{"id":"v3/spot/rest-spot-margin/margin-data","title":"Get Margin Coin Info","description":"This is public endpoint, so do not need an authentication","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/repay":{"id":"v3/spot/rest-spot-margin/repay","title":"Repay","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/repay-history":{"id":"v3/spot/rest-spot-margin/repay-history","title":"Get Repayment Order Detail","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/switch-mode":{"id":"v3/spot/rest-spot-margin/switch-mode","title":"Toggle Margin Trade","description":"Turn on / off spot margin trade","sidebar":"v3SideBar"},"v3/spot/rest-spot/batch-cancel":{"id":"v3/spot/rest-spot/batch-cancel","title":"Batch Cancel Order","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/batch-cancel-by-id":{"id":"v3/spot/rest-spot/batch-cancel-by-id","title":"Batch Cancel Order By Id","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/cancel-order":{"id":"v3/spot/rest-spot/cancel-order","title":"Cancel Order","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/get-order":{"id":"v3/spot/rest-spot/get-order","title":"Get Order","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/open-order":{"id":"v3/spot/rest-spot/open-order","title":"Open Orders","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/rest-spot/order-history":{"id":"v3/spot/rest-spot/order-history","title":"Order History","description":"- If startTime and endTime are both not specified, it returns last 7 days records by default.","sidebar":"v3SideBar"},"v3/spot/rest-spot/place-order":{"id":"v3/spot/rest-spot/place-order","title":"Place Order","description":"Do not use the duplicate orderLinkId in normal order & TP/SL order","sidebar":"v3SideBar"},"v3/spot/rest-spot/trade-history":{"id":"v3/spot/rest-spot/trade-history","title":"Trade History","description":"* If startTime is not specified, you can only query for records in the last 7 days.","sidebar":"v3SideBar"},"v3/spot/wallet":{"id":"v3/spot/wallet","title":"Get Wallet Balance","description":"HTTP Request","sidebar":"v3SideBar"},"v3/spot/wss-authentication":{"id":"v3/spot/wss-authentication","title":"Connect","description":"Note that the following endpoints only apply to Spot. To listen to other websockets, go to:","sidebar":"v3SideBar"},"v3/spot/wss-private/order":{"id":"v3/spot/wss-private/order","title":"Order","description":"This topic pushes order information\uff0cavg.filledPrice = Z / z","sidebar":"v3SideBar"},"v3/spot/wss-private/outbound-account-info":{"id":"v3/spot/wss-private/outbound-account-info","title":"Wallet","description":"This topic pushes spot wallet information","sidebar":"v3SideBar"},"v3/spot/wss-private/stop-order":{"id":"v3/spot/wss-private/stop-order","title":"Stop Order","description":"This topic pushes conditional order, TP/SL order information placed by web/app channel, and TP/SL order information placed by open api channel. It\'ll be triggered as long as order status is changed","sidebar":"v3SideBar"},"v3/spot/wss-private/ticket-info":{"id":"v3/spot/wss-private/ticket-info","title":"Execution","description":"This topic pushes filled trades information. When an order is filled, you will receive two messages: one from ticketInfo, and one from order / stopOrder","sidebar":"v3SideBar"},"v3/spot/wss-public/bookticker":{"id":"v3/spot/wss-public/bookticker","title":"Bookticker","description":"Best bid price and best ask price","sidebar":"v3SideBar"},"v3/spot/wss-public/kline":{"id":"v3/spot/wss-public/kline","title":"Kline","description":"Subscribe the kline stream. Please find desired kline interval here.","sidebar":"v3SideBar"},"v3/spot/wss-public/orderbook":{"id":"v3/spot/wss-public/orderbook","title":"Orderbook","description":"Market depth data for a trading pair:","sidebar":"v3SideBar"},"v3/spot/wss-public/tickers":{"id":"v3/spot/wss-public/tickers","title":"Tickers","description":"The 24-hr statistics of a trading pair.","sidebar":"v3SideBar"},"v3/spot/wss-public/trade":{"id":"v3/spot/wss-public/trade","title":"Public trade","description":"This topic pushes raw trade information; each trade has a unique buyer and seller.","sidebar":"v3SideBar"},"v3/tax/data-explain":{"id":"v3/tax/data-explain","title":"Data Explanation","description":"Trade History","sidebar":"v3SideBar"},"v3/tax/data-export":{"id":"v3/tax/data-export","title":"Retrieve Data Export","description":"Retrieve data export","sidebar":"v3SideBar"},"v3/tax/enum":{"id":"v3/tax/enum","title":"Enums Definitions","description":"ReportType","sidebar":"v3SideBar"},"v3/tax/register-time":{"id":"v3/tax/register-time","title":"Get User Register Date","description":"Get User Register Date","sidebar":"v3SideBar"},"v3/tax/report-status":{"id":"v3/tax/report-status","title":"Get Export Report Status","description":"Get Export Report Status","sidebar":"v3SideBar"},"v3/tax/request-report":{"id":"v3/tax/request-report","title":"Request Export Report","description":"Request to export report","sidebar":"v3SideBar"},"v5/abandon/account-info":{"id":"v5/abandon/account-info","title":"Get Lending Account Info","description":"HTTP Request","sidebar":"v5SideBar"},"v5/abandon/cancel-redeem":{"id":"v5/abandon/cancel-redeem","title":"Cancel Redeem","description":"Cancel the withdrawal operation.","sidebar":"v5SideBar"},"v5/abandon/coin-info":{"id":"v5/abandon/coin-info","title":"Get Lending Coin Info","description":"Get the basic information of lending coins","sidebar":"v5SideBar"},"v5/abandon/deposit":{"id":"v5/abandon/deposit","title":"Deposit Funds","description":"Lending funds to Bybit asset pool","sidebar":"v5SideBar"},"v5/abandon/earning":{"id":"v5/abandon/earning","title":"Get Broker Earning","description":"This endpoint has been depreciated, please move to new Get Exchange Broker Earning","sidebar":"v5SideBar"},"v5/abandon/enable-unitransfer-subuid":{"id":"v5/abandon/enable-unitransfer-subuid","title":"Enable Universal Transfer for Sub UID","description":"You no longer need to configure transferable sub UIDs. Now, all sub UIDs are automatically enabled for universal transfer.","sidebar":"v5SideBar"},"v5/abandon/ltv":{"id":"v5/abandon/ltv","title":"Get LTV","description":"HTTP Request","sidebar":"v5SideBar"},"v5/abandon/margin-coin-info":{"id":"v5/abandon/margin-coin-info","title":"Get Margin Coin Info","description":"HTTP Request","sidebar":"v5SideBar"},"v5/abandon/order-record":{"id":"v5/abandon/order-record","title":"Get Order Records","description":"Get lending or redeem history","sidebar":"v5SideBar"},"v5/abandon/redeem":{"id":"v5/abandon/redeem","title":"Redeem Funds","description":"Withdraw funds from the Bybit asset pool.","sidebar":"v5SideBar"},"v5/account/account-info":{"id":"v5/account/account-info","title":"Get Account Info","description":"Query the margin mode configuration of the account.","sidebar":"v5SideBar"},"v5/account/batch-set-collateral":{"id":"v5/account/batch-set-collateral","title":"Batch Set Collateral Coin","description":"HTTP Request","sidebar":"v5SideBar"},"v5/account/borrow-history":{"id":"v5/account/borrow-history","title":"Get Borrow History","description":"Get interest records, sorted in reverse order of creation time.","sidebar":"v5SideBar"},"v5/account/coin-greeks":{"id":"v5/account/coin-greeks","title":"Get Coin Greeks","description":"Get current account Greeks information","sidebar":"v5SideBar"},"v5/account/collateral-info":{"id":"v5/account/collateral-info","title":"Get Collateral Info","description":"Get the collateral information of the current unified margin account, including loan interest rate, loanable amount, collateral conversion rate, whether it can be mortgaged as margin, etc.","sidebar":"v5SideBar"},"v5/account/contract-transaction-log":{"id":"v5/account/contract-transaction-log","title":"Get Transaction Log","description":"Query transaction logs in the derivatives wallet (classic account), and inverse derivatives wallet (upgraded to UTA)","sidebar":"v5SideBar"},"v5/account/dcp-info":{"id":"v5/account/dcp-info","title":"Get DCP Info","description":"Query the DCP configuration of the account\'s contracts (USDT perpetual, USDC perpetual and USDC Futures) / spot / options. Before calling the interface, please make sure you have applied for the UTA account DCP configuration with your account manager","sidebar":"v5SideBar"},"v5/account/fee-rate":{"id":"v5/account/fee-rate","title":"Get Fee Rate","description":"Get the trading fee rate.","sidebar":"v5SideBar"},"v5/account/get-mmp-state":{"id":"v5/account/get-mmp-state","title":"Get MMP State","description":"HTTP Request","sidebar":"v5SideBar"},"v5/account/repay-liability":{"id":"v5/account/repay-liability","title":"Repay Liability","description":"You can manually repay the liabilities of Unified account","sidebar":"v5SideBar"},"v5/account/reset-mmp":{"id":"v5/account/reset-mmp","title":"Reset MMP","description":"* Once the mmp triggered, you can unfreeze the account by this endpoint, then qtyLimit and deltaLimit will be reset to 0.","sidebar":"v5SideBar"},"v5/account/set-collateral":{"id":"v5/account/set-collateral","title":"Set Collateral Coin","description":"You can decide whether the assets in the Unified account needs to be collateral coins.","sidebar":"v5SideBar"},"v5/account/set-margin-mode":{"id":"v5/account/set-margin-mode","title":"Set Margin Mode","description":"Default is regular margin mode","sidebar":"v5SideBar"},"v5/account/set-mmp":{"id":"v5/account/set-mmp","title":"Set MMP","description":"What is MMP?","sidebar":"v5SideBar"},"v5/account/set-spot-hedge":{"id":"v5/account/set-spot-hedge","title":"Set Spot Hedging","description":"You can turn on/off Spot hedging feature in Portfolio margin for Unified account.","sidebar":"v5SideBar"},"v5/account/smp-group":{"id":"v5/account/smp-group","title":"Get SMP Group ID","description":"Query the SMP group ID of self match prevention","sidebar":"v5SideBar"},"v5/account/transaction-log":{"id":"v5/account/transaction-log","title":"Get Transaction Log","description":"Query transaction logs in Unified account, it supports up to 2 years data","sidebar":"v5SideBar"},"v5/account/upgrade-unified-account":{"id":"v5/account/upgrade-unified-account","title":"Upgrade to Unified Account","description":"Upgrade Unified Account","sidebar":"v5SideBar"},"v5/account/wallet-balance":{"id":"v5/account/wallet-balance","title":"Get Wallet Balance","description":"Obtain wallet balance, query asset information of each currency, and account risk rate information. By default, currency","sidebar":"v5SideBar"},"v5/announcement":{"id":"v5/announcement","title":"Get Announcement","description":"HTTP Request","sidebar":"v5SideBar"},"v5/asset/balance/account-coin-balance":{"id":"v5/asset/balance/account-coin-balance","title":"Get Single Coin Balance","description":"Query the balance of a specific coin in a specific account type. Supports querying sub UID\'s balance.","sidebar":"v5SideBar"},"v5/asset/balance/all-balance":{"id":"v5/asset/balance/all-balance","title":"Get All Coins Balance","description":"You could get all coin balance of all account types under the master account, and sub account.","sidebar":"v5SideBar"},"v5/asset/balance/asset-info":{"id":"v5/asset/balance/asset-info","title":"Get Asset Info","description":"Query asset information","sidebar":"v5SideBar"},"v5/asset/balance/delay-amount":{"id":"v5/asset/balance/delay-amount","title":"Get Withdrawable Amount","description":"How can partial funds be subject to delayed withdrawal requests?","sidebar":"v5SideBar"},"v5/asset/coin-info":{"id":"v5/asset/coin-info","title":"Get Coin Info","description":"Query coin information, including chain information, withdraw and deposit status.","sidebar":"v5SideBar"},"v5/asset/convert/apply-quote":{"id":"v5/asset/convert/apply-quote","title":"Request a Quote","description":"HTTP Request","sidebar":"v5SideBar"},"v5/asset/convert/confirm-quote":{"id":"v5/asset/convert/confirm-quote","title":"Confirm a Quote","description":"1. The exchange is async, please check the final status by calling query result API.","sidebar":"v5SideBar"},"v5/asset/convert/convert-coin-list":{"id":"v5/asset/convert/convert-coin-list","title":"Get Convert Coin List","description":"You can query the coin list of convert from (to).","sidebar":"v5SideBar"},"v5/asset/convert/get-convert-history":{"id":"v5/asset/convert/get-convert-history","title":"Get Convert history","description":"Those confirmed quotes no matter status are showns by this API.","sidebar":"v5SideBar"},"v5/asset/convert/get-convert-result":{"id":"v5/asset/convert/get-convert-result","title":"Get Convert Status","description":"You can query the exchange result by sending quoteTxId.","sidebar":"v5SideBar"},"v5/asset/convert/guideline":{"id":"v5/asset/convert/guideline","title":"Convert Guideline","description":"* All convert api need authentication","sidebar":"v5SideBar"},"v5/asset/delivery":{"id":"v5/asset/delivery","title":"Get Delivery Record","description":"Query delivery records of USDC futures and Options, sorted by deliveryTime in descending order","sidebar":"v5SideBar"},"v5/asset/deposit/deposit-coin-spec":{"id":"v5/asset/deposit/deposit-coin-spec","title":"Get Allowed Deposit Coin Info","description":"Query allowed deposit coin information. To find out paired chain of coin, please refer coin info api.","sidebar":"v5SideBar"},"v5/asset/deposit/deposit-record":{"id":"v5/asset/deposit/deposit-record","title":"Get Deposit Records (on-chain)","description":"Query deposit records.","sidebar":"v5SideBar"},"v5/asset/deposit/internal-deposit-record":{"id":"v5/asset/deposit/internal-deposit-record","title":"Get Internal Deposit Records (off-chain)","description":"Query deposit records within the Bybit platform. These transactions are not on the blockchain.","sidebar":"v5SideBar"},"v5/asset/deposit/master-deposit-addr":{"id":"v5/asset/deposit/master-deposit-addr","title":"Get Master Deposit Address","description":"Query the deposit address information of MASTER account.","sidebar":"v5SideBar"},"v5/asset/deposit/set-deposit-acct":{"id":"v5/asset/deposit/set-deposit-acct","title":"Set Deposit Account","description":"Set auto transfer account after deposit. The same function as the setting for Deposit on web GUI","sidebar":"v5SideBar"},"v5/asset/deposit/sub-deposit-addr":{"id":"v5/asset/deposit/sub-deposit-addr","title":"Get Sub Deposit Address","description":"Query the deposit address information of SUB account.","sidebar":"v5SideBar"},"v5/asset/deposit/sub-deposit-record":{"id":"v5/asset/deposit/sub-deposit-record","title":"Get Sub Deposit Records (on-chain)","description":"Query subaccount\'s deposit records by main UID\'s API key.","sidebar":"v5SideBar"},"v5/asset/exchange":{"id":"v5/asset/exchange","title":"Get Coin Exchange Records","description":"Query the coin exchange records.","sidebar":"v5SideBar"},"v5/asset/settlement":{"id":"v5/asset/settlement","title":"Get USDC Session Settlement","description":"Query session settlement records of USDC perpetual and futures","sidebar":"v5SideBar"},"v5/asset/sub-uid-list":{"id":"v5/asset/sub-uid-list","title":"Get Sub UID","description":"Query the sub UIDs under a main UID. It returns up to 2000 sub accounts, if you need more, please call this endpoint.","sidebar":"v5SideBar"},"v5/asset/transfer/create-inter-transfer":{"id":"v5/asset/transfer/create-inter-transfer","title":"Create Internal Transfer","description":"Create the internal transfer between different account types under the same UID.","sidebar":"v5SideBar"},"v5/asset/transfer/inter-transfer-list":{"id":"v5/asset/transfer/inter-transfer-list","title":"Get Internal Transfer Records","description":"Query the internal transfer records between different account types under the same UID.","sidebar":"v5SideBar"},"v5/asset/transfer/transferable-coin":{"id":"v5/asset/transfer/transferable-coin","title":"Get Transferable Coin","description":"Query the transferable coin list between each account type","sidebar":"v5SideBar"},"v5/asset/transfer/unitransfer":{"id":"v5/asset/transfer/unitransfer","title":"Create Universal Transfer","description":"Transfer between sub-sub or main-sub.","sidebar":"v5SideBar"},"v5/asset/transfer/unitransfer-list":{"id":"v5/asset/transfer/unitransfer-list","title":"Get Universal Transfer Records","description":"Query universal transfer records","sidebar":"v5SideBar"},"v5/asset/withdraw/cancel-withdraw":{"id":"v5/asset/withdraw/cancel-withdraw","title":"Cancel Withdrawal","description":"Cancel the withdrawal","sidebar":"v5SideBar"},"v5/asset/withdraw/vasp-list":{"id":"v5/asset/withdraw/vasp-list","title":"Get Exchange Entity List","description":"This endpoint is particularly used for kyc=KOR users. When withdraw funds, you need to fill entity id.","sidebar":"v5SideBar"},"v5/asset/withdraw/withdraw":{"id":"v5/asset/withdraw/withdraw","title":"Withdraw","description":"Withdraw assets from your Bybit account. You can make an off-chain transfer if the target wallet address is from Bybit. This means that no blockchain fee will be charged.","sidebar":"v5SideBar"},"v5/asset/withdraw/withdraw-record":{"id":"v5/asset/withdraw/withdraw-record","title":"Get Withdrawal Records","description":"Query withdrawal records.","sidebar":"v5SideBar"},"v5/backup/set-pledge-token":{"id":"v5/backup/set-pledge-token","title":"Set Pledge Token","description":"Set Pledge Token in cross margin"},"v5/broker/account-info":{"id":"v5/broker/account-info","title":"Get Exchange Broker Account Info","description":"* Use exchange broker master account to query","sidebar":"v5SideBar"},"v5/broker/exchange-earning":{"id":"v5/broker/exchange-earning","title":"Get Exchange Broker Earning","description":"* Use exchange broker master account to query","sidebar":"v5SideBar"},"v5/broker/sub-deposit-record":{"id":"v5/broker/sub-deposit-record","title":"Get Sub Account Deposit Records","description":"Exchange broker can query subaccount\'s deposit records by main UID\'s API key without specifying uid.","sidebar":"v5SideBar"},"v5/copytrade":{"id":"v5/copytrade","title":"How To Start Copy Trading","description":"Become A Master Trader","sidebar":"v5SideBar"},"v5/demo":{"id":"v5/demo","title":"Demo Trading Service","description":"Introduction","sidebar":"v5SideBar"},"v5/enum":{"id":"v5/enum","title":"Enums Definitions","description":"locale","sidebar":"v5SideBar"},"v5/error":{"id":"v5/error","title":"Error Codes","description":"HTTP Code","sidebar":"v5SideBar"},"v5/guide":{"id":"v5/guide","title":"Integration Guidance","description":"To learn more about the V5 API, please read the Introduction.","sidebar":"v5SideBar"},"v5/intro":{"id":"v5/intro","title":"Introduction","description":"Overview","sidebar":"v5SideBar"},"v5/lt/leverage-token-info":{"id":"v5/lt/leverage-token-info","title":"Get Leverage Token Info","description":"Query leverage token information","sidebar":"v5SideBar"},"v5/lt/leverage-token-reference":{"id":"v5/lt/leverage-token-reference","title":"Get Leveraged Token Market","description":"Get leverage token market information","sidebar":"v5SideBar"},"v5/lt/order-record":{"id":"v5/lt/order-record","title":"Get Purchase/Redemption Records","description":"Get purchase or redeem history","sidebar":"v5SideBar"},"v5/lt/purchase":{"id":"v5/lt/purchase","title":"Purchase","description":"Purchase levearge token","sidebar":"v5SideBar"},"v5/lt/redeem":{"id":"v5/lt/redeem","title":"Redeem","description":"Redeem leverage token","sidebar":"v5SideBar"},"v5/market/delivery-price":{"id":"v5/market/delivery-price","title":"Get Delivery Price","description":"Get the delivery price.","sidebar":"v5SideBar"},"v5/market/history-fund-rate":{"id":"v5/market/history-fund-rate","title":"Get Funding Rate History","description":"Query for historical funding rates. Each symbol has a different funding interval. For example, if the interval is 8 hours and the current time is UTC 12, then it returns the last funding rate, which settled at UTC 8.","sidebar":"v5SideBar"},"v5/market/index-kline":{"id":"v5/market/index-kline","title":"Get Index Price Kline","description":"Query for historical index price klines. Charts are returned in groups based on the requested interval.","sidebar":"v5SideBar"},"v5/market/instrument":{"id":"v5/market/instrument","title":"Get Instruments Info","description":"Query for the instrument specification of online trading pairs.","sidebar":"v5SideBar"},"v5/market/insurance":{"id":"v5/market/insurance","title":"Get Insurance","description":"Query for Bybit insurance pool data (BTC/USDT/USDC etc). The data is updated every 24 hours.","sidebar":"v5SideBar"},"v5/market/iv":{"id":"v5/market/iv","title":"Get Historical Volatility","description":"Query option historical volatility","sidebar":"v5SideBar"},"v5/market/kline":{"id":"v5/market/kline","title":"Get Kline","description":"Query for historical klines (also known as candles/candlesticks). Charts are returned in groups based on the requested interval.","sidebar":"v5SideBar"},"v5/market/long-short-ratio":{"id":"v5/market/long-short-ratio","title":"Get Long Short Ratio","description":"HTTP Request","sidebar":"v5SideBar"},"v5/market/mark-kline":{"id":"v5/market/mark-kline","title":"Get Mark Price Kline","description":"Query for historical mark price klines. Charts are returned in groups based on the requested interval.","sidebar":"v5SideBar"},"v5/market/open-interest":{"id":"v5/market/open-interest","title":"Get Open Interest","description":"Get the open interest of each symbol.","sidebar":"v5SideBar"},"v5/market/orderbook":{"id":"v5/market/orderbook","title":"Get Orderbook","description":"Query for orderbook depth data.","sidebar":"v5SideBar"},"v5/market/preimum-index-kline":{"id":"v5/market/preimum-index-kline","title":"Get Premium Index Price Kline","description":"Query for historical premium index klines. Charts are returned in groups based on the requested interval.","sidebar":"v5SideBar"},"v5/market/recent-trade":{"id":"v5/market/recent-trade","title":"Get Public Recent Trading History","description":"Query recent public trading data in Bybit.","sidebar":"v5SideBar"},"v5/market/risk-limit":{"id":"v5/market/risk-limit","title":"Get Risk Limit","description":"Query for the risk limit.","sidebar":"v5SideBar"},"v5/market/tickers":{"id":"v5/market/tickers","title":"Get Tickers","description":"Query for the latest price snapshot, best bid/ask price, and trading volume in the last 24 hours.","sidebar":"v5SideBar"},"v5/market/time":{"id":"v5/market/time","title":"Get Bybit Server Time","description":"HTTP Request","sidebar":"v5SideBar"},"v5/order/amend-order":{"id":"v5/order/amend-order","title":"Amend Order","description":"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option","sidebar":"v5SideBar"},"v5/order/batch-amend":{"id":"v5/order/batch-amend","title":"Batch Amend Order","description":"Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)","sidebar":"v5SideBar"},"v5/order/batch-cancel":{"id":"v5/order/batch-cancel","title":"Batch Cancel Order","description":"This endpoint allows you to cancel more than one open order in a single request.","sidebar":"v5SideBar"},"v5/order/batch-place":{"id":"v5/order/batch-place","title":"Batch Place Order","description":"Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)","sidebar":"v5SideBar"},"v5/order/cancel-all":{"id":"v5/order/cancel-all","title":"Cancel All Orders","description":"Cancel all open orders","sidebar":"v5SideBar"},"v5/order/cancel-order":{"id":"v5/order/cancel-order","title":"Cancel Order","description":"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options","sidebar":"v5SideBar"},"v5/order/create-order":{"id":"v5/order/create-order","title":"Place Order","description":"This endpoint supports to create the order for spot, spot margin, USDT perpetual, USDC perpetual, USDC futures, inverse futures and options.","sidebar":"v5SideBar"},"v5/order/dcp":{"id":"v5/order/dcp","title":"Set Disconnect Cancel All","description":"Covers: Futures / Spot / Option (Unified Account)","sidebar":"v5SideBar"},"v5/order/execution":{"id":"v5/order/execution","title":"Get Trade History","description":"Query users\' execution records, sorted by execTime in descending order. However, for Classic spot, they are sorted by execId in descending order.","sidebar":"v5SideBar"},"v5/order/open-order":{"id":"v5/order/open-order","title":"Get Open & Closed Orders","description":"Primarily query unfilled or partially filled orders in real-time, but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param openOnly.","sidebar":"v5SideBar"},"v5/order/order-list":{"id":"v5/order/order-list","title":"Get Order History","description":"Query order history. As order creation/cancellation is asynchronous, the data returned from this endpoint may delay. If you want to get","sidebar":"v5SideBar"},"v5/order/spot-borrow-quota":{"id":"v5/order/spot-borrow-quota","title":"Get Borrow Quota (Spot)","description":"Query the available balance for Spot trading and Margin trading","sidebar":"v5SideBar"},"v5/otc/bind-uid":{"id":"v5/otc/bind-uid","title":"Bind Or Unbind UID","description":"For the institutional loan product, you can bind new UIDs to the risk unit or unbind UID from the risk unit.","sidebar":"v5SideBar"},"v5/otc/loan-info":{"id":"v5/otc/loan-info","title":"Get Loan Orders","description":"Get loan orders information","sidebar":"v5SideBar"},"v5/otc/ltv-convert":{"id":"v5/otc/ltv-convert","title":"Get LTV","description":"Get your loan-to-value (LTV) ratio.","sidebar":"v5SideBar"},"v5/otc/margin-coin-convert-info":{"id":"v5/otc/margin-coin-convert-info","title":"Get Margin Coin Info","description":"* This endpoint can be queried without api key and secret, then it returns public margin data","sidebar":"v5SideBar"},"v5/otc/margin-product-info":{"id":"v5/otc/margin-product-info","title":"Get Product Info","description":"* This endpoint can be queried without api key and secret, then it returns public product data","sidebar":"v5SideBar"},"v5/otc/repay-info":{"id":"v5/otc/repay-info","title":"Get Repayment Orders","description":"Get a list of your loan repayment orders (orders which repaid the loan).","sidebar":"v5SideBar"},"v5/position/auto-add-margin":{"id":"v5/position/auto-add-margin","title":"Set Auto Add Margin","description":"Turn on/off auto-add-margin for isolated margin position","sidebar":"v5SideBar"},"v5/position/close-pnl":{"id":"v5/position/close-pnl","title":"Get Closed PnL","description":"Query user\'s closed profit and loss records","sidebar":"v5SideBar"},"v5/position/confirm-mmr":{"id":"v5/position/confirm-mmr","title":"Confirm New Risk Limit","description":"It is only applicable when the user is marked as only reducing positions (please see the isReduceOnly field in","sidebar":"v5SideBar"},"v5/position/cross-isolate":{"id":"v5/position/cross-isolate","title":"Switch Cross/Isolated Margin","description":"Select cross margin mode or isolated margin mode per symbol level","sidebar":"v5SideBar"},"v5/position/leverage":{"id":"v5/position/leverage","title":"Set Leverage","description":"Set the leverage","sidebar":"v5SideBar"},"v5/position/manual-add-margin":{"id":"v5/position/manual-add-margin","title":"Add Or Reduce Margin","description":"Manually add or reduce margin for isolated margin position","sidebar":"v5SideBar"},"v5/position/move-position":{"id":"v5/position/move-position","title":"Move Position","description":"You can move positions between sub-master, master-sub, or sub-sub UIDs when necessary","sidebar":"v5SideBar"},"v5/position/move-position-history":{"id":"v5/position/move-position-history","title":"Get Move Position History","description":"You can query moved position data by master UID api key","sidebar":"v5SideBar"},"v5/position/position":{"id":"v5/position/position","title":"Get Position Info","description":"Query real-time position data, such as position size, cumulative realizedPNL.","sidebar":"v5SideBar"},"v5/position/position-mode":{"id":"v5/position/position-mode","title":"Switch Position Mode","description":"It supports to switch the position mode for USDT perpetual and Inverse futures. If you are in one-way Mode, you can only open one position on Buy or Sell side. If you are in hedge mode, you can open both Buy and Sell side positions simultaneously.","sidebar":"v5SideBar"},"v5/position/set-risk-limit":{"id":"v5/position/set-risk-limit","title":"Set Risk Limit","description":"Since bybit has launched auto risk limit on 12 March 2024, please click here to learn more, so it will not take effect even you set it successfully.","sidebar":"v5SideBar"},"v5/position/tpsl-mode":{"id":"v5/position/tpsl-mode","title":"Set TP/SL Mode","description":"_To some extent, this endpoint is depreciated because now tpsl is based on order level. This API was used for position level","sidebar":"v5SideBar"},"v5/position/trading-stop":{"id":"v5/position/trading-stop","title":"Set Trading Stop","description":"Set the take profit, stop loss or trailing stop for the position.","sidebar":"v5SideBar"},"v5/pre-upgrade/close-pnl":{"id":"v5/pre-upgrade/close-pnl","title":"Get Pre-upgrade Closed PnL","description":"Query user\'s closed profit and loss records from before you upgraded the account to a Unified account. The results are sorted by updatedTime in descending order.","sidebar":"v5SideBar"},"v5/pre-upgrade/delivery":{"id":"v5/pre-upgrade/delivery","title":"Get Pre-upgrade Option Delivery Record","description":"Query delivery records of Option before you upgraded the account to a Unified account, sorted by deliveryTime in descending order","sidebar":"v5SideBar"},"v5/pre-upgrade/execution":{"id":"v5/pre-upgrade/execution","title":"Get Pre-upgrade Trade History","description":"Get users\' execution records which occurred before you upgraded the account to a Unified account, sorted by execTime in descending order","sidebar":"v5SideBar"},"v5/pre-upgrade/order-list":{"id":"v5/pre-upgrade/order-list","title":"Get Pre-upgrade Order History","description":"After the account is upgraded to a Unified account, you can get the orders which occurred before the upgrade.","sidebar":"v5SideBar"},"v5/pre-upgrade/settlement":{"id":"v5/pre-upgrade/settlement","title":"Get Pre-upgrade USDC Session Settlement","description":"Query session settlement records of USDC perpetual before you upgrade the account to Unified account.","sidebar":"v5SideBar"},"v5/pre-upgrade/transaction-log":{"id":"v5/pre-upgrade/transaction-log","title":"Get Pre-upgrade Transaction Log","description":"Query transaction logs which occurred in the USDC Derivatives wallet before the account was upgraded to a Unified account.","sidebar":"v5SideBar"},"v5/rate-limit":{"id":"v5/rate-limit","title":"Rate Limit","description":"IP Rate Limit","sidebar":"v5SideBar"},"v5/smp":{"id":"v5/smp","title":"Self Match Prevention","description":"What is SMP?","sidebar":"v5SideBar"},"v5/spot-margin-normal/account-info":{"id":"v5/spot-margin-normal/account-info","title":"Get Loan Account Info","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/borrow":{"id":"v5/spot-margin-normal/borrow","title":"Borrow","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/borrow-order":{"id":"v5/spot-margin-normal/borrow-order","title":"Get Borrow Order Detail","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/borrowable-data":{"id":"v5/spot-margin-normal/borrowable-data","title":"Get Borrowable Coin Info","description":"Do not need authentication"},"v5/spot-margin-normal/interest-quota":{"id":"v5/spot-margin-normal/interest-quota","title":"Get Interest & Quota","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/margin-data":{"id":"v5/spot-margin-normal/margin-data","title":"Get Margin Coin Info","description":"Do not need authentication"},"v5/spot-margin-normal/repay":{"id":"v5/spot-margin-normal/repay","title":"Repay","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/repay-order":{"id":"v5/spot-margin-normal/repay-order","title":"Get Repayment Order Detail","description":"Covers: Margin trade (Classic Account)"},"v5/spot-margin-normal/switch-mode":{"id":"v5/spot-margin-normal/switch-mode","title":"Toggle Margin Trade","description":"Turn on / off spot margin trade"},"v5/spot-margin-normal/vip-margin":{"id":"v5/spot-margin-normal/vip-margin","title":"Get VIP Margin Data","description":"This margin data is for Classic account in particular."},"v5/spot-margin-uta/historical-interest":{"id":"v5/spot-margin-uta/historical-interest","title":"Get Historical Interest Rate","description":"You can query up to six months borrowing interest rate of Margin trading.","sidebar":"v5SideBar"},"v5/spot-margin-uta/set-leverage":{"id":"v5/spot-margin-uta/set-leverage","title":"Set Leverage","description":"Set the user\'s maximum leverage in spot cross margin","sidebar":"v5SideBar"},"v5/spot-margin-uta/status":{"id":"v5/spot-margin-uta/status","title":"Get Status And Leverage","description":"Query the Spot margin status and leverage of Unified account","sidebar":"v5SideBar"},"v5/spot-margin-uta/switch-mode":{"id":"v5/spot-margin-uta/switch-mode","title":"Toggle Margin Trade","description":"Turn on / off spot margin trade","sidebar":"v5SideBar"},"v5/spot-margin-uta/vip-margin":{"id":"v5/spot-margin-uta/vip-margin","title":"Get VIP Margin Data","description":"This margin data is for Unified account in particular.","sidebar":"v5SideBar"},"v5/user/affiliate-info":{"id":"v5/user/affiliate-info","title":"Get Affiliate User Info","description":"To use this endpoint, you should have an affiliate account and only tick \\"affiliate\\" permission while creating the API key.","sidebar":"v5SideBar"},"v5/user/apikey-info":{"id":"v5/user/apikey-info","title":"Get API Key Information","description":"Get the information of the api key. Use the api key pending to be checked to call the endpoint. Both master and sub user\'s api key are applicable.","sidebar":"v5SideBar"},"v5/user/create-subuid":{"id":"v5/user/create-subuid","title":"Create Sub UID","description":"Create a new sub user id. Use master account\'s api key.","sidebar":"v5SideBar"},"v5/user/create-subuid-apikey":{"id":"v5/user/create-subuid-apikey","title":"Create Sub UID API Key","description":"To create new API key for those newly created sub UID. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/froze-subuid":{"id":"v5/user/froze-subuid","title":"Freeze Sub UID","description":"Freeze Sub UID. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/list-sub-apikeys":{"id":"v5/user/list-sub-apikeys","title":"Get Sub Account All API Keys","description":"Query all api keys information of a sub UID.","sidebar":"v5SideBar"},"v5/user/modify-master-apikey":{"id":"v5/user/modify-master-apikey","title":"Modify Master API Key","description":"Modify the settings of master api key. Use the api key pending to be modified to call the endpoint. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/modify-sub-apikey":{"id":"v5/user/modify-sub-apikey","title":"Modify Sub API Key","description":"Modify the settings of sub api key. Use the sub account api key pending to be modified to call the endpoint or use master","sidebar":"v5SideBar"},"v5/user/page-subuid":{"id":"v5/user/page-subuid","title":"Get Sub UID List (Unlimited)","description":"This API is applicable to the client who has over 10k sub accounts. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/rm-master-apikey":{"id":"v5/user/rm-master-apikey","title":"Delete Master API Key","description":"Delete the api key of master account. Use the api key pending to be delete to call the endpoint. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/rm-sub-apikey":{"id":"v5/user/rm-sub-apikey","title":"Delete Sub API Key","description":"Delete the api key of sub account. Use the sub api key pending to be delete to call the endpoint or use the master api key","sidebar":"v5SideBar"},"v5/user/rm-subuid":{"id":"v5/user/rm-subuid","title":"Delete Sub UID","description":"Delete a sub UID. Before deleting the UID, please make sure there is no asset.","sidebar":"v5SideBar"},"v5/user/subuid-list":{"id":"v5/user/subuid-list","title":"Get Sub UID List (Limited)","description":"Get at most 10k sub UID of master account. Use master user\'s api key only.","sidebar":"v5SideBar"},"v5/user/wallet-type":{"id":"v5/user/wallet-type","title":"Get UID Wallet Type","description":"Get available wallet types for the master account or sub account","sidebar":"v5SideBar"},"v5/websocket/private/dcp":{"id":"v5/websocket/private/dcp","title":"Dcp","description":"Subscribe to the dcp stream to trigger DCP function.","sidebar":"v5SideBar"},"v5/websocket/private/execution":{"id":"v5/websocket/private/execution","title":"Execution","description":"Subscribe to the execution stream to see your executions in real-time.","sidebar":"v5SideBar"},"v5/websocket/private/fast-execution":{"id":"v5/websocket/private/fast-execution","title":"Fast Execution","description":"Fast execution stream significantly reduces data latency compared original \\"execution\\" stream. However, it pushes limited","sidebar":"v5SideBar"},"v5/websocket/private/greek":{"id":"v5/websocket/private/greek","title":"Greek","description":"Subscribe to the greeks stream to see changes to your greeks data in real-time. option only.","sidebar":"v5SideBar"},"v5/websocket/private/order":{"id":"v5/websocket/private/order","title":"Order","description":"Subscribe to the order stream to see changes to your orders in real-time.","sidebar":"v5SideBar"},"v5/websocket/private/position":{"id":"v5/websocket/private/position","title":"Position","description":"Subscribe to the position stream to see changes to your position data in real-time.","sidebar":"v5SideBar"},"v5/websocket/private/wallet":{"id":"v5/websocket/private/wallet","title":"Wallet","description":"Subscribe to the wallet stream to see changes to your wallet in real-time.","sidebar":"v5SideBar"},"v5/websocket/public/etp-kline":{"id":"v5/websocket/public/etp-kline","title":"LT Kline","description":"Subscribe to the leveraged token kline stream.","sidebar":"v5SideBar"},"v5/websocket/public/etp-nav":{"id":"v5/websocket/public/etp-nav","title":"LT Nav","description":"Subscribe to the leveraged token nav stream.","sidebar":"v5SideBar"},"v5/websocket/public/etp-ticker":{"id":"v5/websocket/public/etp-ticker","title":"LT Ticker","description":"Subscribe to the leveraged token ticker stream.","sidebar":"v5SideBar"},"v5/websocket/public/kline":{"id":"v5/websocket/public/kline","title":"Kline","description":"Subscribe to the klines stream.","sidebar":"v5SideBar"},"v5/websocket/public/liquidation":{"id":"v5/websocket/public/liquidation","title":"Liquidation","description":"Subscribe to the liquidation stream, at most one order is published per second per symbol","sidebar":"v5SideBar"},"v5/websocket/public/orderbook":{"id":"v5/websocket/public/orderbook","title":"Orderbook","description":"Subscribe to the orderbook stream. Supports different depths.","sidebar":"v5SideBar"},"v5/websocket/public/ticker":{"id":"v5/websocket/public/ticker","title":"Ticker","description":"Subscribe to the ticker stream.","sidebar":"v5SideBar"},"v5/websocket/public/trade":{"id":"v5/websocket/public/trade","title":"Trade","description":"Subscribe to the recent trades stream.","sidebar":"v5SideBar"},"v5/websocket/trade/guideline":{"id":"v5/websocket/trade/guideline","title":"Websocket Trade Guideline","description":"URL","sidebar":"v5SideBar"},"v5/websocket/wss-authentication":{"id":"v5/websocket/wss-authentication","title":"Connect","description":"WebSocket public stream:","sidebar":"v5SideBar"}}}')}}]); \ No newline at end of file diff --git a/assets/js/af1ac92b.1c52efcc.js b/assets/js/af1ac92b.1c52efcc.js new file mode 100644 index 0000000000..abdf2a8ff6 --- /dev/null +++ b/assets/js/af1ac92b.1c52efcc.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[34288],{3905:(e,t,r)=>{r.d(t,{Zo:()=>s,kt:()=>u});var n=r(67294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function l(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function o(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var d=n.createContext({}),p=function(e){var t=n.useContext(d),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},s=function(e){var t=p(e.components);return n.createElement(d.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,l=e.originalType,d=e.parentName,s=i(e,["components","mdxType","originalType","parentName"]),m=p(r),u=a,k=m["".concat(d,".").concat(u)]||m[u]||c[u]||l;return r?n.createElement(k,o(o({ref:t},s),{},{components:r})):n.createElement(k,o({ref:t},s))}));function u(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var l=r.length,o=new Array(l);o[0]=m;var i={};for(var d in t)hasOwnProperty.call(t,d)&&(i[d]=t[d]);i.originalType=e,i.mdxType="string"==typeof e?e:a,o[1]=i;for(var p=2;p{r.r(t),r.d(t,{assets:()=>d,contentTitle:()=>o,default:()=>f,frontMatter:()=>l,metadata:()=>i,toc:()=>p});var n=r(87462),a=(r(67294),r(3905));const l={title:"Cancel Order",sidebar_label:"Cancel Order",sidebar_position:3},o=void 0,i={unversionedId:"v5/order/cancel-order",id:"v5/order/cancel-order",title:"Cancel Order",description:"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options",source:"@site/docs/v5/order/cancel-order.mdx",sourceDirName:"v5/order",slug:"/v5/order/cancel-order",permalink:"/docs/v5/order/cancel-order",draft:!1,tags:[],version:"current",sidebarPosition:3,frontMatter:{title:"Cancel Order",sidebar_label:"Cancel Order",sidebar_position:3},sidebar:"v5SideBar",previous:{title:"Amend Order",permalink:"/docs/v5/order/amend-order"},next:{title:"Get Open & Closed Orders",permalink:"/docs/v5/order/open-order"}},d={},p=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],s=e=>function(t){return console.warn("Component "+e+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",t)},c=s("Button"),m=s("Tabs"),u=s("TabItem"),k={toc:p};function f(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,n.Z)({},k,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options"),(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Classic account covers: Spot / USDT perpetual / Inverse contract"))),(0,a.kt)("admonition",{title:"important",type:"info"},(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"You must specify ",(0,a.kt)("inlineCode",{parentName:"li"},"orderId")," or ",(0,a.kt)("inlineCode",{parentName:"li"},"orderLinkId")," to cancel the order."),(0,a.kt)("li",{parentName:"ul"},"If ",(0,a.kt)("inlineCode",{parentName:"li"},"orderId")," and ",(0,a.kt)("inlineCode",{parentName:"li"},"orderLinkId")," do not match, the system will process ",(0,a.kt)("inlineCode",{parentName:"li"},"orderId")," first."),(0,a.kt)("li",{parentName:"ul"},"You can only cancel ",(0,a.kt)("strong",{parentName:"li"},"unfilled")," or ",(0,a.kt)("strong",{parentName:"li"},"partially filled")," orders."))),(0,a.kt)("h3",{id:"http-request"},"HTTP Request"),(0,a.kt)("p",null,"POST ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/cancel")),(0,a.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("a",{parentName:"td",href:"../enum#category"},"category")),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Product type ",(0,a.kt)("ul",null,(0,a.kt)("li",null,"Unified account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"option")),(0,a.kt)("li",null,"Classic account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,a.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID. Either ",(0,a.kt)("inlineCode",{parentName:"td"},"orderId")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"orderLinkId")," is ",(0,a.kt)("strong",{parentName:"td"},"required"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID. Either ",(0,a.kt)("inlineCode",{parentName:"td"},"orderId")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"orderLinkId")," is ",(0,a.kt)("strong",{parentName:"td"},"required"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderFilter"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Valid for ",(0,a.kt)("inlineCode",{parentName:"td"},"spot")," ",(0,a.kt)("strong",{parentName:"td"},"only"),". ",(0,a.kt)("inlineCode",{parentName:"td"},"Order"),",",(0,a.kt)("inlineCode",{parentName:"td"},"tpslOrder"),",",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),". If not passed, ",(0,a.kt)("inlineCode",{parentName:"td"},"Order")," by default")))),(0,a.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID")))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("p",{parentName:"admonition"},"The ack of cancel order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status")),(0,a.kt)("a",{href:"/api-explorer/v5/trade/cancel-order"},(0,a.kt)(c,{mdxType:"Button"},"RUN >>")),(0,a.kt)("hr",null),(0,a.kt)("h3",{id:"request-example"},"Request Example"),(0,a.kt)(m,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(u,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},'POST /v5/order/cancel HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672217376681\nX-BAPI-RECV-WINDOW: 5000\nContent-Type: application/json\n\n{\n "category": "linear",\n "symbol": "BTCPERP",\n "orderLinkId": null,\n "orderId":"c6f055d9-7f21-4079-913d-e6523a9cfffa"\n}\n'))),(0,a.kt)(u,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.cancel_order(\n category="linear",\n symbol="BTCPERP",\n orderId="c6f055d9-7f21-4079-913d-e6523a9cfffa",\n))\n'))),(0,a.kt)(u,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.restApi.BybitApiTradeRestClient;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nBybitApiClientFactory factory = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET");\nBybitApiAsyncTradeRestClient client = factory.newAsyncTradeRestClient();\nvar cancelOrderRequest = TradeOrderRequest.builder().category(ProductType.SPOT).symbol("XRPUSDT").orderId("1523347543495541248").build();\nvar canceledOrder = client.cancelOrder(cancelOrderRequest);\nSystem.out.println(canceledOrder);\n'))),(0,a.kt)(u,{value:"DotNet",label:".Net",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-c#"},'using bybit.net.api.ApiServiceImp;\nusing bybit.net.api.Models.Trade;\nBybitTradeService tradeService = new(apiKey: "xxxxxxxxxxxxxx", apiSecret: "xxxxxxxxxxxxxxxxxxxxx");\nvar orderInfoString = await TradeService.CancelOrder(orderId: "1523347543495541248", category: Category.SPOT, symbol: "XRPUSDT");\nConsole.WriteLine(orderInfoString);\n'))),(0,a.kt)(u,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .cancelOrder({\n category: 'linear',\n symbol: 'BTCPERP',\n orderId: 'c6f055d9-7f21-4079-913d-e6523a9cfffa',\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"response-example"},"Response Example"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",\n "orderLinkId": "linear-004"\n },\n "retExtInfo": {},\n "time": 1672217377164\n}\n')))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/af1ac92b.96f99452.js b/assets/js/af1ac92b.96f99452.js deleted file mode 100644 index d65ccda542..0000000000 --- a/assets/js/af1ac92b.96f99452.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[34288],{3905:(e,t,r)=>{r.d(t,{Zo:()=>s,kt:()=>u});var n=r(67294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function l(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function o(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var d=n.createContext({}),p=function(e){var t=n.useContext(d),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},s=function(e){var t=p(e.components);return n.createElement(d.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},m=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,l=e.originalType,d=e.parentName,s=i(e,["components","mdxType","originalType","parentName"]),m=p(r),u=a,k=m["".concat(d,".").concat(u)]||m[u]||c[u]||l;return r?n.createElement(k,o(o({ref:t},s),{},{components:r})):n.createElement(k,o({ref:t},s))}));function u(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var l=r.length,o=new Array(l);o[0]=m;var i={};for(var d in t)hasOwnProperty.call(t,d)&&(i[d]=t[d]);i.originalType=e,i.mdxType="string"==typeof e?e:a,o[1]=i;for(var p=2;p{r.r(t),r.d(t,{assets:()=>d,contentTitle:()=>o,default:()=>f,frontMatter:()=>l,metadata:()=>i,toc:()=>p});var n=r(87462),a=(r(67294),r(3905));const l={title:"Cancel Order",sidebar_label:"Cancel Order",sidebar_position:3},o=void 0,i={unversionedId:"v5/order/cancel-order",id:"v5/order/cancel-order",title:"Cancel Order",description:"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options",source:"@site/docs/v5/order/cancel-order.mdx",sourceDirName:"v5/order",slug:"/v5/order/cancel-order",permalink:"/docs/v5/order/cancel-order",draft:!1,tags:[],version:"current",sidebarPosition:3,frontMatter:{title:"Cancel Order",sidebar_label:"Cancel Order",sidebar_position:3},sidebar:"v5SideBar",previous:{title:"Amend Order",permalink:"/docs/v5/order/amend-order"},next:{title:"Get Open & Closed Orders (real-time)",permalink:"/docs/v5/order/open-order"}},d={},p=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],s=e=>function(t){return console.warn("Component "+e+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",t)},c=s("Button"),m=s("Tabs"),u=s("TabItem"),k={toc:p};function f(e){let{components:t,...r}=e;return(0,a.kt)("wrapper",(0,n.Z)({},k,r,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options"),(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Classic account covers: Spot / USDT perpetual / Inverse contract"))),(0,a.kt)("admonition",{title:"important",type:"info"},(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"You must specify ",(0,a.kt)("inlineCode",{parentName:"li"},"orderId")," or ",(0,a.kt)("inlineCode",{parentName:"li"},"orderLinkId")," to cancel the order."),(0,a.kt)("li",{parentName:"ul"},"If ",(0,a.kt)("inlineCode",{parentName:"li"},"orderId")," and ",(0,a.kt)("inlineCode",{parentName:"li"},"orderLinkId")," do not match, the system will process ",(0,a.kt)("inlineCode",{parentName:"li"},"orderId")," first."),(0,a.kt)("li",{parentName:"ul"},"You can only cancel ",(0,a.kt)("strong",{parentName:"li"},"unfilled")," or ",(0,a.kt)("strong",{parentName:"li"},"partially filled")," orders."))),(0,a.kt)("h3",{id:"http-request"},"HTTP Request"),(0,a.kt)("p",null,"POST ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/cancel")),(0,a.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("a",{parentName:"td",href:"../enum#category"},"category")),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Product type ",(0,a.kt)("ul",null,(0,a.kt)("li",null,"Unified account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"option")),(0,a.kt)("li",null,"Classic account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,a.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID. Either ",(0,a.kt)("inlineCode",{parentName:"td"},"orderId")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"orderLinkId")," is ",(0,a.kt)("strong",{parentName:"td"},"required"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID. Either ",(0,a.kt)("inlineCode",{parentName:"td"},"orderId")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"orderLinkId")," is ",(0,a.kt)("strong",{parentName:"td"},"required"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderFilter"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Valid for ",(0,a.kt)("inlineCode",{parentName:"td"},"spot")," ",(0,a.kt)("strong",{parentName:"td"},"only"),". ",(0,a.kt)("inlineCode",{parentName:"td"},"Order"),",",(0,a.kt)("inlineCode",{parentName:"td"},"tpslOrder"),",",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),". If not passed, ",(0,a.kt)("inlineCode",{parentName:"td"},"Order")," by default")))),(0,a.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID")))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("p",{parentName:"admonition"},"The ack of cancel order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status")),(0,a.kt)("a",{href:"/api-explorer/v5/trade/cancel-order"},(0,a.kt)(c,{mdxType:"Button"},"RUN >>")),(0,a.kt)("hr",null),(0,a.kt)("h3",{id:"request-example"},"Request Example"),(0,a.kt)(m,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(u,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},'POST /v5/order/cancel HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672217376681\nX-BAPI-RECV-WINDOW: 5000\nContent-Type: application/json\n\n{\n "category": "linear",\n "symbol": "BTCPERP",\n "orderLinkId": null,\n "orderId":"c6f055d9-7f21-4079-913d-e6523a9cfffa"\n}\n'))),(0,a.kt)(u,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.cancel_order(\n category="linear",\n symbol="BTCPERP",\n orderId="c6f055d9-7f21-4079-913d-e6523a9cfffa",\n))\n'))),(0,a.kt)(u,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.restApi.BybitApiTradeRestClient;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nBybitApiClientFactory factory = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET");\nBybitApiAsyncTradeRestClient client = factory.newAsyncTradeRestClient();\nvar cancelOrderRequest = TradeOrderRequest.builder().category(ProductType.SPOT).symbol("XRPUSDT").orderId("1523347543495541248").build();\nvar canceledOrder = client.cancelOrder(cancelOrderRequest);\nSystem.out.println(canceledOrder);\n'))),(0,a.kt)(u,{value:"DotNet",label:".Net",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-c#"},'using bybit.net.api.ApiServiceImp;\nusing bybit.net.api.Models.Trade;\nBybitTradeService tradeService = new(apiKey: "xxxxxxxxxxxxxx", apiSecret: "xxxxxxxxxxxxxxxxxxxxx");\nvar orderInfoString = await TradeService.CancelOrder(orderId: "1523347543495541248", category: Category.SPOT, symbol: "XRPUSDT");\nConsole.WriteLine(orderInfoString);\n'))),(0,a.kt)(u,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .cancelOrder({\n category: 'linear',\n symbol: 'BTCPERP',\n orderId: 'c6f055d9-7f21-4079-913d-e6523a9cfffa',\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"response-example"},"Response Example"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",\n "orderLinkId": "linear-004"\n },\n "retExtInfo": {},\n "time": 1672217377164\n}\n')))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/c127b609.3b42ce81.js b/assets/js/c127b609.3b42ce81.js new file mode 100644 index 0000000000..c9e1d45ae1 --- /dev/null +++ b/assets/js/c127b609.3b42ce81.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[11005],{3905:(t,e,r)=>{r.d(e,{Zo:()=>m,kt:()=>g});var n=r(67294);function a(t,e,r){return e in t?Object.defineProperty(t,e,{value:r,enumerable:!0,configurable:!0,writable:!0}):t[e]=r,t}function l(t,e){var r=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),r.push.apply(r,n)}return r}function i(t){for(var e=1;e=0||(a[r]=t[r]);return a}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(t,r)&&(a[r]=t[r])}return a}var o=n.createContext({}),p=function(t){var e=n.useContext(o),r=e;return t&&(r="function"==typeof t?t(e):i(i({},e),t)),r},m=function(t){var e=p(t.components);return n.createElement(o.Provider,{value:e},t.children)},s={inlineCode:"code",wrapper:function(t){var e=t.children;return n.createElement(n.Fragment,{},e)}},k=n.forwardRef((function(t,e){var r=t.components,a=t.mdxType,l=t.originalType,o=t.parentName,m=d(t,["components","mdxType","originalType","parentName"]),k=p(r),g=a,N=k["".concat(o,".").concat(g)]||k[g]||s[g]||l;return r?n.createElement(N,i(i({ref:e},m),{},{components:r})):n.createElement(N,i({ref:e},m))}));function g(t,e){var r=arguments,a=e&&e.mdxType;if("string"==typeof t||a){var l=r.length,i=new Array(l);i[0]=k;var d={};for(var o in e)hasOwnProperty.call(e,o)&&(d[o]=e[o]);d.originalType=t,d.mdxType="string"==typeof t?t:a,i[1]=d;for(var p=2;p{r.r(e),r.d(e,{assets:()=>o,contentTitle:()=>i,default:()=>u,frontMatter:()=>l,metadata:()=>d,toc:()=>p});var n=r(87462),a=(r(67294),r(3905));const l={title:"Get Open & Closed Orders",sidebar_label:"Get Open & Closed Orders",sidebar_position:4},i=void 0,d={unversionedId:"v5/order/open-order",id:"v5/order/open-order",title:"Get Open & Closed Orders",description:"Primarily query unfilled or partially filled orders in real-time, but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param openOnly.",source:"@site/docs/v5/order/open-order.mdx",sourceDirName:"v5/order",slug:"/v5/order/open-order",permalink:"/docs/v5/order/open-order",draft:!1,tags:[],version:"current",sidebarPosition:4,frontMatter:{title:"Get Open & Closed Orders",sidebar_label:"Get Open & Closed Orders",sidebar_position:4},sidebar:"v5SideBar",previous:{title:"Cancel Order",permalink:"/docs/v5/order/cancel-order"},next:{title:"Cancel All Orders",permalink:"/docs/v5/order/cancel-all"}},o={},p=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],m=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",e)},s=m("Button"),k=m("Tabs"),g=m("TabItem"),N={toc:p};function u(t){let{components:e,...r}=t;return(0,a.kt)("wrapper",(0,n.Z)({},N,r,{components:e,mdxType:"MDXLayout"}),(0,a.kt)("p",null,"Primarily query unfilled or partially filled orders in ",(0,a.kt)("strong",{parentName:"p"},"real-time"),", but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param ",(0,a.kt)("inlineCode",{parentName:"p"},"openOnly"),".",(0,a.kt)("br",null),"\nAnd to query older order records, please use the ",(0,a.kt)("a",{parentName:"p",href:"order-list#"},"order history")," interface."),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options"),(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Classic account covers: Spot / USDT perpetual / Inverse contract"))),(0,a.kt)("admonition",{type:"tip"},(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"This endpoint also allows for querying filled, canceled, and rejected orders to the most recent 500 orders for spot, linear, and option categories. The inverse category is not subject to this limitation."),(0,a.kt)("li",{parentName:"ul"},"You can query by symbol, baseCoin, orderId and orderLinkId, and if you pass multiple params, the system will process them according to this priority: orderId > orderLinkId > symbol > baseCoin."),(0,a.kt)("li",{parentName:"ul"},"The records are sorted by the ",(0,a.kt)("inlineCode",{parentName:"li"},"createdTime")," from newest to oldest."))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"Classic account spot can return open orders only"),(0,a.kt)("li",{parentName:"ul"},"After a server release or restart, filled, canceled, and rejected orders of Unified account should only be queried through ",(0,a.kt)("a",{parentName:"li",href:"order-list#"},"order history"),"."))),(0,a.kt)("h3",{id:"http-request"},"HTTP Request"),(0,a.kt)("p",null,"GET ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/realtime")),(0,a.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"category"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Product type ",(0,a.kt)("ul",null,(0,a.kt)("li",null,"Unified account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"option")),(0,a.kt)("li",null,"Classic account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,a.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only. For ",(0,a.kt)("strong",{parentName:"td"},"linear"),", either ",(0,a.kt)("inlineCode",{parentName:"td"},"symbol"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"baseCoin"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"settleCoin")," is ",(0,a.kt)("strong",{parentName:"td"},"required"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"baseCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Base coin, uppercase only ",(0,a.kt)("li",null,"Supports ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"option")),(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"option"),": it returns all option open orders by default"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"settleCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Settle coin, uppercase only ",(0,a.kt)("ul",null,(0,a.kt)("li",null,(0,a.kt)("b",null,"linear"),": either ",(0,a.kt)("inlineCode",{parentName:"td"},"symbol"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"baseCoin")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"settleCoin")," is ",(0,a.kt)("strong",{parentName:"td"},"required")),(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"spot"),": not supported")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"openOnly"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("ul",null,(0,a.kt)("li",null,"Unified account & Classic account: ",(0,a.kt)("inlineCode",{parentName:"td"},"0"),"(default) - query open orders (e.g., New, PartiallyFilled) ",(0,a.kt)("strong",{parentName:"td"},"only")),(0,a.kt)("li",null,"Unified account (spot / linear / option): ",(0,a.kt)("inlineCode",{parentName:"td"},"1"),", Unified account(inverse) & Classic account(linear / inverse): ",(0,a.kt)("inlineCode",{parentName:"td"},"2"),": return a maximum of recent 500 closed status records are kept under each account (e.g., Cancelled, Rejected, Filled orders). ",(0,a.kt)("i",null,"If the Bybit service is restarted due to an update, this part of the data will be cleared and accumulated again, but the order records will still be queried in ",(0,a.kt)("a",{parentName:"td",href:"order-list#"},"order history"))),(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"openOnly")," param will be ignored when query by ",(0,a.kt)("em",{parentName:"td"},"orderId")," or ",(0,a.kt)("em",{parentName:"td"},"orderLinkId")),(0,a.kt)("li",null,"Classic ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),": not supported")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderFilter"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("inlineCode",{parentName:"td"},"Order"),": active order, ",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),": conditional order for Futures and Spot, ",(0,a.kt)("inlineCode",{parentName:"td"},"tpslOrder"),": spot TP/SL order, ",(0,a.kt)("inlineCode",{parentName:"td"},"OcoOrder"),": Spot oco order, ",(0,a.kt)("inlineCode",{parentName:"td"},"BidirectionalTpslOrder"),": Spot bidirectional TPSL order",(0,a.kt)("ul",null,(0,a.kt)("li",null,"Classic account ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),": return ",(0,a.kt)("inlineCode",{parentName:"td"},"Order")," active order by default"),(0,a.kt)("li",null,"Others: all kinds of orders by default")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"limit"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Limit for data size per page. ","[",(0,a.kt)("inlineCode",{parentName:"td"},"1"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"50"),"]",". Default: ",(0,a.kt)("inlineCode",{parentName:"td"},"20"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"cursor"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cursor. Use the ",(0,a.kt)("inlineCode",{parentName:"td"},"nextPageCursor")," token from the response to retrieve the next page of the result set")))),(0,a.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"category"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Product type")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"nextPageCursor"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Refer to the ",(0,a.kt)("inlineCode",{parentName:"td"},"cursor")," request parameter")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"list"),(0,a.kt)("td",{parentName:"tr",align:"left"},"array"),(0,a.kt)("td",{parentName:"tr",align:null},"Object")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> blockTradeId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Paradigm block trade ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Symbol name")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> price"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> qty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order qty")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> side"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Side. ",(0,a.kt)("inlineCode",{parentName:"td"},"Buy"),",",(0,a.kt)("inlineCode",{parentName:"td"},"Sell"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> isLeverage"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Whether to borrow. ",(0,a.kt)("strong",{parentName:"td"},"Unified ",(0,a.kt)("inlineCode",{parentName:"strong"},"spot"))," only. ",(0,a.kt)("inlineCode",{parentName:"td"},"0"),": false, ",(0,a.kt)("inlineCode",{parentName:"td"},"1"),": true. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported, always ",(0,a.kt)("inlineCode",{parentName:"em"},"0")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#positionidx"},"positionIdx")),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Position index. Used to identify positions in different position modes.")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#orderstatus"},"orderStatus")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order status")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#createtype"},"createType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order create type ",(0,a.kt)("li",null,"Only for category=linear or inverse"),(0,a.kt)("li",null,"Spot, Option do not have this key"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#canceltype"},"cancelType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cancel type")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#rejectreason"},"rejectReason")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Reject reason. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> avgPrice"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Average filled price ",(0,a.kt)("li",null,"UTA: returns ",(0,a.kt)("inlineCode",{parentName:"td"},'""')," for those orders without avg price"),(0,a.kt)("li",null,"Classic account: returns ",(0,a.kt)("inlineCode",{parentName:"td"},'"0"')," for those orders without avg price, and also for those orders have partilly filled but cancelled at the end"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> leavesQty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The remaining qty not executed. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> leavesValue"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The estimated value not executed. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> cumExecQty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cumulative executed order qty")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> cumExecValue"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cumulative executed order value. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> cumExecFee"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cumulative executed trading fee. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#timeinforce"},"timeInForce")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Time in force")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#ordertype"},"orderType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order type. ",(0,a.kt)("inlineCode",{parentName:"td"},"Market"),",",(0,a.kt)("inlineCode",{parentName:"td"},"Limit"),". For TP/SL order, it means the order type after triggered")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#stopordertype"},"stopOrderType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Stop order type")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderIv"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Implied volatility")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> marketUnit"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The unit for ",(0,a.kt)("inlineCode",{parentName:"td"},"qty")," when create ",(0,a.kt)("strong",{parentName:"td"},"Spot market")," orders for ",(0,a.kt)("strong",{parentName:"td"},"UTA account"),". ",(0,a.kt)("inlineCode",{parentName:"td"},"baseCoin"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"quoteCoin"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> triggerPrice"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Trigger price. If ",(0,a.kt)("inlineCode",{parentName:"td"},"stopOrderType"),"=",(0,a.kt)("em",{parentName:"td"},"TrailingStop"),", it is activate price. Otherwise, it is trigger price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> takeProfit"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Take profit price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> stopLoss"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Stop loss price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> tpslMode"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"TP/SL mode, ",(0,a.kt)("inlineCode",{parentName:"td"},"Full"),": entire position for TP/SL. ",(0,a.kt)("inlineCode",{parentName:"td"},"Partial"),': partial position tp/sl. Spot does not have this field, and Option returns always ""')),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ocoTriggerBy"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The trigger type of Spot OCO order.",(0,a.kt)("inlineCode",{parentName:"td"},"OcoTriggerByUnknown"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"OcoTriggerByTp"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"OcoTriggerByBySl"),". ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> tpLimitPrice"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The limit order price when take profit price is triggered")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> slLimitPrice"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The limit order price when stop loss price is triggered")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#triggerby"},"tpTriggerBy")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The price type to trigger take profit")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#triggerby"},"slTriggerBy")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The price type to trigger stop loss")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> triggerDirection"),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Trigger direction. ",(0,a.kt)("inlineCode",{parentName:"td"},"1"),": rise, ",(0,a.kt)("inlineCode",{parentName:"td"},"2"),": fall")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#triggerby"},"triggerBy")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The price type of trigger price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> lastPriceOnCreated"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Last price when place the order")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> reduceOnly"),(0,a.kt)("td",{parentName:"tr",align:"left"},"boolean"),(0,a.kt)("td",{parentName:"tr",align:null},"Reduce only. ",(0,a.kt)("inlineCode",{parentName:"td"},"true")," means reduce position size")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> closeOnTrigger"),(0,a.kt)("td",{parentName:"tr",align:"left"},"boolean"),(0,a.kt)("td",{parentName:"tr",align:null},"Close on trigger. ",(0,a.kt)("a",{href:"https://www.bybit.com/en-US/help-center/bybitHC_Article?language=en_US&id=000001050"},"What is a close on trigger order?"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> placeType"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Place type, ",(0,a.kt)("inlineCode",{parentName:"td"},"option")," used. ",(0,a.kt)("inlineCode",{parentName:"td"},"iv"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"price"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#smptype"},"smpType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"SMP execution type")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> smpGroup"),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Smp group ID. If the UID has no group, it is ",(0,a.kt)("inlineCode",{parentName:"td"},"0")," by default")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> smpOrderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The counterparty's orderID which triggers this SMP execution")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> createdTime"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order created timestamp (ms)")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> updatedTime"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order updated timestamp (ms)")))),(0,a.kt)("a",{href:"/api-explorer/v5/trade/open-order"},(0,a.kt)(s,{mdxType:"Button"},"RUN >>")),(0,a.kt)("hr",null),(0,a.kt)("h3",{id:"request-example"},"Request Example"),(0,a.kt)(k,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(g,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/order/realtime?symbol=ETHUSDT&category=linear&openOnly=0&limit=1 HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672219525810\nX-BAPI-RECV-WINDOW: 5000\nContent-Type: application/json\n"))),(0,a.kt)(g,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_open_orders(\n category="linear",\n symbol="ETHUSDT",\n openOnly=0,\n limit=1,\n))\n'))),(0,a.kt)(g,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar openLinearOrdersResult = client.getOpenOrders(openOrderRequest.category(CategoryType.LINEAR).openOnly(1).build());\nSystem.out.println(openLinearOrdersResult);\n'))),(0,a.kt)(g,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getActiveOrders({\n category: 'linear',\n symbol: 'ETHUSDT',\n openOnly: 0,\n limit: 1,\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"response-example"},"Response Example"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "list": [\n {\n "orderId": "fd4300ae-7847-404e-b947-b46980a4d140",\n "orderLinkId": "test-000005",\n "blockTradeId": "",\n "symbol": "ETHUSDT",\n "price": "1600.00",\n "qty": "0.10",\n "side": "Buy",\n "isLeverage": "",\n "positionIdx": 1,\n "orderStatus": "New",\n "cancelType": "UNKNOWN",\n "rejectReason": "EC_NoError",\n "avgPrice": "0",\n "leavesQty": "0.10",\n "leavesValue": "160",\n "cumExecQty": "0.00",\n "cumExecValue": "0",\n "cumExecFee": "0",\n "timeInForce": "GTC",\n "orderType": "Limit",\n "stopOrderType": "UNKNOWN",\n "orderIv": "",\n "triggerPrice": "0.00",\n "takeProfit": "2500.00",\n "stopLoss": "1500.00",\n "tpTriggerBy": "LastPrice",\n "slTriggerBy": "LastPrice",\n "triggerDirection": 0,\n "triggerBy": "UNKNOWN",\n "lastPriceOnCreated": "",\n "reduceOnly": false,\n "closeOnTrigger": false,\n "smpType": "None",\n "smpGroup": 0,\n "smpOrderId": "",\n "tpslMode": "Full",\n "tpLimitPrice": "",\n "slLimitPrice": "",\n "placeType": "",\n "createdTime": "1684738540559",\n "updatedTime": "1684738540561"\n }\n ],\n "nextPageCursor": "page_args%3Dfd4300ae-7847-404e-b947-b46980a4d140%26symbol%3D6%26",\n "category": "linear"\n },\n "retExtInfo": {},\n "time": 1684765770483\n}\n')))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/c127b609.c3316bcb.js b/assets/js/c127b609.c3316bcb.js deleted file mode 100644 index 258d76a20e..0000000000 --- a/assets/js/c127b609.c3316bcb.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[11005],{3905:(t,e,r)=>{r.d(e,{Zo:()=>m,kt:()=>g});var n=r(67294);function a(t,e,r){return e in t?Object.defineProperty(t,e,{value:r,enumerable:!0,configurable:!0,writable:!0}):t[e]=r,t}function l(t,e){var r=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),r.push.apply(r,n)}return r}function i(t){for(var e=1;e=0||(a[r]=t[r]);return a}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(t,r)&&(a[r]=t[r])}return a}var o=n.createContext({}),p=function(t){var e=n.useContext(o),r=e;return t&&(r="function"==typeof t?t(e):i(i({},e),t)),r},m=function(t){var e=p(t.components);return n.createElement(o.Provider,{value:e},t.children)},s={inlineCode:"code",wrapper:function(t){var e=t.children;return n.createElement(n.Fragment,{},e)}},k=n.forwardRef((function(t,e){var r=t.components,a=t.mdxType,l=t.originalType,o=t.parentName,m=d(t,["components","mdxType","originalType","parentName"]),k=p(r),g=a,N=k["".concat(o,".").concat(g)]||k[g]||s[g]||l;return r?n.createElement(N,i(i({ref:e},m),{},{components:r})):n.createElement(N,i({ref:e},m))}));function g(t,e){var r=arguments,a=e&&e.mdxType;if("string"==typeof t||a){var l=r.length,i=new Array(l);i[0]=k;var d={};for(var o in e)hasOwnProperty.call(e,o)&&(d[o]=e[o]);d.originalType=t,d.mdxType="string"==typeof t?t:a,i[1]=d;for(var p=2;p{r.r(e),r.d(e,{assets:()=>o,contentTitle:()=>i,default:()=>u,frontMatter:()=>l,metadata:()=>d,toc:()=>p});var n=r(87462),a=(r(67294),r(3905));const l={title:"Get Open & Closed Orders",sidebar_label:"Get Open & Closed Orders (real-time)",sidebar_position:4},i=void 0,d={unversionedId:"v5/order/open-order",id:"v5/order/open-order",title:"Get Open & Closed Orders",description:"Primarily query unfilled or partially filled orders in real-time, but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param openOnly.",source:"@site/docs/v5/order/open-order.mdx",sourceDirName:"v5/order",slug:"/v5/order/open-order",permalink:"/docs/v5/order/open-order",draft:!1,tags:[],version:"current",sidebarPosition:4,frontMatter:{title:"Get Open & Closed Orders",sidebar_label:"Get Open & Closed Orders (real-time)",sidebar_position:4},sidebar:"v5SideBar",previous:{title:"Cancel Order",permalink:"/docs/v5/order/cancel-order"},next:{title:"Cancel All Orders",permalink:"/docs/v5/order/cancel-all"}},o={},p=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],m=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",e)},s=m("Button"),k=m("Tabs"),g=m("TabItem"),N={toc:p};function u(t){let{components:e,...r}=t;return(0,a.kt)("wrapper",(0,n.Z)({},N,r,{components:e,mdxType:"MDXLayout"}),(0,a.kt)("p",null,"Primarily query unfilled or partially filled orders in ",(0,a.kt)("strong",{parentName:"p"},"real-time"),", but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param ",(0,a.kt)("inlineCode",{parentName:"p"},"openOnly"),".",(0,a.kt)("br",null),"\nAnd to query older order records, please use the ",(0,a.kt)("a",{parentName:"p",href:"order-list#"},"order history")," interface."),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options"),(0,a.kt)("br",null),"\n",(0,a.kt)("strong",{parentName:"p"},"Classic account covers: Spot / USDT perpetual / Inverse contract"))),(0,a.kt)("admonition",{type:"tip"},(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"This endpoint also allows for querying filled, canceled, and rejected orders to the most recent 500 orders for spot, linear, and option categories. The inverse category is not subject to this limitation."),(0,a.kt)("li",{parentName:"ul"},"You can query by symbol, baseCoin, orderId and orderLinkId, and if you pass multiple params, the system will process them according to this priority: orderId > orderLinkId > symbol > baseCoin."),(0,a.kt)("li",{parentName:"ul"},"The records are sorted by the ",(0,a.kt)("inlineCode",{parentName:"li"},"createdTime")," from newest to oldest."))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"Classic account spot can return open orders only"),(0,a.kt)("li",{parentName:"ul"},"After a server release or restart, filled, canceled, and rejected orders of Unified account should only be queried through ",(0,a.kt)("a",{parentName:"li",href:"order-list#"},"order history"),"."))),(0,a.kt)("h3",{id:"http-request"},"HTTP Request"),(0,a.kt)("p",null,"GET ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/realtime")),(0,a.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"category"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Product type ",(0,a.kt)("ul",null,(0,a.kt)("li",null,"Unified account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"option")),(0,a.kt)("li",null,"Classic account: ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Symbol name, like ",(0,a.kt)("inlineCode",{parentName:"td"},"BTCUSDT"),", uppercase only. For ",(0,a.kt)("strong",{parentName:"td"},"linear"),", either ",(0,a.kt)("inlineCode",{parentName:"td"},"symbol"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"baseCoin"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"settleCoin")," is ",(0,a.kt)("strong",{parentName:"td"},"required"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"baseCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Base coin, uppercase only ",(0,a.kt)("li",null,"Supports ",(0,a.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"inverse")," & ",(0,a.kt)("inlineCode",{parentName:"td"},"option")),(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"option"),": it returns all option open orders by default"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"settleCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Settle coin, uppercase only ",(0,a.kt)("ul",null,(0,a.kt)("li",null,(0,a.kt)("b",null,"linear"),": either ",(0,a.kt)("inlineCode",{parentName:"td"},"symbol"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"baseCoin")," or ",(0,a.kt)("inlineCode",{parentName:"td"},"settleCoin")," is ",(0,a.kt)("strong",{parentName:"td"},"required")),(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"spot"),": not supported")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"openOnly"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("ul",null,(0,a.kt)("li",null,"Unified account & Classic account: ",(0,a.kt)("inlineCode",{parentName:"td"},"0"),"(default) - query open orders (e.g., New, PartiallyFilled) ",(0,a.kt)("strong",{parentName:"td"},"only")),(0,a.kt)("li",null,"Unified account (spot / linear / option): ",(0,a.kt)("inlineCode",{parentName:"td"},"1"),", Unified account(inverse) & Classic account(linear / inverse): ",(0,a.kt)("inlineCode",{parentName:"td"},"2"),": return a maximum of recent 500 closed status records are kept under each account (e.g., Cancelled, Rejected, Filled orders). ",(0,a.kt)("i",null,"If the Bybit service is restarted due to an update, this part of the data will be cleared and accumulated again, but the order records will still be queried in ",(0,a.kt)("a",{parentName:"td",href:"order-list#"},"order history"))),(0,a.kt)("li",null,(0,a.kt)("inlineCode",{parentName:"td"},"openOnly")," param will be ignored when query by ",(0,a.kt)("em",{parentName:"td"},"orderId")," or ",(0,a.kt)("em",{parentName:"td"},"orderLinkId")),(0,a.kt)("li",null,"Classic ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),": not supported")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"orderFilter"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("inlineCode",{parentName:"td"},"Order"),": active order, ",(0,a.kt)("inlineCode",{parentName:"td"},"StopOrder"),": conditional order for Futures and Spot, ",(0,a.kt)("inlineCode",{parentName:"td"},"tpslOrder"),": spot TP/SL order, ",(0,a.kt)("inlineCode",{parentName:"td"},"OcoOrder"),": Spot oco order, ",(0,a.kt)("inlineCode",{parentName:"td"},"BidirectionalTpslOrder"),": Spot bidirectional TPSL order",(0,a.kt)("ul",null,(0,a.kt)("li",null,"Classic account ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"),": return ",(0,a.kt)("inlineCode",{parentName:"td"},"Order")," active order by default"),(0,a.kt)("li",null,"Others: all kinds of orders by default")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"limit"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Limit for data size per page. ","[",(0,a.kt)("inlineCode",{parentName:"td"},"1"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"50"),"]",". Default: ",(0,a.kt)("inlineCode",{parentName:"td"},"20"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"cursor"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cursor. Use the ",(0,a.kt)("inlineCode",{parentName:"td"},"nextPageCursor")," token from the response to retrieve the next page of the result set")))),(0,a.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"category"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Product type")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"nextPageCursor"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Refer to the ",(0,a.kt)("inlineCode",{parentName:"td"},"cursor")," request parameter")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"list"),(0,a.kt)("td",{parentName:"tr",align:"left"},"array"),(0,a.kt)("td",{parentName:"tr",align:null},"Object")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderLinkId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"User customised order ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> blockTradeId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Paradigm block trade ID")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Symbol name")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> price"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> qty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order qty")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> side"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Side. ",(0,a.kt)("inlineCode",{parentName:"td"},"Buy"),",",(0,a.kt)("inlineCode",{parentName:"td"},"Sell"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> isLeverage"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Whether to borrow. ",(0,a.kt)("strong",{parentName:"td"},"Unified ",(0,a.kt)("inlineCode",{parentName:"strong"},"spot"))," only. ",(0,a.kt)("inlineCode",{parentName:"td"},"0"),": false, ",(0,a.kt)("inlineCode",{parentName:"td"},"1"),": true. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported, always ",(0,a.kt)("inlineCode",{parentName:"em"},"0")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#positionidx"},"positionIdx")),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Position index. Used to identify positions in different position modes.")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#orderstatus"},"orderStatus")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order status")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#createtype"},"createType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order create type ",(0,a.kt)("li",null,"Only for category=linear or inverse"),(0,a.kt)("li",null,"Spot, Option do not have this key"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#canceltype"},"cancelType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cancel type")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#rejectreason"},"rejectReason")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Reject reason. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> avgPrice"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Average filled price ",(0,a.kt)("li",null,"UTA: returns ",(0,a.kt)("inlineCode",{parentName:"td"},'""')," for those orders without avg price"),(0,a.kt)("li",null,"Classic account: returns ",(0,a.kt)("inlineCode",{parentName:"td"},'"0"')," for those orders without avg price, and also for those orders have partilly filled but cancelled at the end"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> leavesQty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The remaining qty not executed. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> leavesValue"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The estimated value not executed. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> cumExecQty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cumulative executed order qty")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> cumExecValue"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cumulative executed order value. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> cumExecFee"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Cumulative executed trading fee. ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#timeinforce"},"timeInForce")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Time in force")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#ordertype"},"orderType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order type. ",(0,a.kt)("inlineCode",{parentName:"td"},"Market"),",",(0,a.kt)("inlineCode",{parentName:"td"},"Limit"),". For TP/SL order, it means the order type after triggered")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#stopordertype"},"stopOrderType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Stop order type")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> orderIv"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Implied volatility")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> marketUnit"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The unit for ",(0,a.kt)("inlineCode",{parentName:"td"},"qty")," when create ",(0,a.kt)("strong",{parentName:"td"},"Spot market")," orders for ",(0,a.kt)("strong",{parentName:"td"},"UTA account"),". ",(0,a.kt)("inlineCode",{parentName:"td"},"baseCoin"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"quoteCoin"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> triggerPrice"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Trigger price. If ",(0,a.kt)("inlineCode",{parentName:"td"},"stopOrderType"),"=",(0,a.kt)("em",{parentName:"td"},"TrailingStop"),", it is activate price. Otherwise, it is trigger price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> takeProfit"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Take profit price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> stopLoss"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Stop loss price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> tpslMode"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"TP/SL mode, ",(0,a.kt)("inlineCode",{parentName:"td"},"Full"),": entire position for TP/SL. ",(0,a.kt)("inlineCode",{parentName:"td"},"Partial"),': partial position tp/sl. Spot does not have this field, and Option returns always ""')),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ocoTriggerBy"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The trigger type of Spot OCO order.",(0,a.kt)("inlineCode",{parentName:"td"},"OcoTriggerByUnknown"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"OcoTriggerByTp"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"OcoTriggerByBySl"),". ",(0,a.kt)("em",{parentName:"td"},"Classic ",(0,a.kt)("inlineCode",{parentName:"em"},"spot")," is not supported"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> tpLimitPrice"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The limit order price when take profit price is triggered")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> slLimitPrice"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The limit order price when stop loss price is triggered")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#triggerby"},"tpTriggerBy")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The price type to trigger take profit")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#triggerby"},"slTriggerBy")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The price type to trigger stop loss")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> triggerDirection"),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Trigger direction. ",(0,a.kt)("inlineCode",{parentName:"td"},"1"),": rise, ",(0,a.kt)("inlineCode",{parentName:"td"},"2"),": fall")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#triggerby"},"triggerBy")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The price type of trigger price")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> lastPriceOnCreated"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Last price when place the order")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> reduceOnly"),(0,a.kt)("td",{parentName:"tr",align:"left"},"boolean"),(0,a.kt)("td",{parentName:"tr",align:null},"Reduce only. ",(0,a.kt)("inlineCode",{parentName:"td"},"true")," means reduce position size")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> closeOnTrigger"),(0,a.kt)("td",{parentName:"tr",align:"left"},"boolean"),(0,a.kt)("td",{parentName:"tr",align:null},"Close on trigger. ",(0,a.kt)("a",{href:"https://www.bybit.com/en-US/help-center/bybitHC_Article?language=en_US&id=000001050"},"What is a close on trigger order?"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> placeType"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Place type, ",(0,a.kt)("inlineCode",{parentName:"td"},"option")," used. ",(0,a.kt)("inlineCode",{parentName:"td"},"iv"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"price"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> ",(0,a.kt)("a",{parentName:"td",href:"../enum#smptype"},"smpType")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"SMP execution type")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> smpGroup"),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Smp group ID. If the UID has no group, it is ",(0,a.kt)("inlineCode",{parentName:"td"},"0")," by default")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> smpOrderId"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"The counterparty's orderID which triggers this SMP execution")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> createdTime"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order created timestamp (ms)")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"> updatedTime"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"Order updated timestamp (ms)")))),(0,a.kt)("a",{href:"/api-explorer/v5/trade/open-order"},(0,a.kt)(s,{mdxType:"Button"},"RUN >>")),(0,a.kt)("hr",null),(0,a.kt)("h3",{id:"request-example"},"Request Example"),(0,a.kt)(k,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(g,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/order/realtime?symbol=ETHUSDT&category=linear&openOnly=0&limit=1 HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672219525810\nX-BAPI-RECV-WINDOW: 5000\nContent-Type: application/json\n"))),(0,a.kt)(g,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_open_orders(\n category="linear",\n symbol="ETHUSDT",\n openOnly=0,\n limit=1,\n))\n'))),(0,a.kt)(g,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar openLinearOrdersResult = client.getOpenOrders(openOrderRequest.category(CategoryType.LINEAR).openOnly(1).build());\nSystem.out.println(openLinearOrdersResult);\n'))),(0,a.kt)(g,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getActiveOrders({\n category: 'linear',\n symbol: 'ETHUSDT',\n openOnly: 0,\n limit: 1,\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"response-example"},"Response Example"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "list": [\n {\n "orderId": "fd4300ae-7847-404e-b947-b46980a4d140",\n "orderLinkId": "test-000005",\n "blockTradeId": "",\n "symbol": "ETHUSDT",\n "price": "1600.00",\n "qty": "0.10",\n "side": "Buy",\n "isLeverage": "",\n "positionIdx": 1,\n "orderStatus": "New",\n "cancelType": "UNKNOWN",\n "rejectReason": "EC_NoError",\n "avgPrice": "0",\n "leavesQty": "0.10",\n "leavesValue": "160",\n "cumExecQty": "0.00",\n "cumExecValue": "0",\n "cumExecFee": "0",\n "timeInForce": "GTC",\n "orderType": "Limit",\n "stopOrderType": "UNKNOWN",\n "orderIv": "",\n "triggerPrice": "0.00",\n "takeProfit": "2500.00",\n "stopLoss": "1500.00",\n "tpTriggerBy": "LastPrice",\n "slTriggerBy": "LastPrice",\n "triggerDirection": 0,\n "triggerBy": "UNKNOWN",\n "lastPriceOnCreated": "",\n "reduceOnly": false,\n "closeOnTrigger": false,\n "smpType": "None",\n "smpGroup": 0,\n "smpOrderId": "",\n "tpslMode": "Full",\n "tpLimitPrice": "",\n "slLimitPrice": "",\n "placeType": "",\n "createdTime": "1684738540559",\n "updatedTime": "1684738540561"\n }\n ],\n "nextPageCursor": "page_args%3Dfd4300ae-7847-404e-b947-b46980a4d140%26symbol%3D6%26",\n "category": "linear"\n },\n "retExtInfo": {},\n "time": 1684765770483\n}\n')))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/df36d98d.41116648.js b/assets/js/df36d98d.41116648.js deleted file mode 100644 index f3885ad157..0000000000 --- a/assets/js/df36d98d.41116648.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[80567],{3905:(e,t,n)=>{n.d(t,{Zo:()=>c,kt:()=>u});var r=n(67294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var s=r.createContext({}),p=function(e){var t=r.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},c=function(e){var t=p(e.components);return r.createElement(s.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,o=e.originalType,s=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),m=p(n),u=a,f=m["".concat(s,".").concat(u)]||m[u]||d[u]||o;return n?r.createElement(f,i(i({ref:t},c),{},{components:n})):r.createElement(f,i({ref:t},c))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=n.length,i=new Array(o);i[0]=m;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l.mdxType="string"==typeof e?e:a,i[1]=l;for(var p=2;p{n.r(t),n.d(t,{assets:()=>s,contentTitle:()=>i,default:()=>f,frontMatter:()=>o,metadata:()=>l,toc:()=>p});var r=n(87462),a=(n(67294),n(3905));const o={title:"Set Disconnect Cancel All",sidebar_label:"Set DCP (Options)",sidebar_position:11},i=void 0,l={unversionedId:"v5/order/dcp",id:"v5/order/dcp",title:"Set Disconnect Cancel All",description:"Covers: Futures / Spot / Option (Unified Account)",source:"@site/docs/v5/order/dcp.mdx",sourceDirName:"v5/order",slug:"/v5/order/dcp",permalink:"/docs/v5/order/dcp",draft:!1,tags:[],version:"current",sidebarPosition:11,frontMatter:{title:"Set Disconnect Cancel All",sidebar_label:"Set DCP (Options)",sidebar_position:11},sidebar:"v5SideBar",previous:{title:"Get Borrow Quota (Spot)",permalink:"/docs/v5/order/spot-borrow-quota"},next:{title:"Get Position Info",permalink:"/docs/v5/position/"}},s={},p=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],c=e=>function(t){return console.warn("Component "+e+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",t)},d=c("Tabs"),m=c("TabItem"),u={toc:p};function f(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,r.Z)({},u,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"Covers: Futures / Spot / Option (Unified Account)"))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("h2",{parentName:"admonition",id:"what-is-disconnection-protect-dcp"},"What is Disconnection Protect (DCP)?"),(0,a.kt)("p",{parentName:"admonition"},'Based on the websocket private connection and heartbeat mechanism, Bybit provides disconnection protection function. The\ntiming starts from the first disconnection. If the Bybit server does not receive the reconnection from the client for\nmore than 10 (default) seconds and resumes the heartbeat "ping", then the client is in the state of "disconnection protect",\nall active ',(0,a.kt)("strong",{parentName:"p"},"futures / spot / option"),' orders of the client will be cancelled automatically. If within 10 seconds, the client reconnects\nand resumes the heartbeat "ping", the timing will be reset and restarted at the next disconnection.'),(0,a.kt)("h2",{parentName:"admonition",id:"how-to-enable-dcp"},"How to enable DCP"),(0,a.kt)("p",{parentName:"admonition"},"If you need to turn it on/off, you can contact your client manager for consultation and application. The default time window is 10 seconds."),(0,a.kt)("h2",{parentName:"admonition",id:"applicable"},"Applicable"),(0,a.kt)("p",{parentName:"admonition"},"Effective for ",(0,a.kt)("strong",{parentName:"p"},"USDT Perp / USDC Perp / USDC Futures / Spot / options"))),(0,a.kt)("admonition",{type:"tip"},(0,a.kt)("p",{parentName:"admonition"},"After the request is successfully sent, the system needs a certain time to take effect. It is recommended to query or set again after 10 seconds")),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"You can use ",(0,a.kt)("a",{parentName:"li",href:"/v5/account/account-info"},"this endpoint")," to get your current DCP configuration."),(0,a.kt)("li",{parentName:"ul"},"Your private websocket connection ",(0,a.kt)("strong",{parentName:"li"},"must")," subscribe ",(0,a.kt)("a",{parentName:"li",href:"../websocket/private/dcp"},'"dcp" topic')," in order to trigger DCP successfully")),(0,a.kt)("h3",{id:"http-request"},"HTTP Request"),(0,a.kt)("p",null,"POST ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/disconnected-cancel-all")),(0,a.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"product"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("inlineCode",{parentName:"td"},"OPTIONS"),"(default), ",(0,a.kt)("inlineCode",{parentName:"td"},"DERIVATIVES"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"SPOT"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"timeWindow"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Disconnection timing window time. ","[",(0,a.kt)("inlineCode",{parentName:"td"},"3"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"300"),"]",", unit: second")))),(0,a.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,a.kt)("p",null,"None"),(0,a.kt)("h3",{id:"request-example"},"Request Example"),(0,a.kt)(d,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(m,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},'POST v5/order/disconnected-cancel-all HTTP/1.1\nHost: api.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1675852742375\nX-BAPI-RECV-WINDOW: 50000\nContent-Type: application/json\n\n{\n "timeWindow": 40\n}\n'))),(0,a.kt)(m,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.set_dcp(\n timeWindow=40,\n))\n'))),(0,a.kt)(m,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar setDcpOptionsRequest = TradeOrderRequest.builder().timeWindow(40).build();\nSystem.out.println(client.setDisconnectCancelAllTime(setDcpOptionsRequest));\n'))),(0,a.kt)(m,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .setDisconnectCancelAllWindow('option', 40)\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"response-example"},"Response Example"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "success"\n}\n')))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/df36d98d.fec680eb.js b/assets/js/df36d98d.fec680eb.js new file mode 100644 index 0000000000..f91504715f --- /dev/null +++ b/assets/js/df36d98d.fec680eb.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[80567],{3905:(e,t,n)=>{n.d(t,{Zo:()=>c,kt:()=>u});var r=n(67294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var s=r.createContext({}),p=function(e){var t=r.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},c=function(e){var t=p(e.components);return r.createElement(s.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,o=e.originalType,s=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),m=p(n),u=a,f=m["".concat(s,".").concat(u)]||m[u]||d[u]||o;return n?r.createElement(f,i(i({ref:t},c),{},{components:n})):r.createElement(f,i({ref:t},c))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=n.length,i=new Array(o);i[0]=m;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l.mdxType="string"==typeof e?e:a,i[1]=l;for(var p=2;p{n.r(t),n.d(t,{assets:()=>s,contentTitle:()=>i,default:()=>f,frontMatter:()=>o,metadata:()=>l,toc:()=>p});var r=n(87462),a=(n(67294),n(3905));const o={title:"Set Disconnect Cancel All",sidebar_label:"Set DCP",sidebar_position:11},i=void 0,l={unversionedId:"v5/order/dcp",id:"v5/order/dcp",title:"Set Disconnect Cancel All",description:"Covers: Futures / Spot / Option (Unified Account)",source:"@site/docs/v5/order/dcp.mdx",sourceDirName:"v5/order",slug:"/v5/order/dcp",permalink:"/docs/v5/order/dcp",draft:!1,tags:[],version:"current",sidebarPosition:11,frontMatter:{title:"Set Disconnect Cancel All",sidebar_label:"Set DCP",sidebar_position:11},sidebar:"v5SideBar",previous:{title:"Get Borrow Quota (Spot)",permalink:"/docs/v5/order/spot-borrow-quota"},next:{title:"Get Position Info",permalink:"/docs/v5/position/"}},s={},p=[{value:"HTTP Request",id:"http-request",level:3},{value:"Request Parameters",id:"request-parameters",level:3},{value:"Response Parameters",id:"response-parameters",level:3},{value:"Request Example",id:"request-example",level:3},{value:"Response Example",id:"response-example",level:3}],c=e=>function(t){return console.warn("Component "+e+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",t)},d=c("Tabs"),m=c("TabItem"),u={toc:p};function f(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,r.Z)({},u,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"Covers: Futures / Spot / Option (Unified Account)"))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("h2",{parentName:"admonition",id:"what-is-disconnection-protect-dcp"},"What is Disconnection Protect (DCP)?"),(0,a.kt)("p",{parentName:"admonition"},'Based on the websocket private connection and heartbeat mechanism, Bybit provides disconnection protection function. The\ntiming starts from the first disconnection. If the Bybit server does not receive the reconnection from the client for\nmore than 10 (default) seconds and resumes the heartbeat "ping", then the client is in the state of "disconnection protect",\nall active ',(0,a.kt)("strong",{parentName:"p"},"futures / spot / option"),' orders of the client will be cancelled automatically. If within 10 seconds, the client reconnects\nand resumes the heartbeat "ping", the timing will be reset and restarted at the next disconnection.'),(0,a.kt)("h2",{parentName:"admonition",id:"how-to-enable-dcp"},"How to enable DCP"),(0,a.kt)("p",{parentName:"admonition"},"If you need to turn it on/off, you can contact your client manager for consultation and application. The default time window is 10 seconds."),(0,a.kt)("h2",{parentName:"admonition",id:"applicable"},"Applicable"),(0,a.kt)("p",{parentName:"admonition"},"Effective for ",(0,a.kt)("strong",{parentName:"p"},"USDT Perp / USDC Perp / USDC Futures / Spot / options"))),(0,a.kt)("admonition",{type:"tip"},(0,a.kt)("p",{parentName:"admonition"},"After the request is successfully sent, the system needs a certain time to take effect. It is recommended to query or set again after 10 seconds")),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"You can use ",(0,a.kt)("a",{parentName:"li",href:"/v5/account/account-info"},"this endpoint")," to get your current DCP configuration."),(0,a.kt)("li",{parentName:"ul"},"Your private websocket connection ",(0,a.kt)("strong",{parentName:"li"},"must")," subscribe ",(0,a.kt)("a",{parentName:"li",href:"../websocket/private/dcp"},'"dcp" topic')," in order to trigger DCP successfully")),(0,a.kt)("h3",{id:"http-request"},"HTTP Request"),(0,a.kt)("p",null,"POST ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/disconnected-cancel-all")),(0,a.kt)("h3",{id:"request-parameters"},"Request Parameters"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"Parameter"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Required"),(0,a.kt)("th",{parentName:"tr",align:"left"},"Type"),(0,a.kt)("th",{parentName:"tr",align:null},"Comments"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"product"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("inlineCode",{parentName:"td"},"OPTIONS"),"(default), ",(0,a.kt)("inlineCode",{parentName:"td"},"DERIVATIVES"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"SPOT"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"timeWindow"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"Disconnection timing window time. ","[",(0,a.kt)("inlineCode",{parentName:"td"},"3"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"300"),"]",", unit: second")))),(0,a.kt)("h3",{id:"response-parameters"},"Response Parameters"),(0,a.kt)("p",null,"None"),(0,a.kt)("h3",{id:"request-example"},"Request Example"),(0,a.kt)(d,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(m,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},'POST v5/order/disconnected-cancel-all HTTP/1.1\nHost: api.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1675852742375\nX-BAPI-RECV-WINDOW: 50000\nContent-Type: application/json\n\n{\n "timeWindow": 40\n}\n'))),(0,a.kt)(m,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.set_dcp(\n timeWindow=40,\n))\n'))),(0,a.kt)(m,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar setDcpOptionsRequest = TradeOrderRequest.builder().timeWindow(40).build();\nSystem.out.println(client.setDisconnectCancelAllTime(setDcpOptionsRequest));\n'))),(0,a.kt)(m,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .setDisconnectCancelAllWindow('option', 40)\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"response-example"},"Response Example"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "success"\n}\n')))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.c650b523.js b/assets/js/runtime~main.d751df89.js similarity index 98% rename from assets/js/runtime~main.c650b523.js rename to assets/js/runtime~main.d751df89.js index 62622b2516..052eb91d41 100644 --- a/assets/js/runtime~main.c650b523.js +++ b/assets/js/runtime~main.d751df89.js @@ -1 +1 @@ -(()=>{"use strict";var e,a,c,d,b,f={},r={};function t(e){var a=r[e];if(void 0!==a)return a.exports;var c=r[e]={id:e,loaded:!1,exports:{}};return f[e].call(c.exports,c,c.exports,t),c.loaded=!0,c.exports}t.m=f,e=[],t.O=(a,c,d,b)=>{if(!c){var f=1/0;for(i=0;i=b)&&Object.keys(t.O).every((e=>t.O[e](c[o])))?c.splice(o--,1):(r=!1,b0&&e[i-1][2]>b;i--)e[i]=e[i-1];e[i]=[c,d,b]},t.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return t.d(a,{a:a}),a},c=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,t.t=function(e,d){if(1&d&&(e=this(e)),8&d)return e;if("object"==typeof e&&e){if(4&d&&e.__esModule)return e;if(16&d&&"function"==typeof e.then)return e}var b=Object.create(null);t.r(b);var f={};a=a||[null,c({}),c([]),c(c)];for(var r=2&d&&e;"object"==typeof r&&!~a.indexOf(r);r=c(r))Object.getOwnPropertyNames(r).forEach((a=>f[a]=()=>e[a]));return f.default=()=>e,t.d(b,f),b},t.d=(e,a)=>{for(var c in a)t.o(a,c)&&!t.o(e,c)&&Object.defineProperty(e,c,{enumerable:!0,get:a[c]})},t.f={},t.e=e=>Promise.all(Object.keys(t.f).reduce(((a,c)=>(t.f[c](e,a),a)),[])),t.u=e=>"assets/js/"+({42:"2518c83b",520:"fb1a77b4",783:"84002310",1269:"9e31950e",1286:"f5bce583",1714:"6c068fb7",1739:"510acf22",1802:"96368f4f",1893:"4c5e977b",2050:"f54e89d1",2112:"5e4fe134",2338:"5b157bd1",2375:"1c94925b",2449:"3e99551e",2528:"5b292b69",2666:"09c26509",2951:"9bb13d2e",3299:"7e3ea763",3300:"655c39d2",3425:"602542a3",3522:"abf6ee25",3705:"b3a5153e",4159:"b9acd066",4387:"78950515",4637:"b65b34ba",4694:"98dc0d0e",4696:"9569bc2f",5159:"9d6ed550",5295:"5bcf38c1",5872:"587e3d47",5886:"31d96af4",6282:"cd8b4f9a",6473:"a83fc124",6597:"44177285",6675:"036e14f3",6849:"548bc066",6874:"8b221193",7213:"f93f119a",7267:"c9713a6d",7383:"225c9eb6",7828:"f72af8b9",8025:"b42f8477",8179:"136658e4",8347:"8b988d57",8966:"16ef1cd9",9022:"29b0efd4",9113:"84ab2fd1",9300:"903944d2",9532:"68079445",9609:"8e84b0d9",9624:"3042b185",9800:"9ff509e1",9817:"14eb3368",10225:"883bb60a",10235:"a7d19085",10293:"fa570740",11005:"c127b609",11013:"e8acd80e",11053:"7205acf7",11265:"f6106990",11389:"a005ddbc",11396:"e3e28d8f",11792:"855341b1",11908:"f9fe6464",12333:"650716b7",12717:"0b0bc04d",12933:"b6036b82",13085:"1f391b9e",13258:"b5961036",13408:"fdf22a50",13739:"5e33bc00",13959:"2d0f081e",13994:"b2ae77a0",14030:"c5d3bb95",14132:"b6eadb9e",14243:"0744e06b",14281:"30bb4662",14491:"1fefa037",14582:"fed448c0",14681:"1be75057",14731:"64e1104a",14777:"269ec971",14796:"a41d5bc2",15068:"e4440f9d",15114:"ee7f03d8",15309:"57f8207f",15361:"4d2ad36f",15365:"b82d00b2",15609:"060b1584",15669:"5220550c",16071:"094a53a9",16225:"d02b6e20",16377:"07ffdee5",16667:"f81ec24e",16720:"4ac45b89",16825:"5621bfd0",17070:"c78b1140",17210:"daa5df1a",17445:"1a299676",17638:"e165cecb",17719:"6623a699",18104:"7ab943be",18287:"82405689",18772:"c83cf481",19065:"65246720",19178:"3956460a",19270:"cba951d8",19389:"2a8d8e88",19715:"2cfd0fc8",19831:"4e7e2ca5",20048:"441ee7d2",20367:"05a3c259",20844:"4e1901bc",20926:"05bb3e6b",21004:"bc0c7228",21390:"a6905832",21493:"79022373",22162:"31593e16",22399:"0d34b62b",22982:"f041af6f",23003:"34fadc99",23022:"e0a5c1d2",23389:"9041aea1",23750:"c77ce8fa",23905:"d288e937",24069:"41ce3377",24180:"83b28724",24804:"440f78e7",24851:"a592f1e4",24989:"0f2dc4ca",25329:"4eca193c",25370:"af4a2ad4",25374:"980085d9",25382:"632d2515",25733:"735936a9",25760:"31e78686",25785:"20f55e05",25968:"156751cf",25969:"07ca0209",26295:"67f94a41",26467:"302d24dc",26648:"0157939d",26668:"b9fa1d17",26912:"197a4930",27044:"89e5bdec",27133:"92e99bf6",27188:"5036ec9d",27212:"e6cbd2ed",27238:"e298e99e",28135:"89179ad6",28364:"069e89fb",28460:"dd3ced3a",28492:"9931c5c6",28608:"0cadbdb9",28781:"7e458d36",28801:"6dfc2f3d",28848:"99d44459",29010:"8c2621f5",29217:"547b19b8",29514:"1be78505",29538:"4c950052",29766:"5bf23af0",29770:"06b60cb4",29976:"f512b2b1",30561:"bc670d5c",30601:"e5d84bc0",30701:"21fa7ce5",30797:"80238aff",30882:"aedc496a",31094:"8675103a",31404:"3e301362",32111:"74db685e",32197:"eb357560",32252:"eef51a73",32490:"1eaa7a2a",32755:"7e04e77d",33224:"1bd0c971",33240:"0ab53148",33312:"8cd2105d",33404:"afdda5b6",33509:"786f71e5",33527:"a5e760bc",33659:"0e5cbc44",34024:"99f24057",34288:"af1ac92b",34548:"1a8c488b",34730:"f4b2f868",35167:"6c74a4d7",35416:"cc68b255",35701:"d02347dc",35708:"41eb0037",35832:"b745f339",35943:"bc53881b",36106:"c2ebbb3e",36553:"18a5e8d6",36554:"9d979a6d",36904:"637cfff4",37018:"01464744",37486:"dcc6b54d",37487:"a9bf2227",37710:"c11bd48d",37896:"83cc66ac",37950:"8825024b",38270:"5393ce94",38460:"c2d32f88",38704:"8338c5ef",38890:"c084c2e9",38948:"bc8bd5d6",38959:"1eb543d3",39127:"a230a772",39580:"75ecb4f9",39626:"fd867f7c",39796:"3e9399ec",39833:"26987f39",40073:"359a0a8d",40114:"8740ec05",40211:"eb907bb2",40219:"49e3720f",40542:"41790d5d",40614:"716600a7",40683:"0abae2e0",40701:"1ce0a301",40916:"e4459066",41003:"d0d62bb5",41804:"ee640683",41877:"717e7ee6",41943:"62029e95",42069:"9a6be05d",42885:"acdbee8e",44120:"a61ed651",44209:"278665dc",44758:"0a13a0e4",44916:"95d5a544",45111:"cb819e9b",45167:"da88d543",46039:"778f38dc",46215:"784585a8",46566:"763e4dec",46739:"2dd5aaa1",46976:"70b01d77",47137:"47f09a6b",47328:"6daf901a",47361:"7a5188cd",47563:"146da2b4",47615:"84ebbbbf",48026:"a120aaca",48081:"5dce62fd",48169:"e4492fa7",48890:"d5603669",48954:"b0bdb7f3",49486:"e72cf26a",49717:"a5962d55",49755:"c123803f",50067:"246367e0",50430:"867911a0",50730:"4b1cba20",50893:"965dbb95",50932:"485af29a",51106:"dd813bf5",51410:"bd1a9377",51523:"a3761f7f",52474:"4507e508",52486:"de127d6b",52574:"e2668db3",52654:"f024ddd5",52831:"5ec88f12",53408:"4694df8d",53482:"a718913e",53501:"7795e3fe",53630:"dd02e78e",54029:"e286ec4c",54053:"24e3585b",54601:"c552c222",54636:"760e3208",54801:"3ec68450",54820:"05a18904",55038:"100f3054",55229:"2fcfad90",55381:"cfc9c16e",55480:"006095b2",56025:"c3aed80f",56319:"879063fc",56370:"36f93d19",56382:"9ffa1a6c",56886:"4b7a6889",56963:"1b80e345",56979:"d005934a",57067:"eece046c",57152:"e09bff2e",57251:"eb1718b4",57287:"bde9fb45",57756:"6ab4408e",57979:"c5059afe",58188:"e73e328f",58235:"3bdeaa89",58353:"162f137e",58663:"c7dcc258",59082:"6a9a7317",59131:"3b0223df",59135:"e27b8251",59607:"25f376d4",59728:"aa5bd2a7",59856:"e5c88a3e",59865:"e8ee0390",59910:"16142a34",59953:"2041170f",60298:"d4e7ac8a",60310:"5913a508",61304:"8d5fe6f9",62062:"988ba51e",62353:"35d50d77",62457:"30e5c1aa",62860:"3d49fc0e",63447:"1c5b9066",63497:"b8541bfd",63851:"51b69e86",64166:"c54a5582",64195:"c4f5d8e4",64209:"d7a48e98",64214:"575f1b1b",64280:"95a35da8",64497:"099f8a1f",64549:"788d9fe0",64925:"7ee339c8",65149:"53e78238",65154:"af35203c",65368:"cc468388",65687:"2f2f8f8f",65787:"c4ae09d4",65818:"ae255275",65957:"e4627c87",66068:"e8bf0c3e",66286:"13d7a585",66345:"42a8d727",66880:"f32d8490",67365:"18f77871",67374:"6279c8a9",67746:"df7ec86c",67813:"8894256f",67861:"0f9cda3e",68207:"7622c6de",68253:"363ba2d8",68349:"3d3a07f6",68503:"f8c92f63",68809:"4090f62b",68970:"eaafcd74",69043:"9ad8637e",69125:"c80ee60a",69572:"8000380e",69753:"7e31db45",69905:"e23eefc0",70332:"39fee459",70633:"b50c9021",70670:"e62aa786",70743:"c7399101",70838:"22bdf908",71347:"e93ff9aa",71600:"397d4a7e",71723:"0328b0c9",71871:"ce32ce4d",71910:"2a3724f5",72379:"9dba6800",72809:"540cb455",73375:"94fe2afe",73464:"3c6391c1",73602:"696ed493",73634:"e0bec19d",73695:"bdb43652",73905:"94b87f57",73918:"4294ceba",74190:"84cf2087",74298:"48db5030",74428:"53d82fc0",74531:"b25d4024",74811:"cf33a5bc",74971:"0ed89c29",75063:"cf69f832",75288:"77de130e",75600:"30fdf4bf",75791:"0667cc8f",75975:"0de52270",76152:"b180b1b1",76428:"418c923e",76434:"40878283",76541:"d67ae496",76549:"7a65c859",77184:"11b4dd89",77811:"18a382cc",77937:"ea313555",77944:"6bc64de5",77999:"3af651bf",78023:"2b20c80a",78099:"ad577885",78315:"9218c1fd",78340:"5f10f6e3",78541:"0abbbb35",78776:"f46c4408",79014:"e77a5489",79054:"722ec584",79061:"4fd81f4e",79376:"6249c7de",79475:"1db45fbc",79480:"7c767e9e",79681:"a1fd7cfe",79923:"77622da5",80053:"935f2afb",80103:"500ab5e8",80369:"a7c6c228",80536:"17c91901",80567:"df36d98d",80808:"b85fa405",81135:"6c43de6e",81447:"df330cef",81451:"563d7403",81981:"c8450cf2",82311:"f965b663",82381:"16127d6f",82672:"71c1d7a6",82708:"d5e6c777",82718:"471f7fbd",82921:"12f49e0c",83100:"da6ad706",83154:"67009ff2",83302:"9622a62d",83398:"9f602629",83416:"d8f590ab",83616:"0d16b667",83701:"ef308d07",83771:"8c02dfd8",84052:"1dc390ba",84099:"38f61187",84249:"8dca2180",84386:"121b1090",84959:"c75d7ff6",84987:"d94bb6b6",85056:"730110a3",85534:"e593aec6",85621:"87b2412c",85836:"bf0b75c4",85897:"6b3775fc",85953:"b700f6c8",86072:"26183636",86139:"9267eb77",86390:"c4cf1261",86529:"cb4175f3",87074:"6268d0ca",87414:"393be207",87593:"50219e10",87655:"40230f21",87677:"750960ca",87824:"4c4c3de8",88831:"3c8da607",89047:"856bceac",89083:"db4f0c5e",89167:"faee50e1",89209:"198290f4",89776:"b7c7e74a",90357:"e0751957",91177:"8ce69432",91569:"5a7e7a34",91759:"ec202e26",92146:"53d93800",92560:"0c337ca4",92903:"84ee34f2",92957:"d5a10f7c",93006:"5be4f4f7",93348:"eb2927ba",93387:"007a6c32",93418:"49dbb45e",93507:"4a6f24a9",93543:"510addcb",94089:"d9ffe17e",94194:"4b3e38af",94276:"d108a77f",94319:"d0816b53",94506:"fd03cc72",94907:"29f28a73",95496:"994f6abf",95662:"caaad1b0",95690:"f4bc196f",96235:"7fc2b4c9",96247:"6ab4df05",96276:"8aadacf1",96361:"3aecebcc",96551:"120d9fdd",97421:"c8a855a5",97482:"4a3e680b",97500:"d63a00cf",97719:"51c3befa",97879:"e9d56634",97920:"1a4e3797",98016:"ffb2e417",98591:"a61cb094",98604:"d0931cd6",98630:"68e9a632",98692:"67044a7a",98948:"65e0cd55",98960:"4ade5613",99070:"02574e0f",99438:"b5511831",99822:"595b2ce9",99889:"f56b8973"}[e]||e)+"."+{42:"8ec5c37a",520:"1e6c946b",783:"200735d8",1269:"d12c7197",1286:"c853b0a9",1714:"561048f6",1739:"3d437425",1802:"751ec081",1893:"4a98b5fe",2050:"823155de",2112:"82477c40",2338:"18e6b223",2375:"2c98d1be",2449:"c8c4a269",2528:"17f369fc",2666:"1a51e707",2951:"21706190",3299:"397ec1ec",3300:"5190d89e",3425:"c94bfab8",3522:"cd5009f7",3705:"a8fc058b",4159:"6d060ce6",4387:"c65dc917",4637:"85eb2003",4694:"b5334a0e",4696:"261d15e2",4972:"c1e0c51c",5159:"2218c8e5",5295:"c652c243",5872:"1f80115e",5886:"d9475a2e",6282:"6327de25",6338:"63a0beb9",6473:"60886f6c",6597:"387621a1",6675:"a9f56922",6849:"fdf2e81b",6874:"5a9125b3",7213:"e7617507",7267:"e5c093aa",7383:"e657b235",7828:"eff4cfcc",8025:"739425f2",8179:"d929c0f4",8347:"b4d9ec33",8966:"e04d2290",9022:"9e4d05b5",9113:"9af2d8ee",9300:"261c6639",9532:"5ec3ca5b",9609:"288677fa",9624:"ace35f3d",9799:"51815cbe",9800:"8135d36c",9817:"f9d79ca6",10225:"3d3596d5",10235:"7e46f062",10293:"c888a256",11005:"c3316bcb",11013:"aece890c",11053:"95e56544",11265:"0c81fd6e",11389:"3cc70e96",11396:"97c3687b",11792:"4655b6c9",11908:"9641f6e6",12333:"708f853e",12717:"2a5c979f",12933:"95fbe59d",13085:"74c4de50",13258:"48b6f14c",13408:"e6044319",13739:"b1b348b9",13959:"22451ad5",13994:"f6412254",14030:"57c1e1f4",14132:"618c5934",14243:"561b594f",14281:"cf8be476",14491:"23ccaa23",14582:"c88568c5",14681:"5b04162a",14731:"6e6937e7",14777:"7c92fb86",14796:"72d3e984",15068:"a911fd6e",15114:"d790a544",15309:"8230c2ac",15361:"43a57641",15365:"4759fbe7",15609:"536132e5",15669:"eb21dd04",16071:"2dc6ee69",16225:"ce0d8a37",16377:"bcac3475",16667:"4487755d",16720:"2d17fe6d",16825:"9319d7a3",17070:"816bc002",17210:"045fe953",17445:"18a650a4",17638:"ca541869",17719:"84fcedca",18104:"7894f548",18287:"e6a54e4f",18772:"12f8bdf4",18894:"2da9821d",19065:"b47a98dd",19178:"96987a51",19270:"25a94c9f",19389:"feb155f7",19715:"44f46d4f",19831:"5f90158e",20048:"463f63d9",20367:"0bb13b15",20844:"0c3e4097",20926:"c03cd929",21004:"036b2b1f",21390:"358990f1",21493:"46447667",22162:"5ebbe176",22399:"80f66527",22761:"365a347a",22982:"4c970639",23003:"e504b4f5",23022:"a4b81923",23389:"8c8835a8",23750:"a459602c",23905:"a6ac1772",24069:"3d8e0c85",24180:"baa2cde2",24804:"cced5827",24851:"70836f6d",24989:"6dac20a5",25329:"0936a0bf",25370:"9fc51795",25374:"6d32276c",25382:"d968e579",25733:"0daca711",25760:"5719a260",25785:"c05878f8",25968:"fab4e438",25969:"c51b573e",26295:"4f220773",26467:"c93b2d2c",26648:"acbaf873",26668:"560b68f2",26912:"553e892b",27044:"20a47715",27133:"b97d9701",27188:"546365fc",27212:"603070bc",27238:"79cef3a2",28135:"5b1476ac",28364:"7f11b9bc",28460:"58ef3bea",28492:"99707b9e",28608:"315c7081",28781:"22102bff",28801:"54787bb9",28848:"78bc233c",29010:"7a57b036",29217:"38f19102",29514:"e4bcc747",29538:"0518905a",29766:"f4debd7e",29770:"a8c9193f",29976:"63adaa26",30561:"1fc90304",30601:"2a5579b9",30701:"8b5b0eb7",30797:"c3f31e84",30882:"3c5ac118",31094:"1d999bf8",31404:"008d83aa",32111:"e4935bce",32197:"f7526dac",32252:"816c7d32",32490:"d0adf848",32755:"798bebd2",33224:"7164f3fa",33240:"726c4a87",33312:"9907b91c",33404:"0efbfadd",33509:"f924244a",33527:"9210a768",33659:"f6432c75",34024:"b023dd19",34288:"96f99452",34548:"069d388f",34730:"7421fa7a",35167:"b49fab92",35416:"048c875f",35701:"2f7bace8",35708:"0fe8f81f",35832:"b9826c9c",35943:"409c78ee",36106:"9fef4943",36553:"1d050c36",36554:"f49113cb",36904:"608c4f10",37018:"c6e5914d",37486:"c2082024",37487:"0b43fb28",37710:"b7333728",37896:"aa3c7b74",37950:"c18aeed0",38270:"c1ef53c6",38460:"e88eec46",38704:"54aecbb0",38890:"afa6ad85",38948:"4c0cbf75",38959:"12c42e0b",39127:"8b4cf1c4",39580:"74280f6d",39626:"db9dd9ea",39796:"0f844535",39833:"ddaa316d",40073:"172d8b51",40114:"c7285751",40211:"3df45470",40219:"7603b1f6",40542:"575195b2",40614:"1611c893",40683:"7bdae07a",40701:"25786565",40916:"729db7d8",41003:"36e31dce",41804:"d1aca82e",41877:"1814cb04",41943:"c72a17b4",42069:"0dfe52de",42885:"2be43e41",44120:"8f4578a0",44209:"28c163b6",44758:"0762d9fa",44916:"1bc7c335",45111:"0a16adcc",45167:"3abc174e",46039:"362e0ba9",46215:"08417467",46566:"a5077acb",46739:"a6a1b415",46945:"11021670",46976:"2442f078",47137:"255916c9",47328:"f651ed90",47361:"ce148179",47563:"dddd758f",47615:"835b1cc6",48026:"8cad975d",48081:"23fd8a90",48169:"d5d88ba9",48890:"32c5ddf3",48954:"cdfc2c65",49486:"d0d13f08",49717:"770b3669",49755:"a388e846",50067:"0bdf2d2a",50430:"055e1b9d",50730:"c5d66129",50893:"36df98f6",50932:"5af46298",51106:"daff27bd",51410:"c9fc3c07",51523:"8598a7f5",52474:"bb1fc8da",52486:"635a774e",52574:"472cf42f",52654:"92b816af",52831:"ddac26da",53408:"10f7cff0",53482:"df103e38",53501:"b8181aec",53630:"c92dce0e",54029:"2654235a",54053:"833e68fe",54601:"c7802446",54636:"56e055f1",54801:"433ccde3",54820:"d82b721a",55038:"0efb12f2",55229:"195e46dd",55381:"46ee0f90",55480:"a376413f",56025:"16398596",56319:"74302ebf",56370:"239ad3c7",56382:"3def563d",56886:"cde29d7f",56963:"0c50b8a7",56979:"0ba2abc6",57067:"94292e0b",57152:"af1ad35a",57251:"6b0fd1ad",57287:"23ff262e",57756:"f5aeb441",57979:"72351062",58188:"1fe0b3e6",58235:"2bd52ae5",58353:"622fffee",58663:"57e0701e",59082:"9a996868",59131:"441f24ce",59135:"6f73f94f",59607:"ac987203",59728:"45c9a7a9",59856:"0b84f70e",59865:"deb8694a",59910:"f68f6820",59953:"4166ce32",60298:"5f669764",60310:"e1cf2bf5",61304:"009bd8ba",62062:"08d33ceb",62353:"3b2b9e41",62457:"904e3a57",62860:"d437b595",63447:"3d31efcb",63497:"1909fe74",63851:"c999ace8",64166:"b71eccd0",64195:"07350901",64209:"f5ad69ae",64214:"2cc8e777",64280:"17c1f321",64497:"b04c0ea8",64549:"1a1add38",64925:"e236d4b5",65149:"e68f1374",65154:"fb3eceb4",65368:"5b1c1d58",65687:"c6809b64",65787:"9d309eef",65818:"c592639d",65957:"95afcdf9",66068:"31c4a50e",66286:"bf1549af",66345:"8c235ba0",66880:"fa4535e7",67365:"5330d4b8",67374:"2dfcace3",67746:"73579300",67813:"169c3ef2",67861:"feded733",68207:"90230241",68253:"87f711c9",68349:"3df1974e",68503:"89385e31",68724:"bd00f8e9",68809:"ae6235ee",68970:"486ee1b8",69043:"b88c085a",69125:"c6e399ca",69572:"0037e2de",69753:"9e4ebb05",69905:"5390d20c",70332:"858736ed",70633:"2676ed95",70670:"4647b158",70743:"1bc17e63",70838:"ca8f625c",71347:"b8233b2a",71600:"387e240c",71723:"ee2b5980",71814:"56dd82a2",71871:"0852f5b7",71910:"43fea2d8",72379:"a5deef84",72809:"cf9cae29",73375:"177280a8",73464:"5f9bce6c",73602:"b19c6515",73634:"1d31afcb",73695:"e2b4cac6",73905:"8bd67e5c",73918:"a40b3907",74190:"eb8b4856",74298:"d717c136",74428:"9fbb9bdd",74531:"67a3f108",74811:"ab3f1287",74971:"9f410043",75063:"bc1a14f2",75288:"f71e9af9",75600:"fe5ce8c7",75791:"a8af9e17",75975:"b8709007",76152:"78ae7b11",76428:"be894448",76434:"86d6b0f1",76541:"bf22c3cc",76549:"cb62be0f",76780:"a2521cf6",77184:"5344e158",77811:"806940f9",77937:"2057d3d0",77944:"3b62a8fd",77999:"6003a871",78023:"31dba325",78099:"29723372",78315:"fddd6e0b",78340:"ccf543f6",78541:"1875c215",78776:"cdc83d7f",79014:"c22fd11d",79054:"1befeea2",79061:"ef8259de",79376:"999c093a",79475:"92335dcf",79480:"e7e81336",79681:"2e9a82c3",79923:"24e9dfb4",80053:"a30cc0bf",80103:"adb45701",80369:"823951a8",80536:"1fc24eda",80567:"41116648",80808:"d89117d5",81135:"4c893d97",81447:"6435e97d",81451:"62ffeb28",81981:"aca1e4a5",82311:"3f1a2d90",82381:"faeefc76",82672:"b1911849",82708:"05665a03",82718:"52d0bf25",82921:"9a7337d5",83100:"ff43253e",83154:"b0af7501",83302:"05d57b7e",83398:"506a6916",83416:"7b819fe1",83616:"6657d22f",83701:"760e705a",83771:"1c42add4",84052:"b0bd8b53",84099:"de2f4999",84249:"89ad564d",84386:"3cdac849",84959:"77f53787",84987:"74bfc775",85056:"e929ee43",85534:"9bf0046e",85621:"b14f6a91",85836:"f5345df0",85897:"fbdef801",85953:"474bfc80",86072:"b2386542",86139:"3ec102bb",86390:"98cacb7c",86529:"ec82adac",87074:"28692833",87414:"e74de51a",87593:"699b8d97",87655:"664033ae",87677:"baaf40c3",87824:"7eddecc7",88831:"a9e7aed9",89047:"bc17d954",89083:"59f9af31",89167:"5983c73f",89209:"714b0880",89776:"04406d29",90357:"35110dae",91177:"51f8fe7f",91569:"ce93dfb7",91759:"b5658319",92146:"8a7f1067",92560:"de5b412a",92903:"eb94d4d8",92957:"33762a9e",93006:"4305a022",93348:"27f4c48c",93387:"64b4440b",93418:"f73cf098",93507:"a657a544",93543:"3e92aad4",94089:"adfc8b09",94194:"e23dd625",94276:"185d232d",94319:"2bf1ddcc",94506:"3a8a0c30",94907:"8a083c0f",95496:"603eb1ee",95662:"24ecc4ca",95690:"ebf24935",96235:"600ea051",96247:"14850e15",96276:"74c119ca",96361:"7c9a09d0",96551:"807583b8",97421:"2e7bbb6e",97482:"beb13a9b",97500:"1bd487e5",97719:"95bd6f21",97879:"c92ac662",97920:"d5457aa2",98016:"d08720e9",98591:"418e99dd",98604:"5372b027",98630:"7607f8c9",98692:"f146280e",98948:"75dc840b",98960:"2d71c0d5",99070:"6d90e6e1",99438:"6c99546d",99822:"8bf2a709",99889:"d667b6bf"}[e]+".js",t.miniCssF=e=>{},t.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),t.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),d={},b="docusaurus-docs:",t.l=(e,a,c,f)=>{if(d[e])d[e].push(a);else{var r,o;if(void 0!==c)for(var n=document.getElementsByTagName("script"),i=0;i{r.onerror=r.onload=null,clearTimeout(l);var b=d[e];if(delete d[e],r.parentNode&&r.parentNode.removeChild(r),b&&b.forEach((e=>e(c))),a)return a(c)},l=setTimeout(s.bind(null,void 0,{type:"timeout",target:r}),12e4);r.onerror=s.bind(null,r.onerror),r.onload=s.bind(null,r.onload),o&&document.head.appendChild(r)}},t.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.nmd=e=>(e.paths=[],e.children||(e.children=[]),e),t.p="/docs/",t.gca=function(e){return e={26183636:"86072",40878283:"76434",44177285:"6597",65246720:"19065",68079445:"9532",78950515:"4387",79022373:"21493",82405689:"18287",84002310:"783","2518c83b":"42",fb1a77b4:"520","9e31950e":"1269",f5bce583:"1286","6c068fb7":"1714","510acf22":"1739","96368f4f":"1802","4c5e977b":"1893",f54e89d1:"2050","5e4fe134":"2112","5b157bd1":"2338","1c94925b":"2375","3e99551e":"2449","5b292b69":"2528","09c26509":"2666","9bb13d2e":"2951","7e3ea763":"3299","655c39d2":"3300","602542a3":"3425",abf6ee25:"3522",b3a5153e:"3705",b9acd066:"4159",b65b34ba:"4637","98dc0d0e":"4694","9569bc2f":"4696","9d6ed550":"5159","5bcf38c1":"5295","587e3d47":"5872","31d96af4":"5886",cd8b4f9a:"6282",a83fc124:"6473","036e14f3":"6675","548bc066":"6849","8b221193":"6874",f93f119a:"7213",c9713a6d:"7267","225c9eb6":"7383",f72af8b9:"7828",b42f8477:"8025","136658e4":"8179","8b988d57":"8347","16ef1cd9":"8966","29b0efd4":"9022","84ab2fd1":"9113","903944d2":"9300","8e84b0d9":"9609","3042b185":"9624","9ff509e1":"9800","14eb3368":"9817","883bb60a":"10225",a7d19085:"10235",fa570740:"10293",c127b609:"11005",e8acd80e:"11013","7205acf7":"11053",f6106990:"11265",a005ddbc:"11389",e3e28d8f:"11396","855341b1":"11792",f9fe6464:"11908","650716b7":"12333","0b0bc04d":"12717",b6036b82:"12933","1f391b9e":"13085",b5961036:"13258",fdf22a50:"13408","5e33bc00":"13739","2d0f081e":"13959",b2ae77a0:"13994",c5d3bb95:"14030",b6eadb9e:"14132","0744e06b":"14243","30bb4662":"14281","1fefa037":"14491",fed448c0:"14582","1be75057":"14681","64e1104a":"14731","269ec971":"14777",a41d5bc2:"14796",e4440f9d:"15068",ee7f03d8:"15114","57f8207f":"15309","4d2ad36f":"15361",b82d00b2:"15365","060b1584":"15609","5220550c":"15669","094a53a9":"16071",d02b6e20:"16225","07ffdee5":"16377",f81ec24e:"16667","4ac45b89":"16720","5621bfd0":"16825",c78b1140:"17070",daa5df1a:"17210","1a299676":"17445",e165cecb:"17638","6623a699":"17719","7ab943be":"18104",c83cf481:"18772","3956460a":"19178",cba951d8:"19270","2a8d8e88":"19389","2cfd0fc8":"19715","4e7e2ca5":"19831","441ee7d2":"20048","05a3c259":"20367","4e1901bc":"20844","05bb3e6b":"20926",bc0c7228:"21004",a6905832:"21390","31593e16":"22162","0d34b62b":"22399",f041af6f:"22982","34fadc99":"23003",e0a5c1d2:"23022","9041aea1":"23389",c77ce8fa:"23750",d288e937:"23905","41ce3377":"24069","83b28724":"24180","440f78e7":"24804",a592f1e4:"24851","0f2dc4ca":"24989","4eca193c":"25329",af4a2ad4:"25370","980085d9":"25374","632d2515":"25382","735936a9":"25733","31e78686":"25760","20f55e05":"25785","156751cf":"25968","07ca0209":"25969","67f94a41":"26295","302d24dc":"26467","0157939d":"26648",b9fa1d17:"26668","197a4930":"26912","89e5bdec":"27044","92e99bf6":"27133","5036ec9d":"27188",e6cbd2ed:"27212",e298e99e:"27238","89179ad6":"28135","069e89fb":"28364",dd3ced3a:"28460","9931c5c6":"28492","0cadbdb9":"28608","7e458d36":"28781","6dfc2f3d":"28801","99d44459":"28848","8c2621f5":"29010","547b19b8":"29217","1be78505":"29514","4c950052":"29538","5bf23af0":"29766","06b60cb4":"29770",f512b2b1:"29976",bc670d5c:"30561",e5d84bc0:"30601","21fa7ce5":"30701","80238aff":"30797",aedc496a:"30882","8675103a":"31094","3e301362":"31404","74db685e":"32111",eb357560:"32197",eef51a73:"32252","1eaa7a2a":"32490","7e04e77d":"32755","1bd0c971":"33224","0ab53148":"33240","8cd2105d":"33312",afdda5b6:"33404","786f71e5":"33509",a5e760bc:"33527","0e5cbc44":"33659","99f24057":"34024",af1ac92b:"34288","1a8c488b":"34548",f4b2f868:"34730","6c74a4d7":"35167",cc68b255:"35416",d02347dc:"35701","41eb0037":"35708",b745f339:"35832",bc53881b:"35943",c2ebbb3e:"36106","18a5e8d6":"36553","9d979a6d":"36554","637cfff4":"36904","01464744":"37018",dcc6b54d:"37486",a9bf2227:"37487",c11bd48d:"37710","83cc66ac":"37896","8825024b":"37950","5393ce94":"38270",c2d32f88:"38460","8338c5ef":"38704",c084c2e9:"38890",bc8bd5d6:"38948","1eb543d3":"38959",a230a772:"39127","75ecb4f9":"39580",fd867f7c:"39626","3e9399ec":"39796","26987f39":"39833","359a0a8d":"40073","8740ec05":"40114",eb907bb2:"40211","49e3720f":"40219","41790d5d":"40542","716600a7":"40614","0abae2e0":"40683","1ce0a301":"40701",e4459066:"40916",d0d62bb5:"41003",ee640683:"41804","717e7ee6":"41877","62029e95":"41943","9a6be05d":"42069",acdbee8e:"42885",a61ed651:"44120","278665dc":"44209","0a13a0e4":"44758","95d5a544":"44916",cb819e9b:"45111",da88d543:"45167","778f38dc":"46039","784585a8":"46215","763e4dec":"46566","2dd5aaa1":"46739","70b01d77":"46976","47f09a6b":"47137","6daf901a":"47328","7a5188cd":"47361","146da2b4":"47563","84ebbbbf":"47615",a120aaca:"48026","5dce62fd":"48081",e4492fa7:"48169",d5603669:"48890",b0bdb7f3:"48954",e72cf26a:"49486",a5962d55:"49717",c123803f:"49755","246367e0":"50067","867911a0":"50430","4b1cba20":"50730","965dbb95":"50893","485af29a":"50932",dd813bf5:"51106",bd1a9377:"51410",a3761f7f:"51523","4507e508":"52474",de127d6b:"52486",e2668db3:"52574",f024ddd5:"52654","5ec88f12":"52831","4694df8d":"53408",a718913e:"53482","7795e3fe":"53501",dd02e78e:"53630",e286ec4c:"54029","24e3585b":"54053",c552c222:"54601","760e3208":"54636","3ec68450":"54801","05a18904":"54820","100f3054":"55038","2fcfad90":"55229",cfc9c16e:"55381","006095b2":"55480",c3aed80f:"56025","879063fc":"56319","36f93d19":"56370","9ffa1a6c":"56382","4b7a6889":"56886","1b80e345":"56963",d005934a:"56979",eece046c:"57067",e09bff2e:"57152",eb1718b4:"57251",bde9fb45:"57287","6ab4408e":"57756",c5059afe:"57979",e73e328f:"58188","3bdeaa89":"58235","162f137e":"58353",c7dcc258:"58663","6a9a7317":"59082","3b0223df":"59131",e27b8251:"59135","25f376d4":"59607",aa5bd2a7:"59728",e5c88a3e:"59856",e8ee0390:"59865","16142a34":"59910","2041170f":"59953",d4e7ac8a:"60298","5913a508":"60310","8d5fe6f9":"61304","988ba51e":"62062","35d50d77":"62353","30e5c1aa":"62457","3d49fc0e":"62860","1c5b9066":"63447",b8541bfd:"63497","51b69e86":"63851",c54a5582:"64166",c4f5d8e4:"64195",d7a48e98:"64209","575f1b1b":"64214","95a35da8":"64280","099f8a1f":"64497","788d9fe0":"64549","7ee339c8":"64925","53e78238":"65149",af35203c:"65154",cc468388:"65368","2f2f8f8f":"65687",c4ae09d4:"65787",ae255275:"65818",e4627c87:"65957",e8bf0c3e:"66068","13d7a585":"66286","42a8d727":"66345",f32d8490:"66880","18f77871":"67365","6279c8a9":"67374",df7ec86c:"67746","8894256f":"67813","0f9cda3e":"67861","7622c6de":"68207","363ba2d8":"68253","3d3a07f6":"68349",f8c92f63:"68503","4090f62b":"68809",eaafcd74:"68970","9ad8637e":"69043",c80ee60a:"69125","8000380e":"69572","7e31db45":"69753",e23eefc0:"69905","39fee459":"70332",b50c9021:"70633",e62aa786:"70670",c7399101:"70743","22bdf908":"70838",e93ff9aa:"71347","397d4a7e":"71600","0328b0c9":"71723",ce32ce4d:"71871","2a3724f5":"71910","9dba6800":"72379","540cb455":"72809","94fe2afe":"73375","3c6391c1":"73464","696ed493":"73602",e0bec19d:"73634",bdb43652:"73695","94b87f57":"73905","4294ceba":"73918","84cf2087":"74190","48db5030":"74298","53d82fc0":"74428",b25d4024:"74531",cf33a5bc:"74811","0ed89c29":"74971",cf69f832:"75063","77de130e":"75288","30fdf4bf":"75600","0667cc8f":"75791","0de52270":"75975",b180b1b1:"76152","418c923e":"76428",d67ae496:"76541","7a65c859":"76549","11b4dd89":"77184","18a382cc":"77811",ea313555:"77937","6bc64de5":"77944","3af651bf":"77999","2b20c80a":"78023",ad577885:"78099","9218c1fd":"78315","5f10f6e3":"78340","0abbbb35":"78541",f46c4408:"78776",e77a5489:"79014","722ec584":"79054","4fd81f4e":"79061","6249c7de":"79376","1db45fbc":"79475","7c767e9e":"79480",a1fd7cfe:"79681","77622da5":"79923","935f2afb":"80053","500ab5e8":"80103",a7c6c228:"80369","17c91901":"80536",df36d98d:"80567",b85fa405:"80808","6c43de6e":"81135",df330cef:"81447","563d7403":"81451",c8450cf2:"81981",f965b663:"82311","16127d6f":"82381","71c1d7a6":"82672",d5e6c777:"82708","471f7fbd":"82718","12f49e0c":"82921",da6ad706:"83100","67009ff2":"83154","9622a62d":"83302","9f602629":"83398",d8f590ab:"83416","0d16b667":"83616",ef308d07:"83701","8c02dfd8":"83771","1dc390ba":"84052","38f61187":"84099","8dca2180":"84249","121b1090":"84386",c75d7ff6:"84959",d94bb6b6:"84987","730110a3":"85056",e593aec6:"85534","87b2412c":"85621",bf0b75c4:"85836","6b3775fc":"85897",b700f6c8:"85953","9267eb77":"86139",c4cf1261:"86390",cb4175f3:"86529","6268d0ca":"87074","393be207":"87414","50219e10":"87593","40230f21":"87655","750960ca":"87677","4c4c3de8":"87824","3c8da607":"88831","856bceac":"89047",db4f0c5e:"89083",faee50e1:"89167","198290f4":"89209",b7c7e74a:"89776",e0751957:"90357","8ce69432":"91177","5a7e7a34":"91569",ec202e26:"91759","53d93800":"92146","0c337ca4":"92560","84ee34f2":"92903",d5a10f7c:"92957","5be4f4f7":"93006",eb2927ba:"93348","007a6c32":"93387","49dbb45e":"93418","4a6f24a9":"93507","510addcb":"93543",d9ffe17e:"94089","4b3e38af":"94194",d108a77f:"94276",d0816b53:"94319",fd03cc72:"94506","29f28a73":"94907","994f6abf":"95496",caaad1b0:"95662",f4bc196f:"95690","7fc2b4c9":"96235","6ab4df05":"96247","8aadacf1":"96276","3aecebcc":"96361","120d9fdd":"96551",c8a855a5:"97421","4a3e680b":"97482",d63a00cf:"97500","51c3befa":"97719",e9d56634:"97879","1a4e3797":"97920",ffb2e417:"98016",a61cb094:"98591",d0931cd6:"98604","68e9a632":"98630","67044a7a":"98692","65e0cd55":"98948","4ade5613":"98960","02574e0f":"99070",b5511831:"99438","595b2ce9":"99822",f56b8973:"99889"}[e]||e,t.p+t.u(e)},(()=>{var e={51303:0,40532:0};t.f.j=(a,c)=>{var d=t.o(e,a)?e[a]:void 0;if(0!==d)if(d)c.push(d[2]);else if(/^(40532|51303)$/.test(a))e[a]=0;else{var b=new Promise(((c,b)=>d=e[a]=[c,b]));c.push(d[2]=b);var f=t.p+t.u(a),r=new Error;t.l(f,(c=>{if(t.o(e,a)&&(0!==(d=e[a])&&(e[a]=void 0),d)){var b=c&&("load"===c.type?"missing":c.type),f=c&&c.target&&c.target.src;r.message="Loading chunk "+a+" failed.\n("+b+": "+f+")",r.name="ChunkLoadError",r.type=b,r.request=f,d[1](r)}}),"chunk-"+a,a)}},t.O.j=a=>0===e[a];var a=(a,c)=>{var d,b,f=c[0],r=c[1],o=c[2],n=0;if(f.some((a=>0!==e[a]))){for(d in r)t.o(r,d)&&(t.m[d]=r[d]);if(o)var i=o(t)}for(a&&a(c);n{"use strict";var e,a,c,d,b,f={},r={};function t(e){var a=r[e];if(void 0!==a)return a.exports;var c=r[e]={id:e,loaded:!1,exports:{}};return f[e].call(c.exports,c,c.exports,t),c.loaded=!0,c.exports}t.m=f,e=[],t.O=(a,c,d,b)=>{if(!c){var f=1/0;for(i=0;i=b)&&Object.keys(t.O).every((e=>t.O[e](c[o])))?c.splice(o--,1):(r=!1,b0&&e[i-1][2]>b;i--)e[i]=e[i-1];e[i]=[c,d,b]},t.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return t.d(a,{a:a}),a},c=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,t.t=function(e,d){if(1&d&&(e=this(e)),8&d)return e;if("object"==typeof e&&e){if(4&d&&e.__esModule)return e;if(16&d&&"function"==typeof e.then)return e}var b=Object.create(null);t.r(b);var f={};a=a||[null,c({}),c([]),c(c)];for(var r=2&d&&e;"object"==typeof r&&!~a.indexOf(r);r=c(r))Object.getOwnPropertyNames(r).forEach((a=>f[a]=()=>e[a]));return f.default=()=>e,t.d(b,f),b},t.d=(e,a)=>{for(var c in a)t.o(a,c)&&!t.o(e,c)&&Object.defineProperty(e,c,{enumerable:!0,get:a[c]})},t.f={},t.e=e=>Promise.all(Object.keys(t.f).reduce(((a,c)=>(t.f[c](e,a),a)),[])),t.u=e=>"assets/js/"+({42:"2518c83b",520:"fb1a77b4",783:"84002310",1269:"9e31950e",1286:"f5bce583",1714:"6c068fb7",1739:"510acf22",1802:"96368f4f",1893:"4c5e977b",2050:"f54e89d1",2112:"5e4fe134",2338:"5b157bd1",2375:"1c94925b",2449:"3e99551e",2528:"5b292b69",2666:"09c26509",2951:"9bb13d2e",3299:"7e3ea763",3300:"655c39d2",3425:"602542a3",3522:"abf6ee25",3705:"b3a5153e",4159:"b9acd066",4387:"78950515",4637:"b65b34ba",4694:"98dc0d0e",4696:"9569bc2f",5159:"9d6ed550",5295:"5bcf38c1",5872:"587e3d47",5886:"31d96af4",6282:"cd8b4f9a",6473:"a83fc124",6597:"44177285",6675:"036e14f3",6849:"548bc066",6874:"8b221193",7213:"f93f119a",7267:"c9713a6d",7383:"225c9eb6",7828:"f72af8b9",8025:"b42f8477",8179:"136658e4",8347:"8b988d57",8966:"16ef1cd9",9022:"29b0efd4",9113:"84ab2fd1",9300:"903944d2",9532:"68079445",9609:"8e84b0d9",9624:"3042b185",9800:"9ff509e1",9817:"14eb3368",10225:"883bb60a",10235:"a7d19085",10293:"fa570740",11005:"c127b609",11013:"e8acd80e",11053:"7205acf7",11265:"f6106990",11389:"a005ddbc",11396:"e3e28d8f",11792:"855341b1",11908:"f9fe6464",12333:"650716b7",12717:"0b0bc04d",12933:"b6036b82",13085:"1f391b9e",13258:"b5961036",13408:"fdf22a50",13739:"5e33bc00",13959:"2d0f081e",13994:"b2ae77a0",14030:"c5d3bb95",14132:"b6eadb9e",14243:"0744e06b",14281:"30bb4662",14491:"1fefa037",14582:"fed448c0",14681:"1be75057",14731:"64e1104a",14777:"269ec971",14796:"a41d5bc2",15068:"e4440f9d",15114:"ee7f03d8",15309:"57f8207f",15361:"4d2ad36f",15365:"b82d00b2",15609:"060b1584",15669:"5220550c",16071:"094a53a9",16225:"d02b6e20",16377:"07ffdee5",16667:"f81ec24e",16720:"4ac45b89",16825:"5621bfd0",17070:"c78b1140",17210:"daa5df1a",17445:"1a299676",17638:"e165cecb",17719:"6623a699",18104:"7ab943be",18287:"82405689",18772:"c83cf481",19065:"65246720",19178:"3956460a",19270:"cba951d8",19389:"2a8d8e88",19715:"2cfd0fc8",19831:"4e7e2ca5",20048:"441ee7d2",20367:"05a3c259",20844:"4e1901bc",20926:"05bb3e6b",21004:"bc0c7228",21390:"a6905832",21493:"79022373",22162:"31593e16",22399:"0d34b62b",22982:"f041af6f",23003:"34fadc99",23022:"e0a5c1d2",23389:"9041aea1",23750:"c77ce8fa",23905:"d288e937",24069:"41ce3377",24180:"83b28724",24804:"440f78e7",24851:"a592f1e4",24989:"0f2dc4ca",25329:"4eca193c",25370:"af4a2ad4",25374:"980085d9",25382:"632d2515",25733:"735936a9",25760:"31e78686",25785:"20f55e05",25968:"156751cf",25969:"07ca0209",26295:"67f94a41",26467:"302d24dc",26648:"0157939d",26668:"b9fa1d17",26912:"197a4930",27044:"89e5bdec",27133:"92e99bf6",27188:"5036ec9d",27212:"e6cbd2ed",27238:"e298e99e",28135:"89179ad6",28364:"069e89fb",28460:"dd3ced3a",28492:"9931c5c6",28608:"0cadbdb9",28781:"7e458d36",28801:"6dfc2f3d",28848:"99d44459",29010:"8c2621f5",29217:"547b19b8",29514:"1be78505",29538:"4c950052",29766:"5bf23af0",29770:"06b60cb4",29976:"f512b2b1",30561:"bc670d5c",30601:"e5d84bc0",30701:"21fa7ce5",30797:"80238aff",30882:"aedc496a",31094:"8675103a",31404:"3e301362",32111:"74db685e",32197:"eb357560",32252:"eef51a73",32490:"1eaa7a2a",32755:"7e04e77d",33224:"1bd0c971",33240:"0ab53148",33312:"8cd2105d",33404:"afdda5b6",33509:"786f71e5",33527:"a5e760bc",33659:"0e5cbc44",34024:"99f24057",34288:"af1ac92b",34548:"1a8c488b",34730:"f4b2f868",35167:"6c74a4d7",35416:"cc68b255",35701:"d02347dc",35708:"41eb0037",35832:"b745f339",35943:"bc53881b",36106:"c2ebbb3e",36553:"18a5e8d6",36554:"9d979a6d",36904:"637cfff4",37018:"01464744",37486:"dcc6b54d",37487:"a9bf2227",37710:"c11bd48d",37896:"83cc66ac",37950:"8825024b",38270:"5393ce94",38460:"c2d32f88",38704:"8338c5ef",38890:"c084c2e9",38948:"bc8bd5d6",38959:"1eb543d3",39127:"a230a772",39580:"75ecb4f9",39626:"fd867f7c",39796:"3e9399ec",39833:"26987f39",40073:"359a0a8d",40114:"8740ec05",40211:"eb907bb2",40219:"49e3720f",40542:"41790d5d",40614:"716600a7",40683:"0abae2e0",40701:"1ce0a301",40916:"e4459066",41003:"d0d62bb5",41804:"ee640683",41877:"717e7ee6",41943:"62029e95",42069:"9a6be05d",42885:"acdbee8e",44120:"a61ed651",44209:"278665dc",44758:"0a13a0e4",44916:"95d5a544",45111:"cb819e9b",45167:"da88d543",46039:"778f38dc",46215:"784585a8",46566:"763e4dec",46739:"2dd5aaa1",46976:"70b01d77",47137:"47f09a6b",47328:"6daf901a",47361:"7a5188cd",47563:"146da2b4",47615:"84ebbbbf",48026:"a120aaca",48081:"5dce62fd",48169:"e4492fa7",48890:"d5603669",48954:"b0bdb7f3",49486:"e72cf26a",49717:"a5962d55",49755:"c123803f",50067:"246367e0",50430:"867911a0",50730:"4b1cba20",50893:"965dbb95",50932:"485af29a",51106:"dd813bf5",51410:"bd1a9377",51523:"a3761f7f",52474:"4507e508",52486:"de127d6b",52574:"e2668db3",52654:"f024ddd5",52831:"5ec88f12",53408:"4694df8d",53482:"a718913e",53501:"7795e3fe",53630:"dd02e78e",54029:"e286ec4c",54053:"24e3585b",54601:"c552c222",54636:"760e3208",54801:"3ec68450",54820:"05a18904",55038:"100f3054",55229:"2fcfad90",55381:"cfc9c16e",55480:"006095b2",56025:"c3aed80f",56319:"879063fc",56370:"36f93d19",56382:"9ffa1a6c",56886:"4b7a6889",56963:"1b80e345",56979:"d005934a",57067:"eece046c",57152:"e09bff2e",57251:"eb1718b4",57287:"bde9fb45",57756:"6ab4408e",57979:"c5059afe",58188:"e73e328f",58235:"3bdeaa89",58353:"162f137e",58663:"c7dcc258",59082:"6a9a7317",59131:"3b0223df",59135:"e27b8251",59607:"25f376d4",59728:"aa5bd2a7",59856:"e5c88a3e",59865:"e8ee0390",59910:"16142a34",59953:"2041170f",60298:"d4e7ac8a",60310:"5913a508",61304:"8d5fe6f9",62062:"988ba51e",62353:"35d50d77",62457:"30e5c1aa",62860:"3d49fc0e",63447:"1c5b9066",63497:"b8541bfd",63851:"51b69e86",64166:"c54a5582",64195:"c4f5d8e4",64209:"d7a48e98",64214:"575f1b1b",64280:"95a35da8",64497:"099f8a1f",64549:"788d9fe0",64925:"7ee339c8",65149:"53e78238",65154:"af35203c",65368:"cc468388",65687:"2f2f8f8f",65787:"c4ae09d4",65818:"ae255275",65957:"e4627c87",66068:"e8bf0c3e",66286:"13d7a585",66345:"42a8d727",66880:"f32d8490",67365:"18f77871",67374:"6279c8a9",67746:"df7ec86c",67813:"8894256f",67861:"0f9cda3e",68207:"7622c6de",68253:"363ba2d8",68349:"3d3a07f6",68503:"f8c92f63",68809:"4090f62b",68970:"eaafcd74",69043:"9ad8637e",69125:"c80ee60a",69572:"8000380e",69753:"7e31db45",69905:"e23eefc0",70332:"39fee459",70633:"b50c9021",70670:"e62aa786",70743:"c7399101",70838:"22bdf908",71347:"e93ff9aa",71600:"397d4a7e",71723:"0328b0c9",71871:"ce32ce4d",71910:"2a3724f5",72379:"9dba6800",72809:"540cb455",73375:"94fe2afe",73464:"3c6391c1",73602:"696ed493",73634:"e0bec19d",73695:"bdb43652",73905:"94b87f57",73918:"4294ceba",74190:"84cf2087",74298:"48db5030",74428:"53d82fc0",74531:"b25d4024",74811:"cf33a5bc",74971:"0ed89c29",75063:"cf69f832",75288:"77de130e",75600:"30fdf4bf",75791:"0667cc8f",75975:"0de52270",76152:"b180b1b1",76428:"418c923e",76434:"40878283",76541:"d67ae496",76549:"7a65c859",77184:"11b4dd89",77811:"18a382cc",77937:"ea313555",77944:"6bc64de5",77999:"3af651bf",78023:"2b20c80a",78099:"ad577885",78315:"9218c1fd",78340:"5f10f6e3",78541:"0abbbb35",78776:"f46c4408",79014:"e77a5489",79054:"722ec584",79061:"4fd81f4e",79376:"6249c7de",79475:"1db45fbc",79480:"7c767e9e",79681:"a1fd7cfe",79923:"77622da5",80053:"935f2afb",80103:"500ab5e8",80369:"a7c6c228",80536:"17c91901",80567:"df36d98d",80808:"b85fa405",81135:"6c43de6e",81447:"df330cef",81451:"563d7403",81981:"c8450cf2",82311:"f965b663",82381:"16127d6f",82672:"71c1d7a6",82708:"d5e6c777",82718:"471f7fbd",82921:"12f49e0c",83100:"da6ad706",83154:"67009ff2",83302:"9622a62d",83398:"9f602629",83416:"d8f590ab",83616:"0d16b667",83701:"ef308d07",83771:"8c02dfd8",84052:"1dc390ba",84099:"38f61187",84249:"8dca2180",84386:"121b1090",84959:"c75d7ff6",84987:"d94bb6b6",85056:"730110a3",85534:"e593aec6",85621:"87b2412c",85836:"bf0b75c4",85897:"6b3775fc",85953:"b700f6c8",86072:"26183636",86139:"9267eb77",86390:"c4cf1261",86529:"cb4175f3",87074:"6268d0ca",87414:"393be207",87593:"50219e10",87655:"40230f21",87677:"750960ca",87824:"4c4c3de8",88831:"3c8da607",89047:"856bceac",89083:"db4f0c5e",89167:"faee50e1",89209:"198290f4",89776:"b7c7e74a",90357:"e0751957",91177:"8ce69432",91569:"5a7e7a34",91759:"ec202e26",92146:"53d93800",92560:"0c337ca4",92903:"84ee34f2",92957:"d5a10f7c",93006:"5be4f4f7",93348:"eb2927ba",93387:"007a6c32",93418:"49dbb45e",93507:"4a6f24a9",93543:"510addcb",94089:"d9ffe17e",94194:"4b3e38af",94276:"d108a77f",94319:"d0816b53",94506:"fd03cc72",94907:"29f28a73",95496:"994f6abf",95662:"caaad1b0",95690:"f4bc196f",96235:"7fc2b4c9",96247:"6ab4df05",96276:"8aadacf1",96361:"3aecebcc",96551:"120d9fdd",97421:"c8a855a5",97482:"4a3e680b",97500:"d63a00cf",97719:"51c3befa",97879:"e9d56634",97920:"1a4e3797",98016:"ffb2e417",98591:"a61cb094",98604:"d0931cd6",98630:"68e9a632",98692:"67044a7a",98948:"65e0cd55",98960:"4ade5613",99070:"02574e0f",99438:"b5511831",99822:"595b2ce9",99889:"f56b8973"}[e]||e)+"."+{42:"8ec5c37a",520:"1e6c946b",783:"2a4dac02",1269:"d12c7197",1286:"c853b0a9",1714:"561048f6",1739:"3d437425",1802:"751ec081",1893:"4a98b5fe",2050:"823155de",2112:"82477c40",2338:"18e6b223",2375:"2c98d1be",2449:"c8c4a269",2528:"17f369fc",2666:"1a51e707",2951:"21706190",3299:"397ec1ec",3300:"5190d89e",3425:"c94bfab8",3522:"cd5009f7",3705:"a8fc058b",4159:"6d060ce6",4387:"c65dc917",4637:"85eb2003",4694:"b5334a0e",4696:"261d15e2",4972:"c1e0c51c",5159:"2218c8e5",5295:"c652c243",5872:"1f80115e",5886:"d9475a2e",6282:"6327de25",6338:"63a0beb9",6473:"60886f6c",6597:"387621a1",6675:"a9f56922",6849:"fdf2e81b",6874:"5a9125b3",7213:"e7617507",7267:"e5c093aa",7383:"e657b235",7828:"eff4cfcc",8025:"739425f2",8179:"d929c0f4",8347:"b4d9ec33",8966:"e04d2290",9022:"9e4d05b5",9113:"9af2d8ee",9300:"261c6639",9532:"5ec3ca5b",9609:"288677fa",9624:"ace35f3d",9799:"51815cbe",9800:"8135d36c",9817:"f9d79ca6",10225:"3d3596d5",10235:"7e46f062",10293:"c888a256",11005:"3b42ce81",11013:"aece890c",11053:"95e56544",11265:"0c81fd6e",11389:"3cc70e96",11396:"97c3687b",11792:"4655b6c9",11908:"9641f6e6",12333:"708f853e",12717:"d6ad61d8",12933:"95fbe59d",13085:"74c4de50",13258:"48b6f14c",13408:"e6044319",13739:"b1b348b9",13959:"22451ad5",13994:"f6412254",14030:"57c1e1f4",14132:"618c5934",14243:"561b594f",14281:"cf8be476",14491:"23ccaa23",14582:"c88568c5",14681:"5b04162a",14731:"6e6937e7",14777:"7c92fb86",14796:"72d3e984",15068:"a911fd6e",15114:"d790a544",15309:"8230c2ac",15361:"43a57641",15365:"4759fbe7",15609:"536132e5",15669:"eb21dd04",16071:"2dc6ee69",16225:"ce0d8a37",16377:"bcac3475",16667:"4487755d",16720:"2d17fe6d",16825:"9319d7a3",17070:"816bc002",17210:"045fe953",17445:"18a650a4",17638:"ca541869",17719:"84fcedca",18104:"7894f548",18287:"e6a54e4f",18772:"12f8bdf4",18894:"2da9821d",19065:"b47a98dd",19178:"96987a51",19270:"25a94c9f",19389:"feb155f7",19715:"44f46d4f",19831:"5f90158e",20048:"463f63d9",20367:"0bb13b15",20844:"0c3e4097",20926:"c03cd929",21004:"036b2b1f",21390:"358990f1",21493:"46447667",22162:"5ebbe176",22399:"80f66527",22761:"365a347a",22982:"4c970639",23003:"e504b4f5",23022:"a4b81923",23389:"8c8835a8",23750:"a459602c",23905:"a6ac1772",24069:"3d8e0c85",24180:"baa2cde2",24804:"cced5827",24851:"70836f6d",24989:"6dac20a5",25329:"0936a0bf",25370:"9fc51795",25374:"6d32276c",25382:"d968e579",25733:"0daca711",25760:"5719a260",25785:"c05878f8",25968:"fab4e438",25969:"c51b573e",26295:"4f220773",26467:"c93b2d2c",26648:"acbaf873",26668:"560b68f2",26912:"acba2158",27044:"20a47715",27133:"b97d9701",27188:"546365fc",27212:"603070bc",27238:"79cef3a2",28135:"5b1476ac",28364:"7f11b9bc",28460:"58ef3bea",28492:"99707b9e",28608:"315c7081",28781:"22102bff",28801:"54787bb9",28848:"78bc233c",29010:"7a57b036",29217:"38f19102",29514:"e4bcc747",29538:"0518905a",29766:"f4debd7e",29770:"a8c9193f",29976:"63adaa26",30561:"1fc90304",30601:"2a5579b9",30701:"8b5b0eb7",30797:"c3f31e84",30882:"3c5ac118",31094:"1d999bf8",31404:"008d83aa",32111:"e4935bce",32197:"f7526dac",32252:"816c7d32",32490:"d0adf848",32755:"798bebd2",33224:"7164f3fa",33240:"726c4a87",33312:"9907b91c",33404:"0efbfadd",33509:"f924244a",33527:"9210a768",33659:"f6432c75",34024:"b023dd19",34288:"1c52efcc",34548:"069d388f",34730:"7421fa7a",35167:"b49fab92",35416:"048c875f",35701:"2f7bace8",35708:"0fe8f81f",35832:"b9826c9c",35943:"409c78ee",36106:"9fef4943",36553:"1d050c36",36554:"f49113cb",36904:"608c4f10",37018:"c6e5914d",37486:"c2082024",37487:"0b43fb28",37710:"b7333728",37896:"aa3c7b74",37950:"c18aeed0",38270:"c1ef53c6",38460:"e88eec46",38704:"54aecbb0",38890:"afa6ad85",38948:"4c0cbf75",38959:"12c42e0b",39127:"8b4cf1c4",39580:"74280f6d",39626:"db9dd9ea",39796:"0f844535",39833:"ddaa316d",40073:"172d8b51",40114:"c7285751",40211:"3df45470",40219:"7603b1f6",40542:"575195b2",40614:"1611c893",40683:"7bdae07a",40701:"25786565",40916:"729db7d8",41003:"36e31dce",41804:"d1aca82e",41877:"1814cb04",41943:"c72a17b4",42069:"0dfe52de",42885:"2be43e41",44120:"8f4578a0",44209:"28c163b6",44758:"0762d9fa",44916:"1bc7c335",45111:"0a16adcc",45167:"3abc174e",46039:"362e0ba9",46215:"08417467",46566:"a5077acb",46739:"a6a1b415",46945:"11021670",46976:"2442f078",47137:"255916c9",47328:"f651ed90",47361:"ce148179",47563:"dddd758f",47615:"835b1cc6",48026:"8cad975d",48081:"23fd8a90",48169:"d5d88ba9",48890:"32c5ddf3",48954:"cdfc2c65",49486:"d0d13f08",49717:"770b3669",49755:"a388e846",50067:"0bdf2d2a",50430:"055e1b9d",50730:"c5d66129",50893:"36df98f6",50932:"5af46298",51106:"daff27bd",51410:"c9fc3c07",51523:"8598a7f5",52474:"bb1fc8da",52486:"635a774e",52574:"472cf42f",52654:"92b816af",52831:"ddac26da",53408:"10f7cff0",53482:"df103e38",53501:"b8181aec",53630:"c92dce0e",54029:"2654235a",54053:"833e68fe",54601:"c7802446",54636:"56e055f1",54801:"433ccde3",54820:"d82b721a",55038:"0efb12f2",55229:"195e46dd",55381:"46ee0f90",55480:"a376413f",56025:"16398596",56319:"74302ebf",56370:"239ad3c7",56382:"3def563d",56886:"cde29d7f",56963:"0c50b8a7",56979:"0ba2abc6",57067:"94292e0b",57152:"af1ad35a",57251:"6b0fd1ad",57287:"23ff262e",57756:"f5aeb441",57979:"72351062",58188:"1fe0b3e6",58235:"2bd52ae5",58353:"622fffee",58663:"57e0701e",59082:"9a996868",59131:"441f24ce",59135:"6f73f94f",59607:"ac987203",59728:"45c9a7a9",59856:"0b84f70e",59865:"deb8694a",59910:"f68f6820",59953:"4166ce32",60298:"5f669764",60310:"e1cf2bf5",61304:"009bd8ba",62062:"08d33ceb",62353:"3b2b9e41",62457:"904e3a57",62860:"d437b595",63447:"3d31efcb",63497:"1909fe74",63851:"c999ace8",64166:"b71eccd0",64195:"07350901",64209:"f5ad69ae",64214:"2cc8e777",64280:"17c1f321",64497:"b04c0ea8",64549:"1a1add38",64925:"e236d4b5",65149:"e68f1374",65154:"fb3eceb4",65368:"5b1c1d58",65687:"c6809b64",65787:"9d309eef",65818:"c592639d",65957:"95afcdf9",66068:"31c4a50e",66286:"bf1549af",66345:"8c235ba0",66880:"fa4535e7",67365:"5330d4b8",67374:"2dfcace3",67746:"73579300",67813:"169c3ef2",67861:"feded733",68207:"90230241",68253:"87f711c9",68349:"3df1974e",68503:"89385e31",68724:"bd00f8e9",68809:"ae6235ee",68970:"486ee1b8",69043:"b88c085a",69125:"c6e399ca",69572:"0037e2de",69753:"9e4ebb05",69905:"5390d20c",70332:"858736ed",70633:"2676ed95",70670:"4647b158",70743:"1bc17e63",70838:"ca8f625c",71347:"b8233b2a",71600:"387e240c",71723:"ee2b5980",71814:"56dd82a2",71871:"0852f5b7",71910:"43fea2d8",72379:"a5deef84",72809:"cf9cae29",73375:"177280a8",73464:"5f9bce6c",73602:"b19c6515",73634:"1d31afcb",73695:"e2b4cac6",73905:"8bd67e5c",73918:"a40b3907",74190:"eb8b4856",74298:"d717c136",74428:"9fbb9bdd",74531:"67a3f108",74811:"ab3f1287",74971:"9f410043",75063:"bc1a14f2",75288:"f71e9af9",75600:"fe5ce8c7",75791:"a8af9e17",75975:"b8709007",76152:"78ae7b11",76428:"be894448",76434:"86d6b0f1",76541:"bf22c3cc",76549:"cb62be0f",76780:"a2521cf6",77184:"5344e158",77811:"806940f9",77937:"2057d3d0",77944:"3b62a8fd",77999:"6003a871",78023:"31dba325",78099:"29723372",78315:"fddd6e0b",78340:"ccf543f6",78541:"1875c215",78776:"cdc83d7f",79014:"c22fd11d",79054:"1befeea2",79061:"ef8259de",79376:"999c093a",79475:"92335dcf",79480:"e7e81336",79681:"2e9a82c3",79923:"24e9dfb4",80053:"44108aeb",80103:"adb45701",80369:"823951a8",80536:"1fc24eda",80567:"fec680eb",80808:"d89117d5",81135:"4c893d97",81447:"6435e97d",81451:"62ffeb28",81981:"aca1e4a5",82311:"3f1a2d90",82381:"faeefc76",82672:"b1911849",82708:"05665a03",82718:"52d0bf25",82921:"9a7337d5",83100:"ff43253e",83154:"b0af7501",83302:"05d57b7e",83398:"506a6916",83416:"7b819fe1",83616:"9d81d0d4",83701:"760e705a",83771:"1c42add4",84052:"b0bd8b53",84099:"de2f4999",84249:"89ad564d",84386:"3cdac849",84959:"77f53787",84987:"74bfc775",85056:"e929ee43",85534:"9bf0046e",85621:"b14f6a91",85836:"f5345df0",85897:"fbdef801",85953:"474bfc80",86072:"b2386542",86139:"3ec102bb",86390:"98cacb7c",86529:"ec82adac",87074:"28692833",87414:"e74de51a",87593:"699b8d97",87655:"664033ae",87677:"baaf40c3",87824:"7eddecc7",88831:"a9e7aed9",89047:"bc17d954",89083:"59f9af31",89167:"5983c73f",89209:"714b0880",89776:"04406d29",90357:"35110dae",91177:"51f8fe7f",91569:"ce93dfb7",91759:"b5658319",92146:"8a7f1067",92560:"de5b412a",92903:"eb94d4d8",92957:"33762a9e",93006:"4305a022",93348:"27f4c48c",93387:"64b4440b",93418:"f73cf098",93507:"a657a544",93543:"3e92aad4",94089:"adfc8b09",94194:"e23dd625",94276:"185d232d",94319:"2bf1ddcc",94506:"3a8a0c30",94907:"8a083c0f",95496:"603eb1ee",95662:"24ecc4ca",95690:"ebf24935",96235:"600ea051",96247:"14850e15",96276:"74c119ca",96361:"7c9a09d0",96551:"807583b8",97421:"2e7bbb6e",97482:"beb13a9b",97500:"1bd487e5",97719:"95bd6f21",97879:"c92ac662",97920:"d5457aa2",98016:"d08720e9",98591:"418e99dd",98604:"5372b027",98630:"7607f8c9",98692:"f146280e",98948:"75dc840b",98960:"2d71c0d5",99070:"6d90e6e1",99438:"6c99546d",99822:"8bf2a709",99889:"d667b6bf"}[e]+".js",t.miniCssF=e=>{},t.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),t.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),d={},b="docusaurus-docs:",t.l=(e,a,c,f)=>{if(d[e])d[e].push(a);else{var r,o;if(void 0!==c)for(var n=document.getElementsByTagName("script"),i=0;i{r.onerror=r.onload=null,clearTimeout(l);var b=d[e];if(delete d[e],r.parentNode&&r.parentNode.removeChild(r),b&&b.forEach((e=>e(c))),a)return a(c)},l=setTimeout(s.bind(null,void 0,{type:"timeout",target:r}),12e4);r.onerror=s.bind(null,r.onerror),r.onload=s.bind(null,r.onload),o&&document.head.appendChild(r)}},t.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.nmd=e=>(e.paths=[],e.children||(e.children=[]),e),t.p="/docs/",t.gca=function(e){return e={26183636:"86072",40878283:"76434",44177285:"6597",65246720:"19065",68079445:"9532",78950515:"4387",79022373:"21493",82405689:"18287",84002310:"783","2518c83b":"42",fb1a77b4:"520","9e31950e":"1269",f5bce583:"1286","6c068fb7":"1714","510acf22":"1739","96368f4f":"1802","4c5e977b":"1893",f54e89d1:"2050","5e4fe134":"2112","5b157bd1":"2338","1c94925b":"2375","3e99551e":"2449","5b292b69":"2528","09c26509":"2666","9bb13d2e":"2951","7e3ea763":"3299","655c39d2":"3300","602542a3":"3425",abf6ee25:"3522",b3a5153e:"3705",b9acd066:"4159",b65b34ba:"4637","98dc0d0e":"4694","9569bc2f":"4696","9d6ed550":"5159","5bcf38c1":"5295","587e3d47":"5872","31d96af4":"5886",cd8b4f9a:"6282",a83fc124:"6473","036e14f3":"6675","548bc066":"6849","8b221193":"6874",f93f119a:"7213",c9713a6d:"7267","225c9eb6":"7383",f72af8b9:"7828",b42f8477:"8025","136658e4":"8179","8b988d57":"8347","16ef1cd9":"8966","29b0efd4":"9022","84ab2fd1":"9113","903944d2":"9300","8e84b0d9":"9609","3042b185":"9624","9ff509e1":"9800","14eb3368":"9817","883bb60a":"10225",a7d19085:"10235",fa570740:"10293",c127b609:"11005",e8acd80e:"11013","7205acf7":"11053",f6106990:"11265",a005ddbc:"11389",e3e28d8f:"11396","855341b1":"11792",f9fe6464:"11908","650716b7":"12333","0b0bc04d":"12717",b6036b82:"12933","1f391b9e":"13085",b5961036:"13258",fdf22a50:"13408","5e33bc00":"13739","2d0f081e":"13959",b2ae77a0:"13994",c5d3bb95:"14030",b6eadb9e:"14132","0744e06b":"14243","30bb4662":"14281","1fefa037":"14491",fed448c0:"14582","1be75057":"14681","64e1104a":"14731","269ec971":"14777",a41d5bc2:"14796",e4440f9d:"15068",ee7f03d8:"15114","57f8207f":"15309","4d2ad36f":"15361",b82d00b2:"15365","060b1584":"15609","5220550c":"15669","094a53a9":"16071",d02b6e20:"16225","07ffdee5":"16377",f81ec24e:"16667","4ac45b89":"16720","5621bfd0":"16825",c78b1140:"17070",daa5df1a:"17210","1a299676":"17445",e165cecb:"17638","6623a699":"17719","7ab943be":"18104",c83cf481:"18772","3956460a":"19178",cba951d8:"19270","2a8d8e88":"19389","2cfd0fc8":"19715","4e7e2ca5":"19831","441ee7d2":"20048","05a3c259":"20367","4e1901bc":"20844","05bb3e6b":"20926",bc0c7228:"21004",a6905832:"21390","31593e16":"22162","0d34b62b":"22399",f041af6f:"22982","34fadc99":"23003",e0a5c1d2:"23022","9041aea1":"23389",c77ce8fa:"23750",d288e937:"23905","41ce3377":"24069","83b28724":"24180","440f78e7":"24804",a592f1e4:"24851","0f2dc4ca":"24989","4eca193c":"25329",af4a2ad4:"25370","980085d9":"25374","632d2515":"25382","735936a9":"25733","31e78686":"25760","20f55e05":"25785","156751cf":"25968","07ca0209":"25969","67f94a41":"26295","302d24dc":"26467","0157939d":"26648",b9fa1d17:"26668","197a4930":"26912","89e5bdec":"27044","92e99bf6":"27133","5036ec9d":"27188",e6cbd2ed:"27212",e298e99e:"27238","89179ad6":"28135","069e89fb":"28364",dd3ced3a:"28460","9931c5c6":"28492","0cadbdb9":"28608","7e458d36":"28781","6dfc2f3d":"28801","99d44459":"28848","8c2621f5":"29010","547b19b8":"29217","1be78505":"29514","4c950052":"29538","5bf23af0":"29766","06b60cb4":"29770",f512b2b1:"29976",bc670d5c:"30561",e5d84bc0:"30601","21fa7ce5":"30701","80238aff":"30797",aedc496a:"30882","8675103a":"31094","3e301362":"31404","74db685e":"32111",eb357560:"32197",eef51a73:"32252","1eaa7a2a":"32490","7e04e77d":"32755","1bd0c971":"33224","0ab53148":"33240","8cd2105d":"33312",afdda5b6:"33404","786f71e5":"33509",a5e760bc:"33527","0e5cbc44":"33659","99f24057":"34024",af1ac92b:"34288","1a8c488b":"34548",f4b2f868:"34730","6c74a4d7":"35167",cc68b255:"35416",d02347dc:"35701","41eb0037":"35708",b745f339:"35832",bc53881b:"35943",c2ebbb3e:"36106","18a5e8d6":"36553","9d979a6d":"36554","637cfff4":"36904","01464744":"37018",dcc6b54d:"37486",a9bf2227:"37487",c11bd48d:"37710","83cc66ac":"37896","8825024b":"37950","5393ce94":"38270",c2d32f88:"38460","8338c5ef":"38704",c084c2e9:"38890",bc8bd5d6:"38948","1eb543d3":"38959",a230a772:"39127","75ecb4f9":"39580",fd867f7c:"39626","3e9399ec":"39796","26987f39":"39833","359a0a8d":"40073","8740ec05":"40114",eb907bb2:"40211","49e3720f":"40219","41790d5d":"40542","716600a7":"40614","0abae2e0":"40683","1ce0a301":"40701",e4459066:"40916",d0d62bb5:"41003",ee640683:"41804","717e7ee6":"41877","62029e95":"41943","9a6be05d":"42069",acdbee8e:"42885",a61ed651:"44120","278665dc":"44209","0a13a0e4":"44758","95d5a544":"44916",cb819e9b:"45111",da88d543:"45167","778f38dc":"46039","784585a8":"46215","763e4dec":"46566","2dd5aaa1":"46739","70b01d77":"46976","47f09a6b":"47137","6daf901a":"47328","7a5188cd":"47361","146da2b4":"47563","84ebbbbf":"47615",a120aaca:"48026","5dce62fd":"48081",e4492fa7:"48169",d5603669:"48890",b0bdb7f3:"48954",e72cf26a:"49486",a5962d55:"49717",c123803f:"49755","246367e0":"50067","867911a0":"50430","4b1cba20":"50730","965dbb95":"50893","485af29a":"50932",dd813bf5:"51106",bd1a9377:"51410",a3761f7f:"51523","4507e508":"52474",de127d6b:"52486",e2668db3:"52574",f024ddd5:"52654","5ec88f12":"52831","4694df8d":"53408",a718913e:"53482","7795e3fe":"53501",dd02e78e:"53630",e286ec4c:"54029","24e3585b":"54053",c552c222:"54601","760e3208":"54636","3ec68450":"54801","05a18904":"54820","100f3054":"55038","2fcfad90":"55229",cfc9c16e:"55381","006095b2":"55480",c3aed80f:"56025","879063fc":"56319","36f93d19":"56370","9ffa1a6c":"56382","4b7a6889":"56886","1b80e345":"56963",d005934a:"56979",eece046c:"57067",e09bff2e:"57152",eb1718b4:"57251",bde9fb45:"57287","6ab4408e":"57756",c5059afe:"57979",e73e328f:"58188","3bdeaa89":"58235","162f137e":"58353",c7dcc258:"58663","6a9a7317":"59082","3b0223df":"59131",e27b8251:"59135","25f376d4":"59607",aa5bd2a7:"59728",e5c88a3e:"59856",e8ee0390:"59865","16142a34":"59910","2041170f":"59953",d4e7ac8a:"60298","5913a508":"60310","8d5fe6f9":"61304","988ba51e":"62062","35d50d77":"62353","30e5c1aa":"62457","3d49fc0e":"62860","1c5b9066":"63447",b8541bfd:"63497","51b69e86":"63851",c54a5582:"64166",c4f5d8e4:"64195",d7a48e98:"64209","575f1b1b":"64214","95a35da8":"64280","099f8a1f":"64497","788d9fe0":"64549","7ee339c8":"64925","53e78238":"65149",af35203c:"65154",cc468388:"65368","2f2f8f8f":"65687",c4ae09d4:"65787",ae255275:"65818",e4627c87:"65957",e8bf0c3e:"66068","13d7a585":"66286","42a8d727":"66345",f32d8490:"66880","18f77871":"67365","6279c8a9":"67374",df7ec86c:"67746","8894256f":"67813","0f9cda3e":"67861","7622c6de":"68207","363ba2d8":"68253","3d3a07f6":"68349",f8c92f63:"68503","4090f62b":"68809",eaafcd74:"68970","9ad8637e":"69043",c80ee60a:"69125","8000380e":"69572","7e31db45":"69753",e23eefc0:"69905","39fee459":"70332",b50c9021:"70633",e62aa786:"70670",c7399101:"70743","22bdf908":"70838",e93ff9aa:"71347","397d4a7e":"71600","0328b0c9":"71723",ce32ce4d:"71871","2a3724f5":"71910","9dba6800":"72379","540cb455":"72809","94fe2afe":"73375","3c6391c1":"73464","696ed493":"73602",e0bec19d:"73634",bdb43652:"73695","94b87f57":"73905","4294ceba":"73918","84cf2087":"74190","48db5030":"74298","53d82fc0":"74428",b25d4024:"74531",cf33a5bc:"74811","0ed89c29":"74971",cf69f832:"75063","77de130e":"75288","30fdf4bf":"75600","0667cc8f":"75791","0de52270":"75975",b180b1b1:"76152","418c923e":"76428",d67ae496:"76541","7a65c859":"76549","11b4dd89":"77184","18a382cc":"77811",ea313555:"77937","6bc64de5":"77944","3af651bf":"77999","2b20c80a":"78023",ad577885:"78099","9218c1fd":"78315","5f10f6e3":"78340","0abbbb35":"78541",f46c4408:"78776",e77a5489:"79014","722ec584":"79054","4fd81f4e":"79061","6249c7de":"79376","1db45fbc":"79475","7c767e9e":"79480",a1fd7cfe:"79681","77622da5":"79923","935f2afb":"80053","500ab5e8":"80103",a7c6c228:"80369","17c91901":"80536",df36d98d:"80567",b85fa405:"80808","6c43de6e":"81135",df330cef:"81447","563d7403":"81451",c8450cf2:"81981",f965b663:"82311","16127d6f":"82381","71c1d7a6":"82672",d5e6c777:"82708","471f7fbd":"82718","12f49e0c":"82921",da6ad706:"83100","67009ff2":"83154","9622a62d":"83302","9f602629":"83398",d8f590ab:"83416","0d16b667":"83616",ef308d07:"83701","8c02dfd8":"83771","1dc390ba":"84052","38f61187":"84099","8dca2180":"84249","121b1090":"84386",c75d7ff6:"84959",d94bb6b6:"84987","730110a3":"85056",e593aec6:"85534","87b2412c":"85621",bf0b75c4:"85836","6b3775fc":"85897",b700f6c8:"85953","9267eb77":"86139",c4cf1261:"86390",cb4175f3:"86529","6268d0ca":"87074","393be207":"87414","50219e10":"87593","40230f21":"87655","750960ca":"87677","4c4c3de8":"87824","3c8da607":"88831","856bceac":"89047",db4f0c5e:"89083",faee50e1:"89167","198290f4":"89209",b7c7e74a:"89776",e0751957:"90357","8ce69432":"91177","5a7e7a34":"91569",ec202e26:"91759","53d93800":"92146","0c337ca4":"92560","84ee34f2":"92903",d5a10f7c:"92957","5be4f4f7":"93006",eb2927ba:"93348","007a6c32":"93387","49dbb45e":"93418","4a6f24a9":"93507","510addcb":"93543",d9ffe17e:"94089","4b3e38af":"94194",d108a77f:"94276",d0816b53:"94319",fd03cc72:"94506","29f28a73":"94907","994f6abf":"95496",caaad1b0:"95662",f4bc196f:"95690","7fc2b4c9":"96235","6ab4df05":"96247","8aadacf1":"96276","3aecebcc":"96361","120d9fdd":"96551",c8a855a5:"97421","4a3e680b":"97482",d63a00cf:"97500","51c3befa":"97719",e9d56634:"97879","1a4e3797":"97920",ffb2e417:"98016",a61cb094:"98591",d0931cd6:"98604","68e9a632":"98630","67044a7a":"98692","65e0cd55":"98948","4ade5613":"98960","02574e0f":"99070",b5511831:"99438","595b2ce9":"99822",f56b8973:"99889"}[e]||e,t.p+t.u(e)},(()=>{var e={51303:0,40532:0};t.f.j=(a,c)=>{var d=t.o(e,a)?e[a]:void 0;if(0!==d)if(d)c.push(d[2]);else if(/^(40532|51303)$/.test(a))e[a]=0;else{var b=new Promise(((c,b)=>d=e[a]=[c,b]));c.push(d[2]=b);var f=t.p+t.u(a),r=new Error;t.l(f,(c=>{if(t.o(e,a)&&(0!==(d=e[a])&&(e[a]=void 0),d)){var b=c&&("load"===c.type?"missing":c.type),f=c&&c.target&&c.target.src;r.message="Loading chunk "+a+" failed.\n("+b+": "+f+")",r.name="ChunkLoadError",r.type=b,r.request=f,d[1](r)}}),"chunk-"+a,a)}},t.O.j=a=>0===e[a];var a=(a,c)=>{var d,b,f=c[0],r=c[1],o=c[2],n=0;if(f.some((a=>0!==e[a]))){for(d in r)t.o(r,d)&&(t.m[d]=r[d]);if(o)var i=o(t)}for(a&&a(c);n Derivatives Guides | Bybit API Documentation - +

    Derivatives Guides

    Let's learn about derivatives concepts!

    - + \ No newline at end of file diff --git a/category/spot.html b/category/spot.html index a7f463569f..f174a49842 100644 --- a/category/spot.html +++ b/category/spot.html @@ -4,13 +4,13 @@ Spot Guides | Bybit API Documentation - +

    Spot Guides

    Let's learn about spot concepts!

    - + \ No newline at end of file diff --git a/changelog/asset-v3.html b/changelog/asset-v3.html index 68818a7c56..08539157a8 100644 --- a/changelog/asset-v3.html +++ b/changelog/asset-v3.html @@ -4,13 +4,13 @@ Account Asset V3 | Bybit API Documentation - +

    Account Asset V3

    2024-05-09​

    REST API​

    • Withdraw [UPDATE]

      • Add request parameter beneficiary, vaspEntityId, beneficiaryName, they are only used for kyc=KOR (Korean users) to fill travel rule info

    • Get Exchange Entity List [NEW]

      • Add a new API for kyc=KOR users to query target exchange info when fill travel rule info

    • Create Internal Transfer [UPDATE]

      • Add new response field status. When you get "PENDING", please call query API to check the final status after a while

    • Create Universal Transfer [UPDATE]

      • Add new response field status. When you get "PENDING", please call query API to check the final status after a while

    2024-04-23​

    REST API​

    2024-03-22​

    REST API​

    2024-02-28​

    REST API​

    2023-11-14​

    REST API​

    • Withdraw [UPDATE]
      • The rate limit is changed from 10 req/min to 1 req/s

    2023-09-18​

    REST API​

    • Create Sub UID API Key [UPDATE]
      • Request parameter ips is actually string type. array can be used, but string is more explicit
      • Request parameter Derivatives has been depreciated due to auto identification by system
    • Modify Master API Key [UPDATE]
      • Request parameter ips is actually string type. array can be used, but string is more explicit
      • Request parameter Derivatives has been depreciated due to auto identification by system
    • Modify Sub API Key [UPDATE]
      • Add a new request param apikey, which can be used for Master account to manage sub account api key
      • Request parameter ips is actually string type. array can be used, but string is more explicit
      • Request parameter Derivatives has been depreciated due to auto identification by system
    • Delete Sub API Key [UPDATE]
      • Add a new request param apikey, which can be used for Master account to delete sub account api key

    2023-08-31​

    REST API​

    • Get Deposit Records (on chain) [UPDATE]
      • Add a new response field depositType. You can process deposit assets in the web when the deposit has daily deposit limit or abnormal deposit issue.
    • Get Sub Deposit Records (on chain) [UPDATE]
      • Add a new response field depositType. You can process deposit assets in the web when the deposit has daily deposit limit or abnormal deposit issue.

    2023-08-30​

    REST API​

    2023-08-17​

    REST API​

    2023-08-07​

    REST API​

    • Enable Universal Transfer [DEPRECIATE]
      • Depreciated endpoint. No need to configure this, all sub uids support universal transfer by default

    2023-07-24​

    REST API​

    • Get Single Coin Balance [UPDATE]
      • Add new request param: toAccountType, toMemberId, withLtvTransferSafeAmount
      • Add new response field: ltvTransferSafeAmount

    2023-06-15​

    REST API​

    2023-06-06​

    REST API​

    • Withdraw [UPDATE]
      • Add new request param feeType, which is used to select the withdrawal fee operation type when withdraw

    2023-03-23​

    REST API​

    2023-03-15​

    REST API​

    • Get Single Coin Balance [UPDATE]
      • Add a new request param withTransferSafeAmount and a new response field transferSafeAmount

    2023-02-28​

    REST API​

    2023-02-20​

    REST API​

    2023-02-14​

    REST API​

    • Withdraw [UPDATE]
      • Select the wallet to be withdrawn from
      • The default withdrawn wallet is Spot wallet
    Req paramRequiredTypeComments
    accountTypefalsestringSelect the wallet to be withdrawn from
    • SPOT：spot wallet (default)
    • FUND：Funding wallet

    2023-02-09​

    REST API​

    2023-02-06​

    REST API​

    - + \ No newline at end of file diff --git a/changelog/copytrade.html b/changelog/copytrade.html index 3f1a1f474e..e6a2555dbe 100644 --- a/changelog/copytrade.html +++ b/changelog/copytrade.html @@ -4,13 +4,13 @@ Copy Trading | Bybit API Documentation - +

    Copy Trading

    2023-06-24​

    REST API​

    • Bybit starts to release a fully new copy trading on 24th June 2023. It is released gradually by end digit of uid. You can select to upgrade to new copy trading when you are applicable. Once upgraded, please note below points:
      • You will be allocated a new sub account, which has USDT Perpetual copy trading ability
      • Create a new api key for that sub account, and grant it "Contract" permissions.
      • You are no longer permitted to use Copy Trade V3 API. Alternatively, you can go to Contract V3 or V5 to trade, and V5 API is recommended.

    2023-03-23​

    REST API​

    2023-03-15​

    REST API​

    - + \ No newline at end of file diff --git a/changelog/derivatives-v3.html b/changelog/derivatives-v3.html index 79f6e7bc4f..fdf26974cc 100644 --- a/changelog/derivatives-v3.html +++ b/changelog/derivatives-v3.html @@ -4,13 +4,13 @@ Derivatives V3 | Bybit API Documentation - +

    Derivatives V3

    2024-05-09​

    REST API​

    • Risk Limit [UPDATE]
      • When query category="linear", API returns 30 symbols data set each request, please add request parameter cursor paginate
      • Add new response parameter nextPageCursor

    2024-04-11​

    REST API​

    2024-03-12​

    REST API​

    • Set Risk Limit [DEPRECIATE]
      • Since auto risk limit has been launched, it is meaningless to use this API

    2024-03-04​

    REST API​

    Websocket API​

    • Public Trade
      • Add new stream fields for Option only. mP, iP, mIv, iv

    2023-11-09​

    REST API​

    • Get Execution List [UPDATE]

      • Add the time range limitation for startTime and endTime request params

    • Get Closed PnL [UPDATE]

      • Add the time range limitation for startTime and endTime request params
      • data is sort by updatedTime

    2023-10-25​

    REST API​

    Websocket API​

    • Position [UPDATE]
      • Add response field isReduceOnly, mmrSysUpdatedTime, leverageSysUpdatedTime

    2023-09-28​

    REST API​

    2023-08-11​

    REST API​

    • Wallet Balance
      • availableToBorrow always returns "" because main-sub uids share borrow quota

    WebSocket API​

    • Wallet
      • availableToBorrow always returns "" because main-sub uids share borrow quota

    2023-07-31​

    REST API​

    WebSocket API​

    2023-07-13​

    REST API​

    2023-05-23​

    REST API​

    • Place Order [UPDATE]
      • Add new request params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType
    • Replace Order [UPDATE]
      • Add new request params for new TP/SL tpLimitPrice, slLimitPrice
    • Get Open Orders [UPDATE]
      • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice
    • Get Order List [UPDATE]
      • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice
    • My Position [UPDATE]
      • tpSlMode in the position is depreciated
    • Set Trading Stop [UPDATE]
      • Add new request params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType

    WebSocket API​

    • Position
      • tpSlMode in the position is depreciated
    • Order [UPDATE]
      • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice

    2023-05-10​

    REST API​

    Old error codeNew error codeMsg
    10001140071RiskId is not modified

    2023-04-20​

    REST API​

    • Account Info [UPDATE]
      • add new response fields dcpStatus, timeWindow, smpGroup
    • Place Order [UPDATE]
      • add new request param smpType used to select SMP execution type
    • Get Open Orders [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new enum cancelBySmp of cancelType
    • Get Order List [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new enum cancelBySmp of cancelType

    WebSocket API​

    • Order [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new enum cancelBySmp of cancelType

    2023-04-12​

    REST API​

    • My Position [UPDATE]
      • add response param adlRankIndicator

    WebSocket API​

    • Position [UPDATE]
      • add response param adlRankIndicator

    2023-03-08​

    REST API​

    • Risk Limit [UPDATE]
      • remove useless response field section

    2023-03-03​

    REST API​

    • Ticker Info [UPDATE]
      • A new response field openInterestValue is added for Futures
    • Open Interest [UPDATE]
      • cursor & nextPageCursor are added to support pagination

    2023-02-28​

    REST API​

    • IP Rate Limit [UPDATE]
      • Due to the switch to CloudFront, the IP limit rules have been adjusted appropriately

    2023-02-20​

    WebSocket API​

    • Execution [UPDATE]
      • Add new fields: blockTradeId, markPrice

    2023-02-09​

    REST API​

    WebSocket API​

    • Order [UPDATE]
      • Add new fields: avgPrice, blockTradeId, cancelType, cumExecFee, leavesValue, positionIdx, rejectReason

    2023-01-19​

    REST API​

    • Set Margin Mode
      • Portfolio margin mode supports USDT Perpetual
    • Get Open Orders
      • For portfolio margin mode, orderIM returns ""
    • Get Order List
      • For portfolio margin mode, orderIM returns ""
    • My Position
      • For portfolio margin mode, positionIM, positionMM, leverage returns "", riskId returns 0
    • Wallet Balance
      • For portfolio margin mode, totalOrderIM, totalPositionIM, totoalPositionMM returns ""

    WebSocket API​

    • Position
      • For portfolio margin mode, positionIM, positionMM, leverage returns "", riskId returns 0
    • Order
      • For portfolio margin mode, orderIM returns ""
    • Wallet
      • For portfolio margin mode, totalOrderIM, totalPositionIM, totoalPositionMM returns ""

    2023-01-16​

    WebSocket API​

    • Orderbook
      • Add 500 level depth, push frequency is 100ms

    2023-01-09​

    WebSocket API​

    • Tickers
      • nextFundingTime has been changed from dataTime 2023-01-05T08:00:00Z to timestamp (ms) 1672905600000
      • predicatedFundingRate has been removed from stream
    - + \ No newline at end of file diff --git a/changelog/spot-v3.html b/changelog/spot-v3.html index f8e15d8709..60970d7f8f 100644 --- a/changelog/spot-v3.html +++ b/changelog/spot-v3.html @@ -4,13 +4,13 @@ Spot V3 | Bybit API Documentation - +

    Spot V3

    2023-04-20​

    REST API​

    • Place Order [UPDATE]
      • add new request param smpType used to select SMP execution type
      • add new response param smpType
    • Open Orders [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new response field cancelType, the enum value is CancelBySmp and UNKNOWN
    • Get Order [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new response field cancelType, the enum value is CancelBySmp and UNKNOWN
    • Order History [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new response field cancelType, the enum value is CancelBySmp and UNKNOWN

    WebSocket API​

    • Order [UPDATE]
      • add new response fields st, sg, so
      • add new response field ct, the enum value is CancelBySmp and UNKNOWN

    2023-04-12​

    REST API​

    WebSocket API​

    • Order [UPDATE]
      • add response field b, which indicates "blockTradeId"
    • Execution [UPDATE]
      • add response field b, which indicates "blockTradeId"

    2023-03-13​

    WebSocket API​

    • Stop Order [UPDATE]
      • add new response field triggerPrice tp

    2023-03-09​

    REST API​

    2023-02-28​

    REST API​

    • IP Rate Limit
      • due to the switch to CloudFront, the IP limit rules have been adjusted appropriately
    • Public Trading Records
      • type field in the response to tell if it is a paradigm trade

    2023-01-16​

    WebSocket API​

    • Tickers
      • xp has been added to stream. It means USD index price, which can be empty.
    - + \ No newline at end of file diff --git a/changelog/v5.html b/changelog/v5.html index acedb38b72..edcf4e8bd1 100644 --- a/changelog/v5.html +++ b/changelog/v5.html @@ -4,7 +4,7 @@ V5 | Bybit API Documentation - + @@ -14,7 +14,7 @@ USDTPerpetualLeverage, symbol, leverage, USDCContractLeverage
  • Get Loan Orders
    • Add new Response fields: USDTPerpetualOpenLine, USDCContractOpenLine, USDCOptionsOpenLine, USDTPerpetualCloseLine, USDCContractCloseLine, USDCOptionsCloseLine, USDCContractSymbols, USDCOptionsSymbols, marginLeverage, USDTPerpetualLeverage, symbol, leverage, USDCContractLeverage
  • Get Single Coin Balance
    • Add new request param: toAccountType, toMemberId, withLtvTransferSafeAmount
    • Add new response field: ltvTransferSafeAmount
  • Add error codes for UTA with OTC loan when trade Spot, Futures and Option
    • New error codeDescription
    30133USDT Perp: When the trading pair is not in the whitelist
    30134USDC Contract: When the trading pair is not in the whitelist
    30135USDT Perp: When you try to change a leverage higher than the maximum leverage in OTC loan
    30136USDC Contract: When you try to change a leverage higher than the maximum leverage in OTC loan
    3200316Option: restrict to trade
    3200317Option: restrict to buy
    170709Spot: When the trading pair is not in the whitelist
    170215Spot: restrict to buy
    170216Spot: margin leverage exceeded
    170220Spot: restrict to trade

    2023-07-13​

    REST API​

    2023-07-04​

    REST API​

    2023-06-26​

    WebSocket API​

    • Orderbook [Spot]
      • Improve the push frequency from 100ms to 20ms of level 50

    2023-06-24​

    REST API​

    • Get Instruments Info [UPDATE]
      • When category=linear, add a new response params copyTrading to indicate this trading pair supporting copy trade or not for UTA and normal account

    2023-06-15​

    REST API​

    2023-06-14​

    REST API​

    2023-06-08​

    REST API​

    • Get Fee Rate [UPDATE]
      • Support to get USDC perp & USDC futures trading fee rate

    2023-06-07​

    REST API​

    • Withdraw [UPDATE]
      • Add new request param feeType, which is used to select the withdrawal fee operation type when withdraw

    2023-06-02​

    REST API​

    • Get Affiliate User Info [New]
      • A brand new endpoint, which is used for affiliate to check the basic information of their users

    2023-06-01​

    REST API​

    • Set Margin Mode [UPDATE]
      • UTA account supports isolated margin, a new enum ISOLATED_MARGIN for request param "setMarginMode"
    • Switch Position Mode [UPDATE]
      • UTA account supports Hedge mode for USDT Perp when it is isolated margin or cross margin mode
    • Get Position Info [UPDATE]
      • Add new response field positionBalance
    • Get Account Info [UPDATE]
      • "marginTrade" field has a new enum value - ISOLATED_MARGIN
    • Set Auto Add Margin [UPDATE]
      • add category enum linear for UTA
    • Add Or Reduce Margin [UPDATE]
      • A brand new endpoint is used to add or reduce specific margin you want

    WebSocket API​

    • Position [UPDATE]
      • Add new response param positionBalance

    2023-05-30​

    REST API​

    • Get Instruments Info [UPDATE]
      • When category=spot, add a new response params marginTrading to indicate this trading pair supporting margin trade or not for UTA and normal account

    2023-05-23​

    REST API​

    • Place Order [UPDATE]
      • Add new request params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType
    • Amend Order [UPDATE]
      • Add new request params for new TP/SL tpLimitPrice, slLimitPrice
    • Get Open Orders [UPDATE]
      • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice
    • Get Order History [UPDATE]
      • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice
    • Get Position Info [UPDATE]
      • tpslMode in the position is depreciated
    • Set Trading Stop [UPDATE]
      • Add new request params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType

    WebSocket API​

    • Position [UPDATE]
      • tpslMode in the position is depreciated
    • Order [UPDATE]
      • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice

    2023-05-10​

    REST API​

    Old error codeNew error codeMsg
    10001110075RiskId is not modified

    2023-05-05​

    REST API​

    2023-05-04​

    REST API​

    • Get Trade History [UPDATE]
      • symbol is no longer mandatory for normal account when get derivatives
    • Get Closed PnL [UPDATE]
      • symbol is no longer mandatory for normal account when get derivatives

    2023-04-20​

    REST API​

    • Place Order [UPDATE]
      • add new request param smpType used to select SMP execution type
    • Get Open Orders [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new enum cancelBySmp of cancelType
    • Get Order History [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new enum cancelBySmp of cancelType
    • Get Account Info [UPDATE]
      • add new response fields dcpStatus, timeWindow, smpGroup

    WebSocket API​

    • Order [UPDATE]
      • add new response fields smpType, smpOrderId, smpGroup
      • add new enum cancelBySmp of cancelType

    2023-04-06​

    REST API​

    2023-04-04​

    REST API​

    • Get Instruments Info [UPDATE]
      • add request param startTime endTime, effective for UTA mode
      • add response param placeType, used for option

    2023-04-04​

    REST API​

    WebSocket API​

    • Position [UPDATE]
      • add response param adlRankIndicator
      • category field is added to UTA stream
    • Order [UPDATE]
      • add response param placeType, used for option
    • Execution [UPDATE]
      • add response param closedSize

    2023-03-24​

    REST API​

    2023-03-23​

    REST API​

    WebSocket API​

    • Wallet [UPDATE]
      • Add a new response field accountLTV

    2023-03-22​

    REST API​

    2023-03-15​

    REST API​

    • Get Single Coin Balance [UPDATE]
      • Add a new request param withTransferSafeAmount and a new response field transferSafeAmount

    2023-03-10​

    REST API​

    • Get Instruments Info [UPDATE]
      • Unify the enums of status for Spot, Derivatives and Options. Use Trading, Closed, Settling, PreLaunch, Deliverying
      • Remove duplicate category field in the Options response
    • Get Fee Rate [UPDATE]
      • Support to get Options trading fee rate

    2023-03-09​

    REST API​

    • Set Leverage [UPDATE]
      • UTA user can set up to 10X for margin trade
    • Get Wallet Balance [UPDATE]
      • Before adjustment: normal account gets error code and message when call accountType=UNIFIED.
        After adjustment: normal account gets http code 400 when call accountType=UNIFIED

    2023-02-28​

    REST API​

    WebSocket API​

    • Wallet [UPDATE]
      • Add a new field bonus

    2023-02-20​

    REST API​

    2023-02-15​

    REST API​

    • User [NEW]
      • Add a set of user & api key related endpoints for V5

    2023-02-14​

    REST API​

    • Get Fee Rate (Derivatives) [NEW]
      • Get the trading fee rate for derivatives
    • Withdraw [UPDATE]
      • Select the wallet to be withdrawn from
      • The default withdrawn wallet is Spot wallet
    Req paramRequiredTypeComments
    accountTypefalsestringSelect the wallet to be withdrawn from
    • SPOT：spot wallet (default)
    • FUND：Funding wallet

    2023-02-09​

    REST API​

    2023-01-19​

    REST API​

    • Set Margin Mode [UPDATE]
      • Portfolio margin mode supports USDT Perpetual
    • Get Position Info [UPDATE]
      • For portfolio margin mode, positionIM, positionMM, leverage, riskLimitValue returns "", riskId returns 0
    • Get Wallet Balance [UPDATE]
      • For portfolio margin mode, totalOrderIM, totalPositionIM, totoalPositionMM returns ""

    WebSocket API​

    • Position [UPDATE]
      • For portfolio margin mode, positionIM, positionMM, leverage, riskLimitValue returns "", riskId returns 0
    • Wallet [UPDATE]
      • For portfolio margin mode, totalOrderIM, totalPositionIM, totoalPositionMM returns ""

    2023-01-16​

    REST API​

    • Get Tickers [spot]
      • usdIndexPrice has been added to response. It means USD index price, which can be empty.

    WebSocket API​

    • Tickers [spot]
      • usdIndexPrice has been added to stream. It means USD index price, which can be empty.
    • Orderbook [linear contract & inverse contract]
      • Add 500 level depth, push frequency is 100ms

    2023-01-09​

    WebSocket API​

    • Tickers [linear contract & inverse contract]
      • nextFundingTime has been changed from dataTime 2023-01-05T08:00:00Z to timestamp (ms) 1672905600000
      • predicatedFundingRate has been removed from stream
    - + \ No newline at end of file diff --git a/copy-trade/account/transfer-list.html b/copy-trade/account/transfer-list.html index 2e005a348b..13da7a595a 100644 --- a/copy-trade/account/transfer-list.html +++ b/copy-trade/account/transfer-list.html @@ -4,13 +4,13 @@ Get Transfer History | Bybit API Documentation - +

    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
    }
    - + \ No newline at end of file diff --git a/copy-trade/account/transfer.html b/copy-trade/account/transfer.html index 7f95d9d400..2dba0ece62 100644 --- a/copy-trade/account/transfer.html +++ b/copy-trade/account/transfer.html @@ -4,13 +4,13 @@ Transfer | Bybit API Documentation - +

    Transfer

    Transfer

    HTTP Request​

    POST /contract/v3/private/copytrading/wallet/transfer

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdtruestringUUID, which is unique across the platform
    cointruestringCurrency. USDT only
    amounttruestringExchange to amount
    fromAccountTypetruestringAccount type
    toAccountTypetruestringAccount type

    Response Parameters​

    ParameterTypeComments
    transferIdstringUUID, which is unique across the platform

    Request Example​

    POST /contract/v3/private/copytrading/wallet/transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673257786588
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 173

    {
        "transferId": "5f95de08-b10f-43be-9746-7b95c4a37d307",
        "coin": "USDT",
        "amount": "500",
        "fromAccountType": "UNIFIED",
        "toAccountType": "COPYTRADING"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "transferId": "5f95de08-b10f-43be-9746-7b95c4a37d307"
        },
        "retExtInfo": {},
        "time": 1673258002526
    }
    - + \ No newline at end of file diff --git a/copy-trade/account/wallet.html b/copy-trade/account/wallet.html index 4f04070f08..dcd3c60020 100644 --- a/copy-trade/account/wallet.html +++ b/copy-trade/account/wallet.html @@ -4,13 +4,13 @@ Get Wallet Balance | Bybit API Documentation - +

    Get Wallet Balance

    Get CopyTrading Wallet Balance

    HTTP Request​

    GET /contract/v3/private/copytrading/wallet/balance

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    coinstringCoin
    equitystringUser equity (wallet_balance + unrealised_pnl)
    availableBalancestringAvailable balance = wallet balance - used margin
    usedMarginstringUsed margin
    orderMarginstringPre-occupied order margin
    positionMarginstringPosition margin
    walletBalancestringWallet balance
    realisedPnlstringToday's realised pnl
    unrealisedPnlstringunrealised pnl
    cumRealisedPnlstringAccumulated realised pnl (all-time total)

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/contract/v3/private/copytrading/wallet/balance' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670841373442' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "availableBalance": "985.4988359",
            "usedMargin": "0",
            "orderMargin": "0",
            "positionMargin": "0",
            "walletBalance": "985.4988359",
            "realisedPnl": "0",
            "unrealisedPnl": "0",
            "cumRealisedPnl": "-14.5011641",
            "coin": "USDT",
            "equity": "985.4988359"
        },
        "retExtInfo": {},
        "time": 1673257786956
    }
    - + \ No newline at end of file diff --git a/copy-trade/enum.html b/copy-trade/enum.html index b13b59a6a8..f77529a922 100644 --- a/copy-trade/enum.html +++ b/copy-trade/enum.html @@ -4,13 +4,13 @@ Enums Definitions | Bybit API Documentation - +

    Enums Definitions

    accountType​

    • UNIFIED Unified account
    • CONTRACT Future account
    • COPYTRADING CopyTrading account

    transferStatus​

    • SUCCESS
    • PENDING
    • FAILED

    symbol​

    CopyTrading supports USDT Perpetual only

    • BTCUSDT
    • ETHUSDT
    • SOLUSDT
    • ...

    orderType​

    • Market
    • Limit

    triggerBy​

    • LastPrice
    • IndexPrice
    • MarkPrice

    copyTradeOrderStatus​

    • UNKNOWN
    • PendingNew
    • New
    • OpenOrderPartiallyFilled
    • OpenOrderFilled
    • OpenOrderClosing
    • OpenOrderClosedFilled
    • CloseOrderPartiallyFilled
    • CloseOrderFilled
    • Cancelled
    • Untriggered
    • Triggered

    timeInForce​

    • GoodTillCancel
    • ImmediateOrCancel
    • FillOrKill
    • PostOnly

    positionIdx​

    • 0 one-way mode
    • 1 Buy side hedge mode
    • 2 Sell side hedge mode

    interval​

    • 1 3 5 15 30 60 120 240 360 720 minute
    • D day
    • W week
    • M month

    tickDirection​

    It indicates price fluctuation relative to the last trade.

    • PlusTick price rise
    • ZeroPlusTick trade occurs at the same price as the previous trade, which occurred at a price higher than that for the trade preceding it
    • MinusTick price drop
    • ZeroMinusTick trade occurs at the same price as the previous trade, which occurred at a price lower than that for the trade preceding it

    execType​

    lastLiquidityInd​

    • AddedLiquidity add liquidity
    • RemovedLiquidity take liquidity
    • LiquidityIndNA Liquidity not applicable
    - + \ No newline at end of file diff --git a/copy-trade/error.html b/copy-trade/error.html index 1f16064eae..1c49990757 100644 --- a/copy-trade/error.html +++ b/copy-trade/error.html @@ -4,13 +4,13 @@ Error Code | Bybit API Documentation - +

    Error Code

    CodeDescription
    10000An unknown error occurred while processing the request.
    10001There was a problem with the value passed to the API
    10002Request not authorized - an API key is required and should be included in all requests.
    10003Invalid api key
    10004Invalid sign
    10005Permission denied for current apikey. API key was created without the correct permissions (e.g. doesn´t have Order permission, or it's set to read-only)
    10006Too many visits. Refer to the API rate limit. Please use WebSocket for live updates. Current limit is %s requests per minute.
    10007Response timeout from backend server. Delivery and request status unknown.
    10010Request IP mismatch.
    10012DB error
    10014Trading pairs not supported.
    10015Too many new orders. Please lower request frequency.
    10016Service not available.
    10017Request path not found or request method is invalid
    10018Exceeded IP rate limit.
    10020Request not supported.
    10021Timestamp for the request is outside of the recvWindow. The timestamp of this request is 1000 milliseconds ahead of the server time. Please check local time and server time.
    10022Invalid request signature.
    11000Parameter characters not supported.
    11001Too many parameters sent for this endpoint.
    11002Required parameter not sent. Parameter was empty/null or format was incorrect.
    11003Unknown parameter sent.
    11004Not all parameters sent were read.
    11005Empty parameter.
    11006Parameter was sent when no longer required.
    11011Order price exceeded upper limit.
    11012Trading pair does not exist.
    11014TimeInForce parameter sent when not required.
    11015Invalid timeInForce.
    11016Invalid orderType.
    11017Invalid direction.
    11018User-generated order ID was empty.
    11019User-generated order ID was empty.
    11020Invalid interval.
    11021Invalid symbol.
    11025listenKey does not exist.
    11027Query intervals too large.
    11028Invalid parameter combination.
    11030Invalid parameter sent.
    11031Insufficient balance.
    11032Order price exceeded upper limit.
    11033Order price exceeded lower limit.
    11034Order price has too many decimals.
    11035Order quantity exceeded upper limit.
    11036Order quantity exceeded lower limit.
    11037Order quantity has too many decimals.
    11038Order price exceeded limits.
    11039Order has been filled.
    11040Order value exceeded lower limit.
    11041Duplicate clientOrderId.
    11042Order has been canceled.
    11043Order not found.
    11044Order being cancelled. Operation not supported.
    11045Order cannot be canceled.
    11046Order creation timeout.
    11047Order cancellation timeout.
    11090Cancel order has been finished.
    11091Can not cancel order, please try again later.
    20001Order does not exist.
    20003Missing parameter side
    20004Invalid parameter side
    20005Missing parameter symbol
    20006Invalid parameter symbol
    20007Missing parameter order_type
    20008Invalid parameter order_type
    20009Missing parameter qty
    20010New order rejected.
    20011Cancelation rejected.
    20012qty must be greater than zero and less than 1 million
    20013Order does not exist.
    20014Invalid API key format.
    20015Invalid API key or IP.
    20016Trading window not open yet for current pair.
    20017Missing parameter order_id
    20018Invalid date format
    20019Missing parameter stop_px
    20020Missing parameter base_price
    20021Missing parameter stop_order_id
    20022Missing parameter leverage
    20023Leverage must be a number
    20031Leverage must be greater than zero
    20070Missing parameter margin
    20071margin must be greater than zero
    20084order_id or order_link_id is required
    20094order_link_id is not unique.
    30002Exit order already exists.
    30003qty must be higher than the minimum allowed.
    30004qty must be higher than the minimum allowed. The number of contracts exceeds maximum limit allowed. Order qty should be less than 1 million per order.
    30005Order price is out of permissible range.
    30006No last_price.
    30007Order price is out of permissible range.
    30008Invalid order_type.
    30009No position found.
    30010Insufficient wallet balance.
    30011Operation not allowed as position is undergoing liquidation
    30012Operation not allowed as position is undergoing ADL
    30013Position is in liq or adl status
    30014Invalid closing order, qty should not be greater than size.
    30015Invalid closing order, side should be the opposite.
    30016TP and SL must be cancelled before closing the position.
    30017Estimated fill price cannot be lower than current Buy liq_price.
    30018Estimated fill price cannot be higher than current Sell liq_price.
    30019Cannot attach TP/SL params for non-zero position when placing non-opening position order.
    30020Position already has TP/SL params.
    30021Cannot afford estimated position_margin.
    30022Estimated buy liq_price cannot be higher than current mark_price.
    30023Estimated sell liq_price cannot be lower than current mark_price.
    30024Cannot set TP/SL/TS for zero-position
    30025Trigger price should bigger than 10% of last price.
    30026Price is too high.
    30027Price set for Take profit should be higher than Last Traded Price.
    30028Price set for Stop Loss should be between Liquidation price and Last Traded Price.
    30029Price set for Stop Loss should be between Last Traded Price and Liquidation Price.
    30030Price set for Take Profit should be lower than Last Traded Price.
    30031Insufficient available balance for order cost.
    30032Order has been filled or cancelled.
    30033The number of stop orders exceeds maximum limit allowed.
    30034No stop order found.
    30035Too fast to cancel, try it later.
    30036The expected position value after order execution exceeds the current risk limit
    30037Order already cancelled
    30038No mark_price.
    30039Applied leverage has exceeded the permitted range.
    30040Any adjustments made will trigger immediate liquidation.
    30041No position found.
    30042Insufficient wallet balance.
    30043Operation not allowed as position is undergoing liquidation.
    30044Operation not allowed as position is undergoing ADL.
    30045Operation not allowed as position is not in normal status.
    30046There are multiple untriggered stop orders.
    30047Inconsistent p:o.
    30048Applied leverage has exceeded the permitted range.
    30049Insufficient available balance.
    30050Any adjustments made will trigger immediate liquidation!
    30051Due to risk limit, cannot adjust leverage.
    30052Leverage cannot be less than 1x.
    30053max_affordable_position_margin <= 0, position:%s
    30054fixed_new_position_margin is invalid.
    30055Available Balance is not enough to add margin.
    30056The position is in cross_margin.
    30057Requested quantity of contracts exceeds risk limit, please adjust your risk limit level before trying again.
    30063Reduce-only rule not satisfied
    30066Set auto add margin fail.
    30067Insufficient available balance.
    30068Exit value must be positive.
    30073Number of active orders is greater than 500.
    30074Can't create the stop order, because you expect the order will be triggered when the LastPrice(or IndexPrice, MarkPrice, determined by trigger_by) is raising to stop_px, but the LastPrice(or IndexPrice, MarkPrice) is already equal to or greater than stop_px, please adjust base_price or stop_px
    30075Can't create the stop order, because you expect the order will be triggered when the LastPrice(or IndexPrice, MarkPrice, determined by trigger_by) is falling to stop_px, but the LastPrice(or IndexPrice, MarkPrice) is already equal to or less than stop_px, please adjust base_price or stop_px
    30076Replace params invalid. Order not modified.
    30077Submission of order will result in the breach of user's limit according to open interest.
    30078Contracts not in trading status
    30079The position is about to trigger a liquidation
    30080Price cannot be lower than current Buy liq_price
    30081Price cannot be greater than current sell liq_price
    30082Position exists No switching of position mode allowed
    30083No change in position pattern
    30084No changes to the full position-by-position model
    30085Margin unchanged
    30086With a commissioned order, switching position mode is not allowed
    30087Symbol does not support two-way open positions
    30088Symbol does not exist
    30089Duplicate order number
    30090Risk limit info does not exist
    30091Illegal orders (meaning that the order os
    30092No position is not allowed to set margin
    30093No net position
    30094Withdrawal of an order before a liquidation is not concluded
    30095Full positions are not allowed to modify leverage
    31003User account banned
    32006The available balance is not sufficient to cover the handling fee.
    32008Insufficient available margin.
    32009Any adjustments made will trigger immediate liquidation.
    32010Risk limit cannot be adjusted due to insufficient available margin.
    32011Risk limit cannot be adjusted as the current/expected position value held exceeds the revised risk limit.
    33004apikey already expired
    34010Wallet Balance is less than zero.
    34015Cannot set new leverage as it is equal to the previous leverage.
    34017Current leverage is less than 1X
    34018Cannot set leverage lower than 1X
    34019Cannot set leverage greater than maxLeverage.
    34020Cannot set leverage which is same to the previous leverage.
    34021Cannot cancel occ_calc_data, the data is wrong.
    34022Cannot set leverage which will cause available balance less than 0.
    34023The request was canceled because the origin request has been handled.
    34024The request does not include add margin data.
    34025Increase in leverage has failed.
    34026The new limit is equal to the old limit (no change).
    34027Cannot adjust leverage.
    34028ReCalc Funding Fee Failed.
    34030positionInfo not sync with current exec_rpt.
    34032PositionSeq not match on Withdraw.
    34033Realized PNL already rotated.
    34035Add margin not modified.
    34036Set leverage not modified.
    34037Set custom fee rate not modified.
    34038Update deleverage indicator not modified.
    34039Update position status not modified.
    34040Set TP/SL/TS not modified.
    35014Open interest exceeded.
    37001Both side positions tp_sl_mode is equal.
    37002Same tp_sl_mode.
    37003This position has at least one stop-link order and cannot switch between stop-loss and take-profit modes.
    37004This position has at least one stop-loss link order and cannot switch between stop-loss and take-profit modes.
    37005This position has at least one trailing stop or trailing stop link order and cannot be switched to take profit and stop loss mode.
    37006Conditional or limit orders carry a take profit and stop loss parameter
    37007Insufficient number of positions left to set Stop Loss and Take Profit
    37008Active orders are not allowed to modify the price and quantity when they also modify the trigger price
    37009Activity orders are not allowed to modify the stop-loss and take-profit settings if the order is partially filled
    37010In Full Take Profit Stop Loss mode, it is not allowed to modify the Stop Profit Stop Loss size
    37011In partial SL mode, SL is set to more than 20. Set SL/TP exceeds the limit oldTpNum+oldStNum+newNum=(2 the num is tp+sl)
    37012Stop loss price needs to be greater than base price.
    37013Stop loss price needs to be less than base price.
    38101Replacement of order will result in the breach of user's limit according to open interest.
    90015Insufficient balance
    90016Rejected by risk control. It may cause liquidation after the transfer.
    90063In the progress of liquidation
    90066In the reconciliation
    90067Reconciliation failed
    131200server err
    131201biz err
    131212user insufficient balance
    131217risk check err
    131203request parameter err
    131204account info err
    131206cannot be transfer
    131214transferId exist
    131215amount err
    131216query balance error
    131218unify transfer out risk，user's positions are currently under forced liquidation
    131219unify transfer out risk，transfer out waring
    131220unify transfer out risk，transfer out interest-free-load-limit waring
    131221unify transfer out risk，transfer out waring
    131222unify transfer out risk，reconciliation check fail
    131223unify transfer out risk，refused
    131224unify transfer out risk，balance not enough
    131225unsupported unify state
    - + \ No newline at end of file diff --git a/copy-trade/position/close-position.html b/copy-trade/position/close-position.html index 1b48a403fd..bda6073d19 100644 --- a/copy-trade/position/close-position.html +++ b/copy-trade/position/close-position.html @@ -4,13 +4,13 @@ Close All Positions | Bybit API Documentation - +

    Close All Positions

    Close Position

    HTTP Request​

    GET /contract/v3/private/copytrading/position/close

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol
    positionIdxtruestringPosition idx, used to identify positions in different position modes: 0-Single side; 1-Buy side of both side mode; 2-Sell side of both side mode

    Response Parameters​

    None

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/position/close' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670841189767' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{"symbol":"BTCUSDT","positionIdx":"1"}'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1670841190031
    }
    - + \ No newline at end of file diff --git a/copy-trade/position/execution-list.html b/copy-trade/position/execution-list.html index 142bec2857..6280445c5f 100644 --- a/copy-trade/position/execution-list.html +++ b/copy-trade/position/execution-list.html @@ -4,13 +4,13 @@ Get Execution List (2 years) | Bybit API Documentation - +

    Get Execution List (2 years)

    Query users' execution list, sort by execTime in descending order

    tip

    You may have multiple executions in a single order.

    HTTP Request​

    GET /contract/v3/private/copytrading/execution/list

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    orderIdfalsestringOrder ID. Return all records if not passed
    orderLinkIdfalsestringUser customised order ID
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    execTypefalsestringExecution type
    limitfalseintegerLimit for data size per page. [1, 100]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    nextPageCursorstringCursor. Used to pagination
    listarrayObject
    > symbolstringSymbol name
    > sidestringBuy,Sell
    > orderIdstringOrder id
    > orderLinkIdstringUser customised order id
    > orderPricestringOrder price
    > orderQtystringOrder qty
    > orderTypestringMarket,Limit
    > execIdstringTrade Id
    > execPricestringExecution price
    > execQtystringExecution qty
    > execFeestringExecution fee
    > execTypestringExecution type
    > execValuestringExecution position value
    > feeRatestringTrading fee rate
    > lastLiquidityIndstringAddedLiquidity, RemovedLiquidity, LiquidityIndNA
    > isMakerbooleanIs maker
    > leavesQtystringRemaining qty waiting for execution
    > closedSizestringClose size
    > markPricestringMark price
    > execTimestringExecution timestamp (ms)

    Request Example​

    GET /contract/v3/private/copytrading/execution/list?symbol=XRPUSDT&execType=Funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1678788154878
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "nextPageCursor": "0o+MpbbRsIrLhRXdulAiDPRZFkidzCCKmEOQR4TzFIYyq1tofpJ/bOX92Vn8uwRBSEUuSxC/9jnLZs7oFLgcMQ==",
            "list": [
                {
                    "symbol": "XRPUSDT",
                    "side": "Buy",
                    "orderId": "1678780800-XRPUSDT-1019213-Buy",
                    "orderLinkId": "",
                    "orderPrice": "0.0000",
                    "orderQty": "0",
                    "orderType": "UNKNOWN",
                    "execFee": "0.003679",
                    "execId": "73729a92-caf5-4911-8e85-5194dd2ee1c5",
                    "execPrice": "0.3679",
                    "execQty": "100",
                    "execType": "Funding",
                    "execValue": "36.79",
                    "feeRate": "0.0001",
                    "lastLiquidityInd": "LiquidityIndNA",
                    "isMaker": false,
                    "leavesQty": "0",
                    "closedSize": "0",
                    "markPrice": "0.3679",
                    "execTime": "1678780800000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1678788155282
    }
    - + \ No newline at end of file diff --git a/copy-trade/position/leverage.html b/copy-trade/position/leverage.html index 4cf665ac78..e2974489c2 100644 --- a/copy-trade/position/leverage.html +++ b/copy-trade/position/leverage.html @@ -4,13 +4,13 @@ Set Leverage | Bybit API Documentation - +

    Set Leverage

    Set Leverage

    HTTP Request​

    GET /contract/v3/private/copytrading/position/set-leverage

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol
    buyLeveragetruestringThe value of buy_leverage must be equal to sell_leverage.
    sellLeveragetruestringThe value of buy_leverage must be equal to sell_leverage.

    Response Parameters​

    None

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/position/set-leverage' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670841373442' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{"symbol":"BTCUSDT","buyLeverage":"4","sellLeverage":"4"}'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1670841190031
    }
    - + \ No newline at end of file diff --git a/copy-trade/position/position-info.html b/copy-trade/position/position-info.html index d1aadd4fd6..2ca19d6a4c 100644 --- a/copy-trade/position/position-info.html +++ b/copy-trade/position/position-info.html @@ -4,13 +4,13 @@ Position List | Bybit API Documentation - +

    Position List

    Position List

    HTTP Request​

    GET /contract/v3/private/copytrading/position/list

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringSymbol

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > symbolstringSymbol
    > sidestringSide
    > sizestringPosition qty
    > positionValuestringPosition value
    > entryPricestringAverage entry price
    > liqPricestringLiquidation price
    > bustPricestringBankruptcy price
    > markPricestringMark price
    > leveragestringIn Isolated Margin mode, the value is set by the user. In Cross Margin mode, the value is the max leverage at current risk level
    > isIsolatedbooleantrue means isolated margin mode; false means cross margin mode
    > positionMarginstringPosition margin
    > occClosingFeestringPosition closing fee occupied (your opening fee + expected maximum closing fee)
    > occFundingFeestringPre-occupied funding fee: calculated from position qty and current funding fee
    > cumRealisedPnlstringAccumulated realised pnl (all-time total)
    > freeQtystringQty which can be closed. (If you have a long position, free_qty is negative. vice versa)
    > unrealisedPnlstringunrealised pnl
    > positionIdxstringPosition idx, used to identify positions in different position modes:0-Single side; 1-Buy side of both side mode; 2-Sell side of both side mode
    > createdTimestringCreation time (when the order_status was Created)
    > updatedTimestringUpdate time

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/contract/v3/private/copytrading/position/list' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670831398044' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "symbol": "ETHUSDT",
                    "side": "Sell",
                    "size": "0.02",
                    "positionValue": "25.2665",
                    "entryPrice": "1263.325",
                    "liqPrice": "1383.30",
                    "bustPrice": "1389.65",
                    "markPrice": "1254.60",
                    "leverage": "10",
                    "isIsolated": true,
                    "positionMargin": "2.52665009",
                    "occClosingFee": "0.0166758",
                    "occFundingFee": "0",
                    "cumRealisedPnl": "132.46751301",
                    "freeQty": "0.02",
                    "unrealisedPnl": "0.1745",
                    "positionIdx": "2",
                    "createdTime": "1652324549816",
                    "updatedTime": "1670841190027"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1670841190031
    }
    - + \ No newline at end of file diff --git a/copy-trade/rate-limit.html b/copy-trade/rate-limit.html index a6bc09584a..2cba911a45 100644 --- a/copy-trade/rate-limit.html +++ b/copy-trade/rate-limit.html @@ -4,7 +4,7 @@ Rate Limit | Bybit API Documentation - + @@ -15,7 +15,7 @@ in an unexpected violation.

    • GET/POST method (shared):
      • No more than 600 requests are allowed in any 5-second window.
    note

    All traffic to api.bybit.com or api.bytick.com share this limit regardless of if it accesses Spot, Derivatives or Options.

    After violating the limit your IP will be banned for a set period of time (usually 30 minutes). Continually violating the limit will result in a permanent ban. We cannot undo permanent bans or shorten temporary bans.

    API Rate Limit​

    caution

    If you receive "ret_msg": "Too many visits!" in the JSON response, you have hit the API rate limit.

    The API rate limit is based on the rolling time window per minute and UID. In other words, it is per minute per UID. Every request to the API returns response header shown in the code panel:

    • X-Bapi-Limit-Status - your remaining requests for current endpoint
    • X-Bapi-Limit - your current limit for current endpoint
    • X-Bapi-Limit-Reset-Timestamp - the timestamp indicating when your request limit resets if you have exceeded your rate_limit. Otherwise, this is just the current timestamp.

    Http Response Header Example

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    API Rate Limit Table​

    PathLimitConsume
    /contract/v3/private/copytrading/position/set-leverage75 req/min1/request
    /contract/v3/private/copytrading/position/close1/request
    /contract/v3/private/copytrading/position/list1/request
    /contract/v3/private/copytrading/order/create100 req/min1/request
    /contract/v3/private/copytrading/order/close1/request
    /contract/v3/private/copytrading/order/cancel1/request
    /contract/v3/private/copytrading/order/list 1/request
    /contract/v3/private/copytrading/wallet/balance120 req/min1/request
    /contract/v3/private/copytrading/wallet/transfer1/request

    How to increase API Limit​

    Please email api@bybit.com with the following information. We will reply within 1-4 working days:

    1. Your name and your company details
    2. Your Bybit UID or registered email, and the assets you are trading
    3. General description of your trading strategy and reasons for higher rate limits
    4. Screenshot of previous monthly trading volume (maker/taker) on other platforms
    5. Optional: your order history in CSV format
    - + \ No newline at end of file diff --git a/copy-trade/trade/cancel.html b/copy-trade/trade/cancel.html index 1b916b9ff2..f4bc50de7f 100644 --- a/copy-trade/trade/cancel.html +++ b/copy-trade/trade/cancel.html @@ -4,13 +4,13 @@ Cancel Order | Bybit API Documentation - +

    Cancel Order

    Cancel Order

    HTTP Request​

    POST /contract/v3/private/copytrading/order/cancel

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringsymbol
    orderIdfalsestringOrder ID. Either passing orderId or orderLinkId
    orderLinkIdfalsestringUnique user-set order ID. Maximum length of 36 characters. Either passing orderId or orderLinkId

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUnique user-set order ID. Maximum length of 36 characters

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/order/cancel' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670831398044' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{"orderId": "a4f60d8d-2957-46cb-9fff-126367e7fdc6"}'

    Response Example​

    {
      "retCode": 0,
        "retMsg": "success",
        "result": {
            "orderId": "419190fe-016c-469a-810e-936bef2f5d59",
            "orderLinkId": ""
          }
    }
    - + \ No newline at end of file diff --git a/copy-trade/trade/close-order.html b/copy-trade/trade/close-order.html index da386fb0b1..adf4edce92 100644 --- a/copy-trade/trade/close-order.html +++ b/copy-trade/trade/close-order.html @@ -4,13 +4,13 @@ Create Close Position Order | Bybit API Documentation - +

    Create Close Position Order

    Create a specific close order

    HTTP Request​

    POST /contract/v3/private/copytrading/order/close

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol
    orderLinkIdfalsestringUnique user-set order ID. Maximum length of 36 characters
    parentOrderIdfalsestringRequired if not passing parentOrderLinkId
    parentOrderLinkIdfalsestringRequired if not passing parentOrderId

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUnique user-set order ID. Maximum length of 36 characters

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/order/close' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670831398044' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{"symbol":"BTCUSDT","parentOrderId":"cf252fd5-f25f-4623-9080-c60201b22575"}'

    Response Example​

    {
      "retCode": 0,
        "retMsg": "success",
        "result": {
            "orderId": "419190fe-016c-469a-810e-936bef2f5d59",
            "orderLinkId": ""
          }
    }
    - + \ No newline at end of file diff --git a/copy-trade/trade/create-order.html b/copy-trade/trade/create-order.html index b6bc614be5..f2b1902ce9 100644 --- a/copy-trade/trade/create-order.html +++ b/copy-trade/trade/create-order.html @@ -4,13 +4,13 @@ Create Order | Bybit API Documentation - +

    Create Order

    Create Order

    HTTP Request​

    POST /contract/v3/private/copytrading/order/create

    Request Parameters​

    ParameterRequiredTypeComments
    sidetruestringSide
    symboltruestringSymbol
    orderTypetruestringActive order type
    qtytruestringOrder quantity
    pricefalsestringOrder price
    takeProfitfalsestringTake profit price
    stopLossfalsestringStop loss price
    tpTriggerByfalsestringType of take-profit activation price, LastPrice by default
    slTriggerByfalsestringType of stop-loss activation price, LastPrice by default
    orderLinkIdfalsestringUnique user-set order ID. Maximum length of 36 characters

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUnique user-set order ID. Maximum length of 36 characters

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/order/create' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670831398044' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json; charset=utf-8' \
    --data-raw '{"side":"Sell","symbol":"BTCUSDT","orderType":"Limit","qty":"0.001","price":"20000","takeProfit":"0","stopLoss":"0","tpTriggerBy":"LastPrice","slTriggerBy":"LastPrice"}'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "orderId": "419190fe-016c-469a-810e-936bef2f5d59",
            "orderLinkId": "234590fe-016c-44f6-fg78"
        }
    }
    - + \ No newline at end of file diff --git a/copy-trade/trade/get-order.html b/copy-trade/trade/get-order.html index 5e1483169e..659cb65ce9 100644 --- a/copy-trade/trade/get-order.html +++ b/copy-trade/trade/get-order.html @@ -4,13 +4,13 @@ Get Orders | Bybit API Documentation - +

    Get Orders

    Query orders

    HTTP Request​

    GET /contract/v3/private/copytrading/order/list

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringSymbol
    orderIdfalsestringOrder Id
    orderLinkIdfalsestringUnique user-set order ID. Maximum length of 36 characters
    copyTradeOrderTypefalsestringCopyTrading order type

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder Id
    orderLinkIdstringUnique user-set order ID. Maximum length of 36 characters
    symbolstringSymbol
    sidestringSide
    pricestringOrder price
    qtystringOrder quantity in USD
    timeInForcestringTime in force
    isIsolatedbooleantrue means isolated margin mode; false means cross margin mode
    leveragestringIn Isolated Margin mode, the value is set by the user. In Cross Margin mode, the value is the max leverage at current risk level
    copyTradeOrderStatusstringCopy trade order type
    leavesQtystringNumber of unfilled contracts from the order's size
    leavesValuestringThe estimated value corresponding to the number of remaining orders
    cumExecValuestringCumulative value of trading
    cumExecFeestringCumulative trading fees
    takeProfitstringTake profit price
    stopLossstringStop loss price
    tpTriggerBystringType of take-profit activation price, LastPrice by default.
    slTriggerBystringType of stop-loss activation price, LastPrice by default.
    createdTimestringCreation time (when the order_status was Created)
    updatedTimestringUpdate time

    Request Example​

    curl "https://api-testnet.bybit.com/contract/v3/private/copytrading/order/list?api_key={api_key}&timestamp={timestamp}&sign={sign}&symbol=ETHUSDT"

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "orderId": "ae0700f6-c990-4de5-9d6e-0fdf8d5aabea",
                    "symbol": "ETHUSDT",
                    "orderLinkId": "234500f6-c45f-4de5-9d6e",
                    "side": "Sell",
                    "copyTradeOrderStatus": "New",
                    "price": "4000.00",
                    "qty": "5.55",
                    "timeInForce": "GoodTillCancel",
                    "leavesQty": "5.55",
                    "isIsolated": true,
                    "leavesValue": "22200",
                    "leverage": "44",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "createdTime": "1652216213331",
                    "updatedTime": "1652216213365"
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/copy-trade/trade/trading-stop.html b/copy-trade/trade/trading-stop.html index 22058e2f49..5995fa15c9 100644 --- a/copy-trade/trade/trading-stop.html +++ b/copy-trade/trade/trading-stop.html @@ -4,13 +4,13 @@ Set Trading Stop | Bybit API Documentation - +

    Set Trading Stop

    Set Trading Stop

    HTTP Request​

    POST /contract/v3/private/copytrading/order/trading-stop

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol
    parentOrderIdtruestringparentOrderId
    takeProfitfalsestringTake profit price
    stopLossfalsestringStop loss price
    tpTriggerByfalsestringType of take-profit activation price
    slTriggerByfalsestringType of stop-loss activation price
    parentOrderLinkIdfalsestringparentOrderLinkID

    Response Parameters​

    None

    Request Example​

    curl --location --request POST 'https://api.bybit.com/contract/v3/private/copytrading/order/trading-stop' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662026807816' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "symbol": "BTCUSDT",
        "parentOrderId": "XXXXXXXX",
        "takeProfit": "0",
        "stopLoss": "0",
        "tpTriggerBy": "MarkPrice",
        "slTriggerBy": "LastPrice",
        "parentOrderLinkId": "XXXXXXXX"
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {}
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-private/execution.html b/copy-trade/ws-private/execution.html index 8207c63932..94764e8777 100644 --- a/copy-trade/ws-private/execution.html +++ b/copy-trade/ws-private/execution.html @@ -4,14 +4,14 @@ Execution | Bybit API Documentation - +

    Execution

    Topic:
    copyTradeExecution

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder Id
    orderLinkIdstringUnique user-set order ID. Maximum length of 36 characters
    symbolstringSymbol
    sidestringSide
    execIdstringTransaction ID
    execQtystringTransaction qty
    execTypestringExecution type (cannot be Funding)
    execFeestringTransaction fee
    pricestringTransaction price
    orderQtystringOrder qty
    tradeTimenumberTransaction timestamp

    Request Example​

    ws.send('{"op": "subscribe", "args": ["copyTradeExecution"]}')

    Response Example​

    {
        "topic": "copyTradeExecution",
        "data": [
            {
                "orderId": "6d667921-3cf4-4efd-b93f-727bd10a3b62",
                "orderLinkId": "w11a313223ddd132111",
                "symbol": "ETHUSDT",
                "side": "Sell",
                "execId": "0182b08b-a3ce-5038-a8be-5e1e9f862e90",
                "execQty": "0.010000",
                "execType": "Trade",
                "execFee": "0.01175970",
                "price": "1863.250000",
                "orderQty": "0.010000",
                "tradeTime": 1652932133873
            }
        ]
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-private/order.html b/copy-trade/ws-private/order.html index 23187d1308..ac93755ad4 100644 --- a/copy-trade/ws-private/order.html +++ b/copy-trade/ws-private/order.html @@ -4,14 +4,14 @@ Order | Bybit API Documentation - +

    Order

    Topic:
    copyTradeOrder

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder Id
    orderLinkIdstringUnique user-set order ID. Maximum length of 36 characters
    symbolstringSymbol
    orderTypestringConditional order type
    pricestringOrder price
    qtystringTransaction qty
    sidestringSide
    positionIdxstringPosition idx, used to identify positions in different position modes: 1-Buy side of both side mode; 2-Sell side of both side mode
    cumExecFeestringCumulative trading fees
    cumExecValuestringCumulative value of trading
    lastExecPricestringLast execution price
    cumExecQtystringCumulative qty of trading
    takeProfitstringTake profit price
    stopLossstringStop loss price
    tpTriggerBystringType of take-profit activation price, LastPrice by default.
    slTriggerBystringType of stop-loss activation price, LastPrice by default.
    createTimenumberCommission time
    updateTimenumberUpdate time
    copyTradeOrderStatusstringCopy trade order status

    Request Example​

    ws.send('{"op": "subscribe", "args": ["copyTradeOrder"]}')

    Response Example​

    {
        "topic": "copyTradeOrder",
        "data": [
            {
                "orderId": "6d667921-3cf4-4efd-b93f-727bd10a3b62",
                "orderLinkId": "w11a313223ddd132111",
                "symbol": "ETHUSDT",
                "orderType": "Market",
                "price": "1863.250000",
                "qty": "0.010000",
                "side": "Sell",
                "positionIdx": "2",
                "cumExecFee": "0.01175970",
                "cumExecValue": "19.59950000",
                "lastExecPrice": "1959.949951",
                "cumExecQty": "0.010000",
                "takeProfit": "1750",
                "stopLoss": "2000",
                "tpTriggerBy": "LastPrice",
                "slTriggerBy": "LastPrice",
                "createTime": 1652932133873,
                "updateTime": 1652932133892,
                "copyTradeOrderStatus": "OpenOrderFilled"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-private/position.html b/copy-trade/ws-private/position.html index 559f3c8b82..cc7052ef13 100644 --- a/copy-trade/ws-private/position.html +++ b/copy-trade/ws-private/position.html @@ -4,14 +4,14 @@ Position | Bybit API Documentation - +

    Position

    Topic:
    copyTradePosition

    Response Parameters​

    ParameterTypeComments
    symbolstringSymbol
    positionIdxstringPosition idx, used to identify positions in different position modes: 1-Buy side of both side mode; 2-Sell side of both side mode
    positionValuestringPosition value
    riskIdintegerRisk ID
    leveragestringIn Isolated Margin mode, the value is set by the user.
    isolatedbooleantrue means isolated margin mode; false means cross margin mode
    sidestringSide
    sizestringPosition qty
    unrealisedPnlstringunrealised pnl
    liqPricestringLiquidation price
    bustPricestringBankruptcy price
    entryPricestringAverage entry price
    positionMarginstringPosition margin
    orderMarginstringPre-occupied order margin
    occClosingFeestringPosition closing fee occupied (your opening fee + expected maximum closing fee)
    cumRealisedPnlstringAccumulated realised pnl (all-time total)
    positionStatusstringPosition status: Normal, Liq, Adl
    positionSeqnumberPosition sequence

    Request Example​

    ws.send('{"op": "subscribe", "args": ["copyTradePosition"]}')

    Response Example​

    {
        "topic": "copyTradePosition",
        "data": [
            {
                "symbol": "ETHUSDT",
                "positionIdx": "2",
                "positionValue": "80.05065626",
                "riskId": 11,
                "leverage": "10.000000",
                "isIsolated": true,
                "side": "Sell",
                "size": "0.040000",
                "unrealisedPnl": "1.62665626",
                "liqPrice": "2191.350098",
                "bustPrice": "2201.350098",
                "entryPrice": "2001.26640650",
                "positionMargin": "8.00506666",
                "orderMargin": "0.00000000",
                "occClosingFee": "0.05283240",
                "cumRealisedPnl": "0.55284374",
                "positionStatus": "Normal",
                "positionSeq": 0
            }
        ]
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-private/wallet.html b/copy-trade/ws-private/wallet.html index 51d32cdf55..3e0fdcac59 100644 --- a/copy-trade/ws-private/wallet.html +++ b/copy-trade/ws-private/wallet.html @@ -4,14 +4,14 @@ Wallet | Bybit API Documentation - +

    Wallet

    Topic:
    copyTradeWallet

    Response Parameters​

    ParameterTypeComments
    walletBalancenumberWallet balance
    availableBalancenumberAvailable balance = wallet balance - used margin

    Request Example​

    ws.send('{"op": "subscribe", "args": ["copyTradeWallet"]}')

    Response Example​

    {
        "topic": "copyTradeWallet",
        "data": {
            "walletBalance": "14009.12164704",
            "availableBalance": "13998.97749271"
        }
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-public/kline.html b/copy-trade/ws-public/kline.html index 246f7c4f39..da3ecb7d01 100644 --- a/copy-trade/ws-public/kline.html +++ b/copy-trade/ws-public/kline.html @@ -4,14 +4,14 @@ Kline | Bybit API Documentation - +

    Kline

    Interval supported:

    • 1 3 5 15 30 60 120 240 360 720 minute
    • D day
    • W week
    • M month
    info

    If confirm is true, then the data is a final tick for this interval. Otherwise, it is a snapshot.

    Push frequency: 1-60s

    Topic: kline.{interval}.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataarrayObject
    > startnumberCandle start timestamp (ms)
    > endnumberCandle end timestamp (ms)
    > intervalstringInterval
    > openstringOpen price
    > closestringClose price. If not closed, it is last price
    > highstringHighest price
    > lowstringLowest price
    > volumestringTrading volume
    > turnoverstringTrading turnover
    > confirmbooleantrue: last tick. false: this is snapshot data
    > timestampnumberThe timestamp (ms) of the last matched order in the candle

    Subscription Example​

    {
        "op": "subscribe",
        "args": [
        "kline.5.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    Stream Example​

    {
        "topic": "kline.5.BTCUSDT",
        "data": [
            {
                "start": 1671187800000,
                "end": 1671188099999,
                "interval": "5",
                "open": "16991",
                "close": "16980.5",
                "high": "16991",
                "low": "16980.5",
                "volume": "2.501",
                "turnover": "42493.2305",
                "confirm": false,
                "timestamp": 1671187815755
            }
        ],
        "ts": 1671187815755,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-public/liquidation.html b/copy-trade/ws-public/liquidation.html index d3dbe0567d..1973c58fb3 100644 --- a/copy-trade/ws-public/liquidation.html +++ b/copy-trade/ws-public/liquidation.html @@ -4,14 +4,14 @@ Liquidation | Bybit API Documentation - +

    Liquidation

    Get recent liquidation orders in Bybit.

    Push frequency: real-time

    Topic: liquidation.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataarrayObject
    > updatedTimenumberData updated timestamp (ms)
    > symbolstringSymbol name
    > sizestringFilled size
    > pricestringFilled price
    > sidestringSide

    Subscription Example​

    {
        "op": "subscribe",
        "args": [
          "liquidation.GALAUSDT"
        ],
        "req_id": "test" // optional
    }

    Stream Example​

    {
        "data": {
            "price": "0.03803",
            "side": "Buy",
            "size": "1637",
            "symbol": "GALAUSDT",
            "updatedTime": 1673251091822
        },
        "topic": "liquidation.GALAUSDT",
        "ts": 1673251091822,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-public/orderbook.html b/copy-trade/ws-public/orderbook.html index 2e9961e1e7..d5c0f67796 100644 --- a/copy-trade/ws-public/orderbook.html +++ b/copy-trade/ws-public/orderbook.html @@ -4,14 +4,14 @@ Orderbook | Bybit API Documentation - +

    Orderbook

    Get different depth

    info
    • Once subscribe successfully, you will receive a snapshot first.
    • The data is sort by order price, which bids is from highest to lowest and asks is from lowest to highest
    • Websocket will keep pushing delta message when orderbook is changed.
    • If you receive a new snapshot data, it is necessary to reset your local orderbook.
    • If there is a problem in bybit end, it will re-send a snapshot, which is promised the latest and accurate.
    tip

    Level 1 data: if 3 seconds have elapsed without a change in the orderbook, a snapshot message will be pushed again.

    • Level 1 data, push frequency: 10ms
    • Level 50 data, push frequency: 20ms
    • Level 200 data, push frequency: 100ms

    Topic:
    orderbook.{depth}.{symbol} e.g., orderbook.1.BTCUSDT

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringMessage type. snapshot,delta
    tsnumberThe timestamp (ms) that system generates the data.
    dataObject
    > sStringSymbol name
    > barray<array>Bid array
    >> b[0][0]stringBid price
    >> b[0][1]stringBid size
    > sarray<array>Ask array
    >> s[0][0]stringAsk price
    >> s[0][1]stringAsk size
    > unumberUpdate id, is always in sequence. Occasionally, you'll receive "u"=1, which is a snapshot data due to the restart of the service. So please overwrite the locally saved orderbook
    > seqnumberCross sequence (internal value)

    Subscription Example​

    {
        "op": "subscribe",
        "args": [
        "orderbook.50.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    Stream Example​

    {
        "topic": "orderbook.50.BTCUSDT",
        "type": "snapshot",
        "ts": 1671179923028,
        "data": {
            "s": "BTCUSDT",
            "b": [
                [
                    "17440.00",
                    "40.833"
                ],
                [
                    "17439.50",
                    "0.513"
                ],
                ...
                [
                    "17416.00",
                    "6.156"
                ],
                [
                    "17415.50",
                    "32.268"
                ]
        ],
        "a": [
            [
                "17440.50",
                "78.815"
            ],
            [
                "17441.00",
                "8.858"
            ],
            ...
            [
                "17464.50",
                "4.901"
            ],
            [
                "17465.00",
                "5.744"
            ]
        ],
        "u": 13079592,
        "seq": 22520573250
        }
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-public/ticker.html b/copy-trade/ws-public/ticker.html index b5bc0b3767..d409dd9d6b 100644 --- a/copy-trade/ws-public/ticker.html +++ b/copy-trade/ws-public/ticker.html @@ -4,14 +4,14 @@ Tickers | Bybit API Documentation - +

    Tickers

    Get latest information of the symbol

    important

    Have snapshot and delta types. If a key does not exist in the field, it means the value is not changed.

    Push frequency: real-time

    Topic: tickers.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot,delta
    csintegerCross sequence
    tsnumberThe timestamp (ms) that the system generates the data
    dataarrayObject
    > symbolstringSymbol name
    > tickDirectionstringTick direction
    > price24hPcntstringPercentage change of market price in the last 24 hours
    > lastPricestringLast price
    > prevPrice24hstringMarket price 24 hours ago
    > highPrice24hstringThe highest price in the last 24 hours
    > lowPrice24hstringThe lowest price in the last 24 hours
    > prevPrice1hstringMarket price an hour ago
    > markPricestringMark price
    > indexPricestringIndex price
    > openIntereststringOpen interest size
    > openInterestValuestringOpen interest value
    > turnover24hstringTurnover for 24h
    > volume24hstringVolume for 24h
    > nextFundingTimestringNext funding timestamp (ms)
    > fundingRatestringFunding rate
    > bid1PricestringBest bid price
    > bid1SizestringBest bid size
    > ask1PricestringBest ask price
    > ask1SizestringBest ask size

    Subscription Example​

    {
        "op": "subscribe",
        "args": [
            "tickers.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    Stream Example​

    {
        "topic": "tickers.BTCUSDT",
        "type": "snapshot",
        "data": {
            "symbol": "BTCUSDT",
            "tickDirection": "MinusTick",
            "price24hPcnt": "0.017367",
            "lastPrice": "17222.00",
            "prevPrice24h": "16928.00",
            "highPrice24h": "17281.50",
            "lowPrice24h": "16915.00",
            "prevPrice1h": "17238.00",
            "markPrice": "17224.40",
            "indexPrice": "17234.84",
            "openInterest": "68795.534",
            "openInterestValue": "1184961795.83",
            "turnover24h": "1572429119.324499",
            "volume24h": "91823.449",
            "nextFundingTime": "1673280000000",
            "fundingRate": "-0.000211",
            "bid1Price": "17222.00",
            "bid1Size": "220.358",
            "ask1Price": "17222.50",
            "ask1Size": "3.902"
        },
        "cs": 24988405605,
        "ts": 1673273043686
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws-public/trade.html b/copy-trade/ws-public/trade.html index 1dc78b54d2..c913c92600 100644 --- a/copy-trade/ws-public/trade.html +++ b/copy-trade/ws-public/trade.html @@ -4,14 +4,14 @@ Public Trade | Bybit API Documentation - +

    Public Trade

    Get recent public trades data in Bybit.

    info

    After subscription, you will be pushed delta trade message in real-time once there is an order filled.

    Push frequency: real-time

    Topic: publicTrade.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataarrayObject
    > TnumberThe timestamp (ms) that the order is filled
    > sstringSymbol name
    > SstringDirection of taker. Buy,Sell
    > vstringqty
    > pstringExecuted price
    > LstringDirection of price change
    > istringTrade id
    > BTbooleanBlock trade or not

    Request Example​

    {
        "op": "subscribe",
        "args": [
        "publicTrade.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    Response Example​

    {
        "topic": "publicTrade.BTCUSDT",
        "type": "snapshot",
        "ts": 1671181689023,
        "data": [
            {
                "T": 1671181689021,
                "s": "BTCUSDT",
                "S": "Buy",
                "v": "0.002",
                "p": "17032.50",
                "L": "MinusTick",
                "i": "d9cd8295-40dc-5dce-8deb-42882580a7ab",
                "BT": false
            }
        ]
    }
    - + \ No newline at end of file diff --git a/copy-trade/ws/connect.html b/copy-trade/ws/connect.html index ae505f86e3..b17e54f0a2 100644 --- a/copy-trade/ws/connect.html +++ b/copy-trade/ws/connect.html @@ -4,13 +4,13 @@ Connect | Bybit API Documentation - +

    Connect

    caution

    Note that currently Copy Trading only supports USDT perpetual and the following endpoints only apply to USDT Perpetual

    Base endpoints:

    • Testnet:
      • Public Channel: wss://stream-testnet.bybit.com/contract/usdt/public/v3
      • Private Channel: wss://stream-testnet.bybit.com/realtime_private
    • Mainnet:
      • Public Channel: wss://stream.bybit.com/contract/usdt/public/v3
      • Private Channel: wss://stream.bybit.com/realtime_private
    info
    Public channel do not require authentication. The following section applies to private channel only.

    Apply for authentication when establishing a connection.

    Note: if you're using pybit, bybit-api, or another high-level library, you can ignore this code - as authentication is handled for you.

    {
        "op": "auth",
        "args": [
            "api_key",
            1662350400000, //expires; is greater than your current timestamp
            "singature"
        ]
    }
    # based on: https://github.com/bybit-exchange/pybit/blob/master/pybit/_http_manager.py

    import hmac
    import json
    import time
    import websocket

    api_key = ""
    api_secret = ""

    # Generate expires.
    expires = int((time.time() + 1) * 1000)

    # Generate signature.
    signature = str(hmac.new(
        bytes(api_secret, "utf-8"),
        bytes(f"GET/realtime{expires}", "utf-8"), digestmod="sha256"
    ).hexdigest())

    ws = websocket.WebSocketApp(
        url=url,
        ...
    )

    # Authenticate with API.
    ws.send(
        json.dumps({
            "op": "auth",
            "args": [api_key, expires, signature]
        })
    )

    The response sample of authentication success

    {
        "success": true,
        "ret_msg": "",
        "conn_id": "16c79bf6-267d-4e06-a0c1-3ca4ed3a293d",
        "request": {
            "op": "auth",
            "args": [
                "OZUDHROKUZZNVZWHKN",
                "1673261297304",
                "63ae5f1064130d8e931b5d937500461b87c00b2a939284e455fe8ea1e27387f6"
            ]
        }
    }
    info

    Example signature algorithms can be found here.

    caution

    Due to network complexity, your may get disconnected at any time. Please follow the instructions below to ensure that you receive WebSocket messages on time:

    1. Keep connection alive by sending heartbeat packet
    2. Reconnect as soon as possible if disconnected

    IP Limits​

    • Do not frequently connect and disconnect the connection.
    • Do not build over 500 connections in 5 minutes. This is counted separately per WebSocket endpoint.

    How to Send Heartbeat Packet​

    How to Send

    ws.send('{"op":"ping"}');

    Pong response Example

    // Pong example of public channel
    {
        "success": true,
        "ret_msg": "pong",
        "conn_id": "13271fcb-53ed-4e80-948e-2bdbe3a6587d",
        "req_id": "",
        "op": "ping"
    }
    // Pong example of private channel
    {
        "success": true,
        "ret_msg": "pong",
        "conn_id": "16c79bf6-267d-4e06-a0c1-3ca4ed3a293d",
        "request": {
            "op": "ping",
            "args": null
        }
    }
    caution

    To avoid networks or program issues, we recommend that you send the ping heartbeat packet every 20 seconds to maintain the WebSocket connection.

    How to Subscribe to Topics​

    Understanding Websocket Filters​

    How to subscribe with a filter

    // Subscribing level 1 orderbook
    {
        "req_id": "test", // optional
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT"
        ]
    }

    Support subscribe multiple symbols and topics, separate with ','.

    // Example: Subscribing to the trade data for BTCUSDT and ETHUSDT
    {
        "req_id": "test", // optional
        "op": "subscribe",
        "args": [
            "publicTrade.BTCUSDT",
            "publicTrade.ETHUSDT"
        ]
    }

    After establishing the connection, you can subscribe to a new topic by sending a JSON request. The request formats are as follows:

    ws.send('{"op": "subscribe", "args": ["orderbook.1.BTCUSDT","publicTrade.BTCUSDT","orderbook.1.ETHUSDT]}')

    Understanding Websocket Filters unsubscription​

    After successful subscription, you can unsubscribe by sending a JSON request. The request formats are as follows:

    ws.send('{"op": "unsubscribe", "args": ["publicTrade.BTCUSDT"]}');
    {
        "op": "unsubscribe",
        "args": [
            "publicTrade.BTCUSDT"
        ]
    }

    Understanding Subscription Response​

    Subscription Response

    // Subscription response of public channel
    {
        "success": true,
        "ret_msg": "",
        "conn_id": "322b49ce-d6a5-494a-9019-f1d51cd541ae",
        "req_id": "",
        "op": "subscribe"
    }
    // Subscription response of private channel
    {
        "success": true,
        "ret_msg": "",
        "conn_id": "16c79bf6-267d-4e06-a0c1-3ca4ed3a293d",
        "request": {
            "op": "subscribe",
            "args": [
                "copyTradePosition",
                "copyTradeOrder",
                "copyTradeExecution"
            ]
        }
    }

    Once you subscribe successfully, you'd receive result information. You can determine whether the subscription is successful based on the response.

    - + \ No newline at end of file diff --git a/copytrade/public/instrument-info.html b/copytrade/public/instrument-info.html index 2f42ff01ee..6ee85b1e20 100644 --- a/copytrade/public/instrument-info.html +++ b/copytrade/public/instrument-info.html @@ -4,13 +4,13 @@ Instrument Info | Bybit API Documentation - +

    Instrument Info

    Get the spec of trading symbols

    tip

    This is public endpoint, so it does not need authentication

    HTTP Request​

    GET /contract/v3/public/copytrading/symbol/list

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > symbolstringsymbol
    > baseCurrencystringBase currency
    > quoteCurrencystringQuote currency
    > priceScalestringPrice scale (the number of decimal places to which a price can be submitted, although the final price may be rounded to conform to the tick_size)
    > takerFeestringTaker fee
    > makerFeestringMaker fee
    > fundingIntervalstringFunding fee interval
    > leverageFilterObjectLeverage attributes
    >> maxLeveragestringMax leverage (indicates the max leverage, assuming the lowest risk limit setting)
    >> minLeveragestringMin leverage
    > priceFilterObjectPrice attributes
    >> minPricestringMin price
    >> maxPricestringMax price
    >> tickSizestringTick size
    > lotSizeFilterObjectOrder attributes
    >> qtyStepstringQty step
    >> maxOrderQtystringMax trading quantity
    >> minOrderQtystringMin trading quantity

    Request Example​

    curl https://api-testnet.bybit.com/contract/v3/public/copytrading/symbol/list

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "baseCurrency": "BTC",
                    "quoteCurrency": "USDT",
                    "priceScale": "1",
                    "takerFee": "0.00075",
                    "makerFee": "-0.00025",
                    "fundingInterval": "480",
                    "leverageFilter": {
                        "maxLeverage": "100",
                        "minLeverage": "1"
                    },
                    "priceFilter": {
                        "minPrice": "0.5",
                        "maxPrice": "999999.0",
                        "tickSize": "0.5"
                    },
                    "lotSizeFilter": {
                        "qtyStep": "0.001",
                        "maxOrderQty": "100.000",
                        "minOrderQty": "0.001"
                    }
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/auto-margin.html b/derivatives/contract/auto-margin.html index 41cbed3cfd..b181787461 100644 --- a/derivatives/contract/auto-margin.html +++ b/derivatives/contract/auto-margin.html @@ -4,13 +4,13 @@ Set Auto Add Margin | Bybit API Documentation - +

    Set Auto Add Margin

    Turn on/off auto add position margin. To understand more, please read here

    tip

    This functionality only supports USDT Perpetual.

    HTTP Request​

    POST /contract/v3/private/position/set-auto-add-margin

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    sidetruestringSide. Buy,Sell
    autoAddMargintrueintegerTurn on/off auto add margin. 0: off. 1: on
    positionIdxtrueintegerPosition index

    Response Parameters​

    None

    Request Example​

    POST /contract/v3/private/position/set-auto-add-margin HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670826151188
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol": "ETHUSDT",
        "side": "Buy",
        "autoAddMargin": 1,
        "positionIdx": 1
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670826151500
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/cancel-all.html b/derivatives/contract/cancel-all.html index f250e631c3..06fe97f745 100644 --- a/derivatives/contract/cancel-all.html +++ b/derivatives/contract/cancel-all.html @@ -4,13 +4,13 @@ Cancel All Order | Bybit API Documentation - +

    Cancel All Order

    This endpoint enables to cancel all open orders.

    tip

    One of param baseCoin, settleCoin, symbol must be passed.

    HTTP Request​

    POST /contract/v3/private/order/cancel-all

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringSymbol name
    baseCoinfalsestringCancel all open orders by base coin
    settleCoinfalsestringCancel all open orders by settle coin

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> orderIdstringOrder id
    >> orderLinkIdstringUser customised order id

    Request Example​

    POST /contract/v3/private/order/cancel-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670571959925
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "settleCoin": "USDT",
        "symbol": null
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "4545cab5-0f98-45c4-b137-6c42f3b33d4a",
                    "orderLinkId": ""
                },
                {
                    "orderId": "66c1beaf-aadd-4b36-be37-7f80ec315422",
                    "orderLinkId": ""
                }
            ]
    },
        "retExtInfo": {},
        "time": 1670571961179
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/cancel.html b/derivatives/contract/cancel.html index ea20687283..ec5e708aeb 100644 --- a/derivatives/contract/cancel.html +++ b/derivatives/contract/cancel.html @@ -4,13 +4,13 @@ Cancel Order | Bybit API Documentation - +

    Cancel Order

    note

    You could cancel those unfilled or partially filled orders.

    HTTP Request​

    POST /contract/v3/private/order/cancel

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    orderIdfalsestringOrder id. Either orderId or orderLinkId is required
    orderLinkIdfalsestringUser customised order id. Either orderId or orderLinkId is required

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order id

    Request Example​

    POST /contract/v3/private/order/cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670570871662
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol": "BTCUSDT",
        "orderLinkId": null,
        "orderId": "a0c76874-1777-48dd-9f99-b4120ec71cc0"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "orderId": "a0c76874-1777-48dd-9f99-b4120ec71cc0",
        "orderLinkId": "xrp_12"
    },
        "retExtInfo": {},
        "time": 1670570872075
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/closepnl.html b/derivatives/contract/closepnl.html index e9de4aca0e..ffb0518192 100644 --- a/derivatives/contract/closepnl.html +++ b/derivatives/contract/closepnl.html @@ -4,13 +4,13 @@ Get Closed PnL | Bybit API Documentation - +

    Get Closed PnL

    Query user's closed profit and loss records. The results are sorted by updatedTime in descending order.

    info

    Support USDT Perpetual, Inverse Perpetual and Inverse Future

    Query time range:

    • Specify startTime and endTime, you can query up to 2 years records
    • Without startTime and endTime, it returns past 6 months records by default

    HTTP Request​

    GET /contract/v3/private/position/closed-pnl

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruetrueSymbol name
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed,the rule is endTime - startTime <= 7 days
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > symbolstringSymbol name
    > orderIdstringOrder Id
    > sidestringBuy, Side
    > qtystringOrder qty
    > leveragestringleverage
    > orderPricestringOrder price
    > orderTypestringOrder type. Market,Limit
    > execTypestringExec type
    > closedSizestringClosed size
    > cumEntryValuestringCumulated entry position value
    > avgEntryPricestringAverage entry price
    > cumExitValuestringCumulated exit position value
    > avgExitPricestringAverage exit price
    > closedPnlstringClosed PnL
    > fillCountstringThe number of fills in a single order
    > createdAtstringThe created time (ms), same as createdTime
    > createdTimestringThe created time (ms), same as createdAt
    > updatedTimestringThe updated time (ms)
    nextPageCursorstringCursor. Used to pagination

    Request Example​

    GET /contract/v3/private/position/closed-pnl?symbol=ETHUSDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670855140626
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "list": [
            {
                "symbol": "ETHUSDT",
                "orderId": "ee650123-74bf-4094-aadb-efa139d99c50",
                "side": "Buy",
                "qty": "0.30",
                "orderPrice": "1314.75",
                "orderType": "Market",
                "execType": "Trade",
                "closedSize": "0.30",
                "cumEntryValue": "373.71078947",
                "avgEntryPrice": "1245.7026",
                "cumExitValue": "375.532",
                "avgExitPrice": "1251.7734",
                "closedPnl": "-2.27050237",
                "fillCount": "2",
                "leverage": "50",
                "createdAt": "1670838034412",
                "createdTime": "1670838034412",
                "updatedTime": "1670838034450"
            }
        ],
        "nextPageCursor": "eyJza2lwX2xvY2FsX3N5bWJvbCI6ZmFsc2UsInBhZ2VfdG9rZW4iOiJleUpOSWpwN0lsOTFjM2N4WHlJNmV5SkNJam9pUVRnMlZFcEJSVWRCVVVVOUluMHNJbkJySWpwN0lrSWlPaUpLUjFac1RtcFZkMDFVU1hwTVZHTXdXVzFaZEU1RVFUVk9RekZvV1ZkU2FVeFhWbTFaVkVWNlQxZFJOVTlYVFRGTlFUMDlJbjBzSWw5emExOGlPbnNpUWlJNklrWjZRVU5XZGpWcVkyTXlSblJoTTJSQlp6MDlJbjE5ZlE9PSJ9"
    },
        "retExtInfo": {},
        "time": 1670855140831
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/confirm-mmr.html b/derivatives/contract/confirm-mmr.html index b88f88adb1..3c187547d1 100644 --- a/derivatives/contract/confirm-mmr.html +++ b/derivatives/contract/confirm-mmr.html @@ -4,7 +4,7 @@ Confirm New Risk Limit | Bybit API Documentation - + @@ -13,7 +13,7 @@ the Get Position Info interface). After the user actively adjusts the risk level, this interface is called to try to calculate the adjusted risk level, and if it passes (retCode=0), the system will remove the position reduceOnly mark. You are recommended to call Get Position Info to check isReduceOnly field.

    HTTP Request​

    POST /contract/v3/private/position/confirm-pending-mmr

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name

    Response Parameters​

    None

    Request Example​

    POST /contract/v3/private/position/confirm-pending-mmr HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1698051546759
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 32

    {

        "symbol": "BTCUSDT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1698051124588
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/cross-isolated.html b/derivatives/contract/cross-isolated.html index 294697282c..83c3ebce4a 100644 --- a/derivatives/contract/cross-isolated.html +++ b/derivatives/contract/cross-isolated.html @@ -4,13 +4,13 @@ Switch Cross/Isolated Margin | Bybit API Documentation - +

    Switch Cross/Isolated Margin

    Switch cross margin mode / isolated margin mode. To understand more, please read here

    info

    Support USDT Perpetual, Inverse Perpetual and Inverse Future.

    HTTP Request​

    POST /contract/v3/private/position/switch-isolated

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    tradeModetrueinteger0: cross margin. 1: isolated margin
    buyLeveragetruestringBuy side leverage. Make sure buyLeverage equals to sellLeverage
    sellLeveragetruestringSell side leverage. Make sure buyLeverage equals to sellLeverage

    Response Parameters​

    None

    Request Example​

    POST /contract/v3/private/position/switch-isolated HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670848559156
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"BTCUSDT",
        "tradeMode": 1,
        "buyLeverage": "8",
        "sellLeverage": "8"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670848559569
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/execution-list.html b/derivatives/contract/execution-list.html index 3f09f013d8..e7d7de4d87 100644 --- a/derivatives/contract/execution-list.html +++ b/derivatives/contract/execution-list.html @@ -4,13 +4,13 @@ Get Execution List | Bybit API Documentation - +

    Get Execution List

    Query users' execution list, sort by execTime in descending order. Support USDT Perpetual, Inverse Perpetual, Inverse Future, USDC Perpetual and USDC Option.

    Query time range:

    • USDT perp, Inverse perp, Inverse future: up to 2 years
    tip

    You may have multiple executions in a single order.

    HTTP Request​

    GET /contract/v3/private/execution/list

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    orderIdfalsestringOrder ID. Return all records if not passed
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed, the rule is endTime - startTime <= 7 days
    endTimefalseintegerThe end timestamp (ms)
    execTypefalsestringExecution type
    limitfalseintegerLimit for data size per page. [1, 100]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    nextPageCursorstringCursor. Used to pagination
    listarrayObject
    > symbolstringSymbol name
    > sidestringBuy,Sell
    > orderIdstringOrder id
    > orderLinkIdstringUser customised order id
    > orderPricestringOrder price
    > orderQtystringOrder qty
    > orderTypestringMarket,Limit
    > stopOrderTypestringStop order type
    > execIdstringTrade Id
    > execPricestringExecution price
    > execQtystringExecution qty
    > execFeestringExecution fee
    > execTypestringExecution type
    > execValuestringExecution position value
    > feeRatestringTrading fee rate
    > lastLiquidityIndstringAddedLiquidity, RemovedLiquidity
    > isMakerbooleanIs maker
    > leavesQtystringRemaining qty waiting for execution
    > closedSizestringClose size
    > ivstringImplied volatility
    > blockTradeIdstringBlock trade id
    > markPricestringMark price
    > indexPricestringIndex price
    > markIvstringMark iv
    > underlyingPricestringUnderlying price
    > execTimestringExecution timestamp (ms)

    Request Example​

    GET /contract/v3/private/execution/list?symbol=ETHUSDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670853954362
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "ETHUSDT",
                    "execFee": "-0.08720013",
                    "execId": "208751d8-f70e-4570-a5fd-d208c82af99d",
                    "execPrice": "1263.77",
                    "execQty": "0.69",
                    "execType": "Funding",
                    "execValue": "872.0013",
                    "feeRate": "-0.0001",
                    "lastLiquidityInd": "UNKNOWN",
                    "leavesQty": "0.00",
                    "orderId": "1673136000-ETHUSDT-592334-Sell",
                    "orderLinkId": "",
                    "orderPrice": "0.00",
                    "orderQty": "0.00",
                    "orderType": "UNKNOWN",
                    "stopOrderType": "UNKNOWN",
                    "side": "Sell",
                    "execTime": "1673136000000",
                    "closedSize": "0.00",
                    "iv": "",
                    "blockTradeId": "",
                    "markPrice": "",
                    "markIv": "",
                    "underlyingPrice": "",
                    "indexPrice": "",
                    "isMaker": false
                }
            ],
            "nextPageCursor": "ZzU3NlU4M1JlLzhFTWkzeW9hemRVcitqUk4wVW9LL21KVTRWV3JPR0tYTG9uTENWSkFvUDJuWk44OVBlNnB0ZjJHTTFwdlJRV0tpZFM0Z0RzUlQ0d2FSbzVRN2lpZ0ZrZmt2UTZuRlJVSHdQSHdoYXUvdDN6aExzOEpmcDNFY2NLc2dYTnRvOXhmTmY3NVNreVgzQ2RKUFZtekptU0NQNU1rOWd5YzZRV1ZDejVFM0t0MGdlMENNc04ybzQvc2JQQ3BVRkQycHU3MFdBK3RqdFlWaVRkMTNGQmZRUUZpaVc4MkE1SnRCT09iZDRNL2FlNDVSMithdU96NTROWGFxcTFucW1MSnJSaTluM29pZm85dHVkNzJMSVQwODk4UTJLbHEybDJ0Uk9UYmtCcU5ScU9zZWRCa2Znc0dwbmNEOWJoaCtnZkRkWjlrMEl6elRmWnljeHZpYXBPWVdzZSs0UEtvdnZ4cTJHQ2JZcm1UQkU3TXFKS01yU1dmaloyT3pVS1psbmVaamh3N3Ntc0hFbEgwckxtQT09",
            "category": ""
        },
        "retExtInfo": {},
        "time": 1673150404910
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/fee-rate.html b/derivatives/contract/fee-rate.html index bd721e87ea..e329e5d3b7 100644 --- a/derivatives/contract/fee-rate.html +++ b/derivatives/contract/fee-rate.html @@ -4,13 +4,13 @@ Get Trading Fee Rate | Bybit API Documentation - +

    Get Trading Fee Rate

    Get user trading fee rate.

    HTTP Request​

    GET /contract/v3/private/account/fee-rate

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringSymbol name

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > symbolstringSymbol name
    > takerFeeRatestringTaker fee rate
    > makerFeeRatestringMaker fee rate

    Request Example​

    GET /contract/v3/private/account/fee-rate?symbol=SOLUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670924049902
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "list": [
            {
                "symbol": "SOLUSDT",
                "takerFeeRate": "0.0006",
                "makerFeeRate": "0.0001"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1670924050413
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/leverage.html b/derivatives/contract/leverage.html index 7f711fe890..32ccb55606 100644 --- a/derivatives/contract/leverage.html +++ b/derivatives/contract/leverage.html @@ -4,13 +4,13 @@ Set Leverage | Bybit API Documentation - +

    Set Leverage

    Set the leverage.

    HTTP Request​

    POST /contract/v3/private/position/set-leverage

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    buyLeveragetruestring(0, max leverage of corresponding risk limit]. For one-way mode, make sure buyLeverage=sellLeverage
    sellLeveragetruestring(0, max leverage of corresponding risk limit]. For one-way mode, make sure buyLeverage=sellLeverage

    Response Parameters​

    None

    Request Example​

    POST /contract/v3/private/position/set-leverage HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670849911829
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"BTCUSD",
        "buyLeverage":"20",
        "sellLeverage":"20"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670849912024
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/open-order.html b/derivatives/contract/open-order.html index a50d193f1b..ef6c3da6bc 100644 --- a/derivatives/contract/open-order.html +++ b/derivatives/contract/open-order.html @@ -4,13 +4,13 @@ Get Open Orders | Bybit API Documentation - +

    Get Open Orders

    Query unfilled or partially filled orders in real-time.

    tip
    • At most 500 unfilled or partially filled orders will be returned if neither orderId nor orderLinkId is passed.
    • The records are sort by the createdTime from newest to oldest.

    HTTP Request​

    GET /contract/v3/private/order/unfilled-orders

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringSymbol name
    baseCoinfalsestringBase coin
    settleCoinfalsestringSettle coin. One of symbol,baseCoin and settleCoin is required. Priority: symbol > baseCoin > settleCoin
    orderIdfalsestringOrder id
    orderLinkIdfalsestringUser customised order id
    orderFilterfalsestringOrder: active order, StopOrder: conditional order
    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
    categorystringProduct type
    nextPageCursorstringCursor. Used to pagination
    listarraystring
    > symbolstringSymbol name
    > orderIdstringOrder id
    > orderLinkIdstringUser customised order id
    > sidestringSide. Buy,Sell
    > orderTypestringOrder type. Market,Limit. For TP/SL order, it means the order type after triggered
    > pricestringOrder price
    > ivstringImplied volatility. Not applicable for future
    > qtystringOrder qty
    > timeInForcestringTime in force
    > orderStatusstringOrder status
    > lastPriceOnCreatedstringLast price when create the order
    > createdTimestringCreated timestamp (ms)
    > updatedTimestringUpdated timestamp (ms)
    > cancelTypestringCancel type
    > stopOrderTypestringStop order type
    > triggerDirectionstring1: rise, 2: fall
    > triggerBystringThe trigger type of trigger price
    > triggerPricestringTrigger price
    > cumExecValuestringCumulative executed position value
    > cumExecFeestringCumulative trading fee
    > cumExecQtystringCumulative executed qty
    > leavesValuestringThe remaining value waiting to be traded
    > leavesQtystringThe remaining quantity waiting to be traded
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > tpslModestringTP/SL mode, Full: entire position for TP/SL. Partial: partial position tp/sl
    > tpLimitPricestringThe limit order price when take profit price is triggered
    > slLimitPricestringThe limit order price when stop loss price is triggered
    > tpTriggerBystringTrigger type of take profit
    > slTriggerBystringTrigger type of stop loss
    > reduceOnlybooleanReduce only. true means reduce position size
    > closeOnTriggerbooleanClose on trigger. What is a close on trigger order?
    > smpTypestringSMP execution type
    > smpGroupintegerSmp group ID. If the uid has no group, it is 0 by default
    > smpOrderIdstringThe counterparty's orderID which triggers this SMP execution

    Request Example​

    GET /contract/v3/private/order/unfilled-orders?symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670564324211
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "orderId": "806f5fc6-d487-46d1-9a57-4b4964126c90",
                    "side": "Buy",
                    "orderType": "Limit",
                    "stopOrderType": "UNKNOWN",
                    "price": "26864.40",
                    "qty": "0.003",
                    "timeInForce": "PostOnly",
                    "orderStatus": "New",
                    "triggerPrice": "0.00",
                    "orderLinkId": "YLxaWKMiHU",
                    "createdTime": "1684810640078",
                    "updatedTime": "1684810640080",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "triggerBy": "UNKNOWN",
                    "reduceOnly": false,
                    "leavesQty": "0.003",
                    "leavesValue": "80.5932",
                    "cumExecQty": "0.000",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "triggerDirection": 0,
                    "cancelType": "UNKNOWN",
                    "lastPriceOnCreated": "",
                    "iv": "",
                    "closeOnTrigger": false,
                    "tpslMode": "Full",
                    "tpLimitPrice": "",
                    "slLimitPrice": "",
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": ""
                }
            ],
            "nextPageCursor": "",
            "category": ""
        },
        "retExtInfo": {},
        "time": 1684810643363
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/order-list.html b/derivatives/contract/order-list.html index 3c55c946eb..f78c307eae 100644 --- a/derivatives/contract/order-list.html +++ b/derivatives/contract/order-list.html @@ -4,14 +4,14 @@ Get Order List | Bybit API Documentation - +

    Get Order List

    tip

    Query order list.
    As order creation/cancellation is asynchronous, the data returned from this endpoint may delay.

    HTTP Request​

    GET /contract/v3/private/order/list

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringSymbol name
    orderIdfalsestringOrder id
    orderLinkIdfalsestringUser customised order id
    orderStatusfalsestringOrder status. Return all status orders if not passed
    orderFilterfalsestringOrder,StopOrder
    limitfalsestringLimit 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
    categorystringProduct type
    nextPageCursorstringCursor. Used to pagination
    listlistObject
    > symbolstringSymbol name
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID.
    > sidestringBuy,Sell
    > orderTypestringOrder type. Market,Limit. For TP/SL order, it means the order type after triggered
    > pricestringOrder price
    > ivstringImplied volatility
    > qtystringOrder quantity
    > timeInForcestringTime in force
    > orderStatusstringOrder status
    > positionIdxintegerPosition index. 0: one-way mode, 1: buy side hedge mode, 2: sell side hedge mode
    > lastPriceOnCreatedstringLast price when place the order
    > createdTimestringOrder created timestamp (ms)
    > updatedTimestringOrder updated timestamp (ms)
    > cancelTypestringCancel type
    > rejectReasonstringReject reason
    > stopOrderTypestringStop order type
    > triggerDirectionstringTrigger direction. 1: rise, 2: fall
    > triggerBystringThe trigger type of trigger price
    > triggerPricestringTrigger price
    > cumExecValuestringCumulative executed order value
    > cumExecFeestringCumulative executed trading fee
    > cumExecQtystringCumulative executed order qty
    > leavesValuestringThe estimated value not executed
    > leavesQtystringThe remaining qty not executed
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > tpslModestringTP/SL mode, Full: entire position for TP/SL. Partial: partial position tp/sl
    > tpLimitPricestringThe limit order price when take profit price is triggered
    > slLimitPricestringThe limit order price when stop loss price is triggered
    > tpTriggerBystringThe price type to trigger take profit
    > slTriggerBystringThe price type to trigger stop loss
    > reduceOnlybooleanReduce only. true means reduce position size
    > closeOnTriggerbooleanClose on trigger. What is a close on trigger order?. Keeps "" for option
    > blockTradeIdstringParadigm block trade ID
    > smpTypestringSMP execution type
    > smpGroupintegerSmp group ID. If the uid has no group, it is 0 by default
    > smpOrderIdstringThe counterparty's orderID which triggers this SMP execution

    Request Example​

    GET /contract/v3/private/order/list?symbol=BTCUSDT&orderId=806f5fc6-d487-46d1-9a57-4b4964126c90 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673420679798
    X-BAPI-RECV-WINDOW: 5000
    cdn-request-id: test-10

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "side": "Buy",
                    "orderType": "Limit",
                    "price": "26864.40",
                    "qty": "0.003",
                    "reduceOnly": false,
                    "timeInForce": "PostOnly",
                    "orderStatus": "Cancelled",
                    "leavesQty": "0.000",
                    "leavesValue": "0",
                    "cumExecQty": "0.000",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "lastPriceOnCreated": "0.00",
                    "rejectReason": "EC_PerCancelRequest",
                    "orderLinkId": "YLxaWKMiHU",
                    "createdTime": "1684810640078",
                    "updatedTime": "1684810770380",
                    "orderId": "806f5fc6-d487-46d1-9a57-4b4964126c90",
                    "stopOrderType": "UNKNOWN",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "triggerPrice": "0.00",
                    "closeOnTrigger": false,
                    "triggerDirection": 0,
                    "positionIdx": 1,
                    "cancelType": "CancelByUser",
                    "iv": "",
                    "triggerBy": "UNKNOWN",
                    "blockTradeId": "",
                    "tpslMode": "Full",
                    "tpLimitPrice": "",
                    "slLimitPrice": "",
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": ""
                }
            ],
            "nextPageCursor": "eyJza2lwX2xvY2FsX3N5bWJvbCI6ZmFsc2UsInBhZ2VfdG9rZW4iOiIzOTQ3NCJ9",
            "category": ""
        },
        "retExtInfo": {},
        "time": 1684810802126
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/place-order.html b/derivatives/contract/place-order.html index 938ca941ee..fe58b06a28 100644 --- a/derivatives/contract/place-order.html +++ b/derivatives/contract/place-order.html @@ -4,7 +4,7 @@ Place Order | Bybit API Documentation - + @@ -20,7 +20,7 @@ ID to cancel active orders. Meanwhile, your customized order ID should be no longer than 36 characters and should be unique.

  • Each account can hold a maximum of 500 active orders simultaneously. This is contract-specific, so the following situation is allowed: The same account can hold 300 BTCUSD active orders and 280 ETHUSD active orders at the same time. When the upper limit of orders is reached, you can still place orders with parameters of reduceOnly or closeOnTrigger.

    • HTTP Request​

    POST /contract/v3/private/order/create

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    sidetruestringBuy,Sell
    orderTypetruestringMarket, Limit
    qtytruestringOrder quantity
    timeInForcetruestringRead more about Time in force.
    pricefalsestringOrder price. Invalid if orderType=Market
    triggerDirectionfalseintegerConditional order param. Used to identify the expected direction of the conditional order.
    • 1: triggered when market price rises to triggerPrice
    • 2: triggered when market price falls to triggerPrice
    triggerPricefalsestringConditional order param. If you expect the price to rise to trigger your conditional order, make sure:
    triggerPrice > market price
    Else, triggerPrice < market price
    triggerByfalsestringTrigger price type. default:LastPrice.
    positionIdxfalseintegerPosition index. It is required for hedge position mode
    orderLinkIdfalsestringUser customised order id. A max of 36 characters. Combinations of numbers, letters (upper and lower cases), dashes, and underscores are supported.
    rule of future:
    • optional param
    • The same orderLinkId can be used for both USDC PERP and USDT PERP.
    • An orderLinkId can be reused once the original order is either Filled or Cancelled
      • rule of option:
    • This param is required
    • always unique
    takeProfitfalsestringTake profit price
    stopLossfalsestringStop loss price
    tpTriggerByfalsestringThe price type to trigger take profit. default:LastPrice
    slTriggerByfalsestringThe price type to trigger stop loss. default:LastPrice
    reduceOnlyfalsebooleanWhat is a reduce-only order? true means your position can only reduce in size if this order is triggered. When reduce_only is true, take profit/stop loss cannot be set
    smpTypefalsestringSmp execution type. What is SMP?
    closeOnTriggerfalsebooleanWhat is a close on trigger order? For a closing order. It can only reduce your position, not increase it. If the account has insufficient available balance when the closing order is triggered, then other active orders of similar contracts will be cancelled or reduced. It can be used to ensure your stop loss reduces your position regardless of current available margin.
    tpslModefalsestringTP/SL mode
    • Full: entire position for TP/SL. Then, tpOrderType or slOrderType must be Market
    • Partial: partial position tp/sl. Limit TP/SL order are supported. Note: When create limit tp/sl, tpslMode is required and it must be Partial
    tpLimitPricefalsestringThe limit order price when take profit price is triggered. Only works when tpslMode=Partial and tpOrderType=Limit
    slLimitPricefalsestringThe limit order price when stop loss price is triggered. Only works when tpslMode=Partial and slOrderType=Limit
    tpOrderTypefalsestringThe order type when take profit is triggered. Market(default), Limit. For tpslMode=Full, it only supports tpOrderType=Market
    slOrderTypefalsestringThe order type when stop loss is triggered. Market(default), Limit. For tpslMode=Full, it only supports slOrderType=Market

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order id

    Request Example​

    POST /contract/v3/private/order/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670487164902
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json; charset=utf-8
    {
        "symbol": "BTCUSDT",
        "side": "Buy",
        "orderType": "Limit",
        "qty": "0.05",
        "price": "18500",
        "timeInForce": "GoodTillCancel",
        "positionIdx": null,
        "triggerDirection": 1,
        "triggerPrice": "19000"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "0cf62262-7dc2-4503-9566-8835c841509b",
            "orderLinkId": ""
        },
        "retExtInfo": {},
        "time": 1670486764551
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/position-list.html b/derivatives/contract/position-list.html index 54c01fec29..6ac883868f 100644 --- a/derivatives/contract/position-list.html +++ b/derivatives/contract/position-list.html @@ -4,13 +4,13 @@ My Position | Bybit API Documentation - +

    My Position

    Get real-time position data

    HTTP Request​

    GET /contract/v3/private/position/list

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringSymbol name
    settleCoinfalsestringSettle coin. Either symbol or settleCoin is required. symbol has a higher priority

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    nextPageCursorstringCursor. Used to pagination
    listarrayObject
    > symbolstringSymbol name
    > sidestringSide. Buy, Sell. Return None when zero position of one-way mode
    > sizestringPosition size
    > entryPricestringEntry price
    > leveragestringleverage
    > positionValuestringPosition value
    > positionIdxintegerPosition index
    > riskIdintegerRisk limit id
    > riskLimitValuestringPosition limit value corresponding to the risk id
    > tradeModeinteger0: cross margin mode. 1: isolated margin mode
    > autoAddMargininteger0: false. 1: true
    > positionBalancestringPosition margin
    > liqPricestringEstimated liquidation price. It returns value only when minPrice < liqPrice < maxPrice
    > bustPricestringEstimated bankruptcy price
    > tpSlModestringDepreciated, meaningless here, always "Full"
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > createdTimestringPosition created timestamp (ms)
    > updatedTimestringPosition data updated timestamp (ms)
    > trailingStopstringTrailing stop
    > activePricestringActivate price of trailing stop
    > markPricestringReal-time mark price
    > unrealisedPnlstringunrealised PNL
    > cumRealisedPnlstringcumulative realised PNL
    > positionMMstringPosition maintenance margin
    > positionIMstringPosition initial margin
    > positionStatusstringPosition status
    > sessionAvgPricestringSettlement price
    > occClosingFeestringPre-occupancy closing fee
    > adlRankIndicatorintegerAuto-deleverage rank indicator. What is Auto-Deleveraging?
    > isReduceOnlybooleanUseful when Bybit lower the risk limit
    • true: Only allowed to reduce the position. You can consider a series of measures, e.g., lower the risk limit, decrease leverage or reduce the position, add margin, or cancel orders, after these operations, you can call confirm new risk limit endpoint to check if your position can be removed the reduceOnly mark
    • false: There is no restriction, and it means your position is under the risk when the risk limit is systematically adjusted
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > mmrSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the MMR will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the MMR had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > leverageSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the leverage will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the leverage had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others

    Request Example​

    GET /contract/v3/private/position/list?symbol=ETCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673421074950
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "positionIdx": 0,
                    "riskId": 236,
                    "symbol": "ETCUSDT",
                    "side": "None",
                    "size": "0.0",
                    "positionValue": "0",
                    "entryPrice": "0",
                    "tradeMode": 0,
                    "autoAddMargin": 0,
                    "leverage": "10",
                    "positionBalance": "0",
                    "liqPrice": "",
                    "bustPrice": "0.000",
                    "takeProfit": "0.000",
                    "stopLoss": "0.000",
                    "trailingStop": "0.000",
                    "unrealisedPnl": "0",
                    "createdTime": "1672986751942",
                    "updatedTime": "1675382400091",
                    "tpSlMode": "Full",
                    "riskLimitValue": "200000",
                    "activePrice": "0.000",
                    "markPrice": "15.126",
                    "cumRealisedPnl": "-10.69094915",
                    "positionMM": "0",
                    "positionIM": "0",
                    "positionStatus": "Normal",
                    "sessionAvgPrice": "0.000",
                    "occClosingFee": "0",
                    "avgPrice": "0",
                    "adlRankIndicator": 0,
                    "isReduceOnly": false,
                    "mmrSysUpdatedTime": "",
                    "leverageSysUpdatedTime": ""
                }
            ],
            "category": "",
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1697685149803
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/position-mode.html b/derivatives/contract/position-mode.html index 4f640595d3..446f3af4a6 100644 --- a/derivatives/contract/position-mode.html +++ b/derivatives/contract/position-mode.html @@ -4,13 +4,13 @@ Switch Position Mode | Bybit API Documentation - +

    Switch Position Mode

    It supports to switch the position mode for USDT perpetual and Inverse futures. If you are in one-way Mode, you can only open one position on Buy or Sell side. If you are in hedge mode, you can open both Buy and Sell side positions simultaneously.

    tip
    • Priority for configuration to take effect: symbol > coin > system default
    • System default: one-way mode
    • If the request is by coin (settleCoin), then all symbols based on this setteCoin that do not have position and open order will be batch switched, and new listed symbol based on this settleCoin will be the same mode you set.

    Example​

    System defaultcoinsymbol
    Initial settingone-waynever configurednever configured
    ResultAll USDT perpetual trading pairs are one-way mode
    Change 1--Set BTCUSDT to hedge-mode
    ResultBTCUSDT becomes hedge-mode, and all other symbols keep one-way mode
    list new symbol ETHUSDTETHUSDT is one-way mode （inherit default rules）
    Change 2-Set USDT to hedge-mode-
    ResultAll current trading pairs with no positions or orders are hedge-mode, and no adjustments will be made for trading pairs with positions and orders
    list new symbol SOLUSDTSOLUSDT is hedge-mode (Inherit coin rule)
    Change 3--Set ASXUSDT to one-mode
    Take effect resultAXSUSDT is one-way mode, other trading pairs have no change
    list new symbol BITUSDTBITUSDT is hedge-mode (Inherit coin rule)

    The position-switch ability for each contract​

    Regular accountUnified margin account
    USDT perpetualSupport one-way & hedge-modeSupport one-way **only**
    USDC perpetualSupport one-way **only**Support one-way **only**
    Inverse perpetualSupport one-way **only**N/A
    Inverse future Support one-way & hedge-modeN/A

    HTTP Request​

    POST /contract/v3/private/position/switch-mode

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringSymbol name. Either symbol or coin is required. symbol has a higher priority
    coinfalsestringCoin
    modetrueintegerPosition mode. 0: Merged Single. 3: Both Side

    Response Parameters​

    ParameterTypeComments
    retCodeintegerSuccess/Error code
    retMsgstringSuccess/Error message
    resultObject
    retExtInfoObject
    timeintegerTimestamp

    Request Example​

    POST /contract/v3/private/position/switch-mode HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670848915553
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"CHZUSDT",
        "coin": null,
        "mode": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670848915768
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/replace-order.html b/derivatives/contract/replace-order.html index 052673cc21..a3b1f439fa 100644 --- a/derivatives/contract/replace-order.html +++ b/derivatives/contract/replace-order.html @@ -4,13 +4,13 @@ Replace Order | Bybit API Documentation - +

    Replace Order

    note

    You could modify those unfilled or partially filled orders.

    HTTP Request​

    POST /contract/v3/private/order/replace

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    orderIdfalsestringOrder id. Either orderId or orderLinkId is required
    orderLinkIdfalsestringUser customised order id. Either orderId or orderLinkId is required
    pricefalsestringOrder price after modification. Don't pass it if not modify the price
    qtyfalsestringOrder quantity after modification. Don't pass it if not modify the qty
    triggerPricefalsestringTrigger price. Don't pass it if not modify the qty
    takeProfitfalsestringTake profit price after modification. Don't pass it if not modify the take profit
    stopLossfalsestringStop loss price after modification. Don't pass it if not modify the Stop loss
    tpTriggerByfalsestringThe price type to trigger take profit. When set a take profit, this param is required if no initial value for the order
    slTriggerByfalsestringThe price type to trigger stop loss. When set a stop loss, this param is required if no initial value for the order
    triggerByfalsestringTrigger price type. LastPrice, IndexPrice, MarkPrice, LastPrice
    tpLimitPricefalsestringLimit order price when take profit is triggered. Only working when original order sets partial limit tp/sl
    slLimitPricefalsestringLimit order price when stop loss is triggered. Only working when original order sets partial limit tp/sl

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order id

    Request Example​

    POST /contract/v3/private/order/replace HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670554903846
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol": "XRPUSDT",
        "orderId": "5ba57394-0ff0-4cb8-8000-59085d2c3aba",
        "orderLinkId": null,
        "price": "14.5"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "5ba57394-0ff0-4cb8-8000-59085d2c3aba",
            "orderLinkId": ""
        },
        "retExtInfo": {},
        "time": 1670554904609
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/set-risk-limit.html b/derivatives/contract/set-risk-limit.html index 0b60d3b463..9988d6b7b4 100644 --- a/derivatives/contract/set-risk-limit.html +++ b/derivatives/contract/set-risk-limit.html @@ -4,13 +4,13 @@ Set Risk Limit | Bybit API Documentation - +

    Set Risk Limit

    Since bybit has launched auto risk limit on 12 March 2024, please click here to learn more, so it will not take effect even you set it successfully.

    HTTP Request​

    POST /contract/v3/private/position/set-risk-limit

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    riskIdtrueintegerRisk limit id
    positionIdxfalseintegerUsed to identify positions in different position modes. For hedge-mode, this param is required
    • 0: one-way mode
    • 1: hedge-mode Buy side
    • 2: hedge-mode Sell side

    Response Parameters​

    None

    Request Example​

    POST /contract/v3/private/position/set-risk-limit HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670853142896
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"ETHUSDT",
        "riskId": 12,
        "positionIdx": 1
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670853143027
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/tpsl-mode.html b/derivatives/contract/tpsl-mode.html index ad13cd472d..e282f8faca 100644 --- a/derivatives/contract/tpsl-mode.html +++ b/derivatives/contract/tpsl-mode.html @@ -4,7 +4,7 @@ Switch TP/SL Mode | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Switch TP/SL Mode

    tip

    To some extent, this endpoint is depreciated because now tpsl is based on order level. This API was used for position level change before.

    However, you still can use it to set an implicit tpsl mode for a certain symbol because when you don't pass "tpslMode" in the place order or trading stop request, system will get the tpslMode by the default setting.

    Adjust the take profit / stop loss mode. Full position or Partial position TP/SL.

    note

    Support USDT Perpetual, Inverse Perpetual and Inverse Future.

    HTTP Request​

    POST /contract/v3/private/position/switch-tpsl-mode

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    tpSlModetruestringFull: set TP/SL to full position. Partial: set TP/SL to partial mode

    Response Parameters​

    None

    Request Example​

    POST /contract/v3/private/position/switch-tpsl-mode HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670849702461
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"BTCUSDT",
        "tpSlMode":"Full"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670849702655
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/trading-stop.html b/derivatives/contract/trading-stop.html index ec463ec04b..608ce4e93f 100644 --- a/derivatives/contract/trading-stop.html +++ b/derivatives/contract/trading-stop.html @@ -4,7 +4,7 @@ Set Trading Stop | Bybit API Documentation - + @@ -13,7 +13,7 @@ on existing TP/SL orders on the holding position, it will cause the paired tp/sl orders to lose binding relationship. This means that when calling the cancel API through the tp/sl order ID, it will only cancel the corresponding one-sided take profit or stop loss order ID.

    HTTP Request​

    POST /contract/v3/private/position/trading-stop

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringSymbol name
    takeProfitfalsestringCannot be less than 0, 0 means cancel TP. Partial TP/SL cannot be cancelled by set it 0
    stopLossfalsestringCannot be less than 0, 0 means cancel SL. Partial TP/SL cannot be cancelled by set it 0
    tpslModefalsestringTP/SL mode. Full: entire position TP/SL, Partial: partial position TP/SL. As each contract has an initial full TP/SL mode, if it has been modified before, it may be partial. Therefore, if not provided, the system will automatically retrieve the current TP/SL mode configuration for the contract.
    tpSizefalsestringTake profit size. Valid in TP/SL partial mode only. Note: the value of tpSize and slSize must equal
    slSizefalsestringStop loss size. Valid in TP/SL partial mode only. Note: the value of tpSize and slSize must equal
    tpTriggerByfalsestringTake profit trigger price type. default: LastPrice
    slTriggerByfalsestringStop loss trigger price type. default: LastPrice
    trailingStopfalsestringCannot be less than 0, 0 means cancel TS
    activePricefalsestringTrailing stop trigger price. Trailing stop will be triggered when this price is reached only
    tpLimitPricefalsestringThe limit order price when take profit price is triggered. Only works when tpslMode=Partial and tpOrderType=Limit
    slLimitPricefalsestringThe limit order price when stop loss price is triggered. Only works when tpslMode=Partial and slOrderType=Limit
    tpOrderTypefalsestringThe order type when take profit is triggered. Market(default), Limit. For tpslMode=Full, it only supports tpOrderType=Market
    slOrderTypefalsestringThe order type when stop loss is triggered. Market(default), Limit. For tpslMode=Full, it only supports slOrderType=Market
    positionIdxfalsestringUsed to identify positions in different position modes. For hedge-mode, this param is required
    • 0: one-way mode
    • 1: hedge-mode Buy side
    • 2: hedge-mode Sell side

    Response Parameters​

    None

    Request Example​

    POST /contract/v3/private/position/trading-stop HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670852788387
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol": "SOLPERP",
        "takeProfit": "19",
        "stopLoss": "10",
        "activePrice": null,
        "trailingStop": null,
        "tpTriggerBy": null,
        "slTriggerBy": null,
        "tpslMode": "Partial",
        "tpOrderType": "Limit"
        "slOrderType": "Limit"
        "tpSize": "50",
        "slSize": "50",
        "tpLimitPrice": "18",
        "slLimitPrice": "11",
        "positionIdx": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670852788558
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/wallet-fund.html b/derivatives/contract/wallet-fund.html index 5e1e0c8ba5..e09f36feee 100644 --- a/derivatives/contract/wallet-fund.html +++ b/derivatives/contract/wallet-fund.html @@ -4,13 +4,13 @@ Get Wallet Fund Records | Bybit API Documentation - +

    Get Wallet Fund Records

    Get wallet fund records. This endpoint also shows exchanges from the Asset Exchange, where the types for the exchange are ExchangeOrderWithdraw and ExchangeOrderDeposit.

    tip
    • This endpoint returns incomplete information for transfers involving the derivatives wallet. Use the account asset API for creating and querying internal transfers.
    • Find more detail for types Withdraw and Refund in the Withdraw Records endpoint.
    • Deposit or withdrawal records which occurred after 2021-07-15 will not be shown by this endpoint. To fetch records after this date you should call the Query Deposit Recordsand Query Withdraw Records endpoint. This is due to the introduction of the spot wallet at this time.

    HTTP Request​

    GET /contract/v3/private/account/wallet/fund-records

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin
    walletFundTypefalsestringFund type
    startTimefalseintegerStart timestamp (ms)
    endTimefalseintegerEnd 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
    > coinstringCoin
    > typestringType
    > amountstringAmount
    > walletBalancestringWallet balance
    > execTimestringExecuted timestamp (ms)
    nextPageCursorstringCursor. Used to pagination

    Request Example​

    GET /contract/v3/private/account/wallet/fund-records?limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670931970500
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "list": [
            {
                "coin": "BTC",
                "type": "RealisedPNL",
                "amount": "-0.00003034",
                "walletBalance": "0.68146653",
                "execTime": "1665792000030"
            }
        ],
        "nextPageCursor": "K2tqR0xUQ1B1Tyt1a0ZFeVZRa1I2R2ZOT2pVekNKeGZPOTEyWFNpeXd1ejRmRTFoUkhabnVKVlRBNnFtZGk0dlBhRThLdFNHTGxFdWJGQVFMdXBnZ29Bb3JmSDlkczZHV1p1V1JoZmc2dnlRc1VMZ1ZVYlRXeW51ZUVBT3QycjlYSml3alNZampKTHdrdDJzSzFWdnlWK0djRklqczB1M0JYN04wVXltV0ljPQ=="
    },
        "retExtInfo": {},
        "time": 1670931971341
    }
    - + \ No newline at end of file diff --git a/derivatives/contract/wallet.html b/derivatives/contract/wallet.html index df6a63af6c..54e9f1db61 100644 --- a/derivatives/contract/wallet.html +++ b/derivatives/contract/wallet.html @@ -4,13 +4,13 @@ Wallet Balance | Bybit API Documentation - +

    Wallet Balance

    Get wallet balance, including Derivatives account and USDC account.

    HTTP Request​

    GET /contract/v3/private/account/wallet/balance

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin
    • Return all wallet info if not passed
    • Multiple coins are allowed, separated by comma, like USDT,USDC

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > coinstringCoin
    > equitystringTotal equity
    > walletBalancestringWallet balance
    > positionMarginstringPosition margin
    > availableBalancestringAvailable balance
    > orderMarginstringPre-occupied order margin
    > occClosingFeestringPosition closing fee occupied. formula: opening fee + expected maximum closing fee
    > occFundingFeestringPre-occupied funding fee
    > unrealisedPnlstringUnrealised pnl
    > cumRealisedPnlstringCumulative realised pnl (all-time)
    > givenCashstringTrial fund. Find out more here
    > serviceCashstringCoupon. Find out more here
    > accountIMstringUSDC account initial margin
    > accountMMstringUSDC account maintenance margin

    Request Example​

    GET /contract/v3/private/account/wallet/balance?coin=USDC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670923630734
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "list": [
            {
                "coin": "USDC",
                "equity": "1259.7788251",
                "walletBalance": "1259.7488251",
                "positionMargin": "1259.7788251",
                "availableBalance": "1246.7387871",
                "orderMargin": "0",
                "occClosingFee": "0",
                "occFundingFee": "0",
                "unrealisedPnl": "0.03",
                "cumRealisedPnl": "26.6561752",
                "givenCash": "0",
                "serviceCash": "0",
                "accountIM": "13.040038",
                "accountMM": "1.367038"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1670923631261
    }
    - + \ No newline at end of file diff --git a/derivatives/enum.html b/derivatives/enum.html index 6923caa6ee..9ac9e0ed35 100644 --- a/derivatives/enum.html +++ b/derivatives/enum.html @@ -4,13 +4,13 @@ Enums Definitions | Bybit API Documentation - +

    Enums Definitions

    category​

    Contract

    • linear Linear Contract, including USDT Perpetual
    • inverse Inverse Contract, including Inverse Perpetual, Inverse Futures

    Unified Margin

    • linear Linear Contract, including USDT Perpetual, USDC Perpetual
    • option

    symbol​

    USDT Perpetual:

    • BTCUSDT
    • ETHUSDT

    USDC Perpetual:

    • BTCPERP
    • ETHPERP

    Inverse Perpetual:

    • BTCUSD
    • ETHUSD

    Inverse Futures:

    • BTCUSDH23 H: First quarter; 23: 2023
    • BTCUSDM23 M: Second quarter; 23: 2023
    • BTCUSDU23 U: Third quarter; 23: 2023
    • BTCUSDZ23 Z: Fourth quarter; 23: 2023

    positionIdx​

    • 0 one-way mode
    • 1 Buy side of hedge-mode
    • 2 Sell side of hedge-mode

    positionStatus​

    • Normal
    • Liq in the liquidation progress
    • Adl in the auto-deleverage progress

    interval​

    • 1 3 5 15 30 60 120 240 360 720 minute
    • D day
    • W week
    • M month

    triggerBy​

    • LastPrice
    • MarkPrice
    • IndexPrice

    timeInForce​

    • GoodTillCancel
    • ImmediateOrCancel
    • FillOrKlii
    • PostOnly

    orderFilter​

    • Order active order
    • StopOrder conditional order

    orderStatus​

    • Created
    • New
    • Rejected
    • PartiallyFilled
    • Filled
    • PendingCancel
    • Cancelled
    • Untriggered
    • Triggered
    • Deactivated
    • Active

    cancelType​

    • CancelByUser
    • CancelByReduceOnly
    • CancelByPrepareLiq CancelAllBeforeLiq
    • CancelByPrepareAdl CancelAllBeforeAdl
    • CancelByAdmin
    • CancelByTpSlTsClear
    • CancelBySmp

    Options:

    • CancelByUser
    • CancelByReduceOnly
    • CancelAllBeforeLiq Cancelled due to liquidation
    • CancelAllBeforeAdl Cancelled due to ADL
    • CancelBySettle
    • CancelByCannotAffordOrderCost
    • CancelByPmTrialMmOverEquity
    • CancelByAccountBlocking
    • CancelByDelivery
    • CancelByMmpTriggered
    • CancelByCrossSelfMuch
    • CancelByCrossReachMaxTradeNum
    • CancelByDCP

    stopOrderType​

    • TakeProfit
    • StopLoss
    • TrailingStop
    • Stop
    • PartialTakeProfit
    • PartialStopLoss

    rejectReason​

    • EC_NoError
    • EC_Others
    • EC_UnknownMessageType
    • EC_MissingClOrdID
    • EC_MissingOrigClOrdID
    • EC_ClOrdIDOrigClOrdIDAreTheSame
    • EC_DuplicatedClOrdID
    • EC_OrigClOrdIDDoesNotExist
    • EC_TooLateToCancel
    • EC_UnknownOrderType
    • EC_UnknownSide
    • EC_UnknownTimeInForce
    • EC_WronglyRouted
    • EC_MarketOrderPriceIsNotZero
    • EC_LimitOrderInvalidPrice
    • EC_NoEnoughQtyToFill
    • EC_NoImmediateQtyToFill
    • EC_PerCancelRequest
    • EC_MarketOrderCannotBePostOnly
    • EC_PostOnlyWillTakeLiquidity
    • EC_CancelReplaceOrder
    • EC_InvalidSymbolStatus

    positionMode​

    • 0 One-Way Mode
    • 3 Hedge Mode

    execType​

    lastLiquidityInd​

    Unified Margin

    • TAKER
    • MAKER

    Contract

    • AddedLiquidity add liquidity
    • RemovedLiquidity take liquidity

    walletFundType​

    • Deposit
    • Withdraw
    • RealisedPNL
    • Commission
    • Refund
    • Prize
    • ExchangeOrderWithdraw
    • ExchangeOrderDeposit
    • ReturnServiceCash Refund of handling fee bonus
    • Insurance Insurance account transfer
    • SubMember Main-Sub account transfer
    • Coupon Coupon interest
    • AccountTransfer Account transfer
    • CashBack Cash back

    type​

    • TRANSFER_IN
    • TRANSFER_OUT
    • TRADE
    • SETTLEMENT
    • DELIVERY
    • LIQUIDATION
    • BONUS
    • FEE_REFUND
    • INTEREST
    • CURRENCY_BUY
    • CURRENCY_SELL

    adlRankIndicator​

    • 0 default value of empty position
    • 1
    • 2
    • 3
    • 4
    • 5

    tickDirection​

    It indicates price fluctuation relative to the last trade.

    • PlusTick price rise
    • ZeroPlusTick trade occurs at the same price as the previous trade, which occurred at a price higher than that for the trade preceding it
    • MinusTick price drop
    • ZeroMinusTick trade occurs at the same price as the previous trade, which occurred at a price lower than that for the trade preceding it

    smpType​

    • default: None
    • CancelMaker
    • CancelTaker
    • CancelBoth

    unifiedMarginStatus​

    • 1 Regular account
    • 2 Unified margin account, it only trades linear perpetual and options.
    • 3 Unified trade account, it can trade linear perpetual, options and spot
    - + \ No newline at end of file diff --git a/derivatives/error.html b/derivatives/error.html index 5dca08bc21..1c31bf3ddc 100644 --- a/derivatives/error.html +++ b/derivatives/error.html @@ -4,13 +4,13 @@ Error Code | Bybit API Documentation - +

    Error Code

    Unified Margin​

    CodeDescription
    10000Server Timeout
    10001params error
    10002Invalid request, please check your timestamp and recv_window param
    10003Invalid api_key
    10004Error sign
    10005Permission denied
    10006Too many visits
    10008User had been banned. Please check your account mode
    10009IP had been banned
    10010unmatched IP
    10014Request is duplicate
    10016Server Error
    10018Out of frequency limit of IP
    10024Compliance rules triggered
    10027Trading Banned
    110001Order does not exist
    110003Order price is out of permissible range
    110004Insufficient wallet balance
    110005position status
    110006cannot afford estimated position_margin
    110007Insufficient available balance
    110008Order has been finished or canceled
    110009The number of stop orders exceeds maximum limit allowed
    110010Order already cancelled
    110011Any adjustments made will trigger immediate liquidation
    110012Available balance not enough
    110013Due to risk limit, cannot set leverage
    110014Available balance not enough to add margin
    110015the position is in cross_margin
    110016Requested quantity of contracts exceeds risk limit, please adjust your risk limit level before trying again
    110017Reduce-only rule not satisfied
    110018userId illegal
    110019orderId illegal
    110020number of active orders greater than 500
    110021Open Interest exceeded
    110022qty has been limited, cannot modify the order to add qty
    110023This contract only supports position reduction operation, please contact customer service for details
    110024You have an existing position, so position mode cannot be switched
    110025Position mode is not modified
    110026Cross/isolated margin mode is not modified
    110027Margin is not modified
    110028Open orders exist, so you cannot change position mode
    110029Hedge mode is not available for this symbol
    110030Duplicate orderId
    110031risk limit info does not exists
    110032Illegal order
    110033Margin cannot be set without open position
    110034There is no net position
    110035Cancel order is not completed before liquidation
    110036Cross margin mode is not allowed to change leverage
    110037User setting list does not have this symbol
    110038Portfolio margin mode is not allowed to change leverage
    110039Maintain margin rate is too high, which may trigger liquidation
    110040Order will trigger forced liquidation, please resubmit the order
    110041Skip liquidation is not allowed when a position or maker order exists
    110042Pre-delivery status can only reduce positions
    110043Set leverage not modified
    110044Insufficient available margin
    110045Insufficient wallet balance
    110046Any adjustments made will trigger immediate liquidation
    110047Risk limit cannot be adjusted due to insufficient available margin
    110048Risk limit cannot be adjusted as the current/expected position value held exceeds the revised risk limit
    110049Tick notes can only be numbers
    110050Coin is not in the range of selected
    110051The user's available balance cannot cover the lowest price of the current market
    110052User's available balance is insufficient to set a price
    110053The user's available balance cannot cover the current market price and upper limit price
    110054This position has at least one take profit link order, so the take profit and stop loss mode cannot be switched
    110055This position has at least one stop loss link order, so the take profit and stop loss mode cannot be switched
    110056This position has at least one trailing stop link order, so the take profit and stop loss mode cannot be switched
    110057Conditional order or limit order contains TP/SL related params
    110058Insufficient number of remaining position size to set take profit and stop loss
    110059In the case of partial filled of the open order, it is not allowed to modify the take profit and stop loss settings of the open order
    110060Under full TP/SL mode, it is not allowed to modify TP/SL
    110061Under partial TP/SL mode, TP/SL set more than 20
    110062Institution MMP profile not found.
    110063Settlement in progress! {{key0}} not available for trades.
    110064The number of contracts modified cannot be less than or equal to the filled quantity
    110065MMP hasn't yet been enabled for your account. Please contact your BD manager.
    110066No trading is allowed at the current time
    110067unified account is not support
    110068Leveraged user trading is not allowed
    110069Do not allow OTC lending users to trade
    110070ETP symbols are not allowed to be traded

    Contract​

    CodeDescription
    10000Server Timeout
    10001params error
    10002Invalid request, please check your timestamp and recv_window param
    10003Invalid api_key
    10004Error sign
    10005Permission denied
    10006Too many visits
    10008User had been banned. Please check your account mode
    10009IP had been banned
    10010unmatched IP
    10014Request is duplicate
    10016Server Error
    10018Out of frequency limit of IP
    10027Trading Banned
    140001Order does not exist
    140003Order price is out of permissible range
    140004Insufficient wallet balance
    140005position status
    140006cannot afford estimated position_margin
    140007Insufficient available balance
    140008Order has been finished or canceled
    140009The number of stop orders exceeds maximum limit allowed
    140010Order already cancelled
    140011Any adjustments made will trigger immediate liquidation
    140012Available balance not enough
    140013Due to risk limit, cannot set leverage
    140014Available balance not enough to add margin
    140015the position is in cross_margin
    140016Requested quantity of contracts exceeds risk limit, please adjust your risk limit level before trying again
    140017Reduce-only rule not satisfied
    140018userId illegal
    140019orderId illegal
    140020number of active orders greater than 500
    140021Open Interest exceeded
    140022qty has been limited, cannot modify the order to add qty
    140023This contract only supports position reduction operation, please contact customer service for details
    140024You have an existing position, so position mode cannot be switched
    140025Position mode is not modified
    140026Cross/isolated margin mode is not modified
    140027Margin is not modified
    140028Open orders exist, so you cannot change position mode
    140029Hedge mode is not available for this symbol
    140030Duplicate orderId
    140031risk limit info does not exists
    140032Illegal order
    140033Margin cannot be set without open position
    140034There is no net position
    140035Cancel order is not completed before liquidation
    140036Cross margin mode is not allowed to change leverage
    140037User setting list does not have this symbol
    140038Portfolio margin mode is not allowed to change leverage
    140039Maintain margin rate is too high, which may trigger liquidation
    140040Order will trigger forced liquidation, please resubmit the order
    140041Skip liquidation is not allowed when a position or maker order exists
    140042Pre-delivery status can only reduce positions
    140043Set leverage not modified
    140044Insufficient available margin
    140045Insufficient wallet balance
    140046Any adjustments made will trigger immediate liquidation
    140047Risk limit cannot be adjusted due to insufficient available margin
    140048Risk limit cannot be adjusted as the current/expected position value held exceeds the revised risk limit
    140049Tick notes can only be numbers
    140050Coin is not in the range of selected
    140051The user's available balance cannot cover the lowest price of the current market
    140052User's available balance is insufficient to set a price
    140053The user's available balance cannot cover the current market price and upper limit price
    140054This position has at least one take profit link order, so the take profit and stop loss mode cannot be switched
    140055This position has at least one stop loss link order, so the take profit and stop loss mode cannot be switched
    140056This position has at least one trailing stop link order, so the take profit and stop loss mode cannot be switched
    140057Conditional order or limit order contains TP/SL related params
    140058Insufficient number of remaining position size to set take profit and stop loss
    140059In the case of partial filled of the open order, it is not allowed to modify the take profit and stop loss settings of the open order
    140060Under full TP/SL mode, it is not allowed to modify TP/SL
    140061Under partial TP/SL mode, TP/SL set more than 20
    140062Institution MMP profile not found.
    140063Settlement in progress! {{key0}} not available for trades.
    140064The number of contracts modified cannot be less than or equal to the filled quantity
    140065MMP hasn't yet been enabled for your account. Please contact your BD manager.
    140066No trading is allowed at the current time
    140067unified account is not support
    140068Leveraged user trading is not allowed
    140069Do not allow OTC lending users to trade
    140070ETP symbols are not allowed to be traded
    140071RiskId not modified
    3400045Set margin mode failed
    340099Server error
    - + \ No newline at end of file diff --git a/derivatives/public/funding-rate.html b/derivatives/public/funding-rate.html index 16098af01d..120f92ace3 100644 --- a/derivatives/public/funding-rate.html +++ b/derivatives/public/funding-rate.html @@ -4,13 +4,13 @@ Funding Rate History | Bybit API Documentation - +

    Funding Rate History

    Get historical funding rate

    tip
    • Passing startTime only, it returns error.
    • Passing endTime only, it returns 200 records till endTime.
    • Both are not passed, it returns 200 records till current time.

    HTTP Request​

    GET /derivatives/v3/public/funding/history-funding-rate

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse. Default: linear, but in the response category shows ""
    symboltruestringSymbol name
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 200

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type. Keeps empty string "" when category is not passed
    listarrayObject
    > symbolstringSymbol name
    > fundingRatestringFunding rate
    > fundingRateTimestampstringFunding rate timestamp(ms)

    Request Example​

    GET /derivatives/v3/public/funding/history-funding-rate?symbol=BTCPERP&limit=2 HTTP/1.1
    Host: api.bybit.com​​

    Response Example​

        {
            "retCode": 0,
            "retMsg": "OK",
            "result": {
                "category": "",
                "list": [
                    {
                        "symbol": "BTCPERP",
                        "fundingRate": "0.0001",
                        "fundingRateTimestamp": "1671955200000"
                    },
                    {
                        "symbol": "BTCPERP",
                        "fundingRate": "0.0001",
                        "fundingRateTimestamp": "1671926400000"
                    }
                ]
        },
            "retExtInfo": {},
            "time": 1671970750651
        }
    - + \ No newline at end of file diff --git a/derivatives/public/index-kline.html b/derivatives/public/index-kline.html index 2c49a86695..2760b353f9 100644 --- a/derivatives/public/index-kline.html +++ b/derivatives/public/index-kline.html @@ -4,13 +4,13 @@ Index Price Kline | Bybit API Documentation - +

    Index Price Kline

    Get index price kline data

    HTTP Request​

    GET /derivatives/v3/public/index-price-kline

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse. Default: linear, but in the response category shows ""
    symboltruestringSymbol name
    intervaltruestringKline interval. 1 3 5 15 30 60 120 240 360 720 D M W
    starttrueintegerThe start timestamp (ms)
    endtrueintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters​

    ParameterTypeComments
    symbolstringSymbol name
    categorystringProduct type. Keeps empty string "" when category is not passed
    listarray
    • An string array of individual candle
    • Sort in reverse by start
    • The default collation within the array is start, open, high, low, close

    Request Example​

    GET /derivatives/v3/public/index-price-kline?category=linear&symbol=BTCUSDT&interval=60&start=1668441600000&end=1668528000000&limit=2 HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "symbol": "BTCUSDT",
        "category": "linear",
        "list": [
            [
                "1668445200000",
                "16471.28",
                "16619.57",
                "16445.28",
                "16584.01"
            ],
            [
                "1668441600000",
                "16594.06",
                "16624.76",
                "16358",
                "16471.28"
            ]
        ]
    },
        "retExtInfo": {},
        "time": 1671968874797
    }
    - + \ No newline at end of file diff --git a/derivatives/public/instrument-info.html b/derivatives/public/instrument-info.html index 26206e6072..5e0eef7aba 100644 --- a/derivatives/public/instrument-info.html +++ b/derivatives/public/instrument-info.html @@ -4,13 +4,13 @@ Instrument Info | Bybit API Documentation - +

    Instrument Info

    Get launched instruments information.

    HTTP Request​

    GET /derivatives/v3/public/instruments-info

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse,option. Default: returns futures
    symbolfalsestringSymbol name.
    • query an option symbol, category is required
    baseCoinfalsestringBase coin.
    • Valid when category=option
    • BTC by default if not passed
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 500
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringDerivatives products category. Keeps empty string `""` when `category` is not passed
    listarrayObject
    > symbolstringSymbol name
    > contractTypestringContract type. `LinearPerpetual`, `InversePerpetual`, `InverseFutures`
    > statusstringSymbol status
    > baseCoinstringBase coin. e.g BTCUSDT, BTC is base coin
    > quoteCoinstringQuote coin. e.g BTCPERP, USDC is quote coin
    > settleCoinstringSettle coin. e.g BTCUSD, BTC is settle coin
    > launchTimestringThe launch timestamp (ms)
    > deliveryTimestringThe delivery timestamp (ms). "0" for perpetual
    > deliveryFeeRatestringThe delivery fee rate
    > priceScalestringPrice scale
    > leverageFilterObject
    >> minLeveragestringMin. leverage
    >> maxLeveragestringMax. leverage
    >> leverageStepstringThe min step to modify leverage
    > priceFilterObject
    >> minPricestringMin. order price
    >> maxPricestringMax. order price
    >> tickSizestringTick size
    > lotSizeFilterObject
    >> minNotionalValuestringMinimum notional value
    >> maxOrderQtystringMax. trade quantity per order
    >> minOrderQtystringMin. trade quantity per order
    >> qtyStepstringMin. order quantity increment
    >> maxMktOrderQtystringMaximum quantity for Market order
    >> postOnlyMaxOrderQtystringDepreciated, please use maxOrderQty
    > unifiedMarginTradebooleanSupport unified margin trade or not
    > fundingIntervalintegerFunding interval (minute)
    nextPageCursorstringThe cursor used to pagination

    Request Example​

    GET /derivatives/v3/public/instruments-info?symbol=BTCPERP&category=linear HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "category": "linear",
        "list": [
            {
                "symbol": "BTCPERP",
                "contractType": "LinearPerpetual",
                "status": "Trading",
                "baseCoin": "BTC",
                "quoteCoin": "USD",
                "launchTime": "1610604231000",
                "deliveryTime": "0",
                "deliveryFeeRate": "",
                "priceScale": "2",
                "leverageFilter": {
                    "minLeverage": "1",
                    "maxLeverage": "125.00",
                    "leverageStep": "0.01"
            },
                "priceFilter": {
                    "minPrice": "0.50",
                    "maxPrice": "999999.00",
                    "tickSize": "0.50"
            },
                "lotSizeFilter": {
                    "maxTradingQty": "20.000",
                    "minTradingQty": "0.001",
                    "qtyStep": "0.001",
                    "postOnlyMaxOrderQty": "100.000",
                    "maxOrderQty": "20.000",
                    "minOrderQty": "0.001",
                    "minNotionalValue": "5"
            },
                "unifiedMarginTrade": true,
                "fundingInterval": 480,
                "settleCoin": "USDC"
            }
        ],
        "nextPageCursor": ""
    },
        "retExtInfo": {},
        "time": 1671969788515
    }
    - + \ No newline at end of file diff --git a/derivatives/public/kline.html b/derivatives/public/kline.html index f75276d7a3..ecdfe9e284 100644 --- a/derivatives/public/kline.html +++ b/derivatives/public/kline.html @@ -4,13 +4,13 @@ Kline | Bybit API Documentation - +

    Kline

    Get kline data

    HTTP Request​

    GET /derivatives/v3/public/kline

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse. Default: linear, but in the response category shows ""
    symboltruestringSymbol name
    intervaltruestringKline interval. 1 3 5 15 30 60 120 240 360 720 D M W
    starttrueintegerThe start timestamp (ms)
    endtrueintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters​

    ParameterTypeComments
    symbolstringSymbol name
    categorystringProduct type. Keeps empty string "" when category is not passed
    listarray
    • An string array of individual candle
    • Sort in reverse by start
    • The default collation within the array is start, open, high, low, close, volume, turnover

    Request Example​

    GET /derivatives/v3/public/kline?category=linear&symbol=BTCPERP&interval=1&start=1670371140000&end=1670371200000 HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "symbol": "BTCPERP",
        "category": "linear",
        "list": [
            [
                "1670371200000",
                "17077",
                "17084",
                "17077",
                "17084",
                "0.017",
                "290.412"
            ],
            [
                "1670371140000",
                "17074",
                "17077.5",
                "17074",
                "17077",
                "0.006",
                "102.457"
            ]
        ]
    },
        "retExtInfo": {},
        "time": 1671968612436
    }
    - + \ No newline at end of file diff --git a/derivatives/public/long-short-ratio.html b/derivatives/public/long-short-ratio.html index 20ae25a778..6c2519c9f5 100644 --- a/derivatives/public/long-short-ratio.html +++ b/derivatives/public/long-short-ratio.html @@ -4,13 +4,13 @@ Get Long Short Ratio | Bybit API Documentation - +

    Get Long Short Ratio

    HTTP Request​

    GET /derivatives/v3/public/account-ratio

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear(USDT Perpetual only),inverse
    symboltruestringSymbol name
    periodtruestringData recording period. 5min, 15min, 30min, 1h, 4h, 4d
    limitfalseintegerLimit for data size per page. [1, 500]. Default: 50

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > symbolstringSymbol name
    > buyRatiostringThe ratio of users with net long position
    > sellRatiostringThe ratio of users with net short position
    > timestampstringTimestamp (ms)

    Request Example​

    GET /derivatives/v3/public/account-ratio?category=linear&symbol=BTCUSDT&period=1d&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "buyRatio": "0.5777",
                    "sellRatio": "0.4223",
                    "timestamp": "1695772800000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1695785131028
    }
    - + \ No newline at end of file diff --git a/derivatives/public/mark-kline.html b/derivatives/public/mark-kline.html index 9d4da98871..8cae09a8f5 100644 --- a/derivatives/public/mark-kline.html +++ b/derivatives/public/mark-kline.html @@ -4,13 +4,13 @@ Mark Price Kline | Bybit API Documentation - +

    Mark Price Kline

    Get mark price kline data

    HTTP Request​

    GET /derivatives/v3/public/mark-price-kline

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse. Default: linear, but in the response category shows ""
    symboltruestringSymbol name
    intervaltruestringKline interval. 1 3 5 15 30 60 120 240 360 720 D M W
    starttrueintegerThe start timestamp (ms)
    endtrueintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters​

    ParameterTypeComments
    symbolstringSymbol name
    categorystringProduct type. Keeps empty string "" when category is not passed
    listarray
    • An string array of individual candle
    • Sort in reverse by start
    • The default collation within the array is start, open, high, low, close

    Request Example​

    GET /derivatives/v3/public/mark-price-kline?symbol=BTCUSD&interval=1&start=1670261100000&end=1670261280000&category=inverse HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "symbol": "BTCUSD",
        "category": "inverse",
        "list": [
            [
                "1670261280000",
                "17064.76",
                "17068.45",
                "17063.5",
                "17067"
            ],
            [
                "1670261220000",
                "17062.5",
                "17064.88",
                "17062.5",
                "17064.76"
            ],
            [
                "1670261160000",
                "17064",
                "17064",
                "17062.5",
                "17062.5"
            ],
            [
                "1670261100000",
                "17072",
                "17072",
                "17064",
                "17064"
            ]
        ]
    },
        "retExtInfo": {},
        "time": 1671968706092
    }
    - + \ No newline at end of file diff --git a/derivatives/public/open-interest.html b/derivatives/public/open-interest.html index ebb921e93d..3a9f321dc7 100644 --- a/derivatives/public/open-interest.html +++ b/derivatives/public/open-interest.html @@ -4,13 +4,13 @@ Open Interest | Bybit API Documentation - +

    Open Interest

    Get open interest of each symbol in Bybit

    info
    • Returns single side data
    • The upper limit time you can query is the launch time of the symbol.

    HTTP Request​

    GET /derivatives/v3/public/open-interest

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse. Default: linear, but in the response category shows ""
    symboltruestringSymbol name
    intervaltruestringInterval. 5min 15min 30min 1h 4h 1d
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    symbolstringSymbol name
    categorystringProduct type. Keeps empty string "" when category is not passed
    listarrayObject
    > openIntereststringOpen interest
    > timestampstringThe timestamp (ms)
    nextPageCursorstringThe cursor used to pagination

    Request Example​

    GET /derivatives/v3/public/open-interest?category=linear&symbol=ETHUSDT&interval=5min&limit=2 HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "ETHUSDT",
            "category": "linear",
            "list": [
                {
                    "openInterest": "411496.22000000",
                    "timestamp": "1677832800000"
                },
                {
                    "openInterest": "411484.61000000",
                    "timestamp": "1677832500000"
                }
            ],
            "nextPageCursor": "lastid%3D44487872"
        },
        "retExtInfo": {},
        "time": 1677832955976
    }
    - + \ No newline at end of file diff --git a/derivatives/public/option-delivery.html b/derivatives/public/option-delivery.html index 67aba62c38..dff6ed8318 100644 --- a/derivatives/public/option-delivery.html +++ b/derivatives/public/option-delivery.html @@ -4,13 +4,13 @@ Option Delivery Price | Bybit API Documentation - +

    Option Delivery Price

    Get the delivery price for option

    HTTP Request​

    GET /derivatives/v3/public/delivery-price

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. For option only
    symbolfalsestringSymbol name
    baseCoinfalsestringBase coin. Default: BTC
    directionfalsestringPage direction. prev, next. Default: next
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    resultTotalSizeintegerThe number of records in dataList
    cursorstringCursor. Used to pagination
    dataListarrayObject
    > categorystringProducts category
    > symbolstringSymbol name
    > deliveryPricestringDelivery price
    > deliveryTimestringDelivery timestamp(ms)

    Request Example​

    GET /derivatives/v3/public/delivery-price?limit=1&baseCoin=ETH HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "resultTotalSize": 4830,
            "cursor": "0%2C1",
            "dataList": [
                {
                    "category": "option",
                    "symbol": "ETH-25DEC22-1450-C",
                    "deliveryPrice": "1218.856238890",
                    "deliveryTime": "1671955200000"
                }
            ]
    },
        "retExtInfo": {},
        "time": 1671971138308
    }
    - + \ No newline at end of file diff --git a/derivatives/public/orderbook.html b/derivatives/public/orderbook.html index 9f732696ef..921e121e08 100644 --- a/derivatives/public/orderbook.html +++ b/derivatives/public/orderbook.html @@ -4,13 +4,13 @@ Order Book | Bybit API Documentation - +

    Order Book

    Get order book data.

    info

    The response is in the snapshot format.

    HTTP Request​

    GET /derivatives/v3/public/order-book/L2

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse,option. Default: linear, but in the response category shows ""
    symboltruestringSymbol name. category is required when query an option symbol
    limitfalseintegerLimit for data size per page. [1, 500]. Default: 25. option has 25 only

    Response Parameters​

    ParameterTypeComments
    sstringSymbol name
    bstringBid. Order by price asc
    astringAsk. Order by price asc
    tsintegerThe timestamp(ms) that system generates the data
    uintegerUpdate id, is always in sequence
    seqintegerCross sequence
  • You can use this field to compare different levels orderbook data, and for the smaller seq, then it means the data is generated earlier.
  • Option does not have this field currently
    • ctsintegerThe timestamp from the match engine when this orderbook data is produced. It can be correlated with T from public trade channel linear, inverse have this field

    Request Example​

    GET /derivatives/v3/public/order-book/L2?category=linear&symbol=BTCPERP&limit=2 HTTP/1.1
    Host: api.bybit.com​

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "s": "BTCUSDT",
            "b": [
                [
                    "68749.6",
                    "40.381"
                ]
            ],
            "a": [
                [
                    "68755.1",
                    "67.505"
                ]
            ],
            "ts": 1716863768890,
            "u": 1109539,
            "seq": 9239580568,
            "cts": 1716863768873
        },
        "retExtInfo": {},
        "time": 1716863769891
    }
    - + \ No newline at end of file diff --git a/derivatives/public/premium-index-kline.html b/derivatives/public/premium-index-kline.html index 0f206cc0ee..55d2a4d4bb 100644 --- a/derivatives/public/premium-index-kline.html +++ b/derivatives/public/premium-index-kline.html @@ -4,13 +4,13 @@ Premium Index Price Kline | Bybit API Documentation - +

    Premium Index Price Kline

    Get premium index price kline data

    HTTP Request​

    GET /derivatives/v3/public/premium-index-price-kline

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse. Default: linear, but in the response category shows ""
    symboltruestringSymbol name
    intervaltruestringKline interval. 1 3 5 15 30 60 120 240 360 720 D M W
    starttrueintegerThe start timestamp (ms)
    endtrueintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters​

    ParameterTypeComments
    symbolstringSymbol name
    categorystringProduct type. Keeps empty string "" when category is not passed
    listarray
    • An string array of individual candle
    • Sort in reverse by start
    • The default collation within the array is start, open, high, low, close

    Request Example​

    GET /derivatives/v3/public/premium-index-price-kline?symbol=BTCUSDT&interval=D&start=1668441600000&end=1668528000000 HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "symbol": "BTCUSDT",
        "category": "",
        "list": [
            [
                "1668470400000",
                "-0.000754",
                "-0.001071",
                "-0.001072",
                "-0.001072"
            ]
        ]
    },
        "retExtInfo": {},
        "time": 1671969006930
    }
    - + \ No newline at end of file diff --git a/derivatives/public/risk-limit.html b/derivatives/public/risk-limit.html index de495f3e54..233ccabf61 100644 --- a/derivatives/public/risk-limit.html +++ b/derivatives/public/risk-limit.html @@ -4,13 +4,13 @@ Risk Limit | Bybit API Documentation - +

    Risk Limit

    Get risk limit

    tip

    What is risk limit? Risk Limit (USDT Contract)

    info

    category=linear returns data set of 30 symbols each request, please use cursor to get next data set.

    HTTP Request​

    GET /derivatives/v3/public/risk-limit/list

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse. Default: linear, but in the response category shows ""
    symbolfalsestringSymbol name
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type. Keeps empty string "" when category is not passed
    listarrayObject
    > idstringRisk id
    > symbolstringSymbol name
    > limitstringPosition limit
    > maintainMarginstringMaintain margin rate
    > initialMarginstringInitial margin rate
    > isLowerRiskinteger1: true, 0: false
    > maxLeveragestringAllowed max leverage
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /derivatives/v3/public/risk-limit/list?symbol=ETHPERP HTTP/1.1
    Host: api.bybit.com

    Response Example​

        {
            "retCode": 0,
            "retMsg": "OK",
            "result": {
                "category": "",
                "list": [
                    {
                        "id": 1,
                        "symbol": "ETHPERP",
                        "limit": "500000",
                        "maintainMargin": "0.01",
                        "initialMargin": "0.015",
                        "isLowestRisk": 1,
                        "maxLeverage": "66.67"
                    },
                ...,

                ]
            },
            "retExtInfo": {},
            "time": 1671970615467
        }
    - + \ No newline at end of file diff --git a/derivatives/public/ticker.html b/derivatives/public/ticker.html index b39b73c383..5c5b77577b 100644 --- a/derivatives/public/ticker.html +++ b/derivatives/public/ticker.html @@ -4,13 +4,13 @@ Ticker Info | Bybit API Documentation - +

    Ticker Info

    Get all latest information of symbols.

    HTTP Request​

    GET /derivatives/v3/public/tickers

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse,option. Default: linear, but in the response category shows ""
    symbolfalsestringSymbol name.
    • category=option, symbol is required
    • an option symbol, category is required

    Response Parameters​

    ParameterTypeComments
    categorystringDerivatives products category. Keeps empty string `""` when `category` is not passed
    listarrayObject
    > symbolstringSymbol name
    > bidPricestringBest bid price
    > askPricestringBest ask price
    > lastPricestringLast transaction price
    > lastTickDirectionstringDirection of price change
    > prevPrice24hstringPrice of 24 hours ago
    > price24hPcntstringPercentage change of market price relative to 24h
    > highPrice24hstringThe highest price in the last 24 hours
    > lowPrice24hstringLowest price in the last 24 hours
    > prevPrice1hstringHourly market price an hour ago
    > markPricestringMark price
    > indexPricestringIndex price
    > openIntereststringOpen interest
    > turnover24hstringTurnover in the last 24 hours
    > volume24hstringTrading volume in the last 24 hours
    > fundingRatestringFunding rate
    > nextFundingTimestringNext timestamp for funding to settle
    > predictedDeliveryPricestringPredicted delivery price. It has value when 30 min before delivery
    > basisRatestringBasis rate for futures
    > deliveryFeeRatestringDelivery fee rate
    > deliveryTimestringDelivery timestamp (ms)
    > openInterestValuestringOpen interest value

    Request Example​

    GET /derivatives/v3/public/tickers?category=linear&symbol=BTCUSDZ22 HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "category": "inverse",
        "list": [
            {
                "symbol": "BTCUSDZ22",
                "bidPrice": "16825",
                "askPrice": "16825.5",
                "lastPrice": "16825.00",
                "lastTickDirection": "ZeroPlusTick",
                "prevPrice24h": "16830.50",
                "price24hPcnt": "-0.000326",
                "highPrice24h": "16859.50",
                "lowPrice24h": "16798.50",
                "prevPrice1h": "16824.50",
                "markPrice": "16824.02",
                "indexPrice": "16825.28",
                "openInterest": "7653441",
                "turnover24h": "30.80109312",
                "volume24h": "518542",
                "fundingRate": "",
                "nextFundingTime": "0",
                "predictedDeliveryPrice": "0.00",
                "basisRate": "-0.00009093",
                "deliveryFeeRate": "0.0005",
                "deliveryTime": "1672387200000",
                "openInterestValue": "21887.06"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1671969377669
    }
    - + \ No newline at end of file diff --git a/derivatives/public/trade.html b/derivatives/public/trade.html index 9028f924bb..276fcd022b 100644 --- a/derivatives/public/trade.html +++ b/derivatives/public/trade.html @@ -4,13 +4,13 @@ Public Trading History | Bybit API Documentation - +

    Public Trading History

    Get recent public trading records in Bybit. You could download archived USDT contract trade records here.

    HTTP Request​

    GET /derivatives/v3/public/recent-trade

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type.linear,inverse,option
    • category not passed or =linear,inverse, then symbol is required
    • category=option, then symbol is optional
    symbolfalsestringSymbol name
    baseCoinfalsestringBase coin. Default: BTC. Valid only when category=option
    optionTypefalsestringOption type. Call or Put. Valid only when category=option
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 500

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > execIdstringExecution id
    > symbolstringSymbol name
    > pricestringTrade price
    > sizestringTrade size
    > sidestringSide of taker Buy, Sell
    > timestringTrade time
    > isBlockTradebooleanIs block trade
    > mPstringMark price, unique field for option
    > iPstringIndex price, unique field for option
    > mIvstringMark iv, unique field for option
    > ivstringiv, unique field for option

    Request Example​

    GET /derivatives/v3/public/recent-trade?category=linear&symbol=BTCUSDT&limit=1 HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                "execId": "5706445b-8543-59bc-8988-93e0f4a3f0f9",
                "symbol": "BTCUSDT",
                "price": "16814.50",
                "size": "0.001",
                "side": "Buy",
                "time": "1671970297430",
                "isBlockTrade": false
            }
        ]
    },
        "retExtInfo": {},
        "time": 1671970297723
    }
    - + \ No newline at end of file diff --git a/derivatives/rate-limit.html b/derivatives/rate-limit.html index 1d75f4bbe3..e85cc27d9e 100644 --- a/derivatives/rate-limit.html +++ b/derivatives/rate-limit.html @@ -4,7 +4,7 @@ Rate Limit | Bybit API Documentation - + @@ -15,7 +15,7 @@ in an unexpected violation.

    • GET/POST method (shared):
      • No more than 600 requests are allowed in any 5-second window.
    note

    All traffic to api.bybit.com or api.bytick.com share this limit regardless of if it accesses Spot, Derivatives or Options.

    After violating the limit your IP will be banned for a set period of time (usually 30 minutes). Continually violating the limit will result in a permanent ban. We cannot undo permanent bans or shorten temporary bans.

    API Rate Limit​

    caution

    If you receive "ret_msg": "Too many visits!" in the JSON response, you have hit the API rate limit.

    tip

    For now, api rate limit for Unified margin is a bit different.

    • linear: rate limit is count by minute
    • option: rate limit is count by second

    The API rate limit is based on the rolling time window per second and UID. In other words, it is per second per UID. Every request to the API returns response header shown in the code panel:

    • X-Bapi-Limit-Status - your remaining requests for current endpoint
    • X-Bapi-Limit - your current limit for current endpoint
    • X-Bapi-Limit-Reset-Timestamp - the timestamp indicating when your request limit resets if you have exceeded your rate_limit. Otherwise, this is just the current timestamp.

    Http Response Header Example

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    API Rate Limit Table​

    Contract​

    PathLimit
    All private endpoints10 req/s

    How to increase API Limit​

    Please email api@bybit.com with the following information. We will reply within 1-4 working days:

    1. Your name and your company details
    2. Your Bybit UID or registered email, and the assets you are trading
    3. General description of your trading strategy and reasons for higher rate limits
    4. Screenshot of previous monthly trading volume (maker/taker) on other platforms
    5. Optional: your order history in CSV format
    - + \ No newline at end of file diff --git a/derivatives/unified/batch-cancel.html b/derivatives/unified/batch-cancel.html index 85a1e0f6df..a7d2a6ef7f 100644 --- a/derivatives/unified/batch-cancel.html +++ b/derivatives/unified/batch-cancel.html @@ -4,14 +4,14 @@ Batch Cancel Order | Bybit API Documentation - +

    Batch Cancel Order

    tip

    This endpoint provides the batch order mode to cancel a bunch of open orders.

    • Order cancellation of future and option cannot be cancelled in one request.
    • If both future and option orders are in one request, then by given the category type, only the orders whose symbol matches the category will be operated.

    HTTP Request​

    POST /unified/v3/private/order/cancel-batch

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear,option
    requesttruearrayObject
    > symboltruestringSymbol name
    > orderIdfalsestringOrder id. Either orderId or orderLinkId is required
    > orderLinkIdfalsestringUser customised order id. Either orderId or orderLinkId is required

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> categorystringProducts category
    >> symbolstringSymbol name
    >> orderIdstringOrder id
    >> orderLinkIdstringUser customised order id
    retExtInfoObject
    > listarrayObject
    >> codeintegerSuccess/error code
    >> msgstringSuccess/error message

    Request Example​

    POST /unified/v3/private/order/cancel-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672818987475
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "request": [
            {
                "symbol": "ETHUSDT",
                "orderLinkId": "test-002"
            },
            {
                "symbol": "XRPUSDT",
                "orderLinkId": "test-003"
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "",
                    "orderLinkId": "test-002"
                },
                {
                    "category": "linear",
                    "symbol": "XRPUSDT",
                    "orderId": "",
                    "orderLinkId": "test-003"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "success"
                },
                {
                    "code": 110001,
                    "msg": "order not exists or too late to cancel"
                }
            ]
        },
        "time": 1672818989928
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/batch-place.html b/derivatives/unified/batch-place.html index 89d315562a..3e88eb9ac0 100644 --- a/derivatives/unified/batch-place.html +++ b/derivatives/unified/batch-place.html @@ -4,7 +4,7 @@ Batch Place Order | Bybit API Documentation - + @@ -15,7 +15,7 @@ time. Only Limit / Market active order is supported, the conditional order is not supported.
  • If both future and option orders are in one request, then by given the category type, only the orders whose symbol matches the category will be operated.
  • The maximum number of orders included in each request is 10 orders. The returned data list is divided into two lists. The list created by the order and the created information are returned. The structure of the two lists are completely consistent.

    • HTTP Request​

    POST /unified/v3/private/order/create-batch

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    requesttruearrayObject
    > symboltruestringSymbol name
    > sidetruestringBuy, Sell
    > orderTypetruestringMarket, Limit
    > qtytruestringOrder quantity
    > pricefalsestringOrder price. Invalid if orderType=Market
    > orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed
    > timeInForcetruestringTime in force. GoodTillCancel, ImmediateOrCancel, FillOrKill, PostOnly
    > positionIdxfalseintegerPosition index. 0: one-way mode. Unified margin supports one-way mode only
    > orderLinkIdfalsestringUser customised order id. A max of 36 characters. Combinations of numbers, letters (upper and lower cases), dashes, and underscores are supported.
    rule of linear:
    • optional param
    • The same orderLinkId can be used for both USDC PERP and USDT PERP.
    • An orderLinkId can be reused once the original order is either Filled or Cancelled
      • rule of option:
    • required param
    • always unique
    > reduceOnlyfalsebooleanWhat is a reduce-only order? true means your position can only reduce in size if this order is triggered. When reduce_only is true, take profit/stop loss cannot be set
    > closeOnTriggerfalsebooleanWhat is a close on trigger order? For a closing order. It can only reduce your position, not increase it. If the account has insufficient available balance when the closing order is triggered, then other active orders of similar contracts will be cancelled or reduced. It can be used to ensure your stop loss reduces your position regardless of current available margin.
    > mmpfalsebooleanMarket maker protection. true means this order is a market maker protection order

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> categorystringProducts category
    >> symbolstringSymbol name
    >> orderIdstringOrder id
    >> orderLinkIdstringUser customised order id
    >> createAtstringOrder created time (ms)
    retExtInfoObject
    > listarrayObject
    >> codeintegerSuccess/error code
    >> msgstringSuccess/error message

    Request Example​

    POST /unified/v3/private/order/create-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672817108675
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "request": [
            {
                "symbol": "ETHUSDT",
                "orderType": "Limit",
                "side": "Buy",
                "qty": "0.05",
                "price": "1000",
                "timeInForce": "GoodTillCancel",
                "orderLinkId": "test-002",
                "reduceOnly": false,
                "closeOntrigger": false
            },
            {
                "symbol": "XRPUSDT",
                "orderType": "Limit",
                "side": "Buy",
                "qty": "100",
                "price": "0.3",
                "timeInForce": "GoodTillCancel",
                "orderLinkId": "test-003",
                "reduceOnly": false,
                "closeOntrigger": false
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "ce295fcb-8c8a-4f12-89f4-4ab23d38ccd8",
                    "orderLinkId": "test-002",
                    "createAt": "1672817109797"
                },
                {
                    "category": "linear",
                    "symbol": "XRPUSDT",
                    "orderId": "e97f0355-6586-49a4-965f-feb7253cef14",
                    "orderLinkId": "test-003",
                    "createAt": "1672817109796"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "success"
                },
                {
                    "code": 0,
                    "msg": "success"
                }
            ]
        },
        "time": 1672817109804
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/batch-replace.html b/derivatives/unified/batch-replace.html index 7f472cef0e..bee84966eb 100644 --- a/derivatives/unified/batch-replace.html +++ b/derivatives/unified/batch-replace.html @@ -4,14 +4,14 @@ Batch Replace Order | Bybit API Documentation - +

    Batch Replace Order

    tip

    This endpoint provides the batch order mode to replace a bunch of open orders.

    • You could modify those unfilled or partially filled orders. Conditional order is not supported.
    • If both future and option orders are in one request, then by given the category type, only the orders whose symbol matches the category will be operated.

    HTTP Request​

    POST /unified/v3/private/order/replace-batch

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    requesttruearrayObject
    > symboltruestringSymbol name
    > orderIdfalsestringOrder id. Either orderId or orderLinkId is required
    > orderLinkIdfalsestringUser customised order id. Either orderId or orderLinkId is required
    > qtyfalsestringOrder quantity after modification. Don't pass it if not modify the qty
    > pricefalsestringOrder price after modification. Don't pass it if not modify the price
    > orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> categorystringProducts category
    >> symbolstringSymbol name
    >> orderIdstringOrder id
    >> orderLinkIdstringUser customised order id
    retExtInfoObject
    > listarrayObject
    >> codeintegerSuccess/error code
    >> msgstringSuccess/error message

    Request Example​

    POST /unified/v3/private/order/replace-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672818010133
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "request": [
            {
                "symbol": "ETHUSDT",
                "orderId": null,
                "price": null,
                "qty": "0.1",
                "orderLinkId": "test-002"
            },
            {
                "symbol": "XRPUSDT",
                "orderId": null,
                "price": "120",
                "qty": null,
                "orderLinkId": "test-003"
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "",
                    "orderLinkId": "test-002"
                },
                {
                    "category": "linear",
                    "symbol": "XRPUSDT",
                    "orderId": "",
                    "orderLinkId": "test-003"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "success"
                },
                {
                    "code": 0,
                    "msg": "success"
                }
            ]
        },
        "time": 1672818011076
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/borrow-history.html b/derivatives/unified/borrow-history.html index 4242fd5bfd..0e304ec270 100644 --- a/derivatives/unified/borrow-history.html +++ b/derivatives/unified/borrow-history.html @@ -4,13 +4,13 @@ Borrow History | Bybit API Documentation - +

    Borrow History

    HTTP Request​

    GET /unified/v3/private/account/borrow-history

    Request Parameters​

    ParameterRequiredTypeComments
    currencyfalsestringUSDC、USDT、BTC、ETH
    startTimeintegerintegerThe start timestamp (ms)
    endTimeintegerintegerThe end time. timestamp (ms)
    directionfalsestringDirection: prev: previous page, next: next page, Default is next
    limitintegerintegerLimit 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
    nextPageCursorstringCursor. Used to pagination
    currencystringnull
    listarrayObject
    > currencystringUSDC、USDT、BTC、ETH
    > createTimeintegerCreated timestamp (ms)
    > borrowCoststringInterest
    > hourlyBorrowRatestringHourly Borrow Rate
    > InterestBearingBorrowSizestringInterest Bearing Borrow Size
    > costExemptionstringCost exemption

    Request Example​

    GET /unified/v3/private/account/borrow-history?limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673078071099
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "1625%3A0%2C1625%3A0",
            "currency": null,
            "list": [
                {
                    "createTime": 1667282700269,
                    "costExemption": "0.00063175360150218",
                    "InterestBearingBorrowSize": "0",
                    "currency": "USDT",
                    "hourlyBorrowRate": "0.000001142",
                    "borrowCost": "0"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1673078071991
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/borrow-rate.html b/derivatives/unified/borrow-rate.html index d873abefb0..4861f3d66c 100644 --- a/derivatives/unified/borrow-rate.html +++ b/derivatives/unified/borrow-rate.html @@ -4,13 +4,13 @@ Get Borrow Rate | Bybit API Documentation - +

    Get Borrow Rate

    HTTP Request​

    GET /unified/v3/private/account/borrow-rate

    Request Parameters​

    ParameterRequiredTypeComments
    currencyfalsestringUSDC, USDT Only

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > currencystringCurrency of all current collateral
    > hourlyBorrowRatestringHourly borrow rate
    > maxBorrowAmountstringMax borrow amount
    > freeBorrowAmountstringThe free interest of loan amount

    Request Example​

    GET /unified/v3/private/account/borrow-rate HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673078229194
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "list": [
                {
                    "freeBorrowingAmount": "30000",
                    "currency": "USDT",
                    "maxBorrowingAmount": "2500000",
                    "hourlyBorrowRate": "0.0000055139"
                },
                {
                    "freeBorrowingAmount": "15000",
                    "currency": "USDC",
                    "maxBorrowingAmount": "1500000",
                    "hourlyBorrowRate": "0.00000342460000000000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672023307465
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/cancel-all.html b/derivatives/unified/cancel-all.html index 0da2d7b3ce..3a594216a9 100644 --- a/derivatives/unified/cancel-all.html +++ b/derivatives/unified/cancel-all.html @@ -4,13 +4,13 @@ Cancel All Orders | Bybit API Documentation - +

    Cancel All Orders

    tip

    This endpoint enables to cancel all open orders.

    • If category=linear, one of param baseCoin, settleCoin, symbol must be passed.

    HTTP Request​

    POST /unified/v3/private/order/cancel-all

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    symbolfalsestringSymbol name
    baseCoinfalsestringCancel all open orders by base coin
    settleCoinfalsestringCancel all open orders by settle coin. linear only
    orderFilterfalsestringOrder: active order, StopOrder: conditional order

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> categorystringProducts category
    >> symbolstringSymbol name
    >> orderIdstringOrder id
    >> orderLinkIdstringUser customised order id
    retExtInfoObject
    > listarrayObject
    >> codeintegerSuccess/error code
    >> msgstringSuccess/error message

    Request Example​

    POST /unified/v3/private/order/cancel-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672810386137
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
      "category": "linear",
      "baseCoin": "ETH",
      "settleCoin": null
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "6cba55ea-6996-44f5-bd0f-ac09ffda4ab1",
                    "orderLinkId": "liang-001"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "success"
                }
            ]
        },
        "time": 1672810388787
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/cancel.html b/derivatives/unified/cancel.html index 4e5fe99f2c..692bc6b5d7 100644 --- a/derivatives/unified/cancel.html +++ b/derivatives/unified/cancel.html @@ -4,13 +4,13 @@ Cancel Order | Bybit API Documentation - +

    Cancel Order

    caution

    You could cancel those unfilled or partially filled orders.

    HTTP Request​

    POST /unified/v3/private/order/cancel

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    symboltruestringSymbol name
    orderIdfalsestringOrder id. Either orderId or orderLinkId is required
    orderLinkIdfalsestringUser customised order id. Either orderId or orderLinkId is required
    orderFilterfalsestringOrder: active order, StopOrder: conditional order

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order id

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/unified/v3/private/order/cancel' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1657871228347' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
      "category": "linear",
      "orderId": "4c51a45f-7795-4b38-9b66-3c306b73f112",
      "symbol": "BTCUSDT"
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "4c51a45f-7795-4b38-9b66-3c306b73f112",
            "orderLinkId": "e80d558e-ed"
        }
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/dcp.html b/derivatives/unified/dcp.html index 8ac10ee42b..3a20288350 100644 --- a/derivatives/unified/dcp.html +++ b/derivatives/unified/dcp.html @@ -4,7 +4,7 @@ Set Disconnect Cancel All | Bybit API Documentation - + @@ -15,7 +15,7 @@ all active option orders of the client will be cancelled automatically. If within 10 seconds, the client reconnects and resumes the heartbeat "ping", the timing will be reset and restarted at the next disconnection.

    How to enable DCP​

    If you need to turn it on/off, you can contact your client manager for consultation and application. The default time window is 10 seconds.

    Applicable​

    Effective for options only.

    tip

    After the request is successfully sent, the system needs a certain time to take effect. It is recommended to query or set again after 10 seconds

    HTTP Request​

    POST /derivatives/v3/private/dcp-set-timewindow

    Request Parameters​

    ParameterRequiredTypeComments
    timeWindowtrueintegerDisconnection timing window time. [3, 300], unit: second

    Response Parameters​

    None

    Request Example​

    POST /derivatives/v3/private/dcp-set-timewindow HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675852742375
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
      "timeWindow": 40
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/delivery.html b/derivatives/unified/delivery.html index 96bd8701e8..587573e4a6 100644 --- a/derivatives/unified/delivery.html +++ b/derivatives/unified/delivery.html @@ -4,13 +4,13 @@ Get Option Delivery Record | Bybit API Documentation - +

    Get Option Delivery Record

    Query option delivery records, sort by deliveryTime in descending order

    HTTP Request​

    GET /unified/v3/private/delivery-record

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. option
    symbolfalsestringSymbol name
    expDatefalsestringExpiry date. 25MAR22. Default: return all
    directionfalsestringprev: previous page, next: next page. Default: next
    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
    nextPageCursorstringCursor. Used to pagination
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > sidestringBuy,Sell
    > strikestringExercise price
    > feestringTrading fee
    > positionstringExecuted size
    > deliveryTimenumberDelivery time (ms)
    > deliveryPricestringDelivery price
    > deliveryRplstringRealized PnL of the delivery

    Request Example​

    GET /unified/v3/private/delivery-record?category=option&limit=5 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672020598623
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "nextPageCursor": "45%3A0%2C45%3A0",
            "category": "option",
            "list": [
                {
                    "symbol": "BTC-29JUL22-27000-C",
                    "side": "Sell",
                    "deliveryTime": 1659081601928,
                    "strike": "27000",
                    "fee": "0.00000000",
                    "position": "0.0300",
                    "deliveryPrice": "23927.85304688",
                    "deliveryRpl": "0.00000000"
                }
        ]
    },
        "retExtInfo": {},
        "time": 1672020600013
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/exchange.html b/derivatives/unified/exchange.html index 1b7da7d77d..81bbb7596c 100644 --- a/derivatives/unified/exchange.html +++ b/derivatives/unified/exchange.html @@ -4,13 +4,13 @@ Get Exchange Records | Bybit API Documentation - +

    Get Exchange Records

    Query the coin exchange records.

    HTTP Request​

    GET /asset/v2/private/exchange/exchange-order-all

    Request Parameters​

    ParameterRequiredTypeComments
    fromCoinfalsestringThe currency to convert from. e.g,BTC
    toCoinfalsestringThe currency to convert to. e.g,USDT

    Response Parameters​

    ParameterTypeComments
    totalCountstringRecords size
    orderarrayObject
    > fromCoinstringThe currency to convert from
    > fromAmountstringThe amount to convert from
    > toCoinstringThe currency to convert to
    > toAmountstringThe amount to convert to
    > exchangeRatestringExchange rate
    > createdTimestringExchange created timestamp (ms)
    > exchangeTxIdstringExchange transaction id

    Request Example​

    GET /asset/v2/private/exchange/exchange-order-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673079087093
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "order": [
                {
                    "fromCoin": "ETH",
                    "fromAmount": "0.10000000",
                    "toCoin": "XRP",
                    "toAmount": "372.37487085",
                    "exchangeRate": "3723.74870857",
                    "createdTime": "1672989418000",
                    "exchangeTxId": "251239533285211865273079980032"
                },
                {
                    "fromCoin": "BTC",
                    "fromAmount": "0.10000000",
                    "toCoin": "ETH",
                    "toAmount": "1.38586623",
                    "exchangeRate": "13.85866238",
                    "createdTime": "1672197760000",
                    "exchangeTxId": "145102533285208544812654440448"
                }
            ],
            "totalCount": "2"
        },
        "retExtInfo": {},
        "time": 1673079089361
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/execution-list.html b/derivatives/unified/execution-list.html index 9cdc54821e..967d4f06cc 100644 --- a/derivatives/unified/execution-list.html +++ b/derivatives/unified/execution-list.html @@ -4,13 +4,13 @@ Get Execution Record | Bybit API Documentation - +

    Get Execution Record

    Query users' execution records, sort by execTime in descending order

    tip
    • You may have multiple executions in a single order.
    • This endpoint can query half-year data.

    HTTP Request​

    POST /unified/v3/private/execution/list

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear,option
    symbolfalsestringSymbol name
    orderIdfalsestringOrder id
    orderLinkIdfalsestringUser customised order id
    baseCoinfalsestringBase coin. For option only. Return all base coin data if not passed
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    execTypefalsestringExecution type
    directionfalsestringprev: previous page, next: next page. Default: next
    limitfalseintegerLimit for data size per page. [1, 100]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type. linear,option
    listarrayObject
    > symbolstringSymbol name
    > orderIdstringOrder id
    > orderLinkIdstringUser customized order id
    > sidestringSide. Buy,Sell
    > orderPricestringOrder price
    > orderQtystringOrder qty
    > leavesQtystringThe remaining qty not executed
    > orderTypestringOrder type. Market,Limit
    > stopOrderTypestringStop order type. If the order is not stop order, any type is not returned
    > execFeestringExecuted trading fee
    > execIdstringExecution id
    > execPricestringExecution price
    > execQtystringExecution qty
    > execTypestringExecuted type
    > execValuestringExecuted order value
    > execTimenumberExecuted timestamp（ms）
    > feeRatestringTrading fee rate
    > blockTradeIdstringParadigm block trade id
    nextPageCursorstringCursor. Used to pagination

    Request Example​

    GET /unified/v3/private/execution/list?category=option&symbol=ETH-30DEC22-700-C HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672020216382
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "nextPageCursor": "2203%3A0%2C2203%3A0",
            "category": "option",
            "list": [
            {
                "orderType": "Market",
                "symbol": "ETH-30DEC22-700-C",
                "orderLinkId": "",
                "side": "Sell",
                "orderId": "cc8012bc-ddc1-443c-8dd9-88cfb946d3b0",
                "leavesQty": "0.0000",
                "execTime": 1672018465365,
                "execFee": "0.03656010",
                "feeRate": "0.000300",
                "execId": "f4309658-62be-5f2b-b262-852909c45bba",
                "blockTradeId": "",
                "execPrice": "498.00000000",
                "lastLiquidityInd": "TAKER",
                "orderQty": "0.1000",
                "orderPrice": "496.50000000",
                "execValue": "49.80000000",
                "execType": "Trade",
                "execQty": "0.1000"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1672019908409
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/get-dcp.html b/derivatives/unified/get-dcp.html index 3104b89577..6a07edc90e 100644 --- a/derivatives/unified/get-dcp.html +++ b/derivatives/unified/get-dcp.html @@ -4,13 +4,13 @@ Get DCP Info | Bybit API Documentation - +

    Get DCP Info

    HTTP Request​

    GET /derivatives/v3/private/query-dcp-info

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    retCodeintegerResult code
    retMsgstringResult message
    dcpStatusstringDCP status. ON, OFF
    timeWindowstringDCP time window (second)

    請求示例​

    GET /derivatives/v3/private/query-dcp-info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675861979020
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "dcpStatus": "ON",
        "timeWindow": "40"
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/get-mmp-state.html b/derivatives/unified/get-mmp-state.html index 7ac4835b3d..aba04e989d 100644 --- a/derivatives/unified/get-mmp-state.html +++ b/derivatives/unified/get-mmp-state.html @@ -4,13 +4,13 @@ Get MMP State | Bybit API Documentation - +

    Get MMP State

    HTTP Request​

    GET /unified/v3/private/account/mmp-state

    Request Parameters​

    ParameterRequiredTypeComments
    baseCointruestringBase coin

    Response Parameters​

    ParameterTypeComments
    resultarrayObject
    > baseCoinstringBase coin
    > mmpEnabledbooleanWhether the account is enabled mmp
    > windowstringTime window (ms)
    > frozenPeriodstringFrozen period (ms)
    > qtyLimitstringTrade qty limit
    > deltaLimitstringDelta limit
    > mmpFrozenUntilstringUnfreeze timestamp (ms)
    > mmpFrozenbooleanWhether the mmp is triggered.
    • true: mmpFrozenUntil is meaningful
    • false: please ignore the value of mmpFrozenUntil

    Request Example​

    POST /unified/v3/private/account/mmp-state HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675842997277
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "baseCoin": "ETH"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "result": [
                {
                    "baseCoin": "BTC",
                    "mmpEnabled": true,
                    "window": "5000",
                    "frozenPeriod": "100000",
                    "qtyLimit": "0.01",
                    "deltaLimit": "0.01",
                    "mmpFrozenUntil": "1675760625519",
                    "mmpFrozen": false
                }
            ]
        },
        "retExtInfo": {},
        "time": 1675843188984
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/leverage.html b/derivatives/unified/leverage.html index d0420c339b..50011f3516 100644 --- a/derivatives/unified/leverage.html +++ b/derivatives/unified/leverage.html @@ -4,13 +4,13 @@ Set Leverage | Bybit API Documentation - +

    Set Leverage

    Set the leverage.

    HTTP Request​

    POST /unified/v3/private/position/set-leverage

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear only
    symboltruestringSymbol name
    buyLeveragetruestring(0, allowed max leverage of corresponding risk limit]
    sellLeveragetruestring(0, allowed max leverage of corresponding risk limit]

    Response Parameters​

    None

    Request Example​

    POST /unified/v3/private/position/set-leverage HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672016383313
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "ARUSDT",
        "buyLeverage": "11",
        "sellLeverage": "11"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1672016384347
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/open-order.html b/derivatives/unified/open-order.html index c1d9908579..a61f65dc6b 100644 --- a/derivatives/unified/open-order.html +++ b/derivatives/unified/open-order.html @@ -4,13 +4,13 @@ Get Open Orders | Bybit API Documentation - +

    Get Open Orders

    tip

    Query unfilled or partially filled orders in real-time.

    • At most 500 unfilled or partially filled orders will be returned if neither orderId nor orderLinkId is passed.
    • The records are sort by the createdTime from newest to oldest.

    HTTP Request​

    GET /unified/v3/private/order/unfilled-orders

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    symbolfalsestringSymbol name
    baseCoinfalsestringBase coin. Ifcategory=option，then it returns BTC data when this field is not passed
    orderIdfalsestringOrder id
    orderLinkIdfalsestringUser customised order id
    orderFilterfalsestringOrder: active order, StopOrder: conditional order
    directionfalsestringPage direction. prev, next. Default: next
    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
    categorystringProduct type
    nextPageCursorstringRefer to the cursor request parameter
    listarrayObject
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    > blockTradeIdstringParadigm block trade ID
    > symbolstringSymbol name
    > ivstringImplied volatility. linear does not have this field
    > pricestringOrder price
    > qtystringOrder qty
    > sidestringSide. Buy,Sell
    > orderStatusstringOrder status
    > orderTypestringOrder type. Market,Limit
    > stopOrderTypestringStop order type. option does not have this field
    > cumExecValuestringCumulative executed order value
    > cumExecFeestringCumulative executed trading fee
    > cumExecQtystringCumulative executed order qty
    > tpTriggerBystringThe price type to trigger take profit. option does not have this field
    > slTriggerBystringStop loss price. option does not have this field
    > timeInForcestringTime in force
    > basePricestringBase price
    > triggerBystringThe price type of trigger price. option does not have this field
    > triggerPricestringTrigger price. If stopOrderType=TrailingStop, it is activate price. Otherwise, it is trigger price. option does not have this field
    > leavesQtystringThe remaining qty not executed
    > reduceOnlybooleanReduce only. true means reduce position size
    > closeOnTriggerbooleanClose on trigger. option does not have this field
    > takeProfitstringTake profit price. option does not have this field
    > stopLossstringStop loss price. option does not have this field
    > orderIMstringOrder initial margin. For portfolio margin mode, it returns ""
    > createdTimenumberOrder created timestamp (ms)
    > updatedTimenumberOrder updated timestamp (ms)

    Request Example​

    GET /unified/v3/private/order/unfilled-orders?category=option&baseCoin=BTC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673079658059
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "d00b5b7b-4e05-4a12-a81c-8afb6ddf76bc%3A1673079539417%2Cd00b5b7b-4e05-4a12-a81c-8afb6ddf76bc%3A1673079539417",
            "category": "linear",
            "list": [
                {
                    "symbol": "MATICUSDT",
                    "orderType": "Limit",
                    "orderLinkId": "",
                    "orderId": "d00b5b7b-4e05-4a12-a81c-8afb6ddf76bc",
                    "stopOrderType": "UNKNOWN",
                    "orderStatus": "New",
                    "takeProfit": "",
                    "cumExecValue": "0.00000000",
                    "blockTradeId": "",
                    "price": "1.00000000",
                    "createdTime": 1673079539417,
                    "tpTriggerBy": "UNKNOWN",
                    "timeInForce": "PostOnly",
                    "basePrice": "",
                    "updatedTime": 1673079539426,
                    "side": "Sell",
                    "triggerPrice": "",
                    "cumExecFee": "0.00000000",
                    "slTriggerBy": "UNKNOWN",
                    "leavesQty": "500.0000",
                    "closeOnTrigger": true,
                    "cumExecQty": "0.00000000",
                    "reduceOnly": true,
                    "qty": "500.0000",
                    "stopLoss": "",
                    "triggerBy": "UNKNOWN",
                    "orderIM": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1673079551691
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/order-list.html b/derivatives/unified/order-list.html index 562f914c02..28f673a13f 100644 --- a/derivatives/unified/order-list.html +++ b/derivatives/unified/order-list.html @@ -4,14 +4,14 @@ Get Order List | Bybit API Documentation - +

    Get Order List

    tip

    Query order list.
    As order creation/cancellation is asynchronous, the data returned from this endpoint may delay.

    HTTP Request​

    GET /unified/v3/private/order/list

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    symbolfalsestringSymbol name
    baseCoinfalsestringBase coin. Ifcategory=option，then it returns BTC data when this field is not passed
    orderIdfalsestringOrder id
    orderLinkIdfalsestringUser customised order id
    orderStatusfalsestringReturn all status orders if not passed. You could pass multiple status, separated by comma
    orderFilterfalsestringOrder: active order, StopOrder: conditional order
    directionfalsestringPage direction. prev, next. Default: next
    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
    categorystringProduct type
    nextPageCursorstringRefer to the cursor request parameter
    listarrayObject
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    > blockTradeIdstringParadigm block trade ID
    > symbolstringSymbol name
    > ivstringImplied volatility. linear does not have this field
    > pricestringOrder price
    > qtystringOrder qty
    > sidestringSide. Buy,Sell
    > orderStatusstringOrder status
    > orderTypestringOrder type. Market,Limit
    > stopOrderTypestringStop order type. option does not have this field
    > rejectReasonstringThe reason of rejection
    > cumExecValuestringCumulative executed order value
    > cumExecFeestringCumulative executed trading fee
    > cumExecQtystringCumulative executed order qty
    > tpTriggerBystringThe price type to trigger take profit. option does not have this field
    > slTriggerBystringStop loss price. option does not have this field
    > timeInForcestringTime in force
    > basePricestringBase price
    > triggerBystringThe price type of trigger price. option does not have this field
    > triggerPricestringTrigger price. If stopOrderType=TrailingStop, it is activate price. Otherwise, it is trigger price. option does not have this field
    > leavesQtystringThe remaining qty not executed
    > leavesValuestringThe remaining value not executed. option does not have this field
    > reduceOnlybooleanReduce only. true means reduce position size
    > closeOnTriggerbooleanClose on trigger. option does not have this field
    > takeProfitstringTake profit price. option does not have this field
    > stopLossstringStop loss price. option does not have this field
    > orderIMstringOrder initial margin. For portfolio margin mode, it returns ""
    > createdTimenumberOrder created timestamp (ms)
    > updatedTimenumberOrder updated timestamp (ms)

    Request Example​

    GET /unified/v3/private/order/list?category=linear&orderFilter=StopOrder&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672811957817
    X-BAPI-RECV-WINDOW: 5000
    cdn-request-id: test-002

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "c6f055d9-7f21-4079-913d-e6523a9cfffa%3A1672216686849%2Cc6f055d9-7f21-4079-913d-e6523a9cfffa%3A1672216686849",
            "category": "linear",
            "list": [
                {
                    "symbol": "ETHPERP",
                    "orderType": "Limit",
                    "orderLinkId": "linear-004",
                    "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
                    "stopOrderType": "Stop",
                    "orderStatus": "Deactivated",
                    "takeProfit": "",
                    "cumExecValue": "0",
                    "blockTradeId": "",
                    "rejectReason": "EC_NoError",
                    "price": "1050",
                    "createdTime": 1672216686849,
                    "tpTriggerBy": "UNKNOWN",
                    "timeInForce": "GoodTillCancel",
                    "basePrice": "1188",
                    "leavesValue": "0",
                    "updatedTime": 1672217377166,
                    "side": "Sell",
                    "triggerPrice": "1145.00000000",
                    "cumExecFee": "0",
                    "slTriggerBy": "UNKNOWN",
                    "leavesQty": "0",
                    "closeOnTrigger": false,
                    "cumExecQty": "0",
                    "reduceOnly": false,
                    "qty": "0.15",
                    "stopLoss": "",
                    "triggerBy": "MarkPrice",
                    "orderIM": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672811958171
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/place-order.html b/derivatives/unified/place-order.html index de020bfcc6..375d01db1d 100644 --- a/derivatives/unified/place-order.html +++ b/derivatives/unified/place-order.html @@ -4,7 +4,7 @@ Place Order | Bybit API Documentation - + @@ -20,7 +20,7 @@ ID to cancel active orders. Meanwhile, your customized order ID should be no longer than 36 characters and should be unique.

  • Each account can hold a maximum of 500 active orders simultaneously. This is contract-specific, so the following situation is allowed: The same account can hold 300 BTCUSD active orders and 280 ETHUSD active orders at the same time. When the upper limit of orders is reached, you can still place orders with parameters of reduceOnly or closeOnTrigger.

    • HTTP Request​

    POST /unified/v3/private/order/create

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    symboltruestringSymbol name
    sidetruestringBuy, Sell
    orderTypetruestringMarket, Limit
    qtytruestringOrder quantity
    pricefalsestringOrder price. Invalid if orderType=Market
    basePricefalsestring
    • Used to compare with triggerPrice, to decide whether your conditional order will be triggered by crossing trigger price from upper side or lower side.
    • Mainly used to identify the expected direction of the current conditional order.
    triggerPricefalsestringIf you expect the price to rise to trigger your conditional order, make sure:
    triggerPrice > max(market price, basePrice)
    Else, triggerPrice < min(market price, basePrice)
    triggerByfalsestringTrigger price type. LastPrice, IndexPrice, MarkPrice
    orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed
    timeInForcetruestringTime in force. GoodTillCancel, ImmediateOrCancel, FillOrKill, PostOnly
    positionIdxfalseintegerPosition mode. 0: one-way mode.
    orderLinkIdfalsestringUser customised order id. A max of 36 characters. Combinations of numbers, letters (upper and lower cases), dashes, and underscores are supported.
    rule of future:
    • optional param
    • The same orderLinkId can be used for both USDC PERP and USDT PERP.
    • An orderLinkId can be reused once the original order is either Filled or Cancelled
      • rule of option:
    • required param
    • always unique
    takeProfitfalsestringTake profit price
    stopLossfalsestringStop loss price
    tpTriggerByfalsestringThe price type to trigger take profit. MarkPrice, IndexPrice, default:LastPrice
    slTriggerByfalsestringThe price type to trigger stop loss. MarkPrice, IndexPrice, default:LastPrice
    reduceOnlyfalsebooleanWhat is a reduce-only order? true means your position can only reduce in size if this order is triggered. When reduce_only is true, take profit/stop loss cannot be set
    closeOnTriggerfalsebooleanWhat is a close on trigger order? For a closing order. It can only reduce your position, not increase it. If the account has insufficient available balance when the closing order is triggered, then other active orders of similar contracts will be cancelled or reduced. It can be used to ensure your stop loss reduces your position regardless of current available margin.
    mmpfalsebooleanMarket maker protection. true means this order is a market maker protection order

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order id

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/unified/v3/private/order/create' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1657871228347' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "symbol": "BTCUSDT",
        "orderType": "Limit",
        "side": "Buy",
        "qty": "0.01",
        "price": "20002",
        "timeInForce": "GoodTillCancel",
        "category": "linear"
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "e10b0716-7c91-4091-b98a-1fa0f401c7d5",
            "orderLinkId": "test0000003"
        },
        "retExtInfo": {},
        "time": 1664441344238
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/position-info.html b/derivatives/unified/position-info.html index 986801b45a..04d4bad13b 100644 --- a/derivatives/unified/position-info.html +++ b/derivatives/unified/position-info.html @@ -4,13 +4,13 @@ My Position | Bybit API Documentation - +

    My Position

    Get real-time position data

    HTTP Request​

    GET /unified/v3/private/position/list

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    symbolfalsestringSymbol name
    baseCoinfalsestringBase coin.
    • category=option, then BTC records returned by default
    settleCoinfalsestringSettle coin
    directionfalsestringPage direction. prev, next. default: next
    limitfalseintegerLimit for data size per page. [1, 200]. default: 20
    cursorfalsestringCursor. Used to pagination

    Response Parameters​

    ParameterTypeComments
    nextPageCursorstringCursor. Used to pagination
    categorystringProducts category
    listarrayObject
    > symbolstringSymbol name
    > leveragestringLeverage value. For portfolio margin mode, it returns "", which the leverage rule is invalid
    > updatedTimeintegerUpdate time of position (ms)
    > sidestring`Buy`, `Sell`
    > positionValuestringTotal value of position
    > takeProfitstringTake profit price
    > tpslModestringTp/SL mode. `Partial`, `Full`
    > riskIdintegerRisk limit ID. For portfolio margin mode, it returns 0, which the risk limit rule is invalid
    > trailingStopstringTrailing stop (the distance from the current price)
    > entryPricestringAverage entry price
    > unrealisedPnlstringUnrealised pnl
    > markPricestringMark price
    > sizestringPosition size
    > stopLossstringStop loss price
    > cumRealisedPnlstringCumulative realised profit and loss
    > positionMMstringPosition maintenance margin. For portfolio margin mode, it returns ""
    > createdTimeintegerCreated time (ms)
    > positionIdxintegerPosition idx, used to identify positions in different position modes
  • `0`: One-Way Mode
    • > positionIMstringPosition initial margin. For portfolio margin mode, it returns ""

    Request Example​

    GET /unified/v3/private/position/list?category=linear&symbol=XRPUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672820718517
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "updateAt%3D1672819200214",
            "category": "linear",
            "list": [
                {
                    "symbol": "XRPUSDT",
                    "updatedTime": 1672819200214,
                    "leverage": "10",
                    "side": "Buy",
                    "positionValue": "34.91000000",
                    "takeProfit": "",
                    "tpslMode": "Partial",
                    "riskId": 41,
                    "trailingStop": "0",
                    "entryPrice": "0.34910000",
                    "unrealisedPnl": "0.00000000",
                    "markPrice": "0.34910000",
                    "size": "100.0000",
                    "cumRealisedPnl": "-0.02444200",
                    "stopLoss": "",
                    "positionMM": "0.36795140",
                    "createdTime": 1672016298024,
                    "positionIdx": 0,
                    "positionIM": "3.50985140"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672820720159
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/replace-order.html b/derivatives/unified/replace-order.html index 36afa15986..b9e26a7860 100644 --- a/derivatives/unified/replace-order.html +++ b/derivatives/unified/replace-order.html @@ -4,13 +4,13 @@ Replace Order | Bybit API Documentation - +

    Replace Order

    caution

    You could modify those unfilled or partially filled orders.

    HTTP Request​

    POST /unified/v3/private/order/replace

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option
    symboltruestringSymbol name
    orderIdfalsestringOrder id. Either orderId or orderLinkId is required
    orderLinkIdfalsestringUser customised order id. Either orderId or orderLinkId is required
    orderFilterfalsestringOrder: active order, StopOrder: conditional order
    orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed
    triggerPricefalsestringIf you expect the price to rise to trigger your conditional order, make sure:
    triggerPrice > max(market price, basePrice) Else,
    triggerPrice < min(market price, basePrice)
    qtyfalsestringOrder quantity after modification. Don't pass it if not modify the qty
    pricefalsestringOrder price after modification. Don't pass it if not modify the price
    takeProfitfalsestringTake profit price after modification. Don't pass it if not modify the take profit
    stopLossfalsestringStop loss price after modification. Don't pass it if not modify the Stop loss
    tpTriggerByfalsestringThe price type to trigger take profit. When set a take profit, this param is required if no initial value for the order
    slTriggerByfalsestringThe price type to trigger stop loss. When set a stop loss, this param is required if no initial value for the order
    triggerByfalsestringTrigger price type

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order id

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/unified/v3/private/order/replace' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1657871228347' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "category": "linear",
        "symbol":"BTCUSDT",
        "orderId":"1a1ae001-2034-4a6b-8b25-45aa9100b1ec",
        "price":"35000"
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "orderId": "1a1ae001-2034-4a6b-8b25-45aa9100b1ec",
        "orderLinkId": "e80d558e-ed"
      }
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/reset-mmp.html b/derivatives/unified/reset-mmp.html index 287a1896ee..76fa77243f 100644 --- a/derivatives/unified/reset-mmp.html +++ b/derivatives/unified/reset-mmp.html @@ -4,13 +4,13 @@ Reset MMP | Bybit API Documentation - +

    Reset MMP

    info

    Once the mmp triggered, you can unfreeze the account by this endpoint

    HTTP Request​

    POST /unified/v3/private/account/mmp-reset

    Request Parameters​

    ParameterRequiredTypeComments
    baseCointruestringBase coin

    Response Parameters​

    None

    Request Example​

    POST /unified/v3/private/account/mmp-reset HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675842997277
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "baseCoin": "ETH"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/risk-limit.html b/derivatives/unified/risk-limit.html index 871b509f75..d3c53953da 100644 --- a/derivatives/unified/risk-limit.html +++ b/derivatives/unified/risk-limit.html @@ -4,7 +4,7 @@ Set Risk Limit | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Set Risk Limit

    The risk limit will limit the maximum position value you can hold under different margin requirements. If you want to hold a bigger position size, you need more margin. This interface can set the risk limit of a single position. If the order exceeds the current risk limit when placing an order, it will be rejected. Click here to learn more about risk limit.

    tip

    Set the risk limit of the position. You could get risk limit information of each symbol here.

    HTTP Request​

    POST /unified/v3/private/position/set-risk-limit

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear only
    symboltruestringSymbol name
    riskIdtrueintegerRisk id
    positionIdxfalseintegerPosition index. 0: one-way mode

    Response Parameters​

    None

    Request Example​

    POST /unified/v3/private/position/set-risk-limit HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672016123862
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "BTCUSDT",
        "riskId": 2,
        "positionIdx": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1672016125676
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/set-mmp.html b/derivatives/unified/set-mmp.html index a554929b63..7ddf55a1b8 100644 --- a/derivatives/unified/set-mmp.html +++ b/derivatives/unified/set-mmp.html @@ -4,7 +4,7 @@ Set MMP | Bybit API Documentation - + @@ -16,7 +16,7 @@ and new orders tagged as MMP will be rejected for a specific duration — known as the frozen period — so that MM can reassess the market and modify the quotes.

    How to enable MMP​

    Send an email to Bybit (financial.inst@bybit.com) or contact your business development (BD) manager to apply for MMP. After processed, the default settings are as below table:

    ParameterTypeCommentsDefault value
    baseCoinstringBase coinBTC
    windowstringTime window (millisecond)5000
    frozenPeriodstringFrozen period (millisecond)100
    qtyLimitstringQuantity limit100
    deltaLimitstringDelta limit100

    Applicable​

    Effective for options only. When you place an option order, set mmp=true, which means you mark this order as a mmp order.

    HTTP Request​

    POST /unified/v3/private/account/mmp-modify

    Request Parameters​

    ParameterRequiredTypeComments
    baseCointruestringBase coin
    windowtruestringTime window (ms)
    frozenPeriodtruestringFrozen period (ms). "0" means the trade will remain frozen until manually reset
    qtyLimittruestringTrade qty limit (positive and up to 2 decimal places)
    deltaLimittruestringDelta limit (positive and up to 2 decimal places)

    Response Parameters​

    None

    Request Example​

    POST /unified/v3/private/account/mmp-modify HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675833524616
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
        "baseCoin": "ETH",
        "window":"5000",
        "frozenPeriod":"100000",
        "qtyLimit":"50",
        "deltaLimit":"20"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/settlement.html b/derivatives/unified/settlement.html index c914f72ba4..f76daaf248 100644 --- a/derivatives/unified/settlement.html +++ b/derivatives/unified/settlement.html @@ -4,13 +4,13 @@ Get USDC Perpetual Settlement | Bybit API Documentation - +

    Get USDC Perpetual Settlement

    Query session settlement records of USDC perpetual

    HTTP Request​

    GET /unified/v3/private/settlement-record

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear
    symbolfalsestringSymbol name
    directionfalsestringprev: previous page, next: next page. Default: next
    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
    nextPageCursorstringCursor. Used to pagination
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > sidestringBuy,Sell
    > sizestringPosition size
    > sessionAvgPricestringSettlement price
    > markPricestringMark price
    > realisedPnlstringRealised PnL
    > timestringSettlement timestamp (ms)

    Request Example​

    GET /unified/v3/private/settlement-record?category=linear&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672020804664
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "nextPageCursor": "1516%3A0%2C1516%3A0",
            "category": "linear",
            "list": [
            {
                "realisedPnl": "0.72230000",
                "symbol": "BTCPERP",
                "side": "Buy",
                "markPrice": "19769.82000000",
                "size": "0.0100",
                "time": "1666828800000",
                "sessionAvgPrice": "19769.82000000"
            },
        ]
    },
        "retExtInfo": {},
        "time": 1672020805170
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/tp-sl-mode.html b/derivatives/unified/tp-sl-mode.html index fb74c77424..1f57e119a9 100644 --- a/derivatives/unified/tp-sl-mode.html +++ b/derivatives/unified/tp-sl-mode.html @@ -4,13 +4,13 @@ Switch TP/SL Mode | Bybit API Documentation - +

    Switch TP/SL Mode

    Set take profit / stop loss mode of the position, such as FULL TP/SL mode or PARTIAL TP/SL mode

    HTTP Request​

    POST /unified/v3/private/position/tpsl/switch-mode

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear only
    symboltruestringSymbol name
    tpSlModetruestringFull, Partial

    Response Parameters​

    None

    Request Example​

    POST /unified/v3/private/position/tpsl/switch-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672016302990
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol":"XRPUSDT",
        "tpSlMode":"Partial"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1672016303452
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/trading-stop.html b/derivatives/unified/trading-stop.html index 26a8449dfd..ef40bfa615 100644 --- a/derivatives/unified/trading-stop.html +++ b/derivatives/unified/trading-stop.html @@ -4,13 +4,13 @@ Set Trading Stop | Bybit API Documentation - +

    Set Trading Stop

    tip

    Pass the following parameters, then the system will create conditional orders. If the position is closed, the system will cancel these orders, and adjust the position size.

    HTTP Request​

    POST /unified/v3/private/position/trading-stop

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear
    symboltruestringSymbol name
    takeProfitfalsestringCannot be less than 0, 0 means cancel TP
    stopLossfalsestringCannot be less than 0, 0 means cancel SL
    trailingStopfalsestringCannot be less than 0, 0 means cancel TS. note: valid for USDT Perpetual only
    tpTriggerByfalsestringTake profit trigger price type. default: LastPrice
    slTriggerByfalsestringStop loss trigger price type. default: LastPrice
    activePricefalsestringTrailing stop trigger price. Trailing stop will be triggered when this price is reached only
    tpSizefalsestringTake profit size. Valid in TP/SL partial mode
    slSizefalsestringStop loss size. Valid in TP/SL partial mode
    positionIdxtrueintegerUsed to identify positions in different position modes. 0: one-way mode for unified margin only

    Response Parameters​

    None

    Request Example​

    POST /unified/v3/private/position/trading-stop HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXX
    X-BAPI-API-KEY: XXXX
    X-BAPI-TIMESTAMP: 1672017116301
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol":"BTCUSDT",
        "takeProfit":"18000",
        "stopLoss":"15500",
        "tpTriggerBy":"MarkPrice",
        "slTriggerBy":"MarkPrice",
        "trailingStop": null,
        "activePrice": null,
        "slSize": "0.05",
        "tpSize": "0.1",
        "positionIdx": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1672017116958
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/transaction-log.html b/derivatives/unified/transaction-log.html index 67e52ec20d..a1ac715320 100644 --- a/derivatives/unified/transaction-log.html +++ b/derivatives/unified/transaction-log.html @@ -4,13 +4,13 @@ Transaction Log | Bybit API Documentation - +

    Transaction Log

    Query transaction logs in Unified account.

    HTTP Request​

    GET /unified/v3/private/account/transaction-log

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear,option
    currencytruestringUSDC、USDT、BTC、ETH
    baseCoinfalsestringbaseCoin
    typefalsestringAll transaction logs under this category are returned (except transfer/exchange/given cash). Note: To query transfer-in and transfer-out logs, type=TRANSFER_IN, type=TRANSFER_OUT must be passed, otherwise the transfer log cannot be found.
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    directionfalsestringDirection: prev: previous page, next: next page, Default: next
    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
    categorystringProduct type
    currencystringUSDC、USDT、BTC、ETH
    listarrayObject
    > transactionTimenumberTransaction timestamp (ms)
    > typestringType
    > symbolstringSymbol name
    > sidestringSide. Buy,Sell,None
    > qtystringQuantity
    > sizeintegerSize
    > tradePricestringTrade price
    > fundingstringFunding fee
    > feestringTrading fee，fees are positive and rebates are negative
    > cashFlowstringCash flow
    > changestringChange
    > cashBalancestringCash balance
    > feeRatestringTrading fee rate
    > tradeIdstringTrade id
    > orderIdstringOrder id
    > orderLinkIdstringUser customised order id
    nextPageCursorstringCursor. Used to pagination

    Request Example​

    GET /unified/v3/private/account/transaction-log?category=linear&currency=USDC&limit=1&type=SETTLEMENT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672023156071
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "nextPageCursor": "1516%3A0%2C1516%3A0",
            "currency": "USDC",
            "category": "linear",
            "list": [
            {
                "symbol": "BTCPERP",
                "side": "None",
                "funding": "0.00000000",
                "orderLinkId": "",
                "orderId": "",
                "fee": "",
                "change": "0.00000000",
                "cashFlow": "0.00000000",
                "transactionTime": 1666857600000,
                "type": "SETTLEMENT",
                "feeRate": "",
                "size": "0.0000",
                "qty": "",
                "cashBalance": "22.96780168",
                "tradePrice": "",
                "tradeId": ""
            }
        ]
    },
        "retExtInfo": {},
        "time": 1672023157776
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/upgrade.html b/derivatives/unified/upgrade.html index b50f0be6cc..7cacd9ac6d 100644 --- a/derivatives/unified/upgrade.html +++ b/derivatives/unified/upgrade.html @@ -4,13 +4,13 @@ Upgrade To Unified Margin Account | Bybit API Documentation - +

    Upgrade To Unified Margin Account

    Upgrade to unified margin account (UMA)

    HTTP Request​

    POST /unified/v3/private/account/upgrade-unified-account

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    statusstringUpgrade status
    > relieveLimitBizResponsearrayempty array if request success
    >> relieveLimitCodestringFail code
    >> relieveLimitMsgstringFail message
    >> relieveLimitMobileUrlstring""
    >> relieveLimitWebUrlstring""
    >> passbooleanwhether to pass the requirement

    Request Example​

    POST /unified/v3/private/account/upgrade-unified-account HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672022838777
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {}

    Response Example​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "result": {
            "status": "FAIL",
            "relieveLimitBizResponse": [
                {
                    "relieveLimitCode": "3400071",
                    "relieveLimitMsg": "unable to upgrade as you haven’t met the minimum asset requirement.",
                    "relieveLimitMobileUrl": "",
                    "relieveLimitWebUrl": "",
                    "pass": false
                },
                {
                    "relieveLimitCode": "3400051",
                    "relieveLimitMsg": "unable to upgrade, please close the usdt perpetual positions in USDT account.",
                    "relieveLimitMobileUrl": "",
                    "relieveLimitWebUrl": "",
                    "pass": false
                }
            ]
    },
        "retExtInfo": {},
        "time": 1672022840011
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/usc-account-info.html b/derivatives/unified/usc-account-info.html index 95c39ece0c..38b041a73f 100644 --- a/derivatives/unified/usc-account-info.html +++ b/derivatives/unified/usc-account-info.html @@ -4,13 +4,13 @@ Account Info | Bybit API Documentation - +

    Account Info

    Query the configuration under the account.

    HTTP Request​

    GET /unified/v3/private/account/info

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    unifiedMarginStatusintegerAccount status
    marginModestringREGULAR_MARGIN, PORTFOLIO_MARGIN
    dcpStatusstringDisconnected-CancelAll-Prevention status: ON, OFF
    timeWindowintegerDCP trigger time window which user pre-set. Between [10, 300] seconds, default: 10 sec
    smpGroupintegerSmp group ID. If the uid has no group, it is 0 by default
    updatedTimestringAccount data updated timestamp (ms)

    Request Example​

    GET /unified/v3/private/account/info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672023630281
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "marginMode": "REGULAR_MARGIN",
            "updatedTime": "1672918286000",
            "unifiedMarginStatus": 3,
            "dcpStatus": "ON",
            "timeWindow": 30,
            "smpGroup": 0
        }
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/usc-margin-mode.html b/derivatives/unified/usc-margin-mode.html index 6c33dd38a2..4e30ea855e 100644 --- a/derivatives/unified/usc-margin-mode.html +++ b/derivatives/unified/usc-margin-mode.html @@ -4,13 +4,13 @@ Set Margin Mode | Bybit API Documentation - +

    Set Margin Mode

    Default is the regular margin mode. This mode is valid for USDT Perp, USDC Perp and Option.

    HTTP Request​

    POST /unified/v3/private/account/setMarginMode

    Request Parameters​

    ParameterRequiredTypeComments
    setMarginModetruestringREGULAR_MARGIN, PORTFOLIO_MARGIN

    Response Parameters​

    ParameterTypeComments
    reasonsarrayEmpty array if the request is submitted successfully. Otherwise, there are failure Object
    > reasonCodestringFail reason code
    > reasonMsgstringFail reason msg

    Request Example​

    POST /unified/v3/private/account/setMarginMode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672023475526
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "setMarginMode": "REGULAR_MARGIN"
    }

    Response Example​

    {
        "retCode": 3400045,
        "retMsg": "Set margin mode failed",
        "result": {
            "reasons": [
                {
                    "reasonCode": "3400102",
                    "reasonMsg": "Please ensure that there are no active orders in your USDC account, including Limit, Market and Conditional orders"
                },
                {
                    "reasonCode": "3400101",
                    "reasonMsg": "Please ensure that there are no positions in your USDC account, including USDC perpetual and options"
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/derivatives/unified/wallet.html b/derivatives/unified/wallet.html index 0d45f76166..644d77f786 100644 --- a/derivatives/unified/wallet.html +++ b/derivatives/unified/wallet.html @@ -4,13 +4,13 @@ Wallet Balance | Bybit API Documentation - +

    Wallet Balance

    Get wallet balance

    HTTP Request​

    GET /unified/v3/private/account/wallet/balance

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin name

    Response Parameters​

    ParameterTypeComments
    accountIMRatestringInitial Margin Rate: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
    accountMMRatestringMaintenance Margin Rate: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
    totalEquitystringEquity of account converted to usd：Account Margin Balance Base Coin + Account Option Value Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
    totalWalletBalancestringWallet Balance of account converted to usd：∑ Asset Wallet Balance Base Coin。In non-uniform margin mode, the field will be returned as an empty string.
    totalMarginBalancestringMargin Balance of account converted to usd：Account Wallet Balance Base Coin + Account Perp UPL Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
    totalAvailableBalancestringAvailable Balance of account converted to usd：RM：Account Margin Balance Base Coin - Account Initial Margin Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
    totalPerpUPLstringUnrealised P&L of perpetuals of account converted to usd：∑ Asset Perp UPL Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
    totalInitialMarginstringInitial Margin of account converted to usd：∑ Asset Total Initial Margin Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
    totalMaintenanceMarginstringMaintenance Margin of account converted to usd: ∑ Asset Total Maintenance Margin Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
    coinarrayObject
    > currencyCoinstringCoin name, such as BTC, ETH, USDT, USDC
    > availableToBorrowstringDepreciated field, always return "" due to feature of main-sub uid sharing borrow quota
    > borrowSizestringLending amount used. For USDC and USDT only. For BTC and ETH, return 0
    > bonusstringTrial fund
    > accruedIntereststringAccrued interest of an asset
    > availableBalanceWithoutConvertstringAvailable balance, Margin Balance - Total Initial Margin
    > totalOrderIMstringOrder margin pre-occupied. For portfolio margin mode, it returns ""
    > equitystringEquity
    > totalPositionMMstringSum of maintenance margin for all positions. For portfolio margin mode, it returns ""
    > usdValuestringusd value
    > availableBalancestringAB from other assets + the actual AB balance from the current assets (cannot be negative)
    > unrealisedPnlstringUnrealised P&L
    > totalPositionIMstringSum of initial margin of all positions + Pre-occupied liquidation fee. For portfolio margin mode, it returns ""
    > marginBalanceWithoutConvertstringMargin balance
    > walletBalancestringWallet balance
    > cumRealisedPnlstringCumulative Realised P&L
    > marginBalancestringMB from other assets + the actual MB balance from the current assets

    Request Example​

    GET /unified/v3/private/account/wallet/balance?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672021457498
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "totalEquity": "5952.13539158",
            "accountIMRate": "0.1037",
            "totalMarginBalance": "6003.96034690",
            "totalInitialMargin": "622.37237856",
            "totalAvailableBalance": "5381.58796835",
            "accountMMRate": "0.0361",
            "totalPerpUPL": "-733.16272882",
            "totalWalletBalance": "6733.45726207",
            "totalMaintenanceMargin": "216.49590186",
            "coin": [
            {
                "currencyCoin": "ETH",
                "availableToBorrow": "0.00000000",
                "borrowSize": "0.00000000",
                "bonus": "0.00000000",
                "accruedInterest": "0.00000000",
                "availableBalanceWithoutConvert": "0.00000000",
                "totalOrderIM": "",
                "equity": "0.00000000",
                "totalPositionMM": "",
                "usdValue": "0.00000000",
                "availableBalance": "4.41128415",
                "unrealisedPnl": "",
                "totalPositionIM": "",
                "marginBalanceWithoutConvert": "0.00000000",
                "walletBalance": "0.00000000",
                "cumRealisedPnl": "",
                "marginBalance": "4.92144238"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1672021457963
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-contract/execution.html b/derivatives/ws-contract/execution.html index 43ff9427da..9ce581095c 100644 --- a/derivatives/ws-contract/execution.html +++ b/derivatives/ws-contract/execution.html @@ -4,14 +4,14 @@ Execution | Bybit API Documentation - +

    Execution

    Subscribe to the execution stream to see when an open order gets filled or partially filled.

    Covers: USDT Perpetual, Inverse Perpetual, Inverse Future

    Push frequency: real-time

    Topic: user.execution.contractAccount

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    dataarrayObject
    > symbolstringSymbol name
    > sidestringSide. Buy,Sell
    > execIdstringtransaction ID
    > feeRatestringTrading fee rate
    > execFeestringExecuted fee
    > execPricestringExecuted price
    > execQtystringExecuted qty
    > leavesQtystringRemaining order qty waiting to be executed
    > execTypestringExecuted type
    > execValuestringExecuted value
    > lastLiquidityIndstringLiquidity index. AddLiquidity,RemovedLiquidity
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    > orderPricestringOrder price
    > orderQtystringOrder qty
    > orderTypestringOrder type. Market,Limit
    > stopOrderTypestringStop order type. No stop order type if the order is not stop order
    > execTimestringTransaction timestamp (ms)
    > closedSizestringPosition size to be closed
    > blockTradeIdstringParadigm block trade ID
    > markPricestringMark price

    Stream Example​

    {
        "topic": "user.execution.contractAccount",
        "data": [
            {
                "symbol": "ETHUSDT",
                "execFee": "0.1017888",
                "execId": "8b4b2e8c-caa1-5fde-be59-d483166885e7",
                "execPrice": "1696.48",
                "execQty": "0.1",
                "execType": "Trade",
                "execValue": "169.648",
                "feeRate": "0.0006",
                "lastLiquidityInd": "RemovedLiquidity",
                "leavesQty": "0",
                "orderId": "cd2f6f95-8031-4272-9339-e7054ff56567",
                "orderLinkId": "",
                "orderPrice": "1781.09",
                "orderQty": "0.1",
                "orderType": "Market",
                "stopOrderType": "UNKNOWN",
                "side": "Buy",
                "execTime": "1676885237382",
                "closedSize": "0",
                "blockTradeId": "",
                "markPrice": "1696.25"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-contract/order.html b/derivatives/ws-contract/order.html index 7f22ac3595..a4dafa39fb 100644 --- a/derivatives/ws-contract/order.html +++ b/derivatives/ws-contract/order.html @@ -4,14 +4,14 @@ Order | Bybit API Documentation - +

    Order

    Subscribe to the order stream to see new orders, when an order's order status changes, etc.

    Covers: USDT Perpetual, Inverse Perpetual, Inverse Future

    Push frequency: real-time

    Topic: user.order.contractAccount

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    dataarrayObject
    > symbolstringSymbol name
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    > sidestringSide. Buy,Sell
    > orderTypestringOrder type. Market,Limit. For TP/SL order, it means the order type after triggered
    > stopOrderTypestringStop order type
    > pricestringOrder price
    > qtystringOrder qty
    > blockTradeIdstringBlock trade ID
    > timeInForcestringTime in force
    > orderStatusstringOrder status
    > positionIdxintegerPosition index. Used to identify positions in different position modes
    > cancelTypestringCancel type
    > rejectReasonstringReject reason
    > avgPricestringAverage filled price. If unfilled, it is ""
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > tpslModestringTP/SL mode, Full: entire position for TP/SL. Partial: partial position tp/sl
    > tpLimitPricestringThe limit order price when take profit price is triggered
    > slLimitPricestringThe limit order price when stop loss price is triggered
    > tpTriggerBystringTake profit price trigger by
    > slTriggerBystringStop loss price trigger by
    > triggerPricestringTrigger price
    > triggerDirectioninteger0: rise, 1: fall
    > triggerBystringTrigger by
    > reduceOnlybooleanReduce only. true means reduce the position
    > closeOnTriggerbooleanClose on trigger
    > leavesQtystringRemaining order qty waiting to be executed
    > leavesValuestringThe remaining value not executed
    > lastExecQtystringLast executed qty
    • If order status is Filled or Partially Filled, then this field means Executed qty
    • If the orders status is Cancelled, then this field means leaves qty
    > lastExecPricestringLast executed price
    > cumExecFeestringCumulative executed trading fee
    > cumExecQtystringCumulative executed qty
    > cumExecValuestringCumulative executed value
    > smpTypestringSMP execution type
    > smpGroupintegerSmp group ID. If the uid has no group, it is 0 by default
    > smpOrderIdstringThe counterparty's orderID which triggers this SMP execution
    > createdTimestringOrder created timestamp (ms)
    > updatedTimestringOrder updated timestamp (ms)

    Stream Example​

    {
        "topic": "user.order.contractAccount",
        "data": [
            {
                "symbol": "ETHUSDT",
                "orderId": "e62a3099-eced-499f-bd81-185e8747187f",
                "side": "Buy",
                "orderType": "Market",
                "stopOrderType": "UNKNOWN",
                "price": "1622.55",
                "qty": "0.2",
                "timeInForce": "ImmediateOrCancel",
                "orderStatus": "Filled",
                "triggerPrice": "0.00",
                "orderLinkId": "",
                "createdTime": "1675999655229",
                "updatedTime": "1675999655232",
                "takeProfit": "0.00",
                "stopLoss": "0.00",
                "tpslMode": "Full",
                "tpLimitPrice": "",
                "slLimitPrice": "",
                "tpTriggerBy": "UNKNOWN",
                "slTriggerBy": "UNKNOWN",
                "triggerBy": "UNKNOWN",
                "reduceOnly": false,
                "closeOnTrigger": false,
                "triggerDirection": 0,
                "leavesQty": "0",
                "lastExecQty": "0.2",
                "lastExecPrice": "1545.30",
                "cumExecQty": "0.2",
                "cumExecValue": "309.06",
                "avgPrice": "1545.30",
                "blockTradeId": "",
                "cancelType": "UNKNOWN",
                "cumExecFee": "0.185436",
                "leavesValue": "0",
                "positionIdx": 1,
                "rejectReason": "EC_NoError",
                "smpType": "None",
                "smpGroup": 0,
                "smpOrderId": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-contract/position.html b/derivatives/ws-contract/position.html index bed81dfe19..38102acf9a 100644 --- a/derivatives/ws-contract/position.html +++ b/derivatives/ws-contract/position.html @@ -4,14 +4,14 @@ Position | Bybit API Documentation - +

    Position

    Subscribe to the position stream to see changes to your position size, position setting changes, etc.

    Covers: USDT Perpetual, Inverse Perpetual, Inverse Future

    Topic: user.position.contractAccount

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    dataarrayObject
    > symbolstringSymbol name
    > riskIdintegerRisk limit id
    > riskLimitValuestringRisk limit value
    > sidestringSide. Buy,Sell
    > sizestringPosition size
    > entryPricestringAverage entry price
    > positionValuestringEntry position value
    > positionIdxintegerPosition idx, used to identify positions in different position modes
    • 0: One-Way Mode
    • 1: Buy side of both side mode
    • 2: Sell side of both side mode
    > tradeModeintegerTrade mode. 0: cross margin, 1: isolated margin
    > autoAddMarginintegerAuto add margin. 0: false, 1: true
    > leveragestringPosition leverage
    > positionBalancestringPosition margin
    > markPricestringMark price
    > liqPricestringLiquidation price. It returns value only when minPrice < liqPrice < maxPrice
    > bustPricestringBankruptcy price
    > tpSlModestringDepreciated, meaningless here, always "Full"
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > trailingStopstringTrailing stop
    > activePricestringTrailing stop trigger price
    > unrealisedPnlstringUnrealised PnL
    > cumRealisedPnlstringCumulative realized P&L
    > occClosingFeestringPosition closing fee occupied
    > sessionAvgPricestringSettlement price
    > positionStatusstringPosition status
    > positionMMstringPosition Initial margin
    > positionIMstringPosition Maintenance margin
    > createdTimestringPosition created timestamp (ms)
    > updatedTimestringPosition data updated timestamp (ms)
    > adlRankIndicatorintegerAuto-deleverage rank indicator. What is Auto-Deleveraging?
    > isReduceOnlybooleanUseful when Bybit lower the risk limit
    • true: Only allowed to reduce the position. You can consider a series of measures, e.g., lower the risk limit, decrease leverage or reduce the position, add margin, or cancel orders, after these operations, you can call confirm new risk limit endpoint to check if your position can be removed the reduceOnly mark
    • false: There is no restriction, and it means your position is under the risk when the risk limit is systematically adjusted
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > mmrSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the MMR will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the MMR had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > leverageSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the leverage will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the leverage had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others

    Stream Example​

    {
        "topic": "user.position.contractAccount",
        "data": [
            {
                "positionIdx": 0,
                "riskId": 1,
                "symbol": "ARBUSDT",
                "side": "None",
                "size": "0",
                "positionValue": "0",
                "entryPrice": "0",
                "tradeMode": 0,
                "autoAddMargin": 0,
                "leverage": "10",
                "positionBalance": "0",
                "liqPrice": "",
                "bustPrice": "0.0000",
                "takeProfit": "0.0000",
                "stopLoss": "0.0000",
                "trailingStop": "0.0000",
                "unrealisedPnl": "0",
                "createdTime": "1695115891722",
                "updatedTime": "1697686565866",
                "tpSlMode": "Full",
                "sessionAvgPrice": "0.0000",
                "positionStatus": "Normal",
                "occClosingFee": "0",
                "markPrice": "0.7747",
                "cumRealisedPnl": "21.84890946",
                "activePrice": "0.0000",
                "riskLimitValue": "200000",
                "positionMM": "0",
                "positionIM": "0",
                "adlRankIndicator": 0,
                "isReduceOnly": false,
                "mmrSysUpdateTime": "",
                "leverageSysUpdatedTime": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-contract/wallet.html b/derivatives/ws-contract/wallet.html index 1717d5700b..15194fdf57 100644 --- a/derivatives/ws-contract/wallet.html +++ b/derivatives/ws-contract/wallet.html @@ -4,14 +4,14 @@ Wallet | Bybit API Documentation - +

    Wallet

    Subscribe to the wallet stream to see changes to your wallet in real-time.

    Covers: USDT Perpetual, Inverse Perpetual, Inverse Future

    Push frequency: real-time

    Topic: user.wallet.contractAccount

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    dataarrayObject
    > coinstringCoin
    > equitystringEquity
    > walletBalancestringWallet balance
    > positionMarginstringPosition margin
    > availableBalancestringAvailable balance
    > orderMarginstringOrder margin. Margin is occupied by open orders
    > unrealisedPnlstringUnrealised pnl
    > cumRealisedPnlstringCumulative realised pnl

    Stream Example​

    {
        "topic": "user.wallet.contractAccount",
        "data": [
            {
                "coin": "USDT",
                "equity": "8538.34927711",
                "walletBalance": "8505.77505604",
                "positionMargin": "58.93257631",
                "availableBalance": "8436.20247873",
                "orderMargin": "10.640001",
                "unrealisedPnl": "32.57422107",
                "cumRealisedPnl": "-195.05231821"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-public/kline.html b/derivatives/ws-public/kline.html index 06cd9ccaa6..15c8e9b557 100644 --- a/derivatives/ws-public/kline.html +++ b/derivatives/ws-public/kline.html @@ -4,14 +4,14 @@ Kline | Bybit API Documentation - +

    Kline

    Covers: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future

    Interval supported:

    • 1 3 5 15 30 60 120 240 360 720 minute
    • D day
    • W week
    • M month
    info

    If confirm is true, then the data is a final tick for this interval. Otherwise, it is a snapshot.

    Push frequency: 1-60s

    Topic: kline.{interval}.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataarrayObject
    > startnumberCandle start timestamp (ms)
    > endnumberCandle end timestamp (ms)
    > intervalstringInterval
    > openstringOpen price
    > closestringClose price. If not closed, it is last price
    > highstringHighest price
    > lowstringLowest price
    > volumestringTrading volume
    > turnoverstringTrading turnover
    > confirmbooleantrue: last tick. false: this is snapshot data
    > timestampnumberThe timestamp (ms) of the last matched order in the candle

    Subscription Example​

    {
        "op": "subscribe",
        "args": [
        "kline.5.BTCPERP"
        ],
        "req_id": "test" // optional
    }

    Stream Example​

    {
        "topic": "kline.5.BTCPERP",
        "data": [
            {
                "start": 1671187800000,
                "end": 1671188099999,
                "interval": "5",
                "open": "16991",
                "close": "16980.5",
                "high": "16991",
                "low": "16980.5",
                "volume": "2.501",
                "turnover": "42493.2305",
                "confirm": false,
                "timestamp": 1671187815755
            }
        ],
        "ts": 1671187815755,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-public/liquidation.html b/derivatives/ws-public/liquidation.html index ac4847cc3e..33f278dcfb 100644 --- a/derivatives/ws-public/liquidation.html +++ b/derivatives/ws-public/liquidation.html @@ -4,14 +4,14 @@ Liquidation | Bybit API Documentation - +

    Liquidation

    Get recent liquidation orders in Bybit, at most one order is published per second per symbol

    Covers: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future

    Push frequency: 1s

    Topic: liquidation.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataarrayObject
    > updatedTimenumberData updated timestamp (ms)
    > symbolstringSymbol name
    > sizestringFilled size
    > pricestringFilled price
    > sidestringSide

    Subscription Example​

    {
        "op": "subscribe",
        "args": [
          "liquidation.GALAUSDT"
        ],
        "req_id": "test" // optional
    }

    Stream Example​

    {
        "data": {
            "price": "0.03803",
            "side": "Buy",
            "size": "1637",
            "symbol": "GALAUSDT",
            "updatedTime": 1673251091822
        },
        "topic": "liquidation.GALAUSDT",
        "ts": 1673251091822,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-public/orderbook.html b/derivatives/ws-public/orderbook.html index 12eeca5b34..517b8bbf19 100644 --- a/derivatives/ws-public/orderbook.html +++ b/derivatives/ws-public/orderbook.html @@ -4,14 +4,14 @@ Orderbook | Bybit API Documentation - +

    Orderbook

    Get different depth

    Covers: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future, Option

    info
    • Once subscribe successfully, you will receive a snapshot first.
    • For snapshot stream, it is sort by order price, which bids is from highest to lowest and asks is from lowest to highest
    • Websocket will keep pushing delta message when orderbook is changed.
    • If you receive a new snapshot data, it is necessary to reset your local orderbook.
    • If there is a problem in bybit end, it will re-send a snapshot, which is promised the latest and accurate.
    tip

    Linear & inverse level 1 data: if 3 seconds have elapsed without a change in the orderbook, a snapshot message will be pushed again.

    Linear & Inverse:

    • Level 1 data, push frequency: 10ms
    • Level 50 data, push frequency: 20ms
    • Level 200 data, push frequency: 100ms
    • Level 500 data, push frequency: 100ms

    Option:

    • Level 25 data, push frequency: 20ms
    • Level 100 data, push frequency: 100ms

    Topic: (note: option has 25 & 100 level only)
    orderbook.{depth}.{symbol} e.g., orderbook.1.BTCUSDT

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringMessage type. snapshot,delta
    tsnumberThe timestamp (ms) that system generates the data.
    dataObject
    > sStringSymbol name
    > barray<array>Bid array
    >> b[0][0]stringBid price
    >> b[0][1]stringBid size
    > sarray<array>Ask array
    >> s[0][0]stringAsk price
    >> s[0][1]stringAsk size
    > unumberUpdate id, is always in sequence. Occasionally, you'll receive "u"=1, which is a snapshot data due to the restart of the service. So please overwrite the locally saved orderbook
    > seqnumberCross sequence (internal value)

    Subscription Example​

    {
        "op": "subscribe",
        "args": [
        "orderbook.50.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    Stream Example​

    {
        "topic": "orderbook.50.BTCUSDT",
        "type": "snapshot",
        "ts": 1671179923028,
        "data": {
            "s": "BTCUSDT",
            "b": [
                [
                    "17440.00",
                    "40.833"
                ],
                [
                    "17439.50",
                    "0.513"
                ],
                ...
                [
                    "17416.00",
                    "6.156"
                ],
                [
                    "17415.50",
                    "32.268"
                ]
        ],
        "a": [
            [
                "17440.50",
                "78.815"
            ],
            [
                "17441.00",
                "8.858"
            ],
            ...
            [
                "17464.50",
                "4.901"
            ],
            [
                "17465.00",
                "5.744"
            ]
        ],
        "u": 13079592,
        "seq": 22520573250
        }
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-public/ticker.html b/derivatives/ws-public/ticker.html index 7ed037e61f..d6a189f508 100644 --- a/derivatives/ws-public/ticker.html +++ b/derivatives/ws-public/ticker.html @@ -4,14 +4,14 @@ Tickers | Bybit API Documentation - +

    Tickers

    Cover: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future, Option

    Get latest information of the symbol

    important
    • Future has snapshot and delta types. If a key does not exist in the field, it means the value is not changed.
    • Option has snapshot data only.

    Push frequency: 100ms

    Topic: tickers.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot,delta
    csintegerCross sequence
    tsnumberThe timestamp (ms) that the system generates the data
    dataarrayObject
    > symbolstringSymbol name
    > tickDirectionstringTick direction
    > price24hPcntstringPercentage change of market price in the last 24 hours
    > lastPricestringLast price
    > prevPrice24hstringMarket price 24 hours ago
    > highPrice24hstringThe highest price in the last 24 hours
    > lowPrice24hstringThe lowest price in the last 24 hours
    > prevPrice1hstringMarket price an hour ago
    > markPricestringMark price
    > indexPricestringIndex price
    > openIntereststringOpen interest size
    > openInterestValuestringOpen interest value
    > turnover24hstringTurnover for 24h
    > volume24hstringVolume for 24h
    > nextFundingTimestringNext funding timestamp (ms)
    > fundingRatestringFunding rate
    > bid1PricestringBest bid price
    > bid1SizestringBest bid size
    > ask1PricestringBest ask price
    > ask1SizestringBest ask size

    Subscription Example​

    {
        "op": "subscribe",
        "args": [
            "tickers.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    Stream Example​

    {
        "topic": "tickers.BTCUSDT",
        "type": "snapshot",
        "data": {
            "symbol": "BTCUSDT",
            "tickDirection": "MinusTick",
            "price24hPcnt": "0.017367",
            "lastPrice": "17222.00",
            "prevPrice24h": "16928.00",
            "highPrice24h": "17281.50",
            "lowPrice24h": "16915.00",
            "prevPrice1h": "17238.00",
            "markPrice": "17224.40",
            "indexPrice": "17234.84",
            "openInterest": "68795.534",
            "openInterestValue": "1184961795.83",
            "turnover24h": "1572429119.324499",
            "volume24h": "91823.449",
            "nextFundingTime": "1673280000000",
            "fundingRate": "-0.000211",
            "bid1Price": "17222.00",
            "bid1Size": "220.358",
            "ask1Price": "17222.50",
            "ask1Size": "3.902"
        },
        "cs": 24988405605,
        "ts": 1673273043686
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-public/trade.html b/derivatives/ws-public/trade.html index 5f6382856c..5ab54d4f21 100644 --- a/derivatives/ws-public/trade.html +++ b/derivatives/ws-public/trade.html @@ -4,14 +4,14 @@ Public Trade | Bybit API Documentation - +

    Public Trade

    Get recent public trades data in Bybit.

    Cover: USDT Perpetual, USDC Perpetual, Inverse Perpetual, Inverse Future, Option

    info

    After subscription, you will be pushed delta trade message in real-time once there is an order filled.

    Push frequency: real-time

    Topic: publicTrade.{symbol}

    For option, it should use base coin, e.g., publicTrade.BTC

    Response Parameters​

    ParameterTypeComments
    idstringMessage id. Unique field for option
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataarrayObject. The element in the array is sort by matching time in ascending order
    > TnumberThe timestamp (ms) that the order is filled
    > sstringSymbol name
    > SstringSide of taker. Buy,Sell
    > vstringqty
    > pstringExecuted price
    > LstringDirection of price change. Unique field for future
    > istringTrade id
    > BTbooleanBlock trade or not
    > mPstringMark price, unique field for option
    > iPstringIndex price, unique field for option
    > mIvstringMark iv, unique field for option
    > ivstringiv, unique field for option

    Request Example​

    {
        "op": "subscribe",
        "args": [
        "publicTrade.BTCPERP"
        ],
        "req_id": "test" // optional
    }

    Response Example​

    {
        "topic": "publicTrade.BTCPERP",
        "type": "snapshot",
        "ts": 1671181689023,
        "data": [
            {
                "T": 1671181689021,
                "s": "BTCPERP",
                "S": "Buy",
                "v": "0.002",
                "p": "17032.50",
                "L": "MinusTick",
                "i": "d9cd8295-40dc-5dce-8deb-42882580a7ab",
                "BT": false
            }
        ]
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-unified/execution.html b/derivatives/ws-unified/execution.html index 2bf5a8199d..13ad23bd14 100644 --- a/derivatives/ws-unified/execution.html +++ b/derivatives/ws-unified/execution.html @@ -4,14 +4,14 @@ Execution | Bybit API Documentation - +

    Execution

    Subscribe to the execution stream. Will not push funding payments unless they occur on a USDT perpetual, eg BTCUSDT.

    tip

    You may have multiple pushes for one order.

    Topic:
    user.execution.unifiedAccount

    Response Parameters​

    ParameterTypeComments
    idstringMessage id
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataObject
    > versionintegerVersion
    > resultarrayObject
    >> symbolstringSymbol name
    >> orderIdstringOrder id
    >> sidestringSide. Buy,Sell
    >> orderLinkIdstringUser customized order id
    >> orderPricestringOrder price
    >> orderQtystringOrder qty
    >> orderTypestringOrder type
    >> execIdstringExecution id
    >> execPricestringExecution price
    >> execQtystringExecution qty
    >> execValuestringExecuted order value
    >> feeRatestringTrading fee rate
    >> execFeestringExecuted trading fee
    >> execTimestringExecuted timestamp (ms)
    >> execTypestringExecuted type. TRADE,ADLTRADE,FUNDING,BUSTTRADE,SETTLE
    >> lastLiquidityIndstringLiquidity index. TAKER, MAKER
    >> leavesQtystringThe remaining qty not executed
    >> stopOrderTypestringStop order type. If the order is not stop order, any type is not returned
    >> blockTradeIdstringParadigm block trade ID

    Stream Example​

    {
        "id": "533285750bcd0d-6878-4db4-bc15-71207e39acda",
        "topic": "user.execution.unifiedAccount",
        "ts": 1672824334832,
        "data": {
            "result": [
                {
                    "symbol": "ARUSDT",
                    "execFee": "1.399224",
                    "execId": "b90dc5f2-0a01-53e7-b1c5-aa7dfbe774da",
                    "execPrice": "6.92",
                    "execQty": "337",
                    "execType": "TRADE",
                    "execValue": "2332.04",
                    "feeRate": "0.0006",
                    "lastLiquidityInd": "TAKER",
                    "leavesQty": "0",
                    "orderId": "496929da-6243-4f40-b621-267f9611e565",
                    "orderLinkId": "",
                    "orderPrice": "6.58",
                    "orderQty": "337",
                    "orderType": "Market",
                    "stopOrderType": "",
                    "side": "Sell",
                    "execTime": 1672824334817,
                    "blockTradeId": ""
                }
            ],
            "version": 177285
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-unified/greek.html b/derivatives/ws-unified/greek.html index 0185491597..b775db505a 100644 --- a/derivatives/ws-unified/greek.html +++ b/derivatives/ws-unified/greek.html @@ -4,14 +4,14 @@ Greek | Bybit API Documentation - +

    Greek

    Subscribe to the user greeks stream, option only.

    Topic:
    user.greeks.unifiedAccount

    Response Parameters​

    ParameterTypeComments
    idstringMessage id
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataObject
    > versionintegerVersion
    > resultObject
    >> baseCoinstringBase coin
    >> totalDeltastringDelta value
    >> totalGammastringGamma value
    >> totalVegastringVega value
    >> totalThetastringTheta value

    Stream Example​

    {
        "id": "53328593eddf20-ebe8-47d9-8a2b-62e4e2681eaa",
        "topic": "user.greeks.unifiedAccount",
        "ts": 1672107550646,
        "data": {
            "result": [
                {
                    "baseCoin": "BTC",
                    "totalDelta": "-0.02077347",
                    "totalGamma": "-0.00004675",
                    "totalVega": "-0.52558304",
                    "totalTheta": "3.48921259"
                },
                {
                    "baseCoin": "ETH",
                    "totalDelta": "0.05003533",
                    "totalGamma": "-0.00000063",
                    "totalVega": "-0.00014849",
                    "totalTheta": "0.0041225"
                }
            ],
            "version": 62056
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-unified/order.html b/derivatives/ws-unified/order.html index 6db4b0045a..0ddc5c2019 100644 --- a/derivatives/ws-unified/order.html +++ b/derivatives/ws-unified/order.html @@ -4,14 +4,14 @@ Order | Bybit API Documentation - +

    Order

    Subscribe to the order stream to see new orders, when an order's order status changes, etc.

    Topic:
    user.order.unifiedAccount

    Response Parameters​

    ParameterTypeComments
    idstringMessage id
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataObject
    > versionintegerVersion
    > resultarrayObject
    >> symbolstringSymbol name
    >> sidestringSide. Buy,Sell
    >> orderIdstringOrder id
    >> orderLinkIdstringUser customised order id
    >> orderTypestringOrder type. Market,Limit
    >> stopOrderTypestringStop order type
    >> orderStatusstringOrder status
    >> pricestringOrder price
    >> qtystringOrder qty
    >> timeInForcestringTime in force
    >> cumExecQtystringCumulative executed order qty
    >> cumExecValuestringCumulative executed order value
    >> cumExecFeestringCumulative executed trading fee
    >> leavesQtystringThe remaining qty not executed
    >> triggerBystringThe price type of trigger price
    >> triggerPricestringTrigger price. If stopOrderType=TrailingStop, it is activate price. Otherwise, it is trigger price
    >> reduceOnlybooleanReduce only. true means reduce position size
    >> closeOnTriggerbooleanClose on trigger. What is a close on trigger order?
    >> ivstringImplied volatility
    >> orderIMstringOrder initial margin. For portfolio margin mode, it returns ""
    >> takeProfitstringTake profit price
    >> stopLossstringStop loss price
    >> tpTriggerBystringThe price type to trigger take profit
    >> slTriggerBystringThe price type to trigger stop loss
    >> basePricestringBase price
    >> blockTradeIdstringBlock trade ID
    >> createdTimenumberOrder created timestamp (ms)
    >> updatedTimenumberOrder updated timestamp (ms)

    Stream Example​

    {
        "id": "533285293a44e9-7925-445c-a62c-01d7726c6543",
        "topic": "user.order.unifiedAccount",
        "ts": 1672063477614,
        "data": {
            "result": [
                {
                    "orderId": "38554b22-e4fa-4327-9250-3fc81aa4e30a",
                    "orderLinkId": "",
                    "symbol": "SCUSDT",
                    "side": "Sell",
                    "orderType": "Market",
                    "price": "0.00224",
                    "qty": "100",
                    "timeInForce": "ImmediateOrCancel",
                    "orderStatus": "Filled",
                    "cumExecQty": "100",
                    "cumExecValue": "0.234",
                    "cumExecFee": "0.0001404",
                    "stopOrderType": "UNKNOWN",
                    "triggerBy": "UNKNOWN",
                    "triggerPrice": "0",
                    "reduceOnly": true,
                    "closeOnTrigger": true,
                    "createdTime": 1672063477568,
                    "updatedTime": 1672063477578,
                    "iv": "",
                    "orderIM": "",
                    "takeProfit": "0",
                    "stopLoss": "0",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "basePrice": "0.00235",
                    "blockTradeId": "",
                    "leavesQty": "0"
                }
            ],
            "version": 17965
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-unified/position.html b/derivatives/ws-unified/position.html index c36dba14d8..d91038cb6a 100644 --- a/derivatives/ws-unified/position.html +++ b/derivatives/ws-unified/position.html @@ -4,14 +4,14 @@ Position | Bybit API Documentation - +

    Position

    Subscribe to the position stream to see changes to your position size, position setting changes, etc.

    Topic:
    user.position.unifiedAccount

    Response Parameters​

    ParameterTypeComments
    idstringMessage id
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataObject
    > versionintegerVersion
    > resultarrayObject
    >> symbolstringSymbol name
    >> sidestringPosition side. Buy,Sell
    >> sizestringPosition size
    >> positionIdxintegerUsed to identify positions in different position modes
    >> riskIdintegerRisk limit id. Note: for portfolio margin mode, it returns 0, which the risk limit rule is invalid
    >> leveragestringLeverage. Note: for portfolio margin mode, it returns "", which the leverage rule is invalid
    >> entryPricestringAverage entry price
    >> markPricestringCurrent mark price
    >> positionValuestringPosition value
    >> positionIMstringPosition initial margin. Note: for portfolio margin mode, it returns ""
    >> positionMMstringPosition maintenance margin. Note: for portfolio margin mode, it returns ""
    >> tpslModestringTP/SL mode. Full,Partial
    >> takeProfitstringTake profit price
    >> stopLossstringStop loss price
    >> trailingStopstringTrailing stop
    >> unrealisedPnlstringUnrealised PnL
    >> cumRealisedPnlstringCumulative realised PnL
    >> sessionAvgPricestringSession avg price. option does not have this field
    >> createdTimenumberCreated timestamp (ms)
    >> updatedTimenumberUpdated timestamp (ms)

    Stream Example​

    {
        "id": "533285d3534ad0-0cab-477b-95fa-d8efa92e3a00",
        "topic": "user.position.unifiedAccount",
        "ts": 1672103585576,
        "data": {
            "result": [
                {
                    "positionIdx": 0,
                    "riskId": 11,
                    "symbol": "ETHUSDT",
                    "side": "Buy",
                    "size": "0.15",
                    "entryPrice": "1072.54285714",
                    "leverage": "11",
                    "markPrice": "1215.38",
                    "positionIM": "14.71334027",
                    "positionMM": "0.89216153",
                    "takeProfit": "0",
                    "stopLoss": "0",
                    "trailingStop": "0",
                    "positionValue": "160.88142858",
                    "unrealisedPnl": "21.42557142",
                    "cumRealisedPnl": "80.35333206",
                    "createdTime": 0,
                    "updatedTime": 1672103585565,
                    "tpslMode": "Partial"
                }
            ],
            "version": 58085
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/derivatives/ws-unified/wallet.html b/derivatives/ws-unified/wallet.html index 8e168f4257..8d4ca33263 100644 --- a/derivatives/ws-unified/wallet.html +++ b/derivatives/ws-unified/wallet.html @@ -4,14 +4,14 @@ Wallet | Bybit API Documentation - +

    Wallet

    Subscribe to the wallet stream to see changes to your wallet in real-time.

    Topic:
    user.wallet.unifiedAccount

    Response Parameters​

    ParameterTypeComments
    idstringMessage id
    topicstringTopic name
    typestringMessage type. snapshot
    tsnumberThe timestamp (ms) that system generates the data.
    dataObject
    > versionintegerVersion
    > resultObject
    >> accountIMRatestringInitial Margin Rate: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin.
    >> accountMMRatestringMaintenance Margin Rate: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin.
    >> totalEquitystringEquity of account converted to usd：Account Margin Balance Base Coin + Account Option Value Base Coin.
    >> totalWalletBalancestringWallet Balance of account converted to usd：∑ Asset Wallet Balance Base Coin
    >> totalMarginBalancestringMargin Balance of account converted to usd：Account Wallet Balance Base Coin + Account Perp UPL Base Coin.
    >> totalAvailableBalancestringAvailable Balance of account converted to usd：RM：Account Margin Balance Base Coin - Account Initial Margin Base Coin.
    >> totalPerpUPLstringUnrealised P&L of perpetuals of account converted to usd：∑ Asset Perp UPL Base Coin.
    >> totalInitialMarginstringInitial Margin of account converted to usd：∑ Asset Total Initial Margin Base Coin.
    >> totalMaintenanceMarginstringMaintenance Margin of account converted to usd: ∑ Asset Total Maintenance Margin Base Coin.
    >> coinarrayObject
    >>> currencyCoinstringCoin name, such as BTC, ETH, USDT, USDC
    >>> equitystringEquity
    >>> usdValuestringusd value
    >>> walletBalancestringWallet balance
    >>> marginBalancestringMB from other assets + the actual MB balance from the current assets
    >>> availableBalancestringAB from other assets + the actual AB balance from the current assets (cannot be negative)
    >>> marginBalanceWithoutConvertstringMargin balance
    >>> availableBalanceWithoutConvertstringAvailable balance, Margin Balance - Total Initial Margin
    >>> borrowSizestringLending amount used. For USDC and USDT only. For BTC and ETH, return 0
    >>> availableToBorrowstringDepreciated field, always return "" due to feature of main-sub uid sharing borrow quota
    >>> accruedIntereststringAccrued interest of an asset
    >>> totalOrderIMstringOrder margin pre-occupied. For portfolio margin mode, it returns ""
    >>> totalPositionIMstringSum of initial margin of all positions + Pre-occupied liquidation fee. For portfolio margin mode, it returns ""
    >>> totalPositionMMstringSum of maintenance margin for all positions. For portfolio margin mode, it returns ""
    >>> unrealisedPnlstringUnrealised P&L
    >>> cumRealisedPnlstringCumulative Realised P&L

    Stream Example​

    {
        "id": "5332858071ac1a-adcf-4c22-9967-4bdb763d993d",
        "topic": "user.wallet.unifiedAccount",
        "ts": 1673246212184,
        "data": {
            "result": {
                "accountIMRate": "0.1062",
                "accountMMRate": "0.0126",
                "totalEquity": "5306.99168766",
                "totalWalletBalance": "5015.81303189",
                "totalMarginBalance": "5315.50124767",
                "totalAvailableBalance": "4750.87543737",
                "totalPerpUPL": "299.68821577",
                "totalInitialMargin": "564.62581029",
                "totalMaintenanceMargin": "67.39562585",
                "coin": [
                    {
                        "currencyCoin": "USDC",
                        "equity": "696.90520008",
                        "usdValue": "696.90520008",
                        "walletBalance": "702.87476009",
                        "marginBalance": "5315.50124767",
                        "availableBalance": "4750.87543737",
                        "marginBalanceWithoutConvert": "705.41476009",
                        "availableBalanceWithoutConvert": "472.43375944",
                        "borrowSize": "0",
                        "availableToBorrow": "1500000",
                        "accruedInterest": "0",
                        "totalOrderIM": "172.47750096",
                        "totalPositionIM": "60.50349967",
                        "totalPositionMM": "16.09254346",
                        "unrealisedPnl": "-2.07956",
                        "cumRealisedPnl": "153.26214849"
                    },
                    {
                        "currencyCoin": "USDT",
                        "equity": "2989.97442076",
                        "usdValue": "2975.11272839",
                        "walletBalance": "2691.34184935",
                        "marginBalance": "5330.29357298",
                        "availableBalance": "4750.7346256",
                        "marginBalanceWithoutConvert": "2989.97442076",
                        "availableBalanceWithoutConvert": "2658.33944077",
                        "borrowSize": "0",
                        "availableToBorrow": "2500000",
                        "accruedInterest": "0",
                        "totalOrderIM": "0.9205456",
                        "totalPositionIM": "330.71443439",
                        "totalPositionMM": "51.24010721",
                        "unrealisedPnl": "298.63257142",
                        "cumRealisedPnl": "-3418.29414098"
                    }
                ]
            },
            "version": 177440
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/derivatives/ws/connect.html b/derivatives/ws/connect.html index 4fc1a9e16d..a17d059b63 100644 --- a/derivatives/ws/connect.html +++ b/derivatives/ws/connect.html @@ -4,7 +4,7 @@ Connect | Bybit API Documentation - + @@ -21,7 +21,7 @@ USDC Option: wss://stream-testnet.bybit.com/option/usdc/public/v3

    WebSocket private channel:

    • Mainnet:
      Contract: wss://stream.bybit.com/contract/private/v3

    • Testnet:
      Contract: wss://stream-testnet.bybit.com/contract/private/v3

    Authentication​

    info
    Public topics do not require authentication. The following section applies to private topics only.

    Apply for authentication when establishing a connection.

    Note: if you're using pybit, bybit-api or another high-level library, you can ignore this code - as authentication is handled for you.

    {
        "req_id": "10001", // optional
        "op": "auth",
        "args": [
            "api_key",
            1662350400000, //expires; is greater than your current timestamp
            "singature"
        ]
    }
    # based on: https://github.com/bybit-exchange/pybit/blob/master/pybit/_http_manager.py

    import hmac
    import json
    import time
    import websocket

    api_key = ""
    api_secret = ""

    # Generate expires.
    expires = int((time.time() + 1) * 1000)

    # Generate signature.
    signature = str(hmac.new(
        bytes(api_secret, "utf-8"),
        bytes(f"GET/realtime{expires}", "utf-8"), digestmod="sha256"
    ).hexdigest())

    ws = websocket.WebSocketApp(
        url=url,
        ...
    )

    # Authenticate with API.
    ws.send(
        json.dumps({
            "op": "auth",
            "args": [api_key, expires, signature]
        })
    )

    Authentication success sample response

    {
        "success": true,
        "ret_msg": "",
        "op": "auth",
        "conn_id": "ced97gevha793pjs1t30-ob"
    }
    note

    Example signature algorithms can be found here.

    caution

    Due to network complexity, your may get disconnected at any time. Please follow the instructions below to ensure that you receive WebSocket messages on time:

    1. Keep connection alive by sending heartbeat packet
    2. Reconnect as soon as possible if disconnected

    IP Limits​

    • Do not frequently connect and disconnect the connection.
    • Do not build over 500 connections in 5 minutes. This is counted separately per WebSocket endpoint.

    How to Send Heartbeat Packet​

    How to Send

    // req_id is a customised id, which is optional
    ws.send(JSON.stringify({"req_id": "100001", "op": "ping"}));

    Pong message example

    {
        "req_id": "test",
        "op": "pong",
        "args": [
        "1671163042443"
        ],
        "conn_id": "ce3e06kfnonvuu2e3j4g-2t5w"
    }
    caution

    To avoid networks or program issues, we recommend that you send the ping heartbeat packet every 20 seconds to maintain the WebSocket connection.

    How to Subscribe to Topics​

    Understanding Websocket Filters​

    How to subscribe with a filter

    // Subscribing level 1 orderbook
    {
        "req_id": "test", // optional
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT"
        ]
    }

    Support subscribe multiple symbols and topics, separate with ','.

    {
        "req_id": "test", // optional
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT",
            "publicTrade.BTCUSDT",
            "orderbook.1.ETHUSDT",
        ]
    }

    Understanding Websocket Filters unsubscription​

    You can dynamically subscribe and unsubscribe from topics without websocket disconnection as follows:

    {
        "op": "unsubscribe",
        "args": [
            "publicTrade.ETHUSD"
        ],
        "req_id": "customised_id"
    }

    Understanding Subscription Response​

    Topic subscription response message example

    {
        "success": true,
        "ret_msg": "",
        "op": "subscribe",
        "conn_id": "ced97gevha793pjs1t30-ob"
    }

    Once you subscribe successfully, you'd receive result information. You can determine whether the subscription is successful based on the response.

    - + \ No newline at end of file diff --git a/faq.html b/faq.html index b632a4cb0f..8c5edcd724 100644 --- a/faq.html +++ b/faq.html @@ -4,14 +4,14 @@ Frequently Asked Questions | Bybit API Documentation - +

    Frequently Asked Questions

    Where are Bybit's servers located?​

    AWS Singapore, Availability Zone ID apse1-az3.

    reduceOnly and closeOnTrigger - what's the difference?​

    • To close your position, submit an order and specify reduceOnly to true. closeOnTrigger is not strictly applicable here, but you can also set it to true if it's required.
    • reduceOnly is the one that really matters for closing position, and we will improve the interface in the future.
    • Be careful when you specify closeOnTrigger to true as it could cause conflict when reduceOnly is false.

    Why aren't all my orders showing on the website?​

    • Users who have bots which place large numbers of laddered orders will be restricted by the frontend interface, which only shows a maximum of 50 orders on-screen.
    • Don't worry, your orders are still in the system and can be queried by the API, but the frontend cannot show more than 50.

    Calculating order size based on available wallet balance​

    • price * availableBalance * leverage * perc * (1 - (0.0006 * 2))
    • Unfortunately this is not a perfectly accurate formula; the real calculation is complex and may be published in the docs at a later date.
      • price - last price (or your entry price) - can be found with the Tickers.
      • availableBalance - can be found with the Position Info endpoint.
      • leverage - up to the respective maximum leverage for the market and your risk limit (eg 2, 10, 50).
      • perc - 0.1 for 10%, 0.25 for 25%, etc.
      • 1 - (0.0006 * 2) - used to calculate the maximum order cost (always assumes entry & exit orders use taker fee regardless actual fee).

    Can I exchange assets with the API?​

    How do I get funds for testnet?​

    To get testnet funds, just go to master account asset page to request.

    Why are my Closed PNL prices inaccurate?​

    • The entryPrice and exitPrice returned by Closed PNL endpoints are not the actual execution prices of the orders.
    • It is based on the total costs of the order (whether or not the position was only opened/closed by one order executed at one price - it is more complicated if multiple orders opened/closed a position.)
    • For instance, the entry_price and exit_price reported by this endpoint are influenced by the fee paid/received on the orders.

    How can I ensure I am using up-to-date data?​

    • It is possible, although unlikely, that the REST API or (even less likely) the websocket could return/push old data.
    • For the greatest level of data resilience, we recommend clients to:
      • firstly, rely on the websocket, which will not only ensure you get the latest data as fast as possible, but will also ensure you get complete data
      • secondly, query the REST API to fill in any discrepencies in data - or between websocket disconnections.
    • The best practice is to save all of this data locally in your own database or cache.
    • This frees up your rate limits for other requests and also ensures a level of redundancy against the exchange in case of data delays.

    What is the difference between turnover and volume?​

    • Turnover: is in the opposite currency to the quantity's currency
    • Volume: is in the same currency as the quantity's currency

    Why is the price returned in the place market order response wrong?​

    Market orders are (in the backend) just limit orders submitted at a worse price. This is to reduce the chance of a flash crash or a similar event, where a trader might submit a market order which executes at a significantly worse price than they expected it to. The price returned here is that internal limit order price. This "inaccurate" price is returned because the place order endpoint is asynchronous, meaning the response is returned to you before the order is actually executed.

    If you want the true execution price (execPrice) you should subscribe to the execution websocket.

    How can I process WebSocket snapshot and delta messages?​

    Please refer to the orderbook topic's documentation.

    Note that if you're using pybit, it handles these messages for you and always delivers a complete orderbook. Working code examples:

    • Python: _process_delta_orderbook() method within pybit (the Python SDK)
    • Node.js: orderbooks, a library made by the creator of bybit-api (the Node.js SDK)
    - + \ No newline at end of file diff --git a/index.html b/index.html index 9514a4c336..091cc02f28 100644 --- a/index.html +++ b/index.html @@ -4,13 +4,13 @@ Hello from Bybit API Documentation | Bybit API Documentation - +

    Bybit API Documentation

    Introduction to the Bybit V5 APIs – 5min ⏱️

    Unified APIs

    Bybit's latest v5 suite of APIs allow for a smooth and easy integration.

    Learn Exchange Mechanisms

    Learn the intricate details of Bybit's market rules to fully maximise your API usage.

    Historical Market Data

    Get comprehensive public market data in CSV format to speedily backtest and build strategies.

    - + \ No newline at end of file diff --git a/markdown-page.html b/markdown-page.html index 6181621a9a..255e2fffdc 100644 --- a/markdown-page.html +++ b/markdown-page.html @@ -4,13 +4,13 @@ Markdown page example | Bybit API Documentation - +

    Markdown page example

    You don't need React to write simple standalone pages.

    - + \ No newline at end of file diff --git a/pilot-feature.html b/pilot-feature.html index 568c3f9386..29938b0fdc 100644 --- a/pilot-feature.html +++ b/pilot-feature.html @@ -4,7 +4,7 @@ Pilot Features | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Pilot Features

    Open API Supports Demo Trading​

    • Available date: Testnet - alive, Mainnet - 3 Apr 2024
    • Cover: demo trading account
    • Details: You can refer to this page to start demo trading API

    Websocket Place Order Feature​

    • Available date: Testnet - alive, Mainnet - TBD
    • Cover: UTA Spot/Linear/Option
    • Details: You can use websocket to place/amend/cancel the order

    Batch APIs are ready for Spot​

    • Available date: Testnet - alive, Mainnet - 5 Mar 2024
    • Cover: UTA Spot
    • Details: You can use batch API to start Spot trading

    Spot supports bidirectional Tp/Sl​

    • Available date: Testnet - alive, Mainnet - 15 Jan 2024
    • Cover: UTA Spot
    • Details: You can set takeProfit, stopLoss when creating Spot order

    Spot Hedging Feature Is Available​

    • Available date: Testnet - alive, Mainnet - 16 Nov 2023
    • Cover: Unified account - Portfolio Margin mode
    • Details: You can enable Spot Hedging function for Portfolio Margin via Set Spot Hedging

    Spot Supports Amend Order​

    • Available date: Testnet - alive, Mainnet - 1 Nov 2023
    • Cover: Classic & Unified account Spot
    • Details: You can amend your spot orders via Amend Order

    Unified Account Spot Stop Orders logic is changed​

    • Available date: Testnet - alive, Mainnet - 26 Oct 2023 (grey scale period, all are effective est. 2th Nov 2023)
    • Cover: Unified account Spot Stop Orders
    • Details: Once the TP/SL order or Conditional order is triggered, the order ID will be kept the same

    UTA Pro Batch Feature​

    • Available date: Testnet - alive, Mainnet - 31 Aug 2023
    • Cover: UTA Pro, USDT Perpetual, USDC Perpetual & USDC Futures (linear)
    • Details: UTA Pro user can batch create/amend/cancel linear orders
    Sample code
    POST https://api-testnet.bybit.com/v5/order/create-batch

    > Request Body
    {
        "category": "linear",
        "request": [
            {

                "symbol": "BTCUSDT",
                "orderType": "Limit",
                "side": "Buy",
                "qty": "0.1",
                "price": "25500",
                "timeInForce": "GTC",
                "orderLinkId": "test-03",
                "reduceOnly": false,
                "tpslMode": "Full",
                "takeProfit": "26300",
                "stopLoss": "24800",
                "triggerDirection": null,
                "triggerPrice": null,
                "triggerBy": null,
                "positioIdx": 0,
                "smpType": null,
                "tpLimitPrice": null,
                "slLimitPrice": null,
                "slOrderType": null,
                "tpOrderType": null

            },
            {

                "symbol": "ETHUSDT",
                "orderType": "Limit",
                "side": "Buy",
                "qty": "0.1",
                "price": "1550",
                "timeInForce": "GTC",
                "orderLinkId": "test-04",
                "reduceOnly": false,
                "tpslMode": "Full",
                "takeProfit": "1680",
                "stopLoss": "1490",
                "triggerDirection": null,
                "triggerPrice": null,
                "triggerBy": null,
                "positioIdx": 0,
                "smpType": null,
                "tpLimitPrice": null,
                "slLimitPrice": null,
                "slOrderType": null,
                "tpOrderType": null
            }
        ]
    }
    > Response
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "BTCUSDT",
                    "orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14",
                    "orderLinkId": "test-03",
                    "createAt": "1693212677410"
                },
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c",
                    "orderLinkId": "test-04",
                    "createAt": "1693212677410"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 0,
                    "msg": "OK"
                }
            ]
        },
        "time": 1693212677411
    }

    Add Customised Disconnection Configuration​

    • Available date: Testnet - alive, Mainnet - 16 Aug 2023
    • Cover: All kinds of accounts - V5 Websocket Private Connection
    • Details: Set /v5/private?max_active_time=, supported range is from 30s to 600s. For more info, please check here

    Adjust error code​

    Old error codeNew error codeMsg
    34001283200320Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.
    1760363200320Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.

    UTA borrow quota is shared across main-sub uids​

    • Available date: Testnet - alive, Mainnet - 11 Aug 2023
    • Cover: UTA account
    • Details: Before each uid has an independent borrow quota, but now, main-sub uids share the same borrow quota

    UTA user can set collateral coin​

    • Available date: Testnet - alive, Mainnet - 10 Aug 2023
    • Cover: UTA account
    • Details: User can set collateral coin via API

    User can upgrade account to UTA Pro manually​

    • Available date: Testnet - alive, Mainnet - 08 Aug 2023
    • Cover: Normal account, UTA account
    • Details: User can upgrade account to UTA Pro via API

    OpenAPI supports Spot Conditional Order​

    • Available date: Testnet - alive, Mainnet - 07 Aug 2023
    • Cover: Normal account, UTA account
    • Details: User can place Spot conditional order

    UTA Supports Institutional Lending​

    • Available date: Testnet - alive, Mainnet - 24 July 2023
    • Cover: UTA
    • Details: UTA can have OTC loan

    Support Funding For USDC Perp​

    • Available date: Testnet - alive, Mainnet - 13 July 2023
    • Cover: UTA USDC Perpetual
    • Details: There was no execType=Funding in Get Trade History and websocket execution stream update. Now you will it.

    New Copy Trading​

    • Available date: Testnet - alive, Mainnet - 24 June 2023
    • Cover: Copy trading
    • Details: Bybit will release uids that allow upgrades in batches starting from 23 June, and if you select to upgrade it, you can only use Contract V3 or V5 to copy trade

    Unified Account Supports Isolated Margin And Hedge Mode​

    • Available date: Testnet - alive, Mainnet - 1 June 2023
    • Cover: Unified trading account only
    • Details: Isolated margin mode for UTA is account level. Hedge mode supports USDT perpetual only

    New TP/SL​

    • Available date: Testnet - alive, Mainnet - 23 May 2023
    • Cover: V5 API and Contract V3 API
    • Details: UTA account: USDT Perpetual, USDC Perpetual and Futures, Inverse contract, Inverse contract
      Normal account: USDT Perpetual, Inverse contract

    Query Pre-upgrade Records​

    • Available date: Testnet - alive, Mainnet - 27 Apr 2023
    • Cover: UTA account
    • Details: After upgraded to UTA, you can get those order information before upgraded.

    C2C Lending (Abandoned)​

    • Available date: Testnet - alive, Mainnet - 22 Apr 2023
    • Cover: All users (grey scale in the progress right now)
    • Details: You can lend your available assets to platform to earn yield

    Self Match Prevention​

    • Available date: Testnet - alive, Mainnet - 20 Apr 2023
    • Cover: read here
    • Details: Support spot, futures and options

    Upgrade to UTA without closing positions​

    • Available date: Testnet - alive, Mainnet - 04 Apr 2023
    • Cover: Normal account is upgraded to Unified account
    • Details: Do not need to close positions when upgrade. For more details. please refer to upgrade API information

    UTA can trade USDC Futures via V5​

    • Available date: Testnet - alive, Mainnet - 20 Mar 2023
    • Cover: Unified trading account users only
    • Details: Add USDC Futures trading pair

    Institutional Lending V5 API​

    • Available date: Testnet - alive, Mainnet - 13 Mar 2023
    • Cover: Institutional clients who applied OTC
    • Details: Clients can get LTV, lends and repayment information

    Normal account can trade Spot via V5​

    • Available date: Testnet - alive, Mainnet - 10 Mar 2023
    • Cover: Normal account
    • Details: Use V5 API to trade Spot for normal account

    Unify symbol status enums​

    • Available date: Testnet - alive, Mainnet - 10 Mar 2023
    • Cover: /v5/market/instruments-info status field
    • Details: Use Trading, Closed, Settling, PreLaunch, Deliverying

    Release V5 Margin trade (normal account) API​

    • Available date: Testnet - alive, Mainnet - 3 Mar 2023
    • Cover: Normal account can operate margin trade via V5
    • Details: able to loan, repay margins with V5

    UTA can trade Inverse Contract​

    • Available date: Testnet - alive, Mainnet - 21 Feb 2023
    • Cover: UTA has ability to trade inverse contract via V5 API
    • Details: Please note that inverse contract trade is conducted though the CONTRACT wallet

    Merge SPOT account into UNIFIED account(IMPORTANT)​

    • Available date: est. March 3rd, 2023
    • Cover: UTA users only
    • Details: You need to adjust withdrawal logic by transfer funds to FUND account first, then call withdraw API

    Use RSA keys to authenticate​

    • Available date: Testnet - alive, Mainnet - 21 Feb 2023
    • Cover: All V3 & V5 the endpoints need authentication
    • Details: Please refer to this guideline to have a quick start

    Add a new enum type for execType​

    • Available date: Testnet - alive, Mainnet - 20 Feb 2023
    • Cover: Contract V3 - Websocket private channel - execution topic
    • Details: Funding execution stream will be pushed depending on the funding interval of the symbol.

    Normal account is supported by V5 API​

    • Available date: Testnet - alive, Mainnet - 9 Feb 2023
    • Cover: non-unified account can trade USDT perpetual and Inverse contract
    • Details: After this release, you may get some 401 errors or 404 errors if you have following actions:

    401: You are using v1/v2 way to pass authentication params:

    GET https://api.bybit.com/v5/position/list?api_key=xxx&category=linear&recv_window=5000&symbol=ETHUSDT&timestamp=1675929695887&sign=xxx

    You should pass them in the request header:

    Host: api-testnet.bybit.com
    -H 'X-BAPI-SIGN: XXXXXXXXXX' \
    -H 'X-BAPI-API-KEY: XXXXXXXXXX' \
    -H 'X-BAPI-TIMESTAMP: 1658384431891' \
    -H 'X-BAPI-RECV-WINDOW: 5000'

    404: For below APIs, if you use unsuitable category, i.e., you use Normal account to access category=option/spot

    Adjust error code​

    Old error codeNew error codeMsg
    3400045110073Set margin mode failed
    34009910016Server error

    Add level 500 depth​

    • Available date: Testnet - 13 JAN 2023, Mainnet - 16 JAN 2023
    • Cover: V5 orderbook and V3 orderbook
    • Details: Linear contract and inverse contract supports 500 depth, and the push frequency is 100ms.
    - + \ No newline at end of file diff --git a/search.html b/search.html index 1374db7795..289d7b2232 100644 --- a/search.html +++ b/search.html @@ -4,13 +4,13 @@ Search the documentation | Bybit API Documentation - +

    Search the documentation

    - + \ No newline at end of file diff --git a/spot/enum.html b/spot/enum.html index 41b5b58608..7491f4cd57 100644 --- a/spot/enum.html +++ b/spot/enum.html @@ -4,7 +4,7 @@ Enums Definitions | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Enums Definitions

    side​

    • BUY
    • SELL

    timeInForce​

    • GTC Good Till Cancel
    • FOK Fill or Kill
    • IOC Immediate or Cancel

    symbol​

    • BTCUSDT
    • ETHUSDT
    • BTCUSDC
    • ...
      You can get all symbols with the instrument endpoint.

    orderType​

    • MARKET
    • LIMIT
    • LIMIT_MAKER

    currency/coin​

    • BTC
    • ETH
    • USDT
    • ...

    Cross Margin Trading Endpoints support below currency:

    • BTC
    • ETH
    • XRP
    • SOL
    • LTC
    • EOS
    • LINK
    • XLM
    • USDC
    • USDT You could find all supported coins of margin trade here.

    orderStatus​

    • NEW normal order is placed
    • ORDER_NEW TP/SL order is placed
    • PARTIALLY_FILLED
    • FILLED
    • ORDER_FILLED TP/SL order is filled
    • CANCELED normal order is cancelled
    • ORDER_CANCELED TP/SL order is cancelled
    • REJECTED
    • ORDER_REJECTED TP/SL order is cancelled
    • PARTIALLY_FILLED_CANCELED
    • ORDER_FAILED TP/SL order is failed

    interval​

    • 1m 1 minute
    • 3m 3 minutes
    • 5m 5 minutes
    • 15m 15 minutes
    • 30m 30 minutes
    • 1h 1 hour
    • 2h 2 hours
    • 4h 4 hours
    • 6h 6 hours
    • 12h 12 hours
    • 1d 1 day
    • 1w 1 week
    • 1M 1 month

    ltStatus​

    • 1 ETP can be purchased and redeemed
    • 2 ETP can be purchased, but not redeemed
    • 3 ETP can be redeemed, but not purchased
    • 4 ETP cannot be purchased nor redeemed

    ltOrderStatus​

    • 1 Completed
    • 2 In progress
    • 3 Failed

    ltOrderType​

    • 1 Purchase
    • 2 Redemption

    smpType​

    • default: None
    • CancelMaker
    • CancelTaker
    • CancelBoth
    - + \ No newline at end of file diff --git a/spot/error.html b/spot/error.html index a005aaf301..637c8c9d65 100644 --- a/spot/error.html +++ b/spot/error.html @@ -4,13 +4,13 @@ Error Code | Bybit API Documentation - +

    Error Code

    CodeDescription
    5019User-service error
    5004Upstream server timeout
    7001Grpc request filed type error
    10003Invalid api_key
    10006Too many visits
    10001Params error
    10002Invalid request, please check your timestamp and recv_window param
    10004Error sign
    10005Permission denied
    10008uta banned. You cannot access to this endpoint with current account mode, please check your account mode
    10024Compliance rules triggered
    10029The requested symbol is invalid, please check symbol whitelist
    33004api_key expire
    12940Connection reset
    12999Server Error
    12800Invalid request
    12801Invalid JSON
    12802Invalid event
    12803Event required
    12804Invalid topic
    12805Topic required
    12806Params required
    12807Period required
    12808Invalid period
    12809Invalid Symbols
    12810Not supported symbols
    12811There is no such broker.
    12812DumpScale required
    12813Invalid exchangeId
    12814Param %s should be %s.
    12815Symbol required
    12816Timeout. Retry later.
    12817No business with any exchange.
    12818Client disconnected.
    12819OrgId required.
    12820OrgId must be a number.
    12821DumpScale error.
    12822Index name error.
    12823Parameter error
    12824Parameter %s [%s]
    12825The number of each symbol request cannot exceed 300
    12001Request failed to be processed. Please try again.
    12007Response timeout from backend server. Delivery and request status unknown.
    12014Trading pairs not supported.
    12005Too many new orders. Please lower request frequency.
    12016Service not available.
    12032Fusing error
    12114NETWORK_BUSY
    12015UID_NOT_EXIST
    12011INNOVATION_BUY_FAILED_BY_QUOTA
    12010ETP_BUY_FAILED_BY_QUOTA
    12012ETP_NAV_IS_ABNORMAL
    12017CROSS_MARGIN_PRE_BUY_QUOTA_FAILED
    10020CROSS_MARGIN_PRE_SELL_QUOTA_FAILED
    12019Your account has been restricted for trades. If you have any questions, please email us at support@bybit.com
    12124Order amount is too big
    12031The feature has been suspended
    12105Empty parameter.
    12115Invalid timeInForce.
    12116Invalid orderType.
    12117Invalid direction.
    12121Invalid symbol.
    12130Invalid parameter sent.
    12131Insufficient balance
    12132Order price exceeded upper limit.
    12133Order price exceeded lower limit.
    12134Order price has too many decimals.
    12135Order quantity exceeded upper limit.
    12136Order quantity exceeded lower limit.
    12137Order quantity has too many decimals.
    12138Order price exceeded limits.
    12139Order has been filled.
    12140Order value exceeded lower limit.
    12141Duplicate clientOrderId.
    12142Order has been canceled.
    12143Order not found.
    12144Order being cancelled. Operation not supported.
    12145Order cannot be canceled.
    12146Order creation timeout.
    12147Order cancellation timeout.
    12148Market order amount decimal too long
    12149Create order failed
    12150Cancel order failed
    12151The trading pair is not open yet
    12156Order quantity invalid
    12157The trading pair is not available for api trading
    12158create limit maker order failed
    12159Market Order is not supported within the first %s minutes of newly launched pairs due to risk control.
    12190Cancel order has been finished.
    12191Can not cancel order, please try again later.
    12192Order price cannot be higher than %s .
    12193Buy order price cannot be higher than %s.
    12194Sell order price cannot be lower than %s.
    12195Please note that your order may not be filled
    12196Please note that your order may not be filled
    12197Your order quantity to buy is too large. The filled price may deviate significantly from the market price. Please try again
    12198Your order quantity to sell is too large. The filled price may deviate significantly from the market price. Please try again
    12199Your order quantity to buy is too large. The filled price may deviate significantly from the nav. Please try again.
    12200Your order quantity to sell is too large. The filled price may deviate significantly from the nav. Please try again.
    12201Invalid orderCategory parameter
    12202Please enter the TP/SL price
    12203trigger price cannot be higher than 110% price
    12204trigger price cannot be lower than 90% of qty
    12205CROSS_MARGIN_USER_NOT_ALLOW
    12206Stop_limit Order is not supported within the first 5 minutes of newly launched pairs
    12210New order rejected.
    12211Cancelation rejected.
    12212Cancel order request processing
    12213Order does not exist.
    12214This trading pair currently does not support trading
    12217Only LIMIT-MAKER order is supported for the current pair.
    12218The LIMIT-MAKER order is rejected due to invalid price.
    12219UID {{xxx}} is not available to this feature
    12221This coin does not exist
    12222Too many requests in this time frame
    12223Your Spot Account with Institutional Lending triggers an alert or liquidation
    12224You're not a user of the Innovation Zone
    12225You've failed to check the Risk Alert for Leveraged Tokens
    12226Your Spot Account for Margin Trading is being liquidated
    12227This feature is not supported
    12228The purchase amount of each order exceeds the estimated maximum purchase amount
    12229The sell quantity per order exceeds the estimated maximum sell quantity
    12230The reserved quota for Spot Margin Trading does not meet the LTV ratio requirement
    12231Users with Spot Margin Trading are not allowed to perform Block Trades
    12232Users with Institutional Lending are not allowed to perform Block Trades
    12233Users with Leverage Tokens are not allowed to perform Block Trades
    12234System Error
    12400The serialNum is already in use.
    12401Daily purchase limit has been exceeded. Please try again later.
    12402There's a large number of purchase orders. Please try again later.
    12403Insufficient available balance. Please make a deposit and try again.
    12404Daily redemption limit has been exceeded. Please try again later.
    12405There's a large number of redemption orders. Please try again later.
    12406Insufficient available balance. Please make a deposit and try again.
    12407Order not found.
    12408Purchase period hasn't started yet.
    12409Purchase amount has exceeded the upper limit.
    12410You haven't passed the quiz yet! To purchase and/or redeem an LT, please complete the quiz first.
    12412Redemption period hasn't started yet.
    12413Redemption amount has exceeded the upper limit.
    12414Purchase of the LT has been temporarily suspended.
    12415Redemption of the LT has been temporarily suspended.
    12416Invalid format. Please check the length and numeric precision.
    12417Failed to place order：Exceed the maximum position limit of leveraged tokens
    12601Query user repay history error
    12602Query user account info error
    12603Query user loan history error
    12604Query order history start time exceeds end time
    12605Failed to borrow
    12606Repayment Failed
    12607User not found
    12608You haven't enabled Cross Margin Trading yet. To do so
    12609You haven't enabled Cross Margin Trading yet. To do so
    12610Failed to locate the coins to borrow
    12611Cross Margin Trading not yet supported by the selected coin
    12612Pair not available
    12613Cross Margin Trading not yet supported by the selected pair
    12614Repeated repayment requests
    12615Insufficient available balance
    12616No repayment required
    12617Repayment amount has exceeded the total liability
    12618Settlement in progress
    12619Liquidation in progress
    12620Failed to locate repayment history
    12621Repeated borrowing requests
    12622Coins to borrow not generally available yet
    12623Pair to borrow not generally available yet
    12624Invalid user status
    12625Amount to borrow cannot be lower than the min. amount to borrow (per transaction)
    12626Amount to borrow cannot be larger than the max. amount to borrow (per transaction)
    12627Amount to borrow cannot be higher than the max. amount to borrow per user
    12628Amount to borrow has exceeded Bybit's max. amount to borrow
    12629Amount to borrow has exceeded the user's estimated max. amount to borrow
    12630Query user loan info error
    12631Number of decimals has exceeded the maximum precision of borrow
    12631Number of decimals has exceeded the maximum precision of repay
    - + \ No newline at end of file diff --git a/spot/etp/asset-info.html b/spot/etp/asset-info.html index 2aa3cb111e..c5f92f230b 100644 --- a/spot/etp/asset-info.html +++ b/spot/etp/asset-info.html @@ -4,13 +4,13 @@ All Asset Info | Bybit API Documentation - +

    All Asset Info

    info

    It is a public endpoint, and no need to authenticate.

    HTTP Request​

    GET /spot/v3/public/infos

    Request Parameters​

    ParameterRequiredTypeComments
    ltCodefalsestringAbbreviation of the LT.

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > ltCodestringAbbreviation of the LT
    > ltNamestringFull name of the LT
    > maxPurchasestringMax. purchase amount per transaction
    > minPurchasestringMin. purchase amount per transaction
    > maxPurchaseDailystringMax. purchase amount per day
    > maxRedeemstringMax. redemption amount per transaction
    > minRedeemstringMin. redemption amount per transaction
    > maxRedeemDailystringMax. redemption amount per day
    > purchaseFeeRatestringPurchase fees
    > redeemFeeRatestringRedemption fees
    > statusstringWhether the LT can be purchased or redeemed
    > fundFeestringFunding fees charged daily to users who hold LT
    > fundFeeTimenumberTimestamps when funding fees are charged
    > manageFeeRatestringManagement fees
    > manageFeeTimenumberTimestamps when management fees are charged
    > valuestringInternal used parameter, please ignore
    > totalstringApplication upper limit
    > netValuestringNet asset value

    Request Example​

    https://api-testnet.bybit.com/spot/v3/public/infos?ltCode=EOS2LUSDT

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "fundFee": "21.79800315",
                    "fundFeeTime": 1673366400000,
                    "ltCode": "EOS2LUSDT",
                    "ltName": "Long EOS (2x Leverage)",
                    "manageFeeRate": "0.00005",
                    "manageFeeTime": 1673398800000,
                    "maxPurchase": "5000",
                    "maxPurchaseDaily": "200000",
                    "maxRedeem": "861",
                    "maxRedeemDaily": "20000",
                    "minPurchase": "100",
                    "minRedeem": "17",
                    "netValue": "3.781571076822412032",
                    "purchaseFeeRate": "0.0005",
                    "redeemFeeRate": "0.0005",
                    "status": "1",
                    "total": "5000000",
                    "value": "23624.848996419293002588635"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1673345413125
    }
    - + \ No newline at end of file diff --git a/spot/etp/market-info.html b/spot/etp/market-info.html index e67eddf8d7..252a2e8578 100644 --- a/spot/etp/market-info.html +++ b/spot/etp/market-info.html @@ -4,13 +4,13 @@ Market Info | Bybit API Documentation - +

    Market Info

    HTTP Request​

    GET /spot/v3/private/reference

    Request Parameters​

    ParameterRequiredTypeComments
    ltCodetruestringAbbreviation of the LT. Get ltCode from asset info api

    Response Parameters​

    ParameterTypeComments
    basketstringTotal position value = basket value * total circulation
    circulationstringCirculating supply in the secondary market
    leveragestringReal Leverage calculated by last traded price.
    ltCodestringAbbreviation of the LT
    navstringNet asset value
    navTimenumberUpdate time for net asset value (ms)

    Request Example​

    curl --location --request GET 'https://api.bybit.com/spot/v3/private/reference?ltCode=EOS2LUSDT' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662549197919' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "basket": "230666.700009559600667216",
            "circulation": "24999.840207851103706443",
            "leverage": "2.302545313639639446",
            "ltCode": "EOS2L",
            "nav": "3.790797803797135639",
            "navTime": 1673346095226
        },
        "retExtInfo": {},
        "time": 1673346095239
    }
    - + \ No newline at end of file diff --git a/spot/etp/order-history.html b/spot/etp/order-history.html index b45dbd0d8b..5e07a057ce 100644 --- a/spot/etp/order-history.html +++ b/spot/etp/order-history.html @@ -4,13 +4,13 @@ Purchase & Redeem History | Bybit API Documentation - +

    Purchase & Redeem History

    HTTP Request​

    GET /spot/v3/private/record

    Request Parameters​

    ParameterRequiredTypeComments
    ltCodefalsestringAbbreviation of the LT.
    orderIdfalsestringOrder ID
    startTimefalseintegerStart timestamp (ms)
    endTimefalseintegerEnd timestamp (ms)
    limitfalseintegerLimit for data size. [1, 500]. Default: 100
    orderTypefalseintegerOrder type; 1: Purchase; 2: Redeem
    serialNofalsestringSerial number

    Response Parameters​

    ParameterTypeComments
    amountstringActual purchase quantity of the ETP
    excTimenumberLast update time of the order status
    feestringTrading fees
    ltCodestringAbbreviation of the LT
    orderIdstringOrder ID
    orderStatusstringOrder status. 1: Completed; 2: In progress; 3: Failed
    orderTimenumberOrder time
    orderTypeintegerOrder type; 1. Purchase; 2. Redemption
    serialNostringSerial number
    valuestringFilled value
    valueCoinstringQuote asset

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/record?ltCode=DOT3L&startTime=1662548400000&endTime=1662549840000' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662608374151' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "amount": "",
                    "excTime": 1662549752000,
                    "fee": "",
                    "ltCode": "DOT3L",
                    "orderId": "2083",
                    "orderStatus": "3",
                    "orderTime": 1662549752000,
                    "orderType": 1,
                    "serialNo": "x003",
                    "value": "",
                    "valueCoin": "USDT"
                },
                {
                    "amount": "",
                    "excTime": 1662549702000,
                    "fee": "",
                    "ltCode": "DOT3L",
                    "orderId": "2082",
                    "orderStatus": "3",
                    "orderTime": 1662549702000,
                    "orderType": 1,
                    "serialNo": "x002",
                    "value": "",
                    "valueCoin": "USDT"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1662608374640
    }
    - + \ No newline at end of file diff --git a/spot/etp/purchase.html b/spot/etp/purchase.html index 0f32b19dd7..36869b38ee 100644 --- a/spot/etp/purchase.html +++ b/spot/etp/purchase.html @@ -4,13 +4,13 @@ Purchase | Bybit API Documentation - +

    Purchase

    HTTP Request​

    POST /spot/v3/private/purchase

    Request Parameters​

    ParameterRequiredTypeComments
    ltCodetruestringAbbreviation of the LT.
    ltAmounttruestringPurchase amount
    serialNofalsestringSerial number. A kind of unique customised ID

    Response Parameters​

    ParameterTypeComments
    amountstringActual purchase value of the LT
    idstringTransaction ID
    ltCodestringAbbreviation of the LT
    orderAmountstringOrder value of the LT
    orderQuantitystringOrder quantity of the LT
    orderStatusstringOrder status. 1: Completed; 2: In progress; 3: Failed
    serialNostringSerial number
    timestampnumberTimestamp
    valueCoinstringQuote asset

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/purchase' \
    --header 'Content-Type: application/json' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662549845240' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --data-raw '{
        "ltCode": "DOT3LUSDT",
        "ltAmount": "100",
        "serialNo": "x005"
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "amount": "100",
            "id": "2085",
            "ltCode": "DOT3LUSDT",
            "orderAmount": "",
            "orderQuantity": "",
            "orderStatus": "2",
            "serialNo": "x005",
            "timestamp": 1662549845373,
            "valueCoin": "USDT"
        },
        "retExtInfo": {},
        "time": 1662549845453
    }
    - + \ No newline at end of file diff --git a/spot/etp/redeem.html b/spot/etp/redeem.html index 044f10d9e6..fb30c9fc8a 100644 --- a/spot/etp/redeem.html +++ b/spot/etp/redeem.html @@ -4,13 +4,13 @@ Redeem | Bybit API Documentation - +

    Redeem

    HTTP Request​

    POST /spot/v3/private/redeem

    Request Parameters​

    ParameterRequiredTypeComments
    ltCodetruestringAbbreviation of the LT.
    ltQuantitytruestringRedeem quantity
    serialNofalsestringSerial number. A kind of unique customised ID

    Response Parameters​

    ParameterTypeComments
    idstringTransaction ID
    ltCodestringAbbreviation of the LT
    orderAmountstringOrder value of the LT. Normally returns ""
    orderQuantitystringOrder quantity of the LT
    orderStatusstringOrder status; 1. Completed; 2. In progress; 3. Failed
    quantitystringQuantity. Normally returns ""
    serialNostringSerial number
    timestampnumberTimestamp
    valueCoinstringQuote asset

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/redeem' \
    --header 'Content-Type: application/json' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662605726010' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --data-raw '{
        "ltCode": "DOT3LUSDT",
        "ltQuantity": "50",
        "serialNo": "r001"
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "id": "2087",
            "ltCode": "DOT3LUSDT",
            "orderAmount": "",
            "orderQuantity": "50",
            "orderStatus": "2",
            "quantity": "",
            "serialNo": "r001",
            "timestamp": 1662605726326,
            "valueCoin": "DOT3L"
        },
        "retExtInfo": {},
        "time": 1662605727987
    }
    - + \ No newline at end of file diff --git a/spot/margin/account.html b/spot/margin/account.html index 4bbb88dd98..25a124b0d8 100644 --- a/spot/margin/account.html +++ b/spot/margin/account.html @@ -4,13 +4,13 @@ Get Loan Account Info | Bybit API Documentation - +

    Get Loan Account Info

    HTTP Request​

    GET /spot/v3/private/cross-margin-account

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    acctBalanceSumstringTotal equity (BTC)
    debtBalanceSumstringTotal liability (BTC)
    loanAccountListarrayObject
    > freestringAvailable balance
    > intereststringOutstanding interest
    > loanstringOutstanding principle
    > remainAmountstringRemaining debt = interest + loan
    > lockedstringLocked amount
    > tokenIdstringCoin name
    > totalstringTotal
    riskRatestringRisk rate
    statusintegerLoan account status
    • 1: normal
    • 2: withdrawal/transfer restricted
    • 3: liquidation alert triggered
    • 4: liquidated
    switchStatusinteger0: margin trade off, 1: margin trade on

    Request Example​

    GET /spot/v3/private/cross-margin-account HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751305868
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "acctBalanceSum": "0.455189592150138021",
            "debtBalanceSum": "0",
            "loanAccountList": [
                {
                    "free": "0.01444",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "BTC",
                    "total": "0.01444"
                },
                {
                    "free": "0.21147048",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "ETH",
                    "total": "0.21147048"
                },
                {
                    "free": "7963.58978991849",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "USDT",
                    "total": "7963.58978991849"
                },
                {
                    "free": "1380.28832",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "USDC",
                    "total": "1380.28832"
                }
            ],
            "riskRate": "0",
            "status": 1,
            "switchStatus": 1
        },
        "retExtInfo": {},
        "time": 1677751306287
    }
    - + \ No newline at end of file diff --git a/spot/margin/borrow-history.html b/spot/margin/borrow-history.html index 5af8390dfc..0c72410f9a 100644 --- a/spot/margin/borrow-history.html +++ b/spot/margin/borrow-history.html @@ -4,13 +4,13 @@ Get Borrow Order Detail | Bybit API Documentation - +

    Get Borrow Order Detail

    HTTP Request​

    GET /spot/v3/private/cross-margin-orders

    Request Parameters​

    ParameterRequiredTypeComments
    startTimefalselongThe start timestamp (ms)
    endTimefalselongThe end timestamp (ms)
    coinfalsestringCoin name
    statusfalseintegerStatus
    • 0(default)：get all kinds of status
    • 1：uncleared
    • 2：cleared
    limitfalseintegerLimit for data size per page. [1, 500]. Default: 500

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > accountIdstringAccount ID
    > coinstringCoin name
    > createdTimenumberBorrow order created timestamp (ms)
    > idstringBorrow order ID
    > interestAmountstringTotal interest
    > interestBalancestringOutstanding interest
    > loanAmountstringPrincipal amount
    > loanBalancestringOutstanding principal
    > remainAmountstringRemaining debt = interestBalance + loanBalance
    > statusintegerStatus 1：uncleared, 2：cleared
    > typeintegerOrder Type 1: manual loan, 2: auto loan

    Request Example​

    GET /spot/v3/private/cross-margin-orders?coin=ETH&limit=1&status=2 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677754328650
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "accountId": "592335",
                    "coin": "ETH",
                    "createdTime": 1677751839000,
                    "id": "21005",
                    "interestAmount": "0.0001",
                    "interestBalance": "0",
                    "loanAmount": "10",
                    "loanBalance": "0",
                    "remainAmount": "0",
                    "status": 2,
                    "type": 1
                }
            ]
        },
        "retExtInfo": {},
        "time": 1662618592344
    }
    - + \ No newline at end of file diff --git a/spot/margin/borrow.html b/spot/margin/borrow.html index 678c315c0b..36f703c5b5 100644 --- a/spot/margin/borrow.html +++ b/spot/margin/borrow.html @@ -4,13 +4,13 @@ Borrow | Bybit API Documentation - +

    Borrow

    HTTP Request​

    POST /spot/v3/private/cross-margin-loan

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name
    qtytruestringAmount to borrow

    Response Parameters​

    ParameterTypeComments
    transactIdstringBorrow transaction ID

    Request Example​

    POST /spot/v3/private/cross-margin-loan HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751838628
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 38

    {
        "coin": "ETH",
        "qty": "10"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transactId": "14143"
        },
        "retExtInfo": {},
        "time": 1662617848970
    }
    - + \ No newline at end of file diff --git a/spot/margin/borrowable-coin.html b/spot/margin/borrowable-coin.html index bd7f3c524f..9069fc43f3 100644 --- a/spot/margin/borrowable-coin.html +++ b/spot/margin/borrowable-coin.html @@ -4,13 +4,13 @@ Get Borrowable Coin Info | Bybit API Documentation - +

    Get Borrowable Coin Info

    info

    This is public endpoint, so do not need an authentication

    HTTP Request​

    GET /spot/v3/public/cross-margin-borrow-data

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin name

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > coinstringCoin name
    > borrowingPrecisionintegerAccuracy of loan amount
    > repaymentPrecisionintegerAccuracy of repayment amount

    Request Example​

    GET /spot/v3/public/cross-margin-borrow-data?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677750684772
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "borrowingPrecision": 5,
                    "coin": "ETH",
                    "repaymentPrecision": 4
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677750685331
    }
    - + \ No newline at end of file diff --git a/spot/margin/interest.html b/spot/margin/interest.html index 10bfa24fe7..da57e47ff7 100644 --- a/spot/margin/interest.html +++ b/spot/margin/interest.html @@ -4,13 +4,13 @@ Get Interest & Quota | Bybit API Documentation - +

    Get Interest & Quota

    HTTP Request​

    GET /spot/v3/private/cross-margin-loan-info

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name

    Response Parameters​

    ParameterTypeComments
    coinstringCoin name
    interestRatestringDaily interest rate
    loanAbleAmountstringThe estimated amount can be loaned
    maxLoanAmountstringThe fixed loanable amount per user on platform

    Request Example​

    GET /spot/v3/private/cross-margin-loan-info?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677750928871
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "ETH",
            "interestRate": "0.000054835",
            "loanAbleAmount": "19.220442066850037795",
            "maxLoanAmount": "300"
        },
        "retExtInfo": {},
        "time": 1677750929290
    }
    - + \ No newline at end of file diff --git a/spot/margin/margin-data.html b/spot/margin/margin-data.html index a51df23e5c..e75cf30dc4 100644 --- a/spot/margin/margin-data.html +++ b/spot/margin/margin-data.html @@ -4,13 +4,13 @@ Get Margin Coin Info | Bybit API Documentation - +

    Get Margin Coin Info

    info

    This is public endpoint, so do not need an authentication

    HTTP Request​

    GET /spot/v3/public/cross-margin-bond-data

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin name

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > coinstringCoin name
    > conversionRatestringConvert ratio
    > liquidationOrderintegerLiquidation order

    Request Example​

    GET /spot/v3/public/cross-margin-bond-data?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677750396890
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "coin": "ETH",
                    "conversionRate": "0.95",
                    "liquidationOrder": 2
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677750397414
    }
    - + \ No newline at end of file diff --git a/spot/margin/repay-history.html b/spot/margin/repay-history.html index f96e3c78c5..cc9cf69a7f 100644 --- a/spot/margin/repay-history.html +++ b/spot/margin/repay-history.html @@ -4,13 +4,13 @@ Get Repayment Order Detail | Bybit API Documentation - +

    Get Repayment Order Detail

    HTTP Request​

    GET /spot/v3/private/cross-margin-repay-history

    Request Parameters​

    ParameterRequiredTypeComments
    startTimefalselongThe start timestamp (ms)
    endTimefalselongThe end timestamp (ms)
    coinfalsestringCoin name
    limitfalseintegerLimit for data size per page. [1, 500], Default: 500

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > accountIdstringAccount ID
    > coinstringCoin name
    > repaidAmountstringRepaid amount
    > repayIdstringRepay ID
    > repayMarginOrderIdstringRepay margin order ID
    > repayTimestringRepay timestamp (ms)
    > transactIdsarrayObject
    >> repaidIntereststringInterest repaid
    >> repaidPrincipalstringPrincipal repaid
    >> repaidSerialNumberstringRepayment No. (Borrowing Order)
    >> transactIdstringBorrowing transaction ID

    Request Example​

    GET /spot/v3/private/cross-margin-repay-history?coin=ETH&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1677755884678
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "accountId": "592335",
                    "coin": "ETH",
                    "repaidAmount": "10.0001",
                    "repayId": "19070",
                    "repayMarginOrderId": "1367476828218072576",
                    "repayTime": "1677751941000",
                    "transactIds": [
                        {
                            "repaidAmount": "10.0001",
                            "repaidInterest": "0.0001",
                            "repaidPrincipal": "10",
                            "repaidSerialNumber": "1367475973544746496",
                            "transactId": "21005"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1662622151872
    }
    - + \ No newline at end of file diff --git a/spot/margin/repay.html b/spot/margin/repay.html index 97793b54fa..1778f2b4bf 100644 --- a/spot/margin/repay.html +++ b/spot/margin/repay.html @@ -4,13 +4,13 @@ Repay | Bybit API Documentation - +

    Repay

    HTTP Request​

    POST /spot/v3/private/cross-margin-repay

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name
    qtyfalsestringAmount to repay
    • qty is required when completeRepayment=0
    • qty is invalid when completeRepayment=1
    completeRepaymentfalseintegerWhether to pay off all debts. 0(default): false, 1: true

    Response Parameters​

    ParameterTypeComments
    repayIdstringRepayment transaction ID

    Request Example​

    POST /spot/v3/private/cross-margin-repay HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751944347
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 66

    {
        "coin": "ETH",
        "qty": null,
        "completeRepayment": 1
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "repayId": "12128"
        },
        "retExtInfo": {},
        "time": 1662618298452
    }
    - + \ No newline at end of file diff --git a/spot/margin/toggle.html b/spot/margin/toggle.html index 51c219bfbc..f5b8a22942 100644 --- a/spot/margin/toggle.html +++ b/spot/margin/toggle.html @@ -4,13 +4,13 @@ Toggle Margin Trade | Bybit API Documentation - +

    Toggle Margin Trade

    Turn on / off spot margin trade

    HTTP Request​

    POST /spot/v3/private/cross-margin-switch

    Request Parameters​

    ParameterRequiredTypeComments
    switchtrueinteger1: on, 0: off

    Response Parameters​

    ParameterTypeComments
    switchStatusintegerMargin trade status. 1: on, 0: off

    Request Example​

    POST /spot/v3/private/cross-margin-switch HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677747804512
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 19

    {
        "switch": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "switchStatus": 0
        },
        "retExtInfo": {},
        "time": 1677747804974
    }
    - + \ No newline at end of file diff --git a/spot/otc/coin-info.html b/spot/otc/coin-info.html index a5b823d007..4335803499 100644 --- a/spot/otc/coin-info.html +++ b/spot/otc/coin-info.html @@ -4,13 +4,13 @@ Margin Coin Info | Bybit API Documentation - +

    Margin Coin Info

    tip

    This is a public endpoint, so it does not need to authenticate.

    HTTP Request​

    GET /spot/v3/public/margin-ensure-tokens

    Request Parameters​

    ParameterRequiredTypeComments
    productIdfalsestringProductId. If not passed, then return all product margin coin. For spot, it returns coin that convertRation greater than 0.

    Response Parameters​

    ParameterTypeComments
    marginTokenarrayObject
    > productIdstringProduct Id
    > spotTokenarraySpot margin coin
    >> tokenstringMargin coin
    >> convertRatiostringMargin coin convert ratio
    > contractTokenarrayContract margin coin
    >> tokenstringMargin coin
    >> convertRatiostringMargin coin convert ratio

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/public/margin-ensure-tokens?productId=70'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "marginToken": [
                {
                    "productId": "70",
                    "spotToken": [
                        {
                            "token": "BTC",
                            "convertRatio": "1.00000000"
                        },
                        {
                            "token": "ETH",
                            "convertRatio": "1.00000000"
                        },
                        {
                            "token": "USDT",
                            "convertRatio": "1"
                        }
                    ],
                    "contractToken": [
                        {
                            "token": "USDT",
                            "convertRatio": "1"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669363954802
    }
    - + \ No newline at end of file diff --git a/spot/otc/loan-info.html b/spot/otc/loan-info.html index 0c39321767..636f542228 100644 --- a/spot/otc/loan-info.html +++ b/spot/otc/loan-info.html @@ -4,13 +4,13 @@ Get Loan Info | Bybit API Documentation - +

    Get Loan Info

    Get loan orders information

    HTTP Request​

    GET /spot/v3/private/margin-loan-infos

    Request Parameters​

    ParameterRequiredTypeComments
    orderIdfalsestringLoan order id. If not passed, then return all orders, sort by loanTime in descend
    startTimefalseintegerStart timestamp (ms)
    endTimefalseintegerEnd timestamp (ms)
    limitfalseintegerLimit for data size. [1, 100], Default: 10

    Response Parameters​

    ParameterTypeComments
    loanInfoarrayObject
    > orderIdstringLoan order ID
    > orderProductIdstringProduct ID
    > parentUidstringUser parent UID
    > loanTimestringLoan timestamp, in milliseconds
    > loanCoinstringLoan coin
    > loanAmountstringLoan amount
    > unpaidAmountstringUnpaid principal
    > unpaidIntereststringUnpaid interest
    > repaidAmountstringRepaid principal
    > repaidIntereststringRepaid interest
    > interestRatestringDaily interest rate
    > statusinteger1：outstanding; 2：paid off
    > leveragestringleverage
    > supportSpotintegerWhether to support spot. 0:false; 1:true
    > supportContractintegerWhether to support contract . 0:false; 1:true
    > withdrawLinestringRestrict line for withdrawal
    > transferLinestringRestrict line for transfer
    > spotBuyLinestringRestrict line for SPOT buy
    > spotSellLinestringRestrict line for SPOT sell
    > contractOpenLinestringRestrict line for CONTRACT open position
    > liquidationLinestringLine for liquidation
    > stopLiquidationLinestringLine for stop liquidation
    > contractLeveragestringAllowed max leverage of opening contract position
    > transferRatiostringAvailable transfer ratio of loan funds
    > spotSymbolsarrayThe whitelist of spot trading pairs
    > contractSymbolsarrayThe whitelist of contract trading pairs

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/margin-loan-infos' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1669364798602' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "loanInfo": [
                {
                    "orderId": "1244781478207029504",
                    "orderProductId": "34",
                    "parentUid": "999805",
                    "loanTime": "1663126149000",
                    "loanCoin": "USDT",
                    "loanAmount": "500000",
                    "unpaidAmount": "6351.49614274",
                    "unpaidInterest": "264.0137162",
                    "repaidAmount": "493648.50385726",
                    "repaidInterest": "0",
                    "interestRate": "0.00027397",
                    "status": 1,
                    "leverage": "20",
                    "supportSpot": 1,
                    "supportContract": 1,
                    "withdrawLine": "0.5",
                    "transferLine": "0.6",
                    "spotBuyLine": "0.7",
                    "spotSellLine": "0.8",
                    "contractOpenLine": "0.9",
                    "liquidationLine": "0.95",
                    "stopLiquidationLine": "0.20000000",
                    "contractLeverage": "3",
                    "transferRatio": "0.1",
                    "spotSymbols": [
                        "DYDXQQTEST001",
                        "DYDXNEO",
                        "PMTEST16USDT"
                    ],
                    "contractSymbols": [
                        "RAYUSDT",
                        "API3USDT",
                        "SUSHIUSDT"
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669364798924
    }
    - + \ No newline at end of file diff --git a/spot/otc/ltv.html b/spot/otc/ltv.html index f0bbcac20e..dc8f48240f 100644 --- a/spot/otc/ltv.html +++ b/spot/otc/ltv.html @@ -4,13 +4,13 @@ Get LTV | Bybit API Documentation - +

    Get LTV

    Get LTV. Please head here to get LTV if this API returns empty data.

    HTTP Request​

    GET /spot/v3/private/margin-ltv

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    ltvInfoarrayObject
    > ltvstringRisk rate
    > parentUidstringUser id
    > subAccountUidsarrayBound user id
    > unpaidAmountstringTotal debt(USDT)
    > unpaidInfoarrayDebt details
    >> tokenstringcoin
    >> unpaidQtystringUnpaid principle
    >> unpaidIntereststringUnpaid interest
    > balancestringTotal asset. (margin coins converted to USDT). Please read here to understand the calculation
    > spotBalanceInfoarraySpot asset details
    >> tokenstringSpot margin coin
    >> pricestringSpot margin coin price
    >> qtystringSpot margin coin quantity
    > contractInfoarrayContract asset details
    >> tokenstringContract margin coin
    >> pricestringContract margin coin index price
    >> qtystringContract margin coin quantity (available balance of Contract account, and it is not involved with LTV calculation)

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/margin-ltv' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1669367335035' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "ltvInfo": [
                {
                    "ltv": "0.1147",
                    "parentUid": "999805",
                    "subAccountUids": [
                        "999805"
                    ],
                    "unpaidAmount": "",
                    "unpaidInfo": [
                        {
                            "token": "USDT",
                            "unpaidQty": "6351.49614274",
                            "unpaidInterest": "264.0137162"
                        }
                    ],
                    "balance": "57626.875915433333333332400000000",
                    "spotBalanceInfo": [
                        {
                            "token": "BTC",
                            "price": "16375.621333333333333332",
                            "qty": "0.2"
                        },
                        ....
                        {
                            "token": "XRP",
                            "price": "0.409517",
                            "qty": "10000"
                        }
                    ],
                    "contractInfo": [
                        {
                            "token": "USDT",
                            "price": "1",
                            "qty": "0"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669367335608
    }
    - + \ No newline at end of file diff --git a/spot/otc/product-info.html b/spot/otc/product-info.html index 9a85e5b986..ff635fe335 100644 --- a/spot/otc/product-info.html +++ b/spot/otc/product-info.html @@ -4,13 +4,13 @@ Get Margin Product Info | Bybit API Documentation - +

    Get Margin Product Info

    tip

    This is a public endpoint, so it does not need to authenticate.

    HTTP Request​

    GET /spot/v3/public/margin-product-infos

    Request Parameters​

    ParameterRequiredTypeComments
    productIdfalsestringProduct Id. If not passed, then return all products info

    Response Parameters​

    ParameterTypeComments
    marginProductInfoarrayObject
    > productIdstringProduct Id
    > leveragestringleverage
    > supportSpotintegerWhether to support spot. 0:false; 1:true
    > supportContractintegerWhether to support contract. 0:false; 1:true
    > withdrawLinestringRestrict line for withdrawal
    > transferLinestringRestrict line for transfer
    > spotBuyLinestringRestrict line for SPOT buy
    > spotSellLinestringRestrict line for SPOT sell
    > contractOpenLinestringRestrict line for CONTRACT open position
    > liquidationLinestringLine for liquidation
    > stopLiquidationLinestringLine for stop liquidation
    > contractLeveragestringAllowed max leverage of opening contract position
    > transferRatiostringAvailable transfer ratio of loan funds
    > spotSymbolsarrayThe whitelist of spot trading pairs
    > contractSymbolsarrayThe whitelist of contract trading pairs

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/margin-product-infos?productId=70'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "marginProductInfo": [
                {
                    "productId": "70",
                    "leverage": "5.00000000",
                    "supportSpot": 1,
                    "supportContract": 1,
                    "withdrawLine": "0.5",
                    "transferLine": "0.6",
                    "spotBuyLine": "0.7",
                    "spotSellLine": "0.8",
                    "contractOpenLine": "0.9",
                    "liquidationLine": "0.95",
                    "stopLiquidationLine": "0.40000000",
                    "contractLeverage": "",
                    "transferRatio": "",
                    "spotSymbols": [
                        "DYDXQQTEST001"
                    ],
                    "contractSymbols": [
                        "RAYUSDT",
                        "API3USDT"
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669362961705
    }
    - + \ No newline at end of file diff --git a/spot/otc/repay-info.html b/spot/otc/repay-info.html index ea17c55616..51fd945bc6 100644 --- a/spot/otc/repay-info.html +++ b/spot/otc/repay-info.html @@ -4,13 +4,13 @@ Get Repay Info | Bybit API Documentation - +

    Get Repay Info

    Get repaid order information. Authentication needed.

    HTTP Request​

    GET /spot/v3/private/margin-repaid-infos

    Request Parameters​

    ParameterRequiredTypeComments
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size. [1, 100]. Default: 100

    Response Parameters​

    ParameterTypeComments
    repayInfoarrayObject
    > repayOrderIdstringRepaid order ID
    > repaidTimestringRepaid timestamp (ms)
    > tokenstringRepaid coin
    > quantitystringRepaid principle
    > intereststringRepaid interest
    > businessTypestringRepaid type. 1：normal repayment; 2：repaid by liquidation
    > statusstring1：outstanding; 2：paid off

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/margin-repaid-infos?startTime=1663126392000&endTime=1663126394000' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1669366647851' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "repayInfo": [
                {
                    "repayOrderId": "8189",
                    "repaidTime": "1663126393000",
                    "token": "USDT",
                    "quantity": "30000",
                    "interest": "0",
                    "businessType": "1",
                    "status": "1"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669366648366
    }
    - + \ No newline at end of file diff --git a/spot/public/bid-ask.html b/spot/public/bid-ask.html index fd262f6d4c..9b3b2c63cf 100644 --- a/spot/public/bid-ask.html +++ b/spot/public/bid-ask.html @@ -4,13 +4,13 @@ Best Bid/Ask Price | Bybit API Documentation - +

    Best Bid/Ask Price

    info

    If symbol is not specified, the best order price from all symbols will be returned

    HTTP Request​

    GET /spot/v3/public/quote/ticker/bookTicker

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringName of the trading pair

    Response Parameters​

    ParameterTypeComments
    symbolstringName of the trading pair
    bidPricestringBest bid price
    bidQtystringBid quantity
    askPricestringBest ask price
    askQtystringAsk quantity
    timenumberMillisecond timestamp

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/ticker/bookTicker?symbol=BTCUSDT'

    Response Example​

    {
      "retCode": 0,
      "retMsg": "OK",
      "result": {
        "symbol": "BTCUSDT",
        "bidPrice": "21170.14",
        "bidQty": "0.908276",
        "askPrice": "21250",
        "askQty": "0.009264",
        "time": 1659431461695
      },
      "retExtInfo": {},
      "time": 1659431462103
    }
    - + \ No newline at end of file diff --git a/spot/public/depth.html b/spot/public/depth.html index 104862836d..c06eff243c 100644 --- a/spot/public/depth.html +++ b/spot/public/depth.html @@ -4,13 +4,13 @@ Order Book | Bybit API Documentation - +

    Order Book

    HTTP Request​

    GET /spot/v3/public/quote/depth

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringsymbol
    limitfalseintegerLimit for data size. [1, 200]. Default: 100

    Response Parameters​

    ParameterTypeComments
    timenumberCurrent time, unit in millisecond
    bidsarrayBid price and quantity, with best bid prices ranked from top to bottom
    asksarrayAsk price and quantity, with best ask prices ranked from top to bottom

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/depth?symbol=BTCUSDT&limit=1'

    Response Example​

    {
      "retCode": 0,
      "retMsg": "OK",
      "result": {
        "time": 1659429083820,
        "bids": [
          [
            "21170.14",
            "0.050096"
          ]
        ],
        "asks": [
          [
            "21250",
            "0.00211"
          ]
        ]
      },
      "retExtInfo": {},
      "time": 1659429083979
    }
    - + \ No newline at end of file diff --git a/spot/public/instrument.html b/spot/public/instrument.html index 032271eaf7..d7ab90ac0f 100644 --- a/spot/public/instrument.html +++ b/spot/public/instrument.html @@ -4,13 +4,13 @@ Instrument Info | Bybit API Documentation - +

    Instrument Info

    Get the spec of symbol information

    HTTP Request​

    GET /spot/v3/public/symbols

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > namestringName of the trading pair
    > aliasstringAlias
    > baseCoinstringBase currency
    > quoteCoinstringQuote currency
    > basePrecisionstringDecimal precision (base currency)
    > quotePrecisionstringDecimal precision (quote currency)
    > minTradeQtystringMin. order qty (Not valid for market buy orders)
    > minTradeAmtstringMin. order value (Only valid for market buy orders)
    > minPricePrecisionstringMin. number of decimal places
    > maxTradeQtystringMax. order qty (It is ignored when you place an order with order type LIMIT_MAKER)
    > maxTradeAmtstringMax. order value (It is ignored when you place an order with order type LIMIT_MAKER)
    > categorystringCategory
    > innovationstring1 indicates that the price of this currency is relatively volatile
    > showStatusstring1 indicates that the symbol open for trading

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/symbols'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "name": "BTCUSDT",
                    "alias": "BTCUSDT",
                    "baseCoin": "BTC",
                    "quoteCoin": "USDT",
                    "basePrecision": "0.000001",
                    "quotePrecision": "0.00000001",
                    "minTradeQty": "0.000001",
                    "minTradeAmt": "10",
                    "maxTradeQty": "63.01197227",
                    "maxTradeAmt": "1000000",
                    "minPricePrecision": "0.01",
                    "category": "1",
                    "showStatus": "1",
                    "innovation": "0"
                },
                {
                    "name": "ETHUSDT",
                    "alias": "ETHUSDT",
                    "baseCoin": "ETH",
                    "quoteCoin": "USDT",
                    "basePrecision": "0.00001",
                    "quotePrecision": "0.0000001",
                    "minTradeQty": "0.00224",
                    "minTradeAmt": "10",
                    "maxTradeQty": "100000000",
                    "maxTradeAmt": "100000000",
                    "minPricePrecision": "0.01",
                    "category": "1",
                    "showStatus": "1",
                    "innovation": "0"
                }
            ]
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659067662931
    }
    - + \ No newline at end of file diff --git a/spot/public/kline.html b/spot/public/kline.html index c88dc56e54..847df5525f 100644 --- a/spot/public/kline.html +++ b/spot/public/kline.html @@ -4,13 +4,13 @@ Kline | Bybit API Documentation - +

    Kline

    info

    It only returns the results from latest 1000 candles regardless of what interval is specified

    info

    If startTime and endTime are not specified, only the latest candles will be sent

    HTTP Request​

    GET /spot/v3/public/quote/kline

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringName of the trading pair
    intervaltruestringChart interval
    limitfalseintegerLimit for data size. [1, 1000]. Default: 1000
    startTimefalseintegerStart time (ms)
    endTimefalseintegerEnd time (ms)

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > tnumberTimestamp(ms)
    > sstringName of the trading pair
    > snstringAlias
    > cstringClose price
    > hstringHigh price
    > lstringLow price
    > ostringOpen price
    > vstringTrading volume

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/kline?symbol=BTCUSDT&interval=1m&limit=1'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "t": 1659430380000,
                    "s": "BTCUSDT",
                    "sn": "BTCUSDT",
                    "c": "21170.14",
                    "h": "21170.14",
                    "l": "21127.86",
                    "o": "21127.86",
                    "v": "0.907276"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1659430400353
    }
    - + \ No newline at end of file diff --git a/spot/public/last-price.html b/spot/public/last-price.html index b9322f4c26..9f9761162f 100644 --- a/spot/public/last-price.html +++ b/spot/public/last-price.html @@ -4,13 +4,13 @@ Last Traded Price | Bybit API Documentation - +

    Last Traded Price

    info

    If symbol is not specified, the price from all symbols will be returned

    HTTP Request​

    GET /spot/v3/public/quote/ticker/price

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringName of the trading pair

    Response Parameters​

    ParameterTypeComments
    symbolstringName of the trading pair
    pricestringLast traded price

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/ticker/price?symbol=BTCUSDT'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "price": "21127.86"
        },
        "retExtInfo": {},
        "time": 1659431315936
    }
    - + \ No newline at end of file diff --git a/spot/public/merge-depth.html b/spot/public/merge-depth.html index ca07291d8f..f1556fc97a 100644 --- a/spot/public/merge-depth.html +++ b/spot/public/merge-depth.html @@ -4,13 +4,13 @@ Merged Order Book | Bybit API Documentation - +

    Merged Order Book

    HTTP Request​

    GET /spot/v3/public/quote/depth/merged

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringName of the trading pair
    scalefalseintegerPrecision of the merged orderbook, 1 means 1 digit
    limitfalseintegerLimit for data size. [1, 200]. Default: 100

    Response Parameters​

    ParameterTypeComments
    timenumberCurrent time, unit in millisecond
    bidsarrayBid price and quantity, with best bid prices ranked from top to bottom
    asksarrayAsk price and quantity, with best ask prices ranked from top to bottom

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/depth/merged?symbol=BTCUSDT&scale=1&limit=1'

    Response Example​

    {
      "retCode": 0,
      "retMsg": "OK",
      "result": {
        "time": 1659429646349,
        "bids": [
          [
            "21170.1",
            "0.049096"
          ]
        ],
        "asks": [
          [
            "21250",
            "0.00211"
          ]
        ]
      },
      "retExtInfo": {},
      "time": 1659429646652
    }
    - + \ No newline at end of file diff --git a/spot/public/recent-trade.html b/spot/public/recent-trade.html index 29dcf966e3..fdeb9ccd07 100644 --- a/spot/public/recent-trade.html +++ b/spot/public/recent-trade.html @@ -4,13 +4,13 @@ Public Trading Records | Bybit API Documentation - +

    Public Trading Records

    HTTP Request​

    GET /spot/v3/public/quote/trades

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringName of the trading pair
    limitfalseintegerLimit for data size. [1, 60]. Default: 60 ｜

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > pricestringOrder price
    > timenumberCurrent timestamp (ms)
    > qtystringOrder quantity
    > isBuyerMakerinteger0：Sell or taker order, 1：Buy maker order
    > typestring0：normal trade, 1：Paradigm block trade

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/trades?symbol=BTCUSDT&limit=1'

    Response Example​

    {
      "retCode": 0,
      "retMsg": "OK",
      "result": {
        "list": [
          {
            "price": "21170.14",
            "time": 1659429793926,
            "qty": "0.907276",
            "isBuyerMaker": 0,
            "type": "0"
          }
        ]
      },
      "retExtInfo": {},
      "time": 1659429835311
    }
    - + \ No newline at end of file diff --git a/spot/public/tickers.html b/spot/public/tickers.html index f11c95a453..81e613737b 100644 --- a/spot/public/tickers.html +++ b/spot/public/tickers.html @@ -4,13 +4,13 @@ Tickers | Bybit API Documentation - +

    Tickers

    HTTP Request​

    GET /spot/v3/public/quote/ticker/24hr

    info

    If symbol is not specified, the data from all symbols will be returned

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringName of the trading pair

    Response Parameters​

    ParameterTypeComments
    tnumberCurrent timestamp (ms)
    sstringName of the trading pair
    lpstringLast traded price
    hstringHigh price
    lstringLow price
    ostringOpen price
    bpstringBest bid price
    apstringBest ask price
    vstringTrading volume
    qvstringTrading quote volume

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/ticker/24hr?symbol=BTCUSDT'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "t": 1659430933736,
            "s": "BTCUSDT",
            "lp": "21127.86",
            "h": "22000",
            "l": "19779.14",
            "o": "19935.19",
            "bp": "21170.14",
            "ap": "21250",
            "v": "211.378621",
            "qv": "4460854.96730398"
        },
        "retExtInfo": {},
        "time": 1659430975794
    }
    - + \ No newline at end of file diff --git a/spot/rate-limit.html b/spot/rate-limit.html index 103dd87b27..0c13af4ff7 100644 --- a/spot/rate-limit.html +++ b/spot/rate-limit.html @@ -4,7 +4,7 @@ Rate Limit | Bybit API Documentation - + @@ -15,7 +15,7 @@ in an unexpected violation.

    • GET/POST method (shared):
      • No more than 600 requests are allowed in any 5-second window.
    note

    All traffic to api.bybit.com or api.bytick.com share this limit regardless of if it accesses Spot, Derivatives or Options.

    After violating the limit your IP will be banned for a set period of time (usually 30 minutes). Continually violating the limit will result in a permanent ban. We cannot undo permanent bans or shorten temporary bans.

    API Rate Limit​

    caution

    If you receive "ret_msg": "Too many visits!" in the JSON response, you have hit the API rate limit.

    The API rate limit is based on the rolling time window per second and UID. In other words, it is per second per UID. Every request to the API returns response header shown in the code panel:

    • X-Bapi-Limit-Status - your remaining requests for current endpoint
    • X-Bapi-Limit - your current limit for current endpoint
    • X-Bapi-Limit-Reset-Timestamp - the timestamp indicating when your request limit resets if you have exceeded your rate_limit. Otherwise, this is just the current timestamp.

    Http Response Header Example

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    API Rate Limit Table​

    PathLimit
    Cross margin trade5 req/s
    All other private endpoints20 req/s

    How to increase API Limit​

    Please email api@bybit.com with the following information. We will reply within 1-4 working days:

    1. Your name and your company details
    2. Your Bybit UID or registered email, and the assets you are trading
    3. General description of your trading strategy and reasons for higher rate limits
    4. Screenshot of previous monthly trading volume (maker/taker) on other platforms
    5. Optional: your order history in CSV format
    - + \ No newline at end of file diff --git a/spot/trade/batch-cancel.html b/spot/trade/batch-cancel.html index 3df875d4a3..c24249661b 100644 --- a/spot/trade/batch-cancel.html +++ b/spot/trade/batch-cancel.html @@ -4,13 +4,13 @@ Batch Cancel Order | Bybit API Documentation - +

    Batch Cancel Order

    HTTP Request​

    POST /spot/v3/private/cancel-orders

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringName of the trading pair
    sidefalsestringSide. BUY, SELL
    orderTypesfalsestringOrder type. LIMIT in default. It allows multiple types, separated by comma, e.a LIMIT,LIMIT_MAKER
    orderCategoryfalseintegerOrder category. 0：normal order by default; 1：TP/SL order, Required for TP/SL order.

    Response Parameters​

    ParameterTypeComments
    successstringBatch cancel successfully or not. 0：fail, 1：success

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/cancel-orders' \
    --header 'X-BAPI-SIGN: XXXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659078150737' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "symbol": "BTCUSDT",
        "side": "Buy",
        "orderTypes": "LIMIT,LIMIT_MAKER"
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "success": "1"
        },
        "retExtInfo": {},
        "time": 1659080154042
    }
    - + \ No newline at end of file diff --git a/spot/trade/cancel-by-id.html b/spot/trade/cancel-by-id.html index 2e806807da..3cb889ac94 100644 --- a/spot/trade/cancel-by-id.html +++ b/spot/trade/cancel-by-id.html @@ -4,13 +4,13 @@ Batch Cancel Order By Id | Bybit API Documentation - +

    Batch Cancel Order By Id

    HTTP Request​

    POST /spot/v3/private/cancel-orders-by-ids

    Request Parameters​

    ParameterRequiredTypeComments
    orderIdstruestringOrder ID, use commas to indicate multiple orderIds. Maximum of 100 ids.
    orderCategoryfalseintegerOrder category. 0：normal order by default; 1：TP/SL order, Required for TP/SL order.

    Response Parameters​

    ParameterTypeComments
    listarrayObject. If all success, it returns empty array []
    > orderIdstringOrder ID
    > codestringErrors

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/cancel-orders-by-ids' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659080877551' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "orderIds": "1210851823244553984,1210852013162639104"
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": []
        },
        "retExtInfo": {},
        "time": 1659080815222
    }
    - + \ No newline at end of file diff --git a/spot/trade/cancel.html b/spot/trade/cancel.html index f71f9d2a47..e927dadd12 100644 --- a/spot/trade/cancel.html +++ b/spot/trade/cancel.html @@ -4,13 +4,13 @@ Cancel Order | Bybit API Documentation - +

    Cancel Order

    HTTP Request​

    POST /spot/v3/private/cancel-order

    Request Parameters​

    ParameterRequiredTypeComments
    orderIdfalsestringOrder ID. Required if not passing orderLinkId
    orderLinkIdfalsestringUnique user-set order ID. Required if not passing orderId
    orderCategoryfalseintegerOrder category. 0：normal order by default; 1：TP/SL order, Required for TP/SL order.

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser-generated order ID
    symbolstringName of the trading pair
    statusstringOrder status
    accountIdstringAccount ID
    orderPricestringOrder price
    createTimestringOrder Creation Time
    orderQtystringOrder quantity
    execQtystringExecuted quantity
    timeInForcestringTime in force
    orderTypestringOrder type
    sidestringSide. BUY, SELL

    Request Example​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/cancel-order' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659078017415' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "orderId": "1210810256551063296",
        "orderLinkId": null
    }'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1210810256551063296",
            "orderLinkId": "spotA0010",
            "symbol": "BTCUSDT",
            "status": "NEW",
            "accountId": "533287",
            "createTime": "1659075830464",
            "orderPrice": "23500",
            "orderQty": "0.01",
            "execQty": "0",
            "timeInForce": "GTC",
            "orderType": "LIMIT",
            "side": "SELL"
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659078151226
    }
    - + \ No newline at end of file diff --git a/spot/trade/get-order.html b/spot/trade/get-order.html index 596c747fa3..5b8889ab4f 100644 --- a/spot/trade/get-order.html +++ b/spot/trade/get-order.html @@ -4,13 +4,13 @@ Get Order | Bybit API Documentation - +

    Get Order

    HTTP Request​

    GET /spot/v3/private/order

    Request Parameters​

    ParameterRequiredTypeComments
    orderIdfalsestringOrder ID. Required if not passing orderLinkId
    orderLinkIdfalsestringUnique user-set order ID. Required if not passing orderId
    orderCategoryfalseintegerOrder category. 0：normal order by default; 1：TP/SL order, Required for TP/SL order.

    Response Parameters​

    ParameterTypeComments
    accountIdstringAccount ID
    symbolstringName of the trading pair
    orderLinkIdstringUser-generated order ID
    orderIdstringOrder ID
    orderPricestringOrder price
    orderQtystringOrder quantity
    execQtystringExecuted quantity
    cummulativeQuoteQtystringTotal order quantity. For some historical data, it might less than 0, and that means it is not applicable
    avgPricestringAverage filled price
    statusstringOrder status
    timeInForcestringTime in force
    orderTypestringOrder type
    sidestringOrder direction
    stopPricestringStop price
    icebergQtystringPlease ignore
    createTimestringOrder created time in the match engine
    updateTimestringLast time order was updated
    isWorkingstringIs working. 0：valid, 1：invalid
    lockedstringReserved for order (if it's 0, it means that the funds corresponding to the order have been settled)
    blockTradeIdstringParadigm block trade ID
    cancelTypestringCancel type. CancelBySmp
    smpTypestringSMP execution type
    smpGroupintegerSmp group ID. If the uid has no group, it is 0 by default
    smpOrderIdstringThe counterparty's orderID which triggers this SMP execution

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/order?orderLinkId=spotA0010' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659076396894' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "accountId": "533287",
            "symbol": "BTCUSDT",
            "orderLinkId": "spotA0010",
            "orderId": "1210810256551063296",
            "orderPrice": "23500",
            "orderQty": "0.01",
            "execQty": "0",
            "cummulativeQuoteQty": "0",
            "avgPrice": "0",
            "status": "NEW",
            "timeInForce": "GTC",
            "orderType": "LIMIT",
            "side": "SELL",
            "stopPrice": "0.0",
            "icebergQty": "0.0",
            "createTime": "1659075830464",
            "updateTime": "1659075830497",
            "isWorking": "1",
            "locked": "0.01",
            "blockTradeId": "",
            "cancelType": "UNKNOWN"
            "smpGroup": 0,
            "smpOrderId": "",
            "smpType": "None"
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659076397365
    }
    - + \ No newline at end of file diff --git a/spot/trade/my-trades.html b/spot/trade/my-trades.html index d2ea8e3d47..7d11756bf0 100644 --- a/spot/trade/my-trades.html +++ b/spot/trade/my-trades.html @@ -4,13 +4,13 @@ Trade History | Bybit API Documentation - +

    Trade History

    info
    • If startTime is not specified, you can only query for records in the last 7 days.
    • If you want to query for records older than 7 days, startTime is required.
    • It supports to query records up to 180 days.
    info

    If the orderId is null, fromTicketId is passed, and toTicketId is null, then the result is sorted by ticketId in ascend. Otherwise, the result is sorted by ticketId in descend.

    HTTP Request​

    GET /spot/v3/private/my-trades

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringName of the trading pair
    orderIdfalsestringOrder ID
    limitfalsestringDefault value is 50, max 50
    startTimefalseintegerStart timestamp (ms)
    endTimefalseintegerEnd time timestamp (ms)
    fromTradeIdfalsestringQuery greater than the trade ID
    toTradeIdfalsestringQuery smaller than the trade ID

    Response Parameters​

    ParameterTypeComments
    symbolstringName of the trading pair
    idstringIrrelevant for API usage. This field reflects the "Transaction ID" from the Trade History section of the website
    orderIdstringOrder ID
    tradeIdstringThe ID for the trade
    orderPricestringLast traded price
    orderQtystringOrder quantity
    execFeestringTrading fee (for a single fill)
    feeTokenIdstringFee Token ID
    creatTimestringOrder created time in the match engine
    isBuyerstring0：Buyer, 1：Seller
    isMakerstring0：Maker, 1：Taker
    matchOrderIdstringOrder ID of the opponent trader
    makerRebatestringMaker rebate
    executionTimestringOrder execution time
    blockTradeIdstringParadigm block trade ID

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/my-trades?symbol=BTCUSDT' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659084253772' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "id": "1210346127973428992",
                    "orderId": "1210073515485572864",
                    "tradeId": "2100000000001769786",
                    "orderPrice": "20500",
                    "orderQty": "0.02",
                    "execFee": "0.00002",
                    "feeTokenId": "BTC",
                    "creatTime": "1659020488738",
                    "isBuyer": "0",
                    "isMaker": "0",
                    "matchOrderId": "1210346015893229312",
                    "makerRebate": "0",
                    "executionTime": "1659020502026"
                    "blockTradeId": ""
                },
                {
                    "symbol": "BTCUSDT",
                    "id": "1208702504949264128",
                    "orderId": "1208702504731160320",
                    "tradeId": "2100000000001753197",
                    "orderPrice": "20240",
                    "orderQty": "0.009881",
                    "execFee": "0.000009881",
                    "feeTokenId": "BTC",
                    "creatTime": "1658824566874",
                    "isBuyer": "0",
                    "isMaker": "1",
                    "matchOrderId": "1208677465155702529",
                    "makerRebate": "0",
                    "executionTime": "1658824566893"
                    "blockTradeId": ""
                }
            ]
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659084254366
    }
    - + \ No newline at end of file diff --git a/spot/trade/open-order.html b/spot/trade/open-order.html index 7b07663c8f..ac519af0ed 100644 --- a/spot/trade/open-order.html +++ b/spot/trade/open-order.html @@ -4,13 +4,13 @@ Open Orders | Bybit API Documentation - +

    Open Orders

    HTTP Request​

    GET /spot/v3/private/open-orders

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringName of the trading pair
    orderIdfalsestringSpecify orderId to return all the orders that orderId of which are smaller than this particular one for pagination purpose
    limitfalseintegerLimit for data size. [1, 500]. Default: 500
    orderCategoryfalseintegerOrder category. 0：normal order by default; 1：TP/SL order, Required for TP/SL order.

    Response Parameters​

    ParameterTypeComments
    accountIdstringAccount ID
    symbolstringName of the trading pair
    orderLinkIdstringUser-generated order ID
    orderIdstringOrder ID
    orderPricestringOrder price
    orderQtystringOrder quantity
    execQtystringExecuted quantity
    cummulativeQuoteQtystringTotal order quantity. For some historical data, it might less than 0, and that means it is not applicable
    avgPricestringAverage filled price
    statusstringOrder status
    timeInForcestringTime in force
    orderTypestringOrder type
    sidestringSide. BUY, SELL
    stopPricestringStop price
    icebergQtystringPlease ignore
    createTimeintegerOrder created time in the match engine
    updateTimeintegerLast time order was updated
    isWorkingstringIs working. 0：valid, 1：invalid
    orderCategoryintegerOrder category. 0：normal order; 1：TP/SL order. TP/SL order has this field
    triggerPricestringTrigger price. TP/SL order has this field
    blockTradeIdstringParadigm block trade ID
    cancelTypestringCancel type. CancelBySmp
    smpTypestringSMP execution type
    smpGroupintegerSmp group ID. If the uid has no group, it is 0 by default
    smpOrderIdstringThe counterparty's orderID which triggers this SMP execution

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/open-orders?symbol=BTCUSDT' \
    --header 'X-BAPI-SIGN: e28768ea749013bbd0eb38edf78e1cac187d3018e4807859a84a37cf52feb5c0' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659081676022' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "accountId": "533287",
                    "symbol": "BTCUSDT",
                    "orderLinkId": "spotx004",
                    "orderId": "1210858291884732160",
                    "orderPrice": "23500",
                    "orderQty": "0.02",
                    "execQty": "0",
                    "cummulativeQuoteQty": "0",
                    "avgPrice": "0",
                    "status": "NEW",
                    "timeInForce": "GTC",
                    "orderType": "LIMIT_MAKER",
                    "side": "SELL",
                    "stopPrice": "0.0",
                    "icebergQty": "0.0",
                    "createTime": 1659081556722,
                    "updateTime": 1659081556740,
                    "isWorking": "1",
                    "blockTradeId": "",
                    "cancelType": "UNKNOWN"
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "smpType": "None"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1659081570356
    }
    - + \ No newline at end of file diff --git a/spot/trade/order-history.html b/spot/trade/order-history.html index ac4d51ee88..bcdd9fc120 100644 --- a/spot/trade/order-history.html +++ b/spot/trade/order-history.html @@ -4,13 +4,13 @@ Order History | Bybit API Documentation - +

    Order History

    info
    • If startTime and endTime are both not specified, it returns last 7 days records by default.
    • Supports fetching 3 months worth of data per request. Returns data up to 6 months old.
    • Market maker can only get recent 3 days orders.
    • Cancelled, Rejected, Deactivated orders save up to 7 days

    HTTP Request​

    GET /spot/v3/private/history-orders

    Request Parameters​

    ParameterRequiredTypeComments
    symbolfalsestringName of the trading pair
    orderIdfalsestringSpecify orderId to return all the orders that orderId of which are smaller than this particular one for pagination purpose
    limitfalseintegerLimit for data size. [1, 500]. Default: 100
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    orderCategoryfalseintegerOrder category. 0：normal order by default; 1：TP/SL order, Required for TP/SL order.

    Response Parameters​

    ParameterTypeComments
    accountIdstringAccount ID
    symbolstringName of the trading pair
    orderLinkIdstringUser-generated order ID
    orderIdstringOrder ID
    orderPricestringLast traded price
    orderQtystringOrder quantity
    execQtystringExecuted quantity
    cummulativeQuoteQtystringTotal order quantity
    avgPricestringAverage filled price
    statusstringOrder status
    timeInForcestringTime in force
    orderTypestringOrder type
    sidestringSide. BUY, SELL
    stopPricestringStop price
    icebergQtystringPlease ignore
    createTimenumberOrder created time in the match engine
    updateTimenumberLast time order was updated
    isWorkingstringIs working. 0：valid, 1：invalid
    orderCategoryintegerOrder category. 0：normal order; 1：TP/SL order. TP/SL order has this field
    triggerPricestringTrigger price. TP/SL order has this field
    blockTradeIdstringParadigm block trade ID
    cancelTypestringCancel type. CancelBySmp
    smpTypestringSMP execution type
    smpGroupintegerSmp group ID. If the uid has no group, it is 0 by default
    smpOrderIdstringThe counterparty's orderID which triggers this SMP execution

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/history-orders?symbol=BTCUSDT&limit=2&startTime=1658246400000&endTime=1659110400000' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659082629976' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "accountId": "533287",
                    "symbol": "BTCUSDT",
                    "orderLinkId": "spotx003",
                    "orderId": "1210856408331857664",
                    "orderPrice": "23800",
                    "orderQty": "0.02",
                    "execQty": "0",
                    "cummulativeQuoteQty": "0",
                    "avgPrice": "0",
                    "status": "REJECTED",
                    "timeInForce": "GTC",
                    "orderType": "LIMIT_MAKER",
                    "side": "BUY",
                    "stopPrice": "0.0",
                    "icebergQty": "0.0",
                    "createTime": 1659081332185,
                    "updateTime": 1659081332225,
                    "isWorking": "1",
                    "blockTradeId": "",
                    "cancelType": "UNKNOWN"
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "smpType": "None"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1659082630638
    }
    - + \ No newline at end of file diff --git a/spot/trade/place-order.html b/spot/trade/place-order.html index d94346205f..8a83e0a85f 100644 --- a/spot/trade/place-order.html +++ b/spot/trade/place-order.html @@ -4,13 +4,13 @@ Place Order | Bybit API Documentation - +

    Place Order

    info

    Do not use the duplicate orderLinkId in normal order & TP/SL order

    HTTP Request​

    POST /spot/v3/private/order

    Request Parameters​

    ParameterRequiredTypeComments
    symboltruestringName of the trading pair
    orderQtytruestringOrder qty. When you place a MARKET BUY order, this param means quote amount. e.g., MARKET BUY BTCUSDT, orderQty should be 200 USDT
    sidetruestringSide. BUY, SELL
    orderTypetruestringOrder type
    timeInForcefalsestringTime in force
    orderPricefalsestringOrder price. When the type field is MARKET, the price field is optional. When the type field is LIMIT or LIMIT_MAKER, the price field is required
    orderLinkIdfalsestringUser-generated order ID
    orderCategoryfalseintegerOrder category. 0：normal order by default; 1：TP/SL order, Required for TP/SL order.
    triggerPricefalsestringTrigger price. Used for TP/SL order
    smpTypefalsestringSmp execution type. What is SMP?

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser-generated order ID
    symbolstringName of the trading pair
    createTimestringOrder Creation Time
    orderPricestringLast traded price
    orderQtystringOrder quantity
    orderTypestringOrder type
    sidestringSide. BUY, SELL
    statusstringOrder status
    timeInForcestringTime in force
    accountIdstringAccount ID
    execQtystringPlease ignore
    orderCategoryintegerOrder category. 0：normal order by default; 1：TP/SL order
    triggerPricestringTrigger price. TP/SL order has this field
    smpTypestringSmp execution type

    Request Example​

    POST /spot/v3/private/order HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673333450317
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 146

    {
        "symbol": "ETHUSDT",
        "orderPrice": "1220",
        "side": "SELL",
        "orderQty": "1",
        "orderType": "LIMIT",
        "timeInForce": "GTC"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1330411843270754304",
            "orderLinkId": "1673333450634810",
            "symbol": "ETHUSDT",
            "createTime": "1673333450646",
            "orderPrice": "1220",
            "orderQty": "1",
            "orderType": "LIMIT",
            "side": "SELL",
            "status": "NEW",
            "timeInForce": "GTC",
            "accountId": "592335",
            "execQty": "0",
            "orderCategory": 0,
            "smpType": "None"
        },
        "retExtInfo": {},
        "time": 1673333450660
    }
    - + \ No newline at end of file diff --git a/spot/wallet.html b/spot/wallet.html index ff53f5417c..3750eb950d 100644 --- a/spot/wallet.html +++ b/spot/wallet.html @@ -4,13 +4,13 @@ Get Wallet Balance | Bybit API Documentation - +

    Get Wallet Balance

    HTTP Request​

    GET /spot/v3/private/account

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    balancesarrayObject
    > coinstringCoin
    > coinIdstringCoin ID
    > totalstringTotal equity
    > freestringAvailable balance
    > lockedstringReserved for orders

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/account' \
    --header 'X-BAPI-SIGN: XXXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659346886605' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "balances": [
                {
                    "coin": "BTC",
                    "coinId": "BTC",
                    "total": "0.20378018343",
                    "free": "0.20378018343",
                    "locked": "0"
                },
                {
                    "coin": "BTC3L",
                    "coinId": "BTC3L",
                    "total": "743.03560386",
                    "free": "743.03560386",
                    "locked": "0"
                },
                {
                    "coin": "BTC3S",
                    "coinId": "BTC3S",
                    "total": "0.999",
                    "free": "0.999",
                    "locked": "0"
                }
            ]
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659346887407
    }
    - + \ No newline at end of file diff --git a/spot/ws-private/execution.html b/spot/ws-private/execution.html index 80e4c76f07..812cdf3e3d 100644 --- a/spot/ws-private/execution.html +++ b/spot/ws-private/execution.html @@ -4,13 +4,13 @@ Execution | Bybit API Documentation - +

    Execution

    This topic pushes filled trades information. When an order is filled, you will receive two messages: one from ticketInfo, and one from order / stopOrder

    Push frequency: real-time

    Topic: ticketInfo

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > estringEvent type
    > EstringEvent time
    > sstringTrading pair
    > qstringFilled quantity
    > tstringFilled timestamp (ms)
    > pstringFilled price
    > TstringTrade ID
    > ostringOrder ID
    > cstringUser-generated order ID
    > OstringOrder ID of the opponent trader
    > astringAccount ID
    > AstringAccount ID of the opponent trader
    > mbooleanIs MAKER. true: maker, false: taker
    > SstringSide. BUY, SELL
    > bstringParadigm block trade ID

    Subscribe Example​

    {
        "req_id": "ticketInfo_1", //optional
        "op": "subscribe",
        "args": [
            "ticketInfo"
        ]
    }

    Stream Example​

    {
        "type": "snapshot",
        "topic": "ticketInfo",
        "ts": "1662348310388",
        "data": [
            {
                "e": "ticketInfo",
                "E": "1662348310386",
                "s": "BTCUSDT",
                "q": "0.001007",
                "t": "1662348310373",
                "p": "19842.02",
                "T": "2100000000002220938",
                "o": "1238261807653647872",
                "c": "spotx008",
                "O": "1238225004531834368",
                "a": "533287",
                "A": "642908",
                "m": false,
                "S": "BUY",
                "b": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/spot/ws-private/order.html b/spot/ws-private/order.html index 5e188dffde..9de1f6966f 100644 --- a/spot/ws-private/order.html +++ b/spot/ws-private/order.html @@ -4,13 +4,13 @@ Order | Bybit API Documentation - +

    Order

    This topic pushes order information，avg.filledPrice = Z / z

    Push frequency: real-time

    Topic: order

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > estringEvent type
    > EstringEvent time
    > sstringTrading pair
    > cstringUser-generated order ID
    > SstringBUY: buy order, SELL: sell order
    > ostringOrder type. LIMIT, MARKET_OF_QUOTE(Market Buy), MARKET_OF_BASE(Market Sell)
    > fstringTime in force
    > qstringOrder quantity
    > pstringOrder price
    > XstringOrder status
    > istringOrder ID
    > MstringOrder ID of the opponent trader
    > lstringLast filled quantity
    > zstringTotal filled quantity
    > LstringLast traded price
    > nstringTrading fee, it is the latest execution fee for order.
  • After upgraded to the Unified account, you can use execFee for each fill in V5 Execution topic
    • > NstringAsset type in which fee is paid
    > ubooleanIs normal trade. False if self-trade.
    > wbooleanIs working. false：invalid; true：valid
    > mbooleanIs LIMIT_MAKER
    > OstringOrder creation timestamp (ms)
    > ZstringTotal filled value
    > AstringAccount ID of the opponent trader
    > CbooleanIs closed
    > vstringleverage
    > dstringNO_LIQ: it is not a liquidation order. IOC: it is a liquidation order
    > tstringTrade ID
    > bstringParadigm block trade ID
    > ctstringCancel type. CancelBySmp
    > ststringSMP execution type
    > sgintegerSmp group ID. If the uid has no group, it is 0 by default
    > sostringThe counterparty's orderID which triggers this SMP execution

    Subscribe Example​

    {
        "req_id": "order_1", //optional
        "op": "subscribe",
        "args": [
            "order"
        ]
    }

    Stream Example​

    {
        "type": "snapshot",
        "topic": "order",
        "ts": "1681698833381",
        "data": [
            {
                "e": "order",
                "E": "1681698833381",
                "s": "UNIUSDT",
                "c": "test-error-liangwuuu-02",
                "S": "BUY",
                "o": "MARKET_OF_QUOTE",
                "f": "GTC",
                "q": "15",
                "p": "0",
                "X": "CANCELED",
                "i": "1400585759234258176",
                "M": "0",
                "l": "0",
                "z": "0",
                "L": "0",
                "n": "0",
                "N": "",
                "u": true,
                "w": true,
                "m": false,
                "O": "1681698833313",
                "Z": "0",
                "A": "0",
                "C": false,
                "v": "0",
                "d": "NO_LIQ",
                "sg": 1005,
                "st": "CancelTaker",
                "ct": "CancelBySmp",
                "so": "1400584538658193920",
                "b": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/spot/ws-private/stop-order.html b/spot/ws-private/stop-order.html index 56a6dd7868..af262a08d4 100644 --- a/spot/ws-private/stop-order.html +++ b/spot/ws-private/stop-order.html @@ -4,13 +4,13 @@ Stop Order | Bybit API Documentation - +

    Stop Order

    This topic pushes conditional order, TP/SL order information placed by web/app channel, and TP/SL order information placed by open api channel. It'll be triggered as long as order status is changed

    Push frequency: real-time

    Topic: stopOrder

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > estringEvent type
    > EstringEvent time
    > sstringTrading pair
    > cstringUser-generated order ID
    > SstringBUY: buy order, SELL: sell order
    > ostringOrder type. LIMIT, MARKET_OF_QUOTE(Market Buy), MARKET_OF_BASE(Market Sell)
    > fstringTime in force
    > qstringOrder quantity
    > pstringOrder price
    > XstringOrder status
    > istringOrder ID
    > TstringOrder created timestamp (ms)
    > tstringTP/SL order triggered timestamp (ms). The field has value only when order status is ORDER_FILLED and ORDER_FAILED
    > CstringOrder updated time. It is updated when order status is changed
    > qpstringThe market price when place the order
    > eostringThe new order ID after the TP/SL order is triggered
    > tistringPlease ignore
    > sistringPlease ignore
    > tpstringTrigger price

    Subscribe Example​

    {
        "req_id": "stopOrder_1", //optional
        "op": "subscribe",
        "args": [
            "stopOrder"
        ]
    }

    Stream Example​

    {
        "type": "snapshot",
        "topic": "stopOrder",
        "ts": "1678689442476",
        "data": [
            {
                "e": "stopOrder",
                "E": "1678689442476",
                "s": "XRPUSDT",
                "c": "1678689442086",
                "S": "BUY",
                "o": "LIMIT",
                "f": "GTC",
                "q": "100",
                "p": "0.335",
                "X": "ORDER_NEW",
                "i": "1375341158856660992",
                "T": "1678689442437",
                "t": "0",
                "C": "1678689442437",
                "qp": "0.3666",
                "eo": "1375341158856660993",
                "ti": "209a1cc923e1322315805fea6ed6fcbf",
                "si": "d980d5212ea83c87",
                "tp": "0.33"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/spot/ws-private/wallet.html b/spot/ws-private/wallet.html index 7fad389de1..76f572e6b4 100644 --- a/spot/ws-private/wallet.html +++ b/spot/ws-private/wallet.html @@ -4,13 +4,13 @@ Wallet | Bybit API Documentation - +

    Wallet

    This topic pushes spot wallet information

    Push frequency: real-time

    Topic: outboundAccountInfo

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > estringEvent type
    > EstringTimestamp
    > TbooleanAllow trade
    > WbooleanAllow withdraw
    > DbooleanAllow deposit
    > BarrayWallet balance change
    >> astringcoin name
    >> fstringAvailable balance
    >> lstringReserved for orders

    Subscribe Example​

    {
        "req_id": "acctInfo_1", //optional
        "op": "subscribe",
        "args": [
            "outboundAccountInfo"
        ]
    }

    Stream Example​

    {
        "type": "snapshot",
        "topic": "outboundAccountInfo",
        "ts": "1662107217641",
        "data": [
            {
                "e": "outboundAccountInfo",
                "E": "1662107217640",
                "T": true,
                "W": true,
                "D": true,
                "B": [
                    {
                        "a": "USDT",
                        "f": "176.81254174",
                        "l": "201.575"
                    }
                ]
            }
        ]
    }
    - + \ No newline at end of file diff --git a/spot/ws-public/bookticker.html b/spot/ws-public/bookticker.html index 7642bfe254..f40ba330cc 100644 --- a/spot/ws-public/bookticker.html +++ b/spot/ws-public/bookticker.html @@ -4,13 +4,13 @@ Bookticker | Bybit API Documentation - +

    Bookticker

    Best bid price and best ask price

    Push frequency: 100ms

    Topic: bookticker.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > sstringTrading pair
    > bpstringBest bid price
    > bqstringBid quantity
    > apstringBest ask price
    > aqstringAsk quantity
    > tnumberThe timestamp (ms) that system generates the data

    Subscribe Example​

    {
        "req_id": "bookticker00001", //optional
        "op": "subscribe",
        "args": [
            "bookticker.BTCUSDT"
        ]
    }

    Stream Example​

    {
        "topic": "bookticker.BTCUSDT",
        "ts": 1673437259336,
        "type": "snapshot",
        "data": {
            "s": "BTCUSDT",
            "bp": "17440",
            "bq": "0.0002",
            "ap": "17440.01",
            "aq": "0.21302",
            "t": 1673437259336
        }
    }
    - + \ No newline at end of file diff --git a/spot/ws-public/kline.html b/spot/ws-public/kline.html index 6018a2eb15..c205fba9de 100644 --- a/spot/ws-public/kline.html +++ b/spot/ws-public/kline.html @@ -4,13 +4,13 @@ Kline | Bybit API Documentation - +

    Kline

    Subscribe the kline stream. Please find desired kline interval here.

    Topic: kline.{interval}.{symbol} e.g., kline.30m.BTCUSDT

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > tnumberThe start timestamp (ms) of the bar
    > sstringTrading pair
    > cstringClose price
    > hstringHigh price
    > lstringLow price
    > ostringOpen price
    > vstringTrading volume

    Subscribe Example​

    {
        "req_id": "kline00001", //optional
        "op": "subscribe",
        "args": [
            "kline.30m.BTCUSDT"
        ]
    }

    Stream Example​

    {
        "type": "snapshot",
        "topic": "kline.30m.BTCUSDT",
        "data": {
            "s": "BTCUSDT",
            "t": 1673436600000,
            "o": "17439.16",
            "c": "17437.82",
            "h": "17450.45",
            "l": "17433.5",
            "v": "34.059614"
        },
        "ts": 1673438143609
    }
    - + \ No newline at end of file diff --git a/spot/ws-public/orderbook.html b/spot/ws-public/orderbook.html index 8e491275de..3f706ead4e 100644 --- a/spot/ws-public/orderbook.html +++ b/spot/ws-public/orderbook.html @@ -4,13 +4,13 @@ Orderbook | Bybit API Documentation - +

    Orderbook

    Market depth data for a trading pair:

    • Snapshot depth: 40 each for asks and bids.
    • Events trigger order book version change:
      • order enters order book
      • order leaves order book
      • order quantity changes
      • order filled

    Pushes snapshot data only

    Push frequency: 100ms

    Topic: orderbook.40.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > sstringTrading pair
    > tnumberThe timestamp (ms) that system generates the data.
    > barrayBids. The element is sorted by price in descending order
    >> b[0]stringBid price
    >> b[1]stringBid size
    > aarrayAsks. The element is sorted by price in ascending order
    >> a[0]stringAsk price
    >> a[1]stringAsk size

    Subscribe Example​

    {
        "req_id": "depth00001", //optional
        "op": "subscribe",
        "args": [
            "orderbook.40.BTCUSDT"
        ]
    }

    Stream Example​

    {
        "topic": "orderbook.40.BTCUSDT",
        "ts": 1673439424737,
        "type": "snapshot",
        "data": {
            "s": "BTCUSDT",
            "t": 1673439424737,
            "b": [
                [
                    "17423",
                    "0.809534"
                ],
                [
                    "17422.86",
                    "0.043596"
                ],
                ...
            ],
            "a": [
                ...
                [
                    "17428.28",
                    "0.004811"
                ],
                [
                    "17428.62",
                    "0.23"
                ]
            ]
        }
    }
    - + \ No newline at end of file diff --git a/spot/ws-public/public-trade.html b/spot/ws-public/public-trade.html index b75e82b751..41dabba74a 100644 --- a/spot/ws-public/public-trade.html +++ b/spot/ws-public/public-trade.html @@ -4,13 +4,13 @@ Public trade | Bybit API Documentation - +

    Public trade

    This topic pushes raw trade information; each trade has a unique buyer and seller.

    Variable "v" acts as a tradeId. This variable is shared across different symbols; however, each ID is unique. For example, suppose in the last 5 seconds 3 trades happened in ETHUSDT, BTCUSDT, and BHTBTC. Their tradeId (which is "v") will be consecutive: 112, 113, 114.

    Push frequency: real-time

    Topic: trade.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > vstringTrade ID
    > tnumberTimestamp (trading time in the match box)
    > pstringPrice
    > qstringQuantity
    > mbooleanTrue indicates buy side is taker, false indicates sell side is taker
    > typestringTrade type. 0：Spot trade. 1：Paradigm block trade

    Subscribe Example​

    {
        "req_id": "trade0001", //optional
        "op": "subscribe",
        "args": [
            "trade.BTCUSDT"
        ]
    }

    Stream Example​

    {
        "topic": "trade.BTCUSDT",
        "ts": 1673437259397,
        "type": "snapshot",
        "data": {
            "v": "2290000000036455162",
            "t": 1673437259395,
            "p": "17440",
            "q": "0.0002",
            "m": false,
            "type": "0"
        }
    }
    - + \ No newline at end of file diff --git a/spot/ws-public/ticker.html b/spot/ws-public/ticker.html index 347a9782f1..6cbe3ef829 100644 --- a/spot/ws-public/ticker.html +++ b/spot/ws-public/ticker.html @@ -4,13 +4,13 @@ Tickers | Bybit API Documentation - +

    Tickers

    The 24-hr statistics of a trading pair.

    Push frequency: real-time

    Topic: tickers.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    tsnumberThe timestamp (ms) that message is sent out
    typestringData type. snapshot
    dataarrayObject
    > tlongTimestamp (trading time in the match box)
    > sstringTrading pair
    > ostringOpen price
    > hstringHigh price
    > lstringLow price
    > cstringClose price
    > vstringTrading volume
    > qvstringTrading quote volume
    > mstringChange
    > xpstringUSD index price. It can be empty

    Request Example​

    {
        "req_id": "ticker00001", //optional
        "op": "subscribe",
        "args": [
            "tickers.BTCUSDT"
        ]
    }

    Response Example​

    {
        "topic": "tickers.BTCUSDT",
        "ts": 1673853966002,
        "type": "snapshot",
        "data": {
            "t": 1673853957769,
            "s": "BTCUSDT",
            "c": "21097.53",
            "h": "21426.99",
            "l": "20575",
            "o": "20705.31",
            "v": "6786.96571",
            "qv": "142076886.7193882",
            "m": "0.0189",
            "xp": "21109.48012482"
        }
    }
    - + \ No newline at end of file diff --git a/spot/ws/connect.html b/spot/ws/connect.html index 6922a33de9..bbc52b3999 100644 --- a/spot/ws/connect.html +++ b/spot/ws/connect.html @@ -4,13 +4,13 @@ Connect | Bybit API Documentation - +

    Connect

    info

    Note that the following endpoints only apply to Spot. To listen to other websockets, go to:

    Base endpoints:

    • Testnet:
      • Public Topics: wss://stream-testnet.bybit.com/spot/public/v3
      • Private Topics: wss://stream-testnet.bybit.com/spot/private/v3
    • Mainnet:
      • Public Topics: wss://stream.bybit.com/spot/public/v3
      • Private Topics: wss://stream.bybit.com/spot/private/v3
    info
    Public topics do not require authentication. The following section applies to private topics only.

    Apply for authentication when establishing a connection.

    Note: if you're using pybit, bybit-api or another high-level library, you can ignore this code - as authentication is handled for you.

    {
        "req_id": "10001", // optional
        "op": "auth",
        "args": [
            "api_key",
            1662350400000, //expires; is greater than your current timestamp
            "singature"
        ]
    }
    # based on: https://github.com/bybit-exchange/pybit/blob/master/pybit/_http_manager.py

    import hmac
    import json
    import time
    import websocket

    api_key = ""
    api_secret = ""

    # Generate expires.
    expires = int((time.time() + 1) * 1000)

    # Generate signature.
    signature = str(hmac.new(
        bytes(api_secret, "utf-8"),
        bytes(f"GET/realtime{expires}", "utf-8"), digestmod="sha256"
    ).hexdigest())

    ws = websocket.WebSocketApp(
        url=url,
        ...
    )

    # Authenticate with API.
    ws.send(
        json.dumps({
            "op": "auth",
            "args": [api_key, expires, signature]
        })
    )
    info

    Example signature algorithms can be found here.

    caution

    Due to network complexity, your may get disconnected at any time. Please follow the instructions below to ensure that you receive WebSocket messages on time:

    1. Keep connection alive by sending heartbeat packet
    2. Reconnect as soon as possible if disconnected

    How to Send Heartbeat Packet​

    How to Send

    // req_id is a customised id, which is optional
    ws.send(JSON.stringify({"req_id": "100001", "op": "ping"}));

    The response sample of Pong

    // with req_id
    {"op":"pong","args":[1661741630642],"req_id":"100001","conn_id":"706b870c"}

    // without req_id
    {"op":"pong","args":[1661741654529],"conn_id":"706b870c"}
    caution

    To avoid networks or program issues, we recommend that you send the ping heartbeat packet every 20 seconds to maintain the WebSocket connection.

    IP Limits​

    • Do not frequently connect and disconnect the connection.
    • Do not build over 500 connections in 5 minutes. This is counted separately per WebSocket endpoint.

    Rate Limits​

    Private channel only:

    • Each API key may have a maximum of 100 private WebSocket connections. The 101st connection will be rejected.
    • An IP can connect to a maximum of 50 private spot websocket connections simultaneously.

    How to Subscribe to Topics​

    Understanding Websocket Filters​

    How to subscribe with a filter

    // Subscribing to the trade data for BTCUSDT
    {
        "req_id": "10001", // optional
        "op": "subscribe",
        "args": [
            "trade.BTCUSDT"
        ]
    }

    support many symbol, separate with ','.

    // Example: Subscribing to the trade data for BTCUSDT and ETHUSDT
    {
        "req_id": "10001", // optional
        "op": "subscribe",
        "args": [
            "trade.BTCUSDT",
            "trade.ETHUSDT"
        ]
    }

    After establishing the connection, you can subscribe to a new topic by sending a JSON request. The request formats are as follows:

    ws.send('{"req_id": "10001", "op": "subscribe", "args": ["trade.BTCUSDT", "trade.ETHUSDT", "tickers.BTCUSDT", "bookticker.BTCUSDT"]}')
    tip

    You can input up to 10 args for each subscription request sent to one connection

    Understanding Websocket Filters unsubscription​

    After successful subscription, you can unsubscribe by sending a JSON request. The request formats are as follows:

    ws.send('{"req_id": "10002", "op": "unsubscribe", "args": ["trade.BTCUSDT"]}');
    // Example: unsubscribing to the trade data for BTCUSDT and ETHUSDT
    {
        "req_id": "10002", // optional
        "op": "unsubscribe",
        "args": [
            "trade.BTCUSDT",
            "trade.ETHUSDT"
        ]
    }
    // unsubscribe response sample
    {
        "op": "unsubscribe",
        "success": true,
        "req_id": "10002",
        "ret_msg": "unsubscribe",
        "conn_id": "46f097b7"
    }

    Understanding Subscription Response​

    Subscription Response

    {
        "op": "subscribe",
        "success": true,
        "req_id": "10001",
        "ret_msg": "subscribe",
        "conn_id": "46f097b7"
    }

    Once you subscribe successfully, you'd receive result information. You can determine whether the subscription is successful based on the response.

    - + \ No newline at end of file diff --git a/tax/data-export.html b/tax/data-export.html index 74235b7be9..a36114faa7 100644 --- a/tax/data-export.html +++ b/tax/data-export.html @@ -4,13 +4,13 @@ Retrieve Data Export | Bybit API Documentation - +

    Retrieve Data Export

    Retrieve data export

    HTTP Request​

    POST /fht/compliance/tax/v3/private/url

    Request Parameters​

    ParameterRequiredTypeComments
    queryIdtruestringReport Request ID

    Response Parameters​

    ParameterTypeComments
    urlstringURL of files (Basepath + Files). To shorten the time it takes to generate the report, it could generate multiple files. Do take note of this and combine the several files using the same base path when requesting the data export
    info

    Convert S3 Files To CSV using python script

    Sample Python Script​


    import pandas as pd
    import os

    class Bases(object):
        @staticmethod
        def path_list(path):
            """
            :param path:
            :return: list of file paths
            """
            file_list = []
            if os.path.isdir(path):
                print("it's a directory")
                for root, dirs, files in os.walk(path):
                    for f in files:
                        file = os.path.join(root, f)
                        file_list.append(file)
                return file_list
            elif os.path.isfile(path):
                print("it's a normal file")
                return [path]

    class pd_service(Bases):
        def get_data(self, file_path):
            """
            Read s3 files, merge forms
            :param file_path:
            :return:
            """
            df_all = pd.DataFrame()
            for paths in self.path_list(path=file_path):
                df_all = pd.concat([df_all, pd.read_orc(paths)], axis=0)
            print('Row number of tables：', df_all[df_all.columns[1]].count())
            print(df_all.columns.values)
            df_all.sort_values("TradeTime", inplace=True)
            df_all.to_csv("test_data_s3.csv", header=True, index=False)
            print(df_all)
            return df_all

    if __name__ == '__main__':
        # file path
        path = 'XXXX'
        test = pd_service()
        test.get_data(file_path=path)

    Request Example​

    POST /fht/compliance/tax/v3/private/url HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: xxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671184057480
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {"queryId":"12312312415325325"}

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "url": "{\"Files\":[\"20221216/adfsf34234-8e87-4c72-bc70-dsa234234daf/_SUCCESS\",\"20221216/dafasdf34243-8e87-4c72-bc70-dafsd34234/part-00000-adfsd34-00bd-4fe9-9591-adfasr343-c000\"],\"Basepath\":\"https://prod-bybit-tax-api-1705-rz.s3.ap-southeast-1.amazonaws.com/\"}"
        },
        "retExtInfo": {},
        "time": 1671184057646
    }
    - + \ No newline at end of file diff --git a/tax/enum.html b/tax/enum.html index 67e12ecd19..20f14499b0 100644 --- a/tax/enum.html +++ b/tax/enum.html @@ -4,13 +4,13 @@ Enums Definitions | Bybit API Documentation - +

    Enums Definitions

    ReportType​

    • TRADE - TradeHistory
    • P&L - P&L History
    • EARN - Earn History
    • DEPOSIT&WITHDRAWAL - Deposit and Withdrawal History
    • BONUS - Bonus History
    • AIRDROP - Airdrop History

    ReportNumber​

    ReportType = "TRADE"

    • 1 - Get Spot Trade History
    • 2 - Get Contract Trade History
    • 3 - Get USDC Options Trade History
    • 4 - Get NFT Trade History

    ReportType = "P&L"

    • 1 - Get Contract Closed P&L History

    ReportType = "EARN"

    • 1 - Get BybitSavings Yield History
    • 2 - Get LiquidityMining Liquidity History
    • 3 - Get LiquidityMining Yield History
    • 4 - Get LiquidityMining Swap History
    • 5 - Get DualAsset Swap History
    • 6 - Get DeFiMining Yield History
    • 7 - Get Launchpool Yield History
    • 8 - Get Sharkfin Yield History

    ReportType = "DEPOSIT&WITHDRAWAL"

    • 1 - Get Crypto Deposit History
    • 2 - Get P2P Deposit History
    • 3 - Get Fiat Deposit and Withdraw History
    • 4 - Get Express Order Deposit History
    • 5 - Get Third Party Deposit History
    • 6 - Get Crypto Withdraw History
    • 7 - Get NFT Deposit and Withdrawal History

    ReportType = "BONUS"

    • 1 - Get Coupon History
    • 2 - Get Bonus History

    ReportType = "AIRDROP"

    • 1 - Get Airdrop History
    - + \ No newline at end of file diff --git a/tax/explain.html b/tax/explain.html index 80411dca9a..e163e1f9ba 100644 --- a/tax/explain.html +++ b/tax/explain.html @@ -4,13 +4,13 @@ Data Explanation | Bybit API Documentation - +

    Data Explanation

    Trade History​

    1. Spot Trade History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID of the closing order
    TradeIDstringTrade ID of the closing order
    SymbolstringName of the trading pair in the form of
    SidestringSide. Either Buy or Sell direction
    QuoteCoinstringSymbol of the Quote Coin
    BaseCoinstringSymbol of the Executed Coin
    ExecPricestringExecution Price
    ExecValuestringTransacted volume
    TradingFeestringTrading fee for a single fill
    FeeTokenstringToken of the Trading Fee
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed

    2. Contract Trade History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID of the closing order.
    TradeIDstringTrade ID of the closing order.
    ContractTypestringTypes of Contract. Inverse Contracts, Linear Contracts, Future Contracts
    SymbolstringName of the trading pair in the form of
    SidestringSide. Either Buy or Sell direction
    QuoteCoinstringSymbol of the Quote Coin
    BaseCoinstringSymbol of the Executed Coin
    ExecPricestringExecution Price
    ExecQtystringTransaction Quantity
    ExecTypestringExecution Types. Trade, ADL, BustTrade
    ExecValuestringTransacted volume
    FeeRatestringRates for Maker or taker fee
    FeeTokenstringToken of the Trading Fee
    TradingFeestringTrading fee for a single fill
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed
    ClosedSizestringClosed postion size
    OrderTypestringOrder type

    3. USDC Options Trade History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID of the closing order.
    TradeIDstringTrade ID of the closing order.
    ContractTypestringTypes of Contract. Inverse Contracts, Linear Contracts, Future Contracts
    SymbolstringName of the trading pair in the form of
    SidestringSide. Either Buy or Sell direction
    QuoteCoinstringSymbol of the Quote Coin
    BaseCoinstringSymbol of the Executed Coin
    ExecPricestringExecution Price
    ExecQtystringTransaction Quantity
    ExecTypestringExecution Types. Trade, ADL, BustTrade
    ExecValuestringTransacted volume
    FeeRatestringRates for Maker or taker fee
    FeeTokenstringToken of the Trading Fee
    TradingFeestringTrading fee for a single fill
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed

    4. NFT Trade History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID of the closing order.
    NetworkstringName of Network.
    SidestringSide. Either Buy or Sell direction
    NftIdstringID of the NFT collection
    ExecValuestringTransacted volume
    BaseCoinstringSymbol of the Executed Coin
    PlatformFeestringFees for Platform, Fee is as per Base coin
    ShareFeestringFees for Sharing, Fee is as per Base coin
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed

    P&L History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID of the closing order.
    ContractTypestringTypes of Contract. Inverse Contracts, Linear Contracts, Future Contracts
    SymbolstringName of the trading pair in the form of
    SidestringSide. Either Buy or Sell direction
    ClosedSizestringClosed Size
    CumEntryValuestringCumulative entry value
    AvgEntryPricestringAverage entry price
    CumExitValuestringCumulative exit value
    AvgExitPricestringAverage exit price
    SettleCoinstringSettle Coin. Coin for Profit and Loss
    ClosedPNLstringClosed Profit and Loss
    FillCountstringThe number of fills in a single order
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed

    Earn History​

    1. BybitSavings Yield History​

    Response Parameters​

    ParameterTypeComments
    AssetStakedCoinstringCoin that was used to staked in the Bybit Savings Product
    StakingTypestringType of Staking. Flexible and Fixed Term
    AssetEarnedCoinstringCoin that the Interest is given out in
    EffectiveStakingAmountstringTotal amount staked with the Asset Staked coin
    YieldstringAmount of the Interest coin that was given out based on
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed

    2. LiquidityMining Liquidity History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID of the closing order.
    SymbolstringName of the trading pair in the form of
    OrderTypestringIncludes the different types of liquidity mining. Add, Remove, Reduce Leverage, Reinvest
    EntryPricestringEntry price of principal coin pair at time of order
    LeveragestringLeverage Multiples
    SlippagestringDifference between price of an order and the price when the order actually executes
    LiquiditystringLiquidity = Principal Change multiplied by Leverage
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed

    3. LiquidityMining Yield History​

    Response Parameters​

    ParameterTypeComments
    AssetEarnedCoinstringCoin that the Interest is given out in
    YieldstringAmount of the Interest coin that was given out based on
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed

    4. LiquidityMining Swap History​

    Response Parameters​

    ParameterTypeComments
    OrderIdstringtranslation missing: en.taxOrderID
    InitialCoinstringThe coin in the pair that you are trying to swap from.
    DepositAmountstringQuantity of the selected coin in the pair that you are trying to swap from
    SwapCoinstringThe coin in the pair that you are trying to swap into.
    SwapAmountstringQuantity of the selected coin in the pair that you are trying to swap to
    SwapFeeTokenstringFee will be in the swap coin.
    SwapFeestringFee incurred after the swap was successfully performed. Fee will be in the swap coin
    SlippagestringDifference between price of an order and the price when the order actually executes
    TradeTimestringUNIX Time. This is in milliseconds. Time when the trade was executed

    5. DualAsset Swap History​

    Response Parameters​

    ParameterTypeComments
    OrderIdstringOrder ID
    InitialCoinstringThe coin in the pair that you are trying to swap from.
    DepositAmountstringQuantity of the selected coin in the pair that you are trying to swap from
    SwapCoinstringThe coin in the pair that you are trying to swap into.
    SwapAmountstringQuantity of the selected coin in the pair that you are trying to swap to
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    TradeTimenumberUNIX Time. This is in milliseconds. Time when the trade was executed

    6. DeFiMining Yield History​

    Response Parameters​

    ParameterTypeComments
    OrderIdstringtranslation missing: en.taxOrderID
    AssetStakedCoinstringCoin that was used to staked in the Bybit Savings Product
    YieldstringAmount of the Interest coin that was given out based on
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    TradeTimenumberUNIX Time. This is in milliseconds. Time when the trade was executed

    7. Launchpool Yield History​

    Response Parameters​

    ParameterTypeComments
    AssetEarnedCoinstringCoin that the Interest is given out in
    EffectiveStakingAmountstringTotal amount staked with the Asset Staked coin
    YieldstringAmount of the Interest coin that was given out based on
    TradeTimenumberUNIX Time. This is in milliseconds. Time when the trade was executed

    8. Sharkfin Yield History​

    Response Parameters​

    ParameterTypeComments
    AssetEarnedCoinstringCoin that the Interest is given out in
    YieldstringAmount of the Interest coin that was given out based on
    TradeTimenumberUNIX Time. This is in milliseconds. Time when the trade was executed

    Deposit And Withdraw History​

    1. Crypto Deposit History​

    Response Parameters​

    ParameterTypeComments
    TxidstringTransactionID
    DepositTypestringType of Deposit. On-chain Deposit
    ChainTypestringChain name
    SymbolstringName of the trading pair in the form of
    FinalAmountstringQuantity of Crypto
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    CompletedTimenumberComplete timestamp (ms)

    2. P2P Deposit History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID
    OrderTypestringIncludes the different types of liquidity mining. Add, Remove, Reduce Leverage, Reinvest
    P2pSidestringFor P2P Buyer, this represents the buyer bought the respective Coin and using Fiat currency. For P2P Seller, this represents the buyer sold the respective Coin and receive Fiat currency in return.
    FiatstringFiat type
    FiatAmountstringFiat deposited
    CoinstringSymbol of coin purchased
    CoinPricestringPrice of coin purchased
    CoinAmountstringQuantity of coin that is purchased
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    CompletedTimenumberComplete timestamp (ms)

    3. Fiat Deposit and Withdraw History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID
    TypestringType. DEPOSIT, WITHDRAW
    FiatstringFiat type
    DepositAmountstringQuantity of the selected coin in the pair that you are trying to swap from
    FinalAmountstringQuantity of Crypto
    FeestringFee for Fiat Deposit
    PaymentMethodsstringDifferent payment methods
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    CompletedTimenumberComplete timestamp (ms)

    4. Express Order Deposit History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID
    SidestringType of Order. Buy
    FiatstringFiat type
    DepositAmountstringFiat deposited via Credit card.
    DestinationCoinstringSymbol of coin purchased
    CoinPricestringPrice of coin purchased
    FinalAmountstringQuantity of Crypto
    FeestringAny fees in fiat involved when depositing via Credit card
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    CompletedTimenumberComplete timestamp (ms)

    5. Third Party Deposit History​

    Response Parameters​

    ParameterTypeComments
    OrderIDstringOrder ID
    TxidstringTransactionID
    PlatformstringPayment Platform methods
    FiatstringFiat type
    DepositAmountstringQuantity of the selected coin in the pair that you are trying to swap from
    DestinationCoinstringSymbol of coin purchased
    CoinPricestringPrice of coin purchased
    FinalAmountstringQuantity of Crypto
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    CompletedTimenumberComplete timestamp (ms)

    6. Crypto Withdraw History​

    Response Parameters​

    ParameterTypeComments
    TxidstringTransactionID
    ChainTypestringChain name
    CoinstringSymbol of coin purchased
    FinalAmountstringQuantity of Crypto
    FeestringWithdrawal fee as per the withdrawal coin
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    CompletedTimenumberComplete timestamp (ms)

    7. NFT Deposit and Withdrawal History​

    Response Parameters​

    ParameterTypeComments
    OrderIdstringtranslation missing: en.taxOrderID
    TxHashstringUnique IDs recording each NFT transaction
    TokenIdstringAll NFTs have a uint256 variable that identifies different NFT
    TransferTypestringType. Deposit, Withdrawal
    NetworkstringName of Network.
    FeeTokenstringToken of the Trading Fee
    FeestringAny fee incurred using the transaction of the NFT
    OrderTimenumberUNIX Time. This is in milliseconds. Time which the order was ordered
    CompletedTimenumberComplete timestamp (ms)

    Bonus History​

    tip
  • Bonus - The experience bonus can be used to open a position and deduct the handling fee and the funding rate fee because it is paid directly to the user's asset account. All bonuses shown are already applied by the users.
  • Coupon - Money from coupons are deductible will only be used to offset the handling fee. It will not be added to the user's asset account. It will be refunded to the user's asset account following the deduction. All coupons shown are already applied by the users.

    • 1. Coupon History​

    Response Parameters​

    ParameterTypeComments
    CoinstringCoin that is given to user as coupon
    FinalAmountstringAmount of the coin given to user
    CompletedTimenumberComplete timestamp (ms)

    2. Bonus History​

    Response Parameters​

    ParameterTypeComments
    CoinstringCoin that is given to user as coupon
    FinalAmountstringAmount of the coin given to user
    CompletedTimenumberComplete timestamp (ms)

    Airdrop History​

    Response Parameters​

    ParameterTypeComments
    CoinstringCoin that is airdropped to user
    FinalAmountstringAmount of the airdrop given to user
    TransferTypestringType of Airdrop. Airdrop Deposit, Airdrop Withdrawal
    TransferDescriptionstringDescription of the Transfer
    CompletedTimenumberComplete timestamp (ms)
    - + \ No newline at end of file diff --git a/tax/report.html b/tax/report.html index f7c80fad3f..7401bd8a85 100644 --- a/tax/report.html +++ b/tax/report.html @@ -4,13 +4,13 @@ Request Export Report | Bybit API Documentation - +

    Request Export Report

    Request to export report

    HTTP Request​

    POST /fht/compliance/tax/v3/private/create

    Request Parameters​

    ParameterRequiredTypeComments
    typetruestringReport Type
    numbertruestringReport Number
    startTimetruestringUNIX Time. This is in seconds. Timestamp for report start time. The StartTime is included in the Time range for the Data Export.
    endTimetruestringUNIX Time. This is in seconds. Timestamp for report end time. The EndTime is not included in the Time range for the Data Export. Do note that for each request, we will only allow up to 2 months time range search from the StartTime

    Response Parameters​

    ParameterTypeComments
    queryIdstringReport Request ID

    Request Example​

    POST /fht/compliance/tax/v3/private/create HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: xxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671183681683
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {"startTime":"1667264621","endTime":"1669261057","type":"TRADE","number":"2"}

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "queryId": "12312312415325325"
        },
        "retExtInfo": {},
        "time": 1671183681990
    }
    - + \ No newline at end of file diff --git a/tax/status.html b/tax/status.html index 51947d261d..f7176fb123 100644 --- a/tax/status.html +++ b/tax/status.html @@ -4,13 +4,13 @@ Get Export Report Status | Bybit API Documentation - +

    Get Export Report Status

    Get Export Report Status

    HTTP Request​

    POST /fht/compliance/tax/v3/private/status

    Request Parameters​

    ParameterRequiredTypeComments
    queryIdtruestringReport Request ID

    Response Parameters​

    ParameterTypeComments
    statusstring
    • -1: Failed
    • 0: Queued
    • 1: Processing
    • 2: Processed
    • 3: Expired

    Request Example​

    POST /fht/compliance/tax/v3/private/status HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: xxxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671183923110
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {"queryId":"12312312415325325"}

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "status": "2"
        },
        "retExtInfo": {},
        "time": 1671183923244
    }
    - + \ No newline at end of file diff --git a/tax/time.html b/tax/time.html index b70d2dccc2..70f9d7135f 100644 --- a/tax/time.html +++ b/tax/time.html @@ -4,13 +4,13 @@ Get User Register Date | Bybit API Documentation - +

    Get User Register Date

    Get User Register Date

    HTTP Request​

    POST /fht/compliance/tax/v3/private/registertime

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    registerTimestringUNIX Time. This is in seconds. Date that the specific user registers on the platform

    Request Example​

    POST /fht/compliance/tax/v3/private/registertime HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: xxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671183584043
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {}

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "registerTime": "1634515200"
        },
        "retExtInfo": {},
        "time": 1671183584270
    }
    - + \ No newline at end of file diff --git a/v3/intro.html b/v3/intro.html index f48781e7df..734078cb03 100644 --- a/v3/intro.html +++ b/v3/intro.html @@ -4,7 +4,7 @@ Introduction | Bybit API Documentation - + @@ -15,7 +15,7 @@ server_time - recv_window <= timestamp < server_time + 1000
    server_time stands for Bybit server time, which can be queried via the Server Time endpoint.

    Create A Request​

    tip

    To assist in diagnosing advanced network problems, you may consider adding cdn-request-id to your request headers. Its value should be unique for each request.

    info

    Example signature algorithms can be found here

    Basic steps:

    1. timestamp + api-key + (recv_window) + (queryString | jsonBodyString)
    2. Use the HMAC_SHA256 or RSA_SHA256 algorithm to sign the string in step 1, and convert it to a hex string (HMAC_SHA256) / base64 (RSA_SHA256) to obtain the sign parameter.
    3. Append the sign parameter to request header, and send the HTTP request. Note: the plain text for GET and POST requests is different. Please refer to blew examples.

    An example for how to generate plain text to encrypt

    # rule:
    timestamp+api_key+recv_window+queryString

    # param_str
    "1658384314791XXXXXXXXXX5000category=option&symbol=BTC-29JUL22-25000-C"

    # parse
    timestamp = "1658384314791"
    api_key = "XXXXXXXXXX"
    recv_window = "5000"
    queryString = "category=option&symbol=BTC-29JUL22-25000-C"

    http request examples

    GET /unified/v3/private/order/list?category=option&symbol=BTC-29JUL22-25000-C HTTP/1.1
    Host: api-testnet.bybit.com
    -H 'X-BAPI-SIGN: XXXXXXXXXX' \
    -H 'X-BAPI-API-KEY: XXXXXXXXXX' \
    -H 'X-BAPI-TIMESTAMP: 1658384431891' \
    -H 'X-BAPI-RECV-WINDOW: 5000'
    -H 'cdn-request-id: test-001'

    Common response parameters​

    Derivatives​

    ParameterTypeComments
    retCodenumberSuccess/Error code
    retMsgstringSuccess/Error msg. Can be OK,success,Success for Success message
    resultObjectBusiness data result
    retExtInfoObjectExtend info. Most of time, it is {}
    timenumberCurrent timestamp (ms)
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017382656
    }

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017473888
    }

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017572923
    }

    Spot​

    ParameterTypeComments
    retCodenumberSuccess/Error code
    retMsgstringSuccess/Error msg. Can be OK,success,Success for Success message
    resultObjectBusiness data result
    retExtInfoObjectExtend info. Most of time, it is {}
    timenumberCurrent timestamp (ms)
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017382656
    }

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017473888
    }

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017572923
    }

    Account Asset​

    ParameterTypeComments
    retCodenumberSuccess/Error code
    retMsgstringSuccess/Error msg. Can be OK,success,Success for Success message
    resultObjectBusiness data result
    retExtInfoObjectExtend info. Most of time, it is {}
    timenumberCurrent timestamp (ms)
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017382656
    }

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017473888
    }

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017572923
    }
    - + \ No newline at end of file diff --git a/v3/server-time.html b/v3/server-time.html index ed34ebc7fc..1cb44f7d05 100644 --- a/v3/server-time.html +++ b/v3/server-time.html @@ -4,13 +4,13 @@ Bybit Server Time | Bybit API Documentation - +

    Bybit Server Time

    Get the Bybit server timestamp

    HTTP Request​

    GET /v3/public/time

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    timeSecondstringBybit server timestamp (sec)
    timeNanostringBybit server timestamp (nano)

    Request Example​

    curl https://api-testnet.bybit.com/v3/public/time

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "timeSecond": "1674026082",
            "timeNano": "1674026082947745743"
        },
        "retExtInfo": {},
        "time": 1674026082947
    }
    - + \ No newline at end of file diff --git a/v3/smp.html b/v3/smp.html index 31478b0d2c..b150ec7098 100644 --- a/v3/smp.html +++ b/v3/smp.html @@ -4,7 +4,7 @@ Self Match Prevention | Bybit API Documentation - + @@ -19,7 +19,7 @@ the pre-existing orders to avoid the unexpected execution.

    1. SMP Trade Group has a higher priority on SMP execution, and UID will only take effect when there is no group on any side.

    Examples:
    1st of Jan: UID1 joined SMP Trade Group A, and placed Order1;
    2nd of Jan: UID1 was removed from SMP Trade Group A, but Order1 is still active and "New"

    • case1: If UID1 joined SMP Trade Group B, and placed Order2, if Order2 meets Order1, it will be executed since they belong to two different groups.
    • case2: If UID1 did not join any other groups after being removed from SMP Trade Group A, and placed Order2, if Order2 meets Order1, the SMP will be triggered because UID1 did not have a group when placed Order2, so SMP was triggered at the UID level (the same UID1).

    How to manage my UIDs & SMP Trade Group?​

    You can contact your institutional business manager or email Bybit via: institutional_services@bybit.com

    Supported OpenAPI Versions and Product Lines​

    Product linesOpenAPI version supportedComments
    SpotV3 (normal account)
    V5 (unified & normal account)
    ContractContract V3 (normal account): USDT perpetual / Inverse perpetual & futures
    V5 (unified account): USDT perpetual / Inverse perpetual & futures / USDC perpetual & futures
    V5 (normal account): USDT perpetual / Inverse perpetual & futures
    OptionV5 (unified account)V1 has a default SMP at UID level
    - + \ No newline at end of file diff --git a/v5/abandon/account-info.html b/v5/abandon/account-info.html index 6424866976..3b129299bd 100644 --- a/v5/abandon/account-info.html +++ b/v5/abandon/account-info.html @@ -4,13 +4,13 @@ Get Lending Account Info | Bybit API Documentation - +

    Get Lending Account Info

    HTTP Request​

    GET /v5/lending/account

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name

    Response Parameters​

    ParameterTypeComments
    coinstringCoin name
    principalIntereststringUser Redeemable interest
    principalQtystringLeftover quantity you can redeem for today (measured from 0 - 24 UTC), formula: min(the rest amount of principle, the amount that the user can redeem on the day)
    principalTotalstringTotal amount redeemable by user
    quantitystringCurrent deposit quantity

    Request Example​

    GET /v5/lending/account?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682049556563
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "coin": "BTC",
            "principalInterest": "0",
            "principalQty": "1",
            "principalTotal": "1",
            "quantity": "1"
        },
        "retExtInfo": {},
        "time": 1682049706988
    }
    - + \ No newline at end of file diff --git a/v5/abandon/cancel-redeem.html b/v5/abandon/cancel-redeem.html index a11d90d512..e013588bb1 100644 --- a/v5/abandon/cancel-redeem.html +++ b/v5/abandon/cancel-redeem.html @@ -4,13 +4,13 @@ Cancel Redeem | Bybit API Documentation - +

    Cancel Redeem

    Cancel the withdrawal operation.

    HTTP Request​

    POST /v5/lending/redeem-cancel

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin name
    orderIdfalsestringThe order ID of redemption
    serialNofalsestringSerial no. The customised ID of redemption

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    serialNostringSerial No
    updatedTimestringUpdated timestamp (ms)

    Request Example​

    POST /v5/lending/redeem-cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682048277724
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "coin": "BTC",
        "orderId": "1403517113428086272",
        "serialNo": null
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1403517113428086272",
            "serialNo": "linear004",
            "updatedTime": "1682048277963"
        },
        "retExtInfo": {},
        "time": 1682048278001
    }
    - + \ No newline at end of file diff --git a/v5/abandon/coin-info.html b/v5/abandon/coin-info.html index 6f3bf2eda4..0832fe0461 100644 --- a/v5/abandon/coin-info.html +++ b/v5/abandon/coin-info.html @@ -4,13 +4,13 @@ Get Lending Coin Info | Bybit API Documentation - +

    Get Lending Coin Info

    Get the basic information of lending coins

    info

    All v5/lending APIs need SPOT permission.

    HTTP Request​

    GET /v5/lending/info

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin name. Return all currencies by default

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > coinstringCoin name
    > maxRedeemQtystringThe maximum redeemable qty per day (measured from 0 - 24 UTC)
    > minPurchaseQtystringThe minimum qty that can be deposited per request
    > precisionstringDeposit quantity accuracy
    > ratestringAnnualized interest rate. e.g. 0.0002 means 0.02%
    > loanToPoolRatiostringCapital utilization rate. e.g. 0.0004 means 0.04%
    > actualApystringThe actual annualized interest rate

    Request Example​

    GET /v5/lending/info?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682045949295
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "actualApy": "0.003688421873941958",
                    "coin": "ETH",
                    "loanToPoolRatio": "0.16855491872747133044",
                    "maxRedeemQty": "161",
                    "minPurchaseQty": "0.03",
                    "precision": "8",
                    "rate": "0.003411300771389848"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1682045942972
    }
    - + \ No newline at end of file diff --git a/v5/abandon/deposit.html b/v5/abandon/deposit.html index cd9f012439..8b2095d923 100644 --- a/v5/abandon/deposit.html +++ b/v5/abandon/deposit.html @@ -4,13 +4,13 @@ Deposit Funds | Bybit API Documentation - +

    Deposit Funds

    Lending funds to Bybit asset pool

    info
    • normal & UMA account: deduct funds from Spot wallet
    • UTA account: deduct funds from Unified wallet

    HTTP Request​

    POST /v5/lending/purchase

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name
    quantitytruestringDeposit quantity
    serialNofalsestringCustomised ID. If not passed, system will create one by default

    Response Parameters​

    ParameterTypeComments
    coinstringCoin name
    createdTimestringCreated timestamp (ms)
    orderIdstringOrder ID
    quantitystringDeposit quantity
    serialNostringSerial No
    statusstringOrder status. 0: Initial, 1: Processing, 2: Success, 10: Failed
    updatedTimestringUpdated timestamp (ms)

    Request Example​

    POST /v5/lending/purchase HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682046368938
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "coin": "USDC",
        "quantity": "20.00005",
        "serialNo": "test-00007"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "coin": "USDC",
            "createdTime": "1682046369112",
            "orderId": "1403501100816928256",
            "quantity": "20.00005",
            "serialNo": "test-00007",
            "status": "0",
            "updatedTime": "1682046369112"
        },
        "retExtInfo": {},
        "time": 1682046369120
    }
    - + \ No newline at end of file diff --git a/v5/abandon/earning.html b/v5/abandon/earning.html index 9739b5b170..1d73bfc2ce 100644 --- a/v5/abandon/earning.html +++ b/v5/abandon/earning.html @@ -4,13 +4,13 @@ Get Broker Earning | Bybit API Documentation - +

    Get Broker Earning

    danger

    This endpoint has been depreciated, please move to new Get Exchange Broker Earning

    info
    • Use exchange broker master account to query
    • The data can support up to past 6 months until T-1
    • startTime & endTime are either entered at the same time or not entered

    HTTP Request​

    GET /v5/broker/earning-record

    Request Parameters​

    ParameterRequiredTypeComments
    bizTypefalsestringBusiness type. SPOT, DERIVATIVES, OPTIONS
    startTimefalseintegerThe start timestamp(ms)
    endTimefalseintegerThe end timestamp(ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 1000
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > userIdstringUID
    > bizTypestringBusiness type
    > symbolstringSymbol name
    > coinstringCoin name. The currency of earning
    > earningstringCommission
    > orderIdstringOrder ID
    > execTimestringExecution timestamp (ms)
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/broker/earning-record?bizType=SPOT&startTime=1686240000000&endTime=1686326400000&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686708862669
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "userId": "xxxx",
                    "bizType": "SPOT",
                    "symbol": "BTCUSDT",
                    "coin": "BTC",
                    "earning": "0.000015",
                    "orderId": "1531607271849858304",
                    "execTime": "1686306035957"
                }
            ],
            "nextPageCursor": "0%2C1"
        },
        "retExtInfo": {},
        "time": 1686708863283
    }
    - + \ No newline at end of file diff --git a/v5/abandon/enable-unitransfer-subuid.html b/v5/abandon/enable-unitransfer-subuid.html index 1c2f723a2d..db1bc5ed2a 100644 --- a/v5/abandon/enable-unitransfer-subuid.html +++ b/v5/abandon/enable-unitransfer-subuid.html @@ -4,13 +4,13 @@ Enable Universal Transfer for Sub UID | Bybit API Documentation - +

    Enable Universal Transfer for Sub UID

    info

    You no longer need to configure transferable sub UIDs. Now, all sub UIDs are automatically enabled for universal transfer.

    Transfer between sub-sub or main-sub

    Use this endpoint to enable a subaccount to take part in a universal transfer. It is a one-time switch which, once thrown, enables a subaccount permanently. If not set, your subaccount cannot use universal transfers.

    caution

    Can query by the master UID's api key only

    HTTP Request​

    POST /v5/asset/transfer/save-transfer-sub-member

    Request Parameters​

    ParameterRequiredTypeComments
    subMemberIdstruearrayThis list has a single item. Separate multiple UIDs by comma, e.g., "uid1,uid2,uid3"

    Response Parameters​

    None

    Request Example​

    POST /v5/asset/transfer/save-transfer-sub-member HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672147595971
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "subMemberIds": ["554117,592324,592334"]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {},
        "retExtInfo": {},
        "time": 1672147593188
    }
    - + \ No newline at end of file diff --git a/v5/abandon/ltv.html b/v5/abandon/ltv.html index 5270a45b34..d1f683a58e 100644 --- a/v5/abandon/ltv.html +++ b/v5/abandon/ltv.html @@ -4,13 +4,13 @@ Get LTV | Bybit API Documentation - +

    Get LTV

    HTTP Request​

    GET /v5/ins-loan/ltv

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    ltvInfoarrayObject
    > ltvstringRisk rate
    > parentUidstringUser id
    > subAccountUidsarrayBound user id
    > unpaidAmountstringTotal debt(USDT)
    > unpaidInfoarrayDebt details
    >> tokenstringcoin
    >> unpaidQtystringUnpaid principle
    >> unpaidIntereststringUnpaid interest
    > balancestringTotal asset. (margin coins converted to USDT). Please read here to understand the calculation
    > spotBalanceInfoarraySpot asset details
    >> tokenstringSpot margin coin
    >> pricestringSpot margin coin price
    >> qtystringSpot margin coin quantity
    > contractInfoarrayContract asset details
    >> tokenstringContract margin coin
    >> pricestringContract margin coin index price
    >> qtystringContract margin coin quantity (available balance of Contract account, and it is not involved with LTV calculation)

    Request Example​

    GET /v5/ins-loan/ltv HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1678688069538
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "ltvInfo": [
                {
                    "ltv": "0.1147",
                    "parentUid": "999805",
                    "subAccountUids": [
                        "999805"
                    ],
                    "unpaidAmount": "",
                    "unpaidInfo": [
                        {
                            "token": "USDT",
                            "unpaidQty": "6351.49614274",
                            "unpaidInterest": "264.0137162"
                        }
                    ],
                    "balance": "57626.875915433333333332400000000",
                    "spotBalanceInfo": [
                        {
                            "token": "BTC",
                            "price": "16375.621333333333333332",
                            "qty": "0.2"
                        },
                        ....
                        {
                            "token": "XRP",
                            "price": "0.409517",
                            "qty": "10000"
                        }
                    ],
                    "contractInfo": [
                        {
                            "token": "USDT",
                            "price": "1",
                            "qty": "0"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669367335608
    }
    - + \ No newline at end of file diff --git a/v5/abandon/margin-coin-info.html b/v5/abandon/margin-coin-info.html index abc2521987..b4db052e1f 100644 --- a/v5/abandon/margin-coin-info.html +++ b/v5/abandon/margin-coin-info.html @@ -4,13 +4,13 @@ Get Margin Coin Info | Bybit API Documentation - +

    Get Margin Coin Info

    HTTP Request​

    GET /v5/ins-loan/ensure-tokens

    Request Parameters​

    ParameterRequiredTypeComments
    productIdfalsestringProductId. If not passed, then return all product margin coin. For spot, it returns coin that convertRation greater than 0.

    Response Parameters​

    ParameterTypeComments
    marginTokenarrayObject
    > productIdstringProduct Id
    > spotTokenarraySpot margin coin
    >> tokenstringMargin coin
    >> convertRatiostringMargin coin convert ratio
    > contractTokenarrayContract margin coin
    >> tokenstringMargin coin
    >> convertRatiostringMargin coin convert ratio

    Request Example​

    GET /v5/ins-loan/ensure-tokens?productId=70 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "marginToken": [
                {
                    "productId": "70",
                    "spotToken": [
                        {
                            "token": "BTC",
                            "convertRatio": "1.00000000"
                        },
                        {
                            "token": "ETH",
                            "convertRatio": "1.00000000"
                        },
                        {
                            "token": "USDT",
                            "convertRatio": "1"
                        }
                    ],
                    "contractToken": [
                        {
                            "token": "USDT",
                            "convertRatio": "1"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669363954802
    }
    - + \ No newline at end of file diff --git a/v5/abandon/order-record.html b/v5/abandon/order-record.html index c909060081..4b995406b5 100644 --- a/v5/abandon/order-record.html +++ b/v5/abandon/order-record.html @@ -4,13 +4,13 @@ Get Order Records | Bybit API Documentation - +

    Get Order Records

    Get lending or redeem history

    HTTP Request​

    GET /v5/lending/history-order

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin name
    orderIdfalsestringOrder ID
    startTimefalselongThe start timestamp (ms)
    endTimefalselongThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 500]. Default: 50
    orderTypefalsestringOrder type. 1: deposit, 2: redemption, 3: Payment of proceeds

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > coinstringCoin name
    > createdTimestringCreated timestamp (ms)
    > orderIdstringOrder ID
    > quantitystringquantity
    > serialNostringSerial No
    > statusstringOrder status. 0: Initial, 1: Processing, 2: Success, 10: Failed, 11: Cancelled
    > updatedTimestringUpdated timestamp (ms)

    Request Example​

    GET /v5/lending/history-order?orderNo=1403517113428086272 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: 9pXyrhxTlXXXXXaVQGSaP3n
    X-BAPI-TIMESTAMP: 1682049395799
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "coin": "BTC",
                    "createdTime": "1682048277963",
                    "orderId": "1403517113428086272",
                    "orderType": "2",
                    "quantity": "0.1",
                    "serialNo": "14035171132183710722373",
                    "status": "2",
                    "updatedTime": "1682048278245"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1682049395967
    }
    - + \ No newline at end of file diff --git a/v5/abandon/redeem.html b/v5/abandon/redeem.html index 790d1dc62b..ce128f8413 100644 --- a/v5/abandon/redeem.html +++ b/v5/abandon/redeem.html @@ -4,13 +4,13 @@ Redeem Funds | Bybit API Documentation - +

    Redeem Funds

    Withdraw funds from the Bybit asset pool.

    tip

    There will be two redemption records: one for the redeemed quantity, and the other one is for the total interest occurred.

    HTTP Request​

    POST /v5/lending/redeem

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name
    quantityturestringRedemption quantity
    serialNofalsestringSerial no. A customised ID, and it will automatically generated if not passed

    Response Parameters​

    ParameterTypeComments
    coinstringCoin name
    createdTimestringCreated timestamp (ms)
    orderIdstringOrder ID
    principalQtystringRedemption quantity
    serialNostringSerial No
    statusstringOrder status. 0: Initial, 1: Processing, 2: Success, 10: Failed
    updatedTimestringUpdated timestamp (ms)

    Request Example​

    POST /v5/lending/redeem HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682048277724
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "coin": "BTC",
        "quantity": "0.1",
        "serialNo": null
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "coin": "BTC",
            "createdTime": "1682048277963",
            "orderId": "1403517113428086272",
            "principalQty": "0.1",
            "serialNo": "14035171132183710722373",
            "status": "0",
            "updatedTime": "1682048277963"
        },
        "retExtInfo": {},
        "time": 1682048278001
    }
    - + \ No newline at end of file diff --git a/v5/account/account-info.html b/v5/account/account-info.html index 11ff3cbb65..995790d6d7 100644 --- a/v5/account/account-info.html +++ b/v5/account/account-info.html @@ -4,13 +4,13 @@ Get Account Info | Bybit API Documentation - +

    Get Account Info

    Query the margin mode configuration of the account.

    note

    Query the margin mode and the upgraded status of account

    HTTP Request​

    GET /v5/account/info

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    unifiedMarginStatusintegerAccount status
    marginModestringISOLATED_MARGIN, REGULAR_MARGIN, PORTFOLIO_MARGIN
    dcpStatusstringDepreciated, always OFF. Please use Get DCP Info
    timeWindowintegerDepreciated, always 0. Please use Get DCP Info
    smpGroupintegerDepreciated, always 0. Please query Get SMP Group ID endpoint
    isMasterTraderbooleanWhether the account is a master trader (copytrading). true, false
    spotHedgingStatusstringWhether the unified account enables Spot hedging. ON, OFF
    updatedTimestringAccount data updated timestamp (ms)

    Request Example​

    GET /v5/account/info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672129307221
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "marginMode": "REGULAR_MARGIN",
            "updatedTime": "1697078946000",
            "unifiedMarginStatus": 4,
            "dcpStatus": "OFF",
            "timeWindow": 10,
            "smpGroup": 0,
            "isMasterTrader": false,
            "spotHedgingStatus": "OFF"
        }
    }
    - + \ No newline at end of file diff --git a/v5/account/batch-set-collateral.html b/v5/account/batch-set-collateral.html index 8640ff862d..51b50ac8e3 100644 --- a/v5/account/batch-set-collateral.html +++ b/v5/account/batch-set-collateral.html @@ -4,13 +4,13 @@ Batch Set Collateral Coin | Bybit API Documentation - +

    Batch Set Collateral Coin

    HTTP Request​

    POST /v5/account/set-collateral-switch-batch

    Request Parameters​

    ParameterRequiredTypeComments
    requesttruearrayObject
    > cointruestringCoin name, uppercase only
    • You can get collateral coin from here
    • USDT, USDC cannot be set
    > collateralSwitchtruestringON: switch on collateral, OFF: switch off collateral

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> coinstringCoin name
    >> collateralSwitchstringON: switch on collateral, OFF: switch off collateral

    Request Example​

    POST /v5/account/set-collateral-switch-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1704782042755
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 371

    {
        "request": [
            {
                "coin": "MATIC",
                "collateralSwitch": "OFF"
            },
            {
                "coin": "BTC",
                "collateralSwitch": "OFF"
            },
            {
                "coin": "ETH",
                "collateralSwitch": "OFF"
            },
            {
                "coin": "SOL",
                "collateralSwitch": "OFF"
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "result": {
            "list": [
                {
                    "coin": "MATIC",
                    "collateralSwitch": "OFF"
                },
                {
                    "coin": "BTC",
                    "collateralSwitch": "OFF"
                },
                {
                    "coin": "ETH",
                    "collateralSwitch": "OFF"
                },
                {
                    "coin": "SOL",
                    "collateralSwitch": "OFF"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1704782042913
    }
    - + \ No newline at end of file diff --git a/v5/account/borrow-history.html b/v5/account/borrow-history.html index bc331afadf..035ad2c799 100644 --- a/v5/account/borrow-history.html +++ b/v5/account/borrow-history.html @@ -4,13 +4,13 @@ Get Borrow History | Bybit API Documentation - +

    Get Borrow History

    Get interest records, sorted in reverse order of creation time.

    Unified account

    HTTP Request​

    GET /v5/account/borrow-history

    Request Parameters​

    ParameterRequiredTypeComments
    currencyfalsestringUSDC,USDT,BTC,ETH et, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 30 days by default
    • Only startTime is passed, return range between startTime and startTime+30 days
    • Only endTime is passed, return range between endTime-30 days and endTime
    • If both are passed, the rule is endTime - startTime <= 30 days
    endTimefalseintegerThe end time. 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
    > currencystringUSDC,USDT,BTC,ETH
    > createdTimeintegerCreated timestamp (ms)
    > borrowCoststringInterest
    > hourlyBorrowRatestringHourly Borrow Rate
    > InterestBearingBorrowSizestringInterest Bearing Borrow Size
    > costExemptionstringCost exemption
    > borrowAmountstringTotal borrow amount
    > unrealisedLossstringUnrealised loss
    > freeBorrowedAmountstringThe borrowed amount for interest free
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/account/borrow-history?currency=BTC&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672277745427
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "2671153%3A1%2C2671153%3A1",
            "list": [
                {
                    "borrowAmount": "1.06333265702840778",
                    "costExemption": "0",
                    "freeBorrowedAmount": "0",
                    "createdTime": 1697439900204,
                    "InterestBearingBorrowSize": "1.06333265702840778",
                    "currency": "BTC",
                    "unrealisedLoss": "0",
                    "hourlyBorrowRate": "0.000001216904",
                    "borrowCost": "0.00000129"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1697442206478
    }
    - + \ No newline at end of file diff --git a/v5/account/coin-greeks.html b/v5/account/coin-greeks.html index 4080d9eef8..38cfb1c9cc 100644 --- a/v5/account/coin-greeks.html +++ b/v5/account/coin-greeks.html @@ -4,13 +4,13 @@ Get Coin Greeks | Bybit API Documentation - +

    Get Coin Greeks

    Get current account Greeks information

    HTTP Request​

    GET /v5/asset/coin-greeks

    Request Parameters​

    ParameterRequiredTypeComments
    baseCoinfalsestringBase coin, uppercase only. If not passed, all supported base coin greeks will be returned by default

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > baseCoinstringBase coin. e.g.,BTC,ETH,SOL
    > totalDeltastringDelta value
    > totalGammastringGamma value
    > totalVegastringVega value
    > totalThetastringTheta value

    Request Example​

    GET /v5/asset/coin-greeks?baseCoin=BTC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672287887610
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "baseCoin": "BTC",
                    "totalDelta": "0.00004001",
                    "totalGamma": "-0.00000009",
                    "totalVega": "-0.00039689",
                    "totalTheta": "0.01243824"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672287887942
    }
    - + \ No newline at end of file diff --git a/v5/account/collateral-info.html b/v5/account/collateral-info.html index 2a893fa580..31247a60c8 100644 --- a/v5/account/collateral-info.html +++ b/v5/account/collateral-info.html @@ -4,13 +4,13 @@ Get Collateral Info | Bybit API Documentation - +

    Get Collateral Info

    Get the collateral information of the current unified margin account, including loan interest rate, loanable amount, collateral conversion rate, whether it can be mortgaged as margin, etc.

    HTTP Request​

    GET /v5/account/collateral-info

    Request Parameters​

    ParameterRequiredTypeComments
    currencyfalsestringAsset currency of all current collateral, uppercase only

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > currencystringCurrency of all current collateral
    > hourlyBorrowRatestringHourly borrow rate
    > maxBorrowingAmountstringMax borrow amount. This value is shared across main-sub UIDs
    > freeBorrowingLimitstringThe maximum limit for interest-free borrowing
    • Only the borrowing caused by contracts unrealised loss has interest-free amount
    • Spot margin borrowing always has interest
    > freeBorrowAmountstringThe amount of borrowing within your total borrowing amount that is exempt from interest charges
    > borrowAmountstringBorrow amount
    > freeBorrowingAmountstringDepreciated field, always return "", please refer to freeBorrowingLimit
    > availableToBorrowstringAvailable amount to borrow. This value is shared across main-sub UIDs
    > borrowablebooleanWhether currency can be borrowed
    > borrowUsageRatestringBorrow usage rate: borrowAmount/maxBorrowingAmount, it is an actual value, 0.5 means 50%
    > marginCollateralbooleanWhether it can be used as a margin collateral currency (platform), true: YES, false: NO
  • When marginCollateral=false, then collateralSwitch is meaningless
    • > collateralSwitchbooleanWhether the collateral is turned on by user (user), true: ON, false: OFF
  • When marginCollateral=true, then collateralSwitch is meaningful
    • > collateralRatiostringCollateral ratio

    Request Example​

    GET /v5/account/collateral-info?currency=BTC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672127952719
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "availableToBorrow": "3",
                    "freeBorrowingAmount": "",
                    "freeBorrowAmount": "0",
                    "maxBorrowingAmount": "3",
                    "hourlyBorrowRate": "0.00000147",
                    "borrowUsageRate": "0",
                    "collateralSwitch": true,
                    "borrowAmount": "0",
                    "borrowable": true,
                    "currency": "BTC",
                    "marginCollateral": true,
                    "freeBorrowingLimit": "0",
                    "collateralRatio": "0.95"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1691565901952
    }
    - + \ No newline at end of file diff --git a/v5/account/contract-transaction-log.html b/v5/account/contract-transaction-log.html index 8e2403c319..fc474e546a 100644 --- a/v5/account/contract-transaction-log.html +++ b/v5/account/contract-transaction-log.html @@ -4,13 +4,13 @@ Get Transaction Log | Bybit API Documentation - +

    Get Transaction Log

    Query transaction logs in the derivatives wallet (classic account), and inverse derivatives wallet (upgraded to UTA)

    API key permission: "Contract - Position"

    HTTP Request​

    GET /v5/account/contract-transaction-log

    Request Parameters​

    ParameterRequiredTypeComments
    currencyfalsestringCurrency, uppercase only
    baseCoinfalsestringBaseCoin, uppercase only. e.g., BTC of BTCPERP
    typefalsestringTypes of transaction logs
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed, the rule is endTime - startTime <= 7 days
    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
    > idstringUnique id
    > symbolstringSymbol name
    > categorystringProduct type
    > sidestringSide. Buy,Sell,None
    > transactionTimestringTransaction timestamp (ms)
    > typestringType
    > qtystringQuantity
  • Perps & Futures: it is the quantity for each trade entry and it does not have direction
    • > sizestringSize. The rest position size after the trade is executed, and it has direction, i.e., short with "-"
    > currencystringcurrency
    > tradePricestringTrade price
    > fundingstringFunding fee
    • Positive value means deducting funding fee
    • Negative value means receiving funding fee
    > feestringTrading fee
    • Positive fee value means expense
    • Negative fee value means rebates
    > cashFlowstringCash flow, e.g., (1) close the position, and unRPL converts to RPL, (2) transfer in or transfer out. This does not include trading fee, funding fee
    > changestringChange = cashFlow - funding - fee
    > cashBalancestringCash balance. This is the wallet balance after a cash change
    > feeRatestring
    • When type=TRADE, then it is trading fee rate
    • When type=SETTLEMENT, it means funding fee rate. For side=Buy, feeRate=market fee rate; For side=Sell, feeRate= - market fee rate
    > bonusChangestringThe change of bonus
    > tradeIdstringTrade ID
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/account/contract-transaction-log?limit=1&symbol=BTCUSD HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1714035117255
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "id": "467153",
                    "symbol": "BTCUSD",
                    "category": "inverse",
                    "side": "Sell",
                    "transactionTime": "1714032000000",
                    "type": "SETTLEMENT",
                    "qty": "1000",
                    "size": "-1000",
                    "currency": "BTC",
                    "tradePrice": "63974.88",
                    "funding": "-0.00000156",
                    "fee": "",
                    "cashFlow": "0.00000000",
                    "change": "0.00000156",
                    "cashBalance": "1.1311",
                    "feeRate": "-0.00010000",
                    "bonusChange": "",
                    "tradeId": "423a565c-f1b6-4c81-bc62-760cd7dd89e7",
                    "orderId": "",
                    "orderLinkId": ""
                }
            ],
            "nextPageCursor": "cursor_id%3D467153%26"
        },
        "retExtInfo": {},
        "time": 1714035117258
    }
    - + \ No newline at end of file diff --git a/v5/account/dcp-info.html b/v5/account/dcp-info.html index 641fd47061..39b63b20af 100644 --- a/v5/account/dcp-info.html +++ b/v5/account/dcp-info.html @@ -4,13 +4,13 @@ Get DCP Info | Bybit API Documentation - +

    Get DCP Info

    Query the DCP configuration of the account's contracts (USDT perpetual, USDC perpetual and USDC Futures) / spot / options. Before calling the interface, please make sure you have applied for the UTA account DCP configuration with your account manager

    • Only the configured main / sub account can query information from this API. Calling this API by an account always returns empty.

    • If you only request to activate Spot trading for DCP, the contract and options data will not be returned.

    info
    • support linear contract (USDT, USDC Perp & USDC Futures) / Spot / Options only
    • Unified account only

    HTTP Request​

    GET /v5/account/query-dcp-info

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    dcpInfosarray<object>DCP config for each product
    > productstringSPOT, DERIVATIVES, OPTIONS
    > dcpStatusstringDisconnected-CancelAll-Prevention status: ON
    > timeWindowstringDCP trigger time window which user pre-set. Between [3, 300] seconds, default: 10 sec

    Request Example​

    GET /v5/account/query-dcp-info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1717065530867
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    // it means my account enables Spot and Deriviatvies on the backend
    // Options is not enabled with DCP
    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "dcpInfos": [
                {
                    "product": "SPOT",
                    "dcpStatus": "ON",
                    "timeWindow": "10"
                },
                {
                    "product": "DERIVATIVES",
                    "dcpStatus": "ON",
                    "timeWindow": "10"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1717065531697
    }
    - + \ No newline at end of file diff --git a/v5/account/fee-rate.html b/v5/account/fee-rate.html index a6fa0fa1ab..fe1efb5bdd 100644 --- a/v5/account/fee-rate.html +++ b/v5/account/fee-rate.html @@ -4,13 +4,13 @@ Get Fee Rate | Bybit API Documentation - +

    Get Fee Rate

    Get the trading fee rate.

    Covers: Spot / USDT perpetual / USDC perpetual / USDC futures / Inverse perpetual / Inverse futures / Options

    HTTP Request​

    GET /v5/account/fee-rate

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. spot, linear, inverse, option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only. Valid for linear, inverse, spot
    baseCoinfalsestringBase coin, uppercase only. SOL, BTC, ETH. Valid for option

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type. spot, option. Derivatives does not have this field
    listarrayObject
    > symbolstringSymbol name. Keeps "" for Options
    > baseCoinstringBase coin. SOL, BTC, ETH
    • Derivatives does not have this field
    • Keeps "" for Spot
    > takerFeeRatestringTaker fee rate
    > makerFeeRatestringMaker fee rate

    Request Example​

    GET /v5/account/fee-rate?symbol=ETHUSDT HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXXX
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1676360412362
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "ETHUSDT",
                    "takerFeeRate": "0.0006",
                    "makerFeeRate": "0.0001"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1676360412576
    }
    - + \ No newline at end of file diff --git a/v5/account/get-mmp-state.html b/v5/account/get-mmp-state.html index d435035a2a..ad7d7479be 100644 --- a/v5/account/get-mmp-state.html +++ b/v5/account/get-mmp-state.html @@ -4,13 +4,13 @@ Get MMP State | Bybit API Documentation - +

    Get MMP State

    HTTP Request​

    GET /v5/account/mmp-state

    Request Parameters​

    ParameterRequiredTypeComments
    baseCointruestringBase coin, uppercase only

    Response Parameters​

    ParameterTypeComments
    resultarrayObject
    > baseCoinstringBase coin
    > mmpEnabledbooleanWhether the account is enabled mmp
    > windowstringTime window (ms)
    > frozenPeriodstringFrozen period (ms)
    > qtyLimitstringTrade qty limit
    > deltaLimitstringDelta limit
    > mmpFrozenUntilstringUnfreeze timestamp (ms)
    > mmpFrozenbooleanWhether the mmp is triggered.
    • true: mmpFrozenUntil is meaningful
    • false: please ignore the value of mmpFrozenUntil

    Request Example​

    POST /v5/account/mmp-reset HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675842997277
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "baseCoin": "ETH"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "result": [
                {
                    "baseCoin": "BTC",
                    "mmpEnabled": true,
                    "window": "5000",
                    "frozenPeriod": "100000",
                    "qtyLimit": "0.01",
                    "deltaLimit": "0.01",
                    "mmpFrozenUntil": "1675760625519",
                    "mmpFrozen": false
                }
            ]
        },
        "retExtInfo": {},
        "time": 1675843188984
    }
    - + \ No newline at end of file diff --git a/v5/account/repay-liability.html b/v5/account/repay-liability.html index c1260635ad..c72fe1492f 100644 --- a/v5/account/repay-liability.html +++ b/v5/account/repay-liability.html @@ -4,14 +4,14 @@ Repay Liability | Bybit API Documentation - +

    Repay Liability

    You can manually repay the liabilities of Unified account

    Applicable: Unified Account
    Permission: USDC Contracts

    HTTP Request​

    POST /v5/account/quick-repayment

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringThe coin with liability, uppercase only
    • Input the specific coin: repay the liability of this coin in particular
    • No coin specified: repay the liability of all coins

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > coinstringCoin used for repayment
    • The order of currencies used to repay liability is based on liquidationOrder from this endpoint
    > repaymentQtystringRepayment qty

    Request Example​

    POST /v5/account/quick-repayment HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1701848610019
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 22

    {
        "coin": "USDT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "result": {
            "list": [
                {
                    "coin": "BTC",
                    "repaymentQty": "0.10549670"
                },
                {
                    "coin": "ETH",
                    "repaymentQty": "2.27768114"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1701848610941
    }
    - + \ No newline at end of file diff --git a/v5/account/reset-mmp.html b/v5/account/reset-mmp.html index d6be0218d2..b65dc4f07f 100644 --- a/v5/account/reset-mmp.html +++ b/v5/account/reset-mmp.html @@ -4,13 +4,13 @@ Reset MMP | Bybit API Documentation - +

    Reset MMP

    info
    • Once the mmp triggered, you can unfreeze the account by this endpoint, then qtyLimit and deltaLimit will be reset to 0.
    • If the account is not frozen, reset action can also remove previous accumulation, i.e., qtyLimit and deltaLimit will be reset to 0.

    HTTP Request​

    POST /v5/account/mmp-reset

    Request Parameters​

    ParameterRequiredTypeComments
    baseCointruestringBase coin, uppercase only

    Response Parameters​

    None

    Request Example​

    POST /v5/account/mmp-reset HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675842997277
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "baseCoin": "ETH"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/v5/account/set-collateral.html b/v5/account/set-collateral.html index 6f67f58d6d..a67ae4a716 100644 --- a/v5/account/set-collateral.html +++ b/v5/account/set-collateral.html @@ -4,13 +4,13 @@ Set Collateral Coin | Bybit API Documentation - +

    Set Collateral Coin

    You can decide whether the assets in the Unified account needs to be collateral coins.

    HTTP Request​

    POST /v5/account/set-collateral-switch

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name, uppercase only
    • You can get collateral coin from here
    • USDT, USDC cannot be set
    collateralSwitchtruestringON: switch on collateral, OFF: switch off collateral

    Response Parameters​

    None

    Request Example​

    POST /v5/account/set-collateral-switch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1690513916181
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 55

    {
        "coin": "BTC",
        "collateralSwitch": "ON"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "result": {},
        "retExtInfo": {},
        "time": 1690515818656
    }
    - + \ No newline at end of file diff --git a/v5/account/set-margin-mode.html b/v5/account/set-margin-mode.html index 630cc3e44c..aea0461cca 100644 --- a/v5/account/set-margin-mode.html +++ b/v5/account/set-margin-mode.html @@ -4,13 +4,13 @@ Set Margin Mode | Bybit API Documentation - +

    Set Margin Mode

    Default is regular margin mode

    info
    • UTA account can be switched between these 3 kinds of margin modes, which is across UID level, working for USDT Perp, USDC Perp, USDC Futures and Options (Option does not support ISOLATED_MARGIN)
    • Classic account can be switched between REGULAR_MARGIN and PORTFOLIO_MARGIN, only work for USDC Perp and Options trading.

    HTTP Request​

    POST /v5/account/set-margin-mode

    Request Parameters​

    ParameterRequiredTypeComments
    setMarginModetruestringISOLATED_MARGIN, REGULAR_MARGIN(i.e. Cross margin), PORTFOLIO_MARGIN

    Response Parameters​

    ParameterTypeComments
    reasonsarrayObject. If requested successfully, it is an empty array
    > reasonCodestringFail reason code
    > reasonMsgstringFail reason msg

    Request Example​

    POST /v5/account/set-margin-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672134396332
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "setMarginMode": "PORTFOLIO_MARGIN"
    }

    Response Example​

    {
        "retCode": 3400045,
        "retMsg": "Set margin mode failed",
        "result": {
            "reasons": [
                {
                    "reasonCode": "3400000",
                    "reasonMsg": "Equity needs to be equal to or greater than 1000 USDC"
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/v5/account/set-mmp.html b/v5/account/set-mmp.html index 9335058f20..e19fb487bd 100644 --- a/v5/account/set-mmp.html +++ b/v5/account/set-mmp.html @@ -4,7 +4,7 @@ Set MMP | Bybit API Documentation - + @@ -16,7 +16,7 @@ and new orders tagged as MMP will be rejected for a specific duration — known as the frozen period — so that MM can reassess the market and modify the quotes.

    How to enable MMP​

    Send an email to Bybit (financial.inst@bybit.com) or contact your business development (BD) manager to apply for MMP. After processed, the default settings are as below table:

    ParameterTypeCommentsDefault value
    baseCoinstringBase coinBTC
    windowstringTime window (millisecond)5000
    frozenPeriodstringFrozen period (millisecond)100
    qtyLimitstringQuantity limit100
    deltaLimitstringDelta limit100

    Applicable​

    Effective for options only. When you place an option order, set mmp=true, which means you mark this order as a mmp order.

    Some points to note​

    1. Only maker order qty and delta will be counted into qtyLimit and deltaLimit.
    2. qty_limit is the sum of absolute value of qty of each trade executions. delta_limit is the absolute value of the sum of qty*delta. If any of these reaches or exceeds the limit amount, the account's market maker protection will be triggered.

    HTTP Request​

    POST /v5/account/mmp-modify

    Request Parameters​

    ParameterRequiredTypeComments
    baseCointruestringBase coin, uppercase only
    windowtruestringTime window (ms)
    frozenPeriodtruestringFrozen period (ms). "0" means the trade will remain frozen until manually reset
    qtyLimittruestringTrade qty limit (positive and up to 2 decimal places)
    deltaLimittruestringDelta limit (positive and up to 2 decimal places)

    Response Parameters​

    None

    Request Example​

    POST /v5/account/mmp-modify HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675833524616
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
        "baseCoin": "ETH",
        "window": "5000",
        "frozenPeriod": "100000",
        "qtyLimit": "50",
        "deltaLimit": "20"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/v5/account/set-spot-hedge.html b/v5/account/set-spot-hedge.html index a0542c5df6..1e3111f212 100644 --- a/v5/account/set-spot-hedge.html +++ b/v5/account/set-spot-hedge.html @@ -4,13 +4,13 @@ Set Spot Hedging | Bybit API Documentation - +

    Set Spot Hedging

    You can turn on/off Spot hedging feature in Portfolio margin for Unified account.

    info
    • Only unified account is applicable
    • Only portfolio margin mode is applicable

    HTTP Request​

    POST /v5/account/set-hedging-mode

    Request Parameters​

    ParameterRequiredTypeComments
    setHedgingModetruestringON, OFF

    Response Parameters​

    ParameterTypeComments
    retCodeintegerResult code
    retMsgstringResult message

    Request Example​

    POST /v5/account/set-hedging-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1700117968580
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 31

    {
        "setHedgingMode": "OFF"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "SUCCESS"
    }
    - + \ No newline at end of file diff --git a/v5/account/smp-group.html b/v5/account/smp-group.html index 8821a5846b..9465e0935a 100644 --- a/v5/account/smp-group.html +++ b/v5/account/smp-group.html @@ -4,13 +4,13 @@ Get SMP Group ID | Bybit API Documentation - +

    Get SMP Group ID

    Query the SMP group ID of self match prevention

    HTTP Request​

    GET /v5/account/smp-group

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    smpGroupintegerSmp group ID. If the UID has no group, it is 0 by default

    Request Example​

    GET /v5/account/smp-group HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1702363848192
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "smpGroup": 0
        },
        "retExtInfo": {},
        "time": 1702363848539
    }
    - + \ No newline at end of file diff --git a/v5/account/transaction-log.html b/v5/account/transaction-log.html index e79112d61b..1723c9c7e9 100644 --- a/v5/account/transaction-log.html +++ b/v5/account/transaction-log.html @@ -4,13 +4,13 @@ Get Transaction Log | Bybit API Documentation - +

    Get Transaction Log

    Query transaction logs in Unified account, it supports up to 2 years data

    HTTP Request​

    GET /v5/account/transaction-log

    Request Parameters​

    ParameterRequiredTypeComments
    accountTypefalsestringAccount Type. UNIFIED
    categoryfalsestringProduct type. spot,linear,option
    currencyfalsestringCurrency, uppercase only
    baseCoinfalsestringBaseCoin, uppercase only. e.g., BTC of BTCPERP
    typefalsestringTypes of transaction logs
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed, the rule is endTime - startTime <= 7 days
    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
    > idstringUnique id
    > symbolstringSymbol name
    > categorystringProduct type
    > sidestringSide. Buy,Sell,None
    > transactionTimestringTransaction timestamp (ms)
    > typestringType
    > qtystringQuantity
  • Spot: the negative means the qty of this currency is decreased, the positive means the qty of this currency is increased
  • Perps & Futures: it is the quantity for each trade entry and it does not have direction
    • > sizestringSize. The rest position size after the trade is executed, and it has direction, i.e., short with "-"
    > currencystringUSDC、USDT、BTC、ETH
    > tradePricestringTrade price
    > fundingstringFunding fee
    • Positive value means receiving funding fee
    • Negative value means deducting funding fee
    • For USDC Perp, as funding settlement and session settlement are occurred at the same time, so they are in the same log. Please refer to funding to understand funding fee, and cashFlow to understand 8-hour P&L
    > feestringTrading fee
    • Positive fee value means expense
    • Negative fee value means rebates
    > cashFlowstringCash flow, e.g., (1) close the position, and unRPL converts to RPL, (2) 8-hour session settlement for USDC Perp and Futures, (3) transfer in or transfer out. This does not include trading fee, funding fee
    > changestringChange = cashFlow + funding - fee
    > cashBalancestringCash balance. This is the wallet balance after a cash change
    > feeRatestring
    • When type=TRADE, then it is trading fee rate
    • When type=SETTLEMENT, it means funding fee rate. For side=Buy, feeRate=market fee rate; For side=Sell, feeRate= - market fee rate
    > bonusChangestringThe change of bonus
    > tradeIdstringTrade ID
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/account/transaction-log?accountType=UNIFIED&category=linear&currency=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672132480085
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "21963%3A1%2C14954%3A1",
            "list": [
                {
                    "id": "592324_XRPUSDT_161440249321",
                    "symbol": "XRPUSDT",
                    "side": "Buy",
                    "funding": "-0.003676",
                    "orderLinkId": "",
                    "orderId": "1672128000-8-592324-1-2",
                    "fee": "0.00000000",
                    "change": "-0.003676",
                    "cashFlow": "0",
                    "transactionTime": "1672128000000",
                    "type": "SETTLEMENT",
                    "feeRate": "0.0001",
                    "bonusChange": "",
                    "size": "100",
                    "qty": "100",
                    "cashBalance": "5086.55825002",
                    "currency": "USDT",
                    "category": "linear",
                    "tradePrice": "0.3676",
                    "tradeId": "534c0003-4bf7-486f-aa02-78cee36825e4"
                },
                {
                    "id": "592324_XRPUSDT_161440249321",
                    "symbol": "XRPUSDT",
                    "side": "Buy",
                    "funding": "",
                    "orderLinkId": "linear-order",
                    "orderId": "592b7e41-78fd-42e2-9aa3-91e1835ef3e1",
                    "fee": "0.01908720",
                    "change": "-0.0190872",
                    "cashFlow": "0",
                    "transactionTime": "1672121182224",
                    "type": "TRADE",
                    "feeRate": "0.0006",
                    "bonusChange": "-0.1430544",
                    "size": "100",
                    "qty": "88",
                    "cashBalance": "5086.56192602",
                    "currency": "USDT",
                    "category": "linear",
                    "tradePrice": "0.3615",
                    "tradeId": "5184f079-88ec-54c7-8774-5173cafd2b4e"
                },
                {
                    "id": "592324_XRPUSDT_161407743011",
                    "symbol": "XRPUSDT",
                    "side": "Buy",
                    "funding": "",
                    "orderLinkId": "linear-order",
                    "orderId": "592b7e41-78fd-42e2-9aa3-91e1835ef3e1",
                    "fee": "0.00260280",
                    "change": "-0.0026028",
                    "cashFlow": "0",
                    "transactionTime": "1672121182224",
                    "type": "TRADE",
                    "feeRate": "0.0006",
                    "bonusChange": "",
                    "size": "12",
                    "qty": "12",
                    "cashBalance": "5086.58101322",
                    "currency": "USDT",
                    "category": "linear",
                    "tradePrice": "0.3615",
                    "tradeId": "8569c10f-5061-5891-81c4-a54929847eb3"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672132481405
    }
    - + \ No newline at end of file diff --git a/v5/account/upgrade-unified-account.html b/v5/account/upgrade-unified-account.html index 21b5ff2314..c221da1ebf 100644 --- a/v5/account/upgrade-unified-account.html +++ b/v5/account/upgrade-unified-account.html @@ -4,7 +4,7 @@ Upgrade to Unified Account | Bybit API Documentation - + @@ -15,7 +15,7 @@ result cannot be returned in real time. You can check API Get Account Info after 3-5 minutes, check whether the upgrade is successful according to the "unifiedMarginStatus" field in the return.

  • During the account upgrade process, the data of Rest API/Websocket stream may be inaccurate due to the fact that the account-related asset data is in the processing state. It is recommended to query and use it after the upgrade is completed.

    • HTTP Request​

    POST /v5/account/upgrade-to-uta

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    unifiedUpdateStatusstringUpgrade status. FAIL,PROCESS,SUCCESS
    unifiedUpdateMsgObjectIf PROCESS,SUCCESS, it returns null
    > msgarrayError message array. Only FAIL will have this field

    Request Example​

    POST /v5/account/upgrade-to-uta HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672125123533
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {}

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "unifiedUpdateStatus": "FAIL",
            "unifiedUpdateMsg": {
                "msg": [
                    "Update account failed. You have outstanding liabilities in your Spot account.",
                    "Update account failed. Please close the usdc perpetual positions in USDC Account.",
                    "unable to upgrade, please cancel the usdt perpetual open orders in USDT account.",
                    "unable to upgrade, please close the usdt perpetual positions in USDT account."
                ]
        }
    },
        "retExtInfo": {},
        "time": 1672125124195
    }
    - + \ No newline at end of file diff --git a/v5/account/wallet-balance.html b/v5/account/wallet-balance.html index b6b81b759a..a8fd6edab9 100644 --- a/v5/account/wallet-balance.html +++ b/v5/account/wallet-balance.html @@ -4,14 +4,14 @@ Get Wallet Balance | Bybit API Documentation - +

    Get Wallet Balance

    Obtain wallet balance, query asset information of each currency, and account risk rate information. By default, currency information with assets or liabilities of 0 is not returned.

    tip
    • The trading of UTA inverse contracts is conducted through the CONTRACT wallet.
    • To get Funding wallet balance, please go to this endpoint

    HTTP Request​

    GET /v5/account/wallet-balance

    Request Parameters​

    ParameterRequiredTypeComments
    accountTypetruestringAccount type
    • Unified account: UNIFIED (trade spot/linear/options), CONTRACT(trade inverse)
    • Classic account: CONTRACT, SPOT
    coinfalsestringCoin name, uppercase only
    • If not passed, it returns non-zero asset info
    • You can pass multiple coins to query, separated by comma. USDT,USDC

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > accountTypestringAccount type
    > accountLTVstringThis field has been depreciated
    > accountIMRatestringInitial Margin Rate: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > accountMMRatestringMaintenance Margin Rate: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalEquitystringTotal Equity is calculated by adding the fiat currency valuation of the equity of each coin in your account. In non-unified mode & unified (inverse), the field will be returned as an empty string.
    > totalWalletBalancestringWallet Balance of account converted to usd：∑ Asset Wallet Balance By USD value of each asset。In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalMarginBalancestringMargin Balance of account converted to usd：totalWalletBalance + totalPerpUPL. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalAvailableBalancestringAvailable Balance of account converted to usd：Regular mode：totalMarginBalance - totalInitialMargin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalPerpUPLstringUnrealised P&L of Perpetuals and USDC Futures of account converted to usd：∑ Each Perp and USDC Futures upl by base coin. In non-unified mode & unified (inverse), the field will be returned as an empty string.
    > totalInitialMarginstringInitial Margin of account converted to usd：∑ Asset Total Initial Margin Base Coin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalMaintenanceMarginstringMaintenance Margin of account converted to usd: ∑ Asset Total Maintenance Margin Base Coin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > coinarrayObject
    >> coinstringCoin name, such as BTC, ETH, USDT, USDC
    >> equitystringEquity of current coin
    >> usdValuestringUSD value of current coin
    >> walletBalancestringWallet balance of current coin
    >> freestringAvailable balance for Spot wallet. This is a unique field for Classic SPOT
    >> lockedstringLocked balance due to the Spot open order
    >> spotHedgingQtystringThe spot asset qty that is used to hedge in the portfolio margin, truncate to 8 decimals and "0" by default This is a unique field for Unified account
    >> borrowAmountstringBorrow amount of current coin
    >> availableToBorrowstringDepreciated field, always return "" due to feature of main-sub UID sharing borrow quota. Please refer to availableToBorrow in the Get Collateral Info
    >> availableToWithdrawstringAvailable amount to withdraw of current coin
    >> accruedIntereststringAccrued interest
    >> totalOrderIMstringPre-occupied margin for order. For portfolio margin mode, it returns ""
    >> totalPositionIMstringSum of initial margin of all positions + Pre-occupied liquidation fee. For portfolio margin mode, it returns ""
    >> totalPositionMMstringSum of maintenance margin for all positions. For portfolio margin mode, it returns ""
    >> unrealisedPnlstringUnrealised P&L
    >> cumRealisedPnlstringCumulative Realised P&L
    >> bonusstringBonus. This is a unique field for UNIFIED account
    >> marginCollateralbooleanWhether it can be used as a margin collateral currency (platform), true: YES, false: NO
  • When marginCollateral=false, then collateralSwitch is meaningless
    • >> collateralSwitchbooleanWhether the collateral is turned on by user (user), true: ON, false: OFF
  • When marginCollateral=true, then collateralSwitch is meaningful

    • Request Example​

    GET /v5/account/wallet-balance?accountType=UNIFIED&coin=BTC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672125440406
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "totalEquity": "3.31216591",
                    "accountIMRate": "0",
                    "totalMarginBalance": "3.00326056",
                    "totalInitialMargin": "0",
                    "accountType": "UNIFIED",
                    "totalAvailableBalance": "3.00326056",
                    "accountMMRate": "0",
                    "totalPerpUPL": "0",
                    "totalWalletBalance": "3.00326056",
                    "accountLTV": "0",
                    "totalMaintenanceMargin": "0",
                    "coin": [
                        {
                            "availableToBorrow": "3",
                            "bonus": "0",
                            "accruedInterest": "0",
                            "availableToWithdraw": "0",
                            "totalOrderIM": "0",
                            "equity": "0",
                            "totalPositionMM": "0",
                            "usdValue": "0",
                            "spotHedgingQty": "0.01592413",
                            "unrealisedPnl": "0",
                            "collateralSwitch": true,
                            "borrowAmount": "0.0",
                            "totalPositionIM": "0",
                            "walletBalance": "0",
                            "cumRealisedPnl": "0",
                            "locked": "0",
                            "marginCollateral": true,
                            "coin": "BTC"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1690872862481
    }
    - + \ No newline at end of file diff --git a/v5/announcement.html b/v5/announcement.html index 94fb9c29fd..831015306e 100644 --- a/v5/announcement.html +++ b/v5/announcement.html @@ -4,13 +4,13 @@ Get Announcement | Bybit API Documentation - +

    Get Announcement

    HTTP Request​

    GET /v5/announcements/index

    Request Parameters​

    ParameterRequiredTypeComments
    localetruestringLanguage symbol
    typefalsestringAnnouncement type
    tagfalsestringAnnouncement tag
    pagefalseintegerPage number. Default: 1
    limitfalseintegerLimit for data size per page. Default: 20

    Response Parameters​

    ParameterTypeComments
    totalintegerTotal records
    listarrayObject
    > titlestringAnnouncement title
    > descriptionstringAnnouncement description
    > typeObject
    >> titlestringThe title of announcement type
    >> keystringThe key of announcement type
    > tagsarray<string>The tag of announcement
    > urlstringAnnouncement url
    > dateTimestampnumberTimestamp that author fills
    > startDataTimestampnumberThe start timestamp (ms) of the event, only valid when list.type.key == "latest_activities"
    > endDataTimestampnumberThe end timestamp (ms) of the event, only valid when list.type.key == "latest_activities"
    > publishTimenumberThe published timestamp for the announcement

    Request Example​

    GET /v5/announcements/index?locale=en-US&limit=1 HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "total": 735,
            "list": [
                {
                    "title": "New Listing: Arbitrum (ARB) — Deposit, Trade and Stake ARB to Share a 400,000 USDT Prize Pool!",
                    "description": "Bybit is excited to announce the listing of ARB on our trading platform!",
                    "type": {
                        "title": "New Listings",
                        "key": "new_crypto"
                    },
                    "tags": [
                        "Spot",
                        "Spot Listings"
                    ],
                    "url": "https://announcements.bybit.com/en-US/article/new-listing-arbitrum-arb-deposit-trade-and-stake-arb-to-share-a-400-000-usdt-prize-pool--bltf662314c211a8616/",
                    "dateTimestamp": 1679045608000,
                    "startDateTimestamp": 1679045608000,
                    "endDateTimestamp": 1679045608000
                }
            ]
        },
        "retExtInfo": {},
        "time": 1679415136117
    }
    - + \ No newline at end of file diff --git a/v5/asset/balance/account-coin-balance.html b/v5/asset/balance/account-coin-balance.html index 7a56b43955..b681ccdd5a 100644 --- a/v5/asset/balance/account-coin-balance.html +++ b/v5/asset/balance/account-coin-balance.html @@ -4,7 +4,7 @@ Get Single Coin Balance | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Get Single Coin Balance

    Query the balance of a specific coin in a specific account type. Supports querying sub UID's balance. Also, you can check the transferable amount from master to sub account, sub to master account or sub to sub account, especially for user who has an institutional loan.

    info
    • Sub account cannot query master account balance
    • Sub account can only check its own balance
    • Master account can check its own and its sub UIDs balance

    HTTP Request​

    GET /v5/asset/transfer/query-account-coin-balance

    Request Parameters​

    ParameterRequiredTypeComments
    memberIdfalsestringUID. Required when querying sub UID balance with master api key
    toMemberIdfalsestringUID. Required when querying the transferable balance between different UIDs
    accountTypetruestringAccount type
    toAccountTypefalsestringTo account type. Required when querying the transferable balance between different account types
    cointruestringCoin, uppercase only
    withBonusfalseinteger0(default): not query bonus. 1: query bonus
    withTransferSafeAmountfalseintegerWhether query delay withdraw/transfer safe amount
    withLtvTransferSafeAmountfalseintegerFor OTC loan users in particular, you can check the transferable amount under risk level
    • 0(default)：false, 1：true
    • toAccountType is mandatory

    Response Parameters​

    ParameterTypeComments
    accountTypestringAccount type
    bizTypeintegerBiz type
    accountIdstringAccount ID
    memberIdstringUid
    balanceObject
    > coinstringCoin
    > walletBalancestringWallet balance
    > transferBalancestringTransferable balance
    > bonusstringbonus
    > transferSafeAmountstringSafe amount to transfer. Keep "" if not query
    > ltvTransferSafeAmountstringTransferable amount for ins loan account. Keep "" if not query

    Request Example​

    GET /v5/asset/transfer/query-account-coin-balance?accountType=UNIFIED&coin=USDT&toAccountType=FUND&withLtvTransferSafeAmount=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxx
    X-BAPI-API-KEY: xxxxx
    X-BAPI-TIMESTAMP: 1690254520644
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "accountType": "UNIFIED",
            "bizType": 1,
            "accountId": "1631385",
            "memberId": "1631373",
            "balance": {
                "coin": "USDT",
                "walletBalance": "11999",
                "transferBalance": "11999",
                "bonus": "0",
                "transferSafeAmount": "",
                "ltvTransferSafeAmount": "7602.4861"
            }
        },
        "retExtInfo": {},
        "time": 1690254521256
    }
    - + \ No newline at end of file diff --git a/v5/asset/balance/all-balance.html b/v5/asset/balance/all-balance.html index d6b4cc3ffa..9abefb2803 100644 --- a/v5/asset/balance/all-balance.html +++ b/v5/asset/balance/all-balance.html @@ -4,13 +4,13 @@ Get All Coins Balance | Bybit API Documentation - +

    Get All Coins Balance

    You could get all coin balance of all account types under the master account, and sub account.

    Important

    It is not allowed to get master account coin balance via sub account api key.

    HTTP Request​

    GET /v5/asset/transfer/query-account-coins-balance

    Request Parameters​

    ParameterRequiredTypeComments
    memberIdfalsestringUser Id. It is required when you use master api key to check sub account coin balance
    accountTypetruestringAccount type
    coinfalsestringCoin name, uppercase only
    • Query all coins if not passed
    • Can query multiple coins, separated by comma. USDT,USDC,ETH
    withBonusfalseinteger0(default): not query bonus. 1: query bonus

    Response Parameters​

    ParameterTypeComments
    accountTypestringAccount type
    memberIdstringUserID
    balancearrayObject
    > coinstringCurrency type
    > walletBalancestringWallet balance
    > transferBalancestringTransferable balance
    > bonusstringThe bonus

    Request Example​

    GET /v5/asset/transfer/query-account-coins-balance?accountType=FUND&coin=USDC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675866354698
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "memberId": "XXXX",
            "accountType": "FUND",
            "balance": [
                {
                    "coin": "USDC",
                    "transferBalance": "0",
                    "walletBalance": "0",
                    "bonus": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1675866354913
    }
    - + \ No newline at end of file diff --git a/v5/asset/balance/asset-info.html b/v5/asset/balance/asset-info.html index b0b9670f94..9a3c6f0a3e 100644 --- a/v5/asset/balance/asset-info.html +++ b/v5/asset/balance/asset-info.html @@ -4,13 +4,13 @@ Get Asset Info | Bybit API Documentation - +

    Get Asset Info

    Query asset information

    info

    For now, it can query SPOT only.

    HTTP Request​

    GET /v5/asset/transfer/query-asset-info

    Request Parameters​

    ParameterRequiredTypeComments
    accountTypetruestringAccount type. SPOT
    coinfalsestringCoin name, uppercase only

    Response Parameters​

    ParameterTypeComments
    spotObject
    > statusstringaccount status. ACCOUNT_STATUS_NORMAL: normal, ACCOUNT_STATUS_UNSPECIFIED: banned
    > assetsarrayObject
    >> coinstringCoin
    >> frozenstringFreeze amount
    >> freestringFree balance
    >> withdrawstringAmount in withdrawing

    Request Example​

    GET /v5/asset/transfer/query-asset-info?accountType=SPOT&coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672136538042
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "spot": {
                "status": "ACCOUNT_STATUS_NORMAL",
                "assets": [
                    {
                        "coin": "ETH",
                        "frozen": "0",
                        "free": "11.53485",
                        "withdraw": ""
                    }
                ]
            }
        },
        "retExtInfo": {},
        "time": 1672136539127
    }
    - + \ No newline at end of file diff --git a/v5/asset/balance/delay-amount.html b/v5/asset/balance/delay-amount.html index 663ca31159..9427bb1562 100644 --- a/v5/asset/balance/delay-amount.html +++ b/v5/asset/balance/delay-amount.html @@ -4,13 +4,13 @@ Get Withdrawable Amount | Bybit API Documentation - +

    Get Withdrawable Amount

    info

    How can partial funds be subject to delayed withdrawal requests?

    • On-chain deposit: If the number of on-chain confirmations has not reached a risk-controlled level, a portion of the funds will be frozen for a period of time until they are unfrozen.
    • Buying crypto: If there is a risk, the funds will be frozen for a certain period of time and cannot be withdrawn.

    HTTP Request​

    GET /v5/asset/withdraw/withdrawable-amount

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name, uppercase only

    Response Parameters​

    ParameterTypeComments
    limitAmountUsdstringThe frozen amount due to risk, in USD
    withdrawableAmountObject
    > SPOTObjectSpot wallet, it is not returned if spot wallet is removed
    >> coinstringCoin name
    >> withdrawableAmountstringAmount that can be withdrawn
    >> availableBalancestringAvailable balance
    > FUNDObjectFunding wallet
    >> coinstringCoin name
    >> withdrawableAmountstringAmount that can be withdrawn
    >> availableBalancestringAvailable balance

    Request Example​

    GET /v5/asset/withdraw/withdrawable-amount?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677565621998
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "limitAmountUsd": "52853.5551",
            "withdrawableAmount": {
                "FUND": {
                    "coin": "USDT",
                    "withdrawableAmount": "11135.0596",
                    "availableBalance": "11135.0596"
                },
                "SPOT": {
                    "coin": "USDT",
                    "withdrawableAmount": "0",
                    "availableBalance": "0"
                }
            }
        },
        "retExtInfo": {},
        "time": 1677565632151
    }
    - + \ No newline at end of file diff --git a/v5/asset/coin-info.html b/v5/asset/coin-info.html index ae76f12e2c..2fb3d9691c 100644 --- a/v5/asset/coin-info.html +++ b/v5/asset/coin-info.html @@ -4,13 +4,13 @@ Get Coin Info | Bybit API Documentation - +

    Get Coin Info

    Query coin information, including chain information, withdraw and deposit status.

    HTTP Request​

    GET /v5/asset/coin/query-info

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin, uppercase only

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > nameintegerCoin name
    > coinstringCoin
    > remainAmountstringRemaining amount
    > chainsarrayObject
    >> chainstringChain
    >> chainTypestringChain type
    >> confirmationstringThe number of confirmation for deposit
    >> withdrawFeestringwithdraw fee. If withdraw fee is empty, It means that this coin does not support withdrawal
    >> depositMinstringMin. deposit
    >> withdrawMinstringMin. withdraw
    >> minAccuracystringThe precision of withdraw or deposit
    >> chainDepositstringThe chain status of deposit. 0: suspend. 1: normal
    >> chainWithdrawstringThe chain status of withdraw. 0: suspend. 1: normal
    >> withdrawPercentageFeestringThe withdraw fee percentage. It is a real figure, e.g., 0.022 means 2.2%

    Request Example​

    GET /v5/asset/coin/query-info?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672194580887
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "rows": [
                {
                    "name": "ETH",
                    "coin": "ETH",
                    "remainAmount": "1020000",
                    "chains": [
                        {
                            "chainType": "ETH",
                            "confirmation": "10000",
                            "withdrawFee": "0.005",
                            "depositMin": "0.01",
                            "withdrawMin": "0.02",
                            "chain": "ETH",
                            "chainDeposit": "1",
                            "chainWithdraw": "1",
                            "minAccuracy": "8",
                            "withdrawPercentageFee": "0.022"
                        },
                        {
                            "chainType": "Arbitrum One",
                            "confirmation": "10",
                            "withdrawFee": "0.01",
                            "depositMin": "0.001",
                            "withdrawMin": "0.1",
                            "chain": "ARBI",
                            "chainDeposit": "1",
                            "chainWithdraw": "1",
                            "minAccuracy": "8",
                            "withdrawPercentageFee": "0"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677478088215
    }
    - + \ No newline at end of file diff --git a/v5/asset/convert/apply-quote.html b/v5/asset/convert/apply-quote.html index 5e0487426f..42463f7351 100644 --- a/v5/asset/convert/apply-quote.html +++ b/v5/asset/convert/apply-quote.html @@ -4,13 +4,13 @@ Request a Quote | Bybit API Documentation - +

    Request a Quote

    HTTP Request​

    POST /v5/asset/exchange/quote-apply

    Request Parameters​

    ParameterRequiredTypeComments
    fromCointruestringConvert from coin (coin to sell)
    toCointruestringConvert to coin (coin to buy)
    fromCoinTypefalsestringcrypto
    toCoinTypefalsestringcrypto
    requestCointruestringRequest coin, same as fromCoin
  • In the future, we may support requestCoin=toCoin
    • requestAmounttruestringrequest coin amount (the amount you want to sell)
    accountTypetruestringWallet type
    paramTypefalsestringopFrom, mainly used for API broker user
    paramValuefalsestringBroker ID, mainly used for API broker user
    requestIdfalsestringCustomised request ID
  • a maximum length of 36
  • Generally it is useless, but it is convenient to track the quote request internally if you fill this field

    • Response Parameters​

    ParameterTypeComments
    quoteTxIdstringQuote transaction ID. It is system generated, and it is used to confirm quote and query the result of transaction
    exchangeRatestringExchange rate
    fromCoinstringFrom coin
    fromCoinTypestringFrom coin type. crypto
    toCoinstringTo coin
    toCoinTypestringTo coin type. crypto
    fromAmountstringFrom coin amount (amount to sell)
    toAmountstringTo coin amount (amount to buy according to exchange rate)
    expiredTimestringThe expiry time for this quote (15 seconds)
    requestIdstringCustomised request ID

    Request Example​

    POST /v5/asset/exchange/quote-apply HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720071077014
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json
    Content-Length: 172

    {
        "requestId": "test-00002",
        "fromCoin": "ETH",
        "toCoin": "BTC",
        "accountType": "eb_convert_funding",
        "requestCoin": "ETH",
        "requestAmount": "0.1",
        "paramType": "opFrom",
        "paramValue": "broker-id-001"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "quoteTxId": "10100108106409340067234418688",
            "exchangeRate": "0.053517914861880000",
            "fromCoin": "ETH",
            "fromCoinType": "crypto",
            "toCoin": "BTC",
            "toCoinType": "crypto",
            "fromAmount": "0.1",
            "toAmount": "0.005351791486188000",
            "expiredTime": "1720071092225",
            "requestId": "test-00002"
        },
        "retExtInfo": {},
        "time": 1720071077265
    }
    - + \ No newline at end of file diff --git a/v5/asset/convert/confirm-quote.html b/v5/asset/convert/confirm-quote.html index 65a4a523fa..dd48fa9b33 100644 --- a/v5/asset/convert/confirm-quote.html +++ b/v5/asset/convert/confirm-quote.html @@ -4,13 +4,13 @@ Confirm a Quote | Bybit API Documentation - +

    Confirm a Quote

    info
    1. The exchange is async, please check the final status by calling query result API.
    2. Make sure you confirm the quote before the quote is expired.

    HTTP Request​

    POST /v5/asset/exchange/convert-execute

    Request Parameters​

    ParameterRequiredTypeComments
    quoteTxIdtruestringThe quote tx ID from Request a Quote

    Response Parameters​

    ParameterTypeComments
    quoteTxIdstringQuote transaction ID
    exchangeStatusstringExchange status
  • init
  • processing
  • success
  • failure

    • Request Example​

    POST /v5/asset/exchange/convert-execute HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720071899789
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 52

    {
        "quoteTxId": "10100108106409343501030232064"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "exchangeStatus": "processing",
            "quoteTxId": "10100108106409343501030232064"
        },
        "retExtInfo": {},
        "time": 1720071900529
    }
    - + \ No newline at end of file diff --git a/v5/asset/convert/convert-coin-list.html b/v5/asset/convert/convert-coin-list.html index aa8fb289dc..033beeb18c 100644 --- a/v5/asset/convert/convert-coin-list.html +++ b/v5/asset/convert/convert-coin-list.html @@ -4,13 +4,13 @@ Get Convert Coin List | Bybit API Documentation - +

    Get Convert Coin List

    You can query the coin list of convert from (to).

    HTTP Request​

    GET /v5/asset/exchange/query-coin-list

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin, uppercase only
  • Convert from coin (coin to sell)
  • when side=0, coin field is ignored
    • sidefalseinteger0: fromCoin list, the balance is given if you have it; 1: toCoin list (coin to buy)
  • when side=1 and coin field is filled, it returns toCoin list based on coin field
    • accountTypetruestringWallet type
  • eb_convert_funding
  • eb_convert_uta
  • eb_convert_spot
  • eb_convert_contract
  • eb_convert_inverse

    • Response Parameters​

    ParameterTypeComments
    coinsarray<object>Coin spec
    > coinstringCoin
    > fullNamestringFull coin name
    > iconstringCoin icon url
    > iconNightstringCoin icon url (dark mode)
    > accuracyLengthintegerCoin precision
    > coinTypestringcrypto
    > balancestringCoin balance
  • Only when side=0, it checks balance, otherwise, it is ""
    • > uBalancestringCoin balance in USDT worth value
    > singleFromMinLimitstringThe minimum amount of fromCoin per transaction
    > singleFromMaxLimitstringThe maximum amount of fromCoin per transaction
    > disableFrombooleantrue: the coin is disabled to be fromCoin, false: the coin is allowed to be fromCoin
    > disableTobooleantrue: the coin is disabled to be toCoin, false: the coin is allowed to be toCoin
    > timePeriodintegerReserved field, ignored for now
    > singleToMinLimitstringReserved field, ignored for now
    > singleToMaxLimitstringReserved field, ignored for now
    > dailyFromMinLimitstringReserved field, ignored for now
    > dailyFromMaxLimitstringReserved field, ignored for now
    > dailyToMinLimitstringReserved field, ignored for now
    > dailyToMaxLimitstringReserved field, ignored for now

    Request Example​

    GET /v5/asset/exchange/query-coin-list?side=0&accountType=eb_convert_funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720064061248
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "coins": [
                {
                    "coin": "BTC",
                    "fullName": "BTC",
                    "icon": "https://t1.bycsi.com/app/assets/token/0717b8c28c2373bf714c964195411d0f.svg",
                    "iconNight": "https://t1.bycsi.com/app/assets/token/9504b4c841194cc38f04041003ffbfdb.svg",
                    "accuracyLength": 8,
                    "coinType": "crypto",
                    "balance": "0",
                    "uBalance": "0",
                    "timePeriod": 0,
                    "singleFromMinLimit": "0.001",
                    "singleFromMaxLimit": "1",
                    "singleToMinLimit": "0",
                    "singleToMaxLimit": "0",
                    "dailyFromMinLimit": "0",
                    "dailyFromMaxLimit": "0",
                    "dailyToMinLimit": "0",
                    "dailyToMaxLimit": "0",
                    "disableFrom": false,
                    "disableTo": false
                },
                ...
                {
                    "coin": "SOL",
                    "fullName": "SOL",
                    "icon": "https://s1.bycsi.com/app/assets/token/87ca5f1ca7229bdf0d9a16435653007c.svg",
                    "iconNight": "https://t1.bycsi.com/app/assets/token/383a834046655ffe5ef1be1a025791cc.svg",
                    "accuracyLength": 8,
                    "coinType": "crypto",
                    "balance": "18.05988133",
                    "uBalance": "2458.46990211775033220586588327",
                    "timePeriod": 0,
                    "singleFromMinLimit": "0.1",
                    "singleFromMaxLimit": "1250",
                    "singleToMinLimit": "0",
                    "singleToMaxLimit": "0",
                    "dailyFromMinLimit": "0",
                    "dailyFromMaxLimit": "0",
                    "dailyToMinLimit": "0",
                    "dailyToMaxLimit": "0",
                    "disableFrom": false,
                    "disableTo": false
                },
                ...
                {
                    "coin": "ETH",
                    "fullName": "ETH",
                    "icon": "https://s1.bycsi.com/app/assets/token/d6c17c9e767e1810875c702d86ac9f32.svg",
                    "iconNight": "https://t1.bycsi.com/app/assets/token/9613ac8e7d62081f4ca20488ae5b168d.svg",
                    "accuracyLength": 8,
                    "coinType": "crypto",
                    "balance": "0.80264489",
                    "uBalance": "2596.09751650032773106431534138",
                    "timePeriod": 0,
                    "singleFromMinLimit": "0.01",
                    "singleFromMaxLimit": "250",
                    "singleToMinLimit": "0",
                    "singleToMaxLimit": "0",
                    "dailyFromMinLimit": "0",
                    "dailyFromMaxLimit": "0",
                    "dailyToMinLimit": "0",
                    "dailyToMaxLimit": "0",
                    "disableFrom": false,
                    "disableTo": false
                }
            ]
        },
        "retExtInfo": {},
        "time": 1720064061736
    }
    - + \ No newline at end of file diff --git a/v5/asset/convert/get-convert-history.html b/v5/asset/convert/get-convert-history.html index 1646f6ad7c..27bb1c01d2 100644 --- a/v5/asset/convert/get-convert-history.html +++ b/v5/asset/convert/get-convert-history.html @@ -4,13 +4,13 @@ Get Convert history | Bybit API Documentation - +

    Get Convert history

    Those confirmed quotes no matter status are showns by this API.

    info

    Only display the conversion history created through open API.

    HTTP Request​

    GET /v5/asset/exchange/query-convert-history

    Request Parameters​

    ParameterRequiredTypeComments
    accountTypefalsestringWallet type
  • Supports passing multiple types, separated by comma e.g., eb_convert_funding,eb_convert_uta
  • Return all wallet types data if not passed
    • indexfalseintegerPage number
  • started from 1
  • 1st page by default
    • limitfalseintegerPage size
  • 20 records by default
  • up to 100 records, return 100 when exceeds 100

    • Response Parameters​

    ParameterTypeComments
    listarray<object>Array of quotes
    > accountTypestringWallet type
    > exchangeTxIdstringExchange tx ID, same as quote tx ID
    > userIdstringUser ID
    > fromCoinstringFrom coin
    > fromCoinTypestringFrom coin type. crypto
    > toCoinstringTo coin
    > toCoinTypestringTo coin type. crypto
    > fromAmountstringFrom coin amount (amount to sell)
    > toAmountstringTo coin amount (amount to buy according to exchange rate)
    > exchangeStatusstringExchange status
  • init
  • processing
  • success
  • failure
    • > extInfoobject
    >> paramTypestringThis field is published when you send it in the Request a Quote
    >> paramValuestringThis field is published when you send it in the Request a Quote
    > convertRatestringExchange rate
    > createdAtstringQuote created time

    Request Example​

    GET /v5/asset/exchange/query-convert-history?accountType=eb_convert_uta,eb_convert_funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720074159814
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "list": [
                {
                    "accountType": "eb_convert_funding",
                    "exchangeTxId": "10100108106409343501030232064",
                    "userId": "XXXXX",
                    "fromCoin": "ETH",
                    "fromCoinType": "crypto",
                    "fromAmount": "0.1",
                    "toCoin": "BTC",
                    "toCoinType": "crypto",
                    "toAmount": "0.00534882723991",
                    "exchangeStatus": "success",
                    "extInfo": {
                        "paramType": "opFrom",
                        "paramValue": "broker-id-001"
                    },
                    "convertRate": "0.0534882723991",
                    "createdAt": "1720071899995"
                },
                {
                    "accountType": "eb_convert_uta",
                    "exchangeTxId": "23070eb_convert_uta408933875189391360",
                    "userId": "XXXXX",
                    "fromCoin": "BTC",
                    "fromCoinType": "crypto",
                    "fromAmount": "0.1",
                    "toCoin": "ETH",
                    "toCoinType": "crypto",
                    "toAmount": "1.773938248611074",
                    "exchangeStatus": "success",
                    "extInfo": {},
                    "convertRate": "17.73938248611074",
                    "createdAt": "1719974243256"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1720074457715
    }
    - + \ No newline at end of file diff --git a/v5/asset/convert/get-convert-result.html b/v5/asset/convert/get-convert-result.html index 0af49da543..3c75e70dbd 100644 --- a/v5/asset/convert/get-convert-result.html +++ b/v5/asset/convert/get-convert-result.html @@ -4,14 +4,14 @@ Get Convert Status | Bybit API Documentation - +

    Get Convert Status

    You can query the exchange result by sending quoteTxId. Make sure you input correct account type and quoteTxId, otherwise you cannot find it.

    HTTP Request​

    GET /v5/asset/exchange/convert-result-query

    Request Parameters​

    ParameterRequiredTypeComments
    quoteTxIdtruestringQuote tx ID
    accountTypetruestringWallet type

    Response Parameters​

    ParameterTypeComments
    resultobject
    > accountTypestringWallet type
    > exchangeTxIdstringExchange tx ID, same as quote tx ID
    > userIdstringUser ID
    > fromCoinstringFrom coin
    > fromCoinTypestringFrom coin type. crypto
    > toCoinstringTo coin
    > toCoinTypestringTo coin type. crypto
    > fromAmountstringFrom coin amount (amount to sell)
    > toAmountstringTo coin amount (amount to buy according to exchange rate)
    > exchangeStatusstringExchange status
  • init
  • processing
  • success
  • failure
    • > extInfoobjectReserved field, ignored for now
    > convertRatestringExchange rate
    > createdAtstringQuote created time

    Request Example​

    GET /v5/asset/exchange/convert-result-query?quoteTxId=10100108106409343501030232064&accountType=eb_convert_funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720073659847
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "result": {
                "accountType": "eb_convert_funding",
                "exchangeTxId": "10100108106409343501030232064",
                "userId": "XXXXX",
                "fromCoin": "ETH",
                "fromCoinType": "crypto",
                "fromAmount": "0.1",
                "toCoin": "BTC",
                "toCoinType": "crypto",
                "toAmount": "0.00534882723991",
                "exchangeStatus": "success",
                "extInfo": {},
                "convertRate": "0.0534882723991",
                "createdAt": "1720071899995"
            }
        },
        "retExtInfo": {},
        "time": 1720073660696
    }
    - + \ No newline at end of file diff --git a/v5/asset/convert/guideline.html b/v5/asset/convert/guideline.html index 871baf04ab..ab0f45e7d6 100644 --- a/v5/asset/convert/guideline.html +++ b/v5/asset/convert/guideline.html @@ -4,13 +4,13 @@ Convert Guideline | Bybit API Documentation - +

    Convert Guideline

    info
    • All convert api need authentication
    • API key permission: "Exchange"

    Workflow​

    Step1 Get Convert Coin List​

    • Query the supported coin list of convert from / to in the different account types.
    • The balance is also given when querying the convert from coin list.

    Step2 Request a Quote​

    • Select fromCoin, toCoin, acccountType, define the qty of fromCoin to get a quote
    • There is balance pre-check at this stage.

    Step3 Confirm a Quote​

    • Confirm your quote in the valid time slot (15 secs). Once confirmed, the system processes your transactions.
    • This operation is async, so it can be failed if you have funds transferred out. Please check the transaction result by step 4.

    Step4 Get Convert Status​

    Check the final status of the coin convert.

    Error​

    CodeMsgComment
    790000system error, please try again later
    700000parameter error
    700001quote fail: no deler can be used
    700002quote fial: not support quote typewhen requestCoin=toCoin during request quote stage
    700003order status not allowed
    700004order does not exit1. check if quoteTxId is correct; 2. check if quoteTxId is matched with accountType
    700005Your available balance is insufficient or wallet does not exist
    700006Low amount limitthe request amount cannot be smaller than minFromCoinLimit
    700007Large amount limitthe request amount cannot be larger than maxFromCoinLimit
    700008quote fail: price time out1. the quote is expired; 2. The quoteTxId does not exist
    700009quoteTxId has already been usedget this error when you call confirm quote more than once before expiry time
    700010INS loan user cannot perform conversion
    700011illegal operationwhen request a quote with user A, but confirm the quote with user B

    API Rate Limit​

    MethodPathLimitUpgradable
    GET/v5/asset/exchange/query-coin-list100 req/sN
    POST/v5/asset/exchange/quote-apply50 req/sN
    POST/v5/asset/exchange/convert-execute50 req/sN
    GET/v5/asset/exchange/convert-result-query100 req/sN
    GET/v5/asset/exchange/query-convert-history100 req/sN
    - + \ No newline at end of file diff --git a/v5/asset/delivery.html b/v5/asset/delivery.html index 8217d6501f..af575fda3e 100644 --- a/v5/asset/delivery.html +++ b/v5/asset/delivery.html @@ -4,13 +4,13 @@ Get Delivery Record | Bybit API Documentation - +

    Get Delivery Record

    Query delivery records of USDC futures and Options, sorted by deliveryTime in descending order

    Unified account covers: USDC futures / Option

    HTTP Request​

    GET /v5/asset/delivery-record

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. option, linear
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 30 days by default
    • Only startTime is passed, return range between startTime and startTime+30 days
    • Only endTime is passed, return range between endTime-30 days and endTime
    • If both are passed, the rule is endTime - startTime <= 30 days
    endTimefalseintegerThe end time. timestamp (ms)
    expDatefalsestringExpiry date. 25MAR22. Default: return all
    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
    categorystringProduct type
    listarrayObject
    > deliveryTimenumberDelivery time (ms)
    > symbolstringSymbol name
    > sidestringBuy,Sell
    > positionstringExecuted size
    > deliveryPricestringDelivery price
    > strikestringExercise price
    > feestringTrading fee
    > deliveryRplstringRealized PnL of the delivery
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/asset/delivery-record?expDate=29DEC22&category=option HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672362112944
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "132791%3A0%2C132791%3A0",
            "category": "option",
            "list": [
                {
                    "symbol": "BTC-29DEC22-16000-P",
                    "side": "Buy",
                    "deliveryTime": 1672300800860,
                    "strike": "16000",
                    "fee": "0.00000000",
                    "position": "0.01",
                    "deliveryPrice": "16541.86369547",
                    "deliveryRpl": "3.5"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672362116184
    }
    - + \ No newline at end of file diff --git a/v5/asset/deposit/deposit-coin-spec.html b/v5/asset/deposit/deposit-coin-spec.html index 0b2b25a6b6..0798fdcbfd 100644 --- a/v5/asset/deposit/deposit-coin-spec.html +++ b/v5/asset/deposit/deposit-coin-spec.html @@ -4,13 +4,13 @@ Get Allowed Deposit Coin Info | Bybit API Documentation - +

    Get Allowed Deposit Coin Info

    Query allowed deposit coin information. To find out paired chain of coin, please refer coin info api.

    tip

    This is an endpoint that does not need authentication

    HTTP Request​

    GET /v5/asset/deposit/query-allowed-list

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin, uppercase only. coin and chain must be paired if passed
    chainfalsestringChain. coin and chain must be paired if passed
    limitfalseintegerLimit for data size per page. [1, 35]. Default: 10
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    configListarrayObject
    > coinstringCoin
    > chainstringChain
    > coinShowNamestringCoin name
    > chainTypestringChain type
    > blockConfirmNumberintegerDeposit confirmation number
    > minDepositAmountstringMinimum deposit amount
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/asset/deposit/query-allowed-list?coin=ETH&chain=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672191495968
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "configList": [
                {
                    "coin": "ETH",
                    "chain": "ETH",
                    "coinShowName": "ETH",
                    "chainType": "ETH",
                    "blockConfirmNumber": 10000,
                    "minDepositAmount": "0.01"
                }
            ],
            "nextPageCursor": "eyJwYWdlIjoyLCJsaW1pdCI6MTB9"
        },
        "retExtInfo": {},
        "time": 1672191496219
    }
    - + \ No newline at end of file diff --git a/v5/asset/deposit/deposit-record.html b/v5/asset/deposit/deposit-record.html index b8f99c1a11..42af3520b8 100644 --- a/v5/asset/deposit/deposit-record.html +++ b/v5/asset/deposit/deposit-record.html @@ -4,13 +4,13 @@ Get Deposit Records (on-chain) | Bybit API Documentation - +

    Get Deposit Records (on-chain)

    Query deposit records.

    tip
    • endTime - startTime should be less than 30 days. Query last 30 days records by default.
    • Can use main or sub UID api key to query deposit records respectively.

    HTTP Request​

    GET /v5/asset/deposit/query-record

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > coinstringCoin
    > chainstringChain
    > amountstringAmount
    > txIDstringTransaction ID
    > statusintegerDeposit status
    > toAddressstringDeposit target address
    > tagstringTag of deposit target address
    > depositFeestringDeposit fee
    > successAtstringLast updated time
    > confirmationsstringNumber of confirmation blocks
    > txIndexstringTransaction sequence number
    > blockHashstringHash number on the chain
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit
    > depositTypestringThe deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/asset/deposit/query-record?coin=USDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672191991544
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "10000",
                    "txID": "skip-notification-scene-test-amount-202212270944-533285-USDT",
                    "status": 3,
                    "toAddress": "test-amount-address",
                    "tag": "",
                    "depositFee": "",
                    "successAt": "1672134274000",
                    "confirmations": "10000",
                    "txIndex": "",
                    "blockHash": "",
                    "batchReleaseLimit": "-1",
                    "depositType": "0"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTA0NjA0MywibWF4SUQiOjEwNDYwNDN9"
        },
        "retExtInfo": {},
        "time": 1672191992512
    }
    - + \ No newline at end of file diff --git a/v5/asset/deposit/internal-deposit-record.html b/v5/asset/deposit/internal-deposit-record.html index 268d09482d..b5766b8d7d 100644 --- a/v5/asset/deposit/internal-deposit-record.html +++ b/v5/asset/deposit/internal-deposit-record.html @@ -4,13 +4,13 @@ Get Internal Deposit Records (off-chain) | Bybit API Documentation - +

    Get Internal Deposit Records (off-chain)

    Query deposit records within the Bybit platform. These transactions are not on the blockchain.

    Rules
    • The maximum difference between the start time and the end time is 30 days.
    • Support to get deposit records by Master or Sub Member Api Key

    HTTP Request​

    GET /v5/asset/deposit/query-internal-record

    Request Parameters​

    ParameterRequiredTypeComments
    txIDfalsestringInternal transfer transaction ID
    startTimefalseintegerStart time (ms). Default value: 30 days before the current time
    endTimefalseintegerEnd time (ms). Default value: current time
    coinfalsestringCoin name: for example, BTC. Default value: all
    cursorfalsestringCursor, used for pagination
    limitfalseintegerNumber of items per page, [1, 50]. Default value: 50

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > idstringID
    > typeinteger1: Internal deposit
    > coinstringDeposit coin
    > amountstringDeposit amount
    > statusinteger
    • 1=Processing
    • 2=Success
    • 3=deposit failed
    > addressstringEmail address or phone number
    > createdTimestringDeposit created timestamp
    > txIDstringInternal transfer transaction ID
    nextPageCursorstringcursor information: used for pagination. Default value: ""

    Request Example​

    GET /v5/asset/deposit/query-internal-record HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682099024473
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "id": "1103",
                    "amount": "0.1",
                    "type": 1,
                    "coin": "ETH",
                    "address": "xxxx***@gmail.com",
                    "status": 2,
                    "createdTime": "1705393280",
                    "txID": "77c37e5c-d9fa-41e5-bd13-c9b59d95"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTEwMywibWF4SUQiOjExMDN9"
        },
        "retExtInfo": {},
        "time": 1705395632689
    }
    - + \ No newline at end of file diff --git a/v5/asset/deposit/master-deposit-addr.html b/v5/asset/deposit/master-deposit-addr.html index 4eb1bd1a24..798ca3a550 100644 --- a/v5/asset/deposit/master-deposit-addr.html +++ b/v5/asset/deposit/master-deposit-addr.html @@ -4,13 +4,13 @@ Get Master Deposit Address | Bybit API Documentation - +

    Get Master Deposit Address

    Query the deposit address information of MASTER account.

    HTTP Request​

    GET /v5/asset/deposit/query-address

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin, uppercase only
    chainTypefalsestringPlease use the value of >> chain from coin-info endpoint

    Response Parameters​

    ParameterTypeComments
    coinstringCoin
    chainsarrayObject
    > chainTypestringChain type
    > addressDepositstringThe address for deposit
    > tagDepositstringTag of deposit
    > chainstringChain
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit

    Request Example​

    GET /v5/asset/deposit/query-address?coin=USDT&chainType=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672192792371
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "USDT",
            "chains": [
                {
                    "chainType": "ERC20",
                    "addressDeposit": "0xd9e1cd77afa0e50b452a62fbb68a3340602286c3",
                    "tagDeposit": "",
                    "chain": "ETH",
                    "batchReleaseLimit": "-1"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672192792860
    }
    - + \ No newline at end of file diff --git a/v5/asset/deposit/set-deposit-acct.html b/v5/asset/deposit/set-deposit-acct.html index 39f59ff3bd..e026655c72 100644 --- a/v5/asset/deposit/set-deposit-acct.html +++ b/v5/asset/deposit/set-deposit-acct.html @@ -4,13 +4,13 @@ Set Deposit Account | Bybit API Documentation - +

    Set Deposit Account

    Set auto transfer account after deposit. The same function as the setting for Deposit on web GUI

    info
    • Your funds will be deposited into FUND wallet by default. You can set the wallet for auto-transfer after deposit by this API.
    • Only main UID can access.
    tip
    • Unified trading account has FUND, UNIFIED, CONTRACT(for inverse derivatives)
    • Classic account has FUND, CONTRACT(for inverse derivatives and derivatives), SPOT

    HTTP Request​

    POST /v5/asset/deposit/deposit-to-account

    Request Parameters​

    ParameterRequiredTypeComments
    accountTypetruestringAccount type
    • UNIFIED
    • SPOT
    • CONTRACT
    • FUND

    Response Parameters​

    ParameterTypeComments
    statusintegerRequest result:
    • 1: SUCCESS
    • 0: FAIL

    Request Example​

    POST /v5/asset/deposit/deposit-to-account HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676887913670
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
        "accountType": "CONTRACT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "status": 1
        },
        "retExtInfo": {},
        "time": 1676887914363
    }
    - + \ No newline at end of file diff --git a/v5/asset/deposit/sub-deposit-addr.html b/v5/asset/deposit/sub-deposit-addr.html index c84ecea6f5..1ac12b5ebb 100644 --- a/v5/asset/deposit/sub-deposit-addr.html +++ b/v5/asset/deposit/sub-deposit-addr.html @@ -4,13 +4,13 @@ Get Sub Deposit Address | Bybit API Documentation - +

    Get Sub Deposit Address

    Query the deposit address information of SUB account.

    caution

    Can use master UID's api key only

    HTTP Request​

    GET /v5/asset/deposit/query-sub-member-address

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin, uppercase only
    chainTypetruestringPlease use the value of chain from coin-info endpoint
    subMemberIdtruestringSub user ID

    Response Parameters​

    ParameterTypeComments
    coinstringCoin
    chainsarrayObject
    > chainTypestringChain type
    > addressDepositstringThe address for deposit
    > tagDepositstringTag of deposit
    > chainstringChain
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit

    Request Example​

    GET /v5/asset/deposit/query-sub-member-address?coin=USDT&chainType=TRX&subMemberId=592334 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672194349421
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "USDT",
            "chains": {
                "chainType": "TRC20",
                "addressDeposit": "TCB6NmwGXjn8eJYDuPxLvs4aM8Jn7gvJ1f",
                "tagDeposit": "",
                "chain": "TRX",
                "batchReleaseLimit": "-1"
            }
        },
        "retExtInfo": {},
        "time": 1672194350819
    }
    - + \ No newline at end of file diff --git a/v5/asset/deposit/sub-deposit-record.html b/v5/asset/deposit/sub-deposit-record.html index ea2c466d69..785b395c67 100644 --- a/v5/asset/deposit/sub-deposit-record.html +++ b/v5/asset/deposit/sub-deposit-record.html @@ -4,13 +4,13 @@ Get Sub Deposit Records (on-chain) | Bybit API Documentation - +

    Get Sub Deposit Records (on-chain)

    Query subaccount's deposit records by main UID's API key.

    tip

    endTime - startTime should be less than 30 days. Queries for the last 30 days worth of records by default.

    HTTP Request​

    GET /v5/asset/deposit/query-sub-member-record

    Request Parameters​

    ParameterRequiredTypeComments
    subMemberIdtruestringSub UID
    coinfalsestringCoin, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > coinstringCoin
    > chainstringChain
    > amountstringAmount
    > txIDstringTransaction ID
    > statusintegerDeposit status
    > toAddressstringDeposit target address
    > tagstringTag of deposit target address
    > depositFeestringDeposit fee
    > successAtstringLast updated time
    > confirmationsstringNumber of confirmation blocks
    > txIndexstringTransaction sequence number
    > blockHashstringHash number on the chain
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit
    > depositTypestringThe deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/asset/deposit/query-sub-member-record?coin=USDT&limit=1&subMemberId=592334 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672192441294
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1672192441742
    }
    - + \ No newline at end of file diff --git a/v5/asset/exchange.html b/v5/asset/exchange.html index f5e40fe07a..4f0209b947 100644 --- a/v5/asset/exchange.html +++ b/v5/asset/exchange.html @@ -4,13 +4,13 @@ Get Coin Exchange Records | Bybit API Documentation - +

    Get Coin Exchange Records

    Query the coin exchange records.

    info

    It sometimes has 5 secs delay

    HTTP Request​

    GET /v5/asset/exchange/order-record

    Request Parameters​

    ParameterRequiredTypeComments
    fromCoinfalsestringThe currency to convert from, uppercase only. e.g,BTC
    toCoinfalsestringThe currency to convert to, uppercase only. e.g,USDT
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 10
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    nextPageCursorstringRefer to the cursor request parameter
    orderBodyarrayObject
    > fromCoinstringThe currency to convert from
    > fromAmountstringThe amount to convert from
    > toCoinstringThe currency to convert to
    > toAmountstringThe amount to convert to
    > exchangeRatestringExchange rate
    > createdTimestringExchange created timestamp (sec)
    > exchangeTxIdstringExchange transaction ID

    Request Example​

    GET /v5/asset/exchange/order-record?limit=10 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672990462492
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderBody": [
                {
                    "fromCoin": "BTC",
                    "fromAmount": "0.100000000000000000",
                    "toCoin": "ETH",
                    "toAmount": "1.385866230000000000",
                    "exchangeRate": "13.858662380000000000",
                    "createdTime": "1672197760",
                    "exchangeTxId": "145102533285208544812654440448"
                }
            ],
            "nextPageCursor": "173341:1672197760"
        },
        "retExtInfo": {},
        "time": 1672990464021
    }
    - + \ No newline at end of file diff --git a/v5/asset/settlement.html b/v5/asset/settlement.html index c8f58ac53d..408d5bda70 100644 --- a/v5/asset/settlement.html +++ b/v5/asset/settlement.html @@ -4,13 +4,13 @@ Get USDC Session Settlement | Bybit API Documentation - +

    Get USDC Session Settlement

    Query session settlement records of USDC perpetual and futures

    Unified account covers: USDC perpetual / USDC futures

    HTTP Request​

    GET /v5/asset/settlement-record

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 30 days by default
    • Only startTime is passed, return range between startTime and startTime+30 days
    • Only endTime is passed, return range between endTime-30 days and endTime
    • If both are passed, the rule is endTime - startTime <= 30 days
    endTimefalseintegerThe end time. 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
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > sidestringBuy,Sell
    > sizestringPosition size
    > sessionAvgPricestringSettlement price
    > markPricestringMark price
    > realisedPnlstringRealised PnL
    > createdTimestringCreated time (ms)
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/asset/settlement-record?category=linear HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672284883483
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "116952%3A1%2C116952%3A1",
            "category": "linear",
            "list": [
                {
                    "realisedPnl": "-71.28",
                    "symbol": "BTCPERP",
                    "side": "Buy",
                    "markPrice": "16620",
                    "size": "1.5",
                    "createdTime": "1672214400000",
                    "sessionAvgPrice": "16620"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672284884285
    }
    - + \ No newline at end of file diff --git a/v5/asset/sub-uid-list.html b/v5/asset/sub-uid-list.html index c5fc93adb2..46431c7c74 100644 --- a/v5/asset/sub-uid-list.html +++ b/v5/asset/sub-uid-list.html @@ -4,13 +4,13 @@ Get Sub UID | Bybit API Documentation - +

    Get Sub UID

    Query the sub UIDs under a main UID. It returns up to 2000 sub accounts, if you need more, please call this endpoint.

    caution

    Can query by the master UID's api key only

    HTTP Request​

    GET /v5/asset/transfer/query-sub-member-list

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    subMemberIdsarray<string>All sub UIDs under the main UID
    transferableSubMemberIdsarray<string>All sub UIDs that have universal transfer enabled

    Request Example​

    GET /v5/asset/transfer/query-sub-member-list HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672147239931
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "subMemberIds": [
                "554117",
                "592324",
                "592334",
                "1055262",
                "1072055",
                "1119352"
            ],
            "transferableSubMemberIds": [
                "554117",
                "592324"
            ]
        },
        "retExtInfo": {},
        "time": 1672147241320
    }
    - + \ No newline at end of file diff --git a/v5/asset/transfer/create-inter-transfer.html b/v5/asset/transfer/create-inter-transfer.html index 9f553f71d2..f40a56bed6 100644 --- a/v5/asset/transfer/create-inter-transfer.html +++ b/v5/asset/transfer/create-inter-transfer.html @@ -4,13 +4,13 @@ Create Internal Transfer | Bybit API Documentation - +

    Create Internal Transfer

    Create the internal transfer between different account types under the same UID.

    tip
    • Each account type has its own acceptable coins, e.g, you cannot transfer USDC from SPOT to CONTRACT.
    • Please refer to transferable coin list API to find out more.
    • Currently, the funding wallet only supports outgoing transfers in cryptocurrency, not in fiat currency.

    HTTP Request​

    POST /v5/asset/transfer/inter-transfer

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdtruestringUUID. Please manually generate a UUID
    cointruestringCoin, uppercase only
    amounttruestringAmount
    fromAccountTypetruestringFrom account type
    toAccountTypetruestringTo account type

    Response Parameters​

    ParameterTypeComments
    transferIdstringUUID
    statusstringTransfer status
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

    • Request Example​

    POST v5/asset/transfer/inter-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670986690556
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json
    {
        "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb16",
        "coin": "BTC",
        "amount": "0.05",
        "fromAccountType": "UNIFIED",
        "toAccountType": "CONTRACT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbab16",
            "status": "SUCCESS"
        },
        "retExtInfo": {},
        "time": 1670986962783
    }
    - + \ No newline at end of file diff --git a/v5/asset/transfer/inter-transfer-list.html b/v5/asset/transfer/inter-transfer-list.html index bcbc8069b4..3bfab6bb72 100644 --- a/v5/asset/transfer/inter-transfer-list.html +++ b/v5/asset/transfer/inter-transfer-list.html @@ -4,13 +4,13 @@ Get Internal Transfer Records | Bybit API Documentation - +

    Get Internal Transfer Records

    Query the internal transfer records between different account types under the same UID.

    info

    When both startTime & endTime are not passed, API returns 30 days data by default

    HTTP Request​

    GET /v5/asset/transfer/query-inter-transfer-list

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdfalsestringUUID. Use the one you generated in createTransfer
    coinfalsestringCoin, uppercase only
    statusfalsestringTransfer status
    startTimefalseintegerThe start timestamp (ms) Note: the query logic is actually effective based on second level
    endTimefalseintegerThe end timestamp (ms) Note: the query logic is actually effective based on second level
    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
    > transferIdstringTransfer ID
    > coinstringTransferred coin
    > amountstringTransferred amount
    > fromAccountTypestringFrom account type
    > toAccountTypestringTo account type
    > timestampstringTransfer created timestamp (ms)
    > statusstringTransfer status
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/asset/transfer/inter-transfer-list-query?coin=USDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670988271299
    X-BAPI-RECV-WINDOW: 50000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        "list": [
            {
                "transferId": "selfTransfer_a1091cc7-9364-4b74-8de1-18f02c6f2d5c",
                "coin": "USDT",
                "amount": "5000",
                "fromAccountType": "SPOT",
                "toAccountType": "UNIFIED",
                "timestamp": "1667283263000",
                "status": "SUCCESS"
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MTM1ODQ2OCwibWF4SUQiOjEzNTg0Njh9"
    },
        "retExtInfo": {},
        "time": 1670988271677
    }
    - + \ No newline at end of file diff --git a/v5/asset/transfer/transferable-coin.html b/v5/asset/transfer/transferable-coin.html index ef76e39830..d160c90541 100644 --- a/v5/asset/transfer/transferable-coin.html +++ b/v5/asset/transfer/transferable-coin.html @@ -4,13 +4,13 @@ Get Transferable Coin | Bybit API Documentation - +

    Get Transferable Coin

    Query the transferable coin list between each account type

    HTTP Request​

    GET /v5/asset/transfer/query-transfer-coin-list

    Request Parameters​

    ParameterRequiredTypeComments
    fromAccountTypetruestringFrom account type
    toAccountTypetruestringTo account type

    Response Parameters​

    ParameterTypeComments
    listarrayA list of coins (as strings)

    Request Example​

    GET /v5/asset/transfer/query-transfer-coin-list?fromAccountType=UNIFIED&toAccountType=CONTRACT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672144322595
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                "BTC",
                "ETH"
            ]
        },
        "retExtInfo": {},
        "time": 1672144322954
    }
    - + \ No newline at end of file diff --git a/v5/asset/transfer/unitransfer-list.html b/v5/asset/transfer/unitransfer-list.html index 8840e9420c..e236afd03f 100644 --- a/v5/asset/transfer/unitransfer-list.html +++ b/v5/asset/transfer/unitransfer-list.html @@ -4,13 +4,13 @@ Get Universal Transfer Records | Bybit API Documentation - +

    Get Universal Transfer Records

    Query universal transfer records

    tip
    • Main acct api key or Sub acct api key are both supported
    • Main acct api key needs "SubMemberTransfer" permission
    • Sub acct api key needs "SubMemberTransferList" permission
    info

    When both startTime & endTime are not passed, API returns 30 days data by default

    HTTP Request​

    GET /v5/asset/transfer/query-universal-transfer-list

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdfalsestringUUID. Use the one you generated in createTransfer
    coinfalsestringCoin, uppercase only
    statusfalsestringTransfer status. SUCCESS,FAILED,PENDING
    startTimefalseintegerThe start timestamp (ms) Note: the query logic is actually effective based on second level
    endTimefalseintegerThe end timestamp (ms) Note: the query logic is actually effective based on second level
    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
    > transferIdstringTransfer ID
    > coinstringTransferred coin
    > amountstringTransferred amount
    > fromMemberIdstringFrom UID
    > toMemberIdstringTO UID
    > fromAccountTypestringFrom account type
    > toAccountTypestringTo account type
    > timestampstringTransfer created timestamp (ms)
    > statusstringTransfer status
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/asset/transfer/query-universal-transfer-list?limit=1&cursor=eyJtaW5JRCI6MTc5NjU3OCwibWF4SUQiOjE3OTY1Nzh9 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672190762800
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "transferId": "universalTransfer_4c3cfe2f-85cb-11ed-ac09-9e37823c81cd_533285",
                    "coin": "USDC",
                    "amount": "1000",
                    "timestamp": "1672134373000",
                    "status": "SUCCESS",
                    "fromAccountType": "UNIFIED",
                    "toAccountType": "UNIFIED",
                    "fromMemberId": "533285",
                    "toMemberId": "592324"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTc4OTYwNSwibWF4SUQiOjE3ODk2MDV9"
        },
        "retExtInfo": {},
        "time": 1672190763079
    }
    - + \ No newline at end of file diff --git a/v5/asset/transfer/unitransfer.html b/v5/asset/transfer/unitransfer.html index 4724239958..d99b2a8393 100644 --- a/v5/asset/transfer/unitransfer.html +++ b/v5/asset/transfer/unitransfer.html @@ -4,13 +4,13 @@ Create Universal Transfer | Bybit API Documentation - +

    Create Universal Transfer

    Transfer between sub-sub or main-sub.

    caution
    • Can use master or sub acct api key to request
      • To use sub acct api key, it must have "SubMemberTransferList" permission
      • When use sub acct api key, it can only transfer to main account
    • If you encounter errorCode: 131228 and msg: your balance is not enough, please go to Get Single Coin Balance to check transfer safe amount.
    • You can not transfer between the same UID.
    • Currently, the funding wallet only supports outgoing transfers in cryptocurrency, not in fiat currency.

    HTTP Request​

    POST /v5/asset/transfer/universal-transfer

    Request Parameters​

    ParameterRequiredTypeComments
    transferIdtruestringUUID. Please manually generate a UUID
    cointruestringCoin, uppercase only
    amounttruestringAmount
    fromMemberIdtrueintegerFrom UID
    toMemberIdtrueintegerTo UID
    fromAccountTypetruestringFrom account type
    toAccountTypetruestringTo account type

    Response Parameters​

    ParameterTypeComments
    transferIdstringUUID
    statusstringTransfer status
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

    • Request Example​

    POST /v5/asset/transfer/universal-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672189449697
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    {
        "transferId": "be7a2462-1138-4e27-80b1-62653f24925e",
        "coin": "ETH",
        "amount": "0.5",
        "fromMemberId": 592334,
        "toMemberId": 691355,
        "fromAccountType": "CONTRACT",
        "toAccountType": "UNIFIED"

    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "be7a2462-1138-4e27-80b1-62653f24925e",
            "status": "SUCCESS"
        },
        "retExtInfo": {},
        "time": 1672189450195
    }
    - + \ No newline at end of file diff --git a/v5/asset/withdraw.html b/v5/asset/withdraw.html index f551ee9306..beead1e9b2 100644 --- a/v5/asset/withdraw.html +++ b/v5/asset/withdraw.html @@ -4,13 +4,13 @@ Withdraw | Bybit API Documentation - +

    Withdraw

    Withdraw assets from your Bybit account. You can make an off-chain transfer if the target wallet address is from Bybit. This means that no blockchain fee will be charged.

    danger
    • UTA does not have SPOT account
    • How do I know if my account is a UTA account? Call this endpoint, and if uta=1, then it is a UTA account.
    caution
    • Make sure you have whitelisted your wallet address here
    • Can query by the master UID's api key only
    formula

    feeType=0:

    • withdrawPercentageFee != 0: handlingFee = inputAmount / (1 - withdrawPercentageFee) * withdrawPercentageFee + withdrawFee
    • withdrawPercentageFee = 0: handlingFee = withdrawFee

    feeType=1:

    • withdrawPercentageFee != 0: handlingFee = withdrawFee + (inputAmount - withdrawFee) * withdrawPercentageFee
    • withdrawPercentageFee = 0: handlingFee = withdrawFee

    HTTP Request​

    POST /v5/asset/withdraw/create

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin, uppercase only
    chainfalsestringChain
    • forceChain=0 or 1: this field is required
    • forceChain=2: this field can be null
    addresstruestring
    • forceChain=0 or 1: fill wallet address, and make sure you add address in the address book first. Please note that the address is case sensitive, so use the exact same address added in address book
    • forceChain=2: fill Bybit UID, and it can only be another Bybit main account UID. Make sure you add UID in the address book first
    tagfalsestringTag
    • Required if tag exists in the wallet address list.
    • Note: please do not set a tag/memo in the address book if the chain does not support tag
    amounttruestringWithdraw amount
    timestamptrueintegerCurrent timestamp (ms). Used for preventing from withdraw replay
    forceChainfalseintegerWhether or not to force an on-chain withdrawal
    • 0(default): If the address is parsed out to be an internal address, then internal transfer
    • 1: Force the withdrawal to occur on-chain
    • 2: Use UID to withdraw
    accountTypefalsestringSelect the wallet to be withdrawn from
    • SPOT：spot wallet (default)
    • FUND：Funding wallet
    feeTypefalseintegerHandling fee option
    • 0(default): input amount is the actual amount received, so you have to calculate handling fee manually
    • 1: input amount is not the actual amount you received, the system will help to deduct the handling fee automatically
    requestIdfalsestringCustomised ID, globally unique, it is used for idempotent verification
  • A combination of letters (case sensitive) and numbers, which can be pure letters or pure numbers and the length must be between 1 and 32 digits
    • beneficiaryfalseObjectTravel rule info, only required for kyc=KOR (korean) users
    > vaspEntityIdtruestringReceiver exchange entity Id. Please call this endpoint to get this ID
    > beneficiaryNamefalsestringReceiver exchange user KYC name, like John Wilson or Wilson John
  • Please refer to target exchange kyc name
  • When vaspEntityId="others", this field can be null

    • Response Parameters​

    ParameterTypeComments
    idstringWithdrawal ID

    Request Example​

    POST /v5/asset/withdraw/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672196570254
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    {
        "coin": "USDT",
        "chain": "ETH",
        "address": "0x99ced129603abc771c0dabe935c326ff6c86645d",
        "tag": null,
        "amount": "24",
        "timestamp": 1672196561407,
        "forceChain": 0,
        "accountType": "FUND"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "id": "10195"
        },
        "retExtInfo": {},
        "time": 1672196571239
    }
    - + \ No newline at end of file diff --git a/v5/asset/withdraw/cancel-withdraw.html b/v5/asset/withdraw/cancel-withdraw.html index 1874a68a5f..a05f8f44c4 100644 --- a/v5/asset/withdraw/cancel-withdraw.html +++ b/v5/asset/withdraw/cancel-withdraw.html @@ -4,13 +4,13 @@ Cancel Withdrawal | Bybit API Documentation - +

    Cancel Withdrawal

    Cancel the withdrawal

    caution

    Can query by the master UID's api key only

    HTTP Request​

    POST /v5/asset/withdraw/cancel

    Request Parameters​

    ParameterRequiredTypeComments
    idtruestringWithdrawal ID

    Response Parameters​

    ParameterTypeComments
    statusinteger0: fail. 1: success

    Request Example​

    POST /v5/asset/withdraw/cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672197227732
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    {
        "id": "10197"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "status": 1
        },
        "retExtInfo": {},
        "time": 1672197228408
    }
    - + \ No newline at end of file diff --git a/v5/asset/withdraw/vasp-list.html b/v5/asset/withdraw/vasp-list.html index a3ef4a8e65..18ad051ea4 100644 --- a/v5/asset/withdraw/vasp-list.html +++ b/v5/asset/withdraw/vasp-list.html @@ -4,13 +4,13 @@ Get Exchange Entity List | Bybit API Documentation - +

    Get Exchange Entity List

    This endpoint is particularly used for kyc=KOR users. When withdraw funds, you need to fill entity id.

    HTTP Request​

    GET /v5/asset/withdraw/vasp/list

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    vasparrayExchange entity info
    > vaspEntityIdstringReceiver platform id. When transfer to Upbit or other exchanges that not in the list, please use vaspEntityId='others'
    > vaspNamestringReceiver platform name

    Request Example​

    GET /v5/asset/withdraw/vasp/list HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1715067106163
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "vasp": [
                {
                    "vaspEntityId": "basic-finance",
                    "vaspName": "Basic-finance"
                },
                {
                    "vaspEntityId": "beeblock",
                    "vaspName": "Beeblock"
                },
                {
                    "vaspEntityId": "bithumb",
                    "vaspName": "bithumb"
                },
                {
                    "vaspEntityId": "cardo",
                    "vaspName": "cardo"
                },
                {
                    "vaspEntityId": "codevasp",
                    "vaspName": "codevasp"
                },
                {
                    "vaspEntityId": "codexchange-kor",
                    "vaspName": "CODExchange-kor"
                },
                {
                    "vaspEntityId": "coinone",
                    "vaspName": "coinone"
                },
                {
                    "vaspEntityId": "dummy",
                    "vaspName": "Dummy"
                },
                {
                    "vaspEntityId": "flata-exchange",
                    "vaspName": "flataexchange"
                },
                {
                    "vaspEntityId": "fobl",
                    "vaspName": "Foblgate"
                },
                {
                    "vaspEntityId": "hanbitco",
                    "vaspName": "hanbitco"
                },
                {
                    "vaspEntityId": "hexlant",
                    "vaspName": "hexlant"
                },
                {
                    "vaspEntityId": "inex",
                    "vaspName": "INEX"
                },
                {
                    "vaspEntityId": "infiniteblock-corp",
                    "vaspName": "InfiniteBlock Corp"
                },
                {
                    "vaspEntityId": "kdac",
                    "vaspName": "kdac"
                },
                {
                    "vaspEntityId": "korbit",
                    "vaspName": "korbit"
                },
                {
                    "vaspEntityId": "paycoin",
                    "vaspName": "Paycoin"
                },
                {
                    "vaspEntityId": "qbit",
                    "vaspName": "Qbit"
                },
                {
                    "vaspEntityId": "tennten",
                    "vaspName": "TENNTEN"
                },
                {
                    "vaspEntityId": "others",
                    "vaspName": "Others (including Upbit)"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1715067106537
    }
    - + \ No newline at end of file diff --git a/v5/asset/withdraw/withdraw-record.html b/v5/asset/withdraw/withdraw-record.html index 3825320e3b..1b86e16887 100644 --- a/v5/asset/withdraw/withdraw-record.html +++ b/v5/asset/withdraw/withdraw-record.html @@ -4,13 +4,13 @@ Get Withdrawal Records | Bybit API Documentation - +

    Get Withdrawal Records

    Query withdrawal records.

    tip
    • endTime - startTime should be less than 30 days. Query last 30 days records by default.
    • Can query by the master UID's api key only

    HTTP Request​

    GET /v5/asset/withdraw/query-record

    Request Parameters​

    ParameterRequiredTypeComments
    withdrawIDfalsestringWithdraw ID
    txIDfalsestringTransaction hash ID
    coinfalsestringCoin, uppercase only
    withdrawTypefalseintegerWithdraw type. 0(default): on chain. 1: off chain. 2: all
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > withdrawIdstringWithdraw ID
    > txIDstringTransaction ID. It returns "" when withdrawal failed, withdrawal cancelled
    > withdrawTypeintegerWithdraw type. 0: on chain. 1: off chain
    > coinstringCoin
    > chainstringChain
    > amountstringAmount
    > withdrawFeestringWithdraw fee
    > statusstringWithdraw status
    > toAddressstringTo withdrawal address. Shows the Bybit UID for internal transfers
    > tagstringTag
    > createTimestringWithdraw created timestamp (ms)
    > updateTimestringWithdraw updated timestamp (ms)
    nextPageCursorstringCursor. Used for pagination

    Request Example​

    GET /v5/asset/withdraw/query-record?coin=USDT&withdrawType=2&limit=2 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672194949557
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "77",
                    "txID": "",
                    "status": "SecurityCheck",
                    "toAddress": "0x99ced129603abc771c0dabe935c326ff6c86645d",
                    "tag": "",
                    "withdrawFee": "10",
                    "createTime": "1670922217000",
                    "updateTime": "1670922217000",
                    "withdrawId": "9976",
                    "withdrawType": 0
                },
                {
                    "coin": "USDT",
                    "chain": "internalAddressChain",
                    "amount": "20.1234",
                    "txID": "",
                    "status": "success",
                    "toAddress": "999805",
                    "tag": "",
                    "withdrawFee": "0",
                    "createTime": "1698889833000",
                    "updateTime": "1698889846000",
                    "withdrawId": "13310",
                    "withdrawType": 1
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6OTgwMSwibWF4SUQiOjk5NzZ9"
        },
        "retExtInfo": {},
        "time": 1672194949928
    }
    - + \ No newline at end of file diff --git a/v5/backup/set-pledge-token.html b/v5/backup/set-pledge-token.html index 56c7fed5bb..35e1e623ca 100644 --- a/v5/backup/set-pledge-token.html +++ b/v5/backup/set-pledge-token.html @@ -4,13 +4,13 @@ Set Pledge Token | Bybit API Documentation - +

    Set Pledge Token

    Set Pledge Token in cross margin

    HTTP Request​

    POST /v5/spot-margin-trade/set-pledge-token

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringcoin
    pledgeStatustureintpledge status. 1: on, 0: off

    Response Parameters​

    ParameterTypeComments
    pledgeStatusstringpledge status：1: on,0: off
    - + \ No newline at end of file diff --git a/v5/broker/account-info.html b/v5/broker/account-info.html index 5ac553dd05..484e526942 100644 --- a/v5/broker/account-info.html +++ b/v5/broker/account-info.html @@ -4,13 +4,13 @@ Get Exchange Broker Account Info | Bybit API Documentation - +

    Get Exchange Broker Account Info

    info
    • Use exchange broker master account to query

    API rate limit: 10 req / sec

    HTTP Request​

    GET /v5/broker/account-info

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    subAcctQtystringThe qty of sub account has been created
    maxSubAcctQtystringThe max limit of sub account can be created
    baseFeeRebateRateObjectRebate percentage of the base fee
    > spotstringRebate percentage of the base fee for spot, e.g., 10.00%
    > derivativesstringRebate percentage of the base fee for derivatives, e.g., 10.00%
    markupFeeRebateRateObjectRebate percentage of the mark up fee
    > spotstringRebate percentage of the mark up fee for spot, e.g., 10.00%
    > derivativesstringRebate percentage of the mark up fee for derivatives, e.g., 10.00%
    > convertstringRebate percentage of the mark up fee for convert, e.g., 10.00%
    tsstringSystem timestamp (ms)

    Request Example​

    GET /v5/broker/account-info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1701399431920
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "subAcctQty": "2",
            "maxSubAcctQty": "20",
            "baseFeeRebateRate": {
                "spot": "10.0%",
                "derivatives": "10.0%"
            },
            "markupFeeRebateRate": {
                "spot": "6.00%",
                "derivatives": "9.00%",
                "convert": "3.00%",
            },
            "ts": "1701395633402"
        },
        "retExtInfo": {},
        "time": 1701395633403
    }
    - + \ No newline at end of file diff --git a/v5/broker/exchange-earning.html b/v5/broker/exchange-earning.html index 6ae74e454b..2c84555a47 100644 --- a/v5/broker/exchange-earning.html +++ b/v5/broker/exchange-earning.html @@ -4,13 +4,13 @@ Get Exchange Broker Earning | Bybit API Documentation - +

    Get Exchange Broker Earning

    info
    • Use exchange broker master account to query
    • The data can support up to past 1 months until T-1. To extract data from over a month ago, please contact your Relationship Manager
    • begin & end are either entered at the same time or not entered, and latest 7 days data are returned by default

    API rate limit: 10 req / sec

    HTTP Request​

    GET /v5/broker/earnings-info

    Request Parameters​

    ParameterRequiredTypeComments
    bizTypefalsestringBusiness type. SPOT, DERIVATIVES, OPTIONS, CONVERT
    beginfalsestringBegin date, in the format of YYYYMMDD, e.g, 20231201, search the data from 1st Dec 2023 00:00:00 UTC (include)
    endfalsestringEnd date, in the format of YYYYMMDD, e.g, 20231201, search the data before 2nd Dec 2023 00:00:00 UTC (exclude)
    uidfalsestring
    • To get results for a specific sub-account: Enter the sub-account UID
    • To get results for all sub-accounts: Leave the field empty
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 1000
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    totalEarningCatObjectCategory statistics for total earning data
    > spotarrayObject. Earning for Spot trading. If do not have any rebate, keep empty array
    >> coinstringRebate coin name
    >> earningstringRebate amount of the coin
    > derivativesarrayObject. Earning for Derivatives trading. If do not have any rebate, keep empty array
    >> coinstringRebate coin name
    >> earningstringRebate amount of the coin
    > optionsarrayObject. Earning for Option trading. If do not have any rebate, keep empty array
    >> coinstringRebate coin name
    >> earningstringRebate amount of the coin
    > convertarrayObject. Earning for Convert trading. If do not have any rebate, keep empty array
    >> coinstringRebate coin name
    >> earningstringRebate amount of the coin
    > totalarrayObject. Sum earnings of all categories. If do not have any rebate, keep empty array
    >> coinstringRebate coin name
    >> earningstringRebate amount of the coin
    detailsarrayObject. Detailed trading information for each sub UID and each category
    > userIdstringSub UID
    > bizTypestringBusiness type. SPOT, DERIVATIVES, OPTIONS, CONVERT
    > symbolstringSymbol name
    > coinstringRebate coin name
    > earningstringRebate amount
    > markupEarningstringEarning generated from markup fee rate
    > baseFeeEarningstringEarning generated from base fee rate
    > orderIdstringOrder ID
    > execTimestringOrder execution timestamp (ms)
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/broker/earnings-info?begin=20231129&end=20231129&uid=117894077 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1701399431920
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: 32d2aa1bc205ddfb89849b85e2a8b7e23b1f8f69fe95d6f2cb9c87562f9086a6
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "totalEarningCat": {
                "spot": [],
                "derivatives": [
                    {
                        "coin": "USDT",
                        "earning": "0.00027844"
                    }
                ],
                "options": [],
                "total": [
                    {
                        "coin": "USDT",
                        "earning": "0.00027844"
                    }
                ]
            },
            "details": [
                {
                    "userId": "117894077",
                    "bizType": "DERIVATIVES",
                    "symbol": "DOGEUSDT",
                    "coin": "USDT",
                    "earning": "0.00016166",
                    "markupEarning": "0.000032332",
                    "baseFeeEarning": "0.000129328",
                    "orderId": "ec2132f2-a7e0-4a0c-9219-9f3cbcd8e878",
                    "execTime": "1701275846033"
                },
                {
                    "userId": "117894077",
                    "bizType": "DERIVATIVES",
                    "symbol": "TRXUSDT",
                    "coin": "USDT",
                    "earning": "0.00011678",
                    "markupEarning": "0.000023356",
                    "baseFeeEarning": "0.000093424",
                    "orderId": "28b29c2b-ba14-450e-9ce7-3cee0c1fa6da",
                    "execTime": "1701245285017"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1701398193964
    }
    - + \ No newline at end of file diff --git a/v5/broker/sub-deposit-record.html b/v5/broker/sub-deposit-record.html index 5ef3e86865..2903ed0563 100644 --- a/v5/broker/sub-deposit-record.html +++ b/v5/broker/sub-deposit-record.html @@ -4,13 +4,13 @@ Get Sub Account Deposit Records | Bybit API Documentation - +

    Get Sub Account Deposit Records

    Exchange broker can query subaccount's deposit records by main UID's API key without specifying uid.

    API rate limit: 300 req / min

    tip

    endTime - startTime should be less than 30 days. Queries for the last 30 days worth of records by default.

    HTTP Request​

    GET /v5/broker/asset/query-sub-member-deposit-record

    Request Parameters​

    ParameterRequiredTypeComments
    subMemberIdfalsestringSub UID
    coinfalsestringCoin, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    rowsarrayObject
    > subMemberIdstringSub account user ID
    > coinstringCoin
    > chainstringChain
    > amountstringAmount
    > txIDstringTransaction ID
    > statusintegerDeposit status
    > toAddressstringDeposit target address
    > tagstringTag of deposit target address
    > depositFeestringDeposit fee
    > successAtstringLast updated time
    > confirmationsstringNumber of confirmation blocks
    > txIndexstringTransaction sequence number
    > blockHashstringHash number on the chain
    > batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit
    > depositTypestringThe deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/broker/asset/query-sub-member-deposit-record?coin=USDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672192441294
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1672192441742
    }
    - + \ No newline at end of file diff --git a/v5/copytrade.html b/v5/copytrade.html index abd6ac02e8..be502860c5 100644 --- a/v5/copytrade.html +++ b/v5/copytrade.html @@ -4,14 +4,14 @@ How To Start Copy Trading | Bybit API Documentation - +

    How To Start Copy Trading

    Become A Master Trader​

    Please go here to apply to become a Master Trader

    Create The API KEY​

    "Contract - Orders & Positions" are mandatory permissions for Copy Trading orders

    Understand The Scope​

    From time being, classic account and unified account both support Copy Trading, but can only trade USDT Perpetual symbols. Please check the field copyTrading from Get Instruments Info

    Place The Copy Trading Order​

    Use V5 Place Order endpoint to place a Copy Trading order

    POST /v5/order/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1698376189371
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 207

    {
        "symbol": "BTCUSDT",
        "side": "Buy",
        "orderType": "Limit",
        "category": "linear",
        "qty": "0.1",
        "price": "29000",
        "timeInForce": "GTC",
        "positionIdx": 1
    }
    - + \ No newline at end of file diff --git a/v5/demo.html b/v5/demo.html index fc1a8463de..1a97fa5bc5 100644 --- a/v5/demo.html +++ b/v5/demo.html @@ -4,7 +4,7 @@ Demo Trading Service | Bybit API Documentation - + @@ -13,7 +13,7 @@ mainly for trading experience purpose, so that it does not have a complete function compared with the real trading service.

    Create API Key​

    1. You need to log in to your mainnet account;
    2. Switch to Demo Trading, please note it is an independent account for demo trading only, and it has its own user ID;
    3. Hover the mouse on user avatar, then click "API" to generate api key and secret;

    Usage rules​

    • Basic trading rules are the same as real trading
    • Orders generated in demo trading keep 7 days
    • Default rate limit, not upgradable

    Domain​

    Mainnet Demo Trading URL:
    Rest API: https://api-demo.bybit.com
    Websocket : wss://stream-demo.bybit.com

    Tips​

    • Please note that demo trading is an isolated module. When you create the key from demo trading, please use above domain to connect.
    • By the way, it is meaningless to use demo trading service in the testnet website, so do not create a key from Testnet demo trading.

    Available API List​

    CateogoryTitleEndpoint
    MarketAllall endpoints
    TradePlace Order/v5/order/create
    Amend Order/v5/order/amend
    Cancel order/v5/order/cancel
    Get Open Orders/v5/order/realtime
    Cancel All Orders/v5/order/cancel-all
    Get Order History/v5/order/history
    Get Trade History/v5/execution/list
    Batch Place Order/v5/order/create-batch (linear,option)
    Batch Amend Order/v5/order/amend-batch (linear,option)
    Batch Cancel Order/v5/order/cancel-batch (linear,option)
    PositionGet Position Info/v5/position/list
    Set Leverage/v5/position/set-leverage
    Switch Position Mode/v5/position/switch-mode
    Set Trading Stop/v5/position/trading-stop
    Set Auto Add Margin/v5/position/set-auto-add-margin
    Add Or Reduce Margin/v5/position/add-margin
    Get Closed PnL/v5/position/closed-pnl
    AccountGet Wallet Balance/v5/account/wallet-balance
    Get Borrow History/v5/account/borrow-history
    Set Collateral Coin/v5/account/set-collateral-switch
    Get Collateral Info/v5/account/collateral-info
    Get Coin Greeks/v5/asset/coin-greeks
    Get Account Info/v5/account/info
    Get Transaction Log/v5/account/transaction-log
    Set Margin Mode/v5/account/set-margin-mode
    Set Spot Hedging/v5/account/set-hedging-mode
    AssetGet Delivery Record/v5/asset/delivery-record
    Get USDC Session Settlement/v5/asset/settlement-record
    Spot Margin TradeToggle Margin Trade/v5/spot-margin-trade/switch-mode
    Set Leverage/v5/spot-margin-trade/set-leverage
    Get Status And Leverage/v5/spot-margin-uta/status
    WS Privateorder,execution,position,wallet,greeks/v5/private

    Request Demo Trading Funds​

    API rate limit: 1 req per minute

    HTTP Request​

    POST /v5/account/demo-apply-money

    Request Parameters​

    ParameterRequiredTypeComments
    adjustTypefalseinteger0(default): add demo funds; 1: reduce demo funds
    utaDemoApplyMoneyfalsearray
    > coinfalsestringApplied coin, supports BTC, ETH, USDT, USDC
    > amountStrfalsestringApplied amount, the max applied amount in each request
  • BTC: "15"
  • ETH: "200"
  • USDT: "100000"
  • USDC: "100000"

    • Request Example​

    POST /v5/account/demo-apply-money HTTP/1.1
    Host: api-demo.bybit.com
    X-BAPI-SIGN: XXXXXXX
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1711420489915
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "adjustType": 0,
        "utaDemoApplyMoney": [
            {
                "coin": "USDT",
                "amountStr": "109"
            },
            {
                "coin": "ETH",
                "amountStr": "1"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/enum.html b/v5/enum.html index 7871d1a5e8..84210bcd5d 100644 --- a/v5/enum.html +++ b/v5/enum.html @@ -4,7 +4,7 @@ Enums Definitions | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Enums Definitions

    locale​

    • de-DE
    • en-US
    • es-AR
    • es-ES
    • es-MX
    • fr-FR
    • kk-KZ
    • id-ID
    • uk-UA
    • ja-JP
    • ru-RU
    • th-TH
    • pt-BR
    • tr-TR
    • vi-VN
    • zh-TW
    • ar-SA
    • hi-IN
    • fil-PH

    announcementType​

    • new_crypto
    • latest_bybit_news
    • delistings
    • latest_activities
    • product_updates
    • maintenance_updates
    • new_fiat_listings
    • other

    announcementTag​

    • Spot
    • Derivatives
    • Spot Listings
    • BTC
    • ETH
    • Trading Bots
    • USDC
    • Leveraged Tokens
    • USDT
    • Margin Trading
    • Partnerships
    • Launchpad
    • Upgrades
    • ByVotes
    • Delistings
    • VIP
    • Futures
    • Institutions
    • Options
    • WEB3
    • Copy Trading
    • Earn
    • Bybit Savings
    • Dual Asset
    • Liquidity Mining
    • Shark Fin
    • Launchpool
    • NFT GrabPic
    • Buy Crypto
    • P2P Trading
    • Fiat Deposit
    • Crypto Deposit
    • Спот
    • Спот лістинги
    • Торгові боти
    • Токени з кредитним плечем
    • Маржинальна торгівля
    • Партнерство
    • Оновлення
    • Делістинги
    • Ф'ючерси
    • Опціони
    • Копітрейдинг
    • Bybit Накопичення
    • Бівалютні інвестиції
    • Майнінг ліквідності
    • Купівля криптовалюти
    • P2P торгівля
    • Фіатні депозити
    • Криптодепозити
    • Копитрейдинг
    • Торговые боты
    • Деривативы
    • P2P
    • Спот листинги
    • Деривативи
    • MT4
    • Lucky Draw
    • Unified Trading Account
    • Єдиний торговий акаунт
    • Единый торговый аккаунт
    • Институциональный трейдинг
    • Інституціональний трейдинг
    • Делистинг

    category​

    Unified Account

    • spot
    • linear USDT perpetual, and USDC contract, including USDC perp, USDC futures
    • inverse Inverse contract, including Inverse perp, Inverse futures
    • option

    Classic Account

    • linear USDT perp
    • inverse Inverse contract, including Inverse perp, Inverse futures
    • spot

    orderStatus​

    open status

    • New order has been placed successfully
    • PartiallyFilled
    • Untriggered Conditional orders are created

    closed status

    • Rejected
    • PartiallyFilledCanceled Only spot has this order status
    • Filled
    • Cancelled In derivatives, orders with this status may have an executed qty
    • Triggered instantaneous state for conditional orders from Untriggered to New
    • Deactivated UTA: Spot tp/sl order, conditional order, OCO order are cancelled before they are triggered

    timeInForce​

    • GTC GoodTillCancel
    • IOC ImmediateOrCancel
    • FOK FillOrKill
    • PostOnly

    createType​

    • CreateByUser
    • CreateByAdminClosing
    • CreateBySettle USDC Futures delivery; Position closed by contract delisted
    • CreateByStopOrder Futures conditional order
    • CreateByTakeProfit Futures take profit order
    • CreateByPartialTakeProfit Futures partial take profit order
    • CreateByStopLoss Futures stop loss order
    • CreateByPartialStopLoss Futures partial stop loss order
    • CreateByTrailingStop Futures trailing stop order
    • CreateByLiq Laddered liquidation to reduce the required maintenance margin
    • CreateByTakeOver_PassThroughIf the position is still subject to liquidation (i.e., does not meet the required maintenance margin level), the position shall be taken over by the liquidation engine and closed at the bankruptcy price.
    • CreateByAdl_PassThrough Auto-Deleveraging(ADL)
    • CreateByBlock_PassThrough Order placed via Paradigm
    • CreateByBlockTradeMovePosition_PassThrough Order created by move position
    • CreateByClosing The close order placed via web or app position area - web/app
    • CreateByFGridBot Order created via grid bot - web/app
    • CloseByFGridBot Order closed via grid bot - web/app
    • CreateByTWAP Order created by TWAP - web/app
    • CreateByTVSignal Order created by TV webhook - web/app
    • CreateByMmRateClose Order created by Mm rate close function - web/app
    • CreateByMartingaleBot Order created by Martingale bot - web/app
    • CloseByMartingaleBot Order closed by Martingale bot - web/app
    • CreateByIceBerg Order created by Ice berg strategy - web/app
    • CreateByArbitrage Order created by arbitrage - web/app
    • CreateByDdh Option dynamic delta hedge order - web/app

    execType​

    • Trade
    • AdlTrade Auto-Deleveraging
    • Funding Funding fee
    • BustTrade Takeover liquidation
    • Delivery USDC futures delivery; Position closed by contract delisted
    • Settle Inverse futures settlement; Position closed due to delisting
    • BlockTrade
    • MovePosition
    • UNKNOWN May be returned by a classic account. Cannot query by this type

    orderType​

    • Market
    • Limit
    • UNKNOWN is not a valid request parameter value. Is only used in some responses. Mainly, it is used when execType is Funding.

    stopOrderType​

    • TakeProfit
    • StopLoss
    • TrailingStop
    • Stop
    • PartialTakeProfit
    • PartialStopLoss
    • tpslOrder spot TP/SL order
    • OcoOrder spot Oco order
    • MmRateClose On web or app can set MMR to close position
    • BidirectionalTpslOrder Spot bidirectional tpsl order

    tickDirection​

    • PlusTick price rise
    • ZeroPlusTick trade occurs at the same price as the previous trade, which occurred at a price higher than that for the trade preceding it
    • MinusTick price drop
    • ZeroMinusTick trade occurs at the same price as the previous trade, which occurred at a price lower than that for the trade preceding it

    interval​

    • 1 3 5 15 30 60 120 240 360 720 minute
    • D day
    • W week
    • M month

    intervalTime​

    • 5min 15min 30min minute
    • 1h 4h hour
    • 1d day

    positionIdx​

    • 0 one-way mode position
    • 1 Buy side of hedge-mode position
    • 2 Sell side of hedge-mode position

    positionStatus​

    • Normal
    • Liq in the liquidation progress
    • Adl in the auto-deleverage progress

    rejectReason​

    • EC_NoError
    • EC_Others
    • EC_UnknownMessageType
    • EC_MissingClOrdID
    • EC_MissingOrigClOrdID
    • EC_ClOrdIDOrigClOrdIDAreTheSame
    • EC_DuplicatedClOrdID
    • EC_OrigClOrdIDDoesNotExist
    • EC_TooLateToCancel
    • EC_UnknownOrderType
    • EC_UnknownSide
    • EC_UnknownTimeInForce
    • EC_WronglyRouted
    • EC_MarketOrderPriceIsNotZero
    • EC_LimitOrderInvalidPrice
    • EC_NoEnoughQtyToFill
    • EC_NoImmediateQtyToFill
    • EC_PerCancelRequest
    • EC_MarketOrderCannotBePostOnly
    • EC_PostOnlyWillTakeLiquidity
    • EC_CancelReplaceOrder
    • EC_InvalidSymbolStatus
    • EC_CancelForNoFullFill
    • EC_BySelfMatch
    • EC_InCallAuctionStatus used for pre-market order operation, e.g., during 2nd phase of call auction, cancel order is not allowed, when the cancel request is failed to be rejected by trading server, the request will be rejected by matching box finally

    accountType​

    Check the value of unifiedMarginStatus to see if you're on the Unified Trading Account or the classic account.

    Unified Trading Account (UTA)​

    • CONTRACT Inverse Derivatives Account (no UDST in this wallet))
    • UNIFIED Unified Trading Account
    • FUND Funding Account

    Classic account​

    Also known as the "standard account".

    • SPOT Spot Account
    • CONTRACT Derivatives Account (contain USDT in this wallet)
    • OPTION USDC Derivatives (this service is now offline)
    • FUND Funding Account
    • INVESTMENT ByFi Account (this service is now offline)

    transferStatus​

    • SUCCESS
    • PENDING
    • FAILED

    depositStatus​

    • 0 unknown
    • 1 toBeConfirmed
    • 2 processing
    • 3 success (finalised status of a success deposit)
    • 4 deposit failed
    • 10011 pending to be credited to funding pool
    • 10012 Credited to funding pool successfully

    withdrawStatus​

    • SecurityCheck
    • Pending
    • success
    • CancelByUser
    • Reject
    • Fail
    • BlockchainConfirmed
    • MoreInformationRequired
    • Unknown a rare status

    triggerBy​

    • LastPrice
    • IndexPrice
    • MarkPrice

    cancelType​

    • CancelByUser
    • CancelByReduceOnly cancelled by reduceOnly
    • CancelByPrepareLiq CancelAllBeforeLiq cancelled in order to attempt liquidation prevention by freeing up margin
    • CancelByPrepareAdl CancelAllBeforeAdl cancelled due to ADL
    • CancelByAdmin
    • CancelBySettle cancelled due to delisting contract
    • CancelByTpSlTsClear TP/SL order cancelled when the position is cleared
    • CancelBySmp cancelled by SMP

    Options:

    • CancelByUser
    • CancelByReduceOnly
    • CancelAllBeforeLiq cancelled due to liquidation
    • CancelAllBeforeAdl cancelled due to ADL
    • CancelBySettle
    • CancelByCannotAffordOrderCost
    • CancelByPmTrialMmOverEquity
    • CancelByAccountBlocking
    • CancelByDelivery
    • CancelByMmpTriggered
    • CancelByCrossSelfMuch
    • CancelByCrossReachMaxTradeNum
    • CancelByDCP
    • CancelBySmp

    optionPeriod​

    • BTC: 7,14,21,30,60,90,180,270days
    • ETH: 7,14,21,30,60,90,180,270days
    • SOL: 7,14,21,30,60,90days

    dataRecordingPeriod​

    • 5min 15min 30min minute
    • 1h 4h hour
    • 4d day

    contractType​

    • InversePerpetual
    • LinearPerpetual
    • LinearFutures USDC Futures
    • InverseFutures

    status​

    • PreLaunch
    • Trading
    • Delivering
    • Closed

    curAuctionPhase​

    • NotStarted Pre-market trading is not started
    • Finished Pre-market trading is finished
      • After the auction, if the pre-market contract fails to enter continues trading phase, it will be delisted and phase="Finished"
      • After the continuous trading, if the pre-market contract fails to be converted to official contract, it will be delisted and phase="Finished"
    • CallAuction Auction phase of pre-market trading
      • only timeInForce=GTC, orderType=Limit order is allowed to submit
      • TP/SL are not supported; Conditional orders are not supported
      • cannot modify the order at this stage
      • order price range: [preOpenPrice x 0.5, maxPrice]
    • CallAuctionNoCancel Auction no cancel phase of pre-market trading
      • only timeInForce=GTC, orderType=Limit order is allowed to submit
      • TP/SL are not supported; Conditional orders are not supported
      • cannot modify and cancel the order at this stage
      • order price range: Buy [lastPrice x 0.5, markPrice x 1.1], Sell [markPrice x 0.9, maxPrice]
    • CrossMatching cross matching phase
      • cannot create, modify and cancel the order at this stage
      • Candle data is released from this stage
    • ContinuousTrading Continuous trading phase
      • There is no restriction to create, amend, cancel orders
      • orderbook, public trade data is released from this stage

    marginTrading​

    • none Regardless of normal account or UTA account, this trading pair does not support margin trading
    • both For both normal account and UTA account, this trading pair supports margin trading
    • utaOnly Only for UTA account,this trading pair supports margin trading
    • normalSpotOnly Only for normal account, this trading pair supports margin trading

    copyTrading​

    • none Regardless of normal account or UTA account, this trading pair does not support copy trading
    • both For both normal account and UTA account, this trading pair supports copy trading
    • utaOnly Only for UTA account,this trading pair supports copy trading
    • normalOnly Only for normal account, this trading pair supports copy trading

    type(uta-translog)​

    • TRANSFER_IN Assets that transferred into Unified wallet
    • TRANSFER_OUT Assets that transferred out from Unified wallet
    • TRADE
    • SETTLEMENT USDT Perp funding settlement, and USDC Perp funding settlement + USDC 8-hour session settlement
    • DELIVERY USDC Futures, Option delivery
    • LIQUIDATION
    • ADL Auto-Deleveraging
    • AIRDROP
    • BONUS Bonus claimed
    • BONUS_RECOLLECT Bonus expired
    • FEE_REFUND Trading fee refunded
    • INTEREST Interest occurred due to borrowing
    • CURRENCY_BUY Currency convert, and the liquidation for borrowing asset(UTA loan)
    • CURRENCY_SELL Currency convert, and the liquidation for borrowing asset(UTA loan)
    • BORROWED_AMOUNT_INS_LOAN
    • PRINCIPLE_REPAYMENT_INS_LOAN
    • INTEREST_REPAYMENT_INS_LOAN
    • AUTO_SOLD_COLLATERAL_INS_LOAN the liquidation for borrowing asset(INS loan)
    • AUTO_BUY_LIABILITY_INS_LOAN the liquidation for borrowing asset(INS loan)
    • AUTO_PRINCIPLE_REPAYMENT_INS_LOAN
    • AUTO_INTEREST_REPAYMENT_INS_LOAN
    • TRANSFER_IN_INS_LOAN Transfer In when in the liquidation of OTC loan
    • TRANSFER_OUT_INS_LOAN Transfer Out when in the liquidation of OTC loan
    • SPOT_REPAYMENT_SELL One-click repayment currency sell
    • SPOT_REPAYMENT_BUY One-click repayment currency buy
    • TOKENS_SUBSCRIPTION Spot leverage token subscription
    • TOKENS_REDEMPTION Spot leverage token redemption
    • AUTO_DEDUCTION Asset auto deducted by system (roll back)
    • FLEXIBLE_STAKING_SUBSCRIPTION Byfi flexible stake subscription
    • FLEXIBLE_STAKING_REDEMPTION Byfi flexible stake redemption
    • FIXED_STAKING_SUBSCRIPTION Byfi fixed stake subscription
    • PREMARKET_TRANSFER_OUT
    • PREMARKET_DELIVERY_SELL_NEW_COIN
    • PREMARKET_DELIVERY_BUY_NEW_COIN
    • PREMARKET_DELIVERY_PLEDGE_PAY_SELLER
    • PREMARKET_DELIVERY_PLEDGE_BACK
    • PREMARKET_ROLLBACK_PLEDGE_BACK
    • PREMARKET_ROLLBACK_PLEDGE_PENALTY_TO_BUYER
    • CUSTODY_NETWORK_FEE fireblocks business
    • CUSTODY_SETTLE_FEE fireblocks business
    • CUSTODY_LOCK fireblocks / copper business
    • CUSTODY_UNLOCK fireblocks business
    • CUSTODY_UNLOCK_REFUND fireblocks business
    • LOANS_BORROW_FUNDS crypto loan
    • LOANS_PLEDGE_ASSET crypto loan repayment

    type(contract-translog)​

    • TRANSFER_IN Assets that transferred into (inverse) derivatives wallet
    • TRANSFER_OUT Assets that transferred out from (inverse) derivatives wallet
    • TRADE
    • SETTLEMENT USDT / Inverse Perp funding settlement
    • DELIVERY Inverse Futures delivery
    • LIQUIDATION
    • ADL Auto-Deleveraging
    • AIRDROP
    • BONUS Bonus claimed
    • BONUS_RECOLLECT Bonus expired
    • FEE_REFUND Trading fee refunded
    • CURRENCY_BUY Currency convert
    • CURRENCY_SELL Currency convert
    • AUTO_DEDUCTION Asset auto deducted by system (roll back)
    • Others

    unifiedMarginStatus​

    • 1 Regular account
    • 2 Please ignore
    • 3 Unified trade account, it can trade linear perpetual, options and spot
    • 4 UTA Pro, the pro version of Unified trade account

    ltStatus​

    • 1 LT can be purchased and redeemed
    • 2 LT can be purchased, but not redeemed
    • 3 LT can be redeemed, but not purchased
    • 4 LT cannot be purchased nor redeemed
    • 5 Adjusting position

    convertAccountType​

    Check the value of unifiedMarginStatus to see if you're on the Unified Trading Account or the classic account.

    Unified Trading Account (UTA)​

    • eb_convert_inverse Inverse Derivatives Account (no USDT in this wallet))
    • eb_convert_uta Unified Trading Account
    • eb_convert_funding Funding Account

    Classic account​

    Also known as the "standard account"

    • eb_convert_spot Spot Account
    • eb_convert_contract Derivatives Account (contain USDT in this wallet)
    • eb_convert_funding Funding Account

    symbol​

    USDT Perpetual:

    • BTCUSDT
    • ETHUSDT

    USDC Perpetual:

    • BTCPERP
    • ETHPERP

    USDC Futures:

    • BTC-24MAR23

    Inverse Perpetual:

    • BTCUSD
    • ETHUSD

    Inverse Futures:

    • BTCUSDH23 H: First quarter; 23: 2023
    • BTCUSDM23 M: Second quarter; 23: 2023
    • BTCUSDU23 U: Third quarter; 23: 2023
    • BTCUSDZ23 Z: Fourth quarter; 23: 2023

    Spot:

    • BTCUSDT
    • ETHUSDC

    vipLevel​

    • No VIP
    • VIP-1
    • VIP-2
    • VIP-3
    • VIP-4
    • VIP-5
    • VIP-Supreme
    • PRO-1
    • PRO-2
    • PRO-3
    • PRO-4
    • PRO-5

    adlRankIndicator​

    • 0 default value of empty position
    • 1
    • 2
    • 3
    • 4
    • 5

    smpType​

    • default: None
    • CancelMaker
    • CancelTaker
    • CancelBoth

    Spot Fee Currency Instruction​

    with the example of BTCUSDT:

    • Is makerFeeRate positive?
      - TRUE
          - Side = Buy -> base currency (BTC)
          - Side = Sell -> quote currency (USDT)
      - FALSE
          - IsMakerOrder = TRUE
              - Side = Buy -> quote currency (USDT)
              - Side = Sell -> base currency (BTC)
          - IsMakerOrder = FALSE
              - Side = Buy -> base currency (BTC)
              - Side = Sell -> quote currency (USDT)
      e currency (USDT) T) e currency (USDT)
    - + \ No newline at end of file diff --git a/v5/error.html b/v5/error.html index 34f4281197..6edd43ff87 100644 --- a/v5/error.html +++ b/v5/error.html @@ -4,13 +4,13 @@ Error Codes | Bybit API Documentation - +

    Error Codes

    HTTP Code​

    CodeDescription
    400Bad request. Need to send the request with GET / POST (must be capitalized)
    401Invalid request. 1. Need to use the correct key to access; 2. Need to put authentication params in the request header
    403Forbidden request. Possible causes: 1. IP rate limit breached; 2. You send GET request with an empty json body; 3. You are using U.S IP
    404Cannot find path. Possible causes: 1. Wrong path; 2. Category value does not match account mode
    429System level frequency protection. Please retry when encounter this

    WS OE General code​

    CodeDescription
    104041. op type is not found; 2. category is not correct/supported
    10429System level frequency protection
    20006reqId is duplicated
    100161. internal server error; 2. Service is restarting
    10019ws trade service is restarting, do not accept new request, but the request in the process is not affected. You can build new connection to be routed to normal service
    10003Too many sessions under the same UID

    UTA & Classic account​

    CodeDescription
    0OK
    10000Server Timeout
    10001Request parameter error
    10002The request time exceeds the time window range.
    10003API key is invalid. Check whether the key and domain are matched, there are 4 env: mainnet, testnet, mainnet-demo, testnet-demo
    33004Your api key has expired
    10004Error sign, please check your signature generation algorithm.
    10005Permission denied, please check your API key permissions.
    10006Too many visits. Exceeded the API Rate Limit.
    10007User authentication failed.
    10008Common banned, please check your account mode
    10009IP has been banned.
    10010Unmatched IP, please check your API key's bound IP addresses.
    10014Invalid duplicate request.
    10016Server error.
    10017Route not found.
    10018Exceeded the IP Rate Limit.
    10024Compliance rules triggered
    10027Transactions are banned.
    10029The requested symbol is invalid, please check symbol whitelist
    10028The API can only be accessed by unified account users.
    30133OTC loan: The symbol you select for USDT Perpetual is not allowed by Institutional Lending
    30134OTC loan: The symbol you select for USDC Contract is not allowed by Institutional Lending
    30135The leverage you select for USDT Perpetual trading cannot exceed the maximum leverage allowed by Institutional Lending.
    30136The leverage you select for USDC Perpetual or Futures trading cannot exceed the maximum leverage allowed by Institutional Lending.
    40004the order is modified during the process of replacing , please check the order status again
    100028The API cannot be accessed by unified account users.
    110001Order does not exist
    110003Order price exceeds the allowable range.
    110004Wallet balance is insufficient
    110005position status
    110006The assets are estimated to be unable to cover the position margin
    110007Available balance is insufficient
    110008The order has been completed or cancelled.
    110009The number of stop orders exceeds the maximum allowable limit. You can find references in our API doc.
    110010The order has been cancelled
    110011Liquidation will be triggered immediately by this adjustment
    110012Insufficient available balance.
    110013Cannot set leverage due to risk limit level.
    110014Insufficient available balance to add additional margin.
    110015The position is in cross margin mode.
    110016The quantity of contracts requested exceeds the risk limit, please adjust your risk limit level before trying again
    110017Reduce-only rule not satisfied
    110018User ID is illegal.
    110019Order ID is illegal.
    110020Not allowed to have more than 500 active orders.
    110021Not allowed to exceeded position limits due to Open Interest.
    110022Quantity has been restricted and orders cannot be modified to increase the quantity.
    110023Currently you can only reduce your position on this contract. please check our announcement or contact customer service for details.
    110024You have an existing position, so the position mode cannot be switched.
    110025Position mode has not been modified.
    110026Cross/isolated margin mode has not been modified.
    110027Margin has not been modified.
    110028You have existing open orders, so the position mode cannot be switched.
    110029Hedge mode is not supported for this symbol.
    110030Duplicate orderId
    110031Non-existing risk limit info, please check the risk limit rules.
    110032Order is illegal
    110033You can't set margin without an open position
    110034There is no net position
    110035Cancellation of orders was not completed before liquidation
    110036You are not allowed to change leverage due to cross margin mode.
    110037User setting list does not have this symbol
    110038You are not allowed to change leverage due to portfolio margin mode.
    110039Maintenance margin rate is too high. This may trigger liquidation.
    110040The order will trigger a forced liquidation, please re-submit the order.
    110041Skip liquidation is not allowed when a position or maker order exists
    110042Currently,due to pre-delivery status, you can only reduce your position on this contract.
    110043Set leverage has not been modified.
    110044Available margin is insufficient.
    110045Wallet balance is insufficient.
    110046Liquidation will be triggered immediately by this adjustment.
    110047Risk limit cannot be adjusted due to insufficient available margin.
    110048Risk limit cannot be adjusted as the current/expected position value exceeds the revised risk limit.
    110049Tick notes can only be numbers
    110050Invalid coin
    110051The user's available balance cannot cover the lowest price of the current market
    110052Your available balance is insufficient to set the price
    110053The user's available balance cannot cover the current market price and upper limit price
    110054This position has at least one take profit link order, so the take profit and stop loss mode cannot be switched
    110055This position has at least one stop loss link order, so the take profit and stop loss mode cannot be switched
    110056This position has at least one trailing stop link order, so the take profit and stop loss mode cannot be switched
    110057Conditional order or limit order contains TP/SL related params
    110058You can't set take profit and stop loss due to insufficient size of remaining position size.
    110059Not allowed to modify the TP/SL of a partially filled open order
    110060Under full TP/SL mode, it is not allowed to modify TP/SL
    110061Not allowed to have more than 20 TP/SLs under Partial tpSlMode
    110062There is no MMP information of the institution found.
    110063Settlement in progress! {{key0}} not available for trading.
    110064The modified contract quantity cannot be less than or equal to the filled quantity.
    110065MMP hasn't yet been enabled for your account. Please contact your BD manager.
    110066Trading is currently not allowed.
    110067Unified account is not supported.
    110068Leveraged trading is not allowed.
    110069Ins lending customer is not allowed to trade.
    110070ETP symbols cannot be traded.
    110071Sorry, we're revamping the Unified Margin Account! Currently, new upgrades are not supported. If you have any questions, please contact our 24/7 customer support.
    110072OrderLinkedID is duplicate
    110073Set margin mode failed
    110075RiskId not modified
    110075 182021Cannot enable spot margin while in isolated margin mode. Please switch to cross margin mode or portfolio margin mode to trade spot with margin.
    110076Only isolated mode can set auto-add-margin
    110077Pm mode cannot support
    110078Added margin more than max can reduce margin
    110079The order is processing and can not be operated, please try again later
    110080Operations Restriction: The current LTV ratio of your Institutional Lending has hit the liquidation threshold. Assets in your account are being liquidated (trade/risk limit/leverage)
    110082You cannot lift Reduce-Only restrictions, as no Reduce-Only restrictions are applied to your position
    110083Reduce-Only restrictions must be lifted for both Long and Short positions at the same time
    110085The risk limit and margin ratio for this contract has been updated, please select a supported risk limit and place your order again
    110086Current order leverage exceeds the maximum available for your current Risk Limit tier. Please lower leverage before placing an order
    110087Leverage for Perpetual or Futures contracts cannot exceed the maximum allowed for your Institutional loan
    110088Please Upgrade to UTA to trade
    110089Exceeds the maximum risk limit level
    110090Exceeds the maximum leverage limit of the current risk limit level.
    110092expect Rising, but trigger_price[XXXXX] <= current[XXXXX]??laste
    110093expect Falling, but trigger_price[XXXXX] >= current[XXXXX]??last
    110094Order notional value below the lower limit
    110095You cannot create, modify or cancel Pre-Market Perpetual orders during the Call Auction.
    110096Pre-Market Perpetual Trading does not support Portfolio Margin mode.
    110097Non-UTA users cannot access Pre-Market Perpetual Trading. To place, modify or cancel Pre-Market Perpetual orders, please upgrade your Standard Account to UTA.
    110098Only Good-Till-Canceled (GTC) orders are supported during Call Auction.
    110099You cannot create TP/SL orders during the Call Auction for Pre-Market Perpetuals.
    110100You cannot place, modify, or cancel Pre-Market Perpetual orders when you are in Demo Trading.
    181017OrderStatus must be final status
    182100Compulsory closing of positions, no repayment allowed
    182101Failed repayment, insufficient collateral balance
    182102Failed repayment, there are no liabilities in the current currency
    182103Institutional lending users are not supported
    182108Switching failed, margin verification failed, please re-adjust the currency status
    182110Failed to switch
    182111The requested currency has a non guaranteed gold currency or does not support switching status currencies
    182112Duplicate currency, please re-adjust
    3100181UID can not be null
    3100197Temporary banned due to the upgrade to UTA
    3200316USDC Options Trading Restriction: The current LTV ratio for your Institutional Lending has reached the maximum allowable amount for USDC Options trading.
    3200317USDC Options Open Position Restriction: The current LTV ratio for your Institutional Lending has reached the maximum allowable amount for opening USDC Options positions.
    3100326BaseCoin is required
    3200403isolated margin can not create order
    3200419Unable to switch to Portfolio margin due to active pre-market Perpetual orders and positions
    3200320Operations Restriction: The current LTV ratio of your Institutional Lending has hit the liquidation threshold. Assets in your account are being liquidated. (margin mode or spot leverage)
    3400208You have unclosed hedge mode or isolated mode USDT perpetual positions
    3400209You have USDT perpetual positions, so upgrading is prohibited for 10 minutes before and after the hour every hour
    3400210The risk rate of your Derivatives account is too high
    3400211Once upgraded, the estimated risk rate will be too high
    3400212You have USDC perpetual positions or Options positions, so upgrading is prohibited for 10 minutes before and after the hour every hour
    3400213The risk rate of your USDC Derivatives account is too high
    3400052You have uncancelled USDC perpetual orders
    3400053You have uncancelled Options orders
    3400054You have uncancelled USDT perpetual orders
    3400214Server error, please try again later
    3400071The net asset is not satisfied
    3401010Cannot switch to PM mode (for copy trading master trader)
    3400139The total value of your positions and orders has exceeded the risk limit for a Perpetual or Futures contract
    500010The sub-account specified does not belong to the parent account
    500011The Uid 592334 provided is not associated with a Unified Trading Account

    Spot Trade​

    CodeDescription
    170001Internal error.
    170005Too many new orders; current limit is %s orders per %s.
    170007Timeout waiting for response from backend server.
    170010Purchase failed: Exceed the maximum position limit of leveraged tokens, the current available limit is %s USDT
    170011"Purchase failed: Exceed the maximum position limit of innovation tokens,
    170019the current available limit is ''{{.replaceKey0}}'' USDT"
    170031The feature has been suspended
    170032Network error. Please try again later
    170033margin Insufficient account balance
    170034Liability over flow in spot leverage trade!
    170035Submitted to the system for processing!
    170036You haven't enabled Cross Margin Trading yet. To do so, please head to the PC trading site or the Bybit app
    170037Cross Margin Trading not yet supported by the selected coin
    170105Parameter '%s' was empty.
    170115Invalid timeInForce.
    170116Invalid orderType.
    170117Invalid side.
    170121Invalid symbol.
    170124Order amount too large.
    170130Data sent for paramter '%s' is not valid.
    170131Balance insufficient
    170132Order price too high.
    170133Order price lower than the minimum.
    170134Order price decimal too long.
    170135Order quantity too large.
    170136Order quantity lower than the minimum.
    170137Order volume decimal too long
    170139Order has been filled.
    170140Transaction amount lower than the minimum.
    170141Duplicate clientOrderId
    170142Order has been canceled
    170143Cannot be found on order book
    170144Order has been locked
    170145This order type does not support cancellation
    170146Order creation timeout
    170147Order cancellation timeout
    170148Market order amount decimal too long
    170149Create order failed
    170150Cancel order failed
    170151The trading pair is not open yet
    170157The trading pair is not available for api trading
    170159Market Order is not supported within the first %s minutes of newly launched pairs due to risk control.
    170190Cancel order has been finished
    170191Can not cancel order, please try again later
    170192Order price cannot be higher than %s .
    170193Buy order price cannot be higher than %s.
    170194Sell order price cannot be lower than %s.
    170195Please note that your order may not be filled. ETP buy order price deviates from risk control
    170196Please note that your order may not be filled. ETP sell order price deviates from risk control
    170197Your order quantity to buy is too large. The filled price may deviate significantly from the market price. Please try again
    170198Your order quantity to sell is too large. The filled price may deviate significantly from the market price. Please try again
    170199Your order quantity to buy is too large. The filled price may deviate significantly from the nav. Please try again.
    170200Your order quantity to sell is too large. The filled price may deviate significantly from the nav. Please try again.
    170201Invalid orderFilter parameter
    170202Please enter the TP/SL price.
    170203trigger price cannot be higher than 110% price.
    170204trigger price cannot be lower than 90% of qty.
    170206Stop_limit Order is not supported within the first 5 minutes of newly launched pairs
    170207The loan amount of the platform is not enough.
    170210New order rejected.
    170212Cancel order request processing
    170213Order does not exist.
    170215Spot Trading (Buy) Restriction: The current LTV ratio of your institutional lending has reached the maximum allowable amount for buy orders
    170216The leverage you select for Spot Trading cannot exceed the maximum leverage allowed by Institutional Lending
    170217Only LIMIT-MAKER order is supported for the current pair.
    170218The LIMIT-MAKER order is rejected due to invalid price.
    170219UID {{xxx}} is not available to this feature
    170220Spot Trading Restriction: The current LTV ratio of your institutional lending has reached the maximum allowable amount for Spot trading
    170221This coin does not exist.
    170222Too many requests in this time frame.
    170223Your Spot Account with Institutional Lending triggers an alert or liquidation.
    170224You're not a user of the Innovation Zone.
    170226Your Spot Account for Margin Trading is being liquidated.
    170227This feature is not supported.
    170228The purchase amount of each order exceeds the estimated maximum purchase amount.
    170229The sell quantity per order exceeds the estimated maximum sell quantity.
    170230Operations Restriction: Due to the deactivation of Margin Trading for institutional loan
    170234System Error
    170241To proceed with trading, users must read through and confirm that they fully understand the project's risk disclosure document. For App users, please update your Bybit App to version 4.16.0 to process.
    170310Order modification timeout
    170311Order modification failed
    170312The current order does not support modification
    170313The modified contract quantity cannot be less than to the filled quantity
    170341Request order quantity exceeds maximum limit
    170344symbol loanable limit
    170709OTC loan: The select trading pair is not in the whitelist pair
    170810Cannot exceed maximum of 500 conditional, TP/SL and active orders.

    Spot Leverage Token​

    CodeDescription
    175000The serialNum is already in use.
    175001Daily purchase limit has been exceeded. Please try again later.
    175002There's a large number of purchase orders. Please try again later.
    175003Insufficient available balance. Please make a deposit and try again.
    175004Daily redemption limit has been exceeded. Please try again later.
    175005There's a large number of redemption orders. Please try again later.
    175006Insufficient available balance. Please make a deposit and try again.
    175007Order not found.
    175008Purchase period hasn't started yet.
    175009Purchase amount has exceeded the upper limit.
    175010You haven't passed the quiz yet! To purchase and/or redeem an LT, please complete the quiz first.
    175012Redemption period hasn't started yet.
    175013Redemption amount has exceeded the upper limit.
    175014Purchase of the LT has been temporarily suspended.
    175015Redemption of the LT has been temporarily suspended.
    175016Invalid format. Please check the length and numeric precision.
    175017Failed to place order：Exceed the maximum position limit of leveraged tokens, the current available limit is XXXX USDT
    175027Subscriptions and redemptions are temporarily unavailable while account upgrade is in progress

    Spot Margin Trade​

    CodeDescription
    176002Query user account info error. Confirm that if you have completed quiz in GUI
    176003Query user loan history error
    176004Query order history start time exceeds end time
    176005Failed to borrow
    176006Repayment Failed
    176007User not found
    176008You haven't enabled Cross Margin Trading yet. To do so, please head to the PC trading site
    176009You haven't enabled Cross Margin Trading yet. Confirm that if you have turned on margin trade
    176010Failed to locate the coins to borrow
    176011Cross Margin Trading not yet supported by the selected coin
    176012Pair not available
    176013Cross Margin Trading not yet supported by the selected pair
    176014Repeated repayment requests
    176015Insufficient available balance
    176016No repayment required
    176017Repayment amount has exceeded the total liability
    176018Settlement in progress
    176019Liquidation in progress
    176020Failed to locate repayment history
    176021Repeated borrowing requests
    176022Coins to borrow not generally available yet
    176023Pair to borrow not generally available yet
    176024Invalid user status
    176025Amount to borrow cannot be lower than the min. amount to borrow (per transaction)
    176026Amount to borrow cannot be larger than the max. amount to borrow (per transaction)
    176027Amount to borrow cannot be higher than the max. amount to borrow per user
    176028Amount to borrow has exceeded Bybit's max. amount to borrow
    176029Amount to borrow has exceeded the user's estimated max. amount to borrow
    176030Query user loan info error
    176031Number of decimals for borrow amount has exceeded the maximum precision
    176034The leverage ratio is out of range
    176035Failed to close the leverage switch during liquidation
    176036Failed to adjust leverage switch during forced liquidation
    176037For non-unified transaction users, the operation failed
    176038The spot leverage is closed and the current operation is not allowed
    176039Borrowing, current operation is not allowed
    176040There is a spot leverage order, and the adjustment of the leverage switch failed!
    176132Number of decimals for repay amount has exceeded the maximum precision
    176133Liquidation may be triggered! Please adjust your transaction amount and try again
    176134Account has been upgraded (upgrading) to UTA
    176135Failed to get bond data
    176136Failed to get borrow data
    176137Failed to switch user status
    176138You need to repay all your debts before closing your disabling cross margin account
    176139Sorry, you are not eligible to enable cross margin, as you have already enabled OTC lending
    176201Account exception. Check if the UID is bound to an institutional loan
    182104This action could not be completed as your Unified Margin Account's IM/MM utilization rate has exceeded the threshold
    182105Adjustment failed, user is upgrading
    182106Adjustment failed, user forced liquidation in progress.
    182107Adjustment failed, Maintenance Margin Rate too high

    Asset​

    CodeDescription
    131001openapi svc error
    131002Parameter error
    131002Withdraw address chain or destination tag are not equal
    131003Internal error
    131004KYC needed
    131066This address does not support withdrawals for the time being. Please switch to another address for withdrawing
    131067Travel rule verification failed, please contact the target exchange. Travel rule for KR user
    131068Travel rule information is insufficient, please provide additional details. Travel rule for KR user
    131069Unable to withdraw to the receipt, please contact the target the exchange. Travel rule for KR user
    131070The recipient's name is mismatched with the targeted exchange. Travel rule for KR user
    131071The recipient has not undergone KYC verification. Travel rule for KR user
    131072Your withdrawal currency is not supported by the target exchange. Travel rule for KR user
    131073Your withdrawal address has not been included in the target exchange. Travel rule for KR user
    131074Beneficiary info is required, please refer to the latest api document. Travel rule for KR user
    131075InternalAddressCannotBeYourself
    131076internal transfer not support sub-accounts
    131077receive user not exist
    131078receive user deposit has been banned
    131079receive user need kyc
    131080User left retry times is zero
    131081Do not input memo/tag,please.
    131082Do not repeat the request
    131083Withdraw only allowed from address book
    131084Withdraw failed because of Uta Upgrading
    131085Withdrawal amount is greater than your availale balance (the deplayed withdrawal is triggered)
    131086Withdrawal amount exceeds risk limit (the risk limit of margin trade is triggered)
    131087your current account spot risk level is too high, withdrawal is prohibited, please adjust and try again
    131088The withdrawal amount exceeds the remaining withdrawal limit of your identity verification level. The current available amount for withdrawal : %s
    131089User sensitive operation, withdrawal is prohibited within 24 hours
    131090User withdraw has been banned
    131091Blocked login status does not allow withdrawals
    131092User status is abnormal
    131093The withdrawal address is not in the whitelist
    131094UserId is not in the whitelist
    131095Withdrawl amount exceeds the 24 hour platform limit
    131096Withdraw amount does not satify the lower limit or upper limit
    131097Withdrawal of this currency has been closed
    131098Withdrawal currently is not availble from new address
    131099Hot wallet status can cancel the withdraw
    131200Service error
    131201Internal error
    131202Invalid memberId
    131203Request parameter error
    131204Account info error
    131205Query transfer error
    131206cannot be transfer
    131207Account not exist
    131208Forbid transfer
    131209Get subMember relation error
    131210Amount accuracy error
    131211fromAccountType can't be the same as toAccountType
    131212Insufficient balance
    131213TransferLTV check error
    131214TransferId exist
    131215Amount error
    131216Query balance error
    131217Risk check error
    131227Sub-account do not have universal transfer permission
    131228your balance is not enough. Please check transfer safe amount
    131229Due to compliance requirements, the current currency is not allowed to transfer
    131230The system is busy, please try again later
    131231Transfers into this account are not supported
    131232Transfers out this account are not supported
    140001Switching the PM spot hedging switch is not allowed in non PM mode
    140002Institutional lending users do not support PM spot hedging
    140003You have position(s) being liquidated, please try again later.
    140004Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.
    140005Risk level after switching modes exceeds threshold
    141004sub member is not normal
    141025This sub-account has assets and cannot be deleted
    181000category is null
    181001category only support linear or option or spot.
    181002symbol is null.
    181003side is null.
    181004side only support Buy or Sell.
    181005orderStatus is wrong
    181006startTime is not number
    181007endTime is not number
    181008Parameter startTime and endTime are both needed
    181009Parameter startTime needs to be smaller than endTime
    181010The time range between startTime and endTime cannot exceed 7 days
    181011limit is not a number
    181012symbol not exist
    181013Only support settleCoin: usdc
    181014Classic account is not supported
    181018Invalid expDate.
    181019Parameter expDate can't be earlier than 2 years
    182000symbol related quote price is null
    182200Please upgrade UTA first.
    182201You must enter 2 time parameters.
    182202The start time must be less than the end time
    182203Please enter valid characters
    182204Coin does not exist
    182205User level does not exist
    700000accountType/quoteTxId cannot be null
    700001quote fail:no dealer can used
    700004order does not exist
    700007Large Amount Limit

    Institutional Loan​

    CodeDescription
    3777002UID cannot be bound repeatedly.
    3777003UID cannot be unbound because the UID has not been bound to a risk unit.
    3777004The main UID of the risk unit cannot be unbound.
    3777005You have unsettled lending or borrowing orders. Please try again later.
    3777006UID cannot be bound, please try again with a different UID."
    3777007UID cannot be bound, please upgrade to UTA Pro."
    3777027UID cannot be bound, leveraged trading closure failed.
    3777029You currently have orders for pre-market trading that can’t be bind UIDs
    3777030This account has activated copyPro and cannot bind uid

    Broker​

    CodeDescription
    3500402Parameter verification failed for 'limit'.
    3500403Only available to exchange broker main-account
    3500404Invalid Cursor
    3500405Parameter "startTime" and "endTime" need to be input in pairs.
    3500406Out of query time range.
    3500407Parameter begin and end need to be input in pairs.
    - + \ No newline at end of file diff --git a/v5/guide.html b/v5/guide.html index c6998c7071..a2967a2af2 100644 --- a/v5/guide.html +++ b/v5/guide.html @@ -4,7 +4,7 @@ Integration Guidance | Bybit API Documentation - + @@ -16,7 +16,7 @@ keys through the software, and then only provide the public key to Bybit, we will never hold your private key.

    1. Use api-rsa-generator to create RSA private and public keys
    2. Follow the RSA sample scripts to complete encryption procedures.

    Parameters for Authenticated Endpoints​

    The following HTTP header keys must be used for authentication:

    • X-BAPI-API-KEY - API key
    • X-BAPI-TIMESTAMP - UTC timestamp in milliseconds
    • X-BAPI-SIGN - a signature derived from the request's parameters
    • X-Referer or Referer - the header for broker users only

    We also provide X-BAPI-RECV-WINDOW (unit in millisecond and default value is 5,000) to specify how long an HTTP request is valid. It is also used to prevent replay attacks.

    A smaller X-BAPI-RECV-WINDOW is more secure, but your request may fail if the transmission time is greater than your X-BAPI-RECV-WINDOW.

    caution

    Please make sure that the timestamp parameter adheres to the following rule:
    server_time - recv_window <= timestamp < server_time + 1000
    server_time stands for Bybit server time, which can be queried via the Server Time endpoint.

    Create A Request​

    tip

    To assist in diagnosing advanced network problems, you may consider adding cdn-request-id to your request headers. Its value should be unique for each request.

    Basic steps:

    1. timestamp + API key + (recv_window) + (queryString | jsonBodyString)
    2. Use the HMAC_SHA256 or RSA_SHA256 algorithm to sign the string in step 1, and convert it to a hex string (HMAC_SHA256) / base64 (RSA_SHA256) to obtain the sign parameter.
    3. Append the sign parameter to request header, and send the HTTP request. Note: the plain text for GET and POST requests is different. Please refer to blew examples.
    info
    Example signature algorithms can be found here.

    An example for how to generate plain text to encrypt

    # rule:
    timestamp+api_key+recv_window+queryString

    # param_str
    "1658384314791XXXXXXXXXX5000category=option&symbol=BTC-29JUL22-25000-C"

    # parse
    timestamp = "1658384314791"
    api_key = "XXXXXXXXXX"
    recv_window = "5000"
    queryString = "category=option&symbol=BTC-29JUL22-25000-C"

    HTTP request examples

    GET /v5/order/realtime?category=option&symbol=BTC-29JUL22-25000-C HTTP/1.1
    Host: api-testnet.bybit.com
    -H 'X-BAPI-SIGN: XXXXXXXXXX' \
    -H 'X-BAPI-API-KEY: XXXXXXXXXX' \
    -H 'X-BAPI-TIMESTAMP: 1658384431891' \
    -H 'X-BAPI-RECV-WINDOW: 5000'

    Common response parameters​

    ParameterTypeComments
    retCodenumberSuccess/Error code
    retMsgstringSuccess/Error msg. OK, success, SUCCESS, "" indicate a successful response
    resultObjectBusiness data result
    retExtInfoObjectExtend info. Most of the time it is {}
    timenumberCurrent timestamp (ms)
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017382656
    }
    - + \ No newline at end of file diff --git a/v5/intro.html b/v5/intro.html index 28c32cb01b..8e360e43cc 100644 --- a/v5/intro.html +++ b/v5/intro.html @@ -4,7 +4,7 @@ Introduction | Bybit API Documentation - + @@ -44,7 +44,7 @@ orders that can be traded for each symbol.

    Uniform and Precise Data​

    Previous APIs returned data as E2 and E8. API V3 and V5 return data as actual values, eliminating the need for users to implement conversion logic.

    Readability Improvements to API Documentation​

    The API documentation has been revised and proofread to improve clarity and reduce confusion. Any parts of the previous documentation that were not clear have been revised to provide better explanations.

    V5 and V3 Interface Mapping List​

    ModuleV5 EndpointV3 Endpoint
    Market/v5/market/kline/derivatives/v3/public/kline
    /spot/v3/public/quote/kline
    /v5/market/mark-price-kline/derivatives/v3/public/mark-price-kline
    /v5/market/index-price-kline/derivatives/v3/public/index-price-kline
    /v5/market/premium-index-price-kline/derivatives/v3/public/premium-index-price-kline
    /v5/market/orderbook/derivatives/v3/public/order-book/L2
    /spot/v3/public/quote/depth
    /v5/market/tickers/derivatives/v3/public/tickers
    /spot/v3/public/quote/ticker/24hr
    /spot/v3/public/quote/ticker/price
    /spot/v3/public/quote/ticker/bookTicker
    /v5/market/funding/history/derivatives/v3/public/funding/history-funding-rate
    /v5/market/recent-trade/derivatives/v3/public/recent-trade
    /spot/v3/public/quote/trades
    /v5/market/open-interest/derivatives/v3/public/open-interest
    /v5/market/historical-volatility/derivatives/v3/public/historical-volatility
    /v5/market/insurance/derivatives/v3/public/insurance
    /v5/market/instruments-info/derivatives/v3/public/instruments-info
    /spot/v3/public/infos
    /spot/v3/public/symbols
    /v5/market/risk-limit/derivatives/v3/public/risk-limit/list
    /v5/market/delivery-price/derivatives/v3/public/delivery-price
    Order/v5/order/create/unified/v3/private/order/create
    /contract/v3/private/order/create
    /v5/order/amend/unified/v3/private/order/replace
    /contract/v3/private/order/replace
    /v5/order/cancel/unified/v3/private/order/cancel
    /contract/v3/private/order/cancel
    /v5/order/realtime/unified/v3/private/order/unfilled-orders
    /contract/v3/private/order/unfilled-orders
    /v5/order/cancel-all/unified/v3/private/order/cancel-all
    /contract/v3/private/order/cancel-all
    /v5/order/history/unified/v3/private/order/list
    /contract/v3/private/order/list
    /v5/order/create-batch/unified/v3/private/order/create-batch
    /v5/order/amend-batch/unified/v3/private/order/replace-batch
    /v5/order/cancel-batch/unified/v3/private/order/cancel-batch
    /v5/order/spot-borrow-checkNone
    Position/v5/position/list/unified/v3/private/position/list
    /contract/v3/private/position/list
    /v5/position/set-leverage/unified/v3/private/position/set-leverage
    /contract/v3/private/position/set-leverage
    /v5/position/set-risk-limit/unified/v3/private/position/set-risk-limit
    /contract/v3/private/position/set-risk-limit
    /v5/position/trading-stop/unified/v3/private/position/trading-stop
    /contract/v3/private/position/trading-stop
    /v5/position/switch-isolated/contract/v3/private/position/switch-isolated
    /v5/position/switch-mode/contract/v3/private/position/switch-mode
    /v5/position/set-auto-add-margin/contract/v3/private/position/set-auto-add-margin
    /v5/position/closed-pnl/contract/v3/position/closed-pnl
    /v5/execution/list/unified/v3/private/execution/list
    /contract/v3/private/execution/list
    Account/v5/account/wallet-balance/unified/v3/private/account/wallet/balance
    /contract/v3/private/account/wallet/balance
    /v5/account/upgrade-to-uta/unified/v3/private/account/upgrade-unified-account
    /v5/account/borrow-history/unified/v3/private/account/borrow-history
    /v5/account/collateral-info/unified/v3/private/account/borrow-rate
    /v5/asset/coin-greeksNone
    /v5/account/infoNone
    /v5/account/transaction-log/unified/v3/private/account/transaction-log
    /v5/account/set-margin-mode/contract/v3/private/account/setMarginMode
    Spot Leverage Token/v5/spot-lever-token/info/spot/v3/public/infos
    /v5/spot-lever-token/reference/spot/v3/private/order/reference
    /v5/spot-lever-token/purchase/spot/v3/private/order/purchase
    /v5/spot-lever-token/redeem/spot/v3/private/order/redeem
    /v5/spot-lever-token/order-record/spot/v3/private/order/record
    Spot Margin Trade/v5/spot-margin-trade/switch-mode/spot/v3/private/cross-margin-switch
    /v5/spot-margin-trade/set-leverageNone
    /v5/spot-margin-trade/set-pledge-tokenNone
    Asset/v5/asset/delivery-record/unified/v3/private/delivery-record
    /v5/asset/settlement-record/unified/v3/private/settlement-record
    /v5/asset/transfer/inter-transfer/asset/v3/private/transfer/inter-transfer
    v5/asset/transfer/query-inter-transfer-list/asset/v3/private/transfer/inter-transfer/list/query
    v5/asset/transfer/save-transfer-sub-member/asset/v3/private/transfer/transfer-sub-member-save
    /v5/asset/transfer/universal-transfer/asset/v3/private/transfer/universal-transfer
    /v5/asset/transfer/query-universal-transfer-list/asset/v3/private/transfer/universal-transfer/list/query
    /v5/asset/transfer/query-transfer-coin-list/asset/v3/private/transfer/transfer-coin/list/query
    /v5/asset/transfer/query-sub-member-list/asset/v3/private/transfer/sub-member/list/quer
    /v5/asset/transfer/query-account-coin-balance/asset/v3/private/transfer/account-coin/balance/query
    /v5/asset/transfer/query-asset-info/asset/v3/private/transfer/asset-info/query
    /v5/asset/deposit/query-allowed-list/asset/v3/public/deposit/allowed-deposit-list/query
    /v5/asset/deposit/query-record/asset/v3/private/deposit/record/query
    /v5/asset/deposit/query-sub-member-record/asset/v3/private/deposit/sub-member-record/query
    /v5/asset/withdraw/query-record/asset/v3/private/withdraw/record/query
    /v5/asset/coin/query-info/asset/v3/private/coin-info/query
    /v5/asset/withdraw/create/asset/v3/private/withdraw/create
    /v5/asset/withdraw/cancel/asset/v3/private/withdraw/cancel
    /v5/asset/deposit/query-address/asset/v3/private/deposit/address/query
    /v5/asset/deposit/query-sub-member-address/asset/v3/private/deposit/sub-member-address/query
    /v5/asset/exchange/order-record/asset/v2/private/exchange/query-exchange-order
    WebSocket Publicwss://stream.bybit.com/v5/public/spotwss://stream.bybit.com/spot/public/v3
    wss://stream.bybit.com/v5/public/linearwss://stream.bybit.com/contract/usdt/public/v3
    wss://stream.bybit.com/contract/usdc/public/v3
    wss://stream.bybit.com/v5/public/inversewss://stream.bybit.com/contract/inverse/public/v3
    wss://stream.bybit.com/v5/public/optionwss://stream.bybit.com/option/usdc/public/v3
    WebSocket Privatewss://stream.bybit.com/v5/privatewss://stream.bybit.com/spot/private/v3
    wss://stream.bybit.com/unified/private/v3
    wss://stream.bybit.com/contract/private/v3
    - + \ No newline at end of file diff --git a/v5/lt/leverage-token-info.html b/v5/lt/leverage-token-info.html index e34eb0a667..4b7f82e0d9 100644 --- a/v5/lt/leverage-token-info.html +++ b/v5/lt/leverage-token-info.html @@ -4,13 +4,13 @@ Get Leverage Token Info | Bybit API Documentation - +

    Get Leverage Token Info

    Query leverage token information

    HTTP Request​

    GET /v5/spot-lever-token/info

    Request Parameters​

    ParameterRequiredTypeComments
    ltCoinfalsestringAbbreviation of the LT, such as BTC3L

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > ltCoinstringAbbreviation
    > ltNamestringFull name of leveraged token
    > maxPurchasestringSingle maximum purchase amount
    > minPurchasestringSingle minimum purchase amount
    > maxPurchaseDailystringMaximum purchase amount in a single day
    > maxRedeemstringSingle Maximum redemption quantity
    > minRedeemstringSingle Minimum redemption quantity
    > maxRedeemDailystringMaximum redemption quantity in a single day
    > purchaseFeeRatestringPurchase fee rate
    > redeemFeeRatestringRedeem fee rate
    > ltStatusstringWhether the leverage token can be purchased or redeemed
    > fundFeestringFunding fee charged daily for users holding leveraged token
    > fundFeeTimestringThe time to charge funding fee
    > manageFeeRatestringManagement fee rate
    > manageFeeTimestringThe time to charge management fee
    > valuestringNominal asset value
    > netValuestringNet value
    > totalstringTotal purchase upper limit

    Request Example​

    GET /v5/spot-lever-token/info?ltCoin=BTC3L HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "fundFee": "299.70622821",
                    "fundFeeTime": "1672992000000",
                    "ltCoin": "BTC3L",
                    "ltName": "3X Long",
                    "ltStatus": "1",
                    "manageFeeRate": "0.00005",
                    "manageFeeTime": "1673053200000",
                    "maxPurchase": "10000",
                    "maxPurchaseDaily": "200000",
                    "maxRedeem": "14434",
                    "maxRedeemDaily": "2100000",
                    "minPurchase": "100",
                    "minRedeem": "144",
                    "netValue": "0.376482201140738147",
                    "purchaseFeeRate": "0.0005",
                    "redeemFeeRate": "0.0005",
                    "total": "5000000",
                    "value": "49464463114.022994974075443169"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672991427073
    }
    - + \ No newline at end of file diff --git a/v5/lt/leverage-token-reference.html b/v5/lt/leverage-token-reference.html index 0c421b13f8..17690dc973 100644 --- a/v5/lt/leverage-token-reference.html +++ b/v5/lt/leverage-token-reference.html @@ -4,13 +4,13 @@ Get Leveraged Token Market | Bybit API Documentation - +

    Get Leveraged Token Market

    Get leverage token market information

    HTTP Request​

    GET /v5/spot-lever-token/reference

    Request Parameters​

    ParameterRequiredTypeComments
    ltCointruestringAbbreviation of the LT, such as BTC3L

    Response Parameters​

    ParameterTypeComments
    ltCoinstringAbbreviation of the LT, such as BTC3L
    navstringnet value
    navTimestringUpdate time for net asset value (in milliseconds and UTC time zone)
    circulationstringCirculating supply in the secondary market
    basketstringbasket
    leveragestringReal leverage calculated by last traded price

    Request Example​

    GET /v5/spot-lever-token/reference?ltCoin=BTC3S HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "basket": "-132.460000082171973364",
            "circulation": "30097.901900052619091704",
            "leverage": "-2.666924651755770729",
            "ltCoin": "BTC3S",
            "nav": "27.692082719770373048",
            "navTime": "1672991679858"
        },
        "retExtInfo": {},
        "time": 1672991679937
    }
    - + \ No newline at end of file diff --git a/v5/lt/order-record.html b/v5/lt/order-record.html index fc8e6fd899..167675aec3 100644 --- a/v5/lt/order-record.html +++ b/v5/lt/order-record.html @@ -4,13 +4,13 @@ Get Purchase/Redemption Records | Bybit API Documentation - +

    Get Purchase/Redemption Records

    Get purchase or redeem history

    HTTP Request​

    GET /v5/spot-lever-token/order-record

    Request Parameters​

    ParameterRequiredTypeComments
    ltCoinfalsestringAbbreviation of the LT, such as BTC3L
    orderIdfalsestringOrder ID
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 500]. Default: 100
    ltOrderTypefalseintegerLT order type. 1: purchase, 2: redemption
    serialNofalsestringSerial number

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > ltCoinstringAbbreviation of the LT, such as BTC3L
    > orderIdstringOrder ID
    > ltOrderTypeintegerLT order type. 1: purchase, 2: redeem
    > orderTimenumberOrder time
    > updateTimenumberLast update time of the order status
    > ltOrderStatusstringOrder status. 1: completed, 2: in progress, 3: failed
    > feestringTrading fees
    > amountstringOrder quantity of the LT
    > valuestringFilled value
    > valueCoinstringQuote coin
    > serialNostringSerial number

    Request Example​

    GET /v5/spot-lever-token/order-record?orderId=2611 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672294422027
    X-BAPI-SIGN: XXXXX
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "amount": "222.90757477",
                    "fee": "0",
                    "ltCoin": "EOS3L",
                    "ltOrderStatus": "1",
                    "ltOrderType": "1",
                    "orderId": "2611",
                    "orderTime": "1672737465000",
                    "serialNo": "pruchase-002",
                    "updateTime": "1672737478000",
                    "value": "95.13860435",
                    "valueCoin": "USDT"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672294446137
    }
    - + \ No newline at end of file diff --git a/v5/lt/purchase.html b/v5/lt/purchase.html index 80d9168aee..47c7e48799 100644 --- a/v5/lt/purchase.html +++ b/v5/lt/purchase.html @@ -4,13 +4,13 @@ Purchase | Bybit API Documentation - +

    Purchase

    Purchase levearge token

    HTTP Request​

    POST /v5/spot-lever-token/purchase

    Request Parameters​

    ParameterRequiredTypeComments
    ltCointruestringAbbreviation of the LT, such as BTC3L
    ltAmounttruestringPurchase amount
    serialNofalsestringSerial number

    Response Parameters​

    ParameterTypeComments
    ltCoinstringAbbreviation of the LT, such as BTC3L
    ltOrderStatusstringOrder status. 1: completed, 2: in progress, 3: failed
    execQtystringExecuted qty of LT
    execAmtstringExecuted amount of LT
    amountstringPurchase amount
    purchaseIdstringOrder ID
    serialNostringSerial number, customised order ID
    valueCoinstringQuote coin

    Request Example​

    POST /v5/spot-lever-token/purchase HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672294730346
    X-BAPI-SIGN: XXXXX
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "ltCoin": "EOS3L",
        "amount": "200",
        "serialNo": "purchase-001"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "amount": "200",
            "execAmt": "",
            "execQty": "",
            "ltCoin": "EOS3L",
            "ltOrderStatus": "2",
            "purchaseId": "2611",
            "serialNo": "purchase-001",
            "valueCoin": "USDT"
        },
        "retExtInfo": {},
        "time": 1672293867729
    }
    - + \ No newline at end of file diff --git a/v5/lt/redeem.html b/v5/lt/redeem.html index 95dfa6cfae..cc204570a1 100644 --- a/v5/lt/redeem.html +++ b/v5/lt/redeem.html @@ -4,13 +4,13 @@ Redeem | Bybit API Documentation - +

    Redeem

    Redeem leverage token

    HTTP Request​

    POST /v5/spot-lever-token/redeem

    Request Parameters​

    ParameterRequiredTypeComments
    ltCointruestringAbbreviation of the LT, such as BTC3L
    quantityturestringRedeem quantity of LT
    serialNofalsestringSerial number

    Response Parameters​

    ParameterTypeComments
    ltCoinstringAbbreviation of the LT
    ltOrderStatusstringOrder status. 1: completed, 2: in progress, 3: failed
    quantitystringQuantity
    execQtystringLT quantity
    execAmtstringExecuted amount of LT
    redeemIdstringOrder ID
    serialNostringSerial number
    valueCoinstringQuote coin

    Request Example​

    POST /v5/spot-lever-token/redeem HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672296416024
    X-BAPI-SIGN: XXXXX
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "ltCoin": "EOS3L",
        "quantity": "150",
        "serialNo": "redeem-001"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "execAmt": "",
            "execQty": "150",
            "ltCoin": "EOS3L",
            "ltOrderStatus": "2",
            "quantity": "",
            "redeemId": "2619",
            "serialNo": "redeem-001",
            "valueCoin": "EOS3L"
        },
        "retExtInfo": {},
        "time": 1672296417363
    }
    - + \ No newline at end of file diff --git a/v5/market/delivery-price.html b/v5/market/delivery-price.html index a7ab3c56c5..137104d160 100644 --- a/v5/market/delivery-price.html +++ b/v5/market/delivery-price.html @@ -4,13 +4,13 @@ Get Delivery Price | Bybit API Documentation - +

    Get Delivery Price

    Get the delivery price.

    Covers: USDC futures / Inverse futures / Option

    info
    • Option: only returns those symbols are being "DELIVERING" (UTC8~UTC12) when "symbol" is not specified;

    HTTP Request​

    GET /v5/market/delivery-price

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, inverse, option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    baseCoinfalsestringBase coin, uppercase only. Default: BTC. valid for option only
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > deliveryPricestringDelivery price
    > deliveryTimestringDelivery timestamp (ms)
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/market/delivery-price?category=option&symbol=ETH-26DEC22-1400-C HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "category": "option",
            "nextPageCursor": "",
            "list": [
                {
                    "symbol": "ETH-26DEC22-1400-C",
                    "deliveryPrice": "1220.728594450",
                    "deliveryTime": "1672041600000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672055336993
    }
    - + \ No newline at end of file diff --git a/v5/market/history-fund-rate.html b/v5/market/history-fund-rate.html index f8a09357b4..bd7127ecce 100644 --- a/v5/market/history-fund-rate.html +++ b/v5/market/history-fund-rate.html @@ -4,13 +4,13 @@ Get Funding Rate History | Bybit API Documentation - +

    Get Funding Rate History

    Query for historical funding rates. Each symbol has a different funding interval. For example, if the interval is 8 hours and the current time is UTC 12, then it returns the last funding rate, which settled at UTC 8.

    To query the funding rate interval, please refer to the instruments-info endpoint.

    Covers: USDT and USDC perpetual / Inverse perpetual

    info
    • Passing only startTime returns an error.
    • Passing only endTime returns 200 records up till endTime.
    • Passing neither returns 200 records up till the current time.

    HTTP Request​

    GET /v5/market/funding/history

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear,inverse
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 200

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > fundingRatestringFunding rate
    > fundingRateTimestampstringFunding rate timestamp (ms)

    Request Example​

    GET /v5/market/funding/history?category=linear&symbol=ETHPERP&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                    "symbol": "ETHPERP",
                    "fundingRate": "0.0001",
                    "fundingRateTimestamp": "1672041600000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672051897447
    }
    - + \ No newline at end of file diff --git a/v5/market/index-kline.html b/v5/market/index-kline.html index adbfd89143..2b817afe68 100644 --- a/v5/market/index-kline.html +++ b/v5/market/index-kline.html @@ -4,13 +4,13 @@ Get Index Price Kline | Bybit API Documentation - +

    Get Index Price Kline

    Query for historical index price klines. Charts are returned in groups based on the requested interval.

    Covers: USDT perpetual / USDC contract / Inverse contract

    HTTP Request​

    GET /v5/market/index-price-kline

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse
  • When category is not passed, use linear by default
    • symboltruestringSymbol name, like BTCUSDT, uppercase only
    intervaltruestringKline interval. 1,3,5,15,30,60,120,240,360,720,D,M,W
    startfalseintegerThe start timestamp (ms)
    endfalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    symbolstringSymbol name
    listarray
    • An string array of individual candle
    • Sort in reverse by startTime
    > list[0]: startTimestringStart time of the candle (ms)
    > list[1]: openPricestringOpen price
    > list[2]: highPricestringHighest price
    > list[3]: lowPricestringLowest price
    > list[4]: closePricestringClose price. Is the last traded price when the candle is not closed

    Request Example​

    GET /v5/market/index-price-kline?category=inverse&symbol=BTCUSDZ22&interval=1&start=1670601600000&end=1670608800000&limit=2 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDZ22",
            "category": "inverse",
            "list": [
                [
                    "1670608800000",
                    "17167.00",
                    "17167.00",
                    "17161.90",
                    "17163.07"
                ],
                [
                    "1670608740000",
                    "17166.54",
                    "17167.69",
                    "17165.42",
                    "17167.00"
                ]
            ]
        },
        "retExtInfo": {},
        "time": 1672026471128
    }
    - + \ No newline at end of file diff --git a/v5/market/instrument.html b/v5/market/instrument.html index f094a104a7..a918137d13 100644 --- a/v5/market/instrument.html +++ b/v5/market/instrument.html @@ -4,13 +4,13 @@ Get Instruments Info | Bybit API Documentation - +

    Get Instruments Info

    Query for the instrument specification of online trading pairs.

    Covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option

    info
    • Spot does not support pagination, so limit, cursor are invalid.
    • When query by baseCoin, regardless of category=linear or inverse, the result will have USDT perpetual, USDC contract and Inverse contract symbols.

    HTTP Request​

    GET /v5/market/instruments-info

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. spot,linear,inverse,option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    statusfalsestringSymbol status filter
    • spot has Trading only
    • PreLaunch: when category=linear&status=PreLaunch, it returns pre-market perpetual contract
    baseCoinfalsestringBase coin, uppercase only
  • Apply tolinear,inverse,option only
  • option: it returns BTC by default
    • limitfalseintegerLimit for data size per page. [1, 1000]. Default: 500
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    nextPageCursorstringCursor. Used to pagination
    listarrayObject
    > symbolstringSymbol name
    > contractTypestringContract type
    > statusstringInstrument status
    > baseCoinstringBase coin
    > quoteCoinstringQuote coin
    > launchTimestringLaunch timestamp (ms)
    > deliveryTimestringDelivery timestamp (ms)
    > deliveryFeeRatestringDelivery fee rate
    > priceScalestringPrice scale
    > leverageFilterObjectLeverage attributes
    >> minLeveragestringMinimum leverage
    >> maxLeveragestringMaximum leverage
    >> leverageStepstringThe step to increase/reduce leverage
    > priceFilterObjectPrice attributes
    >> minPricestringMinimum order price
    >> maxPricestringMaximum order price
    >> tickSizestringThe step to increase/reduce order price
    > lotSizeFilterObjectSize attributes
    >> minNotionalValuestringMinimum notional value
    >> maxOrderQtystringMaximum quantity for Limit and PostOnly order
    >> maxMktOrderQtystringMaximum quantity for Market order
    >> minOrderQtystringMinimum order quantity
    >> qtyStepstringThe step to increase/reduce order quantity
    >> postOnlyMaxOrderQtystringDepreciated, please use maxOrderQty
    > unifiedMarginTradebooleanWhether to support unified margin trade
    > fundingIntervalintegerFunding interval (minute)
    > settleCoinstringSettle coin
    > copyTradingstringCopy trade symbol or not
    > upperFundingRatestringUpper limit of funding date
    > lowerFundingRatestringLower limit of funding date
    > isPreListingboolean
  • Whether the contract is a pre-market contract
  • When the pre-market contract is converted to official contract, it will be false
    • > preListingInfoobject
  • If isPreListing=false, preListingInfo=null
  • If isPreListing=true, preListingInfo is an object
    • >> curAuctionPhasestringThe current auction phase
    >> phasesarray<object>Each phase time info
    >>> phasestringpre-market trading phase
    >>> startTimestringThe start time of the phase, timestamp(ms)
    >>> endTimestringThe end time of the phase, timestamp(ms)
    >> auctionFeeInfoobjectAction fee info
    >>> auctionFeeRatestringThe trading fee rate during auction phase
  • There is no trading fee until entering continues trading phase
    • >>> takerFeeRatestringThe taker fee rate during continues trading phase
    >>> makerFeeRatestringThe maker fee rate during continues trading phase

    Request Example​

    GET /v5/market/instruments-info?category=linear&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    // official USDT Perpetual instrument structure
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "contractType": "LinearPerpetual",
                    "status": "Trading",
                    "baseCoin": "BTC",
                    "quoteCoin": "USDT",
                    "launchTime": "1585526400000",
                    "deliveryTime": "0",
                    "deliveryFeeRate": "",
                    "priceScale": "2",
                    "leverageFilter": {
                        "minLeverage": "1",
                        "maxLeverage": "100.00",
                        "leverageStep": "0.01"
                    },
                    "priceFilter": {
                        "minPrice": "0.10",
                        "maxPrice": "199999.80",
                        "tickSize": "0.10"
                    },
                    "lotSizeFilter": {
                        "maxOrderQty": "100.000",
                        "maxMktOrderQty": "100.000",
                        "minOrderQty": "0.001",
                        "qtyStep": "0.001",
                        "postOnlyMaxOrderQty": "1000.000",
                        "minNotionalValue": "5"
                    },
                    "unifiedMarginTrade": true,
                    "fundingInterval": 480,
                    "settleCoin": "USDT",
                    "copyTrading": "both",
                    "upperFundingRate": "0.00375",
                    "lowerFundingRate": "-0.00375"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1707186451514
    }

    // Pre-market Perpetual instrument structure
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                    "symbol": "PRE02ZROUSDT",
                    "contractType": "LinearPerpetual",
                    "status": "PreLaunch",
                    "baseCoin": "PRE02ZRO",
                    "quoteCoin": "USDT",
                    "launchTime": "1718610229000",
                    "deliveryTime": "0",
                    "deliveryFeeRate": "",
                    "priceScale": "3",
                    "leverageFilter": {
                        "minLeverage": "1",
                        "maxLeverage": "5.00",
                        "leverageStep": "0.01"
                    },
                    "priceFilter": {
                        "minPrice": "0.001",
                        "maxPrice": "1999.998",
                        "tickSize": "0.001"
                    },
                    "lotSizeFilter": {
                        "maxOrderQty": "10000.0",
                        "minOrderQty": "0.1",
                        "qtyStep": "0.1",
                        "postOnlyMaxOrderQty": "10000.0",
                        "maxMktOrderQty": "2000.0",
                        "minNotionalValue": "5"
                    },
                    "unifiedMarginTrade": true,
                    "fundingInterval": 480,
                    "settleCoin": "USDT",
                    "copyTrading": "none",
                    "upperFundingRate": "0.03",
                    "lowerFundingRate": "-0.03",
                    "isPreListing": true,
                    "preListingInfo": {
                        "curAuctionPhase": "ContinuousTrading",
                        "phases": [
                            {
                                "phase": "CallAuction",
                                "startTime": "1718621400000",
                                "endTime": "1718707200000"
                            },
                            {
                                "phase": "CallAuctionNoCancel",
                                "startTime": "1718707200000",
                                "endTime": "1718707500000"
                            },
                            {
                                "phase": "CrossMatching",
                                "startTime": "1718707500000",
                                "endTime": "1718707800000"
                            },
                            {
                                "phase": "ContinuousTrading",
                                "startTime": "1718707800000",
                                "endTime": ""
                            }
                        ],
                        "auctionFeeInfo": {
                            "auctionFeeRate": "0",
                            "takerFeeRate": "0.001",
                            "makerFeeRate": "0.0004"
                        }
                    }
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1719455285151
    }
    - + \ No newline at end of file diff --git a/v5/market/insurance.html b/v5/market/insurance.html index 855dec8265..1dd57b0223 100644 --- a/v5/market/insurance.html +++ b/v5/market/insurance.html @@ -4,13 +4,13 @@ Get Insurance | Bybit API Documentation - +

    Get Insurance

    Query for Bybit insurance pool data (BTC/USDT/USDC etc). The data is updated every 24 hours.

    info

    Since the insurance pool data is updated every 24 hours, it is possible that you get ADL trade but the insruance pool still has sufficient funds.

    HTTP Request​

    GET /v5/market/insurance

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringcoin, uppercase only. Default: return all insurance coins

    Response Parameters​

    ParameterTypeComments
    updatedTimestringData updated time (ms)
    listarrayObject
    > coinstringCoin
    > symbolsstring
  • For an independent insurance pool, you may see "BTCUSDT,ETHUSDT,SOLUSDT"
  • For non-independent insurance pool, it returns ""
    • > balancestringBalance
    > valuestringUSD value

    Request Example​

    GET /v5/market/insurance?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "updatedTime": "1714003200000",
            "list": [
                {
                    "coin": "USDT",
                    "symbols": "MERLUSDT,10000000AIDOGEUSDT,ZEUSUSDT",
                    "balance": "902178.57602476",
                    "value": "901898.0963091522"
                },
                {
                    "coin": "USDT",
                    "symbols": "SOLUSDT,OMNIUSDT,ALGOUSDT",
                    "balance": "14454.51626125",
                    "value": "14449.515598975464"
                },
                {
                    "coin": "USDT",
                    "symbols": "XLMUSDT,WUSDT",
                    "balance": "23.45018235",
                    "value": "22.992864174376344"
                },
                {
                    "coin": "USDT",
                    "symbols": "AGIUSDT,WIFUSDT",
                    "balance": "10002",
                    "value": "9998.896846613574"
                },
                {
                    "coin": "USDT",
                    "symbols": "",
                    "balance": "10148045273.618073",
                    "value": "10144896808.587431"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1714028451228
    }
    - + \ No newline at end of file diff --git a/v5/market/iv.html b/v5/market/iv.html index 1724d70ac2..d9777a462b 100644 --- a/v5/market/iv.html +++ b/v5/market/iv.html @@ -4,13 +4,13 @@ Get Historical Volatility | Bybit API Documentation - +

    Get Historical Volatility

    Query option historical volatility

    Covers: Option

    info
    • The data is hourly.
    • If both startTime and endTime are not specified, it will return the most recent 1 hours worth of data.
    • startTime and endTime are a pair of params. Either both are passed or they are not passed at all.
    • This endpoint can query the last 2 years worth of data, but make sure [endTime - startTime] <= 30 days.

    HTTP Request​

    GET /v5/market/historical-volatility

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. option
    baseCoinfalsestringBase coin, uppercase only. Default: return BTC data
    periodfalseintegerPeriod. If not specified, it will return data with a 7-day average by default
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > periodintegerPeriod
    > valuestringVolatility
    > timestringTimestamp (ms)

    Request Example​

    GET /v5/market/historical-volatility?category=option&baseCoin=ETH&period=30 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "category": "option",
        "result": [
            {
                "period": 30,
                "value": "0.45024716",
                "time": "1672052400000"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/market/kline.html b/v5/market/kline.html index 0a555d0e6b..3125e68487 100644 --- a/v5/market/kline.html +++ b/v5/market/kline.html @@ -4,13 +4,13 @@ Get Kline | Bybit API Documentation - +

    Get Kline

    Query for historical klines (also known as candles/candlesticks). Charts are returned in groups based on the requested interval.

    Covers: Spot / USDT perpetual / USDC contract / Inverse contract

    HTTP Request​

    GET /v5/market/kline

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. spot,linear,inverse
  • When category is not passed, use linear by default
    • symboltruestringSymbol name, like BTCUSDT, uppercase only
    intervaltruestringKline interval. 1,3,5,15,30,60,120,240,360,720,D,M,W
    startfalseintegerThe start timestamp (ms)
    endfalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    symbolstringSymbol name
    listarray
    • An string array of individual candle
    • Sort in reverse by startTime
    > list[0]: startTimestringStart time of the candle (ms)
    > list[1]: openPricestringOpen price
    > list[2]: highPricestringHighest price
    > list[3]: lowPricestringLowest price
    > list[4]: closePricestringClose price. Is the last traded price when the candle is not closed
    > list[5]: volumestringTrade volume. Unit of contract: pieces of contract. Unit of spot: quantity of coins
    > list[6]: turnoverstringTurnover. Unit of figure: quantity of quota coin

    Request Example​

    GET /v5/market/kline?category=inverse&symbol=BTCUSD&interval=60&start=1670601600000&end=1670608800000 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSD",
            "category": "inverse",
            "list": [
                [
                    "1670608800000",
                    "17071",
                    "17073",
                    "17027",
                    "17055.5",
                    "268611",
                    "15.74462667"
                ],
                [
                    "1670605200000",
                    "17071.5",
                    "17071.5",
                    "17061",
                    "17071",
                    "4177",
                    "0.24469757"
                ],
                [
                    "1670601600000",
                    "17086.5",
                    "17088",
                    "16978",
                    "17071.5",
                    "6356",
                    "0.37288112"
                ]
            ]
        },
        "retExtInfo": {},
        "time": 1672025956592
    }
    - + \ No newline at end of file diff --git a/v5/market/long-short-ratio.html b/v5/market/long-short-ratio.html index 4818ce10c1..f403d08edd 100644 --- a/v5/market/long-short-ratio.html +++ b/v5/market/long-short-ratio.html @@ -4,13 +4,13 @@ Get Long Short Ratio | Bybit API Documentation - +

    Get Long Short Ratio

    HTTP Request​

    GET /v5/market/account-ratio

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear(USDT Perpetual),inverse
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    periodtruestringData recording period. 5min, 15min, 30min, 1h, 4h, 1d
    limitfalseintegerLimit for data size per page. [1, 500]. Default: 50

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > symbolstringSymbol name
    > buyRatiostringThe ratio of users with net long position
    > sellRatiostringThe ratio of users with net short position
    > timestampstringTimestamp (ms)

    Request Example​

    GET /v5/market/account-ratio?category=linear&symbol=BTCUSDT&period=1d&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "buyRatio": "0.5777",
                    "sellRatio": "0.4223",
                    "timestamp": "1695772800000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1695785131028
    }
    - + \ No newline at end of file diff --git a/v5/market/mark-kline.html b/v5/market/mark-kline.html index d10e4fd60a..493c27fb67 100644 --- a/v5/market/mark-kline.html +++ b/v5/market/mark-kline.html @@ -4,13 +4,13 @@ Get Mark Price Kline | Bybit API Documentation - +

    Get Mark Price Kline

    Query for historical mark price klines. Charts are returned in groups based on the requested interval.

    Covers: USDT perpetual / USDC contract / Inverse contract

    HTTP Request​

    GET /v5/market/mark-price-kline

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear,inverse
  • When category is not passed, use linear by default
    • symboltruestringSymbol name, like BTCUSDT, uppercase only
    intervaltruestringKline interval. 1,3,5,15,30,60,120,240,360,720,D,M,W
    startfalseintegerThe start timestamp (ms)
    endfalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    symbolstringSymbol name
    listarray
    • An string array of individual candle
    • Sort in reverse by startTime
    > list[0]: startTimestringStart time of the candle (ms)
    > list[1]: openPricestringOpen price
    > list[2]: highPricestringHighest price
    > list[3]: lowPricestringLowest price
    > list[4]: closePricestringClose price. Is the last traded price when the candle is not closed

    Request Example​

    GET /v5/market/mark-price-kline?category=linear&symbol=BTCUSDT&interval=15&start=1670601600000&end=1670608800000&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "category": "linear",
            "list": [
                [
                "1670608800000",
                "17164.16",
                "17164.16",
                "17121.5",
                "17131.64"
                ]
            ]
        },
        "retExtInfo": {},
        "time": 1672026361839
    }
    - + \ No newline at end of file diff --git a/v5/market/open-interest.html b/v5/market/open-interest.html index 1fc2b2a43c..33081721e4 100644 --- a/v5/market/open-interest.html +++ b/v5/market/open-interest.html @@ -4,13 +4,13 @@ Get Open Interest | Bybit API Documentation - +

    Get Open Interest

    Get the open interest of each symbol.

    Covers: USDT perpetual / USDC contract / Inverse contract

    info
    • The upper limit time you can query is the launch time of the symbol.

    HTTP Request​

    GET /v5/market/open-interest

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear,inverse
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    intervalTimetruestringInterval time. 5min,15min,30min,1h,4h,1d
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 50
    cursorfalsestringCursor. Used to paginate

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    symbolstringSymbol name
    listarrayObject
    > openIntereststringOpen interest. The value is the sum of both sides
    > timestampstringThe timestamp (ms)
    nextPageCursorstringUsed to paginate

    Request Example​

    GET /v5/market/open-interest?category=inverse&symbol=BTCUSD&intervalTime=5min&startTime=1669571100000&endTime=1669571400000 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSD",
            "category": "inverse",
            "list": [
                {
                    "openInterest": "461134384.00000000",
                    "timestamp": "1669571400000"
                },
                {
                    "openInterest": "461134292.00000000",
                    "timestamp": "1669571100000"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1672053548579
    }
    - + \ No newline at end of file diff --git a/v5/market/orderbook.html b/v5/market/orderbook.html index e76e85c4f3..f70c4be5c3 100644 --- a/v5/market/orderbook.html +++ b/v5/market/orderbook.html @@ -4,13 +4,13 @@ Get Orderbook | Bybit API Documentation - +

    Get Orderbook

    Query for orderbook depth data.

    Covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option

    • Contract: 500-level of orderbook data
    • Spot: 200-level of orderbook data
    • Option: 25-level of orderbook data
    info

    The response is in the snapshot format.

    HTTP Request​

    GET /v5/market/orderbook

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. spot, linear, inverse, option
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    limitfalseintegerLimit size for each bid and ask
    • spot: [1, 200]. Default: 1.
    • linear&inverse: [1, 500]. Default: 25.
    • option: [1, 25]. Default: 1.

    Response Parameters​

    ParameterTypeComments
    sstringSymbol name
    barrayBid, buyer. Sort by price desc
    > b[0]stringBid price
    > b[1]stringBid size
    aarrayAsk, seller. Order by price asc
    > a[0]stringAsk price
    > a[1]stringAsk size
    tsintegerThe timestamp (ms) that the system generates the data
    uintegerUpdate ID, is always in sequence
    • For contract, it is corresponding to u in the wss 500-level orderbook
    • For spot, it is corresponding to u in the wss 200-level orderbook
    seqintegerCross sequence
  • You can use this field to compare different levels orderbook data, and for the smaller seq, then it means the data is generated earlier.
  • Option does not have this field currently
    • ctsintegerThe timestamp from the match engine when this orderbook data is produced. It can be correlated with T from public trade channel. linear, inverse, spot have this field

    Request Example​

    GET /v5/market/orderbook?category=spot&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "s": "BTCUSDT",
            "a": [
                [
                    "65557.7",
                    "16.606555"
                ]
            ],
            "b": [
                [
                    "65485.47",
                    "47.081829"
                ]
            ],
            "ts": 1716863719031,
            "u": 230704,
            "seq": 1432604333,
            "cts": 1716863718905
        },
        "retExtInfo": {},
        "time": 1716863719382
    }
    - + \ No newline at end of file diff --git a/v5/market/preimum-index-kline.html b/v5/market/preimum-index-kline.html index f5e7a8a80e..197ec6dc9d 100644 --- a/v5/market/preimum-index-kline.html +++ b/v5/market/preimum-index-kline.html @@ -4,13 +4,13 @@ Get Premium Index Price Kline | Bybit API Documentation - +

    Get Premium Index Price Kline

    Query for historical premium index klines. Charts are returned in groups based on the requested interval.

    Covers: USDT and USDC perpetual

    HTTP Request​

    GET /v5/market/premium-index-price-kline

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    intervaltruestringKline interval
    startfalseintegerThe start timestamp (ms)
    endfalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    symbolstringSymbol name
    listarray
    • An string array of individual candle
    • Sort in reverse by start
    > list[0]stringStart time of the candle (ms)
    > list[1]stringOpen price
    > list[2]stringHighest price
    > list[3]stringLowest price
    > list[4]stringClose price. Is the last traded price when the candle is not closed

    Request Example​

    GET /v5/market/premium-index-price-kline?category=linear&symbol=BTCUSDT&interval=D&start=1652112000000&end=1652544000000 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "category": "linear",
            "list": [
                [
                    "1652486400000",
                    "-0.000587",
                    "-0.000344",
                    "-0.000480",
                    "-0.000344"
                ],
                [
                    "1652400000000",
                    "-0.000989",
                    "-0.000561",
                    "-0.000587",
                    "-0.000587"
                ]
            ]
        },
        "retExtInfo": {},
        "time": 1672765216291
    }
    - + \ No newline at end of file diff --git a/v5/market/recent-trade.html b/v5/market/recent-trade.html index c4b96b0618..d9f7f8e9f7 100644 --- a/v5/market/recent-trade.html +++ b/v5/market/recent-trade.html @@ -4,13 +4,13 @@ Get Public Recent Trading History | Bybit API Documentation - +

    Get Public Recent Trading History

    Query recent public trading data in Bybit.

    Covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option

    You can download archived historical trades from the website

    HTTP Request​

    GET /v5/market/recent-trade

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. spot,linear,inverse,option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    • required for spot/linear/inverse
    • optional for option
    baseCoinfalsestringBase coin, uppercase only
  • Apply to option only
  • If the field is not passed, return BTC data by default
    • optionTypefalsestringOption type. Call or Put. Apply to option only
    limitfalseintegerLimit for data size per page
    • spot: [1,60], default: 60
    • others: [1,1000], default: 500

    Response Parameters​

    ParameterTypeComments
    categorystringProducts category
    listarrayObject
    > execIdstringExecution ID
    > symbolstringSymbol name
    > pricestringTrade price
    > sizestringTrade size
    > sidestringSide of taker Buy, Sell
    > timestringTrade time (ms)
    > isBlockTradebooleanWhether the trade is block trade
    > mPstringMark price, unique field for option
    > iPstringIndex price, unique field for option
    > mIvstringMark iv, unique field for option
    > ivstringiv, unique field for option

    Request Example​

    GET /v5/market/recent-trade?category=spot&symbol=BTCUSDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "spot",
            "list": [
                {
                    "execId": "2100000000007764263",
                    "symbol": "BTCUSDT",
                    "price": "16618.49",
                    "size": "0.00012",
                    "side": "Buy",
                    "time": "1672052955758",
                    "isBlockTrade": false
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672053054358
    }
    - + \ No newline at end of file diff --git a/v5/market/risk-limit.html b/v5/market/risk-limit.html index f351148761..ec8c2d7dbb 100644 --- a/v5/market/risk-limit.html +++ b/v5/market/risk-limit.html @@ -4,13 +4,13 @@ Get Risk Limit | Bybit API Documentation - +

    Get Risk Limit

    Query for the risk limit.

    Covers: USDT perpetual / USDC contract / Inverse contract

    info

    category=linear returns data set of 30 symbols each request, please use cursor to get next data set.

    HTTP Request​

    GET /v5/market/risk-limit

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear,inverse
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > idintegerRisk ID
    > symbolstringSymbol name
    > riskLimitValuestringPosition limit
    > maintenanceMarginnumberMaintain margin rate
    > initialMarginnumberInitial margin rate
    > isLowestRiskinteger1: true, 0: false
    > maxLeveragestringAllowed max leverage
    > mmDeductionstringThe maintenance margin deduction value when risk limit tier changed
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/market/risk-limit?category=inverse&symbol=BTCUSD HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "inverse",
            "list": [
                {
                    "id": 1,
                    "symbol": "BTCUSD",
                    "riskLimitValue": "150",
                    "maintenanceMargin": "0.5",
                    "initialMargin": "1",
                    "isLowestRisk": 1,
                    "maxLeverage": "100.00",
                    "mmDeduction": ""
                },
            ....
            ]
        },
        "retExtInfo": {},
        "time": 1672054488010
    }
    - + \ No newline at end of file diff --git a/v5/market/tickers.html b/v5/market/tickers.html index b92939885f..6e5c5663ae 100644 --- a/v5/market/tickers.html +++ b/v5/market/tickers.html @@ -4,13 +4,13 @@ Get Tickers | Bybit API Documentation - +

    Get Tickers

    Query for the latest price snapshot, best bid/ask price, and trading volume in the last 24 hours.

    Covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option

    info

    If category=option, symbol or baseCoin must be passed.

    HTTP Request​

    GET /v5/market/tickers

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. spot,linear,inverse,option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    baseCoinfalsestringBase coin, uppercase only. Apply to option only
    expDatefalsestringExpiry date. e.g., 25DEC22. Apply to option only

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > lastPricestringLast price
    > indexPricestringIndex price
    > markPricestringMark price
    > prevPrice24hstringMarket price 24 hours ago
    > price24hPcntstringPercentage change of market price relative to 24h
    > highPrice24hstringThe highest price in the last 24 hours
    > lowPrice24hstringThe lowest price in the last 24 hours
    > prevPrice1hstringMarket price an hour ago
    > openIntereststringOpen interest size
    > openInterestValuestringOpen interest value
    > turnover24hstringTurnover for 24h
    > volume24hstringVolume for 24h
    > fundingRatestringFunding rate
    > nextFundingTimestringNext funding time (ms)
    > predictedDeliveryPricestringPredicated delivery price. It has value when 30 min before delivery
    > basisRatestringBasis rate
    > basisstringBasis
    > deliveryFeeRatestringDelivery fee rate
    > deliveryTimestringDelivery timestamp (ms)
    > ask1SizestringBest ask size
    > bid1PricestringBest bid price
    > ask1PricestringBest ask price
    > bid1SizestringBest bid size
    > preOpenPricestringEstimated pre-market contract open price
  • The value is meaningless when entering continuous trading phase
    • > preQtystringEstimated pre-market contract open qty
  • The value is meaningless when entering continuous trading phase
    • > curPreListingPhasestringThe current pre-market contract phase

    Request Example​

    GET /v5/market/tickers?category=inverse&symbol=BTCUSD HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "inverse",
            "list": [
                {
                    "symbol": "BTCUSD",
                    "lastPrice": "16597.00",
                    "indexPrice": "16598.54",
                    "markPrice": "16596.00",
                    "prevPrice24h": "16464.50",
                    "price24hPcnt": "0.008047",
                    "highPrice24h": "30912.50",
                    "lowPrice24h": "15700.00",
                    "prevPrice1h": "16595.50",
                    "openInterest": "373504107",
                    "openInterestValue": "22505.67",
                    "turnover24h": "2352.94950046",
                    "volume24h": "49337318",
                    "fundingRate": "-0.001034",
                    "nextFundingTime": "1672387200000",
                    "predictedDeliveryPrice": "",
                    "basisRate": "",
                    "deliveryFeeRate": "",
                    "deliveryTime": "0",
                    "ask1Size": "1",
                    "bid1Price": "16596.00",
                    "ask1Price": "16597.50",
                    "bid1Size": "1",
                    "basis": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672376496682
    }
    - + \ No newline at end of file diff --git a/v5/market/time.html b/v5/market/time.html index b364f311f8..112e4a8fab 100644 --- a/v5/market/time.html +++ b/v5/market/time.html @@ -4,13 +4,13 @@ Get Bybit Server Time | Bybit API Documentation - +

    Get Bybit Server Time

    HTTP Request​

    GET /v5/market/time

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    timeSecondstringBybit server timestamp (sec)
    timeNanostringBybit server timestamp (nano)

    Request Example​

    GET /v5/market/time HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "timeSecond": "1688639403",
            "timeNano": "1688639403423213947"
        },
        "retExtInfo": {},
        "time": 1688639403423
    }
    - + \ No newline at end of file diff --git a/v5/order/amend-order.html b/v5/order/amend-order.html index 283e277696..1ee6eda5d9 100644 --- a/v5/order/amend-order.html +++ b/v5/order/amend-order.html @@ -4,16 +4,16 @@ Amend Order | Bybit API Documentation - +
    -

    Amend Order

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option
    +

    Amend Order

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option
    Classic account covers: Spot / USDT perpetual / Inverse contract

    important

    You can only modify unfilled or partially filled orders.

    Websocket logic for Spot

    Classic account: if the original Spot order is a PostOnly order, and after the modification, the order becomes a taker order, then you will receive orderStatus="New" ws message first, followed by orderStatus="Rejected" ws message.

    Unified account: if the original Spot order is a PostOnly order, and after the modification, the order becomes a taker order, then you will directly receive orderStatus="Rejected" ws message.

    HTTP Request​

    POST /v5/order/amend

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse, spot, option
    • Classic account: linear, inverse, spot
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    orderIdfalsestringOrder ID. Either orderId or orderLinkId is required
    orderLinkIdfalsestringUser customised order ID. Either orderId or orderLinkId is required
    orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed
    triggerPricefalsestring
    • For Perps & Futures, it is the conditional order trigger price. If you expect the price to rise to trigger your conditional order, make sure:
      triggerPrice > market price
      Else, triggerPrice < market price
    • For spot, it is the TP/SL and Conditional order trigger price
    qtyfalsestringOrder quantity after modification. Do not pass it if not modify the qty
    pricefalsestringOrder price after modification. Do not pass it if not modify the price
    tpslModefalsestringTP/SL mode
    • Full: entire position for TP/SL. Then, tpOrderType or slOrderType must be Market
    • Partial: partial position tp/sl. Limit TP/SL order are supported. Note: When create limit tp/sl, tpslMode is required and it must be Partial
    Valid for linear & inverse
    takeProfitfalsestringTake profit price after modification. If pass "0", it means cancel the existing take profit of the order. Do not pass it if you do not want to modify the take profit. valid for spot(UTA), linear, inverse
    stopLossfalsestringStop loss price after modification. If pass "0", it means cancel the existing stop loss of the order. Do not pass it if you do not want to modify the stop loss. valid for spot(UTA), linear, inverse
    tpTriggerByfalsestringThe price type to trigger take profit. When set a take profit, this param is required if no initial value for the order
    slTriggerByfalsestringThe price type to trigger stop loss. When set a take profit, this param is required if no initial value for the order
    triggerByfalsestringTrigger price type
    tpLimitPricefalsestringLimit order price when take profit is triggered. Only working when original order sets partial limit tp/sl. valid for spot(UTA), linear, inverse
    slLimitPricefalsestringLimit order price when stop loss is triggered. Only working when original order sets partial limit tp/sl. valid for spot(UTA), linear, inverse
    info

    The ack of amend order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order ID

    Request Example​

    POST /v5/order/amend HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672217108106
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "ETHPERP",
        "orderLinkId": "linear-004",
        "triggerPrice": "1145",
        "qty": "0.15",
        "price": "1050",
        "takeProfit": "0",
        "stopLoss": "0"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
            "orderLinkId": "linear-004"
        },
        "retExtInfo": {},
        "time": 1672217093461
    }
    - + \ No newline at end of file diff --git a/v5/order/batch-amend.html b/v5/order/batch-amend.html index cbb461ef14..db398782c5 100644 --- a/v5/order/batch-amend.html +++ b/v5/order/batch-amend.html @@ -4,13 +4,13 @@ Batch Amend Order | Bybit API Documentation - +
    -

    Batch Amend Order

    Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)

    tip

    This endpoint allows you to amend more than one open order in a single request.

    • You can modify unfilled or partially filled orders. Conditional orders are not supported.
    • A maximum of 20 orders (option), 10 orders (linear) & 10 orders (spot) can be amended per request.

    HTTP Request​

    POST /v5/order/amend-batch

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option, spot
    requesttruearrayObject
    > symboltruestringSymbol name, like BTCUSDT, uppercase only
    > orderIdfalsestringOrder ID. Either orderId or orderLinkId is required
    > orderLinkIdfalsestringUser customised order ID. Either orderId or orderLinkId is required
    > orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed
    > triggerPricefalsestring
    • For Perps & Futures, it is the conditional order trigger price. If you expect the price to rise to trigger your conditional order, make sure:
      triggerPrice > market price
      Else, triggerPrice < market price
    • For spot, it is for tpslOrder or stopOrder trigger price
    > qtyfalsestringOrder quantity after modification. Do not pass it if not modify the qty
    > pricefalsestringOrder price after modification. Do not pass it if not modify the price
    > tpslModefalsestringTP/SL mode
    • Full: entire position for TP/SL. Then, tpOrderType or slOrderType must be Market
    • Partial: partial position tp/sl. Limit TP/SL order are supported. Note: When create limit tp/sl, tpslMode is required and it must be Partial
    Valid for linear
    > takeProfitfalsestringTake profit price after modification. If pass "0", it means cancel the existing take profit of the order. Do not pass it if you do not want to modify the take profit. valid for spot, linear
    > stopLossfalsestringStop loss price after modification. If pass "0", it means cancel the existing stop loss of the order. Do not pass it if you do not want to modify the stop loss. valid for spot, linear
    > tpTriggerByfalsestringThe price type to trigger take profit. When set a take profit, this param is required if no initial value for the order
    > slTriggerByfalsestringThe price type to trigger stop loss. When set a take profit, this param is required if no initial value for the order
    > triggerByfalsestringTrigger price type
    > tpLimitPricefalsestringLimit order price when take profit is triggered. Only working when original order sets partial limit tp/sl. valid for spot, linear
    > slLimitPricefalsestringLimit order price when stop loss is triggered. Only working when original order sets partial limit tp/sl. valid for spot, linear

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> categorystringProduct type
    >> symbolstringSymbol name
    >> orderIdstringOrder ID
    >> orderLinkIdstringUser customised order ID
    retExtInfoObject
    > listarrayObject
    >> codenumberSuccess/error code
    >> msgstringSuccess/error message
    info

    The ack of amend order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Request Example​

    POST /v5/order/amend-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672222935987
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "option",
        "request": [
            {
                "symbol": "ETH-30DEC22-500-C",
                "qty": null,
                "price": null,
                "orderIv": "6.8",
                "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2"
            },
            {
                "symbol": "ETH-30DEC22-700-C",
                "qty": null,
                "price": "650",
                "orderIv": null,
                "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52"
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "option",
                    "symbol": "ETH-30DEC22-500-C",
                    "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2",
                    "orderLinkId": ""
                },
                {
                    "category": "option",
                    "symbol": "ETH-30DEC22-700-C",
                    "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52",
                    "orderLinkId": ""
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 0,
                    "msg": "OK"
                }
            ]
        },
        "time": 1672222808060
    }
    - +

    Batch Amend Order

    Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)

    tip

    This endpoint allows you to amend more than one open order in a single request.

    • You can modify unfilled or partially filled orders. Conditional orders are not supported.
    • A maximum of 20 orders (option), 10 orders (linear) & 10 orders (spot) can be amended per request.

    HTTP Request​

    POST /v5/order/amend-batch

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option, spot
    requesttruearrayObject
    > symboltruestringSymbol name, like BTCUSDT, uppercase only
    > orderIdfalsestringOrder ID. Either orderId or orderLinkId is required
    > orderLinkIdfalsestringUser customised order ID. Either orderId or orderLinkId is required
    > orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed
    > triggerPricefalsestring
    • For Perps & Futures, it is the conditional order trigger price. If you expect the price to rise to trigger your conditional order, make sure:
      triggerPrice > market price
      Else, triggerPrice < market price
    • For spot, it is for tpslOrder or stopOrder trigger price
    > qtyfalsestringOrder quantity after modification. Do not pass it if not modify the qty
    > pricefalsestringOrder price after modification. Do not pass it if not modify the price
    > tpslModefalsestringTP/SL mode
    • Full: entire position for TP/SL. Then, tpOrderType or slOrderType must be Market
    • Partial: partial position tp/sl. Limit TP/SL order are supported. Note: When create limit tp/sl, tpslMode is required and it must be Partial
    Valid for linear
    > takeProfitfalsestringTake profit price after modification. If pass "0", it means cancel the existing take profit of the order. Do not pass it if you do not want to modify the take profit. valid for spot, linear
    > stopLossfalsestringStop loss price after modification. If pass "0", it means cancel the existing stop loss of the order. Do not pass it if you do not want to modify the stop loss. valid for spot, linear
    > tpTriggerByfalsestringThe price type to trigger take profit. When set a take profit, this param is required if no initial value for the order
    > slTriggerByfalsestringThe price type to trigger stop loss. When set a take profit, this param is required if no initial value for the order
    > triggerByfalsestringTrigger price type
    > tpLimitPricefalsestringLimit order price when take profit is triggered. Only working when original order sets partial limit tp/sl. valid for spot, linear
    > slLimitPricefalsestringLimit order price when stop loss is triggered. Only working when original order sets partial limit tp/sl. valid for spot, linear

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> categorystringProduct type
    >> symbolstringSymbol name
    >> orderIdstringOrder ID
    >> orderLinkIdstringUser customised order ID
    retExtInfoObject
    > listarrayObject
    >> codenumberSuccess/error code
    >> msgstringSuccess/error message
    info

    The ack of amend order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Request Example​

    POST /v5/order/amend-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672222935987
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "option",
        "request": [
            {
                "symbol": "ETH-30DEC22-500-C",
                "qty": null,
                "price": null,
                "orderIv": "6.8",
                "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2"
            },
            {
                "symbol": "ETH-30DEC22-700-C",
                "qty": null,
                "price": "650",
                "orderIv": null,
                "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52"
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "option",
                    "symbol": "ETH-30DEC22-500-C",
                    "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2",
                    "orderLinkId": ""
                },
                {
                    "category": "option",
                    "symbol": "ETH-30DEC22-700-C",
                    "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52",
                    "orderLinkId": ""
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 0,
                    "msg": "OK"
                }
            ]
        },
        "time": 1672222808060
    }
    + \ No newline at end of file diff --git a/v5/order/batch-cancel.html b/v5/order/batch-cancel.html index 28d636d314..ecae77aab6 100644 --- a/v5/order/batch-cancel.html +++ b/v5/order/batch-cancel.html @@ -4,13 +4,13 @@ Batch Cancel Order | Bybit API Documentation - +
    -

    Batch Cancel Order

    This endpoint allows you to cancel more than one open order in a single request.

    Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)

    important
    • You must specify orderId or orderLinkId.
    • If orderId and orderLinkId is not matched, the system will process orderId first.
    • You can cancel unfilled or partially filled orders.
    • A maximum of 20 orders (option) & 10 orders (linear) & 10 orders (spot) can be cancelled per request.

    HTTP Request​

    POST /v5/order/cancel-batch

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option, spot
    requesttruearrayObject
    > symboltruestringSymbol name, like BTCUSDT, uppercase only
    > orderIdfalsestringOrder ID. Either orderId or orderLinkId is required
    > orderLinkIdfalsestringUser customised order ID. Either orderId or orderLinkId is required

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> categorystringProduct type
    >> symbolstringSymbol name
    >> orderIdstringOrder ID
    >> orderLinkIdstringUser customised order ID
    retExtInfoObject
    > listarrayObject
    >> codenumberSuccess/error code
    >> msgstringSuccess/error message
    info

    The ack of cancel order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Request Example​

    POST /v5/order/cancel-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672223356634
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "spot",
        "request": [
            {
                "symbol": "BTCUSDT",
                "orderId": "1666800494330512128"
            },
            {
                "symbol": "ATOMUSDT",
                "orderLinkId": "1666800494330512129"
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "spot",
                    "symbol": "BTCUSDT",
                    "orderId": "1666800494330512128",
                    "orderLinkId": "spot-btc-03"
                },
                {
                    "category": "spot",
                    "symbol": "ATOMUSDT",
                    "orderId": "",
                    "orderLinkId": "1666800494330512129"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 170213,
                    "msg": "Order does not exist."
                }
            ]
        },
        "time": 1713434299047
    }
    - +

    Batch Cancel Order

    This endpoint allows you to cancel more than one open order in a single request.

    Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)

    important
    • You must specify orderId or orderLinkId.
    • If orderId and orderLinkId is not matched, the system will process orderId first.
    • You can cancel unfilled or partially filled orders.
    • A maximum of 20 orders (option) & 10 orders (linear) & 10 orders (spot) can be cancelled per request.

    HTTP Request​

    POST /v5/order/cancel-batch

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear, option, spot
    requesttruearrayObject
    > symboltruestringSymbol name, like BTCUSDT, uppercase only
    > orderIdfalsestringOrder ID. Either orderId or orderLinkId is required
    > orderLinkIdfalsestringUser customised order ID. Either orderId or orderLinkId is required

    Response Parameters​

    ParameterTypeComments
    resultObject
    > listarrayObject
    >> categorystringProduct type
    >> symbolstringSymbol name
    >> orderIdstringOrder ID
    >> orderLinkIdstringUser customised order ID
    retExtInfoObject
    > listarrayObject
    >> codenumberSuccess/error code
    >> msgstringSuccess/error message
    info

    The ack of cancel order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Request Example​

    POST /v5/order/cancel-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672223356634
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "spot",
        "request": [
            {
                "symbol": "BTCUSDT",
                "orderId": "1666800494330512128"
            },
            {
                "symbol": "ATOMUSDT",
                "orderLinkId": "1666800494330512129"
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "spot",
                    "symbol": "BTCUSDT",
                    "orderId": "1666800494330512128",
                    "orderLinkId": "spot-btc-03"
                },
                {
                    "category": "spot",
                    "symbol": "ATOMUSDT",
                    "orderId": "",
                    "orderLinkId": "1666800494330512129"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 170213,
                    "msg": "Order does not exist."
                }
            ]
        },
        "time": 1713434299047
    }
    + \ No newline at end of file diff --git a/v5/order/batch-place.html b/v5/order/batch-place.html index 87c08daf62..d86db94af5 100644 --- a/v5/order/batch-place.html +++ b/v5/order/batch-place.html @@ -4,18 +4,18 @@ Batch Place Order | Bybit API Documentation - +
    -

    Batch Place Order

    Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)

    tip

    This endpoint allows you to place more than one order in a single request.

    • Make sure you have sufficient funds in your account when placing an order. Once an order is placed, according to the +

      Batch Place Order

      Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)

      tip

      This endpoint allows you to place more than one order in a single request.

      • Make sure you have sufficient funds in your account when placing an order. Once an order is placed, according to the funds required by the order, the funds in your account will be frozen by the corresponding amount during the life cycle of the order.
      • A maximum of 20 orders (option) & 10 orders (linear) & 10 orders (spot) can be placed per request. The returned data list is divided into two lists. The first list indicates whether or not the order creation was successful and the second list details the created order information. The structure of the two lists are completely consistent.
      info

      • Check the rate limit instruction when category=linear or spot here

      • Risk control limit notice:
        Bybit will monitor on your API requests. When the total number of orders of a single user (aggregated the number of orders across main account and sub-accounts) within a day (UTC 0 - UTC 24) exceeds a certain upper limit, the platform will reserve the right to remind, warn, and impose necessary restrictions. Customers who use API default to acceptance of these terms and have the obligation to cooperate with adjustments.

      HTTP Request​

      POST /v5/order/create-batch

      Request Parameters​

      ParameterRequiredTypeComments
      categorytruestringProduct type. linear, option, spot
      requesttruearrayObject
      > symboltruestringSymbol name, like BTCUSDT, uppercase only
      > isLeveragefalseintegerWhether to borrow. Valid for Unified spot only. 0(default): false then spot trading, 1: true then margin trading
      > sidetruestringBuy, Sell
      > orderTypetruestringMarket, Limit
      > qtytruestringOrder quantity
      • UTA account
        • Spot: set marketUnit for market order qty unit, quoteCoin for market buy by default, baseCoin for market sell by default
        • Perps, Futures & Option: always use base coin as unit
      • Perps & Futures: if you pass qty="0" and specify reduceOnly=true&closeOnTrigger=true, you can close the position up to maxMktOrderQty or maxOrderQty shown on Get Instruments Info of current symbol
      > marketUnitfalsestringThe unit for qty when create Spot market orders for UTA account, orderFilter=tpslOrder and StopOrder are supported as well.
    • baseCoin: for example, buy BTCUSDT, then "qty" unit is BTC
    • quoteCoin: for example, sell BTCUSDT, then "qty" unit is USDT
      • > pricefalsestringOrder price
      • Market order will ignore this field
      • Please check the min price and price precision from instrument info endpoint
      • If you have position, price needs to be better than liquidation price
      > triggerDirectionfalseintegerConditional order param. Used to identify the expected direction of the conditional order.
      • 1: triggered when market price rises to triggerPrice
      • 2: triggered when market price falls to triggerPrice
      Valid for linear
      > orderFilterfalsestringIf it is not passed, Order by default.
      • Order
      • tpslOrder: Spot TP/SL order, the assets are occupied even before the order is triggered
      • StopOrder: Spot conditional order, the assets will not be occupied until the price of the underlying asset reaches the trigger price, and the required assets will be occupied after the Conditional order is triggered
      Valid for spot only
      > triggerPricefalsestring
      • For Perps & Futures, it is the conditional order trigger price. If you expect the price to rise to trigger your conditional order, make sure:
        triggerPrice > market price
        Else, triggerPrice < market price
      • For spot, it is the orderFilter=tpslOrder, or orderFilter=stopOrder trigger price
      > triggerByfalsestringConditional order param (Perps & Futures). Trigger price type. LastPrice, IndexPrice, MarkPrice
      > orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed. orderIv has a higher priority when price is passed as well
      > timeInForcefalsestringTime in force
      • Market order will use IOC directly
      • If not passed, GTC is used by default
      > positionIdxfalseintegerUsed to identify positions in different position modes. Under hedge-mode, this param is required (USDT perps have hedge mode)
      • 0: one-way mode
      • 1: hedge-mode Buy side
      • 2: hedge-mode Sell side
      > orderLinkIdfalsestringUser customised order ID. A max of 36 characters. Combinations of numbers, letters (upper and lower cases), dashes, and underscores are supported.
      Futures, Perps & Spot: orderLinkId rules:
      • optional param
      • always unique
        • option orderLinkId rules:
      • required param
      • always unique
      > takeProfitfalsestringTake profit price, vaild for linear, spot
    • spot(UTA): Spot Limit order supports take profit, stop loss or limit take profit, limit stop loss when creating an order
      • > stopLossfalsestringStop loss price, vaild for linear, spot
    • spot(UTA): Spot Limit order supports take profit, stop loss or limit take profit, limit stop loss when creating an order
      • > tpTriggerByfalsestringThe price type to trigger take profit. MarkPrice, IndexPrice, default: LastPrice.
      Valid for linear
      > slTriggerByfalsestringThe price type to trigger stop loss. MarkPrice, IndexPrice, default: LastPrice
      Valid for linear
      > reduceOnlyfalsebooleanWhat is a reduce-only order? true means your position can only reduce in size if this order is triggered.
      • You must specify it as true when you are about to close/reduce the position
      • When reduceOnly is true, take profit/stop loss cannot be set
      Valid for linear, & option
      > closeOnTriggerfalsebooleanWhat is a close on trigger order? For a closing order. It can only reduce your position, not increase it. If the account has insufficient available balance when the closing order is triggered, then other active orders of similar contracts will be cancelled or reduced. It can be used to ensure your stop loss reduces your position regardless of current available margin.
      Valid for linear
      > smpTypefalsestringSmp execution type. What is SMP?
      > mmpfalsebooleanMarket maker protection. option only. true means set the order as a market maker protection order. What is mmp?
      > tpslModefalsestringTP/SL mode
      • Full: entire position for TP/SL. Then, tpOrderType or slOrderType must be Market
      • Partial: partial position tp/sl (as there is no size option, so it will create tp/sl orders with the qty you actually fill). Limit TP/SL order are supported. Note: When create limit tp/sl, tpslMode is required and it must be Partial
      Valid for linear
      > tpLimitPricefalsestringThe limit order price when take profit price is triggered
      • linear: only works when tpslMode=Partial and tpOrderType=Limit
      • Spot(UTA): it is required when the order has takeProfit and tpOrderType=Limit
      > slLimitPricefalsestringThe limit order price when stop loss price is triggered
      • linear: only works when tpslMode=Partial and slOrderType=Limit
      • Spot(UTA): it is required when the order has stopLoss and slOrderType=Limit
      > tpOrderTypefalsestringThe order type when take profit is triggered
      • linear: Market(default), Limit. For tpslMode=Full, it only supports tpOrderType=Market
      • Spot(UTA):
        Market: when you set "takeProfit",
        Limit: when you set "takeProfit" and "tpLimitPrice"
      > slOrderTypefalsestringThe order type when stop loss is triggered
      • linear: Market(default), Limit. For tpslMode=Full, it only supports slOrderType=Market
      • Spot(UTA):
        Market: when you set "stopLoss",
        Limit: when you set "stopLoss" and "slLimitPrice"

      Response Parameters​

      ParameterTypeComments
      resultObject
      > listarrayObject
      >> categorystringProduct type
      >> symbolstringSymbol name
      >> orderIdstringOrder ID
      >> orderLinkIdstringUser customised order ID
      >> createAtstringOrder created time (ms)
      retExtInfoObject
      > listarrayObject
      >> codenumberSuccess/error code
      >> msgstringSuccess/error message
      info

      The ack of create order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

      Request Example​

      POST /v5/order/create-batch HTTP/1.1
      Host: api-testnet.bybit.com
      X-BAPI-SIGN: XXXXX
      X-BAPI-API-KEY: XXXXX
      X-BAPI-TIMESTAMP: 1672222064519
      X-BAPI-RECV-WINDOW: 5000
      Content-Type: application/json

      {
          "category": "spot",
          "request": [
              {
                  "symbol": "BTCUSDT",
                  "side": "Buy",
                  "orderType": "Limit",
                  "isLeverage": 0,
                  "qty": "0.05",
                  "price": "30000",
                  "timeInForce": "GTC",
                  "orderLinkId": "spot-btc-03"
              },
              {
                  "symbol": "ATOMUSDT",
                  "side": "Sell",
                  "orderType": "Limit",
                  "isLeverage": 0,
                  "qty": "2",
                  "price": "12",
                  "timeInForce": "GTC",
                  "orderLinkId": "spot-atom-03"
              }
          ]
      }

      Response Example​

      {
          "retCode": 0,
          "retMsg": "OK",
          "result": {
              "list": [
                  {
                      "category": "spot",
                      "symbol": "BTCUSDT",
                      "orderId": "1666800494330512128",
                      "orderLinkId": "spot-btc-03",
                      "createAt": "1713434102752"
                  },
                  {
                      "category": "spot",
                      "symbol": "ATOMUSDT",
                      "orderId": "1666800494330512129",
                      "orderLinkId": "spot-atom-03",
                      "createAt": "1713434102752"
                  }
              ]
          },
          "retExtInfo": {
              "list": [
                  {
                      "code": 0,
                      "msg": "OK"
                  },
                  {
                      "code": 0,
                      "msg": "OK"
                  }
              ]
          },
          "time": 1713434102753
      }
    - + \ No newline at end of file diff --git a/v5/order/cancel-all.html b/v5/order/cancel-all.html index 264848c77d..6e3531cd68 100644 --- a/v5/order/cancel-all.html +++ b/v5/order/cancel-all.html @@ -4,16 +4,16 @@ Cancel All Orders | Bybit API Documentation - +
    -

    Cancel All Orders

    Cancel all open orders

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options
    +

    Cancel All Orders

    Cancel all open orders

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options
    Classic account covers: Spot / USDT perpetual / Inverse contract

    info
    • Support cancel orders by symbol/baseCoin/settleCoin. If you pass multiple of these params, the system will process one of param, which priority is symbol > baseCoin > settleCoin.
    • NOTE: category=option, you can cancel all option open orders without passing any of those three params. However, for linear and inverse, you must specify one of those three params.
    • NOTE: category=spot, you can cancel all spot open orders (normal order by default) without passing other params.
    info

    Spot: Classic account - cancel up to 500 orders; Unified account - no limit
    Futures: Classic account - cancel up to 500 orders; Unified account - cancel up to 500 orders
    -Options: Unified account - no limit

    HTTP Request​

    POST /v5/order/cancel-all

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only. linear & inverse: Required if not passing baseCoin or settleCoin
    baseCoinfalsestringBase coin, uppercase only
    • linear & inverse(Classic account): If cancel all by baseCoin, it will cancel all linear & inverse orders. Required if not passing symbol or settleCoin
    • linear & inverse(Unified account): If cancel all by baseCoin, it will cancel all corresponding category orders. Required if not passing symbol or settleCoin
    • Classic spot: invalid
    settleCoinfalsestringSettle coin, uppercase only
    • linear & inverse: Required if not passing symbol or baseCoin
    • Does not support spot
    orderFilterfalsestring
    • category=spot, you can pass Order, tpslOrder, StopOrder, OcoOrder, BidirectionalTpslOrder. If not passed, Order by default
    • category=linear or inverse, you can pass Order, StopOrder. If not passed, all kinds of orders will be cancelled, like active order, conditional order, TP/SL order and trailing stop order
    • category=option, you can pass Order. No matter it is passed or not, always cancel all orders
    stopOrderTypefalsestringStop order type Stop
  • Only used for category=linear or inverse and orderFilter=StopOrder,you can cancel conditional orders except TP/SL order and Trailing stop orders with this param
    • info

    The ack of cancel-all order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    successstring"1": success, "0": fail

    Request Example​

    POST /v5/order/cancel-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672219779140
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
      "category": "linear",
      "symbol": null,
      "settleCoin": "USDT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "1616024329462743808",
                    "orderLinkId": "1616024329462743809"
                },
                {
                    "orderId": "1616024287544869632",
                    "orderLinkId": "1616024287544869633"
                }
            ],
            "success": "1"
        },
        "retExtInfo": {},
        "time": 1707381118116
    }
    - +Options: Unified account - no limit

    HTTP Request​

    POST /v5/order/cancel-all

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only. linear & inverse: Required if not passing baseCoin or settleCoin
    baseCoinfalsestringBase coin, uppercase only
    • linear & inverse(Classic account): If cancel all by baseCoin, it will cancel all linear & inverse orders. Required if not passing symbol or settleCoin
    • linear & inverse(Unified account): If cancel all by baseCoin, it will cancel all corresponding category orders. Required if not passing symbol or settleCoin
    • Classic spot: invalid
    settleCoinfalsestringSettle coin, uppercase only
    • linear & inverse: Required if not passing symbol or baseCoin
    • Does not support spot
    orderFilterfalsestring
    • category=spot, you can pass Order, tpslOrder, StopOrder, OcoOrder, BidirectionalTpslOrder. If not passed, Order by default
    • category=linear or inverse, you can pass Order, StopOrder. If not passed, all kinds of orders will be cancelled, like active order, conditional order, TP/SL order and trailing stop order
    • category=option, you can pass Order. No matter it is passed or not, always cancel all orders
    stopOrderTypefalsestringStop order type Stop
  • Only used for category=linear or inverse and orderFilter=StopOrder,you can cancel conditional orders except TP/SL order and Trailing stop orders with this param
    • info

    The ack of cancel-all order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    successstring"1": success, "0": fail

    Request Example​

    POST /v5/order/cancel-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672219779140
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
      "category": "linear",
      "symbol": null,
      "settleCoin": "USDT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "1616024329462743808",
                    "orderLinkId": "1616024329462743809"
                },
                {
                    "orderId": "1616024287544869632",
                    "orderLinkId": "1616024287544869633"
                }
            ],
            "success": "1"
        },
        "retExtInfo": {},
        "time": 1707381118116
    }
    + \ No newline at end of file diff --git a/v5/order/cancel-order.html b/v5/order/cancel-order.html index 9f4f4eaa9c..15d5084082 100644 --- a/v5/order/cancel-order.html +++ b/v5/order/cancel-order.html @@ -4,14 +4,14 @@ Cancel Order | Bybit API Documentation - +
    -

    Cancel Order

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options
    -Classic account covers: Spot / USDT perpetual / Inverse contract

    important
    • You must specify orderId or orderLinkId to cancel the order.
    • If orderId and orderLinkId do not match, the system will process orderId first.
    • You can only cancel unfilled or partially filled orders.

    HTTP Request​

    POST /v5/order/cancel

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    orderIdfalsestringOrder ID. Either orderId or orderLinkId is required
    orderLinkIdfalsestringUser customised order ID. Either orderId or orderLinkId is required
    orderFilterfalsestringValid for spot only. Order,tpslOrder,StopOrder. If not passed, Order by default

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order ID
    info

    The ack of cancel order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Request Example​

    POST /v5/order/cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672217376681
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
      "category": "linear",
      "symbol": "BTCPERP",
      "orderLinkId": null,
      "orderId":"c6f055d9-7f21-4079-913d-e6523a9cfffa"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
            "orderLinkId": "linear-004"
        },
        "retExtInfo": {},
        "time": 1672217377164
    }
    - +

    Cancel Order

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options
    +Classic account covers: Spot / USDT perpetual / Inverse contract

    important
    • You must specify orderId or orderLinkId to cancel the order.
    • If orderId and orderLinkId do not match, the system will process orderId first.
    • You can only cancel unfilled or partially filled orders.

    HTTP Request​

    POST /v5/order/cancel

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    orderIdfalsestringOrder ID. Either orderId or orderLinkId is required
    orderLinkIdfalsestringUser customised order ID. Either orderId or orderLinkId is required
    orderFilterfalsestringValid for spot only. Order,tpslOrder,StopOrder. If not passed, Order by default

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order ID
    info

    The ack of cancel order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Request Example​

    POST /v5/order/cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672217376681
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
      "category": "linear",
      "symbol": "BTCPERP",
      "orderLinkId": null,
      "orderId":"c6f055d9-7f21-4079-913d-e6523a9cfffa"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
            "orderLinkId": "linear-004"
        },
        "retExtInfo": {},
        "time": 1672217377164
    }
    + \ No newline at end of file diff --git a/v5/order/create-order.html b/v5/order/create-order.html index 512a6c14e0..8d3696478a 100644 --- a/v5/order/create-order.html +++ b/v5/order/create-order.html @@ -4,12 +4,12 @@ Place Order | Bybit API Documentation - +
    -

    Place Order

    This endpoint supports to create the order for spot, spot margin, USDT perpetual, USDC perpetual, USDC futures, inverse futures and options.

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option
    +

    Place Order

    This endpoint supports to create the order for spot, spot margin, USDT perpetual, USDC perpetual, USDC futures, inverse futures and options.

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Option
    Classic account covers: Spot / USDT perpetual / Inverse contract

    info

    • Supported order type (orderType):
      Limit order: orderType=Limit, it is necessary to specify order qty and price.

      Market order: orderType=Market, execute at the best price in the Bybit market until the transaction is completed. When selecting a market order, the "price" can be empty. In the futures trading system, in order to protect the serious slippage of the market order, the Bybit trading system will convert the market order into a limit order for matching. will be cancelled. The slippage threshold refers to the percentage that the order price deviates from the latest transaction price. The current threshold is set to 3% for BTC contracts and 5% for other contracts.

    • Supported timeInForce strategy:
      GTC
      @@ -28,7 +28,7 @@ Customers who use API default to acceptance of these terms and have the obligation to cooperate with adjustments.

    Spot Stop Order

    Spot supports TP/SL order, Conditional order, however, the system logic is different between Classic account and Unified account
    Classic account: When the stop order is created, you will get an order ID. After it is triggered, you will get a new order ID
    Unified account: When the stop order is created, you will get an order ID. After it is triggered, the order ID will not be changed

    HTTP Request​

    POST /v5/order/create

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    isLeveragefalseintegerWhether to borrow. Valid for Unified spot only. 0(default): false then spot trading, 1: true then margin trading
    sidetruestringBuy, Sell
    orderTypetruestringMarket, Limit
    qtytruestringOrder quantity
    • UTA account
      • Spot: set marketUnit for market order qty unit, quoteCoin for market buy by default, baseCoin for market sell by default
      • Perps, Futures & Option: always use base coin as unit
    • Classic account
      • Spot: the unit of qty is quote coin for market buy order, for others, it is base coin
      • Perps, Futures: always use base coin as unit
    • Perps & Futures: if you pass qty="0" and specify reduceOnly=true&closeOnTrigger=true, you can close the position up to maxMktOrderQty or maxOrderQty shown on Get Instruments Info of current symbol
    marketUnitfalsestringThe unit for qty when create Spot market orders for UTA account, orderFilter=tpslOrder and StopOrder are supported as well.
  • baseCoin: for example, buy BTCUSDT, then "qty" unit is BTC
  • quoteCoin: for example, sell BTCUSDT, then "qty" unit is USDT
    • pricefalsestringOrder price
    • Market order will ignore this field
    • Please check the min price and price precision from instrument info endpoint
    • If you have position, price needs to be better than liquidation price
    triggerDirectionfalseintegerConditional order param. Used to identify the expected direction of the conditional order.
    • 1: triggered when market price rises to triggerPrice
    • 2: triggered when market price falls to triggerPrice
    Valid for linear & inverse
    orderFilterfalsestringIf it is not passed, Order by default.
    • Order
    • tpslOrder: Spot TP/SL order, the assets are occupied even before the order is triggered
    • StopOrder: Spot conditional order, the assets will not be occupied until the price of the underlying asset reaches the trigger price, and the required assets will be occupied after the Conditional order is triggered
    Valid for spot only
    triggerPricefalsestring
    • For Perps & Futures, it is the conditional order trigger price. If you expect the price to rise to trigger your conditional order, make sure:
      triggerPrice > market price
      Else, triggerPrice < market price
    • For spot, it is the TP/SL and Conditional order trigger price
    triggerByfalsestringTrigger price type, Conditional order param for Perps & Futures. LastPrice, IndexPrice, MarkPrice
    Valid for linear & inverse
    orderIvfalsestringImplied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed. orderIv has a higher priority when price is passed as well
    timeInForcefalsestringTime in force
    • Market order will use IOC directly
    • If not passed, GTC is used by default
    positionIdxfalseintegerUsed to identify positions in different position modes. Under hedge-mode, this param is required (USDT perps & Inverse contracts have hedge mode)
    • 0: one-way mode
    • 1: hedge-mode Buy side
    • 2: hedge-mode Sell side
    orderLinkIdfalsestringUser customised order ID. A max of 36 characters. Combinations of numbers, letters (upper and lower cases), dashes, and underscores are supported.
    Futures & Perps: orderLinkId rules:
    • optional param
    • always unique
      • option orderLinkId rules:
    • required param
    • always unique
    takeProfitfalsestringTake profit price
  • linear & inverse: support UTA and classic account
  • spot(UTA): Spot Limit order supports take profit, stop loss or limit take profit, limit stop loss when creating an order
    • stopLossfalsestringStop loss price
  • linear & inverse: support UTA and classic account
  • spot(UTA): Spot Limit order supports take profit, stop loss or limit take profit, limit stop loss when creating an order
    • tpTriggerByfalsestringThe price type to trigger take profit. MarkPrice, IndexPrice, default: LastPrice. Valid for linear & inverse
    slTriggerByfalsestringThe price type to trigger stop loss. MarkPrice, IndexPrice, default: LastPrice. Valid for linear & inverse
    reduceOnlyfalsebooleanWhat is a reduce-only order? true means your position can only reduce in size if this order is triggered.
    • You must specify it as true when you are about to close/reduce the position
    • When reduceOnly is true, take profit/stop loss cannot be set
    Valid for linear, inverse & option
    closeOnTriggerfalsebooleanWhat is a close on trigger order? For a closing order. It can only reduce your position, not increase it. If the account has insufficient available balance when the closing order is triggered, then other active orders of similar contracts will be cancelled or reduced. It can be used to ensure your stop loss reduces your position regardless of current available margin.
    Valid for linear & inverse
    smpTypefalsestringSmp execution type. What is SMP?
    mmpfalsebooleanMarket maker protection. option only. true means set the order as a market maker protection order. What is mmp?
    tpslModefalsestringTP/SL mode
    • Full: entire position for TP/SL. Then, tpOrderType or slOrderType must be Market
    • Partial: partial position tp/sl (as there is no size option, so it will create tp/sl orders with the qty you actually fill). Limit TP/SL order are supported. Note: When create limit tp/sl, tpslMode is required and it must be Partial
    Valid for linear & inverse
    tpLimitPricefalsestringThe limit order price when take profit price is triggered
    • linear & inverse: only works when tpslMode=Partial and tpOrderType=Limit
    • Spot(UTA): it is required when the order has takeProfit and tpOrderType=Limit
    slLimitPricefalsestringThe limit order price when stop loss price is triggered
    • linear & inverse: only works when tpslMode=Partial and slOrderType=Limit
    • Spot(UTA): it is required when the order has stopLoss and slOrderType=Limit
    tpOrderTypefalsestringThe order type when take profit is triggered
    • linear & inverse: Market(default), Limit. For tpslMode=Full, it only supports tpOrderType=Market
    • Spot(UTA):
      Market: when you set "takeProfit",
      Limit: when you set "takeProfit" and "tpLimitPrice"
    slOrderTypefalsestringThe order type when stop loss is triggered
    • linear & inverse: Market(default), Limit. For tpslMode=Full, it only supports slOrderType=Market
    • Spot(UTA):
      Market: when you set "stopLoss",
      Limit: when you set "stopLoss" and "slLimitPrice"

    Response Parameters​

    ParameterTypeComments
    orderIdstringOrder ID
    orderLinkIdstringUser customised order ID
    info

    The ack of create order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Request Example​

    POST /v5/order/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672211928338
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    // Spot Limit order with market tp sl
    {"category": "spot","symbol": "BTCUSDT","side": "Buy","orderType": "Limit","qty": "0.01","price": "28000","timeInForce": "PostOnly","takeProfit": "35000","stopLoss": "27000","tpOrderType": "Market","slOrderType": "Market"}

    // Spot Limit order with limit tp sl
    {"category": "spot","symbol": "BTCUSDT","side": "Buy","orderType": "Limit","qty": "0.01","price": "28000","timeInForce": "PostOnly","takeProfit": "35000","stopLoss": "27000","tpLimitPrice": "36000","slLimitPrice": "27500","tpOrderType": "Limit","slOrderType": "Limit"}

    // Spot PostOnly normal order
    {"category":"spot","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"0.1","price":"15600","timeInForce":"PostOnly","orderLinkId":"spot-test-01","isLeverage":0,"orderFilter":"Order"}

    // Spot TP/SL order
    {"category":"spot","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"0.1","price":"15600","triggerPrice": "15000", "timeInForce":"Limit","orderLinkId":"spot-test-02","isLeverage":0,"orderFilter":"tpslOrder"}

    // Spot margin normal order (UTA)
    {"category":"spot","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"0.1","price":"15600","timeInForce":"Limit","orderLinkId":"spot-test-limit","isLeverage":1,"orderFilter":"Order"}

    // Spot Market Buy order, qty is quote currency
    {"category":"spot","symbol":"BTCUSDT","side":"Buy","orderType":"Market","qty":"200","timeInForce":"IOC","orderLinkId":"spot-test-04","isLeverage":0,"orderFilter":"Order"}


    // USDT Perp open long position (one-way mode)
    {"category":"linear","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"1","price":"25000","timeInForce":"GTC","positionIdx":0,"orderLinkId":"usdt-test-01","reduceOnly":false,"takeProfit":"28000","stopLoss":"20000","tpslMode":"Partial","tpOrderType":"Limit","slOrderType":"Limit","tpLimitPrice":"27500","slLimitPrice":"20500"}

    // USDT Perp close long position (one-way mode)
    {"category": "linear", "symbol": "BTCUSDT", "side": "Sell", "orderType": "Limit", "qty": "1", "price": "30000", "timeInForce": "GTC", "positionIdx": 0, "orderLinkId": "usdt-test-02", "reduceOnly": true}

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1321003749386327552",
            "orderLinkId": "spot-test-postonly"
        },
        "retExtInfo": {},
        "time": 1672211918471
    }
    - + \ No newline at end of file diff --git a/v5/order/dcp.html b/v5/order/dcp.html index 3bb3d69bfd..2226c5db9d 100644 --- a/v5/order/dcp.html +++ b/v5/order/dcp.html @@ -4,17 +4,17 @@ Set Disconnect Cancel All | Bybit API Documentation - +
    -

    Set Disconnect Cancel All

    Covers: Futures / Spot / Option (Unified Account)

    info

    What is Disconnection Protect (DCP)?​

    Based on the websocket private connection and heartbeat mechanism, Bybit provides disconnection protection function. The +

    Set Disconnect Cancel All

    Covers: Futures / Spot / Option (Unified Account)

    info

    What is Disconnection Protect (DCP)?​

    Based on the websocket private connection and heartbeat mechanism, Bybit provides disconnection protection function. The timing starts from the first disconnection. If the Bybit server does not receive the reconnection from the client for more than 10 (default) seconds and resumes the heartbeat "ping", then the client is in the state of "disconnection protect", all active futures / spot / option orders of the client will be cancelled automatically. If within 10 seconds, the client reconnects and resumes the heartbeat "ping", the timing will be reset and restarted at the next disconnection.

    How to enable DCP​

    If you need to turn it on/off, you can contact your client manager for consultation and application. The default time window is 10 seconds.

    Applicable​

    Effective for USDT Perp / USDC Perp / USDC Futures / Spot / options

    tip

    After the request is successfully sent, the system needs a certain time to take effect. It is recommended to query or set again after 10 seconds

    • You can use this endpoint to get your current DCP configuration.
    • Your private websocket connection must subscribe "dcp" topic in order to trigger DCP successfully

    HTTP Request​

    POST /v5/order/disconnected-cancel-all

    Request Parameters​

    ParameterRequiredTypeComments
    productfalsestringOPTIONS(default), DERIVATIVES, SPOT
    timeWindowtrueintegerDisconnection timing window time. [3, 300], unit: second

    Response Parameters​

    None

    Request Example​

    POST v5/order/disconnected-cancel-all HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675852742375
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
      "timeWindow": 40
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/v5/order/execution.html b/v5/order/execution.html index 10dd8e5428..3778b84cd9 100644 --- a/v5/order/execution.html +++ b/v5/order/execution.html @@ -4,15 +4,15 @@ Get Trade History | Bybit API Documentation - +
    -

    Get Trade History

    Query users' execution records, sorted by execTime in descending order. However, for Classic spot, they are sorted by execId in descending order.

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options
    +

    Get Trade History

    Query users' execution records, sorted by execTime in descending order. However, for Classic spot, they are sorted by execId in descending order.

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options
    Classic account covers: Spot / USDT perpetual / Inverse contract

    tip
    • Response items will have sorting issues When 'execTime' is the same, it is recommended to sort according to execId+OrderId+leavesQty. This issue is currently being optimized and will be released. If you want to receive real-time execution information, Use the websocket stream (recommended).
    • You may have multiple executions in a single order.
    • You can query by symbol, baseCoin, orderId and orderLinkId, and if you pass multiple params, the system will process them according to this priority: orderId > orderLinkId > symbol > baseCoin.
    info
    • Classic Spot supports getting the past 180 days historical data
    • Unified account (linear, spot, option) supports getting the past 730 days historical data

    HTTP Request​

    GET /v5/execution/list

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    orderIdfalsestringOrder ID
    orderLinkIdfalsestringUser customised order ID. Classic account does not support this param
    baseCoinfalsestringBase coin, uppercase only. Unified account - inverse and Classic account do not support this param
    startTimefalseintegerThe start timestamp (ms)
    • Classic Spot: supports the interval up to 180 days
    • Others:
      startTime and endTime are not passed, return 7 days by default;
      Only startTime is passed, return range between startTime and startTime+7 days;
      Only endTime is passed, return range between endTime-7 days and endTime;
      If both are passed, the rule is endTime - startTime <= 7 days
    endTimefalseintegerThe end timestamp (ms)
    execTypefalsestringExecution type. Classic spot is not supported
    limitfalseintegerLimit for data size per page. [1, 100]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > orderIdstringOrder ID
    > orderLinkIdstringUser customized order ID. Classic spot is not supported
    > sidestringSide. Buy,Sell
    > orderPricestringOrder price
    > orderQtystringOrder qty
    > leavesQtystringThe remaining qty not executed. Classic spot is not supported
    > createTypestringOrder create type
  • UTA: Only for category=linear
  • Classic & UTA(inverse): always ""
  • Spot, Option do not have this key
    • > orderTypestringOrder type. Market,Limit
    > stopOrderTypestringStop order type. If the order is not stop order, it either returns UNKNOWN or "". Classic spot is not supported
    > execFeestringExecuted trading fee. You can get spot fee currency instruction here
    > execIdstringExecution ID
    > execPricestringExecution price
    > execQtystringExecution qty
    > execTypestringExecuted type. Classic spot is not supported
    > execValuestringExecuted order value. Classic spot is not supported
    > execTimestringExecuted timestamp（ms）
    > feeCurrencystringSpot trading fee currency Classic spot is not supported
    > isMakerbooleanIs maker order. true: maker, false: taker
    > feeRatestringTrading fee rate. Classic spot is not supported
    > tradeIvstringImplied volatility. Valid for option
    > markIvstringImplied volatility of mark price. Valid for option
    > markPricestringThe mark price of the symbol when executing. Classic spot is not supported
    > indexPricestringThe index price of the symbol when executing. Valid for option only
    > underlyingPricestringThe underlying price of the symbol when executing. Valid for option
    > blockTradeIdstringParadigm block trade ID
    > closedSizestringClosed position size
    > seqlongCross sequence, used to associate each fill and each position update
    • The seq will be the same when conclude multiple transactions at the same time
    • Different symbols may have the same seq, please use seq + symbol to check unique
    • Classic account Spot trade does not have this field
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/execution/list?category=linear&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672283754132
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "132766%3A2%2C132766%3A2",
            "category": "linear",
            "list": [
                {
                    "symbol": "ETHPERP",
                    "orderType": "Market",
                    "underlyingPrice": "",
                    "orderLinkId": "",
                    "side": "Buy",
                    "indexPrice": "",
                    "orderId": "8c065341-7b52-4ca9-ac2c-37e31ac55c94",
                    "stopOrderType": "UNKNOWN",
                    "leavesQty": "0",
                    "execTime": "1672282722429",
                    "feeCurrency": "",
                    "isMaker": false,
                    "execFee": "0.071409",
                    "feeRate": "0.0006",
                    "execId": "e0cbe81d-0f18-5866-9415-cf319b5dab3b",
                    "tradeIv": "",
                    "blockTradeId": "",
                    "markPrice": "1183.54",
                    "execPrice": "1190.15",
                    "markIv": "",
                    "orderQty": "0.1",
                    "orderPrice": "1236.9",
                    "execValue": "119.015",
                    "execType": "Trade",
                    "execQty": "0.1",
                    "closedSize": "",
                    "seq": 4688002127
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672283754510
    }
    - + \ No newline at end of file diff --git a/v5/order/open-order.html b/v5/order/open-order.html index 653ec419b7..8064df88fd 100644 --- a/v5/order/open-order.html +++ b/v5/order/open-order.html @@ -4,15 +4,15 @@ Get Open & Closed Orders | Bybit API Documentation - +
    -

    Get Open & Closed Orders

    Primarily query unfilled or partially filled orders in real-time, but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param openOnly.
    +

    Get Open & Closed Orders

    Primarily query unfilled or partially filled orders in real-time, but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param openOnly.
    And to query older order records, please use the order history interface.

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options
    Classic account covers: Spot / USDT perpetual / Inverse contract

    tip
    • This endpoint also allows for querying filled, canceled, and rejected orders to the most recent 500 orders for spot, linear, and option categories. The inverse category is not subject to this limitation.
    • You can query by symbol, baseCoin, orderId and orderLinkId, and if you pass multiple params, the system will process them according to this priority: orderId > orderLinkId > symbol > baseCoin.
    • The records are sorted by the createdTime from newest to oldest.
    info
    • Classic account spot can return open orders only
    • After a server release or restart, filled, canceled, and rejected orders of Unified account should only be queried through order history.

    HTTP Request​

    GET /v5/order/realtime

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only. For linear, either symbol, baseCoin, settleCoin is required
    baseCoinfalsestringBase coin, uppercase only
  • Supports linear, inverse & option
  • option: it returns all option open orders by default
    • settleCoinfalsestringSettle coin, uppercase only
    • linear: either symbol, baseCoin or settleCoin is required
    • spot: not supported
    orderIdfalsestringOrder ID
    orderLinkIdfalsestringUser customised order ID
    openOnlyfalseinteger
    • Unified account & Classic account: 0(default) - query open orders (e.g., New, PartiallyFilled) only
    • Unified account (spot / linear / option): 1, Unified account(inverse) & Classic account(linear / inverse): 2: return a maximum of recent 500 closed status records are kept under each account (e.g., Cancelled, Rejected, Filled orders). If the Bybit service is restarted due to an update, this part of the data will be cleared and accumulated again, but the order records will still be queried in order history
    • openOnly param will be ignored when query by orderId or orderLinkId
    • Classic spot: not supported
    orderFilterfalsestringOrder: active order, StopOrder: conditional order for Futures and Spot, tpslOrder: spot TP/SL order, OcoOrder: Spot oco order, BidirectionalTpslOrder: Spot bidirectional TPSL order
    • Classic account spot: return Order active order by default
    • Others: all kinds of orders by default
    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
    categorystringProduct type
    nextPageCursorstringRefer to the cursor request parameter
    listarrayObject
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    > blockTradeIdstringParadigm block trade ID
    > symbolstringSymbol name
    > pricestringOrder price
    > qtystringOrder qty
    > sidestringSide. Buy,Sell
    > isLeveragestringWhether to borrow. Unified spot only. 0: false, 1: true. Classic spot is not supported, always 0
    > positionIdxintegerPosition index. Used to identify positions in different position modes.
    > orderStatusstringOrder status
    > createTypestringOrder create type
  • Only for category=linear or inverse
  • Spot, Option do not have this key
    • > cancelTypestringCancel type
    > rejectReasonstringReject reason. Classic spot is not supported
    > avgPricestringAverage filled price
  • UTA: returns "" for those orders without avg price
  • Classic account: returns "0" for those orders without avg price, and also for those orders have partilly filled but cancelled at the end
    • > leavesQtystringThe remaining qty not executed. Classic spot is not supported
    > leavesValuestringThe estimated value not executed. Classic spot is not supported
    > cumExecQtystringCumulative executed order qty
    > cumExecValuestringCumulative executed order value. Classic spot is not supported
    > cumExecFeestringCumulative executed trading fee. Classic spot is not supported
    > timeInForcestringTime in force
    > orderTypestringOrder type. Market,Limit. For TP/SL order, it means the order type after triggered
    > stopOrderTypestringStop order type
    > orderIvstringImplied volatility
    > marketUnitstringThe unit for qty when create Spot market orders for UTA account. baseCoin, quoteCoin
    > triggerPricestringTrigger price. If stopOrderType=TrailingStop, it is activate price. Otherwise, it is trigger price
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > tpslModestringTP/SL mode, Full: entire position for TP/SL. Partial: partial position tp/sl. Spot does not have this field, and Option returns always ""
    > ocoTriggerBystringThe trigger type of Spot OCO order.OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerByBySl. Classic spot is not supported
    > tpLimitPricestringThe limit order price when take profit price is triggered
    > slLimitPricestringThe limit order price when stop loss price is triggered
    > tpTriggerBystringThe price type to trigger take profit
    > slTriggerBystringThe price type to trigger stop loss
    > triggerDirectionintegerTrigger direction. 1: rise, 2: fall
    > triggerBystringThe price type of trigger price
    > lastPriceOnCreatedstringLast price when place the order
    > reduceOnlybooleanReduce only. true means reduce position size
    > closeOnTriggerbooleanClose on trigger. What is a close on trigger order?
    > placeTypestringPlace type, option used. iv, price
    > smpTypestringSMP execution type
    > smpGroupintegerSmp group ID. If the UID has no group, it is 0 by default
    > smpOrderIdstringThe counterparty's orderID which triggers this SMP execution
    > createdTimestringOrder created timestamp (ms)
    > updatedTimestringOrder updated timestamp (ms)

    Request Example​

    GET /v5/order/realtime?symbol=ETHUSDT&category=linear&openOnly=0&limit=1  HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672219525810
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "fd4300ae-7847-404e-b947-b46980a4d140",
                    "orderLinkId": "test-000005",
                    "blockTradeId": "",
                    "symbol": "ETHUSDT",
                    "price": "1600.00",
                    "qty": "0.10",
                    "side": "Buy",
                    "isLeverage": "",
                    "positionIdx": 1,
                    "orderStatus": "New",
                    "cancelType": "UNKNOWN",
                    "rejectReason": "EC_NoError",
                    "avgPrice": "0",
                    "leavesQty": "0.10",
                    "leavesValue": "160",
                    "cumExecQty": "0.00",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "timeInForce": "GTC",
                    "orderType": "Limit",
                    "stopOrderType": "UNKNOWN",
                    "orderIv": "",
                    "triggerPrice": "0.00",
                    "takeProfit": "2500.00",
                    "stopLoss": "1500.00",
                    "tpTriggerBy": "LastPrice",
                    "slTriggerBy": "LastPrice",
                    "triggerDirection": 0,
                    "triggerBy": "UNKNOWN",
                    "lastPriceOnCreated": "",
                    "reduceOnly": false,
                    "closeOnTrigger": false,
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "tpslMode": "Full",
                    "tpLimitPrice": "",
                    "slLimitPrice": "",
                    "placeType": "",
                    "createdTime": "1684738540559",
                    "updatedTime": "1684738540561"
                }
            ],
            "nextPageCursor": "page_args%3Dfd4300ae-7847-404e-b947-b46980a4d140%26symbol%3D6%26",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1684765770483
    }
    - + \ No newline at end of file diff --git a/v5/order/order-list.html b/v5/order/order-list.html index 3c4556a1ea..5f78fc2a3f 100644 --- a/v5/order/order-list.html +++ b/v5/order/order-list.html @@ -4,15 +4,15 @@ Get Order History | Bybit API Documentation - +
    -

    Get Order History

    Query order history. As order creation/cancellation is asynchronous, the data returned from this endpoint may delay. If you want to get +

    Get Order History

    Query order history. As order creation/cancellation is asynchronous, the data returned from this endpoint may delay. If you want to get real-time order information, you could query this endpoint or rely on the websocket stream (recommended).

    Unified account covers: Spot / USDT perpetual / USDC contract / Inverse contract / Options
    Classic account covers: Spot / USDT perpetual / Inverse contract

    tip
    • The orders in the last 7 days: UTA(linear,spot,option) supports querying all closed status except "Cancelled", "Rejected", "Deactivated" status, UTA(inverse) and Classic account supports querying all status
    • 24 hours: UTA(linear,spot,option) for the orders with "Cancelled" (fully cancelled order), "Rejected", "Deactivated" can query last 24 hours data
    • The orders beyond 7 days: supports querying orders which have fills only, i.e., fully filled, partial filled but cancelled finally orders can be queried.
    • You can query by symbol, baseCoin, orderId and orderLinkId, and if you pass multiple params, the system will process them according to this priority: orderId > orderLinkId > symbol > baseCoin.
    info
    • Classic Spot: can get closed order status only
    • Classic Spot: market maker can only get recent 3 days order history, please go to web to export. Retail client can get up to 180 days data
    • Classic Spot: Cancelled, Rejected, Deactivated orders save up to 7 days
    • Unified account (linear, spot, option) supports getting the past 730 days historical data

    HTTP Request​

    GET /v5/order/history

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    baseCoinfalsestringBase coin, uppercase only. Unified account - inverse & Classic account does not support this param
    settleCoinfalsestringSettle coin, uppercase only. Unified account - inverse & Classic account does not support this param
    orderIdfalsestringOrder ID
    orderLinkIdfalsestringUser customised order ID
    orderFilterfalsestringOrder: active order, StopOrder: conditional order for Futures and Spot, tpslOrder: spot TP/SL order, OcoOrder: Spot OCO orders, BidirectionalTpslOrder: Bidirectional TPSL order
    • Classic account spot: return Order active order by default
    • Others: all kinds of orders by default
    orderStatusfalsestring
    • Classic spot: not supported
    • UTA(linear,spot,option): return all closed status orders if not passed
    • UTA(inverse) and classic account: return all status orders if not passed
    startTimefalseintegerThe start timestamp (ms). Classic spot trading does not support startTime and endTime
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed, the rule is endTime - startTime <= 7 days
    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
    categorystringProduct type
    listarrayObject
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    > blockTradeIdstringBlock trade ID
    > symbolstringSymbol name
    > pricestringOrder price
    > qtystringOrder qty
    > sidestringSide. Buy,Sell
    > isLeveragestringWhether to borrow. Unified spot only. 0: false, 1: true. . Classic spot is not supported, always 0
    > positionIdxintegerPosition index. Used to identify positions in different position modes
    > orderStatusstringOrder status
    > createTypestringOrder create type
  • Only for category=linear or inverse
  • Spot, Option do not have this key
    • > cancelTypestringCancel type
    > rejectReasonstringReject reason. Classic spot is not supported
    > avgPricestringAverage filled price
  • UTA: returns "" for those orders without avg price
  • Classic account: returns "0" for those orders without avg price, and also for those orders have partilly filled but cancelled at the end
    • > leavesQtystringThe remaining qty not executed. Classic spot is not supported
    > leavesValuestringThe estimated value not executed. Classic spot is not supported
    > cumExecQtystringCumulative executed order qty
    > cumExecValuestringCumulative executed order value. Classic spot is not supported
    > cumExecFeestringCumulative executed trading fee. Classic spot is not supported
    > timeInForcestringTime in force
    > orderTypestringOrder type. Market,Limit. For TP/SL order, it means the order type after triggered
  • Block trade Roll Back, Block trade-Limit: Unique enum values for Unified account block trades
    • > stopOrderTypestringStop order type
    > orderIvstringImplied volatility
    > marketUnitstringThe unit for qty when create Spot market orders for UTA account. baseCoin, quoteCoin
    > triggerPricestringTrigger price. If stopOrderType=TrailingStop, it is activate price. Otherwise, it is trigger price
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > tpslModestringTP/SL mode, Full: entire position for TP/SL. Partial: partial position tp/sl. Spot does not have this field, and Option returns always ""
    > ocoTriggerBystringThe trigger type of Spot OCO order.OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl. Classic spot is not supported
    > tpLimitPricestringThe limit order price when take profit price is triggered
    > slLimitPricestringThe limit order price when stop loss price is triggered
    > tpTriggerBystringThe price type to trigger take profit
    > slTriggerBystringThe price type to trigger stop loss
    > triggerDirectionintegerTrigger direction. 1: rise, 2: fall
    > triggerBystringThe price type of trigger price
    > lastPriceOnCreatedstringLast price when place the order
    > reduceOnlybooleanReduce only. true means reduce position size
    > closeOnTriggerbooleanClose on trigger. What is a close on trigger order?
    > placeTypestringPlace type, option used. iv, price
    > smpTypestringSMP execution type
    > smpGroupintegerSmp group ID. If the UID has no group, it is 0 by default
    > smpOrderIdstringThe counterparty's orderID which triggers this SMP execution
    > createdTimestringOrder created timestamp (ms)
    > updatedTimestringOrder updated timestamp (ms)
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/order/history?category=linear&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672221263407
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "14bad3a1-6454-43d8-bcf2-5345896cf74d",
                    "orderLinkId": "YLxaWKMiHU",
                    "blockTradeId": "",
                    "symbol": "BTCUSDT",
                    "price": "26864.40",
                    "qty": "0.003",
                    "side": "Buy",
                    "isLeverage": "",
                    "positionIdx": 1,
                    "orderStatus": "Cancelled",
                    "cancelType": "UNKNOWN",
                    "rejectReason": "EC_PostOnlyWillTakeLiquidity",
                    "avgPrice": "0",
                    "leavesQty": "0.000",
                    "leavesValue": "0",
                    "cumExecQty": "0.000",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "timeInForce": "PostOnly",
                    "orderType": "Limit",
                    "stopOrderType": "UNKNOWN",
                    "orderIv": "",
                    "triggerPrice": "0.00",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "triggerDirection": 0,
                    "triggerBy": "UNKNOWN",
                    "lastPriceOnCreated": "0.00",
                    "reduceOnly": false,
                    "closeOnTrigger": false,
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "tpslMode": "",
                    "tpLimitPrice": "",
                    "slLimitPrice": "",
                    "placeType": "",
                    "createdTime": "1684476068369",
                    "updatedTime": "1684476068372"
                }
            ],
            "nextPageCursor": "page_token%3D39380%26",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1684766282976
    }
    - + \ No newline at end of file diff --git a/v5/order/spot-borrow-quota.html b/v5/order/spot-borrow-quota.html index 093aba14c8..f7a77ad992 100644 --- a/v5/order/spot-borrow-quota.html +++ b/v5/order/spot-borrow-quota.html @@ -4,13 +4,13 @@ Get Borrow Quota (Spot) | Bybit API Documentation - +
    -

    Get Borrow Quota (Spot)

    Query the available balance for Spot trading and Margin trading

    Covers: Spot (Unified Account)

    HTTP Request​

    GET /v5/order/spot-borrow-check

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. spot
    symboltruestringSymbol name
    sidetruestringTransaction side. Buy,Sell

    Response Parameters​

    ParameterTypeComments
    symbolstringSymbol name, like BTCUSDT, uppercase only
    sidestringSide
    maxTradeQtystringThe maximum base coin qty can be traded
    • If spot margin trade on and symbol is margin trading pair, it returns available balance + max.borrowable quantity = min(The maximum quantity that a single user can borrow on the platform, The maximum quantity that can be borrowed calculated by IMR MMR of UTA account, The available quantity of the platform's capital pool)
    • Otherwise, it returns actual available balance
    • up to 4 decimals
    maxTradeAmountstringThe maximum quote coin amount can be traded
    • If spot margin trade on and symbol is margin trading pair, it returns available balance + max.borrowable amount = min(The maximum amount that a single user can borrow on the platform, The maximum amount that can be borrowed calculated by IMR MMR of UTA account, The available amount of the platform's capital pool)
    • Otherwise, it returns actual available balance
    • up to 8 decimals
    spotMaxTradeQtystringNo matter your Spot margin switch on or not, it always returns actual qty of base coin you can trade or you have (borrowable qty is not included), up to 4 decimals
    spotMaxTradeAmountstringNo matter your Spot margin switch on or not, it always returns actual amount of quote coin you can trade or you have (borrowable amount is not included), up to 8 decimals
    borrowCoinstringBorrow coin

    Request Example​

    GET /v5/order/spot-borrow-check?category=spot&symbol=BTCUSDT&side=Buy HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672228522214
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "maxTradeQty": "6.6065",
            "side": "Buy",
            "spotMaxTradeAmount": "9004.75628594",
            "maxTradeAmount": "218014.01330797",
            "borrowCoin": "USDT",
            "spotMaxTradeQty": "0.2728"
        },
        "retExtInfo": {},
        "time": 1698895841534
    }
    - +

    Get Borrow Quota (Spot)

    Query the available balance for Spot trading and Margin trading

    Covers: Spot (Unified Account)

    HTTP Request​

    GET /v5/order/spot-borrow-check

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. spot
    symboltruestringSymbol name
    sidetruestringTransaction side. Buy,Sell

    Response Parameters​

    ParameterTypeComments
    symbolstringSymbol name, like BTCUSDT, uppercase only
    sidestringSide
    maxTradeQtystringThe maximum base coin qty can be traded
    • If spot margin trade on and symbol is margin trading pair, it returns available balance + max.borrowable quantity = min(The maximum quantity that a single user can borrow on the platform, The maximum quantity that can be borrowed calculated by IMR MMR of UTA account, The available quantity of the platform's capital pool)
    • Otherwise, it returns actual available balance
    • up to 4 decimals
    maxTradeAmountstringThe maximum quote coin amount can be traded
    • If spot margin trade on and symbol is margin trading pair, it returns available balance + max.borrowable amount = min(The maximum amount that a single user can borrow on the platform, The maximum amount that can be borrowed calculated by IMR MMR of UTA account, The available amount of the platform's capital pool)
    • Otherwise, it returns actual available balance
    • up to 8 decimals
    spotMaxTradeQtystringNo matter your Spot margin switch on or not, it always returns actual qty of base coin you can trade or you have (borrowable qty is not included), up to 4 decimals
    spotMaxTradeAmountstringNo matter your Spot margin switch on or not, it always returns actual amount of quote coin you can trade or you have (borrowable amount is not included), up to 8 decimals
    borrowCoinstringBorrow coin

    Request Example​

    GET /v5/order/spot-borrow-check?category=spot&symbol=BTCUSDT&side=Buy HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672228522214
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "maxTradeQty": "6.6065",
            "side": "Buy",
            "spotMaxTradeAmount": "9004.75628594",
            "maxTradeAmount": "218014.01330797",
            "borrowCoin": "USDT",
            "spotMaxTradeQty": "0.2728"
        },
        "retExtInfo": {},
        "time": 1698895841534
    }
    + \ No newline at end of file diff --git a/v5/otc/bind-uid.html b/v5/otc/bind-uid.html index b6b0336a7d..69ca5343cd 100644 --- a/v5/otc/bind-uid.html +++ b/v5/otc/bind-uid.html @@ -4,13 +4,13 @@ Bind Or Unbind UID | Bybit API Documentation - +

    Bind Or Unbind UID

    For the institutional loan product, you can bind new UIDs to the risk unit or unbind UID from the risk unit.

    info
    • Risk unit designated UID cannot be unbound
    • This endpoint can only be called by uids in the risk unit list
    • The UID must be upgraded to UTA Pro if you try to bind it.
    • When the API is operated through the API Key of any UID in the risk unit, the UID is bound or unbound in the risk unit.

    HTTP Request​

    POST /v5/ins-loan/association-uid

    Request Parameters​

    ParameterRequiredTypeComments
    uidtruestringUID
    operatetruestring0: bind, 1: unbind

    Response Parameters​

    ParameterTypeComments
    uidstringUID
    operatestring0: bind, 1: unbind

    Request Example​

    POST /v5/ins-loan/association-uid HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1699257853101
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json
    Content-Length: 43

    {
        "uid": "592324",
        "operate": "0"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "uid": "592324",
            "operate": "0"
        },
        "retExtInfo": {},
        "time": 1699257746135
    }
    - + \ No newline at end of file diff --git a/v5/otc/loan-info.html b/v5/otc/loan-info.html index 73494bc698..f7f2666a3f 100644 --- a/v5/otc/loan-info.html +++ b/v5/otc/loan-info.html @@ -4,13 +4,13 @@ Get Loan Orders | Bybit API Documentation - +

    Get Loan Orders

    Get loan orders information

    tip
    • Get the past 2 years data by default
    • Get up to the past 2 years of data

    HTTP Request​

    GET /v5/ins-loan/loan-order

    Request Parameters​

    ParameterRequiredTypeComments
    orderIdfalsestringLoan order id. If not passed, then return all orders, sort by loanTime in descend
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size. [1, 100], Default: 10

    Response Parameters​

    ParameterTypeComments
    loanInfoarrayObject
    > orderIdstringLoan order ID
    > orderProductIdstringProduct ID
    > parentUidstringThe designated UID that used to bind INS loan product
    > loanTimestringLoan timestamp, in milliseconds
    > loanCoinstringLoan coin
    > loanAmountstringLoan amount
    > unpaidAmountstringUnpaid principal
    > unpaidIntereststringUnpaid interest
    > repaidAmountstringRepaid principal
    > repaidIntereststringRepaid interest
    > interestRatestringDaily interest rate
    > statusstring1：outstanding; 2：paid off
    > leveragestringThe maximum leverage for this loan product
    > supportSpotstringWhether to support spot. 0:false; 1:true
    > supportContractstringWhether to support contract . 0:false; 1:true
    > withdrawLinestringRestrict line for withdrawal
    > transferLinestringRestrict line for transfer
    > spotBuyLinestringRestrict line for SPOT buy
    > spotSellLinestringRestrict line for SPOT sell
    > contractOpenLinestringRestrict line for USDT Perpetual open position
    > deferredLiquidationLinestringLine for deferred liquidation
    > deferredLiquidationTimestringTime for deferred liquidation
    > reserveTokenstringReserve token
    > reserveQuantitystringReserve token qty
    > liquidationLinestringLine for liquidation
    > stopLiquidationLinestringLine for stop liquidation
    > contractLeveragestringThe allowed default leverage for USDT Perpetual
    > transferRatiostringThe transfer ratio for loan funds to transfer from Spot wallet to Contract wallet
    > spotSymbolsarrayThe whitelist of spot trading pairs. If there is no whitelist, then "[]"
    > contractSymbolsarrayThe whitelist of contract trading pairs
    • If supportContract="0", then this is "[]"
    • If there is no whitelist, this is "[]"
    > supportUSDCContractstringWhether to support USDC contract. "0":false; "1":true
    > supportUSDCOptionsstringWhether to support Option. "0":false; "1":true
    > supportMarginTradingstringWhether to support Spot margin trading. "0":false; "1":true
    > USDTPerpetualOpenLinestringRestrict line to open USDT Perpetual position
    > USDCContractOpenLinestringRestrict line to open USDC Contract position
    > USDCOptionsOpenLinestringRestrict line to open Option position
    > USDTPerpetualCloseLinestringRestrict line to trade USDT Perpetual position
    > USDCContractCloseLinestringRestrict line to trade USDC Contract position
    > USDCOptionsCloseLinestringRestrict line to trade Option position
    > USDCContractSymbolsarrayThe whitelist of USDC contract trading pairs
    • If no whitelist symbols, it is [], and you can trade any
    • If supportUSDCContract="0", it is []
    > USDCOptionsSymbolsarrayThe whitelist of Option symbols
    • If no whitelisted, it is [], and you can trade any
    • If supportUSDCOptions="0", it is []
    > marginLeveragestringThe allowable maximum leverage for Spot margin
    > USDTPerpetualLeveragearrayObject
    • If supportContract="0", it is []
    • If no whitelist USDT perp symbols, it returns all trading symbols and leverage by default
    • If there are whitelist symbols, it return those whitelist data
    >> symbolstringSymbol name
    >> leveragestringMaximum leverage
    > USDCContractLeveragearrayObject
    • If supportUSDCContract="0", it is []
    • If no whitelist USDC contract symbols, it returns all trading symbols and leverage by default
    • If there are whitelist symbols, it return those whitelist data
    >> symbolstringSymbol name
    >> leveragestringMaximum leverage

    Request Example​

    GET /v5/ins-loan/loan-order HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1678687874060
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "loanInfo": [
                {
                    "orderId": "1468005106166530304",
                    "orderProductId": "96",
                    "parentUid": "1631521",
                    "loanTime": "1689735916000",
                    "loanCoin": "USDT",
                    "loanAmount": "204",
                    "unpaidAmount": "52.07924201",
                    "unpaidInterest": "0",
                    "repaidAmount": "151.92075799",
                    "repaidInterest": "0",
                    "interestRate": "0.00019178",
                    "status": "1",
                    "leverage": "4",
                    "supportSpot": "1",
                    "supportContract": "1",
                    "withdrawLine": "",
                    "transferLine": "",
                    "spotBuyLine": "0.71",
                    "spotSellLine": "0.71",
                    "contractOpenLine": "0.71",
                    "liquidationLine": "0.75",
                    "stopLiquidationLine": "0.35000000",
                    "contractLeverage": "7",
                    "transferRatio": "1",
                    "spotSymbols": [],
                    "contractSymbols": [],
                    "supportUSDCContract": "1",
                    "supportUSDCOptions": "1",
                    "USDTPerpetualOpenLine": "0.71",
                    "USDCContractOpenLine": "0.71",
                    "USDCOptionsOpenLine": "0.71",
                    "USDTPerpetualCloseLine": "0.71",
                    "USDCContractCloseLine": "0.71",
                    "USDCOptionsCloseLine": "0.71",
                    "USDCContractSymbols": [],
                    "USDCOptionsSymbols": [],
                    "deferredLiquidationLine":"",
                    "deferredLiquidationTime":"",
                    "marginLeverage": "4",
                    "USDTPerpetualLeverage": [
                        {
                            "symbol": "SUSHIUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "INJUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "RDNTUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "ZRXUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "HIGHUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "WAVESUSDT",
                            "leverage": "7"
                        },
                        ...
                        {
                            "symbol": "ACHUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "SUNUSDT",
                            "leverage": "7"
                        }
                    ],
                    "USDCContractLeverage": [
                        {
                            "symbol": "BTCPERP",
                            "leverage": "8"
                        },
                        {
                            "symbol": "BTC-Futures",
                            "leverage": "8"
                        },
                        ...
                        {
                            "symbol": "ETH-Futures",
                            "leverage": "8"
                        },
                        {
                            "symbol": "SOLPERP",
                            "leverage": "8"
                        },
                        {
                            "symbol": "ETHPERP",
                            "leverage": "8"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1689745773187
    }
    - + \ No newline at end of file diff --git a/v5/otc/ltv-convert.html b/v5/otc/ltv-convert.html index 843a2415cf..886f08150e 100644 --- a/v5/otc/ltv-convert.html +++ b/v5/otc/ltv-convert.html @@ -4,13 +4,13 @@ Get LTV | Bybit API Documentation - +

    Get LTV

    Get your loan-to-value (LTV) ratio.

    HTTP Request​

    GET /v5/ins-loan/ltv-convert

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    ltvInfoarrayObject
    > ltvstringRisk rate
  • ltv is calculated in real-time
  • If you have INS loan, it is highly recommended to query this data per second. The liquidation occurs when it reachs at 0.9 (90%)
    • > rststringRemaining liquidation time (UTC time in seconds). When it is not triggered, it is displayed as an empty string.
    > parentUidstringThe designated UID that used to bind INS loan product
    > subAccountUidsarrayBound user id
    > unpaidAmountstringTotal debt(USDT)
    > unpaidInfoarrayDebt details
    >> tokenstringcoin
    >> unpaidQtystringUnpaid principle
    >> unpaidIntereststringUseless field, please ignore this for now
    > balancestringTotal asset. (margin coins converted to USDT). Please read here to understand the calculation
    > balanceInfoarrayAsset details
    >> tokenstringMargin coin
    >> pricestringMargin coin price
    >> qtystringMargin coin quantity
    >> convertedAmountstringMargin conversion amount

    Request Example​

    GET /v5/ins-loan/ltv-convert HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686638165351
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "ltvInfo": [
                {
                    "ltv": "0.75",
                    "rst": "",
                    "parentUid": "xxxxx",
                    "subAccountUids": [
                        "60568258"
                    ],
                    "unpaidAmount": "30",
                    "unpaidInfo": [
                        {
                            "token": "USDT",
                            "unpaidQty": "30",
                            "unpaidInterest": "0"
                        }
                    ],
                    "balance": "40",
                    "balanceInfo": [
                        {
                            "token": "USDT",
                            "price": "1",
                            "qty": "40",
                            "convertedAmount": "40"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686638166323
    }
    - + \ No newline at end of file diff --git a/v5/otc/margin-coin-convert-info.html b/v5/otc/margin-coin-convert-info.html index 047da6ccdf..fe4eefd17f 100644 --- a/v5/otc/margin-coin-convert-info.html +++ b/v5/otc/margin-coin-convert-info.html @@ -4,13 +4,13 @@ Get Margin Coin Info | Bybit API Documentation - +

    Get Margin Coin Info

    tip
    • This endpoint can be queried without api key and secret, then it returns public margin data
    • If your uid is bound with OTC loan product, then you can get your private margin data by calling the endpoint with api key and secret
    • If your uid is not bound with OTC loan product but api key and secret are also passed, it will return public data only

    HTTP Request​

    GET /v5/ins-loan/ensure-tokens-convert

    Request Parameters​

    ParameterRequiredTypeComments
    productIdfalsestringProductId. If not passed, then return all product margin coin. For spot, it returns coin that convertRation greater than 0.

    Response Parameters​

    ParameterTypeComments
    marginTokenarrayObject
    > productIdstringProduct Id
    > tokenInfoarraySpot margin coin
    >> tokenstringMargin coin
    >> convertRatioListarrayMargin coin convert ratio List
    >>> ladderstringladder
    >>> convertRatiostringMargin coin convert ratio

    Request Example​

    GET /v5/ins-loan/ensure-tokens HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "marginToken": [
                {
                    "productId": "81",
                    "tokenInfo": [
                        {
                            "token": "USDT",
                            "convertRatioList": [
                                {
                                    "ladder": "0-500",
                                    "convertRatio": "0.95"
                                },
                                {
                                    "ladder": "500-1000",
                                    "convertRatio": "0.9"
                                },
                                {
                                    "ladder": "1000-2000",
                                    "convertRatio": "0.8"
                                },
                                {
                                    "ladder": "2000-4000",
                                    "convertRatio": "0.7"
                                },
                                {
                                    "ladder": "4000-99999999999",
                                    "convertRatio": "0.6"
                                }
                            ]
                        }
                      ...
                    ]
                },
                {
                    "productId": "82",
                    "tokenInfo": [
                        ...
                        {
                            "token": "USDT",
                            "convertRatioList": [
                                {
                                    "ladder": "0-1000",
                                    "convertRatio": "0.7"
                                },
                                {
                                    "ladder": "1000-2000",
                                    "convertRatio": "0.65"
                                },
                                {
                                    "ladder": "2000-99999999999",
                                    "convertRatio": "0.6"
                                }
                            ]
                        }
                    ]
                },
                {
                    "productId": "84",
                    "tokenInfo": [
                        ...
                        {
                            "token": "BTC",
                            "convertRatioList": [
                                {
                                    "ladder": "0-1000",
                                    "convertRatio": "1"
                                },
                                {
                                    "ladder": "1000-5000",
                                    "convertRatio": "0.9"
                                },
                                {
                                    "ladder": "5000-99999999999",
                                    "convertRatio": "0.55"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1683276016497
    }
    - + \ No newline at end of file diff --git a/v5/otc/margin-product-info.html b/v5/otc/margin-product-info.html index 1707425f6a..e4b7adc043 100644 --- a/v5/otc/margin-product-info.html +++ b/v5/otc/margin-product-info.html @@ -4,13 +4,13 @@ Get Product Info | Bybit API Documentation - +

    Get Product Info

    tip
    • This endpoint can be queried without api key and secret, then it returns public product data
    • If your uid is bound with OTC loan product, then you can get your private product data by calling the endpoint with api key and secret
    • If your uid is not bound with OTC loan product but api key and secret are also passed, it will return public data only

    HTTP Request​

    GET /v5/ins-loan/product-infos

    Request Parameters​

    ParameterRequiredTypeComments
    productIdfalsestringProduct Id. If not passed, then return all products info

    Response Parameters​

    ParameterTypeComments
    marginProductInfoarrayObject
    > productIdstringProduct Id
    > leveragestringThe maximum leverage for this loan product
    > supportSpotintegerWhether to support Spot. 0:false; 1:true
    > supportContractintegerWhether to support USDT Perpetual. 0:false; 1:true
    > supportMarginTradingintegerWhether to support Spot margin trading. 0:false; 1:true
    > deferredLiquidationLinestringLine for deferred liquidation
    > deferredLiquidationTimestringTime for deferred liquidation
    > withdrawLinestringRestrict line for withdrawal
    > transferLinestringRestrict line for transfer
    > spotBuyLinestringRestrict line for Spot buy
    > spotSellLinestringRestrict line for Spot trading
    > contractOpenLinestringRestrict line for USDT Perpetual open position
    > liquidationLinestringLine for liquidation
    > stopLiquidationLinestringLine for stop liquidation
    > contractLeveragestringThe allowed default leverage for USDT Perpetual
    > transferRatiostringThe transfer ratio for loan funds to transfer from Spot wallet to Contract wallet
    > spotSymbolsarrayThe whitelist of spot trading pairs
    • If supportSpot="0", then it returns "[]"
    • If empty array, then you can trade any symbols
    • If not empty, then you can only trade listed symbols
    > contractSymbolsarrayThe whitelist of contract trading pairs
    • If supportContract="0", then it returns "[]"
    • If empty array, then you can trade any symbols
    • If not empty, then you can only trade listed symbols
    > supportUSDCContractintegerWhether to support USDC contract. '0':false; '1':true
    > supportUSDCOptionsintegerWhether to support Option. '0':false; '1':true
    > USDTPerpetualOpenLinestringRestrict line to open USDT Perpetual position
    > USDCContractOpenLinestringRestrict line to open USDC Contract position
    > USDCOptionsOpenLinestringRestrict line to open Option position
    > USDTPerpetualCloseLinestringRestrict line to trade USDT Perpetual
    > USDCContractCloseLinestringRestrict line to trade USDC Contract
    > USDCOptionsCloseLinestringRestrict line to trade Option
    > USDCContractSymbolsarrayThe whitelist of USDC contract trading pairs
    • If supportContract="0", then it returns "[]"
    • If no whitelist symbols, it is [], and you can trade any
    • If supportUSDCContract="0", it is []
    > USDCOptionsSymbolsarrayThe whitelist of Option symbols
    • If supportContract="0", then it returns "[]"
    • If no whitelisted, it is [], and you can trade any
    • If supportUSDCOptions="0", it is []
    > marginLeveragestringThe allowable maximum leverage for Spot margin trading. If supportMarginTrading=0, then it returns ""
    > USDTPerpetualLeveragearrayObject
    • If supportContract="0", it is []
    • If no whitelist USDT perp symbols, it returns all trading symbols and leverage by default
    • If there are whitelist symbols, it return those whitelist data
    >> symbolstringSymbol name
    >> leveragestringMaximum leverage
    > USDCContractLeveragearrayObject
    • If supportUSDCContract="0", it is []
    • If no whitelist USDC contract symbols, it returns all trading symbols and leverage by default
    • If there are whitelist symbols, it return those whitelist data
    >> symbolstringSymbol name
    >> leveragestringMaximum leverage

    Request Example​

    GET /v5/ins-loan/product-infos?productId=91 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "marginProductInfo": [
                {
                    "productId": "91",
                    "leverage": "4.00000000",
                    "supportSpot": 1,
                    "supportContract": 0,
                    "withdrawLine": "",
                    "transferLine": "",
                    "spotBuyLine": "",
                    "spotSellLine": "",
                    "contractOpenLine": "",
                    "liquidationLine": "0.75",
                    "stopLiquidationLine": "0.35000000",
                    "contractLeverage": "0",
                    "transferRatio": "0",
                    "spotSymbols": [],
                    "contractSymbols": [],
                    "supportUSDCContract": 0,
                    "supportUSDCOptions": 0,
                    "USDTPerpetualOpenLine": "",
                    "USDCContractOpenLine": "",
                    "USDCOptionsOpenLine": "",
                    "USDTPerpetualCloseLine": "",
                    "USDCContractCloseLine": "",
                    "USDCOptionsCloseLine": "",
                    "USDCContractSymbols": [],
                    "USDCOptionsSymbols": [],
                    "marginLeverage": "0",
                    "USDTPerpetualLeverage": [],
                    "USDCContractLeverage": [],
                    "deferredLiquidationLine":"",
                    "deferredLiquidationTime":"",
                }
            ]
        },
        "retExtInfo": {},
        "time": 1689747746332
    }
    - + \ No newline at end of file diff --git a/v5/otc/repay-info.html b/v5/otc/repay-info.html index fc732868fb..5faf7d0b0a 100644 --- a/v5/otc/repay-info.html +++ b/v5/otc/repay-info.html @@ -4,13 +4,13 @@ Get Repayment Orders | Bybit API Documentation - +

    Get Repayment Orders

    Get a list of your loan repayment orders (orders which repaid the loan).

    tip
    • Get the past 2 years data by default
    • Get up to the past 2 years of data

    HTTP Request​

    GET /v5/ins-loan/repaid-history

    Request Parameters​

    ParameterRequiredTypeComments
    startTimefalseintegerThe start timestamp (ms)
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size. [1, 100]. Default: 100

    Response Parameters​

    ParameterTypeComments
    repayInfoarrayObject
    > repayOrderIdstringRepaid order ID
    > repaidTimestringRepaid timestamp (ms)
    > tokenstringRepaid coin
    > quantitystringRepaid principle
    > intereststringRepaid interest
    > businessTypestringRepaid type. 1：normal repayment; 2：repaid by liquidation
    > statusstring1：success; 2：fail

    Request Example​

    GET /v5/ins-loan/repaid-history HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1678687944725
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "repayInfo": [
                {
                    "repayOrderId": "8189",
                    "repaidTime": "1663126393000",
                    "token": "USDT",
                    "quantity": "30000",
                    "interest": "0",
                    "businessType": "1",
                    "status": "1"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669366648366
    }
    - + \ No newline at end of file diff --git a/v5/position.html b/v5/position.html index d7e34af23b..a09abbfe09 100644 --- a/v5/position.html +++ b/v5/position.html @@ -4,14 +4,14 @@ Get Position Info | Bybit API Documentation - +

    Get Position Info

    Query real-time position data, such as position size, cumulative realizedPNL.

    Unified account covers: USDT perpetual / USDC contract / Inverse contract / Options
    -Classic account covers: USDT perpetual / Inverse contract

    info

    Regarding inverse contracts,

    1. you can query all holding positions with "/v5/position/list?category=inverse";
    2. symbol parameter is supported to be passed with multiple symbols up to 10

    HTTP Request​

    GET /v5/position/list

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse, option
    • Classic account: linear, inverse
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    • If symbol passed, it returns data regardless of having position or not.
    • If symbol=null and settleCoin specified, it returns position size greater than zero.
    baseCoinfalsestringBase coin, uppercase only. option only. Return all option positions if not passed
    settleCoinfalsestringSettle coin. For linear, either symbol or settleCoin is required. symbol has a higher priority
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 20
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > positionIdxintegerPosition idx, used to identify positions in different position modes
    • 0: One-Way Mode
    • 1: Buy side of both side mode
    • 2: Sell side of both side mode
    > riskIdintegerRisk limit ID. Note: for portfolio margin mode, this field returns 0, which means risk limit rules are invalid
    > riskLimitValuestringRisk limit value. Note: for portfolio margin mode, this field returns 0, which means risk limit rules are invalid
    > symbolstringSymbol name
    > sidestringPosition side. Buy: long, Sell: short
    • Classic account in one-way mode & Unified account (inverse), an empty position returns None.
    • UTA account(linear contracts), either one-way or hedge mode returns an empty string for an empty position.
    > sizestringPosition size
    > avgPricestringAverage entry price
  • For USDC Perp & Futures, it indicates average entry price, and it will not be changed with 8-hour session settlement
    • > positionValuestringPosition value
    > tradeModeintegerTrade mode
    • Classic & UTA (inverse): 0: cross-margin, 1: isolated margin
    • UTA: depreciated, always 0
    > autoAddMarginintegerWhether to add margin automatically. 0: false, 1: true. For UTA, it is meaningful only when UTA enables ISOLATED_MARGIN
    > positionStatusStringPosition status. Normal, Liq, Adl
    > leveragestringPosition leverage. Valid for contract. Note: for portfolio margin mode, this field returns "", which means leverage rules are invalid
    > markPricestringLast mark price
    > liqPricestringPosition liquidation price
    • UTA (inverse) & UTA (isolated margin enabled) & Classic account: it is the real price for isolated and cross positions, and keeps "" when liqPrice <= minPrice or liqPrice >= maxPrice
    • UTA (Cross margin mode): it is an estimated price for cross positions(because the unified mode controls the risk rate according to the account), and keeps "" when liqPrice <= minPrice or liqPrice >= maxPrice
    However, this field is empty for Portfolio Margin Mode, and no liquidation price will be provided
    > bustPricestringBankruptcy price. Note: Unified mode returns "", no position bankruptcy price (exclude inverse trade under UTA)
    > positionIMstringInitial margin. For portfolio margin mode, it returns ""
    > positionMMstringMaintenance margin. For portfolio margin mode, it returns ""
    > positionBalancestringPosition margin
  • UTA(linear): Only meaningful for isolated margin mode
    • > tpslModestringDepreciated, meaningless here, always "Full". Spot does not return this field. Option returns ""
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > trailingStopstringTrailing stop (The distance from market price)
    > sessionAvgPricestringUSDC contract session avg price, it is the same figure as avg entry price shown in the web UI
    > deltastringDelta, unique field for option
    > gammastringGamma, unique field for option
    > vegastringVega, unique field for option
    > thetastringTheta, unique field for option
    > unrealisedPnlstringUnrealised PnL
    > curRealisedPnlstringThe realised PnL for the current holding position
    > cumRealisedPnlstringCumulative realised pnl
    • Futures & Perp: it is the all time cumulative realised P&L
    • Option: always "", meaningless
    > adlRankIndicatorintegerAuto-deleverage rank indicator. What is Auto-Deleveraging?
    > isReduceOnlybooleanUseful when Bybit lower the risk limit
    • true: Only allowed to reduce the position. You can consider a series of measures, e.g., lower the risk limit, decrease leverage or reduce the position, add margin, or cancel orders, after these operations, you can call confirm new risk limit endpoint to check if your position can be removed the reduceOnly mark
    • false: There is no restriction, and it means your position is under the risk when the risk limit is systematically adjusted
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > mmrSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the MMR will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the MMR had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > leverageSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the leverage will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the leverage had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > createdTimestringTimestamp of the first time a position was created on this symbol (ms)
    > updatedTimestringPosition updated timestamp (ms)
    > seqlongCross sequence, used to associate each fill and each position update
    • Different symbols may have the same seq, please use seq + symbol to check unique
    • Returns "-1" if the symbol has never been traded
    • Returns the seq updated by the last transaction when there are settings like leverage, risk limit
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/position/list?category=inverse&symbol=BTCUSD HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672280218882
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "positionIdx": 0,
                    "riskId": 1,
                    "riskLimitValue": "150",
                    "symbol": "BTCUSD",
                    "side": "Sell",
                    "size": "300",
                    "avgPrice": "27464.50441675",
                    "positionValue": "0.01092319",
                    "tradeMode": 0,
                    "positionStatus": "Normal",
                    "autoAddMargin": 1,
                    "adlRankIndicator": 2,
                    "leverage": "10",
                    "positionBalance": "0.00139186",
                    "markPrice": "28224.50",
                    "liqPrice": "",
                    "bustPrice": "999999.00",
                    "positionMM": "0.0000015",
                    "positionIM": "0.00010923",
                    "tpslMode": "Full",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "trailingStop": "0.00",
                    "unrealisedPnl": "-0.00029413",
                    "curRealisedPnl": "0.00013123",
                    "cumRealisedPnl": "-0.00096902",
                    "seq": 5723621632,
                    "isReduceOnly": false,
                    "mmrSysUpdateTime": "",
                    "leverageSysUpdatedTime": "",
                    "sessionAvgPrice": "",
                    "createdTime": "1676538056258",
                    "updatedTime": "1697673600012"
                }
            ],
            "nextPageCursor": "",
            "category": "inverse"
        },
        "retExtInfo": {},
        "time": 1697684980172
    }
    - +Classic account covers: USDT perpetual / Inverse contract

    info

    Regarding inverse contracts,

    1. you can query all holding positions with "/v5/position/list?category=inverse";
    2. symbol parameter is supported to be passed with multiple symbols up to 10

    HTTP Request​

    GET /v5/position/list

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse, option
    • Classic account: linear, inverse
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    • If symbol passed, it returns data regardless of having position or not.
    • If symbol=null and settleCoin specified, it returns position size greater than zero.
    baseCoinfalsestringBase coin, uppercase only. option only. Return all option positions if not passed
    settleCoinfalsestringSettle coin. For linear, either symbol or settleCoin is required. symbol has a higher priority
    limitfalseintegerLimit for data size per page. [1, 200]. Default: 20
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > positionIdxintegerPosition idx, used to identify positions in different position modes
    • 0: One-Way Mode
    • 1: Buy side of both side mode
    • 2: Sell side of both side mode
    > riskIdintegerRisk limit ID. Note: for portfolio margin mode, this field returns 0, which means risk limit rules are invalid
    > riskLimitValuestringRisk limit value. Note: for portfolio margin mode, this field returns 0, which means risk limit rules are invalid
    > symbolstringSymbol name
    > sidestringPosition side. Buy: long, Sell: short
    • Classic account in one-way mode & Unified account (inverse), an empty position returns None.
    • UTA account(linear contracts), either one-way or hedge mode returns an empty string for an empty position.
    > sizestringPosition size
    > avgPricestringAverage entry price
  • For USDC Perp & Futures, it indicates average entry price, and it will not be changed with 8-hour session settlement
    • > positionValuestringPosition value
    > tradeModeintegerTrade mode
    • Classic & UTA (inverse): 0: cross-margin, 1: isolated margin
    • UTA: depreciated, always 0
    > autoAddMarginintegerWhether to add margin automatically. 0: false, 1: true. For UTA, it is meaningful only when UTA enables ISOLATED_MARGIN
    > positionStatusStringPosition status. Normal, Liq, Adl
    > leveragestringPosition leverage. Valid for contract. Note: for portfolio margin mode, this field returns "", which means leverage rules are invalid
    > markPricestringLast mark price
    > liqPricestringPosition liquidation price
    • UTA (inverse) & UTA (isolated margin enabled) & Classic account: it is the real price for isolated and cross positions, and keeps "" when liqPrice <= minPrice or liqPrice >= maxPrice
    • UTA (Cross margin mode): it is an estimated price for cross positions(because the unified mode controls the risk rate according to the account), and keeps "" when liqPrice <= minPrice or liqPrice >= maxPrice
    However, this field is empty for Portfolio Margin Mode, and no liquidation price will be provided
    > bustPricestringBankruptcy price. Note: Unified mode returns "", no position bankruptcy price (exclude inverse trade under UTA)
    > positionIMstringInitial margin. For portfolio margin mode, it returns ""
    > positionMMstringMaintenance margin. For portfolio margin mode, it returns ""
    > positionBalancestringPosition margin
  • UTA(linear): Only meaningful for isolated margin mode
    • > tpslModestringDepreciated, meaningless here, always "Full". Spot does not return this field. Option returns ""
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > trailingStopstringTrailing stop (The distance from market price)
    > sessionAvgPricestringUSDC contract session avg price, it is the same figure as avg entry price shown in the web UI
    > deltastringDelta, unique field for option
    > gammastringGamma, unique field for option
    > vegastringVega, unique field for option
    > thetastringTheta, unique field for option
    > unrealisedPnlstringUnrealised PnL
    > curRealisedPnlstringThe realised PnL for the current holding position
    > cumRealisedPnlstringCumulative realised pnl
    • Futures & Perp: it is the all time cumulative realised P&L
    • Option: always "", meaningless
    > adlRankIndicatorintegerAuto-deleverage rank indicator. What is Auto-Deleveraging?
    > isReduceOnlybooleanUseful when Bybit lower the risk limit
    • true: Only allowed to reduce the position. You can consider a series of measures, e.g., lower the risk limit, decrease leverage or reduce the position, add margin, or cancel orders, after these operations, you can call confirm new risk limit endpoint to check if your position can be removed the reduceOnly mark
    • false: There is no restriction, and it means your position is under the risk when the risk limit is systematically adjusted
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > mmrSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the MMR will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the MMR had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > leverageSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the leverage will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the leverage had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > createdTimestringTimestamp of the first time a position was created on this symbol (ms)
    > updatedTimestringPosition updated timestamp (ms)
    > seqlongCross sequence, used to associate each fill and each position update
    • Different symbols may have the same seq, please use seq + symbol to check unique
    • Returns "-1" if the symbol has never been traded
    • Returns the seq updated by the last transaction when there are settings like leverage, risk limit
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/position/list?category=inverse&symbol=BTCUSD HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672280218882
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "positionIdx": 0,
                    "riskId": 1,
                    "riskLimitValue": "150",
                    "symbol": "BTCUSD",
                    "side": "Sell",
                    "size": "300",
                    "avgPrice": "27464.50441675",
                    "positionValue": "0.01092319",
                    "tradeMode": 0,
                    "positionStatus": "Normal",
                    "autoAddMargin": 1,
                    "adlRankIndicator": 2,
                    "leverage": "10",
                    "positionBalance": "0.00139186",
                    "markPrice": "28224.50",
                    "liqPrice": "",
                    "bustPrice": "999999.00",
                    "positionMM": "0.0000015",
                    "positionIM": "0.00010923",
                    "tpslMode": "Full",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "trailingStop": "0.00",
                    "unrealisedPnl": "-0.00029413",
                    "curRealisedPnl": "0.00013123",
                    "cumRealisedPnl": "-0.00096902",
                    "seq": 5723621632,
                    "isReduceOnly": false,
                    "mmrSysUpdateTime": "",
                    "leverageSysUpdatedTime": "",
                    "sessionAvgPrice": "",
                    "createdTime": "1676538056258",
                    "updatedTime": "1697673600012"
                }
            ],
            "nextPageCursor": "",
            "category": "inverse"
        },
        "retExtInfo": {},
        "time": 1697684980172
    }
    + \ No newline at end of file diff --git a/v5/position/auto-add-margin.html b/v5/position/auto-add-margin.html index 8c9c93f4d2..a12447f30c 100644 --- a/v5/position/auto-add-margin.html +++ b/v5/position/auto-add-margin.html @@ -4,14 +4,14 @@ Set Auto Add Margin | Bybit API Documentation - +

    Set Auto Add Margin

    Turn on/off auto-add-margin for isolated margin position

    Unified account covers: USDT perpetual / USDC perpetual / USDC futures
    Classic account covers: USDT perpetual

    HTTP Request​

    POST /v5/position/set-auto-add-margin

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear
    • Classic account: linear
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    autoAddMargintrueintegerTurn on/off. 0: off. 1: on
    positionIdxfalseintegerUsed to identify positions in different position modes. For hedge mode position, this param is required
    • 0: one-way mode
    • 1: hedge-mode Buy side
    • 2: hedge-mode Sell side

    Response Parameters​

    None

    Request Example​

    POST /v5/position/set-auto-add-margin HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675255134857
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "BTCUSDT",
        "autoAddmargin": 1,
        "positionIdx": null
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1675255135069
    }
    - + \ No newline at end of file diff --git a/v5/position/close-pnl.html b/v5/position/close-pnl.html index 1e532f9e8b..80ea078179 100644 --- a/v5/position/close-pnl.html +++ b/v5/position/close-pnl.html @@ -4,14 +4,14 @@ Get Closed PnL | Bybit API Documentation - +

    Get Closed PnL

    Query user's closed profit and loss records

    Unified account covers: USDT perpetual / USDC contract / Inverse contract
    Classic account covers: USDT perpetual / Inverse contract

    info
    • Classic account: the results are sorted by updatedTime in descending order.
    • Unified account (except Inverse contract): the results are sorted by createdTime in descending order, this will be constant with classic account afterwards
    • Unified account (linear, spot, option) supports getting the past 730 days historical data

    HTTP Request​

    GET /v5/position/closed-pnl

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse
    • Classic account: linear, inverse. Please note that category is not involved with business logic
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed, the rule is endTime - startTime <= 7 days
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 100]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > orderIdstringOrder ID
    > sidestringBuy, Sell
    > qtystringOrder qty
    > orderPricestringOrder price
    > orderTypestringOrder type. Market,Limit
    > execTypestringExec type. Trade, BustTrade, SessionSettlePnL, Settle, MovePosition
    > closedSizestringClosed size
    > cumEntryValuestringCumulated Position value
    > avgEntryPricestringAverage entry price
    > cumExitValuestringCumulated exit position value
    > avgExitPricestringAverage exit price
    > closedPnlstringClosed PnL
    > fillCountstringThe number of fills in a single order
    > leveragestringleverage
    > createdTimestringThe created time (ms)
    > updatedTimestringThe updated time (ms)
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/position/closed-pnl?category=linear&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672284128523
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "5a373bfe-188d-4913-9c81-d57ab5be8068%3A1672214887231423699%2C5a373bfe-188d-4913-9c81-d57ab5be8068%3A1672214887231423699",
            "category": "linear",
            "list": [
                {
                    "symbol": "ETHPERP",
                    "orderType": "Market",
                    "leverage": "3",
                    "updatedTime": "1672214887236",
                    "side": "Sell",
                    "orderId": "5a373bfe-188d-4913-9c81-d57ab5be8068",
                    "closedPnl": "-47.4065323",
                    "avgEntryPrice": "1194.97516667",
                    "qty": "3",
                    "cumEntryValue": "3584.9255",
                    "createdTime": "1672214887231423699",
                    "orderPrice": "1122.95",
                    "closedSize": "3",
                    "avgExitPrice": "1180.59833333",
                    "execType": "Trade",
                    "fillCount": "4",
                    "cumExitValue": "3541.795"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672284129153
    }
    - + \ No newline at end of file diff --git a/v5/position/confirm-mmr.html b/v5/position/confirm-mmr.html index d8f4ab8553..5db02be40b 100644 --- a/v5/position/confirm-mmr.html +++ b/v5/position/confirm-mmr.html @@ -4,7 +4,7 @@ Confirm New Risk Limit | Bybit API Documentation - + @@ -14,7 +14,7 @@ is called to try to calculate the adjusted risk level, and if it passes (retCode=0), the system will remove the position reduceOnly mark. You are recommended to call Get Position Info to check isReduceOnly field.

    Unified account covers: USDT perpetual / USDC contract / Inverse contract
    Classic account covers: USDT perpetual / Inverse contract

    HTTP Request​

    POST /v5/position/confirm-pending-mmr

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse
    • Classic account: linear, inverse
    symboltruestringSymbol name

    Response Parameters​

    None

    Request Example​

    POST /v5/position/confirm-pending-mmr HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1698051123673
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 53

    {
        "category": "linear",
        "symbol": "BTCUSDT"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1698051124588
    }
    - + \ No newline at end of file diff --git a/v5/position/cross-isolate.html b/v5/position/cross-isolate.html index 03b885e9c3..a0ea017a72 100644 --- a/v5/position/cross-isolate.html +++ b/v5/position/cross-isolate.html @@ -4,14 +4,14 @@ Switch Cross/Isolated Margin | Bybit API Documentation - +

    Switch Cross/Isolated Margin

    Select cross margin mode or isolated margin mode per symbol level

    Unified account covers: Inverse contract
    Classic account covers: USDT perpetual / Inverse contract

    HTTP Request​

    POST /v5/position/switch-isolated

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: inverse
    • Classic account: linear, inverse. Please note that category is not involved with business logic
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    tradeModetrueinteger0: cross margin. 1: isolated margin
    buyLeveragetruestringThe value must be equal to sellLeverage value
    sellLeveragetruestringThe value must be equal to buyLeverage value

    Response Parameters​

    None

    Request Example​

    POST /v5/position/switch-isolated HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675248447965
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 121

    {
        "category": "linear",
        "symbol": "ETHUSDT",
        "tradeMode": 1,
        "buyLeverage": "10",
        "sellLeverage": "10"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1675248433635
    }
    - + \ No newline at end of file diff --git a/v5/position/leverage.html b/v5/position/leverage.html index 9bd2232b7b..3ede56bbaa 100644 --- a/v5/position/leverage.html +++ b/v5/position/leverage.html @@ -4,14 +4,14 @@ Set Leverage | Bybit API Documentation - +

    Set Leverage

    Set the leverage

    Unified account covers: USDT perpetual / USDC contract / Inverse contract
    Classic account covers: USDT perpetual / Inverse contract

    HTTP Request​

    POST /v5/position/set-leverage

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse
    • Classic account: linear, inverse. Please note that category is not involved with business logic
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    buyLeveragetruestring[1, max leverage of corresponding risk limit]
    • one-way mode: buyLeverage must be the same as sellLeverage
    • Hedge mode:
      Classic account & UTA (isolated margin): buyLeverage and sellLeverage can be different;
      UTA (cross margin): buyLeverage must be the same as sellLeverage
    sellLeveragetruestring[1, max leverage of corresponding risk limit]

    Response Parameters​

    None

    Request Example​

    POST /v5/position/set-leverage HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672281605082
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "BTCUSDT",
        "buyLeverage": "6",
        "sellLeverage": "6"

    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1672281607343
    }
    - + \ No newline at end of file diff --git a/v5/position/manual-add-margin.html b/v5/position/manual-add-margin.html index db90c308d3..9811d3ced2 100644 --- a/v5/position/manual-add-margin.html +++ b/v5/position/manual-add-margin.html @@ -4,14 +4,14 @@ Add Or Reduce Margin | Bybit API Documentation - +

    Add Or Reduce Margin

    Manually add or reduce margin for isolated margin position

    Unified account covers: USDT perpetual / USDC perpetual / USDC futures / Inverse contract
    Classic account covers: USDT perpetual / Inverse contract

    HTTP Request​

    POST /v5/position/add-margin

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse
    • Classic account: linear, inverse
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    margintruestringAdd or reduce. To add, then 10; To reduce, then -10. Support up to 4 decimal
    positionIdxfalseintegerUsed to identify positions in different position modes. For hedge mode position, this param is required
    • 0: one-way mode
    • 1: hedge-mode Buy side
    • 2: hedge-mode Sell side

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    symbolstringSymbol name
    positionIdxintegerPosition idx, used to identify positions in different position modes
    • 0: One-Way Mode
    • 1: Buy side of both side mode
    • 2: Sell side of both side mode
    riskIdintegerRisk limit ID
    riskLimitValuestringRisk limit value
    sizestringPosition size
    avgPricestringAverage entry price
    liqPricestringLiquidation price
    bustPricestringBankruptcy price
    markPricestringLast mark price
    positionValuestringPosition value
    leveragestringPosition leverage
    autoAddMarginintegerWhether to add margin automatically. 0: false, 1: true
    positionStatusStringPosition status. Normal, Liq, Adl
    positionIMstringInitial margin
    positionMMstringMaintenance margin
    takeProfitstringTake profit price
    stopLossstringStop loss price
    trailingStopstringTrailing stop (The distance from market price)
    unrealisedPnlstringUnrealised PnL
    cumRealisedPnlstringCumulative realised pnl
    createdTimestringTimestamp of the first time a position was created on this symbol (ms)
    updatedTimestringPosition updated timestamp (ms)

    Request Example​

    POST /v5/position/add-margin HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1684234363665
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 97

    {
        "category": "inverse",
        "symbol": "ETHUSD",
        "margin": "0.01",
        "positionIdx": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "inverse",
            "symbol": "ETHUSD",
            "positionIdx": 0,
            "riskId": 11,
            "riskLimitValue": "500",
            "size": "200",
            "positionValue": "0.11033265",
            "avgPrice": "1812.70004844",
            "liqPrice": "1550.80",
            "bustPrice": "1544.20",
            "markPrice": "1812.90",
            "leverage": "12",
            "autoAddMargin": 0,
            "positionStatus": "Normal",
            "positionIM": "0.01926611",
            "positionMM": "0",
            "unrealisedPnl": "0.00001217",
            "cumRealisedPnl": "-0.04618929",
            "stopLoss": "0.00",
            "takeProfit": "0.00",
            "trailingStop": "0.00",
            "createdTime": "1672737740039",
            "updatedTime": "1684234363788"
        },
        "retExtInfo": {},
        "time": 1684234363789
    }
    - + \ No newline at end of file diff --git a/v5/position/move-position-history.html b/v5/position/move-position-history.html index 4ef4df9bbb..206f085cf5 100644 --- a/v5/position/move-position-history.html +++ b/v5/position/move-position-history.html @@ -4,13 +4,13 @@ Get Move Position History | Bybit API Documentation - +

    Get Move Position History

    You can query moved position data by master UID api key

    Unified account covers: USDT perpetual / USDC contract / Spot / Option

    HTTP Request​

    GET /v5/position/move-history

    Request Parameters​

    ParameterRequiredTypeComments
    categoryfalsestringProduct type. linear, spot, option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    startTimefalsenumberThe order creation start timestamp. The interval is 7 days
    endTimefalsenumberThe order creation end timestamp. The interval is 7 days
    statusfalsestringOrder status. Processing, Filled, Rejected
    blockTradeIdfalsestringBlock trade ID
    limitfalsestringLimit for data size per page. [1, 200]. Default: 20
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > blockTradeIdstringBlock trade ID
    > categorystringProduct type. linear, spot, option
    > orderIdstringBybit order ID
    > userIdintegerUser ID
    > symbolstringSymbol name
    > sidestringOrder side from taker's perspective. Buy, Sell
    > pricestringOrder price
    > qtystringOrder quantity
    > execFeestringThe fee for taker or maker in the base currency paid to the Exchange executing the block trade
    > statusstringBlock trade status. Processing, Filled, Rejected
    > execIdstringThe unique trade ID from the exchange
    > resultCodeintegerThe result code of the order. 0 means success
    > resultMessagestringThe error message. "" when resultCode=0
    > createdAtnumberThe timestamp (ms) when the order is created
    > updatedAtnumberThe timestamp (ms) when the order is updated
    > rejectPartystring
    • "" means the status=Filled
    • Taker, Maker when status=Rejected
    • bybit means error is occurred on the Bybit side
    nextPageCursorstringUsed to get the next page data

    Request Example​

    GET /v5/position/move-history?limit=1&status=Filled HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1697523024244
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "blockTradeId": "1a82e5801af74b67b7ad71ba00a7391a",
                    "category": "option",
                    "orderId": "8e09c5b8-f651-4cec-968d-52764cac11ec",
                    "userId": 592324,
                    "symbol": "BTC-14OCT23-27000-C",
                    "side": "Buy",
                    "price": "6",
                    "qty": "0.99",
                    "execFee": "0",
                    "status": "Filled",
                    "execId": "677ad344-6bb4-4ace-baca-128fcffcaca7",
                    "resultCode": 0,
                    "resultMessage": "",
                    "createdAt": 1697186522865,
                    "updatedAt": 1697186523289,
                    "rejectParty": ""
                }
            ],
            "nextPageCursor": "page_token%3D1241742%26"
        },
        "retExtInfo": {},
        "time": 1697523024386
    }
    - + \ No newline at end of file diff --git a/v5/position/move-position.html b/v5/position/move-position.html index 921a7c61d3..a8c12df6cf 100644 --- a/v5/position/move-position.html +++ b/v5/position/move-position.html @@ -4,13 +4,13 @@ Move Position | Bybit API Documentation - +

    Move Position

    You can move positions between sub-master, master-sub, or sub-sub UIDs when necessary

    Unified account covers: USDT perpetual / USDC contract / Spot / Option

    info
    • The endpoint can only be called by master UID api key
    • UIDs must be the same master-sub account relationship
    • The trades generated from move-position endpoint will not be displayed in the Recent Trade (Rest API & Websocket)
    • There is no trading fee
    • fromUid and toUid both should be Unified trading accounts, and they need to be one-way mode when moving the positions
    • Please note that once executed, you will get execType=MovePosition entry from Get Trade History, Get Closed Pnl, and stream from Execution.

    HTTP Request​

    POST /v5/position/move-positions

    Request Parameters​

    ParameterRequiredTypeComments
    fromUidtruestringFrom UID
    • Must be UTA
    • Must be in one-way mode for Futures
    toUidtruestringTo UID
    • Must be UTA
    • Must be in one-way mode for Futures
    listtruearrayObject. Up to 25 legs per request
    > categorytruestringProduct type. linear, spot, option
    > symboltruestringSymbol name, like BTCUSDT, uppercase only
    > pricetruestringTrade price
    • linear: the price needs to be between [95% of mark price, 105% of mark price]
    • spot&option: the price needs to follow the price rule from Instruments Info
    > sidetruestringTrading side of fromUid
    • For example, fromUid has a long position, when side=Sell, then once executed, the position of fromUid will be reduced or open a short position depending on qty input
    > qtytruestringExecuted qty
    • The value must satisfy the qty rule from Instruments Info, in particular, category=linear is able to input maxOrderQty * 5

    Response Parameters​

    ParameterTypeComments
    retCodeintegerResult code. 0 means request is successfully accepted
    retMsgstringResult message
    resultmapObject
    > blockTradeIdstringBlock trade ID
    > statusstringStatus. Processing, Rejected
    > rejectPartystring
    • "" means initial validation is passed, please check the order status via Get Move Position History
    • Taker, Maker when status=Rejected
    • bybit means error is occurred on the Bybit side

    Request Example​

    POST /v5/position/move-positions HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1697447928051
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "fromUid": "100307601",
        "toUid": "592324",
        "list": [
            {
                "category": "spot",
                "symbol": "BTCUSDT",
                "price": "100",
                "side": "Sell",
                "qty": "0.01"
            }
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "blockTradeId": "e9bb926c95f54cf1ba3e315a58b8597b",
            "status": "Processing",
            "rejectParty": ""
        }
    }
    - + \ No newline at end of file diff --git a/v5/position/position-mode.html b/v5/position/position-mode.html index 40b83f49ff..7c82e65a12 100644 --- a/v5/position/position-mode.html +++ b/v5/position/position-mode.html @@ -4,14 +4,14 @@ Switch Position Mode | Bybit API Documentation - +

    Switch Position Mode

    It supports to switch the position mode for USDT perpetual and Inverse futures. If you are in one-way Mode, you can only open one position on Buy or Sell side. If you are in hedge mode, you can open both Buy and Sell side positions simultaneously.

    Unified account covers: USDT perpetual / Inverse Futures
    Classic account covers: USDT perpetual / Inverse Futures

    tip
    • Priority for configuration to take effect: symbol > coin > system default
    • System default: one-way mode
    • If the request is by coin (settleCoin), then all symbols based on this setteCoin that do not have position and open order will be batch switched, and new listed symbol based on this settleCoin will be the same mode you set.

    Example​

    System defaultcoinsymbol
    Initial settingone-waynever configurednever configured
    ResultAll USDT perpetual trading pairs are one-way mode
    Change 1--Set BTCUSDT to hedge-mode
    ResultBTCUSDT becomes hedge-mode, and all other symbols keep one-way mode
    list new symbol ETHUSDTETHUSDT is one-way mode （inherit default rules）
    Change 2-Set USDT to hedge-mode-
    ResultAll current trading pairs with no positions or orders are hedge-mode, and no adjustments will be made for trading pairs with positions and orders
    list new symbol SOLUSDTSOLUSDT is hedge-mode (Inherit coin rule)
    Change 3--Set ASXUSDT to one-mode
    Take effect resultAXSUSDT is one-way mode, other trading pairs have no change
    list new symbol BITUSDTBITUSDT is hedge-mode (Inherit coin rule)

    The position-switch ability for each contract​

    Classic accountUnified account
    USDT perpetualSupport one-way & hedge-modeSupport one-way & hedge-mode
    USDC perpetualSupport one-way onlySupport one-way only
    Inverse perpetualSupport one-way onlySupport one-way only
    Inverse futureSupport one-way & hedge-modeSupport one-way & hedge-mode

    HTTP Request​

    POST /v5/position/switch-mode

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, USDT Perp; inverse, Inverse Futures
    • Classic account: linear, USDT Perp; inverse, Inverse Futures. Please note that category is not involved with business logic
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only. Either symbol or coin is required. symbol has a higher priority
    coinfalsestringCoin, uppercase only
    modetrueintegerPosition mode. 0: Merged Single. 3: Both Sides

    Response Parameters​

    None

    Request Example​

    POST /v5/position/switch-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675249072041
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 87

    {
        "category":"inverse",
        "symbol":"BTCUSDH23",
        "coin": null,
        "mode": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1675249072814
    }
    - + \ No newline at end of file diff --git a/v5/position/set-risk-limit.html b/v5/position/set-risk-limit.html index ac68c399c9..b2d062614a 100644 --- a/v5/position/set-risk-limit.html +++ b/v5/position/set-risk-limit.html @@ -4,13 +4,13 @@ Set Risk Limit | Bybit API Documentation - +

    Set Risk Limit

    Since bybit has launched auto risk limit on 12 March 2024, please click here to learn more, so it will not take effect even you set it successfully.

    HTTP Request​

    POST /v5/position/set-risk-limit

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse
    • Classic account: linear, inverse. Please note that category is not involved with business logic
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    riskIdtrueintegerRisk limit ID
    positionIdxfalseintegerUsed to identify positions in different position modes. For hedge mode, it is required
    • 0: one-way mode
    • 1: hedge-mode Buy side
    • 2: hedge-mode Sell side

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    riskIdintegerRisk limit ID
    riskLimitValuestringThe position limit value corresponding to this risk ID

    Request Example​

    POST /v5/position/set-risk-limit HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672282269774
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "BTCUSDT",
        "riskId": 4,
        "positionIdx": null
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "riskId": 4,
            "riskLimitValue": "8000000",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1672282270571
    }
    - + \ No newline at end of file diff --git a/v5/position/tpsl-mode.html b/v5/position/tpsl-mode.html index 52c5337845..1177aaab37 100644 --- a/v5/position/tpsl-mode.html +++ b/v5/position/tpsl-mode.html @@ -4,7 +4,7 @@ Set TP/SL Mode | Bybit API Documentation - + @@ -13,7 +13,7 @@ change before.

    However, you still can use it to set an implicit tpsl mode for a certain symbol because when you don't pass "tpslMode" in the place order or trading stop request, system will get the tpslMode by the default setting.

    Set TP/SL mode to Full or Partial

    Unified account covers: USDT perpetual / Inverse contract
    Classic account covers: USDT perpetual / Inverse contract

    info

    For partial TP/SL mode, you can set the TP/SL size smaller than position size.

    HTTP Request​

    POST /v5/position/set-tpsl-mode

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse
    • Classic account: linear, inverse. Please note that category is not involved with business logic
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    tpSlModetruestringTP/SL mode. Full,Partial

    Response Parameters​

    ParameterTypeComments
    tpSlModestringFull,Partial

    Request Example​

    POST /v5/position/set-tpsl-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672279325035
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "symbol": "XRPUSDT",
        "category": "linear",
        "tpSlMode": "Full"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "tpSlMode": "Full"
        },
        "retExtInfo": {},
        "time": 1672279322666
    }
    - + \ No newline at end of file diff --git a/v5/position/trading-stop.html b/v5/position/trading-stop.html index d5a713aea9..7a6c2fb5d2 100644 --- a/v5/position/trading-stop.html +++ b/v5/position/trading-stop.html @@ -4,7 +4,7 @@ Set Trading Stop | Bybit API Documentation - + @@ -14,7 +14,7 @@ on existing TP/SL orders on the holding position, it will cause the paired tp/sl orders to lose binding relationship. This means that when calling the cancel API through the tp/sl order ID, it will only cancel the corresponding one-sided take profit or stop loss order ID.

    HTTP Request​

    POST /v5/position/trading-stop

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type
    • Unified account: linear, inverse
    • Classic account: linear, inverse. Please note that category is not involved with business logic
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    takeProfitfalsestringCannot be less than 0, 0 means cancel TP
    stopLossfalsestringCannot be less than 0, 0 means cancel SL
    trailingStopfalsestringTrailing stop by price distance. Cannot be less than 0, 0 means cancel TS
    tpTriggerByfalsestringTake profit trigger price type
    slTriggerByfalsestringStop loss trigger price type
    activePricefalsestringTrailing stop trigger price. Trailing stop will be triggered when this price is reached only
    tpslModetruestringTP/SL mode. Full: entire position TP/SL, Partial: partial position TP/SL
    tpSizefalsestringTake profit size. Valid in TP/SL partial mode. Note: the value of tpSize and slSize must equal
    slSizefalsestringStop loss size. Valid in TP/SL partial mode. Note: the value of tpSize and slSize must equal
    tpLimitPricefalsestringThe limit order price when take profit price is triggered. Only works when tpslMode=Partial and tpOrderType=Limit
    slLimitPricefalsestringThe limit order price when stop loss price is triggered. Only works when tpslMode=Partial and slOrderType=Limit
    tpOrderTypefalsestringThe order type when take profit is triggered. Market(default), Limit. For tpslMode=Full, it only supports tpOrderType=Market
    slOrderTypefalsestringThe order type when stop loss is triggered. Market(default), Limit. For tpslMode=Full, it only supports slOrderType=Market
    positionIdxtrueintegerUsed to identify positions in different position modes.
    • 0: one-way mode
    • 1: hedge-mode Buy side
    • 2: hedge-mode Sell side

    Response Parameters​

    None

    Request Example​

    POST /v5/position/trading-stop HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672283124270
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category":"linear",
        "symbol": "XRPUSDT",
        "takeProfit": "0.6",
        "stopLoss": "0.2",
        "tpTriggerBy": "MarkPrice",
        "slTriggerBy": "IndexPrice",
        "tpslMode": "Partial",
        "tpOrderType": "Limit",
        "slOrderType": "Limit",
        "tpSize": "50",
        "slSize": "50",
        "tpLimitPrice": "0.57",
        "slLimitPrice": "0.21",
        "positionIdx": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1672283125359
    }
    - + \ No newline at end of file diff --git a/v5/pre-upgrade/close-pnl.html b/v5/pre-upgrade/close-pnl.html index 4ac52d91e8..05902ca5de 100644 --- a/v5/pre-upgrade/close-pnl.html +++ b/v5/pre-upgrade/close-pnl.html @@ -4,13 +4,13 @@ Get Pre-upgrade Closed PnL | Bybit API Documentation - +

    Get Pre-upgrade Closed PnL

    Query user's closed profit and loss records from before you upgraded the account to a Unified account. The results are sorted by updatedTime in descending order.

    For now, it only supports to query USDT perpetual, Inverse perpetual and futures.

    HTTP Request​

    GET /v5/pre-upgrade/position/closed-pnl

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type linear, inverse
    symboltruestringSymbol name, like BTCUSDT, uppercase only
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed, the rule is endTime - startTime <= 7 days
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 100]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > orderIdstringOrder ID
    > sidestringBuy, Side
    > qtystringOrder qty
    > orderPricestringOrder price
    > orderTypestringOrder type. Market,Limit
    > execTypestringExec type. Trade, BustTrade, SessionSettlePnL, Settle
    > closedSizestringClosed size
    > cumEntryValuestringCumulated Position value
    > avgEntryPricestringAverage entry price
    > cumExitValuestringCumulated exit position value
    > avgExitPricestringAverage exit price
    > closedPnlstringClosed PnL
    > fillCountstringThe number of fills in a single order
    > leveragestringleverage
    > createdTimestringThe created time (ms)
    > updatedTimestringThe updated time (ms)
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/pre-upgrade/position/closed-pnl?category=linear&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682580911998
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "orderId": "67836246-460e-4c52-a009-af0c3e1d12bc",
                    "side": "Sell",
                    "qty": "0.200",
                    "orderPrice": "27203.40",
                    "orderType": "Market",
                    "execType": "Trade",
                    "closedSize": "0.200",
                    "cumEntryValue": "5588.88",
                    "avgEntryPrice": "27944.40",
                    "cumExitValue": "5726.4252",
                    "avgExitPrice": "28632.13",
                    "closedPnl": "204.25510011",
                    "fillCount": "22",
                    "leverage": "10",
                    "createdTime": "1682487465732",
                    "updatedTime": "1682487465732"
                }
            ],
            "category": "linear",
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1682580912259
    }
    - + \ No newline at end of file diff --git a/v5/pre-upgrade/delivery.html b/v5/pre-upgrade/delivery.html index fde3a68160..c8e4b144cf 100644 --- a/v5/pre-upgrade/delivery.html +++ b/v5/pre-upgrade/delivery.html @@ -4,13 +4,13 @@ Get Pre-upgrade Option Delivery Record | Bybit API Documentation - +

    Get Pre-upgrade Option Delivery Record

    Query delivery records of Option before you upgraded the account to a Unified account, sorted by deliveryTime in descending order

    info

    Supports the recent 6 months data. Please download older data via GUI

    HTTP Request​

    GET /v5/pre-upgrade/asset/delivery-record

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    expDatefalsestringExpiry date. 25MAR22. Default: return all
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 20
    cursorfalsestringCursor. Used for pagination

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > deliveryTimenumberDelivery time (ms)
    > symbolstringSymbol name
    > sidestringBuy,Sell
    > positionstringExecuted size
    > deliveryPricestringDelivery price
    > strikestringExercise price
    > feestringTrading fee
    > deliveryRplstringRealized PnL of the delivery
    nextPageCursorstringCursor. Used for pagination

    Request Example​

    GET /v5/pre-upgrade/asset/delivery-record?category=option HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686809005774
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "21%3A0%2C21%3A0",
            "category": "option",
            "list": [
                {
                    "symbol": "ETH-14JUN23-1750-C",
                    "side": "Buy",
                    "deliveryTime": 1686729604507,
                    "strike": "1750",
                    "fee": "0",
                    "position": "0.5",
                    "deliveryPrice": "1740.25036667",
                    "deliveryRpl": "0.175"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686796328492
    }
    - + \ No newline at end of file diff --git a/v5/pre-upgrade/execution.html b/v5/pre-upgrade/execution.html index 6b6608fa6a..93d78312dc 100644 --- a/v5/pre-upgrade/execution.html +++ b/v5/pre-upgrade/execution.html @@ -4,14 +4,14 @@ Get Pre-upgrade Trade History | Bybit API Documentation - +

    Get Pre-upgrade Trade History

    Get users' execution records which occurred before you upgraded the account to a Unified account, sorted by execTime in descending order

    For now, it supports to query USDT perpetual, USDC perpetual, Inverse perpetual and futures, Option.

    tip
    • Response items will have sorting issues When 'execTime' is the same, it is recommended to sort according to execId+OrderId+leavesQty. This issue is currently being optimized and will be released. If you want to receive real-time execution information, Use the websocket stream (recommended).
    • You may have multiple executions in a single order.
    • You can query by symbol, baseCoin, orderId and orderLinkId, and if you pass multiple params, the system will process them according to this priority: orderId > orderLinkId > symbol > baseCoin.
    info

    USDC Perpeual & Option support the recent 6 months data. Please download older data via GUI

    HTTP Request​

    GET /v5/pre-upgrade/execution/list

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type linear, inverse, option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    orderIdfalsestringOrder ID
    orderLinkIdfalsestringUser customised order ID
    baseCoinfalsestringBase coin, uppercase only. Used for option
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed, the rule is endTime - startTime <= 7 days
    endTimefalseintegerThe end timestamp (ms)
    execTypefalsestringExecution type
    limitfalseintegerLimit for data size per page. [1, 100]. Default: 50
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > orderIdstringOrder ID
    > orderLinkIdstringUser customized order ID
    > sidestringSide. Buy,Sell
    > orderPricestringOrder price
    > orderQtystringOrder qty
    > leavesQtystringThe remaining qty not executed
    > orderTypestringOrder type. Market,Limit
    > stopOrderTypestringStop order type. If the order is not stop order, any type is not returned
    > execFeestringExecuted trading fee
    > execIdstringExecution ID
    > execPricestringExecution price
    > execQtystringExecution qty
    > execTypestringExecuted type
    > execValuestringExecuted order value
    > execTimestringExecuted timestamp（ms）
    > isMakerbooleanIs maker order. true: maker, false: taker
    > feeRatestringTrading fee rate
    > tradeIvstringImplied volatility
    > markIvstringImplied volatility of mark price
    > markPricestringThe mark price of the symbol when executing
    > indexPricestringThe index price of the symbol when executing
    > underlyingPricestringThe underlying price of the symbol when executing
    > blockTradeIdstringParadigm block trade ID
    > closedSizestringClosed position size
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/pre-upgrade/execution/list?category=linear&limit=1&execType=Funding&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682580752432
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "orderId": "1682553600-BTCUSDT-592334-Sell",
                    "orderLinkId": "",
                    "side": "Sell",
                    "orderPrice": "0.00",
                    "orderQty": "0.000",
                    "leavesQty": "0.000",
                    "orderType": "UNKNOWN",
                    "stopOrderType": "UNKNOWN",
                    "execFee": "0.6364003",
                    "execId": "11f1c4ed-ff20-4d73-acb7-96e43a917f25",
                    "execPrice": "28399.90",
                    "execQty": "0.011",
                    "execType": "Funding",
                    "execValue": "312.3989",
                    "execTime": "1682553600000",
                    "isMaker": false,
                    "feeRate": "0.00203714",
                    "tradeIv": "",
                    "markIv": "",
                    "markPrice": "28399.90",
                    "indexPrice": "",
                    "underlyingPrice": "",
                    "blockTradeId": "",
                    "closedSize": "0.000"
                }
            ],
            "nextPageCursor": "page_token%3D96184191%26",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1682580752717
    }
    - + \ No newline at end of file diff --git a/v5/pre-upgrade/order-list.html b/v5/pre-upgrade/order-list.html index caee8e92fe..bb36105412 100644 --- a/v5/pre-upgrade/order-list.html +++ b/v5/pre-upgrade/order-list.html @@ -4,13 +4,13 @@ Get Pre-upgrade Order History | Bybit API Documentation - +

    Get Pre-upgrade Order History

    After the account is upgraded to a Unified account, you can get the orders which occurred before the upgrade.

    info
    • can get all status in 7 days
    • can only get filled orders beyond 7 days
    • USDC Perpeual & Option support the recent 6 months data. Please download older data via GUI

    HTTP Request​

    GET /v5/pre-upgrade/order/history

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. spot, linear, inverse, option
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only.
    • If not passed, return settleCoin=USDT by default
    • To get USDC perp, please pass symbol
    baseCoinfalsestringBase coin, uppercase only. Used for option query
    orderIdfalsestringOrder ID
    orderLinkIdfalsestringUser customised order ID
    orderFilterfalsestringOrder: active order, StopOrder: conditional order
    orderStatusfalsestringOrder status. Not supported for spot category
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime must be passed together or both are not passed
    • endTime - startTime <= 7 days
    • If both are not passed, it returns recent 7 days by default
    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
    categorystringProduct type
    listarrayObject
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    > blockTradeIdstringBlock trade ID
    > symbolstringSymbol name
    > pricestringOrder price
    > qtystringOrder qty
    > sidestringSide. Buy,Sell
    > isLeveragestringUseless field for those orders before upgraded
    > positionIdxintegerPosition index. Used to identify positions in different position modes
    > orderStatusstringOrder status
    > cancelTypestringCancel type
    > rejectReasonstringReject reason
    > avgPricestringAverage filled price. If unfilled, it is "", and also for those orders have partilly filled but cancelled at the end
    > leavesQtystringThe remaining qty not executed
    > leavesValuestringThe estimated value not executed
    > cumExecQtystringCumulative executed order qty
    > cumExecValuestringCumulative executed order value
    > cumExecFeestringCumulative executed trading fee
    > timeInForcestringTime in force
    > orderTypestringOrder type. Market,Limit
    > stopOrderTypestringStop order type
    > orderIvstringImplied volatility
    > triggerPricestringTrigger price. If stopOrderType=TrailingStop, it is activate price. Otherwise, it is trigger price
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > tpTriggerBystringThe price type to trigger take profit
    > slTriggerBystringThe price type to trigger stop loss
    > triggerDirectionintegerTrigger direction. 1: rise, 2: fall
    > triggerBystringThe price type of trigger price
    > lastPriceOnCreatedstringLast price when place the order
    > reduceOnlybooleanReduce only. true means reduce position size
    > closeOnTriggerbooleanClose on trigger. What is a close on trigger order?
    > placeTypestringPlace type, option used. iv, price
    > smpTypestringSMP execution type
    > smpGroupintegerSmp group ID. If the UID has no group, it is 0 by default
    > smpOrderIdstringThe counterparty's orderID which triggers this SMP execution
    > createdTimestringOrder created timestamp (ms)
    > updatedTimestringOrder updated timestamp (ms)
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/pre-upgrade/order/history?category=linear&limit=1&orderStatus=Filled HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682576940304
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "67836246-460e-4c52-a009-af0c3e1d12bc",
                    "orderLinkId": "",
                    "blockTradeId": "",
                    "symbol": "BTCUSDT",
                    "price": "27203.40",
                    "qty": "0.200",
                    "side": "Sell",
                    "isLeverage": "",
                    "positionIdx": 0,
                    "orderStatus": "Filled",
                    "cancelType": "UNKNOWN",
                    "rejectReason": "EC_NoError",
                    "avgPrice": "28632.126000",
                    "leavesQty": "0.000",
                    "leavesValue": "0",
                    "cumExecQty": "0.200",
                    "cumExecValue": "5726.4252",
                    "cumExecFee": "3.43585512",
                    "timeInForce": "IOC",
                    "orderType": "Market",
                    "stopOrderType": "UNKNOWN",
                    "orderIv": "",
                    "triggerPrice": "0.00",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "triggerDirection": 0,
                    "triggerBy": "UNKNOWN",
                    "lastPriceOnCreated": "0.00",
                    "reduceOnly": true,
                    "closeOnTrigger": true,
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "createdTime": "1682487465732",
                    "updatedTime": "1682487465735",
                    "placeType": ""
                }
            ],
            "nextPageCursor": "page_token%3D69406%26",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1682576940540
    }
    - + \ No newline at end of file diff --git a/v5/pre-upgrade/settlement.html b/v5/pre-upgrade/settlement.html index 05113eb6da..abef77da2b 100644 --- a/v5/pre-upgrade/settlement.html +++ b/v5/pre-upgrade/settlement.html @@ -4,13 +4,13 @@ Get Pre-upgrade USDC Session Settlement | Bybit API Documentation - +

    Get Pre-upgrade USDC Session Settlement

    Query session settlement records of USDC perpetual before you upgrade the account to Unified account.

    info

    USDC Perpeual support the recent 6 months data. Please download older data via GUI

    HTTP Request​

    GET /v5/pre-upgrade/asset/settlement-record

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear
    symbolfalsestringSymbol name, like BTCUSDT, uppercase only
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 20
    cursorfalsestringCursor. Used for pagination

    Response Parameters​

    ParameterTypeComments
    categorystringProduct type
    listarrayObject
    > symbolstringSymbol name
    > sidestringBuy,Sell
    > sizestringPosition size
    > sessionAvgPricestringSettlement price
    > markPricestringMark price
    > realisedPnlstringRealised PnL
    > createdTimestringCreated time (ms)
    nextPageCursorstringCursor. Used for pagination

    Request Example​

    GET /v5/pre-upgrade/asset/settlement-record?category=linear&symbol=ETHPERP&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686809850982
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "25%3A0%2C25%3A0",
            "category": "linear",
            "list": [
                {
                    "realisedPnl": "45.76",
                    "symbol": "ETHPERP",
                    "side": "Sell",
                    "markPrice": "1668.44",
                    "size": "-0.5",
                    "createdTime": "1686787200000",
                    "sessionAvgPrice": "1668.41"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686809851749
    }
    - + \ No newline at end of file diff --git a/v5/pre-upgrade/transaction-log.html b/v5/pre-upgrade/transaction-log.html index b0f9589b0f..febf018ba7 100644 --- a/v5/pre-upgrade/transaction-log.html +++ b/v5/pre-upgrade/transaction-log.html @@ -4,13 +4,13 @@ Get Pre-upgrade Transaction Log | Bybit API Documentation - +

    Get Pre-upgrade Transaction Log

    Query transaction logs which occurred in the USDC Derivatives wallet before the account was upgraded to a Unified account.

    You can get USDC Perpetual, Option records.

    info

    USDC Perpeual & Option support the recent 6 months data. Please download older data via GUI

    HTTP Request​

    GET /v5/pre-upgrade/account/transaction-log

    Request Parameters​

    ParameterRequiredTypeComments
    categorytruestringProduct type. linear,option
    baseCoinfalsestringBaseCoin, uppercase only. e.g., BTC of BTCPERP
    typefalsestringTypes of transaction logs
    startTimefalseintegerThe start timestamp (ms)
    • startTime and endTime are not passed, return 7 days by default
    • Only startTime is passed, return range between startTime and startTime+7 days
    • Only endTime is passed, return range between endTime-7 days and endTime
    • If both are passed, the rule is endTime - startTime <= 7 days
    endTimefalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 50]. Default: 20
    cursorfalsestringCursor. Used for pagination

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > symbolstringSymbol name
    > categorystringProduct type
    > sidestringSide. Buy,Sell,None
    > transactionTimestringTransaction timestamp (ms)
    > typestringType
    > qtystringQuantity
    > sizestringSize
    > currencystringUSDC、USDT、BTC、ETH
    > tradePricestringTrade price
    > fundingstringFunding fee
    • Positive value means receiving funding fee
    • Negative value means deducting funding fee
    > feestringTrading fee
    • Positive fee value means expense
    • Negative fee value means rebates
    > cashFlowstringCash flow
    > changestringChange
    > cashBalancestringCash balance
    > feeRatestring
    • When type=TRADE, then it is trading fee rate
    • When type=SETTLEMENT, it means funding fee rate. For side=Buy, feeRate=market fee rate; For side=Sell, feeRate= - market fee rate
    > bonusChangestringThe change of bonus
    > tradeIdstringTrade ID
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    nextPageCursorstringCursor. Used for pagination

    Request Example​

    GET /v5/pre-upgrade/account/transaction-log?category=option HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686808288265
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "21%3A0%2C21%3A0",
            "list": [
                {
                    "symbol": "ETH-14JUN23-1750-C",
                    "side": "Buy",
                    "funding": "",
                    "orderLinkId": "",
                    "orderId": "",
                    "fee": "0",
                    "change": "0",
                    "cashFlow": "0",
                    "transactionTime": "1686729604507",
                    "type": "DELIVERY",
                    "feeRate": "0",
                    "bonusChange": "",
                    "size": "0",
                    "qty": "0.5",
                    "cashBalance": "1001.1438885",
                    "currency": "USDC",
                    "category": "option",
                    "tradePrice": "1740.25036667",
                    "tradeId": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686809006792
    }
    - + \ No newline at end of file diff --git a/v5/rate-limit.html b/v5/rate-limit.html index 917c116ce5..2e5d3a55a3 100644 --- a/v5/rate-limit.html +++ b/v5/rate-limit.html @@ -4,7 +4,7 @@ Rate Limit | Bybit API Documentation - + @@ -23,8 +23,8 @@ then the request limit will consume 5.

  • If part of the last batch of orders requested within 1s exceeds the limit, the part that exceeds the limit will fail, and the part that does not exceed the limit will succeed. For example, in the 1 second, the remaining limit is 5, but a batch request containing 8 orders is placed at this time, then the first 5 orders will be successfully placed, and the 6-8th orders -will report an error exceeding the limit, and these orders will fail.

    • Classic account & UTAUTA Pro
    Level\ProductFuturesOptionSpotFuturesOptionSpot
    Default10/s10/s20/s10/s10/s20/s
    VIP 120/s20/s25/s20/s20/s25/s
    VIP 240/s40/s30/s40/s40/s30/s
    VIP 360/s60/s40/s60/s60/s40/s
    VIP 460/s60/s40/s60/s60/s40/s
    VIP 560/s60/s40/s60/s60/s40/s
    VIP Supreme60/s60/s40/s60/s60/s40/s
    PRO1100/s100/s50/s150/s150/s150/s
    PRO2150/s150/s75/s200/s200/s200/s
    PRO3200/s200/s100/s250/s250/s250/s
    PRO4200/s200/s100/s300/s300/s300/s
    PRO5200/s200/s100/s300/s300/s300/s

    How to increase API Limit​

    Please contact your client manager or email to institutional_services@bybit.com with the following information. We will reply within 1-4 working days:

    1. Your name and your company details
    2. Your Bybit UID or registered email, and the assets you are trading
    3. General description of your trading strategy and reasons for higher rate limits
    4. Screenshot of previous monthly trading volume (maker/taker) on other platforms
    5. Optional: your order history in CSV format
    - +will report an error exceeding the limit, and these orders will fail.

    Classic account & UTAUTA Pro
    Level\ProductFuturesOptionSpotFuturesOptionSpot
    Default10/s10/s20/s10/s10/s20/s
    VIP 120/s20/s25/s20/s20/s25/s
    VIP 240/s40/s30/s40/s40/s30/s
    VIP 360/s60/s40/s60/s60/s40/s
    VIP 460/s60/s40/s60/s60/s40/s
    VIP 560/s60/s40/s60/s60/s40/s
    VIP Supreme60/s60/s40/s60/s60/s40/s
    PRO1100/s100/s50/s150/s150/s150/s
    PRO2150/s150/s75/s200/s200/s200/s
    PRO3200/s200/s100/s250/s250/s250/s
    PRO4200/s200/s100/s300/s300/s300/s
    PRO5200/s200/s100/s300/s300/s300/s
    PRO6200/s200/s100/s300/s300/s300/s

    How to increase API Limit​

    Please contact your client manager or email to institutional_services@bybit.com with the following information. We will reply within 1-4 working days:

    1. Your name and your company details
    2. Your Bybit UID or registered email, and the assets you are trading
    3. General description of your trading strategy and reasons for higher rate limits
    4. Screenshot of previous monthly trading volume (maker/taker) on other platforms
    5. Optional: your order history in CSV format
    + \ No newline at end of file diff --git a/v5/smp.html b/v5/smp.html index ca2775b658..16778ad382 100644 --- a/v5/smp.html +++ b/v5/smp.html @@ -4,7 +4,7 @@ Self Match Prevention | Bybit API Documentation - + @@ -19,7 +19,7 @@ pre-existing orders to avoid an unexpected execution.

    1. The SMP Trade Group has a higher priority on SMP execution, so an individual UID is only taken into account when there is no SMP Trade Group on either side.

    2. Once the order is standing in the orderbook, its SMP flag doesn't matter any more. The system always follows the tag on the latter order.

    Examples:
    1st of Jan: UID1 joins SMP Trade Group A, and places Order1;
    2nd of Jan: UID1 is removed from SMP Trade Group A, but Order1 is still active and "New"

    • case1: If UID1 joined SMP Trade Group B, and placed Order2, if Order2 meets Order1, it will be executed since they belong to two different groups.
    • case2: If UID1 did not join any other groups after being removed from SMP Trade Group A, and placed Order2, if Order2 meets Order1, the SMP will be triggered because UID1 did not have a group when it placed Order2, so SMP was triggered at the UID level (the same UID1).

    How to manage my UIDs & SMP Trade Group?​

    You can contact your institutional business manager or email Bybit via: institutional_services@bybit.com

    Supported OpenAPI Versions and Product Lines​

    Product linesOpenAPI version supportedComments
    SpotV3 (normal account)
    V5 (unified & normal account)
    ContractContract V3 (normal account): USDT perpetual / Inverse perpetual & futures
    V5 (unified account): USDT perpetual / Inverse perpetual & futures / USDC perpetual & futures
    V5 (normal account): USDT perpetual / Inverse perpetual & futures
    OptionV5 (unified account)V1 has a default SMP at UID level
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/account-info.html b/v5/spot-margin-normal/account-info.html index 3f99bcb13d..953fe8a36f 100644 --- a/v5/spot-margin-normal/account-info.html +++ b/v5/spot-margin-normal/account-info.html @@ -4,13 +4,13 @@ Get Loan Account Info | Bybit API Documentation - +

    Get Loan Account Info

    Covers: Margin trade (Classic Account)

    HTTP Request​

    GET /v5/spot-cross-margin-trade/account

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    acctBalanceSumstringTotal equity (BTC)
    debtBalanceSumstringTotal liability (BTC)
    loanAccountListarrayObject
    > freestringAvailable balance
    > intereststringOutstanding interest
    > loanstringOutstanding principle
    > remainAmountstringRemaining debt = interest + loan
    > lockedstringLocked amount
    > tokenIdstringCoin name
    > totalstringTotal
    riskRatestringRisk rate
    statusintegerLoan account status
    • 1: normal
    • 2: withdrawal/transfer restricted
    • 3: liquidation alert triggered
    • 4: liquidated
    switchStatusinteger0: margin trade off, 1: margin trade on

    Request Example​

    GET /v5/spot-cross-margin-trade/account HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751305868
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "acctBalanceSum": "0.455189592150138021",
            "debtBalanceSum": "0",
            "loanAccountList": [
                {
                    "free": "0.01444",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "BTC",
                    "total": "0.01444"
                },
                {
                    "free": "0.21147048",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "ETH",
                    "total": "0.21147048"
                },
                {
                    "free": "7963.58978991849",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "USDT",
                    "total": "7963.58978991849"
                },
                {
                    "free": "1380.28832",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "USDC",
                    "total": "1380.28832"
                }
            ],
            "riskRate": "0",
            "status": 1,
            "switchStatus": 1
        },
        "retExtInfo": {},
        "time": 1677751306287
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/borrow-order.html b/v5/spot-margin-normal/borrow-order.html index 8657b2a4d7..4aaca56427 100644 --- a/v5/spot-margin-normal/borrow-order.html +++ b/v5/spot-margin-normal/borrow-order.html @@ -4,13 +4,13 @@ Get Borrow Order Detail | Bybit API Documentation - +

    Get Borrow Order Detail

    Covers: Margin trade (Classic Account)

    HTTP Request​

    GET /v5/spot-cross-margin-trade/orders

    Request Parameters​

    ParameterRequiredTypeComments
    startTimefalselongThe start timestamp (ms)
    endTimefalselongThe end timestamp (ms)
    coinfalsestringCoin name
    statusfalseintegerStatus
    • 0(default)：get all kinds of status
    • 1：uncleared
    • 2：cleared
    limitfalseintegerLimit for data size per page. [1, 500]. Default: 500

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > accountIdstringAccount ID
    > coinstringCoin name
    > createdTimenumberBorrow order created timestamp (ms)
    > idstringBorrow order ID
    > interestAmountstringTotal interest
    > interestBalancestringOutstanding interest
    > loanAmountstringPrincipal amount
    > loanBalancestringOutstanding principal
    > remainAmountstringRemaining debt = interestBalance + loanBalance
    > statusintegerStatus 1：uncleared, 2：cleared
    > typeintegerOrder Type 1: manual loan, 2: auto loan

    Request Example​

    GET /v5/spot-cross-margin-trade/orders?coin=ETH&limit=1&status=2 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677754328650
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "accountId": "592335",
                    "coin": "ETH",
                    "createdTime": 1677751839000,
                    "id": "21005",
                    "interestAmount": "0.0001",
                    "interestBalance": "0",
                    "loanAmount": "10",
                    "loanBalance": "0",
                    "remainAmount": "0",
                    "status": 2,
                    "type": 1
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677754329096
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/borrow.html b/v5/spot-margin-normal/borrow.html index 9cc7f5723d..a930a70aa8 100644 --- a/v5/spot-margin-normal/borrow.html +++ b/v5/spot-margin-normal/borrow.html @@ -4,13 +4,13 @@ Borrow | Bybit API Documentation - +

    Borrow

    Covers: Margin trade (Classic Account)

    HTTP Request​

    POST /v5/spot-cross-margin-trade/loan

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name
    qtytruestringAmount to borrow

    Response Parameters​

    ParameterTypeComments
    transactIdstringBorrow transaction ID

    Request Example​

    POST /v5/spot-cross-margin-trade/loan HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751838628
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 38

    {
        "coin": "ETH",
        "qty": "10"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transactId": "21005"
        },
        "retExtInfo": {},
        "time": 1677751839688
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/borrowable-data.html b/v5/spot-margin-normal/borrowable-data.html index b24436d40d..de651f382b 100644 --- a/v5/spot-margin-normal/borrowable-data.html +++ b/v5/spot-margin-normal/borrowable-data.html @@ -4,13 +4,13 @@ Get Borrowable Coin Info | Bybit API Documentation - +

    Get Borrowable Coin Info

    info

    Do not need authentication

    HTTP Request​

    GET /v5/spot-cross-margin-trade/borrow-token

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin name

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > coinstringCoin name
    > borrowingPrecisionintegerAccuracy of loan amount
    > repaymentPrecisionintegerAccuracy of repayment amount

    Request Example​

    GET /v5/spot-cross-margin-trade/borrow-token?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "borrowingPrecision": 5,
                    "coin": "ETH",
                    "repaymentPrecision": 4
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677750685331
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/interest-quota.html b/v5/spot-margin-normal/interest-quota.html index e6827fc389..358fccc9d0 100644 --- a/v5/spot-margin-normal/interest-quota.html +++ b/v5/spot-margin-normal/interest-quota.html @@ -4,13 +4,13 @@ Get Interest & Quota | Bybit API Documentation - +

    Get Interest & Quota

    Covers: Margin trade (Classic Account)

    HTTP Request​

    GET /v5/spot-cross-margin-trade/loan-info

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name

    Response Parameters​

    ParameterTypeComments
    coinstringCoin name
    interestRatestringDaily interest rate
    loanAbleAmountstringThe estimated amount can be loaned
    maxLoanAmountstringThe fixed loanable amount per user on platform

    Request Example​

    GET /v5/spot-cross-margin-trade/loan-info?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677750928871
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "ETH",
            "interestRate": "0.000054835",
            "loanAbleAmount": "19.220442066850037795",
            "maxLoanAmount": "300"
        },
        "retExtInfo": {},
        "time": 1677750929290
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/margin-data.html b/v5/spot-margin-normal/margin-data.html index ffd98301d0..6fff17ef45 100644 --- a/v5/spot-margin-normal/margin-data.html +++ b/v5/spot-margin-normal/margin-data.html @@ -4,13 +4,13 @@ Get Margin Coin Info | Bybit API Documentation - +

    Get Margin Coin Info

    info

    Do not need authentication

    HTTP Request​

    GET /v5/spot-cross-margin-trade/pledge-token

    Request Parameters​

    ParameterRequiredTypeComments
    coinfalsestringCoin name

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > coinstringCoin name
    > conversionRatestringConvert ratio
    > liquidationOrderintegerLiquidation order

    Request Example​

    GET /v5/spot-cross-margin-trade/pledge-token?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "coin": "ETH",
                    "conversionRate": "0.95",
                    "liquidationOrder": 2
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677750397414
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/repay-order.html b/v5/spot-margin-normal/repay-order.html index 1d7bf22fe9..b290445d08 100644 --- a/v5/spot-margin-normal/repay-order.html +++ b/v5/spot-margin-normal/repay-order.html @@ -4,13 +4,13 @@ Get Repayment Order Detail | Bybit API Documentation - +

    Get Repayment Order Detail

    Covers: Margin trade (Classic Account)

    HTTP Request​

    GET /v5/spot-cross-margin-trade/repay-history

    Request Parameters​

    ParameterRequiredTypeComments
    startTimefalselongThe start timestamp (ms)
    endTimefalselongThe end timestamp (ms)
    coinfalsestringCoin name
    limitfalseintegerLimit for data size per page. [1, 500], Default: 500

    Response Parameters​

    ParameterTypeComments
    listarrayObject
    > accountIdstringAccount ID
    > coinstringCoin name
    > repaidAmountstringRepaid amount
    > repayIdstringRepay ID
    > repayMarginOrderIdstringRepay margin order ID
    > repayTimestringRepay timestamp (ms)
    > transactIdsarrayObject
    >> repaidIntereststringInterest repaid
    >> repaidPrincipalstringPrincipal repaid
    >> repaidSerialNumberstringRepayment No. (Borrowing Order)
    >> transactIdstringBorrowing transaction ID

    Request Example​

    GET /v5/spot-cross-margin-trade/repay-history?coin=ETH&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1677755884678
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "accountId": "592335",
                    "coin": "ETH",
                    "repaidAmount": "10.0001",
                    "repayId": "19070",
                    "repayMarginOrderId": "1367476828218072576",
                    "repayTime": "1677751941000",
                    "transactIds": [
                        {
                            "repaidAmount": "10.0001",
                            "repaidInterest": "0.0001",
                            "repaidPrincipal": "10",
                            "repaidSerialNumber": "1367475973544746496",
                            "transactId": "21005"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677755885169
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/repay.html b/v5/spot-margin-normal/repay.html index a2c094828c..5ac3da1dcc 100644 --- a/v5/spot-margin-normal/repay.html +++ b/v5/spot-margin-normal/repay.html @@ -4,13 +4,13 @@ Repay | Bybit API Documentation - +

    Repay

    Covers: Margin trade (Classic Account)

    HTTP Request​

    POST /v5/spot-cross-margin-trade/repay

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringCoin name
    qtyfalsestringAmount to repay
    • qty is required when completeRepayment=0
    • qty is invalid when completeRepayment=1
    completeRepaymentfalseintegerWhether to pay off all debts. 0(default): false, 1: true

    Response Parameters​

    ParameterTypeComments
    repayIdstringRepayment transaction ID

    Request Example​

    POST /v5/spot-cross-margin-trade/repay HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751944347
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 66

    {
        "coin": "ETH",
        "qty": null,
        "completeRepayment": 1
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "repayId": "19070"
        },
        "retExtInfo": {},
        "time": 1677751941219
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/switch-mode.html b/v5/spot-margin-normal/switch-mode.html index 2dbc63cb1f..fda3063e79 100644 --- a/v5/spot-margin-normal/switch-mode.html +++ b/v5/spot-margin-normal/switch-mode.html @@ -4,13 +4,13 @@ Toggle Margin Trade | Bybit API Documentation - +

    Toggle Margin Trade

    Turn on / off spot margin trade

    Covers: Margin trade (Classic Account)

    HTTP Request​

    POST /v5/spot-cross-margin-trade/switch

    Request Parameters​

    ParameterRequiredTypeComments
    switchtrueinteger1: on, 0: off

    Response Parameters​

    ParameterTypeComments
    switchStatusintegerMargin trade status. 1: on, 0: off

    Request Example​

    POST /v5/spot-cross-margin-trade/switch HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677747804512
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 19

    {
        "switch": 0
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "switchStatus": 0
        },
        "retExtInfo": {},
        "time": 1677747804974
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-normal/vip-margin.html b/v5/spot-margin-normal/vip-margin.html index f54a20c41a..40dd9aa526 100644 --- a/v5/spot-margin-normal/vip-margin.html +++ b/v5/spot-margin-normal/vip-margin.html @@ -4,13 +4,13 @@ Get VIP Margin Data | Bybit API Documentation - +

    Get VIP Margin Data

    This margin data is for Classic account in particular.

    info

    Do not need authentication

    HTTP Request​

    GET /v5/spot-cross-margin-trade/data

    Request Parameters​

    ParameterRequiredTypeComments
    vipLevelfalsestringVip level
    currencyfalsestringCoin name

    Response Parameters​

    ParameterTypeComments
    vipCoinListarrayObject
    > listarrayObject
    >> borrowablebooleanWhether it is allowed to be borrowed
    >> collateralRatiostringCollateral ratio
    >> currencystringCoin name
    >> hourlyBorrowRatestringBorrow interest rate per hour
    >> liquidationOrderstringLiquidation order
    >> marginCollateralbooleanWhether it can be used as a margin collateral currency
    >> maxBorrowingAmountstringMax borrow amount
    > vipLevelstringVip level

    Request Example​

    GET /v5/spot-cross-margin-trade/data?vipLevel=No VIP&currency=BTC HTTP/1.1
    Host: api.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "vipCoinList": [
                {
                    "list": [
                        {
                            "borrowable": true,
                            "collateralRatio": "0.95",
                            "currency": "BTC",
                            "hourlyBorrowRate": "0.000003964522",
                            "liquidationOrder": "2",
                            "marginCollateral": true,
                            "maxBorrowingAmount": "5"
                        }
                    ],
                    "vipLevel": "No VIP"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1692071381663
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-uta/historical-interest.html b/v5/spot-margin-uta/historical-interest.html index 379c5b62e2..3f4f6c0c61 100644 --- a/v5/spot-margin-uta/historical-interest.html +++ b/v5/spot-margin-uta/historical-interest.html @@ -4,13 +4,13 @@ Get Historical Interest Rate | Bybit API Documentation - +

    Get Historical Interest Rate

    You can query up to six months borrowing interest rate of Margin trading.

    info
    • Need authentication, the api key needs "Spot" permission
    • Only supports Unified account
    • It is public data, i.e., different users get the same historical interest rate for the same VIP/Pro

    HTTP Request​

    GET /v5/spot-margin-trade/interest-rate-history

    Request Parameters​

    ParameterRequiredTypeComments
    currencytruestringCoin name, uppercase only
    vipLevelfalsestringVip level
  • Please note that "No VIP" should be passed like "No%20VIP" in the query string
  • If not passed, it returns your account's VIP level data
    • startTimefalseintegerThe start timestamp (ms)
  • Either both time parameters are passed or neither is passed.
  • Returns 7 days data when both are not passed
  • Supports up to 30 days interval when both are passed
    • endTimefalseintegerThe end timestamp (ms)

    Response Parameters​

    ParameterTypeComments
    listarray<object>
    > timestamplongtimestamp
    > currencystringcoin name
    > hourlyBorrowRatestringHourly borrowing rate
    > vipLevelstringVIP/Pro level

    Request Example​

    GET /v5/spot-margin-trade/interest-rate-history?currency=USDC&vipLevel=No%20VIP&startTime=1721458800000&endTime=1721469600000 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1721891663064
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "timestamp": 1721469600000,
                    "currency": "USDC",
                    "hourlyBorrowRate": "0.000014621596",
                    "vipLevel": "No VIP"
                },
                {
                    "timestamp": 1721466000000,
                    "currency": "USDC",
                    "hourlyBorrowRate": "0.000014621596",
                    "vipLevel": "No VIP"
                },
                {
                    "timestamp": 1721462400000,
                    "currency": "USDC",
                    "hourlyBorrowRate": "0.000014621596",
                    "vipLevel": "No VIP"
                },
                {
                    "timestamp": 1721458800000,
                    "currency": "USDC",
                    "hourlyBorrowRate": "0.000014621596",
                    "vipLevel": "No VIP"
                }
            ]
        },
        "retExtInfo": "{}",
        "time": 1721899048991
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-uta/set-leverage.html b/v5/spot-margin-uta/set-leverage.html index 1c7c0c5df4..0da41259b5 100644 --- a/v5/spot-margin-uta/set-leverage.html +++ b/v5/spot-margin-uta/set-leverage.html @@ -4,13 +4,13 @@ Set Leverage | Bybit API Documentation - +

    Set Leverage

    Set the user's maximum leverage in spot cross margin

    Covers: Margin trade (Unified Account)

    caution

    Your account needs to activate spot margin first; i.e., you must have finished the quiz on web / app.

    HTTP Request​

    POST /v5/spot-margin-trade/set-leverage

    Request Parameters​

    ParameterRequiredTypeComments
    leveragetruestringLeverage. [2, 10].

    Response Parameters​

    None

    Request Example​

    POST /v5/spot-margin-trade/set-leverage HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672299806626
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "leverage": "4"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1672710944282
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-uta/status.html b/v5/spot-margin-uta/status.html index 5d96dab228..b40002c861 100644 --- a/v5/spot-margin-uta/status.html +++ b/v5/spot-margin-uta/status.html @@ -4,13 +4,13 @@ Get Status And Leverage | Bybit API Documentation - +

    Get Status And Leverage

    Query the Spot margin status and leverage of Unified account

    Covers: Margin trade (Unified Account)

    HTTP Request​

    GET /v5/spot-margin-trade/state

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    spotLeveragestringSpot margin leverage. Returns "" if the margin trade is turned off
    spotMarginModestringSpot margin status. 1: on, 0: off
    effectiveLeveragestringactual leverage ratio. Precision retains 2 decimal places, truncate downwards

    Request Example​

    GET /v5/spot-margin-trade/state HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1692696840996
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "spotLeverage": "10",
            "spotMarginMode": "1",
            "effectiveLeverage": "1"
        },
        "retExtInfo": {},
        "time": 1692696841231
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-uta/switch-mode.html b/v5/spot-margin-uta/switch-mode.html index e57bf66323..79d7be5fb4 100644 --- a/v5/spot-margin-uta/switch-mode.html +++ b/v5/spot-margin-uta/switch-mode.html @@ -4,13 +4,13 @@ Toggle Margin Trade | Bybit API Documentation - +

    Toggle Margin Trade

    Turn on / off spot margin trade

    Covers: Margin trade (Unified Account)

    caution

    Your account needs to activate spot margin first; i.e., you must have finished the quiz on web / app.

    HTTP Request​

    POST /v5/spot-margin-trade/switch-mode

    Request Parameters​

    ParameterRequiredTypeComments
    spotMarginModetruestring1: on, 0: off

    Response Parameters​

    ParameterTypeComments
    spotMarginModestringSpot margin status. 1: on, 0: off

    Request Example​

    POST /v5/spot-margin-trade/switch-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672297794480
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "spotMarginMode": "0"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "spotMarginMode": "0"
        },
        "retExtInfo": {},
        "time": 1672297795542
    }
    - + \ No newline at end of file diff --git a/v5/spot-margin-uta/vip-margin.html b/v5/spot-margin-uta/vip-margin.html index 5d2ee5c9cb..df21022731 100644 --- a/v5/spot-margin-uta/vip-margin.html +++ b/v5/spot-margin-uta/vip-margin.html @@ -4,13 +4,13 @@ Get VIP Margin Data | Bybit API Documentation - +

    Get VIP Margin Data

    This margin data is for Unified account in particular.

    info

    Do not need authentication

    HTTP Request​

    GET /v5/spot-margin-trade/data

    Request Parameters​

    ParameterRequiredTypeComments
    vipLevelfalsestringVip level
    currencyfalsestringCoin name, uppercase only

    Response Parameters​

    ParameterTypeComments
    vipCoinListarrayObject
    > listarrayObject
    >> borrowablebooleanWhether it is allowed to be borrowed
    >> collateralRatiostringCollateral ratio
    >> currencystringCoin name
    >> hourlyBorrowRatestringBorrow interest rate per hour
    >> liquidationOrderstringLiquidation order
    >> marginCollateralbooleanWhether it can be used as a margin collateral currency
    >> maxBorrowingAmountstringMax borrow amount
    > vipLevelstringVip level

    Request Example​

    GET /v5/spot-margin-trade/data?vipLevel=No VIP&currency=BTC HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "vipCoinList": [
                {
                    "list": [
                        {
                            "borrowable": true,
                            "collateralRatio": "0.95",
                            "currency": "BTC",
                            "hourlyBorrowRate": "0.0000015021220000",
                            "liquidationOrder": "11",
                            "marginCollateral": true,
                            "maxBorrowingAmount": "3"
                        }
                    ],
                    "vipLevel": "No VIP"
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/v5/user/affiliate-info.html b/v5/user/affiliate-info.html index 7f37923f99..9e0861dd4c 100644 --- a/v5/user/affiliate-info.html +++ b/v5/user/affiliate-info.html @@ -4,14 +4,14 @@ Get Affiliate User Info | Bybit API Documentation - +

    Get Affiliate User Info

    To use this endpoint, you should have an affiliate account and only tick "affiliate" permission while creating the API key.
    Affiliate site: https://affiliates.bybit.com

    tip
    • Use master UID only
    • The api key can only have "Affiliate" permission
    • The transaction volume and deposit amount are the total amount of the user done on Bybit, and have nothing to do with commission settlement. Any transaction volume data related to commission settlement is subject to the Affiliate Portal.

    HTTP Request​

    GET /v5/user/aff-customer-info

    Request Parameters​

    ParameterRequiredTypeComments
    uidtruestringThe master account UID of affiliate's client

    Response Parameters​

    ParameterTypeComments
    uidstringUID
    vipLevelstringVIP level
    takerVol30DaystringTaker volume in last 30 days (USDT). All volume related attributes below includes Derivatives, Option, Spot volume
    makerVol30DaystringMaker volume in last 30 days (USDT)
    tradeVol30DaystringTotal trading volume in last 30 days (USDT)
    depositAmount30DaystringDeposit amount in last 30 days (USDT)
    takerVol365DaystringTaker volume in the past year (USDT)
    makerVol365DaystringMaker volume in the past year (USDT)
    tradeVol365DaystringTotal trading volume in the past year (USDT)
    depositAmount365DaystringTotal deposit amount in the past year (USDT)
    totalWalletBalancestringWallet balance range
    • 1: less than 100 USDT value
    • 2: [100, 250) USDT value
    • 3: [250, 500) USDT value
    • 4: greater than 500 USDT value
    depositUpdateTimestringThe update date time (UTC) of deposit data
    volUpdateTimestringThe update date of volume data time (UTC)
    KycLevelintegerKYC level. 1, 2, 0

    Request Example​

    GET /v5/user/aff-customer-info?uid=1513500 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: uQ61dcX0lSe7ygD2EA
    X-BAPI-TIMESTAMP: 1685596324209
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: xxxxxx
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "uid": "1513500",
            "takerVol30Day": "10",
            "makerVol30Day": "20",
            "tradeVol30Day": "30",
            "depositAmount30Day": "90",
            "takerVol365Day": "100",
            "makerVol365Day": "500",
            "tradeVol365Day": "600",
            "depositAmount365Day": "1300",
            "totalWalletBalance": "4",
            "depositUpdateTime": "2023-06-01 05:12:04",
            "vipLevel": "99",
            "volUpdateTime": "2023-06-02 00:00:00",
            "KycLevel": 1
        },
        "retExtInfo": {},
        "time": 1685596324508
    }
    - + \ No newline at end of file diff --git a/v5/user/apikey-info.html b/v5/user/apikey-info.html index 723e618925..c62b138ac6 100644 --- a/v5/user/apikey-info.html +++ b/v5/user/apikey-info.html @@ -4,13 +4,13 @@ Get API Key Information | Bybit API Documentation - +

    Get API Key Information

    Get the information of the api key. Use the api key pending to be checked to call the endpoint. Both master and sub user's api key are applicable.

    tip

    Any permission can access this endpoint.

    HTTP Request​

    GET /v5/user/query-api

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    idstringUnique ID. Internal use
    notestringThe remark
    apiKeystringApi key
    readOnlyinteger0：Read and Write. 1：Read only
    secretstringAlways ""
    permissionsObjectThe types of permission
    > ContractTradearrayPermission of contract trade Order, Position
    > SpotarrayPermission of spot SpotTrade
    > WalletarrayPermission of wallet AccountTransfer, SubMemberTransfer(master account), SubMemberTransferList(sub account), Withdraw(master account)
    > OptionsarrayPermission of USDC Contract. It supports trade option and USDC perpetual. OptionsTrade
    > Derivativesarray
  • Unified account has this permission by default DerivativesTrade
  • For classic account, it is always []
    • > CopyTradingarrayAlways [] as Master Trader account just use ContractTrade to start CopyTrading
    > BlockTradearrayPermission of blocktrade. Not applicable to subaccount, always []
    > ExchangearrayPermission of exchange ExchangeHistory
    > NFTarrayPermission of NFT NFTQueryProductList. Not applicable to sub account, always []
    > AffiliatearrayPermission of Affiliate. Only affiliate can have this permission, otherwise always []
    ipsarrayIP bound
    typeintegerThe type of api key. 1：personal, 2：connected to the third-party app
    deadlineDayintegerThe remaining valid days of api key. Only for those api key with no IP bound or the password has been changed
    expiredAtdatetimeThe expiry day of the api key. Only for those api key with no IP bound or the password has been changed
    createdAtdatetimeThe create day of the api key
    unifiedintegerDepreciated field
    utaintegerWhether the account to which the account upgrade to unified trade account. 0：regular account; 1：unified trade account
    userIDintegerUser ID
    inviterIDintegerInviter ID (the UID of the account which invited this account to the platform)
    vipLevelstringVIP Level
    mktMakerLevelstringMarket maker level
    affiliateIDintegerAffiliate Id. 0 represents that there is no binding relationship.
    rsaPublicKeystringRsa public key
    isMasterbooleanIf this api key belongs to master account or not
    parentUidstringThe main account uid. Returns "0" when the endpoint is called by main account
    kycLevelstringPersonal account kyc level. LEVEL_DEFAULT, LEVEL_1， LEVEL_2
    kycRegionstringPersonal account kyc region

    Request Example​

    GET /v5/user/query-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676430842094
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "id": "13770661",
            "note": "readwrite api key",
            "apiKey": "XXXXXX",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [],
                "NFT": [],
                "Affiliate": []
            },
            "ips": [
                "*"
            ],
            "type": 1,
            "deadlineDay": 66,
            "expiredAt": "2023-12-22T07:20:25Z",
            "createdAt": "2022-10-16T02:24:40Z",
            "unified": 0,
            "uta": 0,
            "userID": 24617703,
            "inviterID": 0,
            "vipLevel": "No VIP",
            "mktMakerLevel": "0",
            "affiliateID": 0,
            "rsaPublicKey": "",
            "isMaster": true,
            "parentUid": "0",
            "kycLevel": "LEVEL_DEFAULT",
            "kycRegion": ""
        },
        "retExtInfo": {},
        "time": 1697525990798
    }
    - + \ No newline at end of file diff --git a/v5/user/create-subuid-apikey.html b/v5/user/create-subuid-apikey.html index 48ebcfae0b..1dc55b3ef1 100644 --- a/v5/user/create-subuid-apikey.html +++ b/v5/user/create-subuid-apikey.html @@ -4,13 +4,13 @@ Create Sub UID API Key | Bybit API Documentation - +

    Create Sub UID API Key

    To create new API key for those newly created sub UID. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

    HTTP Request​

    POST /v5/user/create-sub-api

    Request Parameters​

    ParameterRequiredTypeComments
    subuidtrueintegerSub user Id
    notefalsestringSet a remark
    readOnlytrueinteger0：Read and Write. 1：Read only
    ipsfalsestringSet the IP bind. example: "192.168.0.1,192.168.0.2"note:
    • don't pass ips or pass with "*" means no bind
    • No ip bound api key will be invalid after 90 days
    • api key without IP bound will be invalid after 7 days once the account password is changed
    permissionstrueObjectTick the types of permission.
    • one of below types must be passed, otherwise the error is thrown
    > ContractTradefalsearrayContract Trade. ["Order","Position"]
    > SpotfalsearraySpot Trade. ["SpotTrade"]
    > WalletfalsearrayWallet. ["AccountTransfer","SubMemberTransferList"]
    > OptionsfalsearrayUSDC Contract. ["OptionsTrade"]
    > DerivativesfalsearrayThis param is depreciated because system will automatically add this permission according to your account is UTA or Classic
    > ExchangefalsearrayExchange. ["ExchangeHistory"]
    > CopyTradingfalsearrayCopytrade. ["CopyTrading"]

    Response Parameters​

    ParameterTypeComments
    idstringUnique id. Internal used
    notestringThe remark
    apiKeystringApi key
    readOnlyinteger0：Read and Write. 1：Read only
    secretstringThe secret paired with api key.
    • The secret can't be queried by GET api. Please keep it properly
    permissionsObjectThe types of permission
    > ContractTradearrayPermisson of contract trade
    > SpotarrayPermisson of spot
    > WalletarrayPermisson of wallet
    > OptionsarrayPermission of USDC Contract. It supports trade option and usdc perpetual.
    > DerivativesarrayPermission of Unified account
    > CopyTradingarrayPermission of copytrade
    > BlockTradearrayPermission of blocktrade. Not applicable to sub account, always []
    > ExchangearrayPermission of exchange
    > NFTarrayPermission of NFT. Not applicable to sub account, always []

    Request Example​

    POST /v5/user/create-sub-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430005459
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "subuid": 53888000,
        "note": "testxxx",
        "readOnly": 0,
        "permissions": {
            "Wallet": [
                "AccountTransfer"
            ]
        }
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "id": "16651283",
            "note": "testxxx",
            "apiKey": "xxxxx",
            "readOnly": 0,
            "secret": "xxxxxxxx",
            "permissions": {
                "ContractTrade": [],
                "Spot": [],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [],
                "NFT": []
            }
        },
        "retExtInfo": {},
        "time": 1676430007643
    }
    - + \ No newline at end of file diff --git a/v5/user/create-subuid.html b/v5/user/create-subuid.html index 8eddb91354..f2de8103a1 100644 --- a/v5/user/create-subuid.html +++ b/v5/user/create-subuid.html @@ -4,13 +4,13 @@ Create Sub UID | Bybit API Documentation - +

    Create Sub UID

    Create a new sub user id. Use master account's api key.

    tip

    The API key must have one of the below permissions in order to call this endpoint

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

    HTTP Request​

    POST /v5/user/create-sub-member

    Request Parameters​

    ParameterRequiredTypeComments
    usernametruestringGive a username of the new sub user id.
    • 6-16 characters, must include both numbers and letters.
    • cannot be the same as the exist or deleted one.
    passwordfalsestringSet the password for the new sub user id.
    • 8-30 characters, must include numbers, upper and lowercase letters.
    memberTypetrueinteger1: normal sub account, 6: custodial sub account
    switchfalseinteger
    • 0: turn off quick login (default)
    • 1: turn on quick login.
    isUtafalseboolean
    • true: create UTA account
    • false(default): create classic account
    notefalsestringSet a remark

    Response Parameters​

    ParameterTypeComments
    uidstringSub user Id
    usernamestringGive a username of the new sub user id.
    • 6-16 characters, must include both numbers and letters.
    • cannot be the same as the exist or deleted one.
    memberTypeinteger1: normal sub account, 6: custodial sub account
    statusintegerThe status of the user account
    • 1: normal
    • 2: login banned
    • 4: frozen
    remarkstringThe remark

    Request Example​

    POST /v5/user/create-sub-member HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXXX
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1676429344202
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "username": "xxxxx",
        "memberType": 1,
        "switch": 1,
        "note": "test"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "uid": "53888000",
            "username": "xxxxx",
            "memberType": 1,
            "status": 1,
            "remark": "test"
        },
        "retExtInfo": {},
        "time": 1676429344734
    }
    - + \ No newline at end of file diff --git a/v5/user/froze-subuid.html b/v5/user/froze-subuid.html index a0a4ce4744..cf1ec0cfe6 100644 --- a/v5/user/froze-subuid.html +++ b/v5/user/froze-subuid.html @@ -4,13 +4,13 @@ Freeze Sub UID | Bybit API Documentation - +

    Freeze Sub UID

    Freeze Sub UID. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

    HTTP Request​

    POST /v5/user/frozen-sub-member

    Request Parameters​

    ParameterRequiredTypeComments
    subuidtrueintegerSub user Id
    frozentrueinteger0：unfreeze, 1：freeze

    Response Parameters​

    None

    Request Example​

    POST /v5/user/frozen-sub-member HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430842094
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "subuid": 53888001,
        "frozen": 1
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1676430697553
    }
    - + \ No newline at end of file diff --git a/v5/user/list-sub-apikeys.html b/v5/user/list-sub-apikeys.html index eb3816ec95..e5dfa33b77 100644 --- a/v5/user/list-sub-apikeys.html +++ b/v5/user/list-sub-apikeys.html @@ -4,13 +4,13 @@ Get Sub Account All API Keys | Bybit API Documentation - +

    Get Sub Account All API Keys

    Query all api keys information of a sub UID.

    tip
    • Any permission can access this endpoint
    • Only master account can call this endpoint

    HTTP Request​

    GET /v5/user/sub-apikeys

    Request Parameters​

    ParameterRequiredTypeComments
    subMemberIdtruestringSub UID
    limitfalseintegerLimit for data size per page. [1, 20]. Default: 20
    cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    resultarrayObject
    > idstringUnique ID. Internal use
    > ipsarray<string>IP bound
    > apiKeystringApi key
    > notestringThe remark
    > statusinteger1: permanent, 2: expired, 3: within the validity period, 4: expires soon (less than 7 days)
    > expiredAtdatetimeThe expiry day of the api key. Only for those api key with no IP bound or the password has been changed
    > createdAtdatetimeThe create day of the api key
    > typeintegerThe type of api key. 1：personal, 2：connected to the third-party app
    > permissionsObjectThe types of permission
    >> ContractTradearrayPermission of contract trade Order, Position
    >> SpotarrayPermission of spot SpotTrade
    >> WalletarrayPermission of wallet AccountTransfer, SubMemberTransferList
    >> OptionsarrayPermission of USDC Contract. It supports trade option and USDC perpetual. OptionsTrade
    >> DerivativesarrayUnified account api key have this permission by default. DerivativesTrade
    >> CopyTradingarrayAlways [], Master Trader uses "Contract" permission to start Copytrading
    >> BlockTradearrayPermission of blocktrade. Not applicable to subaccount, always []
    >> ExchangearrayPermission of exchange ExchangeHistory
    >> NFTarrayPermission of NFT. Not applicable to sub account, always []
    >> AffiliatearrayPermission of Affiliate. Not applicable to sub account, always []
    > secretstringAlways "******"
    > readOnlybooleantrue, false
    > deadlineDayintegerThe remaining valid days of api key. Only for those api key with no IP bound or the password has been changed
    > flagstringApi key type
    nextPageCursorstringRefer to the cursor request parameter

    Request Example​

    GET /v5/user/sub-apikeys?subMemberId=100400345 HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1699515251088
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "result": [
                {
                    "id": "24828209",
                    "ips": [
                        "*"
                    ],
                    "apiKey": "XXXXXX",
                    "note": "UTA",
                    "status": 3,
                    "expiredAt": "2023-12-01T02:36:06Z",
                    "createdAt": "2023-08-25T06:42:39Z",
                    "type": 1,
                    "permissions": {
                        "ContractTrade": [
                            "Order",
                            "Position"
                        ],
                        "Spot": [
                            "SpotTrade"
                        ],
                        "Wallet": [
                            "AccountTransfer",
                            "SubMemberTransferList"
                        ],
                        "Options": [
                            "OptionsTrade"
                        ],
                        "Derivatives": [
                            "DerivativesTrade"
                        ],
                        "CopyTrading": [],
                        "BlockTrade": [],
                        "Exchange": [
                            "ExchangeHistory"
                        ],
                        "NFT": [],
                        "Affiliate": []
                    },
                    "secret": "******",
                    "readOnly": false,
                    "deadlineDay": 21,
                    "flag": "hmac"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1699515251698
    }
    - + \ No newline at end of file diff --git a/v5/user/modify-master-apikey.html b/v5/user/modify-master-apikey.html index 483303b9e6..2fffe1bba4 100644 --- a/v5/user/modify-master-apikey.html +++ b/v5/user/modify-master-apikey.html @@ -4,13 +4,13 @@ Modify Master API Key | Bybit API Documentation - +

    Modify Master API Key

    Modify the settings of master api key. Use the api key pending to be modified to call the endpoint. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"
    info

    Only the api key that calls this interface can be modified

    HTTP Request​

    POST /v5/user/update-api

    Request Parameters​

    ParameterRequiredTypeComments
    readOnlyfalseinteger0 (default)：Read and Write. 1：Read only
    ipsfalsestringSet the IP bind. example: "192.168.0.1,192.168.0.2"note:
    • don't pass ips or pass with "*" means no bind
    • No ip bound api key will be invalid after 90 days
    • api key will be invalid after 7 days once the account password is changed
    permissionsfalseObjectTick the types of permission. Don't send this param if you don't want to change the permission
    > ContractTradefalsearrayContract Trade. ["Order","Position"]
    > SpotfalsearraySpot Trade. ["SpotTrade"]
    > WalletfalsearrayWallet. ["AccountTransfer","SubMemberTransfer"]
    > OptionsfalsearrayUSDC Contract. ["OptionsTrade"]
    > DerivativesfalsearrayThis param is depreciated because system will automatically add this permission according to your account is UTA or Classic
    > CopyTradingfalsearrayCopytrade. ["CopyTrading"]
    > BlockTradefalsearrayBlocktrade. ["BlockTrade"]
    > ExchangefalsearrayExchange. ["ExchangeHistory"]
    > NFTfalsearrayNFT. ["NFTQueryProductList"]
    > AffiliatefalsearrayAffiliate. ["Affiliate"]
    • This permission is only useful for affiliate
    • If you need this permission, make sure you remove all other permissions

    Response Parameters​

    ParameterTypeComments
    idstringUnique id. Internal used
    notestringThe remark
    apiKeystringApi key
    readOnlyinteger0：Read and Write. 1：Read only
    secretstringAlways ""
    permissionsObjectThe types of permission
    > ContractTradearrayPermisson of contract trade
    > SpotarrayPermisson of spot
    > WalletarrayPermisson of wallet
    > OptionsarrayPermission of USDC Contract. It supports trade option and usdc perpetual.
    > DerivativesarrayPermission of Unified account
    > CopyTradingarrayPermission of copytrade. Not applicable to sub account, always []
    > BlockTradearrayPermission of blocktrade. Not applicable to sub account, always []
    > ExchangearrayPermission of exchange
    > NFTarrayPermission of NFT. Not applicable to sub account, always []
    ipsarrayIP bound

    Request Example​

    POST /v5/user/update-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676431264739
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json

    {
        "readOnly": null,
        "ips": "*",
        "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": [],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": [
                    "NFTQueryProductList"
                ]
            }
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "id": "13770661",
            "note": "xxxxx",
            "apiKey": "xxxxx",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [
                    "DerivativesTrade"
                ],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": [],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": [
                    "NFTQueryProductList"
                ]
            },
            "ips": [
                "*"
            ]
        },
        "retExtInfo": {},
        "time": 1676431265427
    }
    - + \ No newline at end of file diff --git a/v5/user/modify-sub-apikey.html b/v5/user/modify-sub-apikey.html index cf518bd908..72026eaa1f 100644 --- a/v5/user/modify-sub-apikey.html +++ b/v5/user/modify-sub-apikey.html @@ -4,14 +4,14 @@ Modify Sub API Key | Bybit API Documentation - +

    Modify Sub API Key

    Modify the settings of sub api key. Use the sub account api key pending to be modified to call the endpoint or use master account api key to manage its sub account api key.

    tip

    The API key must have one of the below permissions in order to call this endpoint

    • sub API key: "Account Transfer", "Sub Member Transfer"
    • master API Key: "Account Transfer", "Sub Member Transfer", "Withdrawal"

    HTTP Request​

    POST /v5/user/update-sub-api

    Request Parameters​

    ParameterRequiredTypeComments
    apikeyfalsestringSub account api key
    • You must pass this param when you use master account manage sub account api key settings
    • If you use corresponding sub uid api key call this endpoint, apikey param cannot be passed, otherwise throwing an error
    readOnlyfalseinteger0 (default)：Read and Write. 1：Read only
    ipsfalsestringSet the IP bind. example: "192.168.0.1,192.168.0.2"note:
    • don't pass ips or pass with "*" means no bind
    • No ip bound api key will be invalid after 90 days
    • api key will be invalid after 7 days once the account password is changed
    permissionsfalseObjectTick the types of permission. Don't send this param if you don't want to change the permission
    > ContractTradefalsearrayContract Trade. ["Order","Position"]
    > SpotfalsearraySpot Trade. ["SpotTrade"]
    > WalletfalsearrayWallet. ["AccountTransfer", "SubMemberTransferList"]
    > OptionsfalsearrayUSDC Contract. ["OptionsTrade"]
    > DerivativesfalsearrayThis param is depreciated because system will automatically add this permission according to your account is UTA or Classic
    > ExchangefalsearrayExchange. ["ExchangeHistory"]
    > CopyTradingfalsearrayCopytrade. ["CopyTrading"]

    Response Parameters​

    ParameterTypeComments
    idstringUnique id. Internal used
    notestringThe remark
    apiKeystringApi key
    readOnlyinteger0：Read and Write. 1：Read only
    secretstringAlways ""
    permissionsObjectThe types of permission
    > ContractTradearrayPermisson of contract trade
    > SpotarrayPermisson of spot
    > WalletarrayPermisson of wallet
    > OptionsarrayPermission of USDC Contract. It supports trade option and usdc perpetual.
    > DerivativesarrayPermission of Unified account
    > CopyTradingarrayPermission of copytrade
    > BlockTradearrayPermission of blocktrade. Not applicable to sub account, always []
    > ExchangearrayPermission of exchange
    > NFTarrayPermission of NFT. Not applicable to sub account, always []
    ipsarrayIP bound

    Request Example​

    POST /v5/user/update-sub-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676431795752
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "readOnly": 0,
        "ips": "*",
        "permissions": {
                "ContractTrade": [],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [],
                "NFT": []
            }
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "id": "16651472",
            "note": "testxxx",
            "apiKey": "xxxxxx",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [],
                "Derivatives": [],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [],
                "NFT": []
            },
            "ips": [
                "*"
            ]
        },
        "retExtInfo": {},
        "time": 1676431796263
    }
    - + \ No newline at end of file diff --git a/v5/user/page-subuid.html b/v5/user/page-subuid.html index 7253e6a788..6bb4553156 100644 --- a/v5/user/page-subuid.html +++ b/v5/user/page-subuid.html @@ -4,13 +4,13 @@ Get Sub UID List (Unlimited) | Bybit API Documentation - +

    Get Sub UID List (Unlimited)

    This API is applicable to the client who has over 10k sub accounts. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

    HTTP Request​

    GET /v5/user/submembers

    Request Parameters​

    ParameterRequiredTypeComments
    pageSizefalsestringData size per page. Return up to 100 records per request
    nextCursorfalsestringCursor. Use the nextCursor token from the response to retrieve the next page of the result set

    Response Parameters​

    ParameterTypeComments
    subMembersarrayObject
    > uidstringSub user Id
    > usernamestringUsername
    > memberTypeinteger1: standard sub account, 6: custodial sub account
    > statusintegerThe status of the user account
    • 1: normal
    • 2: login banned
    • 4: frozen
    > accountModeintegerThe account mode of the user account
    • 1: Classic Account
    • 3: Unified Trading Account
    > remarkstringThe remark
    nextCursorstringThe next page cursor value. "0" means no more pages

    Request Example​

    GET /v5/user/submembers?pageSize=1 HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430318405
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "subMembers": [
                {
                    "uid": "100475023",
                    "username": "BybitmcYERjAPmMU",
                    "memberType": 1,
                    "status": 1,
                    "remark": "",
                    "accountMode": 1
                }
            ],
            "nextCursor": "126671"
        },
        "retExtInfo": {},
        "time": 1711695552772
    }
    - + \ No newline at end of file diff --git a/v5/user/rm-master-apikey.html b/v5/user/rm-master-apikey.html index 6d20c0ee5c..4ba98d8bfc 100644 --- a/v5/user/rm-master-apikey.html +++ b/v5/user/rm-master-apikey.html @@ -4,13 +4,13 @@ Delete Master API Key | Bybit API Documentation - +

    Delete Master API Key

    Delete the api key of master account. Use the api key pending to be delete to call the endpoint. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"
    danger

    BE CAREFUL! The API key used to call this interface will be invalid immediately.

    HTTP Request​

    POST /v5/user/delete-api

    Request Parameters​

    None

    Response Parameters​

    None

    Request Example​

    POST /v5/user/delete-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676431576621
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json

    {

    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1676431577675
    }
    - + \ No newline at end of file diff --git a/v5/user/rm-sub-apikey.html b/v5/user/rm-sub-apikey.html index 9ba4bd33b3..cf8a46f91f 100644 --- a/v5/user/rm-sub-apikey.html +++ b/v5/user/rm-sub-apikey.html @@ -4,14 +4,14 @@ Delete Sub API Key | Bybit API Documentation - +

    Delete Sub API Key

    Delete the api key of sub account. Use the sub api key pending to be delete to call the endpoint or use the master api key to delete corresponding sub account api key

    tip

    The API key must have one of the below permissions in order to call this endpoint.

    • sub API key: "Account Transfer", "Sub Member Transfer"
    • master API Key: "Account Transfer", "Sub Member Transfer", "Withdrawal"
    danger

    BE CAREFUL! The Sub account API key will be invalid immediately after calling the endpoint.

    HTTP Request​

    POST /v5/user/delete-sub-api

    Request Parameters​

    ParameterRequiredTypeComments
    apikeyfalsestringSub account api key
    • You must pass this param when you use master account manage sub account api key settings
    • If you use corresponding sub uid api key call this endpoint, apikey param cannot be passed, otherwise throwing an error

    Response Parameters​

    None

    Request Example​

    POST /v5/user/delete-sub-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676431922953
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json

    {

    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1676431924719
    }
    - + \ No newline at end of file diff --git a/v5/user/rm-subuid.html b/v5/user/rm-subuid.html index 2868c66a28..87d1d73360 100644 --- a/v5/user/rm-subuid.html +++ b/v5/user/rm-subuid.html @@ -4,14 +4,14 @@ Delete Sub UID | Bybit API Documentation - +

    Delete Sub UID

    Delete a sub UID. Before deleting the UID, please make sure there is no asset.
    Use master user's api key**.

    tip

    The API key must have one of the below permissions in order to call this endpoint

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

    HTTP Request​

    POST /v5/user/del-submember

    Request Parameters​

    ParameterRequiredTypeComments
    subMemberIdtruestringSub UID

    Response Parameters​

    None

    Request Example​

    POST /v5/user/del-submember HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1698907012755
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json
    Content-Length: 34

    {
        "subMemberId": "112725187"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1698907012962
    }
    - + \ No newline at end of file diff --git a/v5/user/subuid-list.html b/v5/user/subuid-list.html index eaab3fc4e0..5d3d331e54 100644 --- a/v5/user/subuid-list.html +++ b/v5/user/subuid-list.html @@ -4,13 +4,13 @@ Get Sub UID List (Limited) | Bybit API Documentation - +

    Get Sub UID List (Limited)

    Get at most 10k sub UID of master account. Use master user's api key only.

    tip

    The API key must have one of the below permissions in order to call this endpoint..

    • master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"

    HTTP Request​

    GET /v5/user/query-sub-members

    Request Parameters​

    None

    Response Parameters​

    ParameterTypeComments
    subMembersarrayObject
    > uidstringSub user Id
    > usernamestringUsername
    > memberTypeinteger1: normal sub account, 6: custodial sub account
    > statusintegerThe status of the user account
    • 1: normal
    • 2: login banned
    • 4: frozen
    > accountModeintegerThe account mode of the user account
    • 1: classic account
    • 2: UMA
    • 3: UTA
    > remarkstringThe remark

    Request Example​

    GET /v5/user/query-sub-members HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430318405
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "subMembers": [
                {
                    "uid": "53888001",
                    "username": "xxx001",
                    "memberType": 1,
                    "status": 1,
                    "remark": "test",
                    "accountMode": 3
                },
                {
                    "uid": "53888002",
                    "username": "xxx002",
                    "memberType": 6,
                    "status": 1,
                    "remark": "",
                    "accountMode": 1
                }
            ]
        },
        "retExtInfo": {},
        "time": 1676430319452
    }
    - + \ No newline at end of file diff --git a/v5/user/wallet-type.html b/v5/user/wallet-type.html index 17478008ef..0416c9113a 100644 --- a/v5/user/wallet-type.html +++ b/v5/user/wallet-type.html @@ -4,13 +4,13 @@ Get UID Wallet Type | Bybit API Documentation - +

    Get UID Wallet Type

    Get available wallet types for the master account or sub account

    tip
    • Master api key: you can get master account and appointed sub account available wallet types, and support up to 200 sub UID in one request.
    • Sub api key: you can get its own available wallet types
    PRACTICE

    "FUND" - If you never deposit or transfer capital into it, this wallet type will not be shown in the array, but your account indeed has this wallet.

    • ["SPOT","OPTION","FUND","CONTRACT"] : Classic account and Funding wallet was operated before
    • ["SPOT","OPTION","CONTRACT"] : Classic account and Funding wallet is never operated
    • ["SPOT","UNIFIED","FUND","CONTRACT"] : UMA account and Funding wallet was operated before. (No UMA account after we forced upgrade to UTA)
    • ["SPOT","UNIFIED","CONTRACT"] : UMA account and Funding wallet is never operated. (No UMA account after we forced upgrade to UTA)
    • ["UNIFIED""FUND","CONTRACT"] : UTA account and Funding wallet was operated before.
    • ["UNIFIED","CONTRACT"] : UTA account and Funding wallet is never operated.

    HTTP Request​

    GET /v5/user/get-member-type

    Request Parameters​

    ParameterRequiredTypeComments
    memberIdsfalsestring
    • Query itself wallet types when not passed
    • When use master api key to query sub UID, master UID data is always returned in the top of the array
    • Multiple sub UID are supported, separated by commas
    • This param is ignored when you use sub account api key

    Response Parameters​

    ParameterTypeComments
    accountsarrayObject
    > uidstringMaster/Sub user Id
    > accountTypearrayWallets array. SPOT, CONTRACT, FUND, OPTION, UNIFIED. Please check above practice to understand the value

    Request Example​

    GET /v5/user/get-member-type HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686884973961
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "accounts": [
                {
                    "uid": "533285",
                    "accountType": [
                        "SPOT",
                        "UNIFIED",
                        "FUND",
                        "CONTRACT"
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686884974151
    }
    - + \ No newline at end of file diff --git a/v5/websocket/private/dcp.html b/v5/websocket/private/dcp.html index e9efb04ff0..13ea5a9356 100644 --- a/v5/websocket/private/dcp.html +++ b/v5/websocket/private/dcp.html @@ -4,13 +4,13 @@ Dcp | Bybit API Documentation - +

    Dcp

    Subscribe to the dcp stream to trigger DCP function.

    For example, connection A subscribes "dcp.xxx", connection B does not and connection C subscribes "dcp.xxx".

    1. If A is alive, B is dead, C is alive, then this case will not trigger DCP.
    2. If A is alive, B is dead, C is dead, then this case will not trigger DCP.
    3. If A is dead, B is alive, C is dead, then DCP is triggered when reach the timeWindow threshold

    To sum up, for those private connections subscribing "dcp" topic are all dead, then DCP will be triggered.

    Topic: dcp.future, dcp.spot, dcp.option

    Subscribe Example​

    {
        "op": "subscribe",
        "args": [
            "dcp.future"
        ]
    }
    - + \ No newline at end of file diff --git a/v5/websocket/private/execution.html b/v5/websocket/private/execution.html index 7748d8226c..bd444e83da 100644 --- a/v5/websocket/private/execution.html +++ b/v5/websocket/private/execution.html @@ -4,14 +4,14 @@ Execution | Bybit API Documentation - +

    Execution

    Subscribe to the execution stream to see your executions in real-time.

    tip

    You may have multiple executions for one order in a single message.

    All-In-One Topic: execution
    Categorised Topic: execution.spot, execution.linear, execution.inverse, execution.option

    info
    • All-In-One topic and Categorised topic cannot be in the same subscription request
    • All-In-One topic: Allow you to listen to all categories (spot, linear, inverse, option) websocket updates
    • Categorised Topic: Allow you to listen only to specific category websocket updates

    Response Parameters​

    ParameterTypeComments
    idstringMessage ID
    topicstringTopic name
    creationTimenumberData created timestamp (ms)
    dataarrayObject
    > categorystringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse.
    > symbolstringSymbol name
    > isLeveragestringWhether to borrow. Unified spot only. 0: false, 1: true. . Classic spot is not supported, always 0
    > orderIdstringOrder ID
    > orderLinkIdstringUser customized order ID
    > sidestringSide. Buy,Sell
    > orderPricestringOrder price. Classic spot is not supported
    > orderQtystringOrder qty. Classic spot is not supported
    > leavesQtystringThe remaining qty not executed. Classic spot is not supported
    > createTypestringOrder create type
  • UTA: Only for category=linear or inverse
  • Classic: always ""
  • Spot, Option do not have this key
    • > orderTypestringOrder type. Market,Limit. Classic spot is not supported
    > stopOrderTypestringStop order type. If the order is not stop order, any type is not returned. Classic spot is not supported
    > execFeestringExecuted trading fee. You can get spot fee currency instruction here Classic spot is not supported
    > execIdstringExecution ID
    > execPricestringExecution price
    > execQtystringExecution qty
    > execTypestringExecuted type. Classic spot is not supported
    > execValuestringExecuted order value. Classic spot is not supported
    > execTimestringExecuted timestamp（ms）
    > isMakerbooleanIs maker order. true: maker, false: taker
    > feeRatestringTrading fee rate. Classic spot is not supported
    > tradeIvstringImplied volatility. Valid for option
    > markIvstringImplied volatility of mark price. Valid for option
    > markPricestringThe mark price of the symbol when executing. Valid for option
    > indexPricestringThe index price of the symbol when executing. Valid for option
    > underlyingPricestringThe underlying price of the symbol when executing. Valid for option
    > blockTradeIdstringParadigm block trade ID
    > closedSizestringClosed position size
    > seqlongCross sequence, used to associate each fill and each position update
    • The seq will be the same when conclude multiple transactions at the same time
    • Different symbols may have the same seq, please use seq + symbol to check unique

    Subscribe Example​

    {
        "op": "subscribe",
        "args": [
            "execution"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.execution_stream(callback=handle_message)
    while True:
        sleep(1)

    Stream Example​

    {
        "id": "592324803b2785-26fa-4214-9963-bdd4727f07be",
        "topic": "execution",
        "creationTime": 1672364174455,
        "data": [
            {
                "category": "linear",
                "symbol": "XRPUSDT",
                "execFee": "0.005061",
                "execId": "7e2ae69c-4edf-5800-a352-893d52b446aa",
                "execPrice": "0.3374",
                "execQty": "25",
                "execType": "Trade",
                "execValue": "8.435",
                "isMaker": false,
                "feeRate": "0.0006",
                "tradeIv": "",
                "markIv": "",
                "blockTradeId": "",
                "markPrice": "0.3391",
                "indexPrice": "",
                "underlyingPrice": "",
                "leavesQty": "0",
                "orderId": "f6e324ff-99c2-4e89-9739-3086e47f9381",
                "orderLinkId": "",
                "orderPrice": "0.3207",
                "orderQty": "25",
                "orderType": "Market",
                "stopOrderType": "UNKNOWN",
                "side": "Sell",
                "execTime": "1672364174443",
                "isLeverage": "0",
                "closedSize": "",
                "seq": 4688002127
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/websocket/private/fast-execution.html b/v5/websocket/private/fast-execution.html index 94855b2e75..9af9430d86 100644 --- a/v5/websocket/private/fast-execution.html +++ b/v5/websocket/private/fast-execution.html @@ -4,7 +4,7 @@ Fast Execution | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Fast Execution

    Fast execution stream significantly reduces data latency compared original "execution" stream. However, it pushes limited execution type of trades, and fewer data fields.

    All-In-One Topic: execution.fast
    Categorised Topic: execution.fast.linear, execution.fast.inverse, execution.fast.spot

    info
    • Supports all Perps, Futures and Spot exceution, and do not support Options for now
    • You can only receive execType=Trade update

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    creationTimenumberData created timestamp (ms)
    dataarrayObject
    > categorystringProduct type
    • Unified account: linear, inverse, spot
    • Classic account: linear, inverse, spot.
    > symbolstringSymbol name
    > orderIdstringOrder ID
    > isMakerbooleantrue: Maker, false: Taker
    > orderLinkIdstringUser customized order ID
  • maker trade is always ""
  • If a maker order in the orderbook is converted to taker (by price amend), orderLinkId is also ""
    • > execIdstringExecution ID
    > execPricestringExecution price
    > execQtystringExecution qty
    > sidestringSide. Buy,Sell
    > execTimestringExecuted timestamp（ms）
    > seqlongCross sequence, used to associate each fill and each position update
    • The seq will be the same when conclude multiple transactions at the same time
    • Different symbols may have the same seq, please use seq + symbol to check unique

    Subscribe Example​

    {
        "op": "subscribe",
        "args": [
            "execution.fast"
        ]
    }

    Stream Example​

    {
        "topic": "execution.fast",
        "creationTime": 1716800399338,
        "data": [
            {
                "category": "linear",
                "symbol": "ICPUSDT",
                "execId": "3510f361-0add-5c7b-a2e7-9679810944fc",
                "execPrice": "12.015",
                "execQty": "3000",
                "orderId": "443d63fa-b4c3-4297-b7b1-23bca88b04dc",
                "isMaker": false,
                "orderLinkId": "test-00001",
                "side": "Sell",
                "execTime": "1716800399334",
                "seq": 34771365464
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/websocket/private/greek.html b/v5/websocket/private/greek.html index ccd8a8b22c..0933661538 100644 --- a/v5/websocket/private/greek.html +++ b/v5/websocket/private/greek.html @@ -4,13 +4,13 @@ Greek | Bybit API Documentation - +

    Greek

    Subscribe to the greeks stream to see changes to your greeks data in real-time. option only.

    Topic: greeks

    Response Parameters​

    ParameterTypeComments
    idstringMessage ID
    topicstringTopic name
    creationTimenumberData created timestamp (ms)
    dataarrayObject
    > baseCoinstringBase coin
    > totalDeltastringDelta value
    > totalGammastringGamma value
    > totalVegastringVega value
    > totalThetastringTheta value

    Subscribe Example​

    {
        "op": "subscribe",
        "args": [
            "greeks"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.greek_stream(callback=handle_message)
    while True:
        sleep(1)

    Stream Example​

    {
        "id": "592324fa945a30-2603-49a5-b865-21668c29f2a6",
        "topic": "greeks",
        "creationTime": 1672364262482,
        "data": [
            {
                "baseCoin": "ETH",
                "totalDelta": "0.06999986",
                "totalGamma": "-0.00000001",
                "totalVega": "-0.00000024",
                "totalTheta": "0.00001314"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/websocket/private/order.html b/v5/websocket/private/order.html index 28c624aa0f..32e6de0090 100644 --- a/v5/websocket/private/order.html +++ b/v5/websocket/private/order.html @@ -4,14 +4,14 @@ Order | Bybit API Documentation - +

    Order

    Subscribe to the order stream to see changes to your orders in real-time.

    All-In-One Topic: order
    Categorised Topic: order.spot, order.linear, order.inverse, order.option

    info
    • All-In-One topic and Categorised topic cannot be in the same subscription request
    • All-In-One topic: Allow you to listen to all categories (spot, linear, inverse, option) websocket updates
    • Categorised Topic: Allow you to listen only to specific category websocket updates

    Response Parameters​

    ParameterTypeComments
    idstringMessage ID
    topicstringTopic name
    creationTimenumberData created timestamp (ms)
    dataarrayObject
    > categorystringProduct type
    • Unified account: spot, linear, inverse, option
    • Classic account: spot, linear, inverse.
    > orderIdstringOrder ID
    > orderLinkIdstringUser customised order ID
    > isLeveragestringWhether to borrow. Unified spot only. 0: false, 1: true. . Classic spot is not supported, always 0
    > blockTradeIdstringBlock trade ID
    > symbolstringSymbol name
    > pricestringOrder price
    > qtystringOrder qty
    > sidestringSide. Buy,Sell
    > positionIdxintegerPosition index. Used to identify positions in different position modes
    > orderStatusstringOrder status
    > createTypestringOrder create type
  • Only for category=linear or inverse
  • Spot, Option do not have this key
    • > cancelTypestringCancel type
    > rejectReasonstringReject reason. Classic spot is not supported
    > avgPricestringAverage filled price
  • returns "" for those orders without avg price, and also for those classic account orders have partilly filled but cancelled at the end
  • Classic Spot: not supported, always ""
    • > leavesQtystringThe remaining qty not executed. Classic spot is not supported
    > leavesValuestringThe remaining value not executed. Classic spot is not supported
    > cumExecQtystringCumulative executed order qty
    > cumExecValuestringCumulative executed order value
    > cumExecFeestringCumulative executed trading fee.
    • Classic spot: it is the latest execution fee for order.
    • After upgraded to the Unified account, you can use execFee for each fill in Execution topic
    > feeCurrencystringTrading fee currency for Spot only. Please understand Spot trading fee currency here
    > timeInForcestringTime in force
    > orderTypestringOrder type. Market,Limit. For TP/SL order, it means the order type after triggered
    > stopOrderTypestringStop order type
    > ocoTriggerBystringThe trigger type of Spot OCO order.OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl. Classic spot is not supported
    > orderIvstringImplied volatility
    > marketUnitstringThe unit for qty when create Spot market orders for UTA account. baseCoin, quoteCoin
    > triggerPricestringTrigger price. If stopOrderType=TrailingStop, it is activate price. Otherwise, it is trigger price
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > tpslModestringTP/SL mode, Full: entire position for TP/SL. Partial: partial position tp/sl. Spot does not have this field, and Option returns always ""
    > tpLimitPricestringThe limit order price when take profit price is triggered
    > slLimitPricestringThe limit order price when stop loss price is triggered
    > tpTriggerBystringThe price type to trigger take profit
    > slTriggerBystringThe price type to trigger stop loss
    > triggerDirectionintegerTrigger direction. 1: rise, 2: fall
    > triggerBystringThe price type of trigger price
    > lastPriceOnCreatedstringLast price when place the order
    > reduceOnlybooleanReduce only. true means reduce position size
    > closeOnTriggerbooleanClose on trigger. What is a close on trigger order?
    > placeTypestringPlace type, option used. iv, price
    > smpTypestringSMP execution type
    > smpGroupintegerSmp group ID. If the UID has no group, it is 0 by default
    > smpOrderIdstringThe counterparty's orderID which triggers this SMP execution
    > createdTimestringOrder created timestamp (ms)
    > updatedTimestringOrder updated timestamp (ms)

    Subscribe Example​

    {
        "op": "subscribe",
        "args": [
            "order"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.order_stream(callback=handle_message)
    while True:
        sleep(1)

    Stream Example​

    {
        "id": "5923240c6880ab-c59f-420b-9adb-3639adc9dd90",
        "topic": "order",
        "creationTime": 1672364262474,
        "data": [
            {
                "symbol": "ETH-30DEC22-1400-C",
                "orderId": "5cf98598-39a7-459e-97bf-76ca765ee020",
                "side": "Sell",
                "orderType": "Market",
                "cancelType": "UNKNOWN",
                "price": "72.5",
                "qty": "1",
                "orderIv": "",
                "timeInForce": "IOC",
                "orderStatus": "Filled",
                "orderLinkId": "",
                "lastPriceOnCreated": "",
                "reduceOnly": false,
                "leavesQty": "",
                "leavesValue": "",
                "cumExecQty": "1",
                "cumExecValue": "75",
                "avgPrice": "75",
                "blockTradeId": "",
                "positionIdx": 0,
                "cumExecFee": "0.358635",
                "createdTime": "1672364262444",
                "updatedTime": "1672364262457",
                "rejectReason": "EC_NoError",
                "stopOrderType": "",
                "tpslMode": "",
                "triggerPrice": "",
                "takeProfit": "",
                "stopLoss": "",
                "tpTriggerBy": "",
                "slTriggerBy": "",
                "tpLimitPrice": "",
                "slLimitPrice": "",
                "triggerDirection": 0,
                "triggerBy": "",
                "closeOnTrigger": false,
                "category": "option",
                "placeType": "price",
                "smpType": "None",
                "smpGroup": 0,
                "smpOrderId": "",
                "feeCurrency": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/websocket/private/position.html b/v5/websocket/private/position.html index e4394fa203..d35024da5a 100644 --- a/v5/websocket/private/position.html +++ b/v5/websocket/private/position.html @@ -4,14 +4,14 @@ Position | Bybit API Documentation - +

    Position

    Subscribe to the position stream to see changes to your position data in real-time.

    All-In-One Topic: position
    Categorised Topic: position.linear, position.inverse, position.option

    info
    • All-In-One topic and Categorised topic cannot be in the same subscription request
    • All-In-One topic: Allow you to listen to all categories (linear, inverse, option) websocket updates
    • Categorised Topic: Allow you to listen only to specific category websocket updates

    Response Parameters​

    ParameterTypeComments
    idstringMessage ID
    topicstringTopic name
    creationTimenumberData created timestamp (ms)
    dataarrayObject
    > categorystringProduct type
    > symbolstringSymbol name
    > sidestringPosition side. Buy,Sell
    > sizestringPosition size
    > positionIdxintegerUsed to identify positions in different position modes
    > tradeModeintegerTrade mode
    • Classic & UTA (inverse): 0: cross-margin, 1: isolated margin
    • UTA: depreciated, always 0
    > positionValuestringPosition value
    > riskIdintegerRisk limit ID. Note: for portfolio margin mode, it returns 0, which the risk limit value is invalid
    > riskLimitValuestringRisk limit value corresponding to riskId. Note: for portfolio margin mode, it returns "", which the risk limit value is invalid
    > entryPricestringEntry price
    > markPricestringMark price
    > leveragestringLeverage. Note: for portfolio margin mode, it returns "", which the leverage value is invalid
    > positionBalancestringPosition margin. For portfolio margin mode, it returns ""
    > autoAddMarginintegerWhether to add margin automatically. 0: false, 1: true. For UTA, it is meaningful only when UTA enables ISOLATED_MARGIN
    > positionMMstringPosition maintenance margin. Note: for portfolio margin mode, it returns ""
    > positionIMstringPosition initial margin. Note: for portfolio margin mode, it returns ""
    > liqPricestringPosition liquidation price
    • UTA (inverse) & UTA (isolated margin enabled) & Classic account: it is the real price for isolated and cross positions, and keeps "" when liqPrice <= minPrice or liqPrice >= maxPrice
    • UTA (Cross margin mode): it is an estimated price for cross positions(because the unified mode controls the risk rate according to the account), and keeps "" when liqPrice <= minPrice or liqPrice >= maxPrice
    However, this field is empty for Portfolio Margin Mode, and no liquidation price will be provided
    > bustPricestringEst.bankruptcy price. "" for Unified trade(spot/linear/options)
    > tpslModestringDepreciated, meaningless here, always "Full". Spot does not return this field. Option returns ""
    > takeProfitstringTake profit price
    > stopLossstringStop loss price
    > trailingStopstringTrailing stop
    > unrealisedPnlstringUnrealised profit and loss
    > curRealisedPnlstringThe realised PnL for the current holding position
    > sessionAvgPricestringUSDC contract session avg price, it is the same figure as avg entry price shown in the web UI
    > deltastringDelta, unique field for option
    > gammastringGamma, unique field for option
    > vegastringVega, unique field for option
    > thetastringTheta, unique field for option
    > cumRealisedPnlstringCumulative realised pnl
    • Futures & Perp: it is the all time cumulative realised P&L
    • Option: it is the realised P&L when you hold that position
    > positionStatusstringPosition status. Normal, Liq, Adl
    > adlRankIndicatorintegerAuto-deleverage rank indicator. What is Auto-Deleveraging?
    > isReduceOnlybooleanUseful when Bybit lower the risk limit
    • true: Only allowed to reduce the position. You can consider a series of measures, e.g., lower the risk limit, decrease leverage or reduce the position, add margin, or cancel orders, after these operations, you can call confirm new risk limit endpoint to check if your position can be removed the reduceOnly mark
    • false: There is no restriction, and it means your position is under the risk when the risk limit is systematically adjusted
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > mmrSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the MMR will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the MMR had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > leverageSysUpdatedTimestringUseful when Bybit lower the risk limit
    • When isReduceOnly=true: the timestamp (ms) when the leverage will be forcibly adjusted by the system
      • When isReduceOnly=false: the timestamp when the leverage had been adjusted by system
    • It returns the timestamp when the system operates, and if you manually operate, there is no timestamp
    • Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp
    • Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
    > createdTimestringTimestamp of the first time a position was created on this symbol (ms)
    > updatedTimestringPosition data updated timestamp (ms)
    > seqlongCross sequence, used to associate each fill and each position update
    • Different symbols may have the same seq, please use seq + symbol to check unique
    • Returns "-1" if the symbol has never been traded
    • Returns the seq updated by the last transaction when there are setting like leverage, risk limit

    Subscribe Example​

    {
        "op": "subscribe",
        "args": [
            "position"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.position_stream(callback=handle_message)
    while True:
        sleep(1)

    Stream Example​

    {
        "id": "1003076014fb7eedb-c7e6-45d6-a8c1-270f0169171a",
        "topic": "position",
        "creationTime": 1697682317044,
        "data": [
            {
                "positionIdx": 2,
                "tradeMode": 0,
                "riskId": 1,
                "riskLimitValue": "2000000",
                "symbol": "BTCUSDT",
                "side": "",
                "size": "0",
                "entryPrice": "0",
                "leverage": "10",
                "positionValue": "0",
                "positionBalance": "0",
                "markPrice": "28184.5",
                "positionIM": "0",
                "positionMM": "0",
                "takeProfit": "0",
                "stopLoss": "0",
                "trailingStop": "0",
                "unrealisedPnl": "0",
                "curRealisedPnl": "1.26",
                "cumRealisedPnl": "-25.06579337",
                "sessionAvgPrice": "0",
                "createdTime": "1694402496913",
                "updatedTime": "1697682317038",
                "tpslMode": "Full",
                "liqPrice": "0",
                "bustPrice": "",
                "category": "linear",
                "positionStatus": "Normal",
                "adlRankIndicator": 0,
                "autoAddMargin": 0,
                "leverageSysUpdatedTime": "",
                "mmrSysUpdatedTime": "",
                "seq": 8327597863,
                "isReduceOnly": false
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/websocket/private/wallet.html b/v5/websocket/private/wallet.html index 0d243bf0a1..90b1bedf37 100644 --- a/v5/websocket/private/wallet.html +++ b/v5/websocket/private/wallet.html @@ -4,13 +4,13 @@ Wallet | Bybit API Documentation - +

    Wallet

    Subscribe to the wallet stream to see changes to your wallet in real-time.

    Topic: wallet

    Response Parameters​

    ParameterTypeComments
    idstringMessage ID
    topicstringTopic name
    creationTimenumberData created timestamp (ms)
    dataarrayObject
    > accountTypestringAccount type.
    • Unified account: UNIFIED (spot/linear/options), CONTRACT(inverse)
    • Classic account: CONTRACT, SPOT
    > accountLTVstringAccount LTV: account total borrowed size / (account total equity + account total borrowed size). In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > accountIMRatestringInitial Margin Rate: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > accountMMRatestringMaintenance Margin Rate: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalEquitystringEquity of account converted to usd：Account Margin Balance Base Coin + Account Option Value Base Coin. In non-unified mode & unified (inverse), the field will be returned as an empty string.
    > totalWalletBalancestringWallet Balance of account converted to usd：∑ Asset Wallet Balance By USD value of each asset。In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalMarginBalancestringMargin Balance of account converted to usd：totalWalletBalance + totalPerpUPL. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalAvailableBalancestringAvailable Balance of account converted to usd：Regular mode：totalMarginBalance - totalInitialMargin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalPerpUPLstringUnrealised P&L of Perpetuals and USDC Futures of account converted to usd：∑ Each Perp and USDC Futures upl by base coin. In non-unified mode & unified (inverse), the field will be returned as an empty string.
    > totalInitialMarginstringInitial Margin of account converted to usd：∑ Asset Total Initial Margin Base Coin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > totalMaintenanceMarginstringMaintenance Margin of account converted to usd: ∑ Asset Total Maintenance Margin Base Coin. In non-unified mode & unified (inverse) & unified (isolated_margin), the field will be returned as an empty string.
    > coinarrayObject
    >> coinstringCoin name, such as BTC, ETH, USDT, USDC
    >> equitystringEquity of current coin
    >> usdValuestringUSD value of current coin. If this coin cannot be collateral, then it is 0
    >> walletBalancestringWallet balance of current coin
    >> freestringAvailable balance for Spot wallet. This is a unique field for Classic SPOT
    >> lockedstringLocked balance due to the Spot open order
    >> spotHedgingQtystringThe spot asset qty that is used to hedge in the portfolio margin, truncate to 8 decimals and "0" by default This is a unique field for Unified account
    >> borrowAmountstringBorrow amount of current coin
    >> availableToBorrowstringDepreciated field, always return "" due to feature of main-sub UID sharing borrow quota. Please refer to availableToBorrow in the Get Collateral Info
    >> availableToWithdrawstringAvailable amount to withdraw of current coin
    >> accruedIntereststringAccrued interest
    >> totalOrderIMstringPre-occupied margin for order. For portfolio margin mode, it returns ""
    >> totalPositionIMstringSum of initial margin of all positions + Pre-occupied liquidation fee. For portfolio margin mode, it returns ""
    >> totalPositionMMstringSum of maintenance margin for all positions. For portfolio margin mode, it returns ""
    >> unrealisedPnlstringUnrealised P&L
    >> cumRealisedPnlstringCumulative Realised P&L
    >> bonusstringBonus. This is a unique field for UNIFIED account
    >> collateralSwitchbooleanWhether it can be used as a margin collateral currency (platform)
    • When marginCollateral=false, then collateralSwitch is meaningless
    • This is a unique field for UNIFIED account
    >> marginCollateralbooleanWhether the collateral is turned on by user (user)
    • When marginCollateral=true, then collateralSwitch is meaningful
    • This is a unique field for UNIFIED account

    Subscribe Example​

    {
        "op": "subscribe",
        "args": [
            "wallet"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.wallet_stream(callback=handle_message)
    while True:
        sleep(1)

    Stream Example​

    {
        "id": "592324d2bce751-ad38-48eb-8f42-4671d1fb4d4e",
        "topic": "wallet",
        "creationTime": 1700034722104,
        "data": [
            {
                "accountIMRate": "0",
                "accountMMRate": "0",
                "totalEquity": "10262.91335023",
                "totalWalletBalance": "9684.46297164",
                "totalMarginBalance": "9684.46297164",
                "totalAvailableBalance": "9556.6056555",
                "totalPerpUPL": "0",
                "totalInitialMargin": "0",
                "totalMaintenanceMargin": "0",
                "coin": [
                    {
                        "coin": "BTC",
                        "equity": "0.00102964",
                        "usdValue": "36.70759517",
                        "walletBalance": "0.00102964",
                        "availableToWithdraw": "0.00102964",
                        "availableToBorrow": "",
                        "borrowAmount": "0",
                        "accruedInterest": "0",
                        "totalOrderIM": "",
                        "totalPositionIM": "",
                        "totalPositionMM": "",
                        "unrealisedPnl": "0",
                        "cumRealisedPnl": "-0.00000973",
                        "bonus": "0",
                        "collateralSwitch": true,
                        "marginCollateral": true,
                        "locked": "0",
                        "spotHedgingQty": "0.01592413"
                    }
                ],
                "accountLTV": "0",
                "accountType": "UNIFIED"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/websocket/public/etp-kline.html b/v5/websocket/public/etp-kline.html index 9e1aa2ed16..c79a85ae2d 100644 --- a/v5/websocket/public/etp-kline.html +++ b/v5/websocket/public/etp-kline.html @@ -4,14 +4,14 @@ LT Kline | Bybit API Documentation - +

    LT Kline

    Subscribe to the leveraged token kline stream.

    tip

    If confirm=true, this means that the candle has closed. Otherwise, the candle is still open and updating.

    Available intervals:

    • 1 3 5 15 30 (min)
    • 60 120 240 360 720 (min)
    • D (day)
    • W (week)
    • M (month)

    Push frequency: 1-60s

    Topic:
    kline_lt.{interval}.{symbol} e.g., kline_lt.30.BTC3SUSDT

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot
    tsnumberThe timestamp (ms) that the system generates the data
    dataarrayObject
    > startnumberThe start timestamp (ms)
    > endnumberThe end timestamp (ms). It is current timestamp if it does not reach to the end time of candle
    > intervalstringKline interval
    > openstringOpen price
    > closestringClose price
    > highstringHighest price
    > lowstringLowest price
    > confirmbooleanWeather the tick is ended or not
    > timestampnumberThe timestamp (ms) of the last matched order in the candle

    Subscribe Example​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="spot",
    )
    def handle_message(message):
        print(message)
    ws.lt_kline_stream(
        interval=30,
        symbol="EOS3LUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "type": "snapshot",
        "topic": "kline_lt.5.EOS3LUSDT",
        "data": [
            {
                "start": 1672325100000,
                "end": 1672325399999,
                "interval": "5",
                "open": "0.416039541212402799",
                "close": "0.41477848043290448",
                "high": "0.416039541212402799",
                "low": "0.409734237314911206",
                "confirm": false,
                "timestamp": 1672325322393
            }
        ],
        "ts": 1672325322393
    }
    - + \ No newline at end of file diff --git a/v5/websocket/public/etp-nav.html b/v5/websocket/public/etp-nav.html index 5703774363..1581d4634a 100644 --- a/v5/websocket/public/etp-nav.html +++ b/v5/websocket/public/etp-nav.html @@ -4,14 +4,14 @@ LT Nav | Bybit API Documentation - +

    LT Nav

    Subscribe to the leveraged token nav stream.

    Push frequency: 300ms

    Topic:
    lt.{symbol} e.g.,lt.BTC3SUSDT

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot
    tsnumberThe timestamp (ms) that the system generates the data
    dataarrayObject
    > timenumberThe generated timestamp of nav
    > symbolstringSymbol name
    > navstringNet asset value
    > basketPositionstringTotal position value = basket value * total circulation
    > leveragestringLeverage
    > basketLoanstringBasket loan
    > circulationstringCirculation
    > basketstringBasket

    Subscribe Example​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="spot",
    )
    def handle_message(message):
        print(message)
    ws.lt_nav_stream(
        symbol="EOS3LUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "topic": "lt.EOS3LUSDT",
        "ts": 1672325564669,
        "type": "snapshot",
        "data": {
            "symbol": "EOS3LUSDT",
            "time": 1672325564554,
            "nav": "0.413517419653406162",
            "basketPosition": "1.261060779498318641",
            "leverage": "2.656197506416192150",
            "basketLoan": "-0.684866519289629374",
            "circulation": "72767.309468460367138199",
            "basket": "91764.000000292013277472"
        }
    }
    - + \ No newline at end of file diff --git a/v5/websocket/public/etp-ticker.html b/v5/websocket/public/etp-ticker.html index 0f29ba0da5..bd788e129b 100644 --- a/v5/websocket/public/etp-ticker.html +++ b/v5/websocket/public/etp-ticker.html @@ -4,14 +4,14 @@ LT Ticker | Bybit API Documentation - +

    LT Ticker

    Subscribe to the leveraged token ticker stream.

    Push frequency: 300ms

    Topic:
    tickers_lt.{symbol} e.g.,tickers_lt.BTC3SUSDT

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot
    tsnumberThe timestamp (ms) that the system generates the data
    dataarrayObject
    > symbolstringSymbol name
    > price24hPcntstringMarket price change percentage in the past 24 hours
    > lastPricestringThe last price
    > prevPrice24hstringMarket price 24 hours ago
    > highPrice24hstringHighest price in the past 24 hours
    > lowPrice24hstringLowest price in the past 24 hours

    Subscribe Example​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="spot",
    )
    def handle_message(message):
        print(message)
    ws.lt_ticker_stream(
        symbol="EOS3LUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "topic": "tickers_lt.EOS3LUSDT",
        "ts": 1672325446847,
        "type": "snapshot",
        "data": {
            "symbol": "EOS3LUSDT",
            "lastPrice": "0.41477848043290448",
            "highPrice24h": "0.435285472510871305",
            "lowPrice24h": "0.394601507960931382",
            "prevPrice24h": "0.431502290172376349",
            "price24hPcnt": "-0.0388"
        }
    }
    - + \ No newline at end of file diff --git a/v5/websocket/public/kline.html b/v5/websocket/public/kline.html index 7d952a8d0b..91298f3c32 100644 --- a/v5/websocket/public/kline.html +++ b/v5/websocket/public/kline.html @@ -4,14 +4,14 @@ Kline | Bybit API Documentation - +

    Kline

    Subscribe to the klines stream.

    tip

    If confirm=true, this means that the candle has closed. Otherwise, the candle is still open and updating.

    Available intervals:

    • 1 3 5 15 30 (min)
    • 60 120 240 360 720 (min)
    • D (day)
    • W (week)
    • M (month)

    Push frequency: 1-60s

    Topic:
    kline.{interval}.{symbol} e.g., kline.30.BTCUSDT

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot
    tsnumberThe timestamp (ms) that the system generates the data
    dataarrayObject
    > startnumberThe start timestamp (ms)
    > endnumberThe end timestamp (ms)
    > intervalstringKline interval
    > openstringOpen price
    > closestringClose price
    > highstringHighest price
    > lowstringLowest price
    > volumestringTrade volume
    > turnoverstringTurnover
    > confirmbooleanWeather the tick is ended or not
    > timestampnumberThe timestamp (ms) of the last matched order in the candle

    Subscribe Example​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.kline_stream(
        interval=5,
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "topic": "kline.5.BTCUSDT",
        "data": [
            {
                "start": 1672324800000,
                "end": 1672325099999,
                "interval": "5",
                "open": "16649.5",
                "close": "16677",
                "high": "16677",
                "low": "16608",
                "volume": "2.081",
                "turnover": "34666.4005",
                "confirm": false,
                "timestamp": 1672324988882
            }
        ],
        "ts": 1672324988882,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/v5/websocket/public/liquidation.html b/v5/websocket/public/liquidation.html index becffb6d02..5e027e503d 100644 --- a/v5/websocket/public/liquidation.html +++ b/v5/websocket/public/liquidation.html @@ -4,14 +4,14 @@ Liquidation | Bybit API Documentation - +

    Liquidation

    Subscribe to the liquidation stream, at most one order is published per second per symbol

    Push frequency: 1s

    Topic:
    liquidation.{symbol} e.g., liquidation.BTCUSDT

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot
    tsnumberThe timestamp (ms) that the system generates the data
    dataObject
    > updateTimenumberThe updated timestamp (ms)
    > symbolstringSymbol name
    > sidestringPosition side. Buy,Sell. When you receive a Buy update, this means that a long position has been liquidated
    > sizestringExecuted size
    > pricestringBankruptcy price

    Subscribe Example​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.liquidation_stream(
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "topic": "liquidation.BTCUSDT",
        "type": "snapshot",
        "ts": 1703485237953,
        "data": {
            "updatedTime": 1703485237953,
            "symbol": "BTCUSDT",
            "side": "Sell",
            "size": "0.003",
            "price": "43511.70"
        }
    }
    - + \ No newline at end of file diff --git a/v5/websocket/public/orderbook.html b/v5/websocket/public/orderbook.html index 6b42ced1d5..e55b11362b 100644 --- a/v5/websocket/public/orderbook.html +++ b/v5/websocket/public/orderbook.html @@ -4,7 +4,7 @@ Orderbook | Bybit API Documentation - + @@ -20,7 +20,7 @@ Level 25 data, push frequency: 20ms
    Level 100 data, push frequency: 100ms

    Topic:
    orderbook.{depth}.{symbol} e.g., orderbook.1.BTCUSDT

    Process snapshot/delta​

    To process snapshot and delta messages, please follow these rules:

    Once you have subscribed successfully, you will receive a snapshot. The WebSocket will keep pushing delta messages every time the orderbook changes. If you receive a new snapshot message, you will have to reset your local orderbook. If there is a problem on Bybit's end, a snapshot will be re-sent, which is guaranteed to contain the latest data.

    To apply delta updates:

    • If you receive an amount that is 0, delete the entry
    • If you receive an amount that does not exist, insert it
    • If the entry exists, you simply update the value

    See working code examples of this logic in the FAQ.

    info

    Linear & inverse level 1 data: if 3 seconds have elapsed without a change in the orderbook, a snapshot message will be pushed again.

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot,delta
    tsnumberThe timestamp (ms) that the system generates the data
    datamapObject
    > sstringSymbol name
    > barrayBids. For snapshot stream, the element is sorted by price in descending order
    >> b[0]stringBid price
    >> b[1]stringBid size
  • The delta data has size=0, which means that all quotations for this price have been filled or cancelled
    • > aarrayAsks. For snapshot stream, the element is sorted by price in ascending order
    >> a[0]stringAsk price
    >> a[1]stringAsk size
  • The delta data has size=0, which means that all quotations for this price have been filled or cancelled
    • > uintegerUpdate ID. Is a sequence. Occasionally, you'll receive "u"=1, which is a snapshot data due to the restart of the service. So please overwrite your local orderbook
    > seqintegerCross sequence
  • You can use this field to compare different levels orderbook data, and for the smaller seq, then it means the data is generated earlier.
    • ctsnumberThe timestamp from the match engine when this orderbook data is produced. It can be correlated with T from public trade channel

    Subscribe Example​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.orderbook_stream(
        depth=50,
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "topic": "orderbook.50.BTCUSDT",
        "type": "snapshot",
        "ts": 1672304484978,
        "data": {
            "s": "BTCUSDT",
            "b": [
                ...,
                [
                    "16493.50",
                    "0.006"
                ],
                [
                    "16493.00",
                    "0.100"
                ]
            ],
            "a": [
                [
                    "16611.00",
                    "0.029"
                ],
                [
                    "16612.00",
                    "0.213"
                ],
                ...,
            ],
        "u": 18521288,
        "seq": 7961638724
        }
        "cts": 1672304484976
    }
    - + \ No newline at end of file diff --git a/v5/websocket/public/ticker.html b/v5/websocket/public/ticker.html index 6a5b2019b8..8b6dc96e51 100644 --- a/v5/websocket/public/ticker.html +++ b/v5/websocket/public/ticker.html @@ -4,14 +4,14 @@ Ticker | Bybit API Documentation - +

    Ticker

    Subscribe to the ticker stream.

    note
    • This topic utilises the snapshot field and delta field. If a response param is not found in the message, then its value has not changed.
    • Spot & Option tickers message are snapshot only

    Push frequency: Derivatives & Options - 100ms, Spot - real-time

    Topic:
    tickers.{symbol}

    Response Parameters​

    ParameterTypeComments
    topicstringTopic name
    typestringData type. snapshot,delta
    csintegerCross sequence
    tsnumberThe timestamp (ms) that the system generates the data
    dataarrayObject
    > symbolstringSymbol name
    > tickDirectionstringTick direction
    > price24hPcntstringPercentage change of market price in the last 24 hours
    > lastPricestringLast price
    > prevPrice24hstringMarket price 24 hours ago
    > highPrice24hstringThe highest price in the last 24 hours
    > lowPrice24hstringThe lowest price in the last 24 hours
    > prevPrice1hstringMarket price an hour ago
    > markPricestringMark price
    > indexPricestringIndex price
    > openIntereststringOpen interest size
    > openInterestValuestringOpen interest value
    > turnover24hstringTurnover for 24h
    > volume24hstringVolume for 24h
    > nextFundingTimestringNext funding timestamp (ms)
    > fundingRatestringFunding rate
    > bid1PricestringBest bid price
    > bid1SizestringBest bid size
    > ask1PricestringBest ask price
    > ask1SizestringBest ask size
    > deliveryTimedatetimeDelivery date time (UTC+0). Unique field for inverse futures & USDC futures
    > basisRatestringBasis rate. Unique field for inverse futures & USDC futures
    > deliveryFeeRatestringDelivery fee rate. Unique field for inverse futures & USDC futures
    > predictedDeliveryPricestringPredicated delivery price. Unique field for inverse futures & USDC futures
    > preOpenPricestringEstimated pre-market contract open price
  • The value is meaningless when entering continuous trading phase
  • USDC Futures and Inverse Futures do not have this field
    • > preQtystringEstimated pre-market contract open qty
  • The value is meaningless when entering continuous trading phase
  • USDC Futures and Inverse Futures do not have this field
    • > curPreListingPhasestringThe current pre-market contract phase
  • USDC Futures and Inverse Futures do not have this field

    • Subscribe Example​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.ticker_stream(
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "topic": "tickers.BTCUSDT",
        "type": "snapshot",
        "data": {
            "symbol": "BTCUSDT",
            "tickDirection": "PlusTick",
            "price24hPcnt": "0.017103",
            "lastPrice": "17216.00",
            "prevPrice24h": "16926.50",
            "highPrice24h": "17281.50",
            "lowPrice24h": "16915.00",
            "prevPrice1h": "17238.00",
            "markPrice": "17217.33",
            "indexPrice": "17227.36",
            "openInterest": "68744.761",
            "openInterestValue": "1183601235.91",
            "turnover24h": "1570383121.943499",
            "volume24h": "91705.276",
            "nextFundingTime": "1673280000000",
            "fundingRate": "-0.000212",
            "bid1Price": "17215.50",
            "bid1Size": "84.489",
            "ask1Price": "17216.00",
            "ask1Size": "83.020"
        },
        "cs": 24987956059,
        "ts": 1673272861686
    }
    - + \ No newline at end of file diff --git a/v5/websocket/public/trade.html b/v5/websocket/public/trade.html index 7a18303638..1129923108 100644 --- a/v5/websocket/public/trade.html +++ b/v5/websocket/public/trade.html @@ -4,7 +4,7 @@ Trade | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Trade

    Subscribe to the recent trades stream.

    After subscription, you will be pushed trade messages in real-time.

    Push frequency: real-time

    Topic:
    publicTrade.{symbol}
    Note: option uses baseCoin, e.g., publicTrade.BTC

    Response Parameters​

    ParameterTypeComments
    idstringMessage id. Unique field for option
    topicstringTopic name
    typestringData type. snapshot
    tsnumberThe timestamp (ms) that the system generates the data
    dataarrayObject. The element in the array is sort by matching time in ascending order
    > TnumberThe timestamp (ms) that the order is filled
    > sstringSymbol name
    > SstringSide of taker. Buy,Sell
    > vstringTrade size
    > pstringTrade price
    > LstringDirection of price change. Unique field for future
    > istringTrade ID
    > BTbooleanWhether it is a block trade order or not
    > mPstringMark price, unique field for option
    > iPstringIndex price, unique field for option
    > mIvstringMark iv, unique field for option
    > ivstringiv, unique field for option

    Subscribe Example​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.trade_stream(
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "topic": "publicTrade.BTCUSDT",
        "type": "snapshot",
        "ts": 1672304486868,
        "data": [
            {
                "T": 1672304486865,
                "s": "BTCUSDT",
                "S": "Buy",
                "v": "0.001",
                "p": "16578.50",
                "L": "PlusTick",
                "i": "20f43950-d8dd-5b31-9112-a178eb6023af",
                "BT": false
            }
        ]
    }
    - + \ No newline at end of file diff --git a/v5/websocket/trade/guideline.html b/v5/websocket/trade/guideline.html index 8f6aef5150..4126b428f3 100644 --- a/v5/websocket/trade/guideline.html +++ b/v5/websocket/trade/guideline.html @@ -4,7 +4,7 @@ Websocket Trade Guideline | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Websocket Trade Guideline

    URL​

    • Mainnet:
      wss://stream.bybit.com/v5/trade

    • Testnet:
      wss://stream-testnet.bybit.com/v5/trade

    Support​

    Unified Trading Account

    category=linear, spot, option

    Authentication​

    Request Parameters​

    ParameterRequiredTypeComments
    reqIdfalsestringOptional field, used to match the response
  • If not passed, this field will not be returned in response
    • optruestringOp type. auth
    argsfalsestring["api key", expiry timestamp, "signature"]. Please click here to generate signature

    Response Parameters​

    ParameterTypeComments
    reqIdstring
  • If it is passed on the request, then it is returned in the response
  • If it is not passed, then it is not returned in the response
    • retCodeinteger
  • 0: auth success
  • 20001: repeat auth
  • 10004: invalid sign
  • 10001: param error
    • retMsgstring
  • OK
  • Error message
    • opstringOp type
    connIdstringConnection id, the unique id for the connection

    Request Example​

    {
        "op": "auth",
        "args": [
            "XXXXXX",
            1711010121452,
            "ec71040eff72b163a36153d770b69d6637bcb29348fbfbb16c269a76595ececf"
        ]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "op": "auth",
        "connId": "cnt5leec0hvan15eukcg-2t"
    }

    Create/Amend/Cancel Order​

    Request Parameters​

    ParameterRequiredTypeComments
    reqIdfalsestringUsed to identify the uniqueness of the request, the response will return it when passed. The length cannot exceed 36 characters.
  • If passed, it can't be duplicated, otherwise you will get "20006"
    • headertrueobjectRequest headers
    > X-BAPI-TIMESTAMPtruestringCurrent timestamp
    > X-BAPI-RECV-WINDOWfalsestring5000(ms) by default. Request will be rejected when not satisfy this rule: Bybit_server_time - X-BAPI-RECV-WINDOW <= X-BAPI-TIMESTAMP < Bybit_server_time + 1000
    > RefererfalsestringThe referer identifier for API broker user
    optruestringOp type
  • order.create: create an order
  • order.amend: amend an order
  • order.cancel: cancel an order
    • argsfalsearray<object>Args array, support one item only for now
  • order.create: refer to create order request
  • order.amend: refer to amend order request
  • order.cancel: refer to cancel order request

    • Response Parameters​

    ParameterTypeComments
    reqIdstring
  • If it is passed on the request, then it is returned in the response
  • If it is not passed, then it is not returned in the response
    • retCodeinteger
  • 0: success
  • 10404: 1. op type is not found; 2. category is not correct/supported
  • 10429: System level frequency protection
  • 20006: reqId is duplicated
  • 10016: 1. internal server error; 2. Service is restarting
  • 10019: ws trade service is restarting, do not accept new request, but the request in the process is not affected. You can build new connection to be routed to normal service
    • retMsgstring
  • OK
  • ""
  • Error message
    • opstringOp type
    dataobjectBusiness data, keep the same as result on rest api response
  • order.create: refer to create order response
  • order.amend: refer to amend order response
  • order.cancel: refer to cancel order response
    • headerobjectHeader info
    > TraceIdstringTrace ID, used to track the trip of request
    > TimenowstringCurrent timestamp
    > X-Bapi-LimitstringThe total rate limit of the current account for this op type
    > X-Bapi-Limit-StatusstringThe remaining rate limit of the current account for this op type
    > X-Bapi-Limit-Reset-TimestampstringThe timestamp indicates when your request limit resets if you have exceeded your rate limit. Otherwise, this is just the current timestamp (it may not exactly match timeNow)
    connIdstringConnection id, the unique id for the connection
    info

    The ack of create/amend/cancel order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status

    Request Example​

    {
        "reqId": "test-005",
        "header": {
            "X-BAPI-TIMESTAMP": "1711001595207",
            "X-BAPI-RECV-WINDOW": "8000",
            "Referer": "bot-001" // for api broker
        },
        "op": "order.create",
        "args": [
            {
                "symbol": "ETHUSDT",
                "side": "Buy",
                "orderType": "Limit",
                "qty": "0.2",
                "price": "2800",
                "category": "linear",
                "timeInForce": "PostOnly"
            }
        ]
    }

    Response Example​

    {
        "reqId": "test-005",
        "retCode": 0,
        "retMsg": "OK",
        "op": "order.create",
        "data": {
            "orderId": "a4c1718e-fe53-4659-a118-1f6ecce04ad9",
            "orderLinkId": ""
        },
        "header": {
            "X-Bapi-Limit": "10",
            "X-Bapi-Limit-Status": "9",
            "X-Bapi-Limit-Reset-Timestamp": "1711001595208",
            "Traceid": "38b7977b430f9bd228f4b19724794dfd",
            "Timenow": "1711001595209"
        },
        "connId": "cnt5leec0hvan15eukcg-2v"
    }

    Ping​

    Request Parameters​

    ParameterRequiredTypeComments
    optruestringOp type. ping

    Response Parameters​

    ParameterTypeComments
    retCodeintegerResult code
    retMsgstringResult message
    opstringOp type pong
    dataarrayOne item in the array, current timestamp (string)
    connIdstringConnection id, the unique id for the connection

    Request Example​

    {
        "op": "ping"
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "op": "pong",
        "data": [
            "1711002002529"
        ],
        "connId": "cnt5leec0hvan15eukcg-2v"
    }
    - + \ No newline at end of file diff --git a/v5/ws/connect.html b/v5/ws/connect.html index 773217d343..83016eadbf 100644 --- a/v5/ws/connect.html +++ b/v5/ws/connect.html @@ -4,7 +4,7 @@ Connect | Bybit API Documentation - + @@ -22,7 +22,7 @@ wss://stream-testnet.bybit.com/v5/private

    WebSocket Order Entry:

    • Mainnet:
      wss://stream.bybit.com/v5/trade

    • Testnet:
      wss://stream-testnet.bybit.com/v5/trade

    Customise Private Connection Alive Time

    For private stream and order entry, you can customise alive duration by adding a param max_active_time, the lowest value is 30s (30 seconds), the highest value is 600s (10 minutes). You can also pass 1m, 2m etc when you try to configure by minute level. e.g., wss://stream-testnet.bybit.com/v5/private?max_active_time=1m.

    In general, if there is no "ping-pong" and no stream data sent from server end, the connection will be cut off after 10 minutes. When you have a particular need, you can configure connection alive time by max_active_time.

    Since ticker scans every 30s, so it is not fully exact, i.e., if you configure 45s, and your last update or ping-pong is occurred on 2023-08-15 17:27:23, your disconnection time maybe happened on 2023-08-15 17:28:15

    Authentication​

    info
    Public topics do not require authentication. The following section applies to private topics only.

    Apply for authentication when establishing a connection.

    Note: if you're using pybit, bybit-api, or another high-level library, you can ignore this code - as authentication is handled for you.

    {
        "req_id": "10001", // optional
        "op": "auth",
        "args": [
            "api_key",
            1662350400000, // expires; is greater than your current timestamp
            "signature"
        ]
    }
    # based on: https://github.com/bybit-exchange/pybit/blob/master/pybit/_http_manager.py

    import hmac
    import json
    import time
    import websocket

    api_key = ""
    api_secret = ""

    # Generate expires.
    expires = int((time.time() + 1) * 1000)

    # Generate signature.
    signature = str(hmac.new(
        bytes(api_secret, "utf-8"),
        bytes(f"GET/realtime{expires}", "utf-8"), digestmod="sha256"
    ).hexdigest())

    ws = websocket.WebSocketApp(
        url=url,
        ...
    )

    # Authenticate with API.
    ws.send(
        json.dumps({
            "op": "auth",
            "args": [api_key, expires, signature]
        })
    )

    Successful authentication sample response

    {
        "success": true,
        "ret_msg": "",
        "op": "auth",
        "conn_id": "cejreaspqfh3sjdnldmg-p"
    }
    note

    Example signature algorithms can be found here.

    caution

    Due to network complexity, your may get disconnected at any time. Please follow the instructions below to ensure that you receive WebSocket messages on time:

    1. Keep connection alive by sending the heartbeat packet
    2. Reconnect as soon as possible if disconnected

    IP Limits​

    • Do not frequently connect and disconnect the connection.
    • Do not build over 500 connections in 5 minutes. This is counted separately per WebSocket endpoint.

    Public channel - Args limits​

    Regardless of Perpetual, Futures, Options or Spot, for one public connection, you cannot have length of "args" array over 21,000 characters.

    • Spot can input up to 10 args for each subscription request sent to one connection
    • Options can input up to 2000 args for a single connection
    • No args limit for Futures for now

    How to Send the Heartbeat Packet​

    How to Send

    // req_id is a customised ID, which is optional
    ws.send(JSON.stringify({"req_id": "100001", "op": "ping"}));

    Pong message example of public channels

    {
        "success": true,
        "ret_msg": "pong",
        "conn_id": "0970e817-426e-429a-a679-ff7f55e0b16a",
        "op": "ping"
    }

    Pong message example of private channels

    {
        "req_id": "test",
        "op": "pong",
        "args": [
            "1675418560633"
        ],
        "conn_id": "cfcb4ocsvfriu23r3er0-1b"
    }
    caution

    To avoid network or program issues, we recommend that you send the ping heartbeat packet every 20 seconds to maintain the WebSocket connection.

    How to Subscribe to Topics​

    Understanding WebSocket Filters​

    How to subscribe with a filter

    // Subscribing level 1 orderbook
    {
        "req_id": "test", // optional
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT"
        ]
    }

    Subscribing with multiple symbols and topics is supported.

    {
        "req_id": "test", // optional
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT",
            "publicTrade.BTCUSDT",
            "orderbook.1.ETHUSDT"
        ]
    }

    Understanding WebSocket Filters: Unsubscription​

    You can dynamically subscribe and unsubscribe from topics without unsubscribing from the WebSocket like so:

    {
        "op": "unsubscribe",
        "args": [
            "publicTrade.ETHUSD"
        ],
        "req_id": "customised_id"
    }

    Understanding the Subscription Response​

    Topic subscription response message example

    {
        "success": true,
        "ret_msg": "",
        "op": "subscribe",
        "conn_id": "cejreassvfrsfvb9v1a0-2m"
    }
    - + \ No newline at end of file diff --git a/zh-TW/404.html b/zh-TW/404.html index e853f15904..33b8b7df7d 100644 --- a/zh-TW/404.html +++ b/zh-TW/404.html @@ -4,13 +4,13 @@ 找不到頁面 | Bybit API Documentation - +

    找不到頁面

    我們沒有您要找的頁面。

    請聯絡原始連結來源網站的所有者，並通知他們連結已毀損。

    - + \ No newline at end of file diff --git a/zh-TW/account-asset/all-balance.html b/zh-TW/account-asset/all-balance.html index 0051ff2277..3091e0dd9d 100644 --- a/zh-TW/account-asset/all-balance.html +++ b/zh-TW/account-asset/all-balance.html @@ -4,13 +4,13 @@ 查詢賬戶所有幣種余額 | Bybit API Documentation - +

    查詢賬戶所有幣種余額

    支持查詢母帳戶的各個帳戶類型的幣種餘額，以及母帳戶下各子帳戶的各個帳戶類型的幣種餘額。

    重要

    無法通過子賬戶api key獲取主賬戶的帳戶餘額

    HTTP 請求​

    GET /asset/v3/private/transfer/account-coins/balance/query

    請求參數​

    參數是否必須類型說明
    memberIdfalsestring用戶ID. 當使用母帳號api key查詢子帳戶的幣種餘額時，該字段必傳
    accountTypetruestring賬戶類型
    coinfalsestring幣種類型
    withBonusfalsestring是否查詢體驗金. 0(默認)：不查詢; 1：查詢

    返回參數​

    參數類型說明
    accountTypestring賬戶類型
    memberIdstring用戶ID
    balanceObject
    > coinstring幣種類型
    > walletBalancestring錢包余額
    > transferBalancestring可划余額
    > bonusstring体验金

    請求示例​

    GET /asset/v3/private/transfer/account-coins/balance/query?accountType=FUND&coin=USDT,USDC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675865289817
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "memberId": "533285",
            "accountType": "FUND",
            "balance": [
                {
                    "coin": "USDT",
                    "transferBalance": "1010",
                    "walletBalance": "1010",
                    "bonus": ""
                },
                {
                    "coin": "USDC",
                    "transferBalance": "0",
                    "walletBalance": "0",
                    "bonus": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1675865290069
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/apikey-info.html b/zh-TW/account-asset/apikey-info.html index dce5aec890..f5e1c2441b 100644 --- a/zh-TW/account-asset/apikey-info.html +++ b/zh-TW/account-asset/apikey-info.html @@ -4,13 +4,13 @@ 查詢API Key相關信息 | Bybit API Documentation - +

    查詢API Key相關信息

    獲取API key的相關信息。使用待查詢的api key調用接口。適用於母、子帳戶的api key。

    提示

    任意權限可以訪問該接口

    HTTP 請求​

    GET /user/v3/private/query-api

    請求參數​

    無

    返回參數​

    參數類型說明
    idstring唯一id. 內部使用
    notestring備註
    apiKeystringApi key
    readOnlyinteger0：可讀可寫. 1：只讀
    secretstring總是""
    permissionsObject權限類型
    > ContractTradearray合約交易的權限
    > Spotarray現貨交易的權限
    > Walletarray錢包的權限
    > OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易
    > Derivativesarray衍生品v3/v5交易的權限
    > CopyTradingarray跟單交易的權限. 子帳戶暫不支持, 總是[]
    > BlockTradearray大宗交易的權限. 子帳戶暫不支持，總是[]
    > Exchangearray兌換的權限
    > NFTarrayNFT的權限. 子帳戶暫不支持, 總是[]
    ipsarray綁定的IP
    typeintegerApi key類型. 1：個人使用, 2：綁定到第三方應用
    deadlineDayintegerAPI key失效的倒數日. 針對那些未綁定IP的api key或者修改過密碼的帳戶
    expiredAtdatetimeAPI key的過期日. 針對那些未綁定IP的api key或者修改過密碼的帳戶
    createdAtdatetimeAPI key的創建日
    unifiedintegerAPI Key所屬的帳戶是否為統一保證金帳戶. 0：普通帳戶; 1：統一保证金帳戶
    utaintegerAPI Key所屬的帳戶是否為統一交易帳戶. 0：普通帳戶; 1：統一交易账户
    userIDinteger用戶 ID
    inviterIDinteger邀請人 ID（邀請該賬號加入平台的賬號的UID）
    vipLevelstringVIP用戶等級
    mktMakerLevelstringmarket maker等級
    affiliateIDinteger代理商Id. 0: 表示無任何代理綁定關係
    rsaPublicKeystringRSA公鑰
    isMasterboolean是否為主帳戶下的api key
    parentUidstring主帳戶uid. 如果是主帳戶本身調用, 則返回"0"

    請求示例​

    GET /user/v3/private/query-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671177977555
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "id": "375764",
            "note": "ordinary",
            "apiKey": "CBIZAHQMLAPKMGUVGJ",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [
                    "DerivativesTrade"
                ],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": []
            },
            "ips": [
                "*"
            ],
            "type": 1,
            "deadlineDay": 87,
            "expiredAt": "2023-04-04T05:44:02Z",
            "createdAt": "2023-01-04T05:44:02Z",
            "unified": 0,
            "uta": 0,
            "userID": 1135134,
            "inviterID": 0,
            "vipLevel": "No VIP",
            "mktMakerLevel": "0",
            "affiliateID": 0,
            "rsaPublicKey": "",
            "isMaster": false,
            "parentUid": "24617703"
        },
        "retExtInfo": {},
        "time": 1672986764656
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/asset-info.html b/zh-TW/account-asset/asset-info.html index c61a1d3f44..feff35e6cc 100644 --- a/zh-TW/account-asset/asset-info.html +++ b/zh-TW/account-asset/asset-info.html @@ -4,13 +4,13 @@ 查詢資產信息 | Bybit API Documentation - +

    查詢資產信息

    提示

    僅能查詢到現貨帳戶的資產

    HTTP 請求​

    GET /asset/v3/private/transfer/asset-info/query

    請求參數​

    參數是否必須類型說明
    accountTypefalsestring帳戶類型. 默認是SPOT類型
    coinfalsestring幣種類型

    返回參數​

    參數類型說明
    spotObject
    > statusstring
    • 賬戶狀態: ACCOUNT_STATUS_NORMAL -- 正常
    • ACCOUNT_STATUS_UNSPECIFIED -- 不正常
    > assetsarrayObject
    >> coinstring幣種類型
    >> frozenstring掛單凍結金額
    >> freestring可用余額
    >> withdrawstring提現中金額

    請求示例​

    GET /asset/v3/private/transfer/asset-info/query?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXXXXXXX
    X-BAPI-TIMESTAMP: 1670924059987
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: XXXXXXXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "spot": {
                "status": "ACCOUNT_STATUS_NORMAL",
                "assets": [
                    {
                        "coin": "USDT",
                        "frozen": "0",
                        "free": "61.1428",
                        "withdraw": ""
                    }
                ]
            }
        },
        "retExtInfo": {},
        "time": 1670924060108
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/cancel-withdraw.html b/zh-TW/account-asset/cancel-withdraw.html index 73307a7c8f..ec748a6bea 100644 --- a/zh-TW/account-asset/cancel-withdraw.html +++ b/zh-TW/account-asset/cancel-withdraw.html @@ -4,13 +4,13 @@ 撤銷提幣 | Bybit API Documentation - +

    撤銷提幣

    撤銷提幣

    HTTP 請求​

    POST /asset/v3/private/withdraw/cancel

    請求參數​

    參數是否必須類型說明
    idtrueinteger提現ID。 (提現API響應參數中的提現請求ID)

    返回參數​

    參數類型說明
    statusinteger撤銷申請結果
    • 1: 成功
    • 0: 失敗

    請求示例​

    POST /asset/v3/private/withdraw/cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671173665186
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 24

    {
        "id": 1234567890
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "status": 1
          },
        "retExtInfo": {},
        "time": 1671173665252
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/coin-balance.html b/zh-TW/account-asset/coin-balance.html index e28b5988a8..ca4ca1a295 100644 --- a/zh-TW/account-asset/coin-balance.html +++ b/zh-TW/account-asset/coin-balance.html @@ -4,14 +4,14 @@ 查詢賬戶單個幣種余額 | Bybit API Documentation - +

    查詢賬戶單個幣種余額

    支持查詢母帳戶的單個幣種餘額，以及母帳戶下各子帳戶的單個幣種餘額。 同時, 支持查詢母子帳戶、子子帳戶、子母帳戶之間的可劃轉金額，特別是針對於擁有機構借貸的用戶。

    重要

    無法通過子賬戶api key獲取主賬戶帳戶餘額

    HTTP 請求​

    GET /asset/v3/private/transfer/account-coin/balance/query

    請求參數​

    參數是否必須類型說明
    memberIdfalsestring用戶ID. 當使用母帳號api key查詢子帳戶的幣種餘額時，該字段必傳
    toMemberIdfalsestring劃入帳戶UID. 當查詢帳戶間劃轉時, 該字段必傳
    accountTypetruestring賬戶類型
    toAccountTypefalsestring劃入帳戶類型. 當查詢不同帳戶類型間的劃轉時, 該字段必傳
    cointruestring幣種類型
    withBonusfalseinteger是否查詢體驗金. 0(默認)：不查詢; 1：查詢
    withTransferSafeAmountfalseinteger是否查詢延遲提幣安全限額
    withLtvTransferSafeAmountfalseinteger特別用於機構借貸用戶, 可以查詢風險水平內的可劃轉餘額
    • 0(default)：false, 1：true
    • 此時toAccountType字段必傳

    返回參數​

    參數類型說明
    accountTypestring賬戶類型
    bizTypeinteger帳戶業務子類型
    accountIdstring賬戶ID
    memberIdstring用戶ID
    balanceObject
    > coinstring幣種類型
    > walletBalancestring錢包余額
    > transferBalancestring可划余額
    > bonusstring体验金
    > transferSafeAmountstring可劃轉的安全限額. 若不查詢，則返回""
    > ltvTransferSafeAmountstring機構借貸用戶的可劃轉餘額. 若不查詢，則返回""

    請求示例​

    GET /asset/v3/private/transfer/account-coin/balance/query?accountType=CONTRACT&coin=USDT&withTransferSafeAmount=1&withBonus=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1678794085278
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "accountType": "CONTRACT",
            "bizType": 1,
            "accountId": "533285",
            "memberId": "533285",
            "balance": {
                "coin": "USDT",
                "walletBalance": "0",
                "transferBalance": "-995.3506",
                "bonus": "995.3506",
                "transferSafeAmount": "-995.3506",
                "ltvTransferSafeAmount": ""
            }
        },
        "retExtInfo": {},
        "time": 1678794085705
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/coin-info.html b/zh-TW/account-asset/coin-info.html index aeead8e2dc..24430416e5 100644 --- a/zh-TW/account-asset/coin-info.html +++ b/zh-TW/account-asset/coin-info.html @@ -4,13 +4,13 @@ 查詢幣種信息 | Bybit API Documentation - +

    查詢幣種信息

    幣種信息查詢

    HTTP 請求​

    GET /asset/v3/private/coin-info/query

    請求參數​

    參數是否必須類型說明
    coinfalsestring幣種

    返回參數​

    參數類型說明
    rowsarrayObject
    > namestring幣種名稱
    > coinstring幣種
    > remainAmountstring該幣種當前最大可提現數量
    > chainsarrayObject
    >> chainTypestring鏈類型
    >> confirmationstring充值上賬確認數
    >> withdrawFeestring提現手續費
    • 如果提現費為空，則表示該幣不支持提現
    • 若為0, 可能該幣種手續費為百分比, 後續會增加相關字段
    >> depositMinstring最小充值數量
    >> withdrawMinstring最小提現數量
    >> chainstring鏈名
    >> chainDepositstring幣鏈是否可充值. 0：暫停; 1：正常
    >> chainWithdrawstring幣鏈是否可提幣. 0：暫停; 1：正常
    >> minAccuracystring充提幣的最小精度
    >> withdrawPercentageFeestring提現手續費百分比. 該字段的值是實際數字，即0.022表示為2.2%

    請求示例​

    GET /asset/v3/private/coin-info/query?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671172180432
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: xxxxxxxxxxx

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "rows": [
                {
                    "name": "ETH",
                    "coin": "ETH",
                    "remainAmount": "1020000",
                    "chains": [
                        {
                            "chainType": "ETH",
                            "confirmation": "10000",
                            "withdrawFee": "0.005",
                            "depositMin": "0.01",
                            "withdrawMin": "0.02",
                            "chain": "ETH",
                            "chainDeposit": "1",
                            "chainWithdraw": "1",
                            "minAccuracy": "8",
                            "withdrawPercentageFee": "0.022"
                        },
                        {
                            "chainType": "Arbitrum One",
                            "confirmation": "10",
                            "withdrawFee": "0.01",
                            "depositMin": "0.001",
                            "withdrawMin": "0.1",
                            "chain": "ARBI",
                            "chainDeposit": "1",
                            "chainWithdraw": "1",
                            "minAccuracy": "8",
                            "withdrawPercentageFee": "0"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677478088215
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/create-subuid-apikey.html b/zh-TW/account-asset/create-subuid-apikey.html index fa734ec86e..8491a3d613 100644 --- a/zh-TW/account-asset/create-subuid-apikey.html +++ b/zh-TW/account-asset/create-subuid-apikey.html @@ -4,13 +4,13 @@ 新建子帳戶的API Key | Bybit API Documentation - +

    新建子帳戶的API Key

    給新建好的子帳戶創建新的API key。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /user/v3/private/create-sub-api

    請求參數​

    參數是否必須類型說明
    subuidtrueinteger子帳戶userId
    notefalsestring設置備註
    readOnlytrueinteger0：可讀可寫. 1：只讀
    ipsfalsestring綁定IP. 比如: "192.168.0.1,192.168.0.2"注意:
    • 不傳參數ips 或者入参值為"*"意味著不綁定
    • 不綁定IP的api key將有90天的有效期限
    • 一旦帳戶密碼做了修改，帳戶下的非永久api key將在7天後失效
    permissionstrueObject勾選api key權限.
    • 注意: 必須傳入以下權限類型的任意一種, 否則報錯n
    > ContractTradefalsearray合約. ["Order","Position"]
    > Spotfalsearray現貨. ["SpotTrade"]
    > Walletfalsearray錢包. ["AccountTransfer","SubMemberTransferList"]
    > OptionsfalsearrayUSDC合約. ["OptionsTrade"]
    > Derivativesfalsearray統一帳戶權限. 該字段失效, 因為系統將會自動根據您的帳戶類型(經典帳戶和統一帳戶)來決定是否增加該權限
    > Exchangefalsearray兌換. ["ExchangeHistory"]

    返回參數​

    參數類型說明
    idstring唯一id. 內部使用
    notestring備註
    apiKeystringApi key
    readOnlyinteger0：可讀可寫. 1：只讀
    secretstringApi密鑰密碼.
    • 注意: Api密鑰密碼只會在這裡出現一次，除此之外沒有任何地方還可以獲取到密碼。請妥善保存。
    permissionsObject權限類型
    > ContractTradearray合約交易的權限
    > Spotarray現貨交易的權限
    > Walletarray錢包的權限
    > OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易
    > Derivativesarray統一帳戶權限
    > CopyTradingarray跟單交易的權限. 子帳戶暫不支持, 總是[]
    > BlockTradearray大宗交易的權限. 子帳戶暫不支持，總是[]
    > Exchangearray兌換的權限
    > NFTarrayNFT的權限. 子帳戶暫不支持, 總是[]

    請求示例​

    POST /user/v3/private/create-sub-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671176685767
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 796

    {
        "subuid": 1111111111,
        "note": "mytest",
        "readOnly": 1,
        "ips": "*",
        "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": [
                    "BlockTrade"
                ],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": [
                    "NFTQueryProductList"
                ]
            }
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "id": "1111111111",
            "note": "mytest",
            "apiKey": "xxxxxxxxxxxxx",
            "readOnly": 1,
            "secret": "xxxxxxxxxxxxx",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [
                    "DerivativesTrade"
                ],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": []
            }
        },
        "retExtInfo": {},
        "time": 1671176685954
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/create-subuid.html b/zh-TW/account-asset/create-subuid.html index dd7505841d..d5ee36e1fa 100644 --- a/zh-TW/account-asset/create-subuid.html +++ b/zh-TW/account-asset/create-subuid.html @@ -4,13 +4,13 @@ 新建子帳戶 | Bybit API Documentation - +

    新建子帳戶

    創建新的子帳戶。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /user/v3/private/create-sub-member

    請求參數​

    參數是否必須類型說明
    usernametruestring給新的子帳戶創建一個用戶名。
    • 6-16位字符，須同時含有數字和字母。
    • 不能與已存在或已刪除的帳戶用戶名重複。
    passwordfalsestring給新的子帳戶設置一個密碼。
    • 8-30位字符，須同時含有數字和大小寫字母。
    memberTypetrueinteger1: 普通子帳戶, 6: 託管子帳戶
    switchfalseinteger
    • 0: 關閉快捷登陸 (默認關閉)
    • 1: 打開快捷登陸.
    isUtafalseboolean
    • true: 創建統一帳戶
    • false(默認): 創建普通帳戶
    notefalsestring設置備註

    返回參數​

    參數類型說明
    uidstring子帳戶userId
    usernamestring給新的子帳戶創建一個用戶名
    • 6-16位字符，須同時含有數字和字母。
    • 不能與已存在或已刪除的帳戶用戶名重複。
    memberTypeinteger1: 普通子帳戶, 6: 託管子帳戶
    statusinteger帳戶狀態
    • 1: 正常
    • 2: 登陸封禁
    • 4: 凍結
    remarkstring設置的備註

    請求示例​

    POST /user/v3/private/create-sub-member HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671174837503
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 109

    {
        "username": "testsubaccount",
        "memberType": 1,
        "switch": 1,
        "note": "testnet subaccount"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "uid": "111111111",
            "username": "testsubaccount",
            "memberType": 1,
            "status": 1,
            "remark": "testnet subaccount"
        },
        "retExtInfo": {},
        "time": 1671174837668
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/delay-amount.html b/zh-TW/account-asset/delay-amount.html index f94b3e1cf2..0e3b4a1dea 100644 --- a/zh-TW/account-asset/delay-amount.html +++ b/zh-TW/account-asset/delay-amount.html @@ -4,13 +4,13 @@ 查詢延遲提幣凍結金額 | Bybit API Documentation - +

    查詢延遲提幣凍結金額

    信息

    如何會導致部分資金被要求延遲提幣？

    • 鏈上充值: 鏈上區塊確認數未達到風險可控程度, 部分資金被凍結一段時間, 直到解凍
    • 買幣: 若存在風險, 則一定時間內被凍結, 無法提幣

    HTTP 請求​

    GET /asset/v3/private/withdraw/withdrawable-amount

    請求參數​

    參數是否必需類型說明
    cointruestring幣種敏誠

    響應參數​

    參數類型說明
    limitAmountUsdstring延遲提幣凍結金額 (USD)
    withdrawableAmountarrayObject
    > SPOTObject現貨錢包, 若該錢包被移除, 則不會返回該對象
    >> coinstring幣種名稱
    >> withdrawableAmountstring可提現金額
    >> availableBalancestring可用餘額
    > FUNDObject資金錢包
    >> coinstring幣種名稱
    >> withdrawableAmountstring可提現金額
    >> availableBalancestring可用餘額

    請求示例​


    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "limitAmountUsd": "52853.5551",
            "withdrawableAmount": {
                "FUND": {
                    "coin": "USDT",
                    "withdrawableAmount": "11135.0596",
                    "availableBalance": "11135.0596"
                },
                "SPOT": {
                    "coin": "USDT",
                    "withdrawableAmount": "0",
                    "availableBalance": "0"
                }
            }
        },
        "retExtInfo": {},
        "time": 1677565632151
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/deposit-record.html b/zh-TW/account-asset/deposit-record.html index 45f69770d7..0cd8dc301a 100644 --- a/zh-TW/account-asset/deposit-record.html +++ b/zh-TW/account-asset/deposit-record.html @@ -4,13 +4,13 @@ 查詢充值記錄 (鏈上) | Bybit API Documentation - +

    查詢充值記錄 (鏈上)

    充值記錄查詢

    規則
  • 開始時間和截止時間差最大限制為30天
  • 支持使用母、子帳戶的api key查詢各自的入金紀錄

    • HTTP 請求​

    GET /asset/v3/private/deposit/record/query

    請求參數​

    參數是否必須類型說明
    startTimefalseinteger開始時間 (精確到毫秒)。 默認為當前時間之前30天
    endTimefalseinteger結束時間 (精確到毫秒)。 默認為當前時間
    coinfalsestring幣種名：舉例，BTC。默認全部
    cursorfalsestring游標信息：用來分頁。 默認空
    limitfalseinteger每頁條數, [1, 50] 默認為50

    返回參數​

    參數類型說明
    rowsarrayObject
    > coinstring充值的幣種
    > chainstring鏈名
    > amountstring充值的數量
    > txIDstring交易ID。充值失敗/取消充值：為空
    > statusint
    • 0=未知
    • 1=待確認
    • 2=上賬中
    • 3=已完成
    • 4=充值失敗
    > toAddressstring充值的目標地址
    > tagstring充值目標地址的tag
    > depositFeestring充值手續費
    > successAtstring最後更新時間
    > confirmationsstring确认区块的数量
    > txIndexstring交易序列号
    > blockHashstring鏈上的哈希數
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制
    > depositTypeinteger入金類型. 0: 正常充值, 10: 充值觸發每日限額, 20: 異常充值
    nextPageCursorstring游標信息：用來分頁

    請求示例​

    GET /asset/v3/private/deposit/record/query?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671166430580
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "10000",
                    "txID": "1234567890",
                    "status": 3,
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "",
                    "depositFee": "",
                    "successAt": "1671018256000",
                    "confirmations": "10000",
                    "txIndex": "",
                    "blockHash": "",
                    "batchReleaseLimit": "-1"
                },
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "10000",
                    "txID": "01234567890",
                    "status": 3,
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "",
                    "depositFee": "",
                    "successAt": "1669197900000",
                    "confirmations": "10000",
                    "txIndex": "",
                    "blockHash": "",
                    "batchReleaseLimit": "-1",
                    "depositType": 0
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTAwNTYwNiwibWF4SUQiOjEwMzE1MjN9"
        },
        "retExtInfo": {},
        "time": 1671166430718
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/deposit-spec.html b/zh-TW/account-asset/deposit-spec.html index e4deb1ce26..1ff595e49a 100644 --- a/zh-TW/account-asset/deposit-spec.html +++ b/zh-TW/account-asset/deposit-spec.html @@ -4,13 +4,13 @@ 查詢充值相關的規格 | Bybit API Documentation - +

    查詢充值相關的規格

    查詢充值相關的規格信息

    Information

    是一個公共接口，無需鑒權。 coin和chain必須在輸入參數中配對出現。 否則，視為無條件查詢。

    HTTP 請求​

    GET /asset/v3/public/deposit/allowed-deposit-list/query

    請求參數​

    參數是否必須類型說明
    coinfalsestring充值幣種. coin和chain必須在輸入參數中配對出現。 否則，視為無條件查詢。
    chainfalsestring充值鏈名. coin和chain必須在輸入參數中配對出現。 否則，視為無條件查詢。
    cursorfalsestring游標信息，用來分頁
    limitfalseinteger每頁條數, [1, 50], 默認為50

    返回參數​

    參數類型說明
    configListarrayObject
    > coinstring充值的幣種
    > chainstring鏈名
    > coinShowNamestring币展名
    > chainTypestring鏈類型
    > blockConfirmNumberinteger充值上賬確認數
    > minDepositAmountstring最低充值金額
    nextPageCursorstring游標信息, 用來分頁

    請求示例​

    GET /asset/v3/public/deposit/allowed-deposit-list/query?coin=BTC&chain=BTC HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "configList": [
                {
                    "coin": "BTC",
                    "chain": "BTC",
                    "coinShowName": "BTC",
                    "chainType": "BTC",
                    "blockConfirmNumber": 10000,
                    "minDepositAmount": "0.0005"
                }
            ],
            "nextPageCursor": "eyJwYWdlIjoyLCJsaW1pdCI6MTB9"
        },
        "retExtInfo": {},
        "time": 1671165256048
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/enable-unitransfer.html b/zh-TW/account-asset/enable-unitransfer.html index 4f8bdfb40e..ec25595278 100644 --- a/zh-TW/account-asset/enable-unitransfer.html +++ b/zh-TW/account-asset/enable-unitransfer.html @@ -4,13 +4,13 @@ 配置可互相劃轉的子賬號 (廢棄) | Bybit API Documentation - +

    配置可互相劃轉的子賬號 (廢棄)

    配置可互相劃轉的子賬號列表

    信息

    無需再配置可劃轉的子帳號, 該限制已移除, 默認任意子帳號之間可以劃轉

    提示

    萬能轉賬使您可以在兩個子賬戶或者母子帳戶在各種賬戶類型(CONTRACT、SPOT等)之間劃轉。

    你需要通過這個接口來設置可互相劃轉的子賬號。如果不設置，這些子賬戶之間不能互相劃轉

    HTTP 請求​

    POST /asset/v3/private/transfer/transfer-sub-member-save

    請求參數​

    參數是否必須類型說明
    subMemberIdsfalsearray<string>逗號隔開的id列表，例："123,45,14,26,46"
    • 若不傳，則表示移除子帳戶萬能劃轉的能力

    返回參數​

    無

    請求示例​

    POST /asset/v3/private/transfer/transfer-sub-member-save HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670928736473
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 43

    {
        "subMemberIds": ["1111111","2222222"]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {},
        "retExtInfo": {},
        "time": 1670928736727
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/enum.html b/zh-TW/account-asset/enum.html index 9ebe94a4d0..87c237893d 100644 --- a/zh-TW/account-asset/enum.html +++ b/zh-TW/account-asset/enum.html @@ -4,13 +4,13 @@ 枚舉定義 | Bybit API Documentation - +

    枚舉定義

    accountType​

    • CONTRACT 合約帳戶
    • SPOT 現貨帳戶
    • INVESTMENT 理財帳戶 (相關服務已下線)
    • OPTION USDC帳戶
    • UNIFIED 統一帳戶
    • FUND 資金帳戶

    coin​

    • BTC
    • ETH
    • USDT
    • XRP
    • ...

    chain​

    • BTC
    • ETH
    • TRX
    • XLM
    • LTC
    • ...

    transferStatus​

    • SUCCESS
    • PENDING
    • FAILED

    withdrawStatus​

    • SecurityCheck
    • Pending
    • success
    • CancelByUser
    • Reject
    • Fail
    • BlockchainConfirmed
    • MoreInformationRequired
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/error.html b/zh-TW/account-asset/error.html index 7b2d2c6cef..09fa832e62 100644 --- a/zh-TW/account-asset/error.html +++ b/zh-TW/account-asset/error.html @@ -4,13 +4,13 @@ 錯誤碼 | Bybit API Documentation - +

    錯誤碼

    錯誤碼描述
    0成功
    131084UTA升級中，無法提現
    131200服務不可用
    131201業務異常
    131202用戶ID無效
    131203請求參數錯誤
    131204帳戶異常
    131205查詢劃轉失敗
    131206劃轉失敗
    131207帳戶不存在
    131208劃轉封禁
    131209查詢子帳戶關係失敗
    131210金額精度錯誤
    131211轉入賬戶類型不能作為轉出賬戶類型
    131212可用餘額不足
    131213當前劃轉能力受到LTV風險率限制
    131214劃轉ID已存在
    131215金額錯誤
    131216查詢余額錯誤
    131217風險檢查失敗
    131001服務錯誤
    131002參數錯誤
    131003內部錯誤
    131004需要KYC認證
    131085提幣金額大於可用餘額，觸發延遲提幣
    131086提幣金額超過風控限制，觸發全倉槓桿限制
    131088提幣金額超過當前KYC限額，您目前的可提限額是: %s
    131089用戶24小時內進行過銘感操作，提現被禁
    131090用戶提現封禁
    131091用戶登陸封禁，無法提幣
    131092用戶狀態異常
    131093提幣地址不在白名單內
    131094用戶ID不在白名單內
    131095提幣金額超過平台24小時限額
    131096檢查提幣金額是否滿足最小最大可提金額
    131097系統暫停提幣
    131098當前時間禁止從新地址提幣
    131099當前狀態不支持取消提幣請求
    131227子帳戶未配置萬能劃轉能力
    131228可劃轉餘額不足. 請確認延遲提幣安全限額
    131229Due to compliance requirements, the current currency is not allowed to transfer 根據合規要求, 該資產不允許劃轉
    131087請不要傳入tag/memo
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/froze-subuid.html b/zh-TW/account-asset/froze-subuid.html index 31759e36bb..07905d2f1b 100644 --- a/zh-TW/account-asset/froze-subuid.html +++ b/zh-TW/account-asset/froze-subuid.html @@ -4,13 +4,13 @@ 凍結/解凍子帳戶 | Bybit API Documentation - +

    凍結/解凍子帳戶

    凍結或解凍子帳戶。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /user/v3/private/frozen-sub-member

    請求參數​

    參數是否必須類型說明
    subuidtrueinteger子帳戶userId
    frozentrueinteger0：解凍, 1：凍結

    返回參數​

    無

    請求示例​

    POST /user/v3/private/frozen-sub-member HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671177689823
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 42

    {
        "subuid": 111111111,
        "frozen": 1
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1671177689999
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/internal-deposit-record.html b/zh-TW/account-asset/internal-deposit-record.html index b85f43144c..2d646c4350 100644 --- a/zh-TW/account-asset/internal-deposit-record.html +++ b/zh-TW/account-asset/internal-deposit-record.html @@ -4,13 +4,13 @@ 查詢充值記錄 (平台转账) | Bybit API Documentation - +

    查詢充值記錄 (平台转账)

    查詢Bybit平台內部充值紀錄

    規則
  • 開始時間和截止時間差最大限制為30天
  • 支持使用母、子帳戶的api key查詢各自的入金紀錄

    • HTTP 請求​

    GET /asset/v3/private/deposit/internal-deposit-record/query

    請求參數​

    參數是否必須類型說明
    txIDfalsestring內部轉帳交易ID
    startTimefalseinteger開始時間 (精確到毫秒)。 默認為當前時間之前30天
    endTimefalseinteger結束時間 (精確到毫秒)。 默認為當前時間
    coinfalsestring幣種名：舉例，BTC。默認全部
    cursorfalsestring游標信息：用來分頁。 默認空
    limitfalseinteger每頁條數, [1, 50] 默認為50

    返回參數​

    參數類型說明
    rowsarrayObject
    > idstringID
    > typeinteger1: 內部充值
    > coinstring充值的幣種
    > amountstring充值的數量
    > txIDstring交易ID。充值失敗/取消充值：為空
    > statusinteger
    • 1=處理中
    • 2=已完成
    • 3=充值失敗
    > addressstring郵箱地址或者手機號
    > createdTimestring充值創建時間戳
    nextPageCursorstring游標信息：用來分頁

    請求示例​

    GET /asset/v3/private/deposit/internal-deposit-record/query HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1705395811647
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "id": "1103",
                    "amount": "0.1",
                    "type": 1,
                    "coin": "ETH",
                    "address": "xxxxx***@gmail.com",
                    "status": 2,
                    "createdTime": "1705393280",
                    "txID": "77c37e5c-d9fa-41e5-bd13-c9b59d95"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTEwMywibWF4SUQiOjExMDN9"
        },
        "retExtInfo": {},
        "time": 1705395814405
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/internal-transfer-list.html b/zh-TW/account-asset/internal-transfer-list.html index 0dd295ba29..dcc95d8bb8 100644 --- a/zh-TW/account-asset/internal-transfer-list.html +++ b/zh-TW/account-asset/internal-transfer-list.html @@ -4,13 +4,13 @@ 查詢劃轉記錄(單帳號內) | Bybit API Documentation - +

    查詢劃轉記錄(單帳號內)

    查詢劃轉記錄列表

    信息

    當startTime & endTime都不傳入時, API默認返回30天的數據

    HTTP 請求​

    GET /asset/v3/private/transfer/inter-transfer/list/query

    請求參數​

    參數是否必須類型說明
    transferIdtruestringUUID,全局唯一
    cointruestring幣種類型
    statusfalsestring劃轉狀態
    startTimefalseinteger開始時間戳（毫秒) 注意: 實際查詢時是秒級維度生效
    endTimefalseinteger結束時間戳（毫秒) 注意: 實際查詢時是秒級維度生效
    limitfalseinteger每頁數量限制
    cursorfalsestring游標, 用來分頁

    返回參數​

    參數類型說明
    transferIdstringUUID,全局唯一
    coinstring幣種類型
    amountstring劃轉數量
    fromAccountTypestring轉出賬戶類型
    toAccountTypestring轉入賬戶類型
    timestampstring創建時間戳 (毫秒)
    statusstring劃轉狀態
    nextPageCursorstring游標信息：用來分頁

    請求示例​

    GET /asset/v3/private/transfer/inter-transfer/list/query?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670926842754
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: xxxxxxxxxxxxxxx

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "transferId": "22b168ef-1917-4bbe-a8bd-4ea729ec5887",
                    "coin": "USDT",
                    "amount": "1",
                    "fromAccountType": "SPOT",
                    "toAccountType": "UNIFIED",
                    "timestamp": "1668749670000",
                    "status": "SUCCESS"
                },
                {
                    "transferId": "selfTransfer_4420a136-5610-44d3-97bb-a3d0551869a9",
                    "coin": "USDT",
                    "amount": "1",
                    "fromAccountType": "UNIFIED",
                    "toAccountType": "SPOT",
                    "timestamp": "1668570868000",
                    "status": "SUCCESS"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6NTYxMzUxLCJtYXhJRCI6MTU2Mzg4OX0="
        },
        "retExtInfo": {},
        "time": 1670926842908
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/internal-transfer.html b/zh-TW/account-asset/internal-transfer.html index 281acef564..2bee43b68d 100644 --- a/zh-TW/account-asset/internal-transfer.html +++ b/zh-TW/account-asset/internal-transfer.html @@ -4,13 +4,13 @@ 劃轉(單帳號內) | Bybit API Documentation - +

    劃轉(單帳號內)

    在個人賬戶的不同業務賬戶之間（而非子賬戶之間）轉移資金。 例如，在現貨和衍生品賬戶之間。

    要發送賬戶類型和父子不可知的轉賬，請使用創建萬能轉賬接口。

    提示
    • 請註意該接口入參請求數據中的transferId字段為UUID全局唯一。
    • 轉入和轉出賬戶類型不能相同。
    • 升級到統一帳戶後，僅支持從現貨帳戶轉帳USDT到統保帳戶。
    • 資金賬戶轉出目前僅支持加密貨幣，不支持法定貨幣。

    HTTP 請求​

    POST /asset/v3/private/transfer/inter-transfer

    請求參數​

    參數是否必須類型說明
    transferIdtruestringUUID,全局唯一
    cointruestring幣種類型
    amounttruestring兌入數量
    fromAccountTypetruestring賬戶類型
    toAccountTypetruestring賬戶類型

    返回參數​

    參數類型說明
    transferIdstringUUID,全局唯一
    statusstring劃轉狀態
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

    • 請求示例​

    POST /asset/v3/private/transfer/inter-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670925348932
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 164

    {
        "transferId": "42c0cfb0-6bca-c242-bc73-4e6df6cbcb06",
        "coin": "USDT",
        "amount": "10",
        "fromAccountType": "CONTRACT",
        "toAccountType": "SPOT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "42c0cfb0-6bca-c242-bc73-4e6df6cbcb06",
            "status": "SUCCESS"
        },
        "retExtInfo": {},
        "time": 1670925349100
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/master-deposit-addr.html b/zh-TW/account-asset/master-deposit-addr.html index b2fb732af8..574d5bef60 100644 --- a/zh-TW/account-asset/master-deposit-addr.html +++ b/zh-TW/account-asset/master-deposit-addr.html @@ -4,13 +4,13 @@ 查詢主帳戶充值地址信息 | Bybit API Documentation - +

    查詢主帳戶充值地址信息

    主帳戶充值地址信息查詢

    HTTP 請求​

    GET /asset/v3/private/deposit/address/query

    請求參數​

    參數是否必須類型說明
    cointruestring幣種
    chainTypefalsestring鏈. 若為空，則返回全部.
    • 注意，此處應傳鏈名，例如ETH，而不是ERC20.

    返回參數​

    參數類型說明
    coinstring幣種
    chainsarrayObject
    > chainTypestring鏈類型
    > addressDepositstring充值地址
    > tagDepositstring充值tag
    > chainstring鏈名
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制

    請求示例​

    GET /asset/v3/private/deposit/address/query?coin=USDT&chainType=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671174181320
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/x-www-form-urlencoded

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "USDT",
            "chains": [
                {
                    "chainType": "ERC20",
                    "addressDeposit": "xxxxxxxxxxx",
                    "tagDeposit": "",
                    "chain": "ETH",
                    "batchReleaseLimit": "ETH"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1671174181514
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/modify-master-apikey.html b/zh-TW/account-asset/modify-master-apikey.html index 980a048ffd..f48b154415 100644 --- a/zh-TW/account-asset/modify-master-apikey.html +++ b/zh-TW/account-asset/modify-master-apikey.html @@ -4,13 +4,13 @@ 修改母帳戶的API Key設置 | Bybit API Documentation - +

    修改母帳戶的API Key設置

    修改母帳戶API key的設置。使用待修改的api key調用接口。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"
    信息

    只能修改調用該接口的api key

    HTTP 請求​

    POST /user/v3/private/update-api

    請求參數​

    參數是否必須類型說明
    readOnlyfalseinteger0 (默認)：可讀可寫. 1：只讀
    ipsfalsearray綁定IP. 比如: "192.168.0.1,192.168.0.2"注意:
    • 不傳參數ips 或者入参值為"*"意味著不綁定
    • 不綁定IP的api key將有90天的有效期限
    • 一旦帳戶密碼做了修改，帳戶下的api key將在7天後失效
    permissionsfalseObject勾選api key權限. 如果不修改權限, 則不要傳入該參數
    > ContractTradefalsearray合約. ["Order","Position"]
    > Spotfalsearray現貨. ["SpotTrade"]
    > Walletfalsearray錢包. ["AccountTransfer","SubMemberTransfer"]
    > OptionsfalsearrayUSDC合約. ["OptionsTrade"]
    > Derivativesfalsearray統一帳戶權限. 該字段失效, 因為系統將會自動根據您的帳戶類型(經典帳戶和統一帳戶)來決定是否增加該權限
    > CopyTradingfalsearray跟單交易. ["CopyTrading"]
    > BlockTradefalsearray大宗商品交易. ["BlockTrade"]
    > Exchangefalsearray兌換. ["ExchangeHistory"]
    > NFTfalsearrayNFT. ["NFTQueryProductList"]

    返回參數​

    參數類型說明
    idstring唯一id. 內部使用
    notestring備註
    apiKeystringApi key
    readOnlyinteger0：可讀可寫. 1：只讀
    secretstring總是 ""
    permissionsObject權限類型
    > ContractTradearray合約交易的權限
    > Spotarray現貨交易的權限
    > Walletarray錢包的權限
    > OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易
    > Derivativesarray統一帳戶權限
    > CopyTradingarray跟單交易的權限
    > BlockTradearray大宗交易的權限
    > Exchangearray兌換的權限
    > NFTarrayNFT的權限
    ipsarray綁定的IP

    請求示例​

    POST /user/v3/private/update-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671179084116
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 741

    {
        "readOnly": 0,
        "ips": "xxx.xxx.xxx.xx",
        "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": ["BlockTrade"],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": ["NFTQueryProductList"]
            }
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "id": "341509",
            "note": "TESTING12SEP",
            "apiKey": "xxxxxxxxxxxxx",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [
                    "DerivativesTrade"
                ],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": [
                    "BlockTrade"
                ],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": [
                    "NFTQueryProductList"
                ]
            },
            "ips": [
                "xxx.xxx.xxx.xxx"
            ]
        },
        "retExtInfo": {},
        "time": 1671179084363
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/modify-sub-apikey.html b/zh-TW/account-asset/modify-sub-apikey.html index 7ff44387ee..f9847bd9d6 100644 --- a/zh-TW/account-asset/modify-sub-apikey.html +++ b/zh-TW/account-asset/modify-sub-apikey.html @@ -4,13 +4,13 @@ 修改子帳戶的API Key設置 | Bybit API Documentation - +

    修改子帳戶的API Key設置

    修改子帳戶API key的設置, 支持母帳戶管理子帳戶key的設置, 或者子帳戶key直接修改本身。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 子API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）"
    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /user/v3/private/update-sub-api

    請求參數​

    參數是否必須類型說明
    apikeyfalsestring子帳戶的api key
    • 當您要使用母帳戶來管理子帳戶的key時, 該字段必傳
    • 如果您是用對應的子帳戶api key修改本身, 該字段請不要傳入, 否則報錯
    readOnlyfalseinteger0 (默認)：可讀可寫. 1：只讀
    ipsfalsestring綁定IP. 比如: "192.168.0.1,192.168.0.2"注意:
    • 不傳參數ips 或者入参值為"*"意味著不綁定
    • 不綁定IP的api key將有90天的有效期限
    • 一旦帳戶密碼做了修改，帳戶下的非永久api key將在7天後失效
    permissionsfalseObject勾選api key權限. 如果不修改權限, 則不要傳入該參數
    > ContractTradefalsearray合約. ["Order","Position"]
    > Spotfalsearray現貨. ["SpotTrade"]
    > Walletfalsearray錢包. ["AccountTransfer","SubMemberTransferList"]
    > OptionsfalsearrayUSDC合約. ["OptionsTrade"]
    > Derivativesfalsearray統一帳戶權限. 該字段失效, 因為系統將會自動根據您的帳戶類型(經典帳戶和統一帳戶)來決定是否增加該權限
    > Exchangefalsearray兌換. ["ExchangeHistory"]

    返回參數​

    參數類型說明
    idstring唯一id. 內部使用
    notestring備註
    apiKeystringapi key
    readOnlyinteger0：可讀可寫. 1：只讀
    secretstring總是 ""
    permissionsObject權限類型
    > ContractTradearray合約交易的權限e
    > Spotarray現貨交易的權限
    > Walletarray錢包的權限
    > OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易
    > Derivativesarray統一帳戶權限
    > CopyTradingarray跟單交易的權限. 子帳戶暫不支持, 總是[]
    > BlockTradearray大宗交易的權限. 子帳戶暫不支持，總是[]
    > Exchangearray兌換的權限
    > NFTarrayNFT的權限. 子帳戶暫不支持, 總是[]
    ipsarrayIP綁定

    請求示例​

    POST /user/v3/private/update-sub-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671180069231
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 531

    {
        "readOnly": 0,
        "ips": "*",
        "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Exchange": [
                    "ExchangeHistory"
                ]
            }
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "id": "111111111",
            "note": "TESTNET subacc testing",
            "apiKey": "xxxxxxxxxxxxx",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [
                    "DerivativesTrade"
                ],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": []
            },
            "ips": [
                "*"
            ]
        },
        "retExtInfo": {},
        "time": 1671180069386
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/rate-limit.html b/zh-TW/account-asset/rate-limit.html index 193e2ff866..e81925ddfc 100644 --- a/zh-TW/account-asset/rate-limit.html +++ b/zh-TW/account-asset/rate-limit.html @@ -4,14 +4,14 @@ 頻率限制 | Bybit API Documentation - +

    頻率限制

    IP限頻​

    警告

    如果您收到HTTP 403（拒絕訪問）響應, 您的 IP 已被暫時或永久禁止。 您應立即查看以下指南，以確保您的應用程序不會繼續違反限制。如果您在 30 分鐘後 仍被禁止，則您可能會被永久禁止。

    我們不建議您在這些限制的邊緣運行您的應用程序，以防異常的網絡活動導致意外違規。

    • GET/POST 請求 (共享):
      • 連續 5 秒內每秒不超過 120 個請求
    備註

    所有到api.bybit.com或api.bytick.com的流量共享此限制，無論是訪問現貨、期貨還是期權。

    違反限制後，您的 IP 將被禁止一段時間（通常為 30 分鐘）。 持續違反限制將導致永久禁止。 我們不能撤銷永久禁令或縮短臨時禁令。

    賬戶頻率限製​

    警告

    如果您收到這樣的響應"ret_msg": "Too many visits!", 則表示您觸發了帳戶頻率限制, 請等到頻率限制重置以後, 再繼續發送請求。

    Bybit基於每分鐘的滾動時間窗口來做頻率限製，並且是按賬戶（uid）來做劃分限製，每次請求API響應頭(response header)中都會包含如下字段：

    • X-Bapi-Limit-Status - 該接口當前時間窗口剩余可用請求數
    • X-Bapi-Limit - 該接口當前頻率限製上限
    • X-Bapi-Limit-Reset-Timestamp - 如果您已超過該接口當前窗口頻率限製，該字段表示下個可用時間窗口的時間戳（毫秒），即什麽時候可以恢復訪問；如果您未超過該接口當前窗口頻率限製，該字段表示返回的是當前服務器時間（毫秒).

    Http 響應頭示例

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    接口頻率限制表​

    劃轉​

    路徑頻率
    /asset/v3/private/transfer/sub-member-transfer20 req/min
    /asset/v3/private/transfer/transfer-sub-member-save
    /asset/v3/private/transfer/universal-transfer5 req/sec
    /asset/v3/private/transfer/inter-transfer/list/query60 req/min
    /asset/v3/private/transfer/inter-transfer
    /asset/v3/private/transfer/sub-member-transfer/list/query
    /asset/v3/private/transfer/transfer-coin/list/query
    /asset/v3/private/transfer/sub-member/list/query
    /asset/v3/private/transfer/account-coin/balance/query
    /asset/v3/private/transfer/asset-info/query
    /asset/v3/private/transfer/universal-transfer/list/query5 req/sec
    /asset/v3/private/transfer/account-coins/balance/query5 req/sec

    提現與充值相關​

    路徑頻率
    /asset/v3/private/deposit/sub-member-record/query300 req/min
    /asset/v3/private/deposit/record/query
    /asset/v3/private/withdraw/record/query
    /asset/v3/private/deposit/address/query
    /asset/v3/private/deposit/sub-member-address/query
    /asset/v3/private/coin-info/query5 req/sec
    /asset/v3/private/withdraw/cancel60 req/min
    /asset/v3/private/withdraw/create1 req/s

    母子帳戶相關​

    路徑頻率
    /user/v3/private/create-sub-member5 req/sec
    /user/v3/private/create-sub-api
    /user/v3/private/frozen-sub-member
    /user/v3/private/update-api
    /user/v3/private/delete-api
    /user/v3/private/update-sub-api
    /user/v3/private/delete-sub-api
    /user/v3/private/query-sub-members10 req/sec
    /user/v3/private/query-api
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/rm-master-apikey.html b/zh-TW/account-asset/rm-master-apikey.html index 2d360c1a57..41079a5a0c 100644 --- a/zh-TW/account-asset/rm-master-apikey.html +++ b/zh-TW/account-asset/rm-master-apikey.html @@ -4,13 +4,13 @@ 刪除母帳戶的API Key | Bybit API Documentation - +

    刪除母帳戶的API Key

    刪除母帳戶下的api key。使用待刪除的api key調用接口。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"
    危險

    當心! 用於調用本接口的API KEY將會立馬失效。

    HTTP 請求​

    POST /user/v3/private/delete-api

    請求參數​

    無

    返回參數​

    無

    請求示例​

    POST /user/v3/private/delete-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671180438117
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 4
    {}

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1671180438209
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/rm-sub-apikey.html b/zh-TW/account-asset/rm-sub-apikey.html index 80e0cd06e0..00faf5eed3 100644 --- a/zh-TW/account-asset/rm-sub-apikey.html +++ b/zh-TW/account-asset/rm-sub-apikey.html @@ -4,13 +4,13 @@ 刪除子帳戶下的API Key | Bybit API Documentation - +

    刪除子帳戶下的API Key

    刪除子帳戶下的api key。使用待刪除的子帳戶api key調用接口或者使用母帳戶調用刪除指定api key

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 子API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）"
    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"
    危險

    當心! 用於調用本接口後, 對應的子帳戶api key會立馬失效。

    HTTP 請求​

    POST /user/v3/private/delete-sub-api

    請求參數​

    參數是否必須類型說明
    apikeyfalsestring子帳戶的api key
    • 當您要使用母帳戶來管理子帳戶的key時, 該字段必傳
    • 如果您是用對應的子帳戶api key修改本身, 該字段請不要傳入, 否則報錯

    返回參數​

    無

    請求示例​

    POST /user/v3/private/delete-sub-api HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671180557996
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    {
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1671180558095
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/set-deposit-acct.html b/zh-TW/account-asset/set-deposit-acct.html index e81cf2402d..b269dbf1a2 100644 --- a/zh-TW/account-asset/set-deposit-acct.html +++ b/zh-TW/account-asset/set-deposit-acct.html @@ -4,13 +4,13 @@ 設置充值帳戶 | Bybit API Documentation - +

    設置充值帳戶

    設置充值後的自動轉入帳戶類型。該功能與網頁端-設置-充值保持一致。

    信息
    • 資金會默認充值至資金帳戶, 通過該接口設置自動劃轉帳戶後，系統將會自動劃轉至目標帳戶。
    • 僅支持主帳號調用。
    提示
    • 統一交易帳戶(UTA)擁有FUND, UNIFIED, CONTRACT(反向期貨錢包), SPOT(將在2月底合併入UNIFIED錢包)
    • 統一保證金帳戶(UMA)擁有FUND, UNIFIED, CONTRACT(反向期貨錢包), SPOT
    • 普通帳戶擁有FUND, OPTION(USDC錢包), CONTRACT(期貨錢包), SPOT

    HTTP 請求​

    POST /asset/v3/private/deposit/deposit-to-account

    請求參數​

    參數是否必須類型說明
    accountTypetruestring帳戶類型
    • UNIFIED
    • SPOT
    • OPTION
    • CONTRACT
    • FUND

    返回參數​

    參數類型說明
    statusinteger請求狀態:
    • 1: 修改成功
    • 0: 修改失敗

    請求示例​

    POST /asset/v3/private/deposit/deposit-to-account HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676887913670
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
        "accountType": "CONTRACT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "status": 1
        },
        "retExtInfo": {},
        "time": 1676887914363
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/sub-deposit-addr.html b/zh-TW/account-asset/sub-deposit-addr.html index 49fc1ff81b..917a6ac14f 100644 --- a/zh-TW/account-asset/sub-deposit-addr.html +++ b/zh-TW/account-asset/sub-deposit-addr.html @@ -4,13 +4,13 @@ 查詢子帳戶充值地址信息 | Bybit API Documentation - +

    查詢子帳戶充值地址信息

    子帳戶充值地址信息查詢

    信息

    查詢子帳戶的充值地址信息。需使用母帳戶的API key。

    HTTP 請求​

    GET /asset/v3/private/deposit/sub-member-address/query

    請求參數​

    參數是否必須類型說明
    cointruestring幣種
    chainTypefalsestring鏈名.
    • 注意，此處應傳鏈名，例如ETH，而不是ERC20
    subMemberIdtruestring子帳戶UID

    返回參數​

    參數類型說明
    coinstring幣種
    chainsarrayObject
    > chainTypestring鏈類型
    > addressDepositstring充值地址
    > tagDepositstring充值tag
    > chainstring鏈名
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制

    請求示例​

    GET /asset/v3/private/deposit/sub-member-address/query?coin=USDT&chainType=ETH&subMemberId=407767 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671174486288
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "USDT",
            "chains": {
                "chainType": "ERC20",
                "addressDeposit": "xxxxxxxxxxx",
                "tagDeposit": "",
                "chain": "ETH",
                "batchReleaseLimit": "-1"
            }
        },
        "retExtInfo": {},
        "time": 1671174486505
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/sub-deposit-record.html b/zh-TW/account-asset/sub-deposit-record.html index ecf22f1d8a..fe911c1d48 100644 --- a/zh-TW/account-asset/sub-deposit-record.html +++ b/zh-TW/account-asset/sub-deposit-record.html @@ -4,13 +4,13 @@ 查詢子帳戶充值 (鏈上) | Bybit API Documentation - +

    查詢子帳戶充值 (鏈上)

    子帳戶充值紀錄

    Rules

    規則: 獲取子帳戶的入金紀錄。需使用母帳戶的API Key。若要通過子帳戶API Key查詢入金紀錄，請使用充值紀錄查詢

    HTTP 請求​

    GET /asset/v3/private/deposit/sub-member-record/query

    請求參數​

    參數是否必須類型說明
    subMemberIdtrueinteger子帳戶UID
    startTimefalseinteger開始時間 (精確到毫秒)。 默認為當前時間之前30天
    endTimefalseinteger結束時間 (精確到毫秒)。 默認為當前時間
    coinfalsestring幣種名：舉例，BTC。默認全部
    cursorfalsestring游標信息：用來分頁。 默認空
    limitfalseinteger每頁條數。[1, 50], 默認為50

    返回參數​

    參數類型說明
    rowsarrayObject
    > coinstring充值的幣種
    > chainstring鏈名
    > amountstring充值的數量
    > txIDstring交易ID。充值失敗/取消充值：為空
    > statusinteger
    • 0=未知
    • 1=待確認
    • 2=上賬中
    • 3=已完成
    • 4=充值失敗
    > toAddressstring充值的目標地址
    > tagstring充值目標地址的tag
    > depositFeestring充值手續費
    > successAtstring最後更新時間
    > confirmationsstring确认区块的数量
    > txIndexstring交易序列号
    > blockHashstring鏈上的哈希數
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制
    > depositTypeinteger入金類型. 0: 正常充值, 10: 充值觸發每日限額, 20: 異常充值
    nextPageCursorstring游標信息：用來分頁

    請求示例​

    GET /asset/v3/private/deposit/sub-member-record/query?subMemberId=xxxxxxxxxxx HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671169682466
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "10000",
                    "txID": "1234567890",
                    "status": 3,
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "11234567890",
                    "depositFee": "",
                    "successAt": "1671018256000",
                    "confirmations": "10000",
                    "txIndex": "",
                    "blockHash": "",
                    "batchReleaseLimit": "-1",
                    "depositType": 0
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTAwNTYwNiwibWF4SUQiOjEwMzE1MjN9"
        },
        "retExtInfo": {},
        "time": 1671166430718
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/sub-transfer-list.html b/zh-TW/account-asset/sub-transfer-list.html index 41252d2f6f..78e0615da0 100644 --- a/zh-TW/account-asset/sub-transfer-list.html +++ b/zh-TW/account-asset/sub-transfer-list.html @@ -4,13 +4,13 @@ 查詢子母間劃轉記錄 | Bybit API Documentation - +

    查詢子母間劃轉記錄

    查詢子母帳戶間的劃轉記錄

    警告

    僅支持使用母帳戶API key查詢

    HTTP 請求​

    GET /asset/v3/private/transfer/sub-member-transfer/list/query

    請求參數​

    參數是否必須類型說明
    transferIdfalsestringUUID,全局唯一
    coinfalsestring幣種類型
    statusfalsestring劃轉狀態
    startTimefalseinteger開始時間戳（毫秒)
    endTimefalseinteger結束時間戳（毫秒)
    limitfalseinteger每頁數量限制
    cursorfalsestring游標，用來分頁

    返回參數​

    參數類型說明
    listarrayObject
    > transferIdstringUUID,全局唯一
    > coinstring幣種類型
    > amountstring劃轉數量
    > memberIdinteger母賬戶ID
    > subMemberIdinteger子賬戶ID
    > timestampstring創建時間戳 (毫秒)
    > statusstring劃轉狀態
    > typestring轉入轉出類型.
    • IN 從主賬戶轉賬到子賬戶
    • OUT 從子賬戶轉賬到主賬戶
    nextPageCursorstring游標信息：用來分頁

    請求示例​

    GET /asset/v3/private/transfer/sub-member-transfer/list/query?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670927635525
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f",
                    "coin": "USDT",
                    "amount": "5",
                    "memberId": xxxxxxx,
                    "subMemberId": xxxxxxx,
                    "timestamp": "1670925916000",
                    "status": "SUCCESS",
                    "type": "IN"
                },
                {
                    "transferId": "11ff9144-2d5d-4233-913d-4595c9ad2170",
                    "coin": "USDT",
                    "amount": "100",
                    "memberId": xxxxxxx,
                    "subMemberId": xxxxxxx,
                    "timestamp": "1658732947000",
                    "status": "SUCCESS",
                    "type": "OUT"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MzU2MTA0LCJtYXhJRCI6MTcyMDk2OH0="
        },
        "retExtInfo": {},
        "time": 1670927635641
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/sub-transfer.html b/zh-TW/account-asset/sub-transfer.html index eb188b8908..86f9cb5dbd 100644 --- a/zh-TW/account-asset/sub-transfer.html +++ b/zh-TW/account-asset/sub-transfer.html @@ -4,13 +4,13 @@ 子母劃轉 | Bybit API Documentation - +

    子母劃轉

    觸發子母劃轉動作

    要發送賬戶類型和父子不可知的轉賬，請使用創建萬能轉賬接口。

    提示
    • 請註意該接口入參請求數據中的transferId字段為UUID全局唯一。
    • 該接口只能用於母子賬號之間的劃轉。
    • 一個子賬號只會歸屬於一個母賬號。
    • 如果您遇到錯誤碼是131228並且錯誤信息是your balance is not enough, 請前往查詢賬戶單個幣種余額接口確認安全限額。
    • 使用此API端点必须使用主账户的API key

    HTTP 請求​

    POST /asset/v3/private/transfer/sub-member-transfer

    請求參數​

    參數是否必須類型說明
    transferIdtruestringUUID,全局唯一
    cointruestring幣種類型
    amounttruestring兌入數量
    subMemberIdtrueinteger子賬戶ID
    typetruestring轉入轉出類型
    • IN 從主賬戶轉賬到子賬戶
    • OUT 從子賬戶轉賬到主賬戶

    返回參數​

    參數類型說明
    transferIdstringUUID,全局唯一

    請求示例​

    POST /asset/v3/private/transfer/sub-member-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670925915816
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: xxxxxxxxxxxxx
    Content-Type: application/json
    Content-Length: 144

    {
        "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f",
        "coin": "USDT",
        "amount": "5",
        "subMemberId": 554137,
        "type": "IN"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f"
        },
        "retExtInfo": {},
        "time": 1670925915979
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/sub-uid-list.html b/zh-TW/account-asset/sub-uid-list.html index b0733e5687..b7f2da38cb 100644 --- a/zh-TW/account-asset/sub-uid-list.html +++ b/zh-TW/account-asset/sub-uid-list.html @@ -4,13 +4,13 @@ 查詢子賬號列表 | Bybit API Documentation - +

    查詢子賬號列表

    查詢子賬號列表

    HTTP 請求​

    GET /asset/v3/private/transfer/sub-member/list/query

    請求參數​

    無

    返回參數​

    參數類型說明
    subMemberIdsarray<string>所有子賬號列表
    transferableSubMemberIdsarray<string>所有可互相劃轉的子賬號列表

    請求示例​

    GET /asset/v3/private/transfer/sub-member/list/query HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1670928351923
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "subMemberIds": [
                "111111",
                "2222222",
                "3333333"
            ],
            "transferableSubMemberIds": [
                "111111",
                "2222222",
                "3333333"
            ]
        },
        "retExtInfo": {},
        "time": 1670928352175
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/subuid-list.html b/zh-TW/account-asset/subuid-list.html index e02a36aa72..b339389971 100644 --- a/zh-TW/account-asset/subuid-list.html +++ b/zh-TW/account-asset/subuid-list.html @@ -4,13 +4,13 @@ 查詢子帳戶UID列表 | Bybit API Documentation - +

    查詢子帳戶UID列表

    獲取當前母帳戶下所有的子帳戶列表。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    GET /user/v3/private/query-sub-members

    請求參數​

    無

    返回參數​

    參數類型說明
    subMembersarrayObject
    > uidstring子帳戶userId
    > usernamestring用戶名
    > memberTypeinteger1: 普通子帳戶, 6: 託管子帳戶
    > statusinteger帳戶狀態.
    • 1: 正常
    • 2: 登陸封禁
    • 4: 凍結
    > remarkstring備註

    請求示例​

    GET /user/v3/private/query-sub-members HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430318405
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "subMembers": [
                {
                    "uid": "53888001",
                    "username": "xxx001",
                    "memberType": 1,
                    "status": 1,
                    "remark": "test"
                },
                {
                    "uid": "53888002",
                    "username": "xxx002",
                    "memberType": 6,
                    "status": 1,
                    "remark": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1676430319452
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/transferable-coin-list.html b/zh-TW/account-asset/transferable-coin-list.html index da6ee2f0bc..bda2655594 100644 --- a/zh-TW/account-asset/transferable-coin-list.html +++ b/zh-TW/account-asset/transferable-coin-list.html @@ -4,13 +4,13 @@ 賬號內可劃轉幣種列表 | Bybit API Documentation - +

    賬號內可劃轉幣種列表

    賬號內可劃轉幣種列表

    您可以在當前API key所屬的UID下確認不同賬戶類型之間的可劃轉的幣種

    HTTP 請求​

    GET /asset/v3/private/transfer/transfer-coin/list/query

    請求參數​

    參數是否必須類型說明
    fromAccountTypetruestring劃出賬戶類型. 劃入劃出帳戶類型必須不一樣
    toAccountTypetruestring劃出賬戶類型. 劃入劃出帳戶類型必須不一樣

    返回參數​

    參數類型說明
    listarray賬號內互轉支持的幣種

    請求示例​

    GET /asset/v3/private/transfer/transfer-coin/list/query?fromAccountType=SPOT&toAccountType=CONTRACT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671163888641
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                "ETH",
                "EOS",
                "USDT",
                "ADA",
                "BIT",
                "BTC",
                "DAI",
                "DOT",
                "LTC",
                "MANA",
                "XRP"
            ]
        },
        "retExtInfo": {},
        "time": 1671163888818
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/uni-transfer-list.html b/zh-TW/account-asset/uni-transfer-list.html index 136e87de30..f3ba0dd1ee 100644 --- a/zh-TW/account-asset/uni-transfer-list.html +++ b/zh-TW/account-asset/uni-transfer-list.html @@ -4,13 +4,13 @@ 查詢萬能劃轉記錄 | Bybit API Documentation - +

    查詢萬能劃轉記錄

    查詢萬能劃轉記錄

    該接口僅返回通過萬能劃轉接口以及網頁端的母子和子子劃轉的紀錄，通過其他劃轉接口的轉帳的紀錄將不會返回。

    提示
    • 母子帳號的api key都支持調用
    • 母帳號的api key需擁有"母子帳戶劃轉"(SubMemberTransfer)權限
    • 子帳號的api key需擁有"母子帳戶劃轉"(SubMemberTransferList)權限
    信息

    當startTime & endTime都不傳入時, API默認返回30天的數據

    HTTP 請求​

    GET /asset/v3/private/transfer/universal-transfer/list/query

    請求參數​

    參數是否必須類型說明
    transferIdtruestringUUID,全局唯一
    cointruestring幣種類型
    statusfalsestring劃轉狀態
    startTimefalseinteger開始時間戳（毫秒) 注意: 實際查詢時是秒級維度生效
    endTimefalseinteger結束時間戳（毫秒) 注意: 實際查詢時是秒級維度生效
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標, 用來分頁

    返回參數​

    參數類型說明
    listarrayObject
    > transferIdstringUUID,全局唯一
    > coinstring幣種類型
    > amountstring劃轉數量
    > timestampstring創建時間戳 (毫秒)
    > statusstring劃轉狀態
    > fromAccountTypestring劃出賬戶類型
    > toAccountTypestring劃入賬戶類型
    > fromMemberIdstring劃出的UID
    > toMemberIdstring劃入UID
    nextPageCursorstring游標信息：用來分頁

    請求示例​

    GET /asset/v3/private/transfer/universal-transfer/list/query?coin=USDT&status=SUCCESS HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671163509262
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06",
                    "coin": "USDT",
                    "amount": "10",
                    "timestamp": "1671163374000",
                    "status": "SUCCESS",
                    "fromAccountType": "UNIFIED",
                    "toAccountType": "SPOT",
                    "fromMemberId": "11111111",
                    "toMemberId": "22222222"
                },
                {
                    "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f",
                    "coin": "USDT",
                    "amount": "5",
                    "timestamp": "1670925916000",
                    "status": "SUCCESS",
                    "fromAccountType": "SPOT",
                    "toAccountType": "SPOT",
                    "fromMemberId": "111111111",
                    "toMemberId": "33333333"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MzU2MTA0LCJtYXhJRCI6MTczNDQ5Mn0="
        },
        "retExtInfo": {},
        "time": 1671163509474
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/uni-transfer.html b/zh-TW/account-asset/uni-transfer.html index 91333a86b4..b7c0717aa8 100644 --- a/zh-TW/account-asset/uni-transfer.html +++ b/zh-TW/account-asset/uni-transfer.html @@ -4,13 +4,13 @@ 萬能劃轉 | Bybit API Documentation - +

    萬能劃轉

    萬能劃轉, 您可以進行子帳戶之間，以及母子之間的劃轉

    警告
    • 支持使用母帳戶或者子帳號api key請求
      • 若要使用子帳號api key, 需要有"母子帳戶劃轉"(SubMemberTransferList)權限
      • 當使用子帳號api key劃轉時, 僅能劃轉到母帳號下
    • 如果您遇到錯誤碼是131228並且錯誤信息是your balance is not enough, 請前往查詢賬戶單個幣種余額接口確認安全限額.
    • 資金賬戶轉出目前僅支持加密貨幣，不支持法定貨幣.

    HTTP 請求​

    POST /asset/v3/private/transfer/universal-transfer

    請求參數​

    參數是否必須類型說明
    transferIdtruestringUUID,全局唯一
    cointruestring幣種類型
    amounttruestring劃轉數量
    fromMemberIdtruestring劃出的賬號uid. fromMemberId和toMemberId不能一樣
    toMemberIdtruestring劃入的賬號uid. fromMemberId和toMemberId不能一樣
    fromAccountTypetruestring劃出賬戶類型
    toAccountTypetruestring劃入賬戶類型

    返回參數​

    參數類型說明
    transferIdstringUUID,全局唯一
    statusstring劃轉狀態
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

    • 請求示例​

    POST /asset/v3/private/transfer/universal-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671163372208
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 219

    {
        "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06",
        "coin": "USDT",
        "amount": "10",
        "fromMemberId":"111111",
        "toMemberId":"222222",
        "fromAccountType": "UNIFIED",
        "toAccountType": "SPOT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06",
            "status": "SUCCESS"
        },
        "retExtInfo": {},
        "time": 1671163373537
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/vasp-list.html b/zh-TW/account-asset/vasp-list.html index 92973853a0..20c3e96610 100644 --- a/zh-TW/account-asset/vasp-list.html +++ b/zh-TW/account-asset/vasp-list.html @@ -4,13 +4,13 @@ 查詢交易所列表 | Bybit API Documentation - +

    查詢交易所列表

    該接口主要用於kyc=KOR的韓國個人用戶, 在提現時需要填寫接收方交易所信息

    HTTP 請求​

    GET /asset/v3/private/withdraw/vasp/list

    請求參數​

    無

    響應參數​

    參數類型說明
    vasparray交易所實體信息
    > vaspEntityIdstring接收方平台id. 當提現至Upbit或者不在該列表內的平台時, 請使用vaspEntityId="others"
    > vaspNamestring接收方平台名稱

    請求示例​

    GET /asset/v3/private/withdraw/vasp/list HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1715067106163
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "vasp": [
                {
                    "vaspEntityId": "basic-finance",
                    "vaspName": "Basic-finance"
                },
                {
                    "vaspEntityId": "beeblock",
                    "vaspName": "Beeblock"
                },
                {
                    "vaspEntityId": "bithumb",
                    "vaspName": "bithumb"
                },
                {
                    "vaspEntityId": "cardo",
                    "vaspName": "cardo"
                },
                {
                    "vaspEntityId": "codevasp",
                    "vaspName": "codevasp"
                },
                {
                    "vaspEntityId": "codexchange-kor",
                    "vaspName": "CODExchange-kor"
                },
                {
                    "vaspEntityId": "coinone",
                    "vaspName": "coinone"
                },
                {
                    "vaspEntityId": "dummy",
                    "vaspName": "Dummy"
                },
                {
                    "vaspEntityId": "flata-exchange",
                    "vaspName": "flataexchange"
                },
                {
                    "vaspEntityId": "fobl",
                    "vaspName": "Foblgate"
                },
                {
                    "vaspEntityId": "hanbitco",
                    "vaspName": "hanbitco"
                },
                {
                    "vaspEntityId": "hexlant",
                    "vaspName": "hexlant"
                },
                {
                    "vaspEntityId": "inex",
                    "vaspName": "INEX"
                },
                {
                    "vaspEntityId": "infiniteblock-corp",
                    "vaspName": "InfiniteBlock Corp"
                },
                {
                    "vaspEntityId": "kdac",
                    "vaspName": "kdac"
                },
                {
                    "vaspEntityId": "korbit",
                    "vaspName": "korbit"
                },
                {
                    "vaspEntityId": "paycoin",
                    "vaspName": "Paycoin"
                },
                {
                    "vaspEntityId": "qbit",
                    "vaspName": "Qbit"
                },
                {
                    "vaspEntityId": "tennten",
                    "vaspName": "TENNTEN"
                },
                {
                    "vaspEntityId": "others",
                    "vaspName": "Others (including Upbit)"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1715067106537
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/wallet-type.html b/zh-TW/account-asset/wallet-type.html index 4dae9fea0a..678642a6ad 100644 --- a/zh-TW/account-asset/wallet-type.html +++ b/zh-TW/account-asset/wallet-type.html @@ -4,13 +4,13 @@ 查詢帳戶支持的錢包類型 | Bybit API Documentation - +

    查詢帳戶支持的錢包類型

    查詢母帳戶或者子帳戶下支持的錢包類型

    提示
    • 使用母帳戶api key: 您可以查詢到母帳戶以及指定的子帳戶的錢包類型, 子帳戶的uid最多單次可查詢200個.
    • 使用子帳戶api key: 僅能查詢自身的錢包類型
    最佳實踐

    "FUND" - 這個資金錢包, 如果您從未存入或者轉入過資金, 該接口返回的數組裡將不會呈現該枚舉值, 但實際上您的帳戶總是擁有該錢包.

    • ["SPOT","OPTION","FUND","CONTRACT"] : 普通帳戶並且資金錢包曾經操作過
    • ["SPOT","OPTION","CONTRACT"] : 普通帳戶並且資金錢包不曾操作過
    • ["SPOT","UNIFIED","FUND","CONTRACT"] : UMA帳戶並且資金錢包曾經操作過. (等強制或主動升級到UTA後, 就沒有UMA帳戶的概念了)
    • ["SPOT","UNIFIED","CONTRACT"] : UMA帳戶並且資金錢包不曾操作過. (等強制或主動升級到UTA後, 就沒有UMA帳戶的概念了)
    • ["UNIFIED""FUND","CONTRACT"] : UTA帳戶並且資金錢包曾經操作過
    • ["UNIFIED","CONTRACT"] : UTA帳戶並且資金錢包不曾操作過

    HTTP 請求​

    GET /user/v3/private/get-member-type

    請求參數​

    參數是否必須類型說明
    memberIdsfalsestring
    • 不入参時, 僅查詢自身
    • 當使用母帳戶api key查詢子uid時, 母帳戶的數據總是返回且在數組的第一個
    • 支持輸入多個子uid, 用逗號隔開, 單次查詢最多支持200個
    • 子帳戶api key查詢時, 該入参將會被忽略

    返回參數​

    參數類型說明
    accountsarrayObject
    > uidstring母/子 uid
    > accountTypearraySPOT, CONTRACT, FUND, OPTION, UNIFIED. 請查閱上面的最佳實踐來理解返回的值

    Request Example​

    GET /user/v3/private/get-member-type HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686882546210
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "accounts": [
                {
                    "uid": "XXXXX",
                    "accountType": [
                        "SPOT",
                        "OPTION",
                        "FUND",
                        "CONTRACT"
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686880658551
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/withdraw-record.html b/zh-TW/account-asset/withdraw-record.html index 2a5e22cd3f..1ec1f7c430 100644 --- a/zh-TW/account-asset/withdraw-record.html +++ b/zh-TW/account-asset/withdraw-record.html @@ -4,13 +4,13 @@ 查詢提現記錄 | Bybit API Documentation - +

    查詢提現記錄

    提現記錄查詢

    信息

    規則：按id倒序進行，開始時間和截止時間差最大限制為30天

    HTTP 請求​

    GET /asset/v3/private/withdraw/record/query

    請求參數​

    參數是否必須類型說明
    withdrawIDfalseinteger提現ID。 (提現API響應參數中的提現請求ID)
    txIDfalsestring交易哈希ID
    startTimefalseinteger開始時間 (毫秒)。 默認為當前時間之前30天
    endTimefalseinteger結束時間 (毫秒)。 默認為當前時間
    coinfalsestring幣種名：舉例，BTC。默認全部
    withdrawTypefalsestring
    • 0 (默認)：鏈上提現.
    • 1：平台內部轉帳.
    • 2：鏈上提現和內部轉帳
    cursorfalsestring游標信息：用來分頁。 默認空
    limitfalseinteger每頁條數。[1, 50], 默認為50

    返回參數​

    ParameterTypeComments
    rowsarrayObject
    > coinstring提現的幣種
    > chainstring鏈名
    > amountstring提現的數量
    > txIDstring交易ID。提現失敗/提現撤銷：為空
    > statusstring提現狀態
    > toAddressstring提現目標地址. 內部轉帳：顯示郵箱或手機號
    > tagstring提現目標地址的tag
    > withdrawFeestring提現手續費
    > createTimestring發起提幣時間
    > updateTimestring提幣狀態更新時間
    > withdrawIdstring提現ID
    > withdrawTypeinteger出金類型.
    • 0：鏈上出金;
    • 1：內部地址轉帳
    nextPageCursorstring游標信息：用來分頁

    請求示例​

    GET /asset/v3/private/withdraw/record/query HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671171632559
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "TRX",
                    "amount": "10",
                    "txID": "",
                    "status": "CancelByUser",
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "",
                    "withdrawFee": "1",
                    "createTime": "1670906044000",
                    "updateTime": "1670906050000",
                    "withdrawId": "9965",
                    "withdrawType": 0
                },
                {
                    "coin": "USDT",
                    "chain": "TRX",
                    "amount": "10",
                    "txID": "",
                    "status": "CancelByUser",
                    "toAddress": "xxxxxxxxxxx",
                    "tag": "",
                    "withdrawFee": "1",
                    "createTime": "1670905993000",
                    "updateTime": "1670906001000",
                    "withdrawId": "9964",
                    "withdrawType": 0
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6OTk2NCwibWF4SUQiOjk5NjV9"
        },
        "retExtInfo": {},
        "time": 1671171632649
    }
    - + \ No newline at end of file diff --git a/zh-TW/account-asset/withdraw.html b/zh-TW/account-asset/withdraw.html index fd98d2c138..ecd6d25d95 100644 --- a/zh-TW/account-asset/withdraw.html +++ b/zh-TW/account-asset/withdraw.html @@ -4,13 +4,13 @@ 提現 | Bybit API Documentation - +

    提現

    若目標地址是Bybit平台內部地址，您可以實現內部平台轉帳

    信息
    • 確保您已經將提幣地址加入到這裡
    危險
    • 請UTA用戶注意, Bybit預計在二月底將操作現貨帳戶合併入統一帳戶, 所以請調整提現邏輯，即先將資金轉入資金帳戶，然完成提現。
    • 如何確定當前帳戶是否為UTA帳戶? 調用該接口, 若uta=1, 則表面該api key所屬的帳戶是UTA帳戶。
    公式

    feeType=0:

    • 若百分比手續費 != 0: 手續費 = 輸入金額 / (1 - 百分比手續費) * 百分比手續費 + 固定手續費
    • 若百分比手續費 = 0: 手續費 = 固定手續費

    feeType=1:

    • 若百分比手續費 != 0: 手續費 = 固定手續費 + (輸入金額 - 固定手續費) * 百分比手續費
    • 若百分比手續費 = 0: 手續費 = 固定手續費

    HTTP 請求​

    POST /asset/v3/private/withdraw/create

    請求參數​

    參數是否必須類型說明
    cointruestring幣種
    chaintruestring鏈名
    addresstruestring提幣地址. 注意大小寫，請使用和提幣地址簿中完全一樣的地址
    tagfalsestring存在tag的需要填寫. 注意: 如果鏈不支持tag/memo，請移除地址簿中的tag/memo，然後調用接口時，也不要傳tag字段
    amounttruestring提幣數量。最小提幣金額可從幣種信息接口獲取。
    timestamptrueinteger取用當前時間戳
    forceChainfalseinteger是否強制走鏈提幣.
    • 0(默認)：解析到若為內部地址 ，則內部轉帳
    • 1：強制走鏈
    accountTypefalsestring設置出金帳戶.
    • SPOT(默認)：走現貨錢包出金
    • FUND：走資金錢包出金
    feeTypefalseinteger手續費選項
    • 0(默認): 輸入金額即實際收到的金額, 所以您需要額外考慮手續費
    • 1: 輸入金額不是實際收到的金額, 系統將會自動計算所需的手續費
    requestIdfalsestring自定義ID, 全局唯一, 用於冪等校驗
  • 字母(區分大小寫)數字組合, 可以是純字母或者純數字, 長度在1-32字符之間
    • beneficiaryfalseObject提現目標方基本信息, 僅kyc=KOR(韓國個人用戶)必須傳遞此字段
    > vaspEntityIdtruestring接收方交易所id. 請調用該接口來查詢對應的id
    > beneficiaryNamefalsestring接收方交易所用戶kyc姓名, 比如John Wilson 或者 Wilson John
  • 請依據目標交易所kyc姓名
  • 僅當vaspEntityId="others"時, 該字段可不傳

    • 返回參數​

    參數類型說明
    idstring提現ID

    請求示例​

    POST /asset/v3/private/withdraw/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671172758674
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json
    Content-Length: 193

    {
        "coin": "USDT",
        "chain": "ETH",
        "address": "xxxxxxxxxxx",
        "tag": null,
        "amount": "10",
        "timestamp": 1670919612851,
        "forceChain": 1,
        "accountType": "FUND"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "id": "xxxxxxxxxxx"
          },
        "retExtInfo": {},
        "time": 1671172180550
    }
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/account-info.html b/zh-TW/api-explorer/v5/account/account-info.html index 92c4ada664..a83e5d08eb 100644 --- a/zh-TW/api-explorer/v5/account/account-info.html +++ b/zh-TW/api-explorer/v5/account/account-info.html @@ -4,13 +4,13 @@ Get Account Info | Bybit API Documentation - +

    Get Account Info​

    Get account info

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/account.html b/zh-TW/api-explorer/v5/account/account.html index e1b4609f21..dce0f392d6 100644 --- a/zh-TW/api-explorer/v5/account/account.html +++ b/zh-TW/api-explorer/v5/account/account.html @@ -4,13 +4,13 @@ Account | Bybit API Documentation - +

    Account

    Account endpoints

    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/borrow-history.html b/zh-TW/api-explorer/v5/account/borrow-history.html index 679222235b..057dfb390f 100644 --- a/zh-TW/api-explorer/v5/account/borrow-history.html +++ b/zh-TW/api-explorer/v5/account/borrow-history.html @@ -4,13 +4,13 @@ Get Borrow History | Bybit API Documentation - +

    Get Borrow History​

    Get borrow history

    Query Parameters
    • currency string

      e.g., USDC, USDT, BTC, ETH

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 20

      Limit per page. 1-50

    • cursor string

      Cusor, used for pagiation

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/coin-greeks.html b/zh-TW/api-explorer/v5/account/coin-greeks.html index d4d70a6159..fdd44653ec 100644 --- a/zh-TW/api-explorer/v5/account/coin-greeks.html +++ b/zh-TW/api-explorer/v5/account/coin-greeks.html @@ -4,13 +4,13 @@ Get Coin Greeks | Bybit API Documentation - +

    Get Coin Greeks​

    Get coin greek info

    Query Parameters
    • baseCoin string

      Base coin

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/collateral-info.html b/zh-TW/api-explorer/v5/account/collateral-info.html index 15e43b7963..7e017886fb 100644 --- a/zh-TW/api-explorer/v5/account/collateral-info.html +++ b/zh-TW/api-explorer/v5/account/collateral-info.html @@ -4,13 +4,13 @@ Get Collateral Info | Bybit API Documentation - +

    Get Collateral Info​

    Get collateral info

    Query Parameters
    • currency string

      Collateral asset

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/fee-rate.html b/zh-TW/api-explorer/v5/account/fee-rate.html index 625b466107..fbb44945bf 100644 --- a/zh-TW/api-explorer/v5/account/fee-rate.html +++ b/zh-TW/api-explorer/v5/account/fee-rate.html @@ -4,13 +4,13 @@ Get Fee Rate | Bybit API Documentation - +

    Get Fee Rate​

    Get fee rate

    Query Parameters
    • category string required

      Possible values: [spot, linear, inverse, option]

      Product type. working for spot and option

    • symbol string

      Symbol name. valid for linear,inverse and spot

    • baseCoin string

      Possible values: [SOL, BTC, ETH]

      Base coin. Valid for option

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/set-collateral.html b/zh-TW/api-explorer/v5/account/set-collateral.html index 0c78aa0094..e1d765f175 100644 --- a/zh-TW/api-explorer/v5/account/set-collateral.html +++ b/zh-TW/api-explorer/v5/account/set-collateral.html @@ -4,13 +4,13 @@ Set Collateral Coin | Bybit API Documentation - +

    Set Collateral Coin​

    Set collateral coin

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • coin string required

      coin

    • collateralSwitch string required

      Possible values: [ON, OFF]

      coin

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/set-margin-mode.html b/zh-TW/api-explorer/v5/account/set-margin-mode.html index 64c41fb8b7..a9ab56a8a5 100644 --- a/zh-TW/api-explorer/v5/account/set-margin-mode.html +++ b/zh-TW/api-explorer/v5/account/set-margin-mode.html @@ -4,13 +4,13 @@ Set Margin Mode | Bybit API Documentation - +

    Set Margin Mode​

    Set margin mode

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • setMarginMode string required

      Possible values: [REGULAR_MARGIN, ISOLATED_MARGIN, PORTFOLIO_MARGIN]

      Margin mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/set-spot-hedge.html b/zh-TW/api-explorer/v5/account/set-spot-hedge.html index 87f59ba1d8..d31d227d15 100644 --- a/zh-TW/api-explorer/v5/account/set-spot-hedge.html +++ b/zh-TW/api-explorer/v5/account/set-spot-hedge.html @@ -4,13 +4,13 @@ Set Spot Hedging | Bybit API Documentation - +

    Set Spot Hedging​

    Set spot hedging for Portfolio margin

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • setHedgingMode string required

      Possible values: [ON, OFF]

      on or off spot hedging mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/transaction-log.html b/zh-TW/api-explorer/v5/account/transaction-log.html index 779076dbcd..8aac118800 100644 --- a/zh-TW/api-explorer/v5/account/transaction-log.html +++ b/zh-TW/api-explorer/v5/account/transaction-log.html @@ -4,13 +4,13 @@ Get Transaction Log | Bybit API Documentation - +

    Get Transaction Log​

    Get transaction log

    Query Parameters
    • accountType string

      Possible values: [UNIFIED]

      Support UNIFIED for now

    • category string

      Possible values: [spot, linear, option]

      Product category

    • currency string

      Currency

    • baseCoin string

      Base coin

    • type string

      Possible values: [TRANSFER_IN, TRANSFER_OUT, TRADE, SETTLEMENT, DELIVERY, LIQUIDATION, BONUS, FEE_REFUND, INTEREST, CURRENCY_BUY, CURRENCY_SELL]

      Transaction log type

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 20

      Limit size for each page. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/upgrade-unified-account.html b/zh-TW/api-explorer/v5/account/upgrade-unified-account.html index d5dd118dd9..1ae36220d6 100644 --- a/zh-TW/api-explorer/v5/account/upgrade-unified-account.html +++ b/zh-TW/api-explorer/v5/account/upgrade-unified-account.html @@ -4,13 +4,13 @@ Upgrade to Unified Account | Bybit API Documentation - +

    Upgrade to Unified Account​

    Upgrade to UTA

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • object
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/account/wallet.html b/zh-TW/api-explorer/v5/account/wallet.html index 088ee63bfe..e0912127a3 100644 --- a/zh-TW/api-explorer/v5/account/wallet.html +++ b/zh-TW/api-explorer/v5/account/wallet.html @@ -4,13 +4,13 @@ Get Wallet Balance | Bybit API Documentation - +

    Get Wallet Balance​

    Get wallet balance

    Query Parameters
    • accountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT]

      Account type

    • coin string

      Coin name. You can pass mutiple coins like USDT,USDC

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/account-coin-balance.html b/zh-TW/api-explorer/v5/asset/account-coin-balance.html index 55081a3d6b..98d010ef3b 100644 --- a/zh-TW/api-explorer/v5/asset/account-coin-balance.html +++ b/zh-TW/api-explorer/v5/asset/account-coin-balance.html @@ -4,13 +4,13 @@ Get Single Coin Balance | Bybit API Documentation - +

    Get Single Coin Balance​

    Get Single Coin Balance

    Query Parameters
    • memberId string

      If query sub user balance, please input sub uid

    • accountType string required

      Possible values: [SPOT, CONTRACT, UNIFIED, OPTION, INVESTMENT, FUND]

      Account type

    • coin string required

      Coin name

    • withBonus integer

      Possible values: [0, 1]

      Query bonus or not. 0=false, 1=true

    • withTransferSafeAmount integer

      Possible values: [0, 1]

      Whether query delay withdraw/transfer safe amount. 0：false, 1；true

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/all-balance.html b/zh-TW/api-explorer/v5/asset/all-balance.html index d950dcee7b..a4b48c9205 100644 --- a/zh-TW/api-explorer/v5/asset/all-balance.html +++ b/zh-TW/api-explorer/v5/asset/all-balance.html @@ -4,13 +4,13 @@ Get All Coins Balance | Bybit API Documentation - +

    Get All Coins Balance​

    Get All Coins Balance

    Query Parameters
    • memberId string

      If query sub user balance, please input sub uid

    • accountType string required

      Possible values: [SPOT, CONTRACT, UNIFIED, OPTION, INVESTMENT, FUND]

      Account type

    • coin string

      Coin name

    • withBonus integer

      Possible values: [0, 1]

      Query bonus or not. 0=false, 1=true

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/asset-info.html b/zh-TW/api-explorer/v5/asset/asset-info.html index 82b0e77f96..f72b500771 100644 --- a/zh-TW/api-explorer/v5/asset/asset-info.html +++ b/zh-TW/api-explorer/v5/asset/asset-info.html @@ -4,13 +4,13 @@ Get Asset Info (Spot) | Bybit API Documentation - +

    Get Asset Info (Spot)​

    Get spot asset

    Query Parameters
    • accountType string required

      Possible values: [SPOT]

      Account type

    • coin string

      Coin name

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/asset.html b/zh-TW/api-explorer/v5/asset/asset.html index e031d03a65..cf4bbd2756 100644 --- a/zh-TW/api-explorer/v5/asset/asset.html +++ b/zh-TW/api-explorer/v5/asset/asset.html @@ -4,13 +4,13 @@ Asset | Bybit API Documentation - +

    Asset

    Asset endpoints

    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/coin-info.html b/zh-TW/api-explorer/v5/asset/coin-info.html index 41ff10a2da..55309943d2 100644 --- a/zh-TW/api-explorer/v5/asset/coin-info.html +++ b/zh-TW/api-explorer/v5/asset/coin-info.html @@ -4,13 +4,13 @@ Get Coin Info | Bybit API Documentation - +

    Get Coin Info​

    Get coin info

    Query Parameters
    • coin string

      Coin name

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/create-inter-transfer.html b/zh-TW/api-explorer/v5/asset/create-inter-transfer.html index 7116b34880..4c8e6e3c50 100644 --- a/zh-TW/api-explorer/v5/asset/create-inter-transfer.html +++ b/zh-TW/api-explorer/v5/asset/create-inter-transfer.html @@ -4,13 +4,13 @@ Create Internal Transfer | Bybit API Documentation - +

    Create Internal Transfer​

    Create internal transfer

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • transferId string required

      UUID

    • coin string required

      Coin

    • amount string required

      Amount

    • fromAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, INVESTMENT, FUND]

      From account type

    • toAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, INVESTMENT, FUND]

      To account type

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/delivery.html b/zh-TW/api-explorer/v5/asset/delivery.html index 987ec4b4b8..d1070d25e2 100644 --- a/zh-TW/api-explorer/v5/asset/delivery.html +++ b/zh-TW/api-explorer/v5/asset/delivery.html @@ -4,13 +4,13 @@ Get Delivery Record | Bybit API Documentation - +

    Get Delivery Record​

    Get delivery record

    Query Parameters
    • category string required

      Possible values: [option, linear]

      Product type

    • symbol string

      Symbol name

    • expDate string

      expired date

    • limit integer

      Default value: 20

      1-50. max 50

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/deposit-coin-spec.html b/zh-TW/api-explorer/v5/asset/deposit-coin-spec.html index 8ac9e1169f..8b0729f17f 100644 --- a/zh-TW/api-explorer/v5/asset/deposit-coin-spec.html +++ b/zh-TW/api-explorer/v5/asset/deposit-coin-spec.html @@ -4,13 +4,13 @@ Get Allowed Deposit Coin Info | Bybit API Documentation - +

    Get Allowed Deposit Coin Info​

    Get allowed deposit coin info

    Query Parameters
    • coin string

      Coin name. coin and chain must be paired if passed

    • chain string

      Chain name. coin and chain must be paired if passed

    • limit integer

      Default value: 10

      Limit size. 1-35

    • cursor string

      Cursor, used for pagination

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/deposit-record.html b/zh-TW/api-explorer/v5/asset/deposit-record.html index d5ffd4a253..fc567a2f94 100644 --- a/zh-TW/api-explorer/v5/asset/deposit-record.html +++ b/zh-TW/api-explorer/v5/asset/deposit-record.html @@ -4,13 +4,13 @@ Get Deposit Record (on-chain) | Bybit API Documentation - +

    Get Deposit Record (on-chain)​

    Get deposit record

    Query Parameters
    • coin string

      Coin name

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      Limit size. 1-50

    • cursor string

      Cursor, used to pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/exchange.html b/zh-TW/api-explorer/v5/asset/exchange.html index b7b26eb440..5cf1b1b99f 100644 --- a/zh-TW/api-explorer/v5/asset/exchange.html +++ b/zh-TW/api-explorer/v5/asset/exchange.html @@ -4,13 +4,13 @@ Get Coin Exchange Records | Bybit API Documentation - +

    Get Coin Exchange Records​

    Get exchange records

    Query Parameters
    • fromCoin string

      From coin

    • toCoin string

      To coin

    • limit integer required

      Default value: 20

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/inter-transfer-list.html b/zh-TW/api-explorer/v5/asset/inter-transfer-list.html index 6f2850b8aa..a5176e27e3 100644 --- a/zh-TW/api-explorer/v5/asset/inter-transfer-list.html +++ b/zh-TW/api-explorer/v5/asset/inter-transfer-list.html @@ -4,13 +4,13 @@ Get Internal Transfer Records | Bybit API Documentation - +

    Get Internal Transfer Records​

    Get internal transfer records

    Query Parameters
    • transferId string

      Transfer id

    • coin string

      Coin name

    • status string

      Possible values: [SUCCESS, PENDING, FAILED]

      Status

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 20

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/internal-deposit-record.html b/zh-TW/api-explorer/v5/asset/internal-deposit-record.html index 82726a1dff..105d43e241 100644 --- a/zh-TW/api-explorer/v5/asset/internal-deposit-record.html +++ b/zh-TW/api-explorer/v5/asset/internal-deposit-record.html @@ -4,13 +4,13 @@ Get Internal Deposit Records (off-chain) | Bybit API Documentation - +

    Get Internal Deposit Records (off-chain)​

    Get deposit records through Bybit platform

    Query Parameters
    • coin string

      Coin name

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/master-deposit-addr.html b/zh-TW/api-explorer/v5/asset/master-deposit-addr.html index 8b7d68a49d..eb06d833bc 100644 --- a/zh-TW/api-explorer/v5/asset/master-deposit-addr.html +++ b/zh-TW/api-explorer/v5/asset/master-deposit-addr.html @@ -4,13 +4,13 @@ Get Master Deposit Address | Bybit API Documentation - +

    Get Master Deposit Address​

    Get master deposit address

    Query Parameters
    • coin string required

      Coin name

    • chainType string

      Chain name

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/set-deposit-acct.html b/zh-TW/api-explorer/v5/asset/set-deposit-acct.html index da58279586..7ec75a75fc 100644 --- a/zh-TW/api-explorer/v5/asset/set-deposit-acct.html +++ b/zh-TW/api-explorer/v5/asset/set-deposit-acct.html @@ -4,13 +4,13 @@ Set Deposit Account | Bybit API Documentation - +

    Set Deposit Account​

    Set Deposit Account

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Request Body
    • AccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, FUND]

      From account type

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/settlement.html b/zh-TW/api-explorer/v5/asset/settlement.html index e33bc2dc2e..d9052438c6 100644 --- a/zh-TW/api-explorer/v5/asset/settlement.html +++ b/zh-TW/api-explorer/v5/asset/settlement.html @@ -4,13 +4,13 @@ Get USDC Session Settlement | Bybit API Documentation - +

    Get USDC Session Settlement​

    Get usdc session settlement record.

    Query Parameters
    • category string required

      Possible values: [linear]

      Product type

    • symbol string

      Symbol name. USDC perp or USDC futures

    • limit integer

      Default value: 20

      1-50. max 50

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/sub-deposit-addr.html b/zh-TW/api-explorer/v5/asset/sub-deposit-addr.html index 111b0d52c1..f228b3b1c0 100644 --- a/zh-TW/api-explorer/v5/asset/sub-deposit-addr.html +++ b/zh-TW/api-explorer/v5/asset/sub-deposit-addr.html @@ -4,13 +4,13 @@ Get Sub Deposit Address | Bybit API Documentation - +

    Get Sub Deposit Address​

    Get sub deposit address

    Query Parameters
    • coin string required

      Coin name

    • chainType string required

      Chain name

    • subMemberId string required

      Sub UID

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/sub-deposit-record.html b/zh-TW/api-explorer/v5/asset/sub-deposit-record.html index 1824ef9a3c..a394c23902 100644 --- a/zh-TW/api-explorer/v5/asset/sub-deposit-record.html +++ b/zh-TW/api-explorer/v5/asset/sub-deposit-record.html @@ -4,13 +4,13 @@ Get Sub Account Deposit Records (on-chain) | Bybit API Documentation - +

    Get Sub Account Deposit Records (on-chain)​

    Get sub account deposit record

    Query Parameters
    • subMemberId string required

      Sub UID

    • coin string

      Coin name

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/sub-uid-list.html b/zh-TW/api-explorer/v5/asset/sub-uid-list.html index 585a6c20cc..b13f04bc60 100644 --- a/zh-TW/api-explorer/v5/asset/sub-uid-list.html +++ b/zh-TW/api-explorer/v5/asset/sub-uid-list.html @@ -4,13 +4,13 @@ Get Sub UID | Bybit API Documentation - +

    Get Sub UID​

    Get sub uid

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api key

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/transferable-coin.html b/zh-TW/api-explorer/v5/asset/transferable-coin.html index a23ad686e7..c9ac69de32 100644 --- a/zh-TW/api-explorer/v5/asset/transferable-coin.html +++ b/zh-TW/api-explorer/v5/asset/transferable-coin.html @@ -4,13 +4,13 @@ Get Transferable Coin | Bybit API Documentation - +

    Get Transferable Coin​

    Get transferable coins

    Query Parameters
    • fromAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, INVESTMENT, FUND]

      From account type

    • toAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, OPTION, INVESTMENT, FUND]

      To account type

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/unitransfer-list.html b/zh-TW/api-explorer/v5/asset/unitransfer-list.html index 23e57d9f21..e4c35d9a92 100644 --- a/zh-TW/api-explorer/v5/asset/unitransfer-list.html +++ b/zh-TW/api-explorer/v5/asset/unitransfer-list.html @@ -4,13 +4,13 @@ Get Universal Transfer Records | Bybit API Documentation - +

    Get Universal Transfer Records​

    Get universal transfer record

    Query Parameters
    • transferId string

      Transfer id

    • coin string

      Coin name

    • status string

      Possible values: [SUCCESS, FAILED, PENDING]

      Status

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 20

      Limit size. 1-50

    • cursor string

      Cursor, used for pagination

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/unitransfer.html b/zh-TW/api-explorer/v5/asset/unitransfer.html index 50e16a9ced..82be106177 100644 --- a/zh-TW/api-explorer/v5/asset/unitransfer.html +++ b/zh-TW/api-explorer/v5/asset/unitransfer.html @@ -4,13 +4,13 @@ Create Universal Transfer | Bybit API Documentation - +

    Create Universal Transfer​

    Create universal transfer

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Request Body
    • transferId sting required

      Transfer id. UUID

    • coin sting required

      Coin name

    • amount sting required

      Amount

    • fromMemberId intger required

      From UID

    • toMemberId integer required

      To UID

    • fromAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, INVESTMENT, OPTION, FUND]

      From account type

    • toAccountType string required

      Possible values: [UNIFIED, CONTRACT, SPOT, INVESTMENT, OPTION, FUND]

      To account type

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/asset/withdraw-record.html b/zh-TW/api-explorer/v5/asset/withdraw-record.html index 789c96da06..7b9dcf3511 100644 --- a/zh-TW/api-explorer/v5/asset/withdraw-record.html +++ b/zh-TW/api-explorer/v5/asset/withdraw-record.html @@ -4,13 +4,13 @@ Get Withdraw Records | Bybit API Documentation - +

    Get Withdraw Records​

    Get withdraw record

    Query Parameters
    • withdrawID string

      Withdraw ID

    • coin string

      Coin name

    • withdrawType integer

      Possible values: [0, 1, 2]

      Withdraw type. 0=on chain, 1=off chain, 2=all

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      Limit size. 1-50

    • cursor string

      Cursor, used to pagination

    Header Parameters
    • apiKey string required

      Use master UID api key

    • secret string required

      Use master UID api secret

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/category.html b/zh-TW/api-explorer/v5/category.html index d99dd79477..6409c3da1b 100644 --- a/zh-TW/api-explorer/v5/category.html +++ b/zh-TW/api-explorer/v5/category.html @@ -4,13 +4,13 @@ V5 API | Bybit API Documentation - +

    V5 API

    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/lt/etp.html b/zh-TW/api-explorer/v5/lt/etp.html index 6c8d37ef23..e32e603d0b 100644 --- a/zh-TW/api-explorer/v5/lt/etp.html +++ b/zh-TW/api-explorer/v5/lt/etp.html @@ -4,13 +4,13 @@ Spot Leverage Token | Bybit API Documentation - +
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/lt/leverage-token-info.html b/zh-TW/api-explorer/v5/lt/leverage-token-info.html index e2cbe4d03e..203165f1f2 100644 --- a/zh-TW/api-explorer/v5/lt/leverage-token-info.html +++ b/zh-TW/api-explorer/v5/lt/leverage-token-info.html @@ -4,13 +4,13 @@ Get Leverage Token Info | Bybit API Documentation - +

    Get Leverage Token Info​

    Get lt information

    Query Parameters
    • ltCoin string

      Levearage coin name. e.g., BTC3L

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/lt/leverage-token-reference.html b/zh-TW/api-explorer/v5/lt/leverage-token-reference.html index f641eaf869..95c43cacfe 100644 --- a/zh-TW/api-explorer/v5/lt/leverage-token-reference.html +++ b/zh-TW/api-explorer/v5/lt/leverage-token-reference.html @@ -4,13 +4,13 @@ Get Leverage Token Market | Bybit API Documentation - +

    Get Leverage Token Market​

    Get lt market information

    Query Parameters
    • ltCoin string required

      Levearage coin name. e.g., BTC3L

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/lt/order-record.html b/zh-TW/api-explorer/v5/lt/order-record.html index 11b3563e5e..7b8e249802 100644 --- a/zh-TW/api-explorer/v5/lt/order-record.html +++ b/zh-TW/api-explorer/v5/lt/order-record.html @@ -4,13 +4,13 @@ Get Purchase or Redeem Records | Bybit API Documentation - +

    Get Purchase or Redeem Records​

    Get the order history of purchase or redeem

    Query Parameters
    • ltCoin string

      Levearage coin name. e.g., BTC3L

    • orderId string

      Order id

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 100

      Limit size of each page. 1-500

    • ltOrderType integer

      Possible values: [1, 2]

      LT order type. 1=purchase, 2=redeem

    • serialNo string

      Serial number

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/lt/purchase.html b/zh-TW/api-explorer/v5/lt/purchase.html index 1da570daec..181b58fe12 100644 --- a/zh-TW/api-explorer/v5/lt/purchase.html +++ b/zh-TW/api-explorer/v5/lt/purchase.html @@ -4,13 +4,13 @@ Purchase | Bybit API Documentation - +

    Purchase​

    Purchase leverage token

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • ltCoin string

      Levearage coin name. e.g., BTC3L

    • ltAmount string

      Purchase amount

    • serialNo string

      Serial number, customised order id

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/lt/redeem.html b/zh-TW/api-explorer/v5/lt/redeem.html index 349508e5e7..1cbcd89511 100644 --- a/zh-TW/api-explorer/v5/lt/redeem.html +++ b/zh-TW/api-explorer/v5/lt/redeem.html @@ -4,13 +4,13 @@ Redeem | Bybit API Documentation - +

    Redeem​

    Redeem leverage token

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • ltCoin string

      Levearage coin name. e.g., BTC3L

    • quantity string

      Redeem quantity

    • serialNo string

      Serial number, customised order id

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/delivery-price.html b/zh-TW/api-explorer/v5/market/delivery-price.html index 864eb83dec..cba86f973a 100644 --- a/zh-TW/api-explorer/v5/market/delivery-price.html +++ b/zh-TW/api-explorer/v5/market/delivery-price.html @@ -4,13 +4,13 @@ Get Delivery Price | Bybit API Documentation - +

    Get Delivery Price​

    Get delivery price

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option]

      Product type. linear, inverse, option

    • symbol string

      Symbol name

    • baseCoin string

      Default value: BTC

      Base coin, for option only. Return BTC by default

    • limit string

      Default value: 50

      Maximum 200

    • cursor string

      The cursor, used for pagination

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/history-fund-rate.html b/zh-TW/api-explorer/v5/market/history-fund-rate.html index 4b03f84ac3..00839f2513 100644 --- a/zh-TW/api-explorer/v5/market/history-fund-rate.html +++ b/zh-TW/api-explorer/v5/market/history-fund-rate.html @@ -4,13 +4,13 @@ Get Funding Rate History | Bybit API Documentation - +

    Get Funding Rate History​

    Get historical funding rate

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • startTime integer

      The start timstamp (ms)

    • endTime integer

      The end timstamp (ms)

    • limit integer

      Default value: 200

      Maximum 200

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/index-kline.html b/zh-TW/api-explorer/v5/market/index-kline.html index 5e3b5293ee..bc14b89171 100644 --- a/zh-TW/api-explorer/v5/market/index-kline.html +++ b/zh-TW/api-explorer/v5/market/index-kline.html @@ -4,13 +4,13 @@ Get Index Price Kline | Bybit API Documentation - +

    Get Index Price Kline​

    Get Index Price Kline data

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • interval string[] required

      Possible values: [1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, M, W]

      kline interval

    • start integer

      start timestamp (ms). e.g., 1669852800000 (1 DEC 2022 UTC 0:00)

    • end integer

      end timestamp (ms). e.g., 1671062400000 (15 DEC 2022 UTC 0:00)

    • limit integer

      Default value: 200

      Maximum 1000

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/instrument.html b/zh-TW/api-explorer/v5/market/instrument.html index 0938a59871..bdf0f7f910 100644 --- a/zh-TW/api-explorer/v5/market/instrument.html +++ b/zh-TW/api-explorer/v5/market/instrument.html @@ -4,13 +4,13 @@ Get Instrument Info | Bybit API Documentation - +

    Get Instrument Info​

    Get launched instruments information.

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string

      Symbol name

    • status string

      Possible values: [PreLaunch, Trading, Settling, Delivering, Closed]

      Status filter

    • baseCoin string

      for linear, invere and option ONLY

    • limit integer

      Default value: 500

      Maximum 1000. spot does not have pagination

    • cursor string

      pass cursor from the response param "nagePageCursor" to paginate

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/insurance.html b/zh-TW/api-explorer/v5/market/insurance.html index 4a68a4cf73..4ace3790a9 100644 --- a/zh-TW/api-explorer/v5/market/insurance.html +++ b/zh-TW/api-explorer/v5/market/insurance.html @@ -4,13 +4,13 @@ Get Insurance | Bybit API Documentation - +

    Get Insurance​

    Get Insurance

    Query Parameters
    • coin string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/iv.html b/zh-TW/api-explorer/v5/market/iv.html index c8ce099103..3b7976fb8c 100644 --- a/zh-TW/api-explorer/v5/market/iv.html +++ b/zh-TW/api-explorer/v5/market/iv.html @@ -4,13 +4,13 @@ Get Historical Volatility | Bybit API Documentation - +

    Get Historical Volatility​

    Get historical volatility

    Query Parameters
    • category string[] required

      Possible values: [option]

      Product type

    • baseCoin string

      Default value: BTC

      Base coin. If not passed, BTC returned by default

    • period integer[]

      Possible values: [7, 14, 21, 30, 60, 90, 180, 270]

      Period. If not passed, it returns 7 days by default. SOL does not have 180 and 270

    • startTime integer

      The start timstamp (ms)

    • endTime integer

      The end timstamp (ms)

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/kline.html b/zh-TW/api-explorer/v5/market/kline.html index 75964b0c75..41bcf5c32c 100644 --- a/zh-TW/api-explorer/v5/market/kline.html +++ b/zh-TW/api-explorer/v5/market/kline.html @@ -4,13 +4,13 @@ Get Kline | Bybit API Documentation - +

    Get Kline​

    Get kline data

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, spot]

      Product type

    • symbol string required

      Symbol name

    • interval string[] required

      Possible values: [1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, M, W]

      kline interval

    • start integer

      start timestamp (ms). e.g., 1669852800000 (1 DEC 2022 UTC 0:00)

    • end integer

      end timestamp (ms). e.g., 1671062400000 (15 DEC 2022 UTC 0:00)

    • limit integer

      Default value: 200

      Maximum 1000

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/long-short-ratio.html b/zh-TW/api-explorer/v5/market/long-short-ratio.html index 9e669ccba8..6d44dab78d 100644 --- a/zh-TW/api-explorer/v5/market/long-short-ratio.html +++ b/zh-TW/api-explorer/v5/market/long-short-ratio.html @@ -4,13 +4,13 @@ Get Long Short Ratio | Bybit API Documentation - +

    Get Long Short Ratio​

    Get long short ratio

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • period string[] required

      Possible values: [5min, 15min, 30min, 1h, 4h, 1d]

      period

    • limit integer

      Default value: 50

      Maximum 500

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/mark-kline.html b/zh-TW/api-explorer/v5/market/mark-kline.html index 77e077efc1..0ab08d3621 100644 --- a/zh-TW/api-explorer/v5/market/mark-kline.html +++ b/zh-TW/api-explorer/v5/market/mark-kline.html @@ -4,13 +4,13 @@ Get Mark Price Kline | Bybit API Documentation - +

    Get Mark Price Kline​

    Get Mark Price Kline data

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, spot]

      Product type

    • symbol string required

      Symbol name

    • interval string[] required

      Possible values: [1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, M, W]

      kline interval

    • start integer

      start timestamp (ms). e.g., 1669852800000 (1 DEC 2022 UTC 0:00)

    • end integer

      end timestamp (ms). e.g., 1671062400000 (15 DEC 2022 UTC 0:00)

    • limit integer

      Default value: 200

      Maximum 1000

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/market.html b/zh-TW/api-explorer/v5/market/market.html index 24d9e601eb..0efcbb849e 100644 --- a/zh-TW/api-explorer/v5/market/market.html +++ b/zh-TW/api-explorer/v5/market/market.html @@ -4,13 +4,13 @@ Market | Bybit API Documentation - +

    Market

    Market endpoints

    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/open-interest.html b/zh-TW/api-explorer/v5/market/open-interest.html index 1a501cfe26..3371936c23 100644 --- a/zh-TW/api-explorer/v5/market/open-interest.html +++ b/zh-TW/api-explorer/v5/market/open-interest.html @@ -4,13 +4,13 @@ Get Open Interest | Bybit API Documentation - +

    Get Open Interest​

    Get open interest

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • intervalTime string[] required

      Possible values: [5min, 15min, 30min, 1h, 4h, 1d]

      interval time

    • startTime integer

      The start timstamp (ms)

    • endTime integer

      The end timstamp (ms)

    • limit integer

      Default value: 50

      Maximum 200

    • cursor string

      pass cursor from the response param "nagePageCursor" to paginate

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/orderbook.html b/zh-TW/api-explorer/v5/market/orderbook.html index 6c742194a4..688dccda6e 100644 --- a/zh-TW/api-explorer/v5/market/orderbook.html +++ b/zh-TW/api-explorer/v5/market/orderbook.html @@ -4,13 +4,13 @@ Get Orderbook | Bybit API Documentation - +

    Get Orderbook​

    Get order book data

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name

    • limit integer

      spot：1-50，default：1. linear&inverse：1-200，default：25. option：1-25，default：1

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/premium-index-kline.html b/zh-TW/api-explorer/v5/market/premium-index-kline.html index 0900422547..09732f2eb6 100644 --- a/zh-TW/api-explorer/v5/market/premium-index-kline.html +++ b/zh-TW/api-explorer/v5/market/premium-index-kline.html @@ -4,13 +4,13 @@ Get Premium Index Price Kline | Bybit API Documentation - +

    Get Premium Index Price Kline​

    Get Premium Index Price Kline data

    Query Parameters
    • category string[] required

      Possible values: [linear]

      Product type

    • symbol string required

      Symbol name

    • interval string[] required

      Possible values: [1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, M, W]

      kline interval

    • start integer

      start timestamp (ms). e.g., 1669852800000 (1 DEC 2022 UTC 0:00)

    • end integer

      end timestamp (ms). e.g., 1671062400000 (15 DEC 2022 UTC 0:00)

    • limit integer

      Default value: 200

      Maximum 1000

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/recent-trade.html b/zh-TW/api-explorer/v5/market/recent-trade.html index a93d1e7b7f..635f441714 100644 --- a/zh-TW/api-explorer/v5/market/recent-trade.html +++ b/zh-TW/api-explorer/v5/market/recent-trade.html @@ -4,13 +4,13 @@ Get Public Recent Trading History | Bybit API Documentation - +

    Get Public Recent Trading History​

    Get public trade

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name.

    • baseCoin string

      Default value: BTC

      Base coin. Valid for option. Default is BTC

    • optionType string

      Possible values: [Call, Put]

      Option type. Valid for option.

    • limit integer

      Maximum 60 for spot. Maximum 1000 for others

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/risk-limit.html b/zh-TW/api-explorer/v5/market/risk-limit.html index 291accd386..c8128e72d4 100644 --- a/zh-TW/api-explorer/v5/market/risk-limit.html +++ b/zh-TW/api-explorer/v5/market/risk-limit.html @@ -4,13 +4,13 @@ Get Risk Limit | Bybit API Documentation - +

    Get Risk Limit​

    Get risk limit

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse]

      Product type

    • symbol string

      Symbol name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/tickers.html b/zh-TW/api-explorer/v5/market/tickers.html index 29e2f95aa0..d80cd638a6 100644 --- a/zh-TW/api-explorer/v5/market/tickers.html +++ b/zh-TW/api-explorer/v5/market/tickers.html @@ -4,13 +4,13 @@ Get Tickers | Bybit API Documentation - +

    Get Tickers​

    Get all latest information of symbols. All parameters are needed for OPTION

    Query Parameters
    • category string[] required

      Possible values: [linear, inverse, option, spot]

      Product type

    • baseCoin string

      for option ONLY, baseCoin or symbol must be passed when query option

    • expDate string

      Expiry date. For option only. Default is all, and the parameter format is 25MAR22.

    • symbol string

      Symbol name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/market/time.html b/zh-TW/api-explorer/v5/market/time.html index 107528c06e..9b0d523a10 100644 --- a/zh-TW/api-explorer/v5/market/time.html +++ b/zh-TW/api-explorer/v5/market/time.html @@ -4,13 +4,13 @@ Get Bybit Server Time | Bybit API Documentation - +

    Get Bybit Server Time​

    Get server time

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/auto-add-margin.html b/zh-TW/api-explorer/v5/position/auto-add-margin.html index 75e9cd5dbe..bf7031c7b9 100644 --- a/zh-TW/api-explorer/v5/position/auto-add-margin.html +++ b/zh-TW/api-explorer/v5/position/auto-add-margin.html @@ -4,13 +4,13 @@ Set Auto Add Margin | Bybit API Documentation - +

    Set Auto Add Margin​

    Set Auto Add Margin

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • autoAddMargin integer required

      0 - turn off, 1 - turn on

    • positionIdx integer required

      Possible values: [0, 1, 2]

      Position index. 0=one-way-mode, 1=buy-hedge-mode, 2=sell-hedege-mode. REQUIRED for hedge-mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/close-pnl.html b/zh-TW/api-explorer/v5/position/close-pnl.html index 2f62c02dd4..aaeb2378c4 100644 --- a/zh-TW/api-explorer/v5/position/close-pnl.html +++ b/zh-TW/api-explorer/v5/position/close-pnl.html @@ -4,13 +4,13 @@ Get Closed PnL | Bybit API Documentation - +

    Get Closed PnL​

    Get closed pnl

    Query Parameters
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string

      Symbol name

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • limit integer

      Default value: 50

      1-200. max 200

    • cursor string

      cursor for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/cross-isolate.html b/zh-TW/api-explorer/v5/position/cross-isolate.html index 335998972f..e79a3b99f5 100644 --- a/zh-TW/api-explorer/v5/position/cross-isolate.html +++ b/zh-TW/api-explorer/v5/position/cross-isolate.html @@ -4,13 +4,13 @@ Switch Cross/Isolated Margin | Bybit API Documentation - +

    Switch Cross/Isolated Margin​

    Select cross margin mode or isolated margin mode

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • tradeMode integer required

      Possible values: [0, 1]

      0 - cross margin, 1 - isolated margin

    • buyLeverage string

      Buy side leverage

    • sellLeverage string

      Sell side leverage

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/execution.html b/zh-TW/api-explorer/v5/position/execution.html index 66632b8042..2e8ccbef50 100644 --- a/zh-TW/api-explorer/v5/position/execution.html +++ b/zh-TW/api-explorer/v5/position/execution.html @@ -4,13 +4,13 @@ Get Execution (2 years) | Bybit API Documentation - +

    Get Execution (2 years)​

    Get execution list

    Query Parameters
    • category string required

      Possible values: [linear, inverse, spot, option]

      Product type

    • symbol string

      Symbol name

    • baseCoin string

      Base coin

    • orderId string
    • orderLinkId string

      User customised order id

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • execType string

      Possible values: [Trade, AdlTrade, Funding, BustTrade, Settle]

      Execution type

    • limit integer

      Default value: 50

      1-100. max 100

    • cursor string

      cursor to pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/leverage.html b/zh-TW/api-explorer/v5/position/leverage.html index a54a404ac9..dedb7b3a91 100644 --- a/zh-TW/api-explorer/v5/position/leverage.html +++ b/zh-TW/api-explorer/v5/position/leverage.html @@ -4,13 +4,13 @@ Set Leverage | Bybit API Documentation - +

    Set Leverage​

    Set levearage.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • buyLeverage string

      Buy side leverage

    • sellLeverage string

      Sell side leverage

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/manual-add-margin.html b/zh-TW/api-explorer/v5/position/manual-add-margin.html index e32547401a..5c227d502f 100644 --- a/zh-TW/api-explorer/v5/position/manual-add-margin.html +++ b/zh-TW/api-explorer/v5/position/manual-add-margin.html @@ -4,13 +4,13 @@ Add Or Reduce Margin | Bybit API Documentation - +

    Add Or Reduce Margin​

    Manually add or reduce margin for isolated margin position

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • margin string required

      10 - add, -10 - reduce

    • positionIdx integer required

      Possible values: [0, 1, 2]

      Position index. 0=one-way-mode, 1=buy-hedge-mode, 2=sell-hedege-mode. REQUIRED for hedge-mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/position-info.html b/zh-TW/api-explorer/v5/position/position-info.html index 1b3ed29daf..54a9452df3 100644 --- a/zh-TW/api-explorer/v5/position/position-info.html +++ b/zh-TW/api-explorer/v5/position/position-info.html @@ -4,13 +4,13 @@ Get Position Info | Bybit API Documentation - +

    Get Position Info​

    Get Position Info

    Query Parameters
    • category string required

      Possible values: [linear, inverse, option]

      Product type

    • symbol string

      Symbol name

    • baseCoin string

      Base coin. For option only

    • settleCoin string

      Used for linear & inverse, symbol or settleCoin is required

    • limit integer

      Default value: 20

      1-200. max 200

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/position-mode.html b/zh-TW/api-explorer/v5/position/position-mode.html index 7d3468170f..c59f413b6e 100644 --- a/zh-TW/api-explorer/v5/position/position-mode.html +++ b/zh-TW/api-explorer/v5/position/position-mode.html @@ -4,13 +4,13 @@ Switch Position Mode | Bybit API Documentation - +

    Switch Position Mode​

    Switch Position Mode

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string

      Symbol name

    • coin string

      Coin name

    • mode integer required

      Possible values: [0, 3]

      Position mode. 0 - Merged single, 3 - Both sides

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/position.html b/zh-TW/api-explorer/v5/position/position.html index 3561826a54..38fa546b84 100644 --- a/zh-TW/api-explorer/v5/position/position.html +++ b/zh-TW/api-explorer/v5/position/position.html @@ -4,13 +4,13 @@ Position | Bybit API Documentation - +

    Position

    All Position v5 REST API.

    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/set-risk-limit.html b/zh-TW/api-explorer/v5/position/set-risk-limit.html index 0e4b405f45..aa0d65d03f 100644 --- a/zh-TW/api-explorer/v5/position/set-risk-limit.html +++ b/zh-TW/api-explorer/v5/position/set-risk-limit.html @@ -4,13 +4,13 @@ Set Risk Limit | Bybit API Documentation - +

    Set Risk Limit​

    Set risk limit.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • riskId integer required

      Risk limit id

    • positionIdx integer

      Possible values: [0, 1, 2]

      Position index. 0=one-way-mode, 1=buy-hedge-mode, 2=sell-hedege-mode. REQUIRED for hedge-mode

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/tpsl-mode.html b/zh-TW/api-explorer/v5/position/tpsl-mode.html index ee49050e2e..9b63737404 100644 --- a/zh-TW/api-explorer/v5/position/tpsl-mode.html +++ b/zh-TW/api-explorer/v5/position/tpsl-mode.html @@ -4,13 +4,13 @@ Set TP/SL Mode | Bybit API Documentation - +

    Set TP/SL Mode​

    Set tp/sl mode.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • tpSlMode string required

      Possible values: [Full, Partial]

      Full = full position TP/SL, Partial = partial mode tp/sl

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/position/trading-stop.html b/zh-TW/api-explorer/v5/position/trading-stop.html index bec95731c7..27f9c11884 100644 --- a/zh-TW/api-explorer/v5/position/trading-stop.html +++ b/zh-TW/api-explorer/v5/position/trading-stop.html @@ -4,13 +4,13 @@ Set Trading Stop | Bybit API Documentation - +

    Set Trading Stop​

    Set trade stop.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse]

      Product type

    • symbol string required

      Symbol name

    • takeProfit string

      Take profit price

    • stopLoss string

      Stop loss price

    • tpSize string

      Take profit size

    • slSize string

      Stop loss size

    • tpTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Take profit trigger price type

    • slTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Stop loss trigger price type

    • trailingStop string

      Trailing stop

    • activePrice string

      Trailing stop trigger price

    • positionIdx integer required

      Possible values: [0, 1, 2]

      Position index. 0=one-way-mode, 1=buy-hedge-mode, 2=sell-hedege-mode. REQUIRED for hedge-mode

    • tpLimitPrice string

      The limit order price when take profit price is triggered

    • slLimitPrice string

      The limit order price when stop loss price is triggered

    • tpOrderType string

      Possible values: [Market, Limit]

      The order type when take profit is triggered

    • slOrderType string

      Possible values: [Market, Limit]

      The order type when stop loss is triggered

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/account-info.html b/zh-TW/api-explorer/v5/spot-margin-normal/account-info.html index 5bb58cab5f..304a184c82 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/account-info.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/account-info.html @@ -4,13 +4,13 @@ Get Loan Account Info | Bybit API Documentation - +

    Get Loan Account Info​

    Get Loan Account Info

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/borrow-order.html b/zh-TW/api-explorer/v5/spot-margin-normal/borrow-order.html index 1a59b46f42..7877aacf5c 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/borrow-order.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/borrow-order.html @@ -4,13 +4,13 @@ Get Borrow Order Detail | Bybit API Documentation - +

    Get Borrow Order Detail​

    Get Borrow Order Detail

    Query Parameters
    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • coin string

      Coin name

    • status string

      Possible values: [0, 1, 2]

      Status filter. 0：get all kinds of status, 1：uncleared, 2：cleared

    • limit integer

      Limit for data size per page. 1 - 500. Default：500

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/borrow.html b/zh-TW/api-explorer/v5/spot-margin-normal/borrow.html index 4693c2935a..66756d5a50 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/borrow.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/borrow.html @@ -4,13 +4,13 @@ Borrow | Bybit API Documentation - +

    Borrow​

    Borrow

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Request Body
    • coin string

      Coin name

    • qty string

      Amount to borrow

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/borrowable-data.html b/zh-TW/api-explorer/v5/spot-margin-normal/borrowable-data.html index bcfca6140a..4fa517666c 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/borrowable-data.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/borrowable-data.html @@ -4,13 +4,13 @@ Get Borrowable Coin Info | Bybit API Documentation - +

    Get Borrowable Coin Info​

    Get Borrowable Coin Info

    Query Parameters
    • coin string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/interest-quota.html b/zh-TW/api-explorer/v5/spot-margin-normal/interest-quota.html index db09500ece..705fa1a94b 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/interest-quota.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/interest-quota.html @@ -4,13 +4,13 @@ Get Interest & Quota | Bybit API Documentation - +

    Get Interest & Quota​

    Get Interest & Quota

    Query Parameters
    • coin string required

      Coin name

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/margin-data.html b/zh-TW/api-explorer/v5/spot-margin-normal/margin-data.html index fd38ca9db1..57428ebc73 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/margin-data.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/margin-data.html @@ -4,13 +4,13 @@ Get Margin Coin Info | Bybit API Documentation - +

    Get Margin Coin Info​

    Get Margin Coin Info

    Query Parameters
    • coin string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/normal-margin-trade.html b/zh-TW/api-explorer/v5/spot-margin-normal/normal-margin-trade.html index 847493e844..479d831fe7 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/normal-margin-trade.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/normal-margin-trade.html @@ -4,13 +4,13 @@ Spot Margin Trade (Classic) | Bybit API Documentation - +

    Spot Margin Trade (Classic)

    Spot margin trade (Classic) endpoints

    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/repay-order.html b/zh-TW/api-explorer/v5/spot-margin-normal/repay-order.html index 98c0677d53..2765fa8951 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/repay-order.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/repay-order.html @@ -4,13 +4,13 @@ Get Repayment Order Detail | Bybit API Documentation - +

    Get Repayment Order Detail​

    Get Repayment Order Detail

    Query Parameters
    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • coin string

      Coin name

    • limit integer

      Limit for data size per page. 1 - 500. Default：500

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/repay.html b/zh-TW/api-explorer/v5/spot-margin-normal/repay.html index fb9c3724d4..c497e05963 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/repay.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/repay.html @@ -4,13 +4,13 @@ Repay | Bybit API Documentation - +

    Repay​

    Repay

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Request Body
    • coin string

      Coin name

    • qty string

      Amount to repay

    • completeRepayment integer

      Possible values: [0, 1]

      Whether to pay off all debts. 0：false, 1：true

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/switch-mode.html b/zh-TW/api-explorer/v5/spot-margin-normal/switch-mode.html index 99c04177e8..ea3d63ca58 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/switch-mode.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/switch-mode.html @@ -4,13 +4,13 @@ Toggle Margin Trade | Bybit API Documentation - +

    Toggle Margin Trade​

    Toggle Margin Trade

    Header Parameters
    • apiKey string required

      Please use normal mode account API KEY

    • secret string required

      Please use normal mode account API SECRET

    Request Body
    • switch integer

      1：on, 0：off

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-normal/vip-margin.html b/zh-TW/api-explorer/v5/spot-margin-normal/vip-margin.html index 715f18ea8e..93d2bd4722 100644 --- a/zh-TW/api-explorer/v5/spot-margin-normal/vip-margin.html +++ b/zh-TW/api-explorer/v5/spot-margin-normal/vip-margin.html @@ -4,13 +4,13 @@ Get VIP Margin Data | Bybit API Documentation - +

    Get VIP Margin Data​

    Get vip margin data

    Query Parameters
    • vipLevel string[]

      Possible values: [No VIP, VIP-1, VIP-2, VIP-3, VIP-4, VIP-5, PRO-1, PRO-2, PRO-3, PRO-4, PRO-5]

      VIP level

    • currency string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-uta/set-leverage.html b/zh-TW/api-explorer/v5/spot-margin-uta/set-leverage.html index 14789bd7fe..a261662255 100644 --- a/zh-TW/api-explorer/v5/spot-margin-uta/set-leverage.html +++ b/zh-TW/api-explorer/v5/spot-margin-uta/set-leverage.html @@ -4,13 +4,13 @@ Set Leverage | Bybit API Documentation - +

    Set Leverage​

    Set leverage for margin trade

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • leverage integer

      Possible values: [2, 3, 4, 5, 6, 7, 8, 9, 10]

      Levearge, support 2-10

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-uta/status.html b/zh-TW/api-explorer/v5/spot-margin-uta/status.html index 384ef6303c..2d4c4ccd9c 100644 --- a/zh-TW/api-explorer/v5/spot-margin-uta/status.html +++ b/zh-TW/api-explorer/v5/spot-margin-uta/status.html @@ -4,13 +4,13 @@ Get Status And Leverage | Bybit API Documentation - +

    Get Status And Leverage​

    Get status and leverage

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-uta/switch-mode.html b/zh-TW/api-explorer/v5/spot-margin-uta/switch-mode.html index 291e4beb6d..e96a09189e 100644 --- a/zh-TW/api-explorer/v5/spot-margin-uta/switch-mode.html +++ b/zh-TW/api-explorer/v5/spot-margin-uta/switch-mode.html @@ -4,13 +4,13 @@ Toggle Margin Trade | Bybit API Documentation - +

    Toggle Margin Trade​

    Toggle margin trade

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • spotMarginMode integer

      Possible values: [0, 1]

      Margin mode. 0=off, 1=on

    • required
    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-uta/uta-margin-trade.html b/zh-TW/api-explorer/v5/spot-margin-uta/uta-margin-trade.html index 9983fa0a1b..d4df9006bb 100644 --- a/zh-TW/api-explorer/v5/spot-margin-uta/uta-margin-trade.html +++ b/zh-TW/api-explorer/v5/spot-margin-uta/uta-margin-trade.html @@ -4,13 +4,13 @@ Spot Margin Trade (UTA) | Bybit API Documentation - +
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/spot-margin-uta/vip-margin.html b/zh-TW/api-explorer/v5/spot-margin-uta/vip-margin.html index 2a7720987a..a62f8b9dfe 100644 --- a/zh-TW/api-explorer/v5/spot-margin-uta/vip-margin.html +++ b/zh-TW/api-explorer/v5/spot-margin-uta/vip-margin.html @@ -4,13 +4,13 @@ Get VIP Margin Data | Bybit API Documentation - +

    Get VIP Margin Data​

    Get vip margin data

    Query Parameters
    • vipLevel string[]

      Possible values: [No VIP, VIP-1, VIP-2, VIP-3, VIP-4, VIP-5, PRO-1, PRO-2, PRO-3, PRO-4, PRO-5]

      VIP level

    • currency string

      Coin name

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/amend-order.html b/zh-TW/api-explorer/v5/trade/amend-order.html index 8aed744ddb..d545f73807 100644 --- a/zh-TW/api-explorer/v5/trade/amend-order.html +++ b/zh-TW/api-explorer/v5/trade/amend-order.html @@ -4,13 +4,13 @@ Amend Order | Bybit API Documentation - +

    Amend Order​

    Amend an order.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name

    • orderId string

      Either orderId or orderLinkId is required

    • orderLinkId string

      Either orderId or orderLinkId is required

    • qty string

      Modify the order qty

    • price string

      Modify the order price

    • orderIv string

      Modify option order iv

    • triggerPrice string

      Modify StopOrder trigger price

    • tpslMode string

      Possible values: [Full, Partial]

      Full：TPSL for full size, Partial：TPSL for partial size

    • takeProfit string

      Modify take profit price

    • stopLoss string

      Modify stop loss price

    • triggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Modify the type of trigger price

    • tpTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Modify trigger take profit price price type

    • slTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Modify trigger stop loss price price type

    • tpLimitPrice string

      The limit order price when take profit price is triggered

    • slLimitPrice string

      The limit order price when stop loss price is triggered

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/batch-amend.html b/zh-TW/api-explorer/v5/trade/batch-amend.html index 19dd8cceb8..88bd9d195f 100644 --- a/zh-TW/api-explorer/v5/trade/batch-amend.html +++ b/zh-TW/api-explorer/v5/trade/batch-amend.html @@ -4,13 +4,13 @@ Batch Amend Order | Bybit API Documentation - +

    Batch Amend Order​

    Batch amend orders

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [option, linear]

      Product type

    • request object[] required

      Possible values: <= 10

    • symbol string required

      Symbol name

    • orderId string

      Either orderId or orderLinkId is required

    • orderLinkId string

      Either orderId or orderLinkId is required

    • qty string

      Modify the order qty

    • price string

      Modify the order price

    • orderIv string

      Modify option order iv

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/batch-cancel.html b/zh-TW/api-explorer/v5/trade/batch-cancel.html index feabcec498..c6b7228f88 100644 --- a/zh-TW/api-explorer/v5/trade/batch-cancel.html +++ b/zh-TW/api-explorer/v5/trade/batch-cancel.html @@ -4,13 +4,13 @@ Batch Cancel Order | Bybit API Documentation - +

    Batch Cancel Order​

    Batch cancel orders

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [option, linear]

      Product type

    • request object[] required

      Possible values: <= 10

    • symbol string required

      Symbol name

    • orderId string

      Either orderId or orderLinkId is required

    • orderLinkId string

      Either orderId or orderLinkId is required

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/batch-place.html b/zh-TW/api-explorer/v5/trade/batch-place.html index 1c670c7f24..46ccbd7084 100644 --- a/zh-TW/api-explorer/v5/trade/batch-place.html +++ b/zh-TW/api-explorer/v5/trade/batch-place.html @@ -4,13 +4,13 @@ Batch Place Order | Bybit API Documentation - +

    Batch Place Order​

    Batch place orders

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [option, linear]

      Product type. linear, option

    • request object[] required

      Possible values: <= 10

    • symbol string required

      Symbol name

    • side string required

      Possible values: [Buy, Sell]

    • orderType string required

      Possible values: [Market, Limit]

      Order type

    • qty string required
    • price string
    • orderIv string
    • timeInForce string required

      Possible values: [GTC, IOC, FOK, PostOnly]

      Time in force

    • positionIdx integer

      Possible values: [0]

      Position mode. one-way mode only for unified.

    • orderLinkId string required

      REQUIRED param when place an option order

    • reduceOnly boolean

      Possible values: [true, false]

      specify true if a close position order

    • mmp boolean

      Possible values: [true, false]

      enable market marker protection

    • smpType string

      Possible values: [None, CancelMaker, CancelTaker, CancelBoth]

      Smp execution type

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/cancel-all.html b/zh-TW/api-explorer/v5/trade/cancel-all.html index 06dd1503a1..b123c56815 100644 --- a/zh-TW/api-explorer/v5/trade/cancel-all.html +++ b/zh-TW/api-explorer/v5/trade/cancel-all.html @@ -4,13 +4,13 @@ Cancel All Orders | Bybit API Documentation - +

    Cancel All Orders​

    Cancel all orders.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string

      Symbol name. Required if not passing baseCoin or settleCoin

    • baseCoin string

      Cancel by base coin. Required if not passing symbol or settleCoin

    • settleCoin string

      Cancel by settle coin. Does not support spot. Required if not passing symbol or baseCoin

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/cancel-order.html b/zh-TW/api-explorer/v5/trade/cancel-order.html index 9151dcbcf3..edddcff5e6 100644 --- a/zh-TW/api-explorer/v5/trade/cancel-order.html +++ b/zh-TW/api-explorer/v5/trade/cancel-order.html @@ -4,13 +4,13 @@ Cancel Order | Bybit API Documentation - +

    Cancel Order​

    Cancel a single order.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name

    • orderId string

      Either orderId or orderLinkId is required

    • orderLinkId string

      Either orderId or orderLinkId is required

    • orderFilter string

      Possible values: [Order, tpslOrder, StopOrder]

      Default value: Order

      Take profit stop loss or ordinary order. Only valid for spot.

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/create-order.html b/zh-TW/api-explorer/v5/trade/create-order.html index d818e62203..2a3fa7fcab 100644 --- a/zh-TW/api-explorer/v5/trade/create-order.html +++ b/zh-TW/api-explorer/v5/trade/create-order.html @@ -4,13 +4,13 @@ Place Order | Bybit API Documentation - +

    Place Order​

    Place an order.

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Request Body
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string required

      Symbol name

    • isLeverage integer

      Possible values: [0, 1]

      Whether to loan, only for spot. 0:No;1:Yes.

    • side string required

      Possible values: [Buy, Sell]

    • orderType string required

      Possible values: [Market, Limit]

      Order type

    • qty string required

      Order qty

    • price string

      ignore it if Market order

    • triggerPrice string

      param for StopOrder

    • triggerDirection integer

      param for StopOrder. 1=rise, 2=fall

    • triggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      param for StopOrder

    • orderFilter string

      Possible values: [Order, tpslOrder, StopOrder]

      Default value: Order

      Take profit stop loss, normal order or conditional order. Only valid for spot.

    • orderIv string

      Implied volatility. param for option order

    • timeInForce string

      Possible values: [GTC, IOC, FOK, PostOnly]

      Time in force

    • positionIdx integer

      Possible values: [0, 1, 2]

      0=one-way mode, 1=buy-hedge-mode, 2=sell-hedge-mode

    • orderLinkId string

      required param for option order

    • takeProfit string

      Take profit price

    • stopLoss string

      Stop loss price

    • tpTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Trigger take profit price price type

    • slTriggerBy string

      Possible values: [LastPrice, MarkPrice, IndexPrice]

      Trigger stop loss price price type

    • reduceOnly boolean

      Possible values: [true, false]

      specify true if a close position order

    • closeOnTrigger boolean

      Possible values: [true, false]

      close on trigger

    • smpType string

      Possible values: [None, CancelMaker, CancelTaker, CancelBoth]

      Smp execution type

    • mmp boolean

      Possible values: [true, false]

      market marker protection. for option order

    • tpslMode string

      Possible values: [Full, Partial]

      TP/SL mode

    • tpLimitPrice string

      The limit order price when take profit price is triggered

    • slLimitPrice string

      The limit order price when stop loss price is triggered

    • tpOrderType string

      Possible values: [Market, Limit]

      The order type when take profit is triggered

    • slOrderType string

      Possible values: [Market, Limit]

      The order type when stop loss is triggered

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/open-order.html b/zh-TW/api-explorer/v5/trade/open-order.html index 9a72a64f6b..c7703bd827 100644 --- a/zh-TW/api-explorer/v5/trade/open-order.html +++ b/zh-TW/api-explorer/v5/trade/open-order.html @@ -4,13 +4,13 @@ Get Open Orders (real-time) | Bybit API Documentation - +

    Get Open Orders (real-time)​

    Get unfilled orders or partially filled orders

    Query Parameters
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string

      Symbol name

    • baseCoin string

      Base coin

    • settleCoin string

      Settle coin. Spot is not available

    • orderId string
    • orderLinkId string

      User customised order id

    • orderFilter string

      Possible values: [Order, StopOrder, tpslOrder]

      Order filter. Default：all kinds of orders

    • openOnly integer

      Possible values: [0, 1, 2]

      Whether to only query active orders, if openOnly = 0, only get active orders. If it is 1, return only the order data of the final status (cancelled/rejected/completely filled, etc.) in the last 10 minutes

    • limit integer

      Default value: 20

      1-50. max 50

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/order-list.html b/zh-TW/api-explorer/v5/trade/order-list.html index 8360973f6f..4d214383cd 100644 --- a/zh-TW/api-explorer/v5/trade/order-list.html +++ b/zh-TW/api-explorer/v5/trade/order-list.html @@ -4,13 +4,13 @@ Get Order History (2 years) | Bybit API Documentation - +

    Get Order History (2 years)​

    Get order history.

    Query Parameters
    • category string required

      Possible values: [linear, inverse, option, spot]

      Product type

    • symbol string

      Symbol name

    • baseCoin string

      Base coin

    • orderId string
    • orderLinkId string

      User customised order id

    • startTime integer

      The start timestamp (ms)

    • endTime integer

      The end timestamp (ms)

    • orderStatus string

      Possible values: [Created, New, Rejected, PartiallyFilled, PartillyFilledCancelled, Filled, PendingCancel, Cancelled, Untriggered, Triggered, Deactivated, Active]

      Order status

    • orderFilter string

      Possible values: [Order, StopOrder, tpslOrder]

      Order filter

    • limit integer

      Default value: 20

      1-50. max 50

    • cursor string

      cursor to pagnition

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/query-spot-quota.html b/zh-TW/api-explorer/v5/trade/query-spot-quota.html index f4773461d5..a002cedb80 100644 --- a/zh-TW/api-explorer/v5/trade/query-spot-quota.html +++ b/zh-TW/api-explorer/v5/trade/query-spot-quota.html @@ -4,13 +4,13 @@ Get Borrow Quota (Spot) | Bybit API Documentation - +

    Get Borrow Quota (Spot)​

    Query user's spot available quota

    Query Parameters
    • category string required

      Possible values: [spot]

      Product type

    • symbol string required

      Symbol name

    • side string required

      Possible values: [Buy, Sell]

      Buy or Sell

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/trade/trade.html b/zh-TW/api-explorer/v5/trade/trade.html index 2cb5217f24..70d1c7edc0 100644 --- a/zh-TW/api-explorer/v5/trade/trade.html +++ b/zh-TW/api-explorer/v5/trade/trade.html @@ -4,13 +4,13 @@ Trade | Bybit API Documentation - +

    Trade

    All trade v5 REST API.

    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/user/affiliate-info.html b/zh-TW/api-explorer/v5/user/affiliate-info.html index 697e9dca5c..9754b9ac03 100644 --- a/zh-TW/api-explorer/v5/user/affiliate-info.html +++ b/zh-TW/api-explorer/v5/user/affiliate-info.html @@ -4,13 +4,13 @@ Get Affiliate User Info | Bybit API Documentation - +

    Get Affiliate User Info​

    Get affiliate user info

    Query Parameters
    • uid string required

      The main UID of referral

    Header Parameters
    • apiKey string

      Please use the key with "Affiliate" permission

    • secret string

      Please use the key with "Affiliate" permission

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/user/apikey-info.html b/zh-TW/api-explorer/v5/user/apikey-info.html index 34848845b3..d84e075751 100644 --- a/zh-TW/api-explorer/v5/user/apikey-info.html +++ b/zh-TW/api-explorer/v5/user/apikey-info.html @@ -4,13 +4,13 @@ Get API Key Information | Bybit API Documentation - +

    Get API Key Information​

    Get API Key Information

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/user/list-sub-apikeys.html b/zh-TW/api-explorer/v5/user/list-sub-apikeys.html index a19de76f58..5e1e146190 100644 --- a/zh-TW/api-explorer/v5/user/list-sub-apikeys.html +++ b/zh-TW/api-explorer/v5/user/list-sub-apikeys.html @@ -4,13 +4,13 @@ Get Sub Account All API Keys | Bybit API Documentation - +

    Get Sub Account All API Keys​

    Get Sub Account All API Keys

    Query Parameters
    • subMemberId string required

      Sub UID

    • limit integer

      Default value: 20

      1-20. max 20

    • cursor string

      cursor, used for pagination

    Header Parameters
    • apiKey string required

      Please use main account API key

    • secret string required

      Please use main account secret key

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/user/user.html b/zh-TW/api-explorer/v5/user/user.html index 9446a1e1be..500570a388 100644 --- a/zh-TW/api-explorer/v5/user/user.html +++ b/zh-TW/api-explorer/v5/user/user.html @@ -4,13 +4,13 @@ User | Bybit API Documentation - +
    - + \ No newline at end of file diff --git a/zh-TW/api-explorer/v5/user/wallet-type.html b/zh-TW/api-explorer/v5/user/wallet-type.html index a81f03b18d..dc73df5937 100644 --- a/zh-TW/api-explorer/v5/user/wallet-type.html +++ b/zh-TW/api-explorer/v5/user/wallet-type.html @@ -4,13 +4,13 @@ Get UID Wallet Type | Bybit API Documentation - +

    Get UID Wallet Type​

    Get uid wallet type

    Query Parameters
    • memberIds string

      Main UID or Sub UIDs

    Header Parameters
    • apiKey string

      A UTA sub account API key is provided by default

    • secret string

      A UTA sub account API key is provided by default

    Responses

    successful operation

    Loading...
    - + \ No newline at end of file diff --git a/zh-TW/assets/js/3b83c135.7aa5038a.js b/zh-TW/assets/js/3b83c135.7aa5038a.js deleted file mode 100644 index 803e0009c3..0000000000 --- a/zh-TW/assets/js/3b83c135.7aa5038a.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[82946],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>u});var r=n(67294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=r.createContext({}),c=function(e){var t=r.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},d=function(e){var t=c(e.components);return r.createElement(p.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,p=e.parentName,d=l(e,["components","mdxType","originalType","parentName"]),m=c(n),u=a,k=m["".concat(p,".").concat(u)]||m[u]||s[u]||i;return n?r.createElement(k,o(o({ref:t},d),{},{components:n})):r.createElement(k,o({ref:t},d))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=m;var l={};for(var p in t)hasOwnProperty.call(t,p)&&(l[p]=t[p]);l.originalType=e,l.mdxType="string"==typeof e?e:a,o[1]=l;for(var c=2;c{n.r(t),n.d(t,{assets:()=>p,contentTitle:()=>o,default:()=>k,frontMatter:()=>i,metadata:()=>l,toc:()=>c});var r=n(87462),a=(n(67294),n(3905));const i={title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",sidebar_label:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593 (\u671f\u6b0a)",sidebar_position:11},o=void 0,l={unversionedId:"v5/order/dcp",id:"v5/order/dcp",title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",description:"\u8986\u84cb\u7bc4\u570d: \u5408\u7d04 / \u73fe\u8ca8 / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236)",source:"@site/i18n/zh-TW/docusaurus-plugin-content-docs/current/v5/order/dcp.mdx",sourceDirName:"v5/order",slug:"/v5/order/dcp",permalink:"/docs/zh-TW/v5/order/dcp",draft:!1,tags:[],version:"current",sidebarPosition:11,frontMatter:{title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",sidebar_label:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593 (\u671f\u6b0a)",sidebar_position:11},sidebar:"v5SideBar",previous:{title:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",permalink:"/docs/zh-TW/v5/order/spot-borrow-quota"},next:{title:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",permalink:"/docs/zh-TW/v5/position/"}},p={},c=[{value:"HTTP\u8acb\u6c42",id:"http\u8acb\u6c42",level:3},{value:"\u8acb\u6c42\u53c3\u6578",id:"\u8acb\u6c42\u53c3\u6578",level:3},{value:"\u97ff\u61c9\u53c3\u6578",id:"\u97ff\u61c9\u53c3\u6578",level:3},{value:"\u8acb\u6c42\u793a\u4f8b",id:"\u8acb\u6c42\u793a\u4f8b",level:3},{value:"\u97ff\u61c9\u793a\u4f8b",id:"\u97ff\u61c9\u793a\u4f8b",level:3}],d=e=>function(t){return console.warn("Component "+e+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",t)},s=d("Tabs"),m=d("TabItem"),u={toc:c};function k(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,r.Z)({},u,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"\u8986\u84cb\u7bc4\u570d: \u5408\u7d04 / \u73fe\u8ca8 / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236)"))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("h2",{parentName:"admonition",id:"\u4ec0\u9ebc\u662f\u65b7\u7dda\u4fdd\u8b77-disconnection-protect"},"\u4ec0\u9ebc\u662f\u65b7\u7dda\u4fdd\u8b77 (Disconnection Protect)?"),(0,a.kt)("p",{parentName:"admonition"},"Bybit\u57fa\u65bcwebsocket\u79c1\u6709\u9023\u63a5\u548c\u5fc3\u8df3\u6a5f\u5236\uff0c\u63d0\u4f9b\u65b7\u7dda\u4fdd\u8b77\u529f\u80fd\u3002\u9019\u8a08\u6642\u5f9e\u7b2c\u4e00\u6b21\u65b7\u958b\u958b\u59cb\u3002\u5982\u679cBybit\u670d\u52d9\u5668\u5728\u4e00\u6bb5\u6642\u9593\u5167\u6c92\u6709\u6536\u5230\u5ba2\u6236\u7aef\u7684\u91cd\u9023\u8d85\u904e10\u79d2\uff08\u9ed8\u8a8d\uff09\u4e26\n\u6062\u5fa9\u5fc3\u8df3\u201cping\u201d\uff0c\u5247\u5ba2\u6236\u7aef\u8655\u65bc\u201c\u65b7\u7dda\u4fdd\u8b77\u201d\u72c0\u614b\uff0c\u5ba2\u6236\u6240\u6709\u6d3b\u8e8d\u7684",(0,a.kt)("strong",{parentName:"p"},"\u5408\u7d04 / \u73fe\u8ca8 / \u671f\u6b0a"),"\u8a02\u55ae\u5c07\u81ea\u52d5\u53d6\u6d88\u3002\u5982\u679c\u5728 10 \u79d2\u5167\uff0c\u5ba2\u6236\u7aef\u91cd\u65b0\u9023\u63a5\u4e26\u6062\u5fa9\u5fc3\u8df3\u201cping\u201d\uff0c\u8a08\u6642\u6703\u5728\u4e0b\u6b21\u65b7\u7dda\n\u6642\u91cd\u7f6e\u4e26\u91cd\u65b0\u958b\u59cb\u3002"),(0,a.kt)("h2",{parentName:"admonition",id:"\u5982\u4f55\u555f\u7528\u65b7\u7dda\u4fdd\u8b77"},"\u5982\u4f55\u555f\u7528\u65b7\u7dda\u4fdd\u8b77"),(0,a.kt)("p",{parentName:"admonition"},"\u82e5\u60a8\u9700\u8981\u958b\u555f/\u95dc\u9589\u65b7\u7dda\u4fdd\u8b77\u529f\u80fd, \u60a8\u53ef\u4ee5\u8aee\u8a62\u5ba2\u6236\u7d93\u7406. \u958b\u555f\u5f8c\uff0c\u9ed8\u8a8d\u7684\u65b7\u7dda\u4fdd\u8b77\u6642\u9593\u70ba10\u79d2\u3002"),(0,a.kt)("h2",{parentName:"admonition",id:"\u9069\u7528\u5c0d\u8c61"},"\u9069\u7528\u5c0d\u8c61"),(0,a.kt)("p",{parentName:"admonition"},"\u50c5\u9069\u7528\u65bc",(0,a.kt)("strong",{parentName:"p"},"USDT\u6c38\u7e8c / USDC\u6c38\u7e8c / USDC\u4ea4\u5272 / \u73fe\u8ca8 / \u671f\u6b0a"),"\u4ea4\u6613\u3002")),(0,a.kt)("admonition",{type:"tip"},(0,a.kt)("p",{parentName:"admonition"},"API\u8acb\u6c42\u767c\u9001\u6210\u529f\u5f8c\uff0c\u7cfb\u7d71\u9700\u8981\u4e00\u5b9a\u7684\u6642\u9593\u624d\u80fd\u751f\u6548\u3002\u5efa\u8b7010\u79d2\u5f8c\u518d\u67e5\u8a62\u6216\u8a2d\u7f6e\u3002")),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"\u60a8\u53ef\u4ee5\u4f7f\u7528\u8a72",(0,a.kt)("a",{parentName:"li",href:"/v5/account/account-info"},"\u63a5\u53e3"),"\u4f86\u67e5\u8a62\u7576\u524dDCP\u914d\u7f6e"),(0,a.kt)("li",{parentName:"ul"},"\u60a8\u7684\u79c1\u6709\u9023\u63a5",(0,a.kt)("strong",{parentName:"li"},"\u5fc5\u9808"),"\u8a02\u95b1",(0,a.kt)("a",{parentName:"li",href:"../websocket/private/dcp"},"\u65b7\u7dda\u4fdd\u8b77"),", \u624d\u80fd\u78ba\u4fddDCP\u529f\u80fd\u88ab\u89f8\u767c")),(0,a.kt)("h3",{id:"http\u8acb\u6c42"},"HTTP\u8acb\u6c42"),(0,a.kt)("p",null,"POST ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/disconnected-cancel-all")),(0,a.kt)("h3",{id:"\u8acb\u6c42\u53c3\u6578"},"\u8acb\u6c42\u53c3\u6578"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u662f\u5426\u5fc5\u9700"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,a.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"product"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("inlineCode",{parentName:"td"},"OPTIONS"),"(\u9ed8\u8a8d), ",(0,a.kt)("inlineCode",{parentName:"td"},"DERIVATIVES"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"SPOT"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"timeWindow"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"\u65b7\u7dda\u4fdd\u8b77\u6642\u9593\u7a97\u53e3. ","[",(0,a.kt)("inlineCode",{parentName:"td"},"3"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"300"),"]",", \u55ae\u4f4d: \u79d2")))),(0,a.kt)("h3",{id:"\u97ff\u61c9\u53c3\u6578"},"\u97ff\u61c9\u53c3\u6578"),(0,a.kt)("p",null,"\u7121"),(0,a.kt)("h3",{id:"\u8acb\u6c42\u793a\u4f8b"},"\u8acb\u6c42\u793a\u4f8b"),(0,a.kt)(s,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(m,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},'POST v5/order/disconnected-cancel-all HTTP/1.1\nHost: api.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1675852742375\nX-BAPI-RECV-WINDOW: 50000\nContent-Type: application/json\n\n{\n "timeWindow": 40\n}\n'))),(0,a.kt)(m,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.set_dcp(\n timeWindow=40,\n))\n'))),(0,a.kt)(m,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar setDcpOptionsRequest = TradeOrderRequest.builder().timeWindow(40).build();\nSystem.out.println(client.setDisconnectCancelAllTime(setDcpOptionsRequest));\n'))),(0,a.kt)(m,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .setDisconnectCancelAllWindow('option', 40)\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"\u97ff\u61c9\u793a\u4f8b"},"\u97ff\u61c9\u793a\u4f8b"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "success"\n}\n')))}k.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/3b83c135.beb24b95.js b/zh-TW/assets/js/3b83c135.beb24b95.js new file mode 100644 index 0000000000..56cf239046 --- /dev/null +++ b/zh-TW/assets/js/3b83c135.beb24b95.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[82946],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>u});var r=n(67294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=r.createContext({}),c=function(e){var t=r.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},d=function(e){var t=c(e.components);return r.createElement(p.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,p=e.parentName,d=l(e,["components","mdxType","originalType","parentName"]),m=c(n),u=a,k=m["".concat(p,".").concat(u)]||m[u]||s[u]||i;return n?r.createElement(k,o(o({ref:t},d),{},{components:n})):r.createElement(k,o({ref:t},d))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=m;var l={};for(var p in t)hasOwnProperty.call(t,p)&&(l[p]=t[p]);l.originalType=e,l.mdxType="string"==typeof e?e:a,o[1]=l;for(var c=2;c{n.r(t),n.d(t,{assets:()=>p,contentTitle:()=>o,default:()=>k,frontMatter:()=>i,metadata:()=>l,toc:()=>c});var r=n(87462),a=(n(67294),n(3905));const i={title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",sidebar_label:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",sidebar_position:11},o=void 0,l={unversionedId:"v5/order/dcp",id:"v5/order/dcp",title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",description:"\u8986\u84cb\u7bc4\u570d: \u5408\u7d04 / \u73fe\u8ca8 / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236)",source:"@site/i18n/zh-TW/docusaurus-plugin-content-docs/current/v5/order/dcp.mdx",sourceDirName:"v5/order",slug:"/v5/order/dcp",permalink:"/docs/zh-TW/v5/order/dcp",draft:!1,tags:[],version:"current",sidebarPosition:11,frontMatter:{title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",sidebar_label:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",sidebar_position:11},sidebar:"v5SideBar",previous:{title:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",permalink:"/docs/zh-TW/v5/order/spot-borrow-quota"},next:{title:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",permalink:"/docs/zh-TW/v5/position/"}},p={},c=[{value:"HTTP\u8acb\u6c42",id:"http\u8acb\u6c42",level:3},{value:"\u8acb\u6c42\u53c3\u6578",id:"\u8acb\u6c42\u53c3\u6578",level:3},{value:"\u97ff\u61c9\u53c3\u6578",id:"\u97ff\u61c9\u53c3\u6578",level:3},{value:"\u8acb\u6c42\u793a\u4f8b",id:"\u8acb\u6c42\u793a\u4f8b",level:3},{value:"\u97ff\u61c9\u793a\u4f8b",id:"\u97ff\u61c9\u793a\u4f8b",level:3}],d=e=>function(t){return console.warn("Component "+e+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",t)},s=d("Tabs"),m=d("TabItem"),u={toc:c};function k(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,r.Z)({},u,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"\u8986\u84cb\u7bc4\u570d: \u5408\u7d04 / \u73fe\u8ca8 / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236)"))),(0,a.kt)("admonition",{type:"info"},(0,a.kt)("h2",{parentName:"admonition",id:"\u4ec0\u9ebc\u662f\u65b7\u7dda\u4fdd\u8b77-disconnection-protect"},"\u4ec0\u9ebc\u662f\u65b7\u7dda\u4fdd\u8b77 (Disconnection Protect)?"),(0,a.kt)("p",{parentName:"admonition"},"Bybit\u57fa\u65bcwebsocket\u79c1\u6709\u9023\u63a5\u548c\u5fc3\u8df3\u6a5f\u5236\uff0c\u63d0\u4f9b\u65b7\u7dda\u4fdd\u8b77\u529f\u80fd\u3002\u9019\u8a08\u6642\u5f9e\u7b2c\u4e00\u6b21\u65b7\u958b\u958b\u59cb\u3002\u5982\u679cBybit\u670d\u52d9\u5668\u5728\u4e00\u6bb5\u6642\u9593\u5167\u6c92\u6709\u6536\u5230\u5ba2\u6236\u7aef\u7684\u91cd\u9023\u8d85\u904e10\u79d2\uff08\u9ed8\u8a8d\uff09\u4e26\n\u6062\u5fa9\u5fc3\u8df3\u201cping\u201d\uff0c\u5247\u5ba2\u6236\u7aef\u8655\u65bc\u201c\u65b7\u7dda\u4fdd\u8b77\u201d\u72c0\u614b\uff0c\u5ba2\u6236\u6240\u6709\u6d3b\u8e8d\u7684",(0,a.kt)("strong",{parentName:"p"},"\u5408\u7d04 / \u73fe\u8ca8 / \u671f\u6b0a"),"\u8a02\u55ae\u5c07\u81ea\u52d5\u53d6\u6d88\u3002\u5982\u679c\u5728 10 \u79d2\u5167\uff0c\u5ba2\u6236\u7aef\u91cd\u65b0\u9023\u63a5\u4e26\u6062\u5fa9\u5fc3\u8df3\u201cping\u201d\uff0c\u8a08\u6642\u6703\u5728\u4e0b\u6b21\u65b7\u7dda\n\u6642\u91cd\u7f6e\u4e26\u91cd\u65b0\u958b\u59cb\u3002"),(0,a.kt)("h2",{parentName:"admonition",id:"\u5982\u4f55\u555f\u7528\u65b7\u7dda\u4fdd\u8b77"},"\u5982\u4f55\u555f\u7528\u65b7\u7dda\u4fdd\u8b77"),(0,a.kt)("p",{parentName:"admonition"},"\u82e5\u60a8\u9700\u8981\u958b\u555f/\u95dc\u9589\u65b7\u7dda\u4fdd\u8b77\u529f\u80fd, \u60a8\u53ef\u4ee5\u8aee\u8a62\u5ba2\u6236\u7d93\u7406. \u958b\u555f\u5f8c\uff0c\u9ed8\u8a8d\u7684\u65b7\u7dda\u4fdd\u8b77\u6642\u9593\u70ba10\u79d2\u3002"),(0,a.kt)("h2",{parentName:"admonition",id:"\u9069\u7528\u5c0d\u8c61"},"\u9069\u7528\u5c0d\u8c61"),(0,a.kt)("p",{parentName:"admonition"},"\u50c5\u9069\u7528\u65bc",(0,a.kt)("strong",{parentName:"p"},"USDT\u6c38\u7e8c / USDC\u6c38\u7e8c / USDC\u4ea4\u5272 / \u73fe\u8ca8 / \u671f\u6b0a"),"\u4ea4\u6613\u3002")),(0,a.kt)("admonition",{type:"tip"},(0,a.kt)("p",{parentName:"admonition"},"API\u8acb\u6c42\u767c\u9001\u6210\u529f\u5f8c\uff0c\u7cfb\u7d71\u9700\u8981\u4e00\u5b9a\u7684\u6642\u9593\u624d\u80fd\u751f\u6548\u3002\u5efa\u8b7010\u79d2\u5f8c\u518d\u67e5\u8a62\u6216\u8a2d\u7f6e\u3002")),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"\u60a8\u53ef\u4ee5\u4f7f\u7528\u8a72",(0,a.kt)("a",{parentName:"li",href:"/v5/account/account-info"},"\u63a5\u53e3"),"\u4f86\u67e5\u8a62\u7576\u524dDCP\u914d\u7f6e"),(0,a.kt)("li",{parentName:"ul"},"\u60a8\u7684\u79c1\u6709\u9023\u63a5",(0,a.kt)("strong",{parentName:"li"},"\u5fc5\u9808"),"\u8a02\u95b1",(0,a.kt)("a",{parentName:"li",href:"../websocket/private/dcp"},"\u65b7\u7dda\u4fdd\u8b77"),", \u624d\u80fd\u78ba\u4fddDCP\u529f\u80fd\u88ab\u89f8\u767c")),(0,a.kt)("h3",{id:"http\u8acb\u6c42"},"HTTP\u8acb\u6c42"),(0,a.kt)("p",null,"POST ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/disconnected-cancel-all")),(0,a.kt)("h3",{id:"\u8acb\u6c42\u53c3\u6578"},"\u8acb\u6c42\u53c3\u6578"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u662f\u5426\u5fc5\u9700"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,a.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"product"),(0,a.kt)("td",{parentName:"tr",align:"left"},"false"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},(0,a.kt)("inlineCode",{parentName:"td"},"OPTIONS"),"(\u9ed8\u8a8d), ",(0,a.kt)("inlineCode",{parentName:"td"},"DERIVATIVES"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"SPOT"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"timeWindow"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,a.kt)("td",{parentName:"tr",align:null},"\u65b7\u7dda\u4fdd\u8b77\u6642\u9593\u7a97\u53e3. ","[",(0,a.kt)("inlineCode",{parentName:"td"},"3"),", ",(0,a.kt)("inlineCode",{parentName:"td"},"300"),"]",", \u55ae\u4f4d: \u79d2")))),(0,a.kt)("h3",{id:"\u97ff\u61c9\u53c3\u6578"},"\u97ff\u61c9\u53c3\u6578"),(0,a.kt)("p",null,"\u7121"),(0,a.kt)("h3",{id:"\u8acb\u6c42\u793a\u4f8b"},"\u8acb\u6c42\u793a\u4f8b"),(0,a.kt)(s,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(m,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},'POST v5/order/disconnected-cancel-all HTTP/1.1\nHost: api.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1675852742375\nX-BAPI-RECV-WINDOW: 50000\nContent-Type: application/json\n\n{\n "timeWindow": 40\n}\n'))),(0,a.kt)(m,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.set_dcp(\n timeWindow=40,\n))\n'))),(0,a.kt)(m,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar setDcpOptionsRequest = TradeOrderRequest.builder().timeWindow(40).build();\nSystem.out.println(client.setDisconnectCancelAllTime(setDcpOptionsRequest));\n'))),(0,a.kt)(m,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .setDisconnectCancelAllWindow('option', 40)\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"\u97ff\u61c9\u793a\u4f8b"},"\u97ff\u61c9\u793a\u4f8b"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "success"\n}\n')))}k.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/935f2afb.b8ca5cff.js b/zh-TW/assets/js/935f2afb.b8ca5cff.js new file mode 100644 index 0000000000..9b3f459c0d --- /dev/null +++ b/zh-TW/assets/js/935f2afb.b8ca5cff.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[80053],{1109:e=>{e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"v3SideBar":[{"type":"link","label":"\u6982\u89bd","href":"/docs/zh-TW/v3/intro","docId":"v3/intro"},{"type":"link","label":"Bybit\u670d\u52d9\u5668\u6642\u9593","href":"/docs/zh-TW/v3/server-time","docId":"v3/server-time"},{"type":"link","label":"\u81ea\u6210\u4ea4\u6514\u622a","href":"/docs/zh-TW/v3/smp","docId":"v3/smp"},{"type":"category","label":"\u884d\u751f\u54c1","items":[{"type":"category","label":"REST\u63a5\u53e3","items":[{"type":"category","label":"\u5e02\u5834\u884c\u60c5","items":[{"type":"link","label":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/derivatives/public/kline","docId":"v3/derivatives/rest-public/kline"},{"type":"link","label":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/derivatives/public/mark-kline","docId":"v3/derivatives/rest-public/mark-kline"},{"type":"link","label":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/derivatives/public/index-kline","docId":"v3/derivatives/rest-public/index-kline"},{"type":"link","label":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/derivatives/public/premium-index-kline","docId":"v3/derivatives/rest-public/premium-index-kline"},{"type":"link","label":"Order Book (\u6df1\u5ea6)","href":"/docs/zh-TW/derivatives/public/orderbook","docId":"v3/derivatives/rest-public/orderbook"},{"type":"link","label":"\u67e5\u8a62\u6700\u65b0\u884c\u60c5\u4fe1\u606f","href":"/docs/zh-TW/derivatives/public/ticker","docId":"v3/derivatives/rest-public/ticker-info"},{"type":"link","label":"\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u898f\u683c\u4fe1\u606f","href":"/docs/zh-TW/derivatives/public/instrument-info","docId":"v3/derivatives/rest-public/instrument-info"},{"type":"link","label":"\u67e5\u8a62\u5e73\u53f0\u6210\u4ea4\u6b77\u53f2","href":"/docs/zh-TW/derivatives/public/trade","docId":"v3/derivatives/rest-public/public-trade"},{"type":"link","label":"\u67e5\u8a62\u5408\u7d04\u98a8\u96aa\u9650\u984d","href":"/docs/zh-TW/derivatives/public/risk-limit","docId":"v3/derivatives/rest-public/risk-limit"},{"type":"link","label":"\u67e5\u8a62\u6b77\u53f2\u8cc7\u91d1\u8cbb\u7387","href":"/docs/zh-TW/derivatives/public/funding-rate","docId":"v3/derivatives/rest-public/fund-rate-history"},{"type":"link","label":"\u67e5\u8a62\u672a\u5e73\u5009\u5408\u7d04\u6301\u5009\u6578\u91cf","href":"/docs/zh-TW/derivatives/public/open-interest","docId":"v3/derivatives/rest-public/open-interest"},{"type":"link","label":"\u67e5\u8a62\u671f\u6b0a\u4ea4\u5272\u50f9\u683c","href":"/docs/zh-TW/derivatives/public/option-delivery","docId":"v3/derivatives/rest-public/delivery-price"},{"type":"link","label":"\u67e5\u8a62\u591a\u7a7a\u6bd4","href":"/docs/zh-TW/derivatives/public/long-short-ratio","docId":"v3/derivatives/rest-public/long-short-ratio"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5408\u7d04","items":[{"type":"category","label":"\u4ea4\u6613","items":[{"type":"link","label":"\u5275\u5efa\u59d4\u8a17\u55ae","href":"/docs/zh-TW/derivatives/contract/place-order","docId":"v3/derivatives/rest-contract/order/place-order"},{"type":"link","label":"\u67e5\u8a62\u5be6\u6642\u59d4\u8a17\u55ae","href":"/docs/zh-TW/derivatives/contract/open-order","docId":"v3/derivatives/rest-contract/order/open-order"},{"type":"link","label":"\u4fee\u6539\u59d4\u8a17\u55ae","href":"/docs/zh-TW/derivatives/contract/replace-order","docId":"v3/derivatives/rest-contract/order/replace-order"},{"type":"link","label":"\u64a4\u92b7\u59d4\u8a17\u55ae","href":"/docs/zh-TW/derivatives/contract/cancel","docId":"v3/derivatives/rest-contract/order/cancel-order"},{"type":"link","label":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","href":"/docs/zh-TW/derivatives/contract/cancel-all","docId":"v3/derivatives/rest-contract/order/cancel-all"},{"type":"link","label":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae","href":"/docs/zh-TW/derivatives/contract/order-list","docId":"v3/derivatives/rest-contract/order/order-list"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u6301\u5009","items":[{"type":"link","label":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","href":"/docs/zh-TW/derivatives/contract/position-list","docId":"v3/derivatives/rest-contract/position/position-info"},{"type":"link","label":"\u8a2d\u7f6e\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1","href":"/docs/zh-TW/derivatives/contract/auto-margin","docId":"v3/derivatives/rest-contract/position/auto-margin"},{"type":"link","label":"\u5207\u63db\u5168\u5009/\u9010\u5009","href":"/docs/zh-TW/derivatives/contract/cross-isolated","docId":"v3/derivatives/rest-contract/position/cross-isolated-margin"},{"type":"link","label":"\u5207\u63db\u5009\u4f4d\u6a21\u5f0f","href":"/docs/zh-TW/derivatives/contract/position-mode","docId":"v3/derivatives/rest-contract/position/position-mode"},{"type":"link","label":"\u5207\u63db\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","href":"/docs/zh-TW/derivatives/contract/tpsl-mode","docId":"v3/derivatives/rest-contract/position/tpsl-mode"},{"type":"link","label":"\u8a2d\u7f6e\u69d3\u687f\u500d\u6578","href":"/docs/zh-TW/derivatives/contract/leverage","docId":"v3/derivatives/rest-contract/position/leverage"},{"type":"link","label":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","href":"/docs/zh-TW/derivatives/contract/trading-stop","docId":"v3/derivatives/rest-contract/position/trading-stop"},{"type":"link","label":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d (\u5ee2\u68c4)","href":"/docs/zh-TW/derivatives/contract/set-risk-limit","docId":"v3/derivatives/rest-contract/position/set-risk-limit"},{"type":"link","label":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304","href":"/docs/zh-TW/derivatives/contract/execution-list","docId":"v3/derivatives/rest-contract/position/execution"},{"type":"link","label":"\u67e5\u8a62\u5e73\u5009\u76c8\u8667","href":"/docs/zh-TW/derivatives/contract/closepnl","docId":"v3/derivatives/rest-contract/position/close-pnl"},{"type":"link","label":"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d","href":"/docs/zh-TW/derivatives/contract/confirm-mmr","docId":"v3/derivatives/rest-contract/position/confirm-mmr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5e33\u6236","items":[{"type":"link","label":"\u9322\u5305\u9918\u984d","href":"/docs/zh-TW/derivatives/contract/wallet","docId":"v3/derivatives/rest-contract/account/wallet-balance"},{"type":"link","label":"\u67e5\u8a62\u4ea4\u6613\u8cbb\u7387","href":"/docs/zh-TW/derivatives/contract/fee-rate","docId":"v3/derivatives/rest-contract/account/trading-fee"},{"type":"link","label":"\u67e5\u8a62\u9322\u5305\u8cc7\u91d1\u7d00\u9304","href":"/docs/zh-TW/derivatives/contract/wallet-fund","docId":"v3/derivatives/rest-contract/account/wallet-fund-record"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket\u63a8\u9001","items":[{"type":"link","label":"\u8a02\u95b1WebSocket","href":"/docs/zh-TW/derivatives/ws/connect","docId":"v3/derivatives/wss-authentication"},{"type":"category","label":"\u516c\u5171\u983b\u9053","items":[{"type":"link","label":"\u6df1\u5ea6","href":"/docs/zh-TW/derivatives/ws-public/orderbook","docId":"v3/derivatives/wss-public/orderbook"},{"type":"link","label":"\u5e73\u53f0\u6210\u4ea4","href":"/docs/zh-TW/derivatives/ws-public/trade","docId":"v3/derivatives/wss-public/trade"},{"type":"link","label":"\u884c\u60c5","href":"/docs/zh-TW/derivatives/ws-public/ticker","docId":"v3/derivatives/wss-public/tickers"},{"type":"link","label":"K\u7dda","href":"/docs/zh-TW/derivatives/ws-public/kline","docId":"v3/derivatives/wss-public/kline"},{"type":"link","label":"\u5f37\u5e73\u63a8\u9001","href":"/docs/zh-TW/derivatives/ws-public/liquidation","docId":"v3/derivatives/wss-public/liquidation"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u79c1\u6709\u983b\u9053(\u5408\u7d04)","items":[{"type":"link","label":"\u6301\u5009","href":"/docs/zh-TW/derivatives/ws-contract/position","docId":"v3/derivatives/wss-contract/position"},{"type":"link","label":"\u500b\u4eba\u6210\u4ea4","href":"/docs/zh-TW/derivatives/ws-contract/execution","docId":"v3/derivatives/wss-contract/execution"},{"type":"link","label":"\u8a02\u55ae","href":"/docs/zh-TW/derivatives/ws-contract/order","docId":"v3/derivatives/wss-contract/order"},{"type":"link","label":"\u9322\u5305","href":"/docs/zh-TW/derivatives/ws-contract/wallet","docId":"v3/derivatives/wss-contract/wallet"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"\u983b\u7387\u9650\u5236","href":"/docs/zh-TW/derivatives/rate-limit","docId":"v3/derivatives/rate-limit"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/derivatives/enum","docId":"v3/derivatives/enum"},{"type":"link","label":"\u932f\u8aa4\u78bc","href":"/docs/zh-TW/derivatives/error","docId":"v3/derivatives/error"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/category/derivatives"},{"type":"category","label":"\u73fe\u8ca8","items":[{"type":"category","label":"REST\u63a5\u53e3","items":[{"type":"category","label":"\u5e02\u5834\u884c\u60c5","items":[{"type":"link","label":"\u67e5\u8a62\u6240\u6709\u4ea4\u6613\u5c0d","href":"/docs/zh-TW/spot/public/instrument","docId":"v3/spot/rest-public/instrument-info"},{"type":"link","label":"\u8a02\u55ae\u7c3f","href":"/docs/zh-TW/spot/public/depth","docId":"v3/spot/rest-public/orderbook"},{"type":"link","label":"\u5408\u4e26\u8a02\u55ae\u7c3f","href":"/docs/zh-TW/spot/public/merge-depth","docId":"v3/spot/rest-public/merge-orderbook"},{"type":"link","label":"\u67e5\u8a62K\u7dda\u6578\u64da","href":"/docs/zh-TW/spot/public/kline","docId":"v3/spot/rest-public/kline"},{"type":"link","label":"\u5e73\u81fa\u4ea4\u6613\u6b77\u53f2\u6578\u64da","href":"/docs/zh-TW/spot/public/recent-trade","docId":"v3/spot/rest-public/public-trade"},{"type":"link","label":"\u6700\u4f73\u8cb7\u8ce3\u50f9","href":"/docs/zh-TW/spot/public/bid-ask","docId":"v3/spot/rest-public/best-bid-ask"},{"type":"link","label":"Symbol\u6700\u65b0\u50f9","href":"/docs/zh-TW/spot/public/last-price","docId":"v3/spot/rest-public/last-trade-price"},{"type":"link","label":"\u6700\u65b0\u4fe1\u606f","href":"/docs/zh-TW/spot/public/tickers","docId":"v3/spot/rest-public/ticker-info"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u4ea4\u6613","items":[{"type":"link","label":"\u5275\u5efa\u6d3b\u52d5\u59d4\u6258\u55ae","href":"/docs/zh-TW/spot/trade/place-order","docId":"v3/spot/rest-spot/place-order"},{"type":"link","label":"\u67e5\u8a62\u6d3b\u52d5\u59d4\u6258","href":"/docs/zh-TW/spot/trade/get-order","docId":"v3/spot/rest-spot/get-order"},{"type":"link","label":"\u64a4\u92b7\u6d3b\u52d5\u59d4\u6258\u55ae","href":"/docs/zh-TW/spot/trade/cancel","docId":"v3/spot/rest-spot/cancel-order"},{"type":"link","label":"\u8a02\u55ae\u5217\u8868","href":"/docs/zh-TW/spot/trade/open-order","docId":"v3/spot/rest-spot/open-order"},{"type":"link","label":"\u6279\u91cf\u64a4\u92b7\u8a02\u55ae","href":"/docs/zh-TW/spot/trade/batch-cancel","docId":"v3/spot/rest-spot/batch-cancel"},{"type":"link","label":"\u6839\u64da\u8a02\u55ae\u865f\u6279\u91cf\u64a4\u92b7\u8a02\u55ae","href":"/docs/zh-TW/spot/trade/cancel-by-id","docId":"v3/spot/rest-spot/batch-cancel-by-id"},{"type":"link","label":"\u6b77\u53f2\u8a02\u55ae","href":"/docs/zh-TW/spot/trade/order-history","docId":"v3/spot/rest-spot/order-history"},{"type":"link","label":"\u4ea4\u6613\u8a18\u9304","href":"/docs/zh-TW/spot/trade/my-trades","docId":"v3/spot/rest-spot/trade-history"}],"collapsed":true,"collapsible":true},{"type":"link","label":"\u67e5\u8a62\u9322\u5305\u4f59\u984d","href":"/docs/zh-TW/spot/wallet","docId":"v3/spot/wallet"},{"type":"category","label":"\u69d3\u687f\u4ee3\u5e63","items":[{"type":"link","label":"LT \u5168\u91cf\u8cc7\u7522\u57fa\u790e\u4fe1\u606f\u67e5\u8a62","href":"/docs/zh-TW/spot/etp/asset-info","docId":"v3/spot/rest-etp/asset-info"},{"type":"link","label":"LT \u884c\u60c5\u67e5\u8a62","href":"/docs/zh-TW/spot/etp/market-info","docId":"v3/spot/rest-etp/market-info"},{"type":"link","label":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","href":"/docs/zh-TW/spot/etp/order-history","docId":"v3/spot/rest-etp/purchase-redeem-history"},{"type":"link","label":"\u7533\u8cfc","href":"/docs/zh-TW/spot/etp/purchase","docId":"v3/spot/rest-etp/purchase"},{"type":"link","label":"\u8d16\u56de","href":"/docs/zh-TW/spot/etp/redeem","docId":"v3/spot/rest-etp/redeem"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5168\u5009\u69d3\u687f","items":[{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u5e33\u6236\u4fe1\u606f","href":"/docs/zh-TW/spot/margin/account","docId":"v3/spot/rest-spot-margin/account-info"},{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae","href":"/docs/zh-TW/spot/margin/borrow-history","docId":"v3/spot/rest-spot-margin/borrow-info"},{"type":"link","label":"\u501f\u6b3e","href":"/docs/zh-TW/spot/margin/borrow","docId":"v3/spot/rest-spot-margin/borrow"},{"type":"link","label":"\u67e5\u8a62\u53ef\u501f\u5e63\u7a2e\u7cbe\u5ea6","href":"/docs/zh-TW/spot/margin/borrowable-coin","docId":"v3/spot/rest-spot-margin/borrowable-data"},{"type":"link","label":"\u67e5\u8a62\u5229\u7387\u53ca\u984d\u5ea6","href":"/docs/zh-TW/spot/margin/interest","docId":"v3/spot/rest-spot-margin/interest-quota"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/spot/margin/margin-data","docId":"v3/spot/rest-spot-margin/margin-data"},{"type":"link","label":"\u67e5\u8a62\u9084\u6b3e\u8a02\u55ae\u4fe1\u606f","href":"/docs/zh-TW/spot/margin/repay-history","docId":"v3/spot/rest-spot-margin/repay-history"},{"type":"link","label":"\u9084\u6b3e","href":"/docs/zh-TW/spot/margin/repay","docId":"v3/spot/rest-spot-margin/repay"},{"type":"link","label":"\u5168\u5009\u69d3\u687f\u958b\u95dc","href":"/docs/zh-TW/spot/margin/toggle","docId":"v3/spot/rest-spot-margin/switch-mode"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u6a5f\u69cb\u501f\u8cb8","items":[{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u7522\u54c1\u4fe1\u606f","href":"/docs/zh-TW/spot/otc/product-info","docId":"v3/spot/rest-institution-loan/margin-product-info"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/spot/otc/coin-info","docId":"v3/spot/rest-institution-loan/margin-coin-info"},{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u4fe1\u606f","href":"/docs/zh-TW/spot/otc/loan-info","docId":"v3/spot/rest-institution-loan/loan-info"},{"type":"link","label":"\u67e5\u8a62\u9084\u6b3e\u4fe1\u606f","href":"/docs/zh-TW/spot/otc/repay-info","docId":"v3/spot/rest-institution-loan/repay-info"},{"type":"link","label":"\u67e5\u8a62\u98a8\u96aa\u7387","href":"/docs/zh-TW/spot/otc/ltv","docId":"v3/spot/rest-institution-loan/ltv"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket\u63a8\u9001","items":[{"type":"link","label":"\u8a02\u95b1WebSocket","href":"/docs/zh-TW/spot/ws/connect","docId":"v3/spot/wss-authentication"},{"type":"category","label":"\u516c\u5171\u983b\u9053","items":[{"type":"link","label":"\u6df1\u5ea6","href":"/docs/zh-TW/spot/ws-public/orderbook","docId":"v3/spot/wss-public/orderbook"},{"type":"link","label":"K\u7dda","href":"/docs/zh-TW/spot/ws-public/kline","docId":"v3/spot/wss-public/kline"},{"type":"link","label":"\u884c\u60c5","href":"/docs/zh-TW/spot/ws-public/ticker","docId":"v3/spot/wss-public/tickers"},{"type":"link","label":"\u8cb7\u4e00\u8ce3\u4e00","href":"/docs/zh-TW/spot/ws-public/bookticker","docId":"v3/spot/wss-public/bookticker"},{"type":"link","label":"\u5e73\u81fa\u6210\u4ea4","href":"/docs/zh-TW/spot/ws-public/public-trade","docId":"v3/spot/wss-public/trade"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u79c1\u6709\u983b\u9053","items":[{"type":"link","label":"\u8a02\u55ae","href":"/docs/zh-TW/spot/ws-private/order","docId":"v3/spot/wss-private/order"},{"type":"link","label":"\u6b62\u76c8\u6b62\u640d\u8a02\u55ae","href":"/docs/zh-TW/spot/ws-private/stop-order","docId":"v3/spot/wss-private/stop-order"},{"type":"link","label":"\u500b\u4eba\u6210\u4ea4","href":"/docs/zh-TW/spot/ws-private/execution","docId":"v3/spot/wss-private/ticket-info"},{"type":"link","label":"\u9322\u5305","href":"/docs/zh-TW/spot/ws-private/wallet","docId":"v3/spot/wss-private/outbound-account-info"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"\u983b\u7387\u9650\u5236","href":"/docs/zh-TW/spot/rate-limit","docId":"v3/spot/rate-limit"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/spot/enum","docId":"v3/spot/enum"},{"type":"link","label":"\u932f\u8aa4\u78bc","href":"/docs/zh-TW/spot/error","docId":"v3/spot/error"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/category/spot"},{"type":"category","label":"\u5e33\u6236\u8cc7\u7522","collapsed":true,"items":[{"type":"category","label":"\u5283\u8f49\u76f8\u95dc\u63a5\u53e3","collapsed":true,"items":[{"type":"link","label":"\u5283\u8f49(\u55ae\u5e33\u865f\u5167)","href":"/docs/zh-TW/account-asset/internal-transfer","docId":"v3/account-asset/transfer/internal-transfer"},{"type":"link","label":"\u67e5\u8a62\u5283\u8f49\u8a18\u9304(\u55ae\u5e33\u865f\u5167)","href":"/docs/zh-TW/account-asset/internal-transfer-list","docId":"v3/account-asset/transfer/internal-transfer-list"},{"type":"link","label":"\u5b50\u6bcd\u5283\u8f49","href":"/docs/zh-TW/account-asset/sub-transfer","docId":"v3/account-asset/transfer/subacct-transfer"},{"type":"link","label":"\u67e5\u8a62\u5b50\u6bcd\u9593\u5283\u8f49\u8a18\u9304","href":"/docs/zh-TW/account-asset/sub-transfer-list","docId":"v3/account-asset/transfer/subacct-transfer-list"},{"type":"link","label":"\u67e5\u8a62\u5b50\u8cec\u865f\u5217\u8868","href":"/docs/zh-TW/account-asset/sub-uid-list","docId":"v3/account-asset/transfer/subacct-list"},{"type":"link","label":"\u914d\u7f6e\u53ef\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u8cec\u865f (\u5ee2\u68c4)","href":"/docs/zh-TW/account-asset/enable-unitransfer","docId":"v3/account-asset/transfer/enable-uni-transfer"},{"type":"link","label":"\u842c\u80fd\u5283\u8f49","href":"/docs/zh-TW/account-asset/uni-transfer","docId":"v3/account-asset/transfer/uni-transfer"},{"type":"link","label":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u8a18\u9304","href":"/docs/zh-TW/account-asset/uni-transfer-list","docId":"v3/account-asset/transfer/uni-transfer-list"},{"type":"link","label":"\u8cec\u865f\u5167\u53ef\u5283\u8f49\u5e63\u7a2e\u5217\u8868","href":"/docs/zh-TW/account-asset/transferable-coin-list","docId":"v3/account-asset/transfer/transferable-coin-list"},{"type":"link","label":"\u67e5\u8a62\u8cec\u6236\u55ae\u500b\u5e63\u7a2e\u4f59\u984d","href":"/docs/zh-TW/account-asset/coin-balance","docId":"v3/account-asset/transfer/coin-balance"},{"type":"link","label":"\u67e5\u8a62\u8cec\u6236\u6240\u6709\u5e63\u7a2e\u4f59\u984d","href":"/docs/zh-TW/account-asset/all-balance","docId":"v3/account-asset/transfer/all-balance"},{"type":"link","label":"\u67e5\u8a62\u8cc7\u7522\u4fe1\u606f (\u73fe\u8ca8)","href":"/docs/zh-TW/account-asset/asset-info","docId":"v3/account-asset/transfer/asset-info"}],"collapsible":true},{"type":"category","label":"\u63d0\u73fe\u8207\u5145\u503c\u76f8\u95dc\u63a5\u53e3","collapsed":true,"items":[{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u76f8\u95dc\u7684\u898f\u683c","href":"/docs/zh-TW/account-asset/deposit-spec","docId":"v3/account-asset/withdraw-deposit/deposit-spec"},{"type":"link","label":"\u8a2d\u7f6e\u5145\u503c\u5e33\u6236","href":"/docs/zh-TW/account-asset/set-deposit-acct","docId":"v3/account-asset/withdraw-deposit/set-deposit-acct"},{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u93c8\u4e0a)","href":"/docs/zh-TW/account-asset/deposit-record","docId":"v3/account-asset/withdraw-deposit/master-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236\u5145\u503c (\u93c8\u4e0a)","href":"/docs/zh-TW/account-asset/sub-deposit-record","docId":"v3/account-asset/withdraw-deposit/sub-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u5e73\u53f0\u8f6c\u8d26)","href":"/docs/zh-TW/account-asset/internal-deposit-record","docId":"v3/account-asset/withdraw-deposit/internal-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u63d0\u73fe\u8a18\u9304","href":"/docs/zh-TW/account-asset/withdraw-record","docId":"v3/account-asset/withdraw-deposit/withdraw-record"},{"type":"link","label":"\u67e5\u8a62\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/account-asset/coin-info","docId":"v3/account-asset/withdraw-deposit/coin-info"},{"type":"link","label":"\u67e5\u8a62\u5ef6\u9072\u63d0\u5e63\u51cd\u7d50\u91d1\u984d","href":"/docs/zh-TW/account-asset/delay-amount","docId":"v3/account-asset/withdraw-deposit/deplay-amount"},{"type":"link","label":"\u67e5\u8a62\u4ea4\u6613\u6240\u5217\u8868 (\u97d3\u570b\u7528\u6236)","href":"/docs/zh-TW/account-asset/vasp-list","docId":"v3/account-asset/withdraw-deposit/vasp-list"},{"type":"link","label":"\u63d0\u73fe","href":"/docs/zh-TW/account-asset/withdraw","docId":"v3/account-asset/withdraw-deposit/withdraw"},{"type":"link","label":"\u64a4\u92b7\u63d0\u5e63","href":"/docs/zh-TW/account-asset/cancel-withdraw","docId":"v3/account-asset/withdraw-deposit/cancel-withdraw"},{"type":"link","label":"\u67e5\u8a62\u4e3b\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f","href":"/docs/zh-TW/account-asset/master-deposit-addr","docId":"v3/account-asset/withdraw-deposit/master-deposit-addr"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f","href":"/docs/zh-TW/account-asset/sub-deposit-addr","docId":"v3/account-asset/withdraw-deposit/sub-deposit-addr"}],"collapsible":true},{"type":"category","label":"\u6bcd\u5b50\u5e33\u6236\u76f8\u95dc\u63a5\u53e3","collapsed":true,"items":[{"type":"link","label":"\u65b0\u5efa\u5b50\u5e33\u6236","href":"/docs/zh-TW/account-asset/create-subuid","docId":"v3/account-asset/user/create-subuid"},{"type":"link","label":"\u65b0\u5efa\u5b50\u5e33\u6236\u7684API Key","href":"/docs/zh-TW/account-asset/create-subuid-apikey","docId":"v3/account-asset/user/create-subuid-apikey"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868","href":"/docs/zh-TW/account-asset/subuid-list","docId":"v3/account-asset/user/subuid-list"},{"type":"link","label":"\u51cd\u7d50/\u89e3\u51cd\u5b50\u5e33\u6236","href":"/docs/zh-TW/account-asset/froze-subuid","docId":"v3/account-asset/user/froze-subuid"},{"type":"link","label":"\u67e5\u8a62API Key\u76f8\u95dc\u4fe1\u606f","href":"/docs/zh-TW/account-asset/apikey-info","docId":"v3/account-asset/user/apikey-info"},{"type":"link","label":"\u67e5\u8a62\u5e33\u6236\u652f\u6301\u7684\u9322\u5305\u985e\u578b","href":"/docs/zh-TW/account-asset/wallet-type","docId":"v3/account-asset/user/wallet-type"},{"type":"link","label":"\u4fee\u6539\u6bcd\u5e33\u6236\u7684API Key\u8a2d\u7f6e","href":"/docs/zh-TW/account-asset/modify-master-apikey","docId":"v3/account-asset/user/modify-master-apikey"},{"type":"link","label":"\u4fee\u6539\u5b50\u5e33\u6236\u7684API Key\u8a2d\u7f6e","href":"/docs/zh-TW/account-asset/modify-sub-apikey","docId":"v3/account-asset/user/modify-sub-apikey"},{"type":"link","label":"\u522a\u9664\u6bcd\u5e33\u6236\u7684API Key","href":"/docs/zh-TW/account-asset/rm-master-apikey","docId":"v3/account-asset/user/rm-master-apikey"},{"type":"link","label":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684API Key","href":"/docs/zh-TW/account-asset/rm-sub-apikey","docId":"v3/account-asset/user/rm-sub-apikey"}],"collapsible":true},{"type":"link","label":"\u983b\u7387\u9650\u5236","href":"/docs/zh-TW/account-asset/rate-limit","docId":"v3/account-asset/rate-limit"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/account-asset/enum","docId":"v3/account-asset/enum"},{"type":"link","label":"\u932f\u8aa4\u78bc","href":"/docs/zh-TW/account-asset/error","docId":"v3/account-asset/error"}],"collapsible":true},{"type":"category","label":"\u7a05\u52d9","items":[{"type":"link","label":"\u67e5\u8a62\u7279\u5b9a\u7528\u6236\u5728\u5e73\u53f0\u8a3b\u518a\u65e5\u671f","href":"/docs/zh-TW/tax/time","docId":"v3/tax/register-time"},{"type":"link","label":"\u5275\u5efa\u5c0e\u51fa\u5831\u544a\u8acb\u6c42","href":"/docs/zh-TW/tax/report","docId":"v3/tax/request-report"},{"type":"link","label":"\u67e5\u8a62\u5831\u544a\u5c0e\u51fa\u72c0\u614b","href":"/docs/zh-TW/tax/status","docId":"v3/tax/report-status"},{"type":"link","label":"\u6578\u64da\u5c0e\u51fa","href":"/docs/zh-TW/tax/data-export","docId":"v3/tax/data-export"},{"type":"link","label":"\u6578\u64da\u8aaa\u660e","href":"/docs/zh-TW/tax/explain","docId":"v3/tax/data-explain"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/tax/enum","docId":"v3/tax/enum"}],"collapsed":true,"collapsible":true}],"v5SideBar":[{"type":"link","label":"\u6982\u89bd","href":"/docs/zh-TW/v5/intro","docId":"v5/intro"},{"type":"link","label":"\u63a5\u5165\u6307\u5357","href":"/docs/zh-TW/v5/guide","docId":"v5/guide"},{"type":"link","label":"\u67e5\u8a62\u516c\u544a","href":"/docs/zh-TW/v5/announcement","docId":"v5/announcement"},{"type":"link","label":"\u81ea\u6210\u4ea4\u6514\u622a","href":"/docs/zh-TW/v5/smp","docId":"v5/smp"},{"type":"link","label":"\u5982\u4f55\u4f7f\u7528API\u5e36\u55ae","href":"/docs/zh-TW/v5/copytrade","docId":"v5/copytrade"},{"type":"link","label":"\u6a21\u64ec\u4ea4\u6613","href":"/docs/zh-TW/v5/demo","docId":"v5/demo"},{"type":"category","label":"\u516c\u6709\u884c\u60c5","items":[{"type":"link","label":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/v5/market/kline","docId":"v5/market/kline"},{"type":"link","label":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/v5/market/mark-kline","docId":"v5/market/mark-kline"},{"type":"link","label":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/v5/market/index-kline","docId":"v5/market/index-kline"},{"type":"link","label":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/v5/market/preimum-index-kline","docId":"v5/market/preimum-index-kline"},{"type":"link","label":"\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u898f\u683c\u4fe1\u606f","href":"/docs/zh-TW/v5/market/instrument","docId":"v5/market/instrument"},{"type":"link","label":"Order Book (\u6df1\u5ea6)","href":"/docs/zh-TW/v5/market/orderbook","docId":"v5/market/orderbook"},{"type":"link","label":"\u67e5\u8a62\u6700\u65b0\u884c\u60c5\u4fe1\u606f","href":"/docs/zh-TW/v5/market/tickers","docId":"v5/market/tickers"},{"type":"link","label":"\u67e5\u8a62\u6b77\u53f2\u8cc7\u91d1\u8cbb\u7387","href":"/docs/zh-TW/v5/market/history-fund-rate","docId":"v5/market/history-fund-rate"},{"type":"link","label":"\u67e5\u8a62\u5e73\u53f0\u6700\u8fd1\u6210\u4ea4\u6b77\u53f2","href":"/docs/zh-TW/v5/market/recent-trade","docId":"v5/market/recent-trade"},{"type":"link","label":"\u67e5\u8a62\u672a\u5e73\u5009\u5408\u7d04\u6301\u5009\u6578\u91cf","href":"/docs/zh-TW/v5/market/open-interest","docId":"v5/market/open-interest"},{"type":"link","label":"\u67e5\u8a62\u671f\u6b0a\u6ce2\u52d5\u7387","href":"/docs/zh-TW/v5/market/iv","docId":"v5/market/iv"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u96aa\u57fa\u91d1","href":"/docs/zh-TW/v5/market/insurance","docId":"v5/market/insurance"},{"type":"link","label":"\u67e5\u8a62\u5408\u7d04\u98a8\u96aa\u9650\u984d","href":"/docs/zh-TW/v5/market/risk-limit","docId":"v5/market/risk-limit"},{"type":"link","label":"\u67e5\u8a62\u4ea4\u5272\u50f9\u683c","href":"/docs/zh-TW/v5/market/delivery-price","docId":"v5/market/delivery-price"},{"type":"link","label":"\u67e5\u8a62\u591a\u7a7a\u6bd4","href":"/docs/zh-TW/v5/market/long-short-ratio","docId":"v5/market/long-short-ratio"},{"type":"link","label":"Bybit\u670d\u52d9\u5668\u6642\u9593","href":"/docs/zh-TW/v5/market/time","docId":"v5/market/time"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u4ea4\u6613","items":[{"type":"link","label":"\u5275\u5efa\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/create-order","docId":"v5/order/create-order"},{"type":"link","label":"\u4fee\u6539\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/amend-order","docId":"v5/order/amend-order"},{"type":"link","label":"\u64a4\u92b7\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/cancel-order","docId":"v5/order/cancel-order"},{"type":"link","label":"\u67e5\u8a62\u5be6\u6642\u548c\u7d42\u614b\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/open-order","docId":"v5/order/open-order"},{"type":"link","label":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","href":"/docs/zh-TW/v5/order/cancel-all","docId":"v5/order/cancel-all"},{"type":"link","label":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae (2\u5e74)","href":"/docs/zh-TW/v5/order/order-list","docId":"v5/order/order-list"},{"type":"link","label":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304 (2\u5e74)","href":"/docs/zh-TW/v5/order/execution","docId":"v5/order/execution"},{"type":"link","label":"\u6279\u91cf\u5275\u5efa\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/batch-place","docId":"v5/order/batch-place"},{"type":"link","label":"\u6279\u91cf\u4fee\u6539\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/batch-amend","docId":"v5/order/batch-amend"},{"type":"link","label":"\u6279\u91cf\u64a4\u92b7\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/batch-cancel","docId":"v5/order/batch-cancel"},{"type":"link","label":"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)","href":"/docs/zh-TW/v5/order/spot-borrow-quota","docId":"v5/order/spot-borrow-quota"},{"type":"link","label":"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593","href":"/docs/zh-TW/v5/order/dcp","docId":"v5/order/dcp"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u6301\u5009","items":[{"type":"link","label":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","href":"/docs/zh-TW/v5/position/","docId":"v5/position/position"},{"type":"link","label":"\u8a2d\u7f6e\u69d3\u687f","href":"/docs/zh-TW/v5/position/leverage","docId":"v5/position/leverage"},{"type":"link","label":"\u5207\u63db\u5168\u5009/\u9010\u5009\u4fdd\u8b49\u91d1(\u4ea4\u6613\u5c0d)","href":"/docs/zh-TW/v5/position/cross-isolate","docId":"v5/position/cross-isolate"},{"type":"link","label":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","href":"/docs/zh-TW/v5/position/tpsl-mode","docId":"v5/position/tpsl-mode"},{"type":"link","label":"\u5207\u63db\u6301\u5009\u6a21\u5f0f","href":"/docs/zh-TW/v5/position/position-mode","docId":"v5/position/position-mode"},{"type":"link","label":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d (\u5ee2\u68c4)","href":"/docs/zh-TW/v5/position/set-risk-limit","docId":"v5/position/set-risk-limit"},{"type":"link","label":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","href":"/docs/zh-TW/v5/position/trading-stop","docId":"v5/position/trading-stop"},{"type":"link","label":"\u8a2d\u7f6e\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1","href":"/docs/zh-TW/v5/position/auto-add-margin","docId":"v5/position/auto-add-margin"},{"type":"link","label":"\u624b\u52d5\u589e\u52a0\u6216\u6e1b\u5c11\u4fdd\u8b49\u91d1","href":"/docs/zh-TW/v5/position/manual-add-margin","docId":"v5/position/manual-add-margin"},{"type":"link","label":"\u67e5\u8a62\u5e73\u5009\u76c8\u8667","href":"/docs/zh-TW/v5/position/close-pnl","docId":"v5/position/close-pnl"},{"type":"link","label":"\u79fb\u5009","href":"/docs/zh-TW/v5/position/move-position","docId":"v5/position/move-position"},{"type":"link","label":"\u67e5\u8a62\u79fb\u5009\u6b77\u53f2","href":"/docs/zh-TW/v5/position/move-position-history","docId":"v5/position/move-position-history"},{"type":"link","label":"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d","href":"/docs/zh-TW/v5/position/confirm-mmr","docId":"v5/position/confirm-mmr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5347\u7d1a\u524d\u76f8\u95dc\u7d00\u9304","items":[{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u8a02\u55ae\u7d00\u9304","href":"/docs/zh-TW/v5/pre-upgrade/order-list","docId":"v5/pre-upgrade/order-list"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u6210\u4ea4\u7d00\u9304","href":"/docs/zh-TW/v5/pre-upgrade/execution","docId":"v5/pre-upgrade/execution"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u5e73\u5009\u76c8\u8667","href":"/docs/zh-TW/v5/pre-upgrade/close-pnl","docId":"v5/pre-upgrade/close-pnl"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u4ea4\u6613\u65e5\u8a8c","href":"/docs/zh-TW/v5/pre-upgrade/transaction-log","docId":"v5/pre-upgrade/transaction-log"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u671f\u6b0a\u4ea4\u5272\u7d00\u9304","href":"/docs/zh-TW/v5/pre-upgrade/delivery","docId":"v5/pre-upgrade/delivery"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524dUSDC\u7d50\u7b97\u7d00\u9304","href":"/docs/zh-TW/v5/pre-upgrade/settlement","docId":"v5/pre-upgrade/settlement"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5e33\u6236","items":[{"type":"link","label":"\u67e5\u8a62\u9322\u5305\u9918\u984d","href":"/docs/zh-TW/v5/account/wallet-balance","docId":"v5/account/wallet-balance"},{"type":"link","label":"\u5347\u7d1a\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236","href":"/docs/zh-TW/v5/account/upgrade-unified-account","docId":"v5/account/upgrade-unified-account"},{"type":"link","label":"\u67e5\u8a62\u5229\u606f\u8a18\u9304 (2\u5e74)","href":"/docs/zh-TW/v5/account/borrow-history","docId":"v5/account/borrow-history"},{"type":"link","label":"\u4e00\u9375\u9084\u6b3e","href":"/docs/zh-TW/v5/account/repay-liability","docId":"v5/account/repay-liability"},{"type":"link","label":"\u8a2d\u7f6e\u62b5\u62bc\u54c1\u5e63\u7a2e","href":"/docs/zh-TW/v5/account/set-collateral","docId":"v5/account/set-collateral"},{"type":"link","label":"\u6279\u91cf\u8a2d\u7f6e\u62b5\u62bc\u54c1\u5e63\u7a2e","href":"/docs/zh-TW/v5/account/batch-set-collateral","docId":"v5/account/batch-set-collateral"},{"type":"link","label":"\u67e5\u8a62\u62b5\u62bc\u54c1\u4fe1\u606f","href":"/docs/zh-TW/v5/account/collateral-info","docId":"v5/account/collateral-info"},{"type":"link","label":"\u67e5\u8a62Greeks\u4fe1\u606f","href":"/docs/zh-TW/v5/account/coin-greeks","docId":"v5/account/coin-greeks"},{"type":"link","label":"\u67e5\u8a62\u624b\u7e8c\u8cbb\u7387","href":"/docs/zh-TW/v5/account/fee-rate","docId":"v5/account/fee-rate"},{"type":"link","label":"\u67e5\u8a62\u8cec\u6236\u914d\u7f6e","href":"/docs/zh-TW/v5/account/account-info","docId":"v5/account/account-info"},{"type":"link","label":"\u67e5\u8a62DCP\u914d\u7f6e","href":"/docs/zh-TW/v5/account/dcp-info","docId":"v5/account/dcp-info"},{"type":"link","label":"\u4ea4\u6613\u65e5\u8a8c (\u7d71\u4e00\u5e33\u6236)","href":"/docs/zh-TW/v5/account/transaction-log","docId":"v5/account/transaction-log"},{"type":"link","label":"\u4ea4\u6613\u65e5\u8a8c (\u7d93\u5178\u5e33\u6236)","href":"/docs/zh-TW/v5/account/contract-transaction-log","docId":"v5/account/contract-transaction-log"},{"type":"link","label":"\u67e5\u8a62SMP\u7d44ID","href":"/docs/zh-TW/v5/account/smp-group","docId":"v5/account/smp-group"},{"type":"link","label":"\u8a2d\u7f6e\u4fdd\u8b49\u91d1\u6a21\u5f0f(\u5e33\u6236)","href":"/docs/zh-TW/v5/account/set-margin-mode","docId":"v5/account/set-margin-mode"},{"type":"link","label":"\u8a2d\u7f6e\u73fe\u8ca8\u5c0d\u885d","href":"/docs/zh-TW/v5/account/set-spot-hedge","docId":"v5/account/set-spot-hedge"},{"type":"link","label":"\u8bbe\u7f6e\u5e02\u5546\u4fdd\u8b77","href":"/docs/zh-TW/v5/account/set-mmp","docId":"v5/account/set-mmp"},{"type":"link","label":"\u91cd\u7f6e\u5e02\u5546\u4fdd\u8b77\u51cd\u7d50","href":"/docs/zh-TW/v5/account/reset-mmp","docId":"v5/account/reset-mmp"},{"type":"link","label":"\u67e5\u8a62\u5e02\u5546\u4fdd\u8b77\u914d\u7f6e\u4fe1\u606f","href":"/docs/zh-TW/v5/account/get-mmp-state","docId":"v5/account/get-mmp-state"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u8cc7\u7522","items":[{"type":"link","label":"\u67e5\u8a62\u4ea4\u5272\u7d00\u9304 (2\u5e74)","href":"/docs/zh-TW/v5/asset/delivery","docId":"v5/asset/delivery"},{"type":"link","label":"\u67e5\u8a62USDC\u7d50\u7b97\u7d00\u9304 (2\u5e74)","href":"/docs/zh-TW/v5/asset/settlement","docId":"v5/asset/settlement"},{"type":"link","label":"\u67e5\u8a62\u514c\u63db\u8a02\u55ae\u7d00\u9304","href":"/docs/zh-TW/v5/asset/exchange","docId":"v5/asset/exchange"},{"type":"link","label":"\u67e5\u8a62\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/asset/coin-info","docId":"v5/asset/coin-info"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u865f\u5217\u8868","href":"/docs/zh-TW/v5/asset/sub-uid-list","docId":"v5/asset/sub-uid-list"},{"type":"category","label":"\u9918\u984d","items":[{"type":"link","label":"\u67e5\u8a62\u8cc7\u7522\u4fe1\u606f (\u73fe\u8ca8)","href":"/docs/zh-TW/v5/asset/balance/asset-info","docId":"v5/asset/balance/asset-info"},{"type":"link","label":"\u67e5\u8a62\u8cec\u6236\u6240\u6709\u5e63\u7a2e\u4f59\u984d","href":"/docs/zh-TW/v5/asset/balance/all-balance","docId":"v5/asset/balance/all-balance"},{"type":"link","label":"\u67e5\u8a62\u5e33\u6236\u55ae\u500b\u5e63\u7a2e\u9918\u984d","href":"/docs/zh-TW/v5/asset/balance/account-coin-balance","docId":"v5/asset/balance/account-coin-balance"},{"type":"link","label":"\u67e5\u8a62\u5ef6\u9072\u63d0\u5e63\u51cd\u7d50\u91d1\u984d","href":"/docs/zh-TW/v5/asset/balance/delay-amount","docId":"v5/asset/balance/delay-amount"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5283\u8f49","items":[{"type":"link","label":"\u67e5\u8a62\u5283\u8f49\u7d00\u9304 (\u55ae\u5e33\u865f\u5167)","href":"/docs/zh-TW/v5/asset/transfer/inter-transfer-list","docId":"v5/asset/transfer/inter-transfer-list"},{"type":"link","label":"\u5e33\u6236\u985e\u578b\u9593\u53ef\u5283\u8f49\u7684\u5e63\u7a2e","href":"/docs/zh-TW/v5/asset/transfer/transferable-coin","docId":"v5/asset/transfer/transferable-coin"},{"type":"link","label":"\u5283\u8f49 (\u55ae\u5e33\u865f\u5167)","href":"/docs/zh-TW/v5/asset/transfer/create-inter-transfer","docId":"v5/asset/transfer/create-inter-transfer"},{"type":"link","label":"\u5275\u5efa\u842c\u80fd\u5283\u8f49","href":"/docs/zh-TW/v5/asset/transfer/unitransfer","docId":"v5/asset/transfer/unitransfer"},{"type":"link","label":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u7d00\u9304","href":"/docs/zh-TW/v5/asset/transfer/unitransfer-list","docId":"v5/asset/transfer/unitransfer-list"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5145\u503c","items":[{"type":"link","label":"\u67e5\u8a62\u652f\u6301\u7684\u5145\u503c\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/asset/deposit/deposit-coin-spec","docId":"v5/asset/deposit/deposit-coin-spec"},{"type":"link","label":"\u8a2d\u7f6e\u5145\u503c\u5e33\u6236","href":"/docs/zh-TW/v5/asset/deposit/set-deposit-acct","docId":"v5/asset/deposit/set-deposit-acct"},{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u7d00\u9304 (\u93c8\u4e0a)","href":"/docs/zh-TW/v5/asset/deposit/deposit-record","docId":"v5/asset/deposit/deposit-record"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u865f\u7684\u5145\u503c\u7d00\u9304 (\u93c8\u4e0a)","href":"/docs/zh-TW/v5/asset/deposit/sub-deposit-record","docId":"v5/asset/deposit/sub-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u5e73\u53f0\u8f6c\u8d26)","href":"/docs/zh-TW/v5/asset/deposit/internal-deposit-record","docId":"v5/asset/deposit/internal-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u4e3b\u5e33\u865f\u5145\u503c\u5730\u5740","href":"/docs/zh-TW/v5/asset/deposit/master-deposit-addr","docId":"v5/asset/deposit/master-deposit-addr"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u865f\u5145\u503c\u5730\u5740","href":"/docs/zh-TW/v5/asset/deposit/sub-deposit-addr","docId":"v5/asset/deposit/sub-deposit-addr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u63d0\u73fe","items":[{"type":"link","label":"\u67e5\u8a62\u63d0\u73fe\u7d00\u9304","href":"/docs/zh-TW/v5/asset/withdraw/withdraw-record","docId":"v5/asset/withdraw/withdraw-record"},{"type":"link","label":"\u67e5\u8a62\u4ea4\u6613\u6240\u5217\u8868 (\u97d3\u570b\u7528\u6236)","href":"/docs/zh-TW/v5/asset/withdraw/vasp-list","docId":"v5/asset/withdraw/vasp-list"},{"type":"link","label":"\u63d0\u73fe","href":"/docs/zh-TW/v5/asset/withdraw/","docId":"v5/asset/withdraw/withdraw"},{"type":"link","label":"\u64a4\u92b7\u63d0\u5e63","href":"/docs/zh-TW/v5/asset/withdraw/cancel-withdraw","docId":"v5/asset/withdraw/cancel-withdraw"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u9583\u514c","items":[{"type":"link","label":"\u63a5\u5165\u6307\u5357","href":"/docs/zh-TW/v5/asset/convert/guideline","docId":"v5/asset/convert/guideline"},{"type":"link","label":"\u67e5\u8a62\u514c\u63db\u5e63\u7a2e\u5217\u8868","href":"/docs/zh-TW/v5/asset/convert/convert-coin-list","docId":"v5/asset/convert/convert-coin-list"},{"type":"link","label":"\u7533\u8acb\u5831\u50f9","href":"/docs/zh-TW/v5/asset/convert/apply-quote","docId":"v5/asset/convert/apply-quote"},{"type":"link","label":"\u78ba\u8a8d\u5831\u50f9","href":"/docs/zh-TW/v5/asset/convert/confirm-quote","docId":"v5/asset/convert/confirm-quote"},{"type":"link","label":"\u67e5\u8a62\u5831\u50f9\u55ae\u72c0\u614b","href":"/docs/zh-TW/v5/asset/convert/get-convert-result","docId":"v5/asset/convert/get-convert-result"},{"type":"link","label":"\u67e5\u8a62\u514c\u63db\u6b77\u53f2","href":"/docs/zh-TW/v5/asset/convert/get-convert-history","docId":"v5/asset/convert/get-convert-history"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u7528\u6236","items":[{"type":"link","label":"\u65b0\u5efa\u5b50\u5e33\u6236","href":"/docs/zh-TW/v5/user/create-subuid","docId":"v5/user/create-subuid"},{"type":"link","label":"\u65b0\u5efa\u5b50\u5e33\u6236\u7684API Key","href":"/docs/zh-TW/v5/user/create-subuid-apikey","docId":"v5/user/create-subuid-apikey"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868 (\u9650\u5236)","href":"/docs/zh-TW/v5/user/subuid-list","docId":"v5/user/subuid-list"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868 (\u7121\u9650\u5236)","href":"/docs/zh-TW/v5/user/page-subuid","docId":"v5/user/page-subuid"},{"type":"link","label":"\u51cd\u7d50/\u89e3\u51cd\u5b50\u5e33\u6236","href":"/docs/zh-TW/v5/user/froze-subuid","docId":"v5/user/froze-subuid"},{"type":"link","label":"\u67e5\u8a62API Key\u76f8\u95dc\u4fe1\u606f","href":"/docs/zh-TW/v5/user/apikey-info","docId":"v5/user/apikey-info"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236\u7684\u6240\u6709API Key\u4fe1\u606f","href":"/docs/zh-TW/v5/user/list-sub-apikeys","docId":"v5/user/list-sub-apikeys"},{"type":"link","label":"\u67e5\u8a62\u5e33\u6236\u652f\u6301\u7684\u9322\u5305\u985e\u578b","href":"/docs/zh-TW/v5/user/wallet-type","docId":"v5/user/wallet-type"},{"type":"link","label":"\u4fee\u6539\u6bcd\u5e33\u6236\u7684API Key\u8a2d\u7f6e","href":"/docs/zh-TW/v5/user/modify-master-apikey","docId":"v5/user/modify-master-apikey"},{"type":"link","label":"\u4fee\u6539\u5b50\u5e33\u6236\u7684API Key\u8a2d\u7f6e","href":"/docs/zh-TW/v5/user/modify-sub-apikey","docId":"v5/user/modify-sub-apikey"},{"type":"link","label":"\u522a\u9664\u5b50\u5e33\u6236","href":"/docs/zh-TW/v5/user/rm-subuid","docId":"v5/user/rm-subuid"},{"type":"link","label":"\u522a\u9664\u6bcd\u5e33\u6236\u7684API Key","href":"/docs/zh-TW/v5/user/rm-master-apikey","docId":"v5/user/rm-master-apikey"},{"type":"link","label":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684API Key","href":"/docs/zh-TW/v5/user/rm-sub-apikey","docId":"v5/user/rm-sub-apikey"},{"type":"link","label":"\u67e5\u8a62\u4ee3\u7406\u7528\u6236\u4fe1\u606f","href":"/docs/zh-TW/v5/user/affiliate-info","docId":"v5/user/affiliate-info"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u69d3\u687f\u4ee3\u5e63","items":[{"type":"link","label":"LT\u5168\u91cf\u8cc7\u7522\u67e5\u8a62","href":"/docs/zh-TW/v5/lt/leverage-token-info","docId":"v5/lt/leverage-token-info"},{"type":"link","label":"\u67e5\u8a62LT\u884c\u60c5","href":"/docs/zh-TW/v5/lt/leverage-token-reference","docId":"v5/lt/leverage-token-reference"},{"type":"link","label":"\u7533\u8cfc","href":"/docs/zh-TW/v5/lt/purchase","docId":"v5/lt/purchase"},{"type":"link","label":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","href":"/docs/zh-TW/v5/lt/order-record","docId":"v5/lt/order-record"},{"type":"link","label":"\u8d16\u56de","href":"/docs/zh-TW/v5/lt/redeem","docId":"v5/lt/redeem"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5168\u5009\u69d3\u687f (\u7d71\u4e00\u5e33\u6236)","items":[{"type":"link","label":"\u67e5\u8a62\u4e0d\u540cVIP\u7684\u69d3\u687f\u6578\u64da","href":"/docs/zh-TW/v5/spot-margin-uta/vip-margin","docId":"v5/spot-margin-uta/vip-margin"},{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u6b77\u53f2\u5229\u7387","href":"/docs/zh-TW/v5/spot-margin-uta/historical-interest","docId":"v5/spot-margin-uta/historical-interest"},{"type":"link","label":"\u5168\u5009\u69d3\u687f\u958b\u95dc","href":"/docs/zh-TW/v5/spot-margin-uta/switch-mode","docId":"v5/spot-margin-uta/switch-mode"},{"type":"link","label":"\u5168\u5009\u69d3\u687f\u8a2d\u7f6e","href":"/docs/zh-TW/v5/spot-margin-uta/set-leverage","docId":"v5/spot-margin-uta/set-leverage"},{"type":"link","label":"\u67e5\u8a62\u958b\u95dc\u72c0\u614b\u548c\u500d\u6578","href":"/docs/zh-TW/v5/spot-margin-uta/status","docId":"v5/spot-margin-uta/status"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u6a5f\u69cb\u501f\u8cb8","items":[{"type":"link","label":"\u67e5\u8a62\u7522\u54c1\u4fe1\u606f","href":"/docs/zh-TW/v5/otc/margin-product-info","docId":"v5/otc/margin-product-info"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/otc/margin-coin-convert-info","docId":"v5/otc/margin-coin-convert-info"},{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u4fe1\u606f","href":"/docs/zh-TW/v5/otc/loan-info","docId":"v5/otc/loan-info"},{"type":"link","label":"\u67e5\u8a62\u9084\u6b3e\u4fe1\u606f","href":"/docs/zh-TW/v5/otc/repay-info","docId":"v5/otc/repay-info"},{"type":"link","label":"\u67e5\u8a62\u98a8\u96aa\u7387","href":"/docs/zh-TW/v5/otc/ltv-convert","docId":"v5/otc/ltv-convert"},{"type":"link","label":"\u7d81\u5b9a/\u89e3\u7d81UID","href":"/docs/zh-TW/v5/otc/bind-uid","docId":"v5/otc/bind-uid"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u7d93\u7d00\u5546","items":[{"type":"link","label":"\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63\u4fe1\u606f","href":"/docs/zh-TW/v5/broker/exchange-earning","docId":"v5/broker/exchange-earning"},{"type":"link","label":"\u67e5\u8a62\u7d93\u7d00\u5546\u5e33\u6236\u4fe1\u606f","href":"/docs/zh-TW/v5/broker/account-info","docId":"v5/broker/account-info"},{"type":"link","label":"\u67e5\u8a62\u7d93\u7d00\u5546\u7684\u5b50\u5e33\u865f\u5145\u503c\u7d00\u9304","href":"/docs/zh-TW/v5/broker/sub-deposit-record","docId":"v5/broker/sub-deposit-record"}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket\u6d41","items":[{"type":"link","label":"\u8a02\u95b1WebSocket","href":"/docs/zh-TW/v5/ws/connect","docId":"v5/websocket/wss-authentication"},{"type":"category","label":"\u516c\u5171\u983b\u9053","items":[{"type":"link","label":"\u6df1\u5ea6","href":"/docs/zh-TW/v5/websocket/public/orderbook","docId":"v5/websocket/public/orderbook"},{"type":"link","label":"\u5e73\u53f0\u6210\u4ea4","href":"/docs/zh-TW/v5/websocket/public/trade","docId":"v5/websocket/public/trade"},{"type":"link","label":"\u884c\u60c5","href":"/docs/zh-TW/v5/websocket/public/ticker","docId":"v5/websocket/public/ticker"},{"type":"link","label":"K\u7dda","href":"/docs/zh-TW/v5/websocket/public/kline","docId":"v5/websocket/public/kline"},{"type":"link","label":"\u5f37\u5e73\u63a8\u9001","href":"/docs/zh-TW/v5/websocket/public/liquidation","docId":"v5/websocket/public/liquidation"},{"type":"link","label":"ETP\u6de8\u503cK\u7dda","href":"/docs/zh-TW/v5/websocket/public/etp-kline","docId":"v5/websocket/public/etp-kline"},{"type":"link","label":"ETP\u6de8\u503c\u884c\u60c5\u63a8\u9001","href":"/docs/zh-TW/v5/websocket/public/etp-ticker","docId":"v5/websocket/public/etp-ticker"},{"type":"link","label":"ETP\u6700\u65b0\u6de8\u503c\u63a8\u9001","href":"/docs/zh-TW/v5/websocket/public/etp-nav","docId":"v5/websocket/public/etp-nav"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u79c1\u6709\u983b\u9053","items":[{"type":"link","label":"\u6301\u5009","href":"/docs/zh-TW/v5/websocket/private/position","docId":"v5/websocket/private/position"},{"type":"link","label":"\u500b\u4eba\u6210\u4ea4","href":"/docs/zh-TW/v5/websocket/private/execution","docId":"v5/websocket/private/execution"},{"type":"link","label":"\u500b\u4eba\u6210\u4ea4 (Fast)","href":"/docs/zh-TW/v5/websocket/private/fast-execution","docId":"v5/websocket/private/fast-execution"},{"type":"link","label":"\u8a02\u55ae","href":"/docs/zh-TW/v5/websocket/private/order","docId":"v5/websocket/private/order"},{"type":"link","label":"\u9322\u5305","href":"/docs/zh-TW/v5/websocket/private/wallet","docId":"v5/websocket/private/wallet"},{"type":"link","label":"\u7528\u6236\u5e0c\u81d8\u5b57\u6bcd\u4fe1\u606f (\u671f\u6b0a)","href":"/docs/zh-TW/v5/websocket/private/greek","docId":"v5/websocket/private/greek"},{"type":"link","label":"\u65b7\u7dda\u4fdd\u8b77 (\u671f\u6b0a)","href":"/docs/zh-TW/v5/websocket/private/dcp","docId":"v5/websocket/private/dcp"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u4ea4\u6613","items":[{"type":"link","label":"Websocket\u4e0b\u55ae\u6307\u5357","href":"/docs/zh-TW/v5/websocket/trade/guideline","docId":"v5/websocket/trade/guideline"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"\u983b\u7387\u9650\u5236","href":"/docs/zh-TW/v5/rate-limit","docId":"v5/rate-limit"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/v5/enum","docId":"v5/enum"},{"type":"link","label":"\u932f\u8aa4\u78bc","href":"/docs/zh-TW/v5/error","docId":"v5/error"},{"type":"category","label":"\u5ee2\u68c4\u63a5\u53e3","items":[{"type":"link","label":"\u67e5\u8a62\u53ef\u5b58\u5165\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/abandon/coin-info","docId":"v5/abandon/coin-info"},{"type":"link","label":"\u67e5\u8a62\u98a8\u96aa\u7387","href":"/docs/zh-TW/v5/abandon/ltv","docId":"v5/abandon/ltv"},{"type":"link","label":"\u5b58\u5165\u8cc7\u91d1","href":"/docs/zh-TW/v5/abandon/deposit","docId":"v5/abandon/deposit"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/abandon/margin-coin-info","docId":"v5/abandon/margin-coin-info"},{"type":"link","label":"\u914d\u7f6e\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u5e33\u865f","href":"/docs/zh-TW/v5/abandon/enable-unitransfer-subuid","docId":"v5/abandon/enable-unitransfer-subuid"},{"type":"link","label":"\u8d16\u56de\u8cc7\u91d1","href":"/docs/zh-TW/v5/abandon/redeem","docId":"v5/abandon/redeem"},{"type":"link","label":"\u64a4\u92b7\u8d16\u56de","href":"/docs/zh-TW/v5/abandon/cancel-redeem","docId":"v5/abandon/cancel-redeem"},{"type":"link","label":"\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63","href":"/docs/zh-TW/v5/abandon/earning","docId":"v5/abandon/earning"},{"type":"link","label":"\u67e5\u8a62\u8a02\u55ae\u6b77\u53f2","href":"/docs/zh-TW/v5/abandon/order-record","docId":"v5/abandon/order-record"},{"type":"link","label":"\u67e5\u8a62\u4f59\u5e63\u5bf6\u5e33\u6236\u4fe1\u606f","href":"/docs/zh-TW/v5/abandon/account-info","docId":"v5/abandon/account-info"}],"collapsed":true,"collapsible":true}],"apiExplorerSideBar":[{"type":"category","label":"V5","items":[{"type":"category","label":"Market","items":[{"type":"link","label":"Get Bybit Server Time","href":"/docs/zh-TW/api-explorer/v5/market/time","className":"api-method get","docId":"api-explorer/v5/market/time"},{"type":"link","label":"Get Kline","href":"/docs/zh-TW/api-explorer/v5/market/kline","className":"api-method get","docId":"api-explorer/v5/market/kline"},{"type":"link","label":"Get Mark Price Kline","href":"/docs/zh-TW/api-explorer/v5/market/mark-kline","className":"api-method get","docId":"api-explorer/v5/market/mark-kline"},{"type":"link","label":"Get Index Price Kline","href":"/docs/zh-TW/api-explorer/v5/market/index-kline","className":"api-method get","docId":"api-explorer/v5/market/index-kline"},{"type":"link","label":"Get Premium Index Price Kline","href":"/docs/zh-TW/api-explorer/v5/market/premium-index-kline","className":"api-method get","docId":"api-explorer/v5/market/premium-index-kline"},{"type":"link","label":"Get Instrument Info","href":"/docs/zh-TW/api-explorer/v5/market/instrument","className":"api-method get","docId":"api-explorer/v5/market/instrument"},{"type":"link","label":"Get Orderbook","href":"/docs/zh-TW/api-explorer/v5/market/orderbook","className":"api-method get","docId":"api-explorer/v5/market/orderbook"},{"type":"link","label":"Get Tickers","href":"/docs/zh-TW/api-explorer/v5/market/tickers","className":"api-method get","docId":"api-explorer/v5/market/tickers"},{"type":"link","label":"Get Funding Rate History","href":"/docs/zh-TW/api-explorer/v5/market/history-fund-rate","className":"api-method get","docId":"api-explorer/v5/market/history-fund-rate"},{"type":"link","label":"Get Public Recent Trading History","href":"/docs/zh-TW/api-explorer/v5/market/recent-trade","className":"api-method get","docId":"api-explorer/v5/market/recent-trade"},{"type":"link","label":"Get Open Interest","href":"/docs/zh-TW/api-explorer/v5/market/open-interest","className":"api-method get","docId":"api-explorer/v5/market/open-interest"},{"type":"link","label":"Get Historical Volatility","href":"/docs/zh-TW/api-explorer/v5/market/iv","className":"api-method get","docId":"api-explorer/v5/market/iv"},{"type":"link","label":"Get Insurance","href":"/docs/zh-TW/api-explorer/v5/market/insurance","className":"api-method get","docId":"api-explorer/v5/market/insurance"},{"type":"link","label":"Get Risk Limit","href":"/docs/zh-TW/api-explorer/v5/market/risk-limit","className":"api-method get","docId":"api-explorer/v5/market/risk-limit"},{"type":"link","label":"Get Delivery Price","href":"/docs/zh-TW/api-explorer/v5/market/delivery-price","className":"api-method get","docId":"api-explorer/v5/market/delivery-price"},{"type":"link","label":"Get Long Short Ratio","href":"/docs/zh-TW/api-explorer/v5/market/long-short-ratio","className":"api-method get","docId":"api-explorer/v5/market/long-short-ratio"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/market/market"},{"type":"category","label":"Trade","items":[{"type":"link","label":"Place Order","href":"/docs/zh-TW/api-explorer/v5/trade/create-order","className":"api-method post","docId":"api-explorer/v5/trade/create-order"},{"type":"link","label":"Amend Order","href":"/docs/zh-TW/api-explorer/v5/trade/amend-order","className":"api-method post","docId":"api-explorer/v5/trade/amend-order"},{"type":"link","label":"Cancel Order","href":"/docs/zh-TW/api-explorer/v5/trade/cancel-order","className":"api-method post","docId":"api-explorer/v5/trade/cancel-order"},{"type":"link","label":"Get Open Orders (real-time)","href":"/docs/zh-TW/api-explorer/v5/trade/open-order","className":"api-method get","docId":"api-explorer/v5/trade/open-order"},{"type":"link","label":"Cancel All Orders","href":"/docs/zh-TW/api-explorer/v5/trade/cancel-all","className":"api-method post","docId":"api-explorer/v5/trade/cancel-all"},{"type":"link","label":"Get Order History (2 years)","href":"/docs/zh-TW/api-explorer/v5/trade/order-list","className":"api-method get","docId":"api-explorer/v5/trade/order-list"},{"type":"link","label":"Batch Place Order","href":"/docs/zh-TW/api-explorer/v5/trade/batch-place","className":"api-method post","docId":"api-explorer/v5/trade/batch-place"},{"type":"link","label":"Batch Amend Order","href":"/docs/zh-TW/api-explorer/v5/trade/batch-amend","className":"api-method post","docId":"api-explorer/v5/trade/batch-amend"},{"type":"link","label":"Batch Cancel Order","href":"/docs/zh-TW/api-explorer/v5/trade/batch-cancel","className":"api-method post","docId":"api-explorer/v5/trade/batch-cancel"},{"type":"link","label":"Get Borrow Quota (Spot)","href":"/docs/zh-TW/api-explorer/v5/trade/query-spot-quota","className":"api-method get","docId":"api-explorer/v5/trade/query-spot-quota"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/trade/trade"},{"type":"category","label":"Position","items":[{"type":"link","label":"Get Position Info","href":"/docs/zh-TW/api-explorer/v5/position/position-info","className":"api-method get","docId":"api-explorer/v5/position/position-info"},{"type":"link","label":"Set Leverage","href":"/docs/zh-TW/api-explorer/v5/position/leverage","className":"api-method post","docId":"api-explorer/v5/position/leverage"},{"type":"link","label":"Switch Cross/Isolated Margin","href":"/docs/zh-TW/api-explorer/v5/position/cross-isolate","className":"api-method post","docId":"api-explorer/v5/position/cross-isolate"},{"type":"link","label":"Set TP/SL Mode","href":"/docs/zh-TW/api-explorer/v5/position/tpsl-mode","className":"api-method post","docId":"api-explorer/v5/position/tpsl-mode"},{"type":"link","label":"Switch Position Mode","href":"/docs/zh-TW/api-explorer/v5/position/position-mode","className":"api-method post","docId":"api-explorer/v5/position/position-mode"},{"type":"link","label":"Set Risk Limit","href":"/docs/zh-TW/api-explorer/v5/position/set-risk-limit","className":"api-method post","docId":"api-explorer/v5/position/set-risk-limit"},{"type":"link","label":"Set Trading Stop","href":"/docs/zh-TW/api-explorer/v5/position/trading-stop","className":"api-method post","docId":"api-explorer/v5/position/trading-stop"},{"type":"link","label":"Set Auto Add Margin","href":"/docs/zh-TW/api-explorer/v5/position/auto-add-margin","className":"api-method post","docId":"api-explorer/v5/position/auto-add-margin"},{"type":"link","label":"Add Or Reduce Margin","href":"/docs/zh-TW/api-explorer/v5/position/manual-add-margin","className":"api-method post","docId":"api-explorer/v5/position/manual-add-margin"},{"type":"link","label":"Get Execution (2 years)","href":"/docs/zh-TW/api-explorer/v5/position/execution","className":"api-method get","docId":"api-explorer/v5/position/execution"},{"type":"link","label":"Get Closed PnL","href":"/docs/zh-TW/api-explorer/v5/position/close-pnl","className":"api-method get","docId":"api-explorer/v5/position/close-pnl"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/position/position"},{"type":"category","label":"Account","items":[{"type":"link","label":"Get Wallet Balance","href":"/docs/zh-TW/api-explorer/v5/account/wallet","className":"api-method get","docId":"api-explorer/v5/account/wallet"},{"type":"link","label":"Upgrade to Unified Account","href":"/docs/zh-TW/api-explorer/v5/account/upgrade-unified-account","className":"api-method post","docId":"api-explorer/v5/account/upgrade-unified-account"},{"type":"link","label":"Set Collateral Coin","href":"/docs/zh-TW/api-explorer/v5/account/set-collateral","className":"api-method post","docId":"api-explorer/v5/account/set-collateral"},{"type":"link","label":"Get Borrow History","href":"/docs/zh-TW/api-explorer/v5/account/borrow-history","className":"api-method get","docId":"api-explorer/v5/account/borrow-history"},{"type":"link","label":"Get Collateral Info","href":"/docs/zh-TW/api-explorer/v5/account/collateral-info","className":"api-method get","docId":"api-explorer/v5/account/collateral-info"},{"type":"link","label":"Get Coin Greeks","href":"/docs/zh-TW/api-explorer/v5/account/coin-greeks","className":"api-method get","docId":"api-explorer/v5/account/coin-greeks"},{"type":"link","label":"Get Fee Rate","href":"/docs/zh-TW/api-explorer/v5/account/fee-rate","className":"api-method get","docId":"api-explorer/v5/account/fee-rate"},{"type":"link","label":"Get Account Info","href":"/docs/zh-TW/api-explorer/v5/account/account-info","className":"api-method get","docId":"api-explorer/v5/account/account-info"},{"type":"link","label":"Get Transaction Log","href":"/docs/zh-TW/api-explorer/v5/account/transaction-log","className":"api-method get","docId":"api-explorer/v5/account/transaction-log"},{"type":"link","label":"Set Margin Mode","href":"/docs/zh-TW/api-explorer/v5/account/set-margin-mode","className":"api-method post","docId":"api-explorer/v5/account/set-margin-mode"},{"type":"link","label":"Set Spot Hedging","href":"/docs/zh-TW/api-explorer/v5/account/set-spot-hedge","className":"api-method post","docId":"api-explorer/v5/account/set-spot-hedge"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/account/account"},{"type":"category","label":"Asset","items":[{"type":"link","label":"Get Coin Exchange Records","href":"/docs/zh-TW/api-explorer/v5/asset/exchange","className":"api-method get","docId":"api-explorer/v5/asset/exchange"},{"type":"link","label":"Get Delivery Record","href":"/docs/zh-TW/api-explorer/v5/asset/delivery","className":"api-method get","docId":"api-explorer/v5/asset/delivery"},{"type":"link","label":"Get USDC Session Settlement","href":"/docs/zh-TW/api-explorer/v5/asset/settlement","className":"api-method get","docId":"api-explorer/v5/asset/settlement"},{"type":"link","label":"Get Asset Info (Spot)","href":"/docs/zh-TW/api-explorer/v5/asset/asset-info","className":"api-method get","docId":"api-explorer/v5/asset/asset-info"},{"type":"link","label":"Get All Coins Balance","href":"/docs/zh-TW/api-explorer/v5/asset/all-balance","className":"api-method get","docId":"api-explorer/v5/asset/all-balance"},{"type":"link","label":"Get Single Coin Balance","href":"/docs/zh-TW/api-explorer/v5/asset/account-coin-balance","className":"api-method get","docId":"api-explorer/v5/asset/account-coin-balance"},{"type":"link","label":"Get Transferable Coin","href":"/docs/zh-TW/api-explorer/v5/asset/transferable-coin","className":"api-method get","docId":"api-explorer/v5/asset/transferable-coin"},{"type":"link","label":"Create Internal Transfer","href":"/docs/zh-TW/api-explorer/v5/asset/create-inter-transfer","className":"api-method post","docId":"api-explorer/v5/asset/create-inter-transfer"},{"type":"link","label":"Get Internal Transfer Records","href":"/docs/zh-TW/api-explorer/v5/asset/inter-transfer-list","className":"api-method get","docId":"api-explorer/v5/asset/inter-transfer-list"},{"type":"link","label":"Get Sub UID","href":"/docs/zh-TW/api-explorer/v5/asset/sub-uid-list","className":"api-method get","docId":"api-explorer/v5/asset/sub-uid-list"},{"type":"link","label":"Create Universal Transfer","href":"/docs/zh-TW/api-explorer/v5/asset/unitransfer","className":"api-method post","docId":"api-explorer/v5/asset/unitransfer"},{"type":"link","label":"Get Universal Transfer Records","href":"/docs/zh-TW/api-explorer/v5/asset/unitransfer-list","className":"api-method get","docId":"api-explorer/v5/asset/unitransfer-list"},{"type":"link","label":"Get Allowed Deposit Coin Info","href":"/docs/zh-TW/api-explorer/v5/asset/deposit-coin-spec","className":"api-method get","docId":"api-explorer/v5/asset/deposit-coin-spec"},{"type":"link","label":"Set Deposit Account","href":"/docs/zh-TW/api-explorer/v5/asset/set-deposit-acct","className":"api-method post","docId":"api-explorer/v5/asset/set-deposit-acct"},{"type":"link","label":"Get Deposit Record (on-chain)","href":"/docs/zh-TW/api-explorer/v5/asset/deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/deposit-record"},{"type":"link","label":"Get Sub Account Deposit Records (on-chain)","href":"/docs/zh-TW/api-explorer/v5/asset/sub-deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/sub-deposit-record"},{"type":"link","label":"Get Internal Deposit Records (off-chain)","href":"/docs/zh-TW/api-explorer/v5/asset/internal-deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/internal-deposit-record"},{"type":"link","label":"Get Master Deposit Address","href":"/docs/zh-TW/api-explorer/v5/asset/master-deposit-addr","className":"api-method get","docId":"api-explorer/v5/asset/master-deposit-addr"},{"type":"link","label":"Get Sub Deposit Address","href":"/docs/zh-TW/api-explorer/v5/asset/sub-deposit-addr","className":"api-method get","docId":"api-explorer/v5/asset/sub-deposit-addr"},{"type":"link","label":"Get Coin Info","href":"/docs/zh-TW/api-explorer/v5/asset/coin-info","className":"api-method get","docId":"api-explorer/v5/asset/coin-info"},{"type":"link","label":"Get Withdraw Records","href":"/docs/zh-TW/api-explorer/v5/asset/withdraw-record","className":"api-method get","docId":"api-explorer/v5/asset/withdraw-record"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/asset/asset"},{"type":"category","label":"User","items":[{"type":"link","label":"Get API Key Information","href":"/docs/zh-TW/api-explorer/v5/user/apikey-info","className":"api-method get","docId":"api-explorer/v5/user/apikey-info"},{"type":"link","label":"Get Sub Account All API Keys","href":"/docs/zh-TW/api-explorer/v5/user/list-sub-apikeys","className":"api-method get","docId":"api-explorer/v5/user/list-sub-apikeys"},{"type":"link","label":"Get UID Wallet Type","href":"/docs/zh-TW/api-explorer/v5/user/wallet-type","className":"api-method get","docId":"api-explorer/v5/user/wallet-type"},{"type":"link","label":"Get Affiliate User Info","href":"/docs/zh-TW/api-explorer/v5/user/affiliate-info","className":"api-method get","docId":"api-explorer/v5/user/affiliate-info"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/user/user"},{"type":"category","label":"Spot Leverage Token","items":[{"type":"link","label":"Get Leverage Token Info","href":"/docs/zh-TW/api-explorer/v5/lt/leverage-token-info","className":"api-method get","docId":"api-explorer/v5/lt/leverage-token-info"},{"type":"link","label":"Get Leverage Token Market","href":"/docs/zh-TW/api-explorer/v5/lt/leverage-token-reference","className":"api-method get","docId":"api-explorer/v5/lt/leverage-token-reference"},{"type":"link","label":"Purchase","href":"/docs/zh-TW/api-explorer/v5/lt/purchase","className":"api-method post","docId":"api-explorer/v5/lt/purchase"},{"type":"link","label":"Redeem","href":"/docs/zh-TW/api-explorer/v5/lt/redeem","className":"api-method post","docId":"api-explorer/v5/lt/redeem"},{"type":"link","label":"Get Purchase or Redeem Records","href":"/docs/zh-TW/api-explorer/v5/lt/order-record","className":"api-method get","docId":"api-explorer/v5/lt/order-record"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/lt/etp"},{"type":"category","label":"Spot Margin Trade (UTA)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/vip-margin","className":"api-method get","docId":"api-explorer/v5/spot-margin-uta/vip-margin"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/switch-mode","className":"api-method post","docId":"api-explorer/v5/spot-margin-uta/switch-mode"},{"type":"link","label":"Set Leverage","href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/set-leverage","className":"api-method post","docId":"api-explorer/v5/spot-margin-uta/set-leverage"},{"type":"link","label":"Get Status And Leverage","href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/status","className":"api-method get","docId":"api-explorer/v5/spot-margin-uta/status"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/uta-margin-trade"},{"type":"category","label":"Spot Margin Trade (Classic)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/vip-margin","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/vip-margin"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/margin-data","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/margin-data"},{"type":"link","label":"Get Borrowable Coin Info","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/borrowable-data","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/borrowable-data"},{"type":"link","label":"Get Interest & Quota","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/interest-quota","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/interest-quota"},{"type":"link","label":"Get Loan Account Info","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/account-info","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/account-info"},{"type":"link","label":"Borrow","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/borrow","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/borrow"},{"type":"link","label":"Repay","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/repay","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/repay"},{"type":"link","label":"Get Borrow Order Detail","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/borrow-order","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/borrow-order"},{"type":"link","label":"Get Repayment Order Detail","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/repay-order","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/repay-order"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/switch-mode","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/switch-mode"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/normal-margin-trade"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/category/"}],"changelogSidebar":[{"type":"link","label":"V5","href":"/docs/zh-TW/changelog/v5","docId":"changelog/v5"},{"type":"link","label":"\u884d\u751f\u54c1 V3","href":"/docs/zh-TW/changelog/derivatives-v3","docId":"changelog/derivatives-v3"},{"type":"link","label":"\u73fe\u8ca8 V3","href":"/docs/zh-TW/changelog/spot-v3","docId":"changelog/spot-v3"},{"type":"link","label":"\u5e33\u6236\u8cc7\u7522 V3","href":"/docs/zh-TW/changelog/asset-v3","docId":"changelog/asset-v3"},{"type":"link","label":"\u8ddf\u55ae\u4ea4\u6613","href":"/docs/zh-TW/changelog/copytrade","docId":"changelog/copytrade"}]},"docs":{"api-explorer/v5/account/account":{"id":"api-explorer/v5/account/account","title":"Account","description":"Account","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/account-info":{"id":"api-explorer/v5/account/account-info","title":"Get Account Info","description":"Get account info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/borrow-history":{"id":"api-explorer/v5/account/borrow-history","title":"Get Borrow History","description":"Get borrow history","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/coin-greeks":{"id":"api-explorer/v5/account/coin-greeks","title":"Get Coin Greeks","description":"Get coin greek info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/collateral-info":{"id":"api-explorer/v5/account/collateral-info","title":"Get Collateral Info","description":"Get collateral info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/fee-rate":{"id":"api-explorer/v5/account/fee-rate","title":"Get Fee Rate","description":"Get fee rate","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-collateral":{"id":"api-explorer/v5/account/set-collateral","title":"Set Collateral Coin","description":"Set collateral coin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-margin-mode":{"id":"api-explorer/v5/account/set-margin-mode","title":"Set Margin Mode","description":"Set margin mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-spot-hedge":{"id":"api-explorer/v5/account/set-spot-hedge","title":"Set Spot Hedging","description":"Set spot hedging for Portfolio margin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/transaction-log":{"id":"api-explorer/v5/account/transaction-log","title":"Get Transaction Log","description":"Get transaction log","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/upgrade-unified-account":{"id":"api-explorer/v5/account/upgrade-unified-account","title":"Upgrade to Unified Account","description":"Upgrade to UTA","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/wallet":{"id":"api-explorer/v5/account/wallet","title":"Get Wallet Balance","description":"Get wallet balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/account-coin-balance":{"id":"api-explorer/v5/asset/account-coin-balance","title":"Get Single Coin Balance","description":"Get Single Coin Balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/all-balance":{"id":"api-explorer/v5/asset/all-balance","title":"Get All Coins Balance","description":"Get All Coins Balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/asset":{"id":"api-explorer/v5/asset/asset","title":"Asset","description":"Asset","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/asset-info":{"id":"api-explorer/v5/asset/asset-info","title":"Get Asset Info (Spot)","description":"Get spot asset","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/coin-info":{"id":"api-explorer/v5/asset/coin-info","title":"Get Coin Info","description":"Get coin info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/create-inter-transfer":{"id":"api-explorer/v5/asset/create-inter-transfer","title":"Create Internal Transfer","description":"Create internal transfer","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/delivery":{"id":"api-explorer/v5/asset/delivery","title":"Get Delivery Record","description":"Get delivery record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/deposit-coin-spec":{"id":"api-explorer/v5/asset/deposit-coin-spec","title":"Get Allowed Deposit Coin Info","description":"Get allowed deposit coin info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/deposit-record":{"id":"api-explorer/v5/asset/deposit-record","title":"Get Deposit Record (on-chain)","description":"Get deposit record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/exchange":{"id":"api-explorer/v5/asset/exchange","title":"Get Coin Exchange Records","description":"Get exchange records","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/inter-transfer-list":{"id":"api-explorer/v5/asset/inter-transfer-list","title":"Get Internal Transfer Records","description":"Get internal transfer records","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/internal-deposit-record":{"id":"api-explorer/v5/asset/internal-deposit-record","title":"Get Internal Deposit Records (off-chain)","description":"Get deposit records through Bybit platform","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/master-deposit-addr":{"id":"api-explorer/v5/asset/master-deposit-addr","title":"Get Master Deposit Address","description":"Get master deposit address","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/set-deposit-acct":{"id":"api-explorer/v5/asset/set-deposit-acct","title":"Set Deposit Account","description":"Set Deposit Account","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/settlement":{"id":"api-explorer/v5/asset/settlement","title":"Get USDC Session Settlement","description":"Get usdc session settlement record.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-deposit-addr":{"id":"api-explorer/v5/asset/sub-deposit-addr","title":"Get Sub Deposit Address","description":"Get sub deposit address","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-deposit-record":{"id":"api-explorer/v5/asset/sub-deposit-record","title":"Get Sub Account Deposit Records (on-chain)","description":"Get sub account deposit record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-uid-list":{"id":"api-explorer/v5/asset/sub-uid-list","title":"Get Sub UID","description":"Get sub uid","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/transferable-coin":{"id":"api-explorer/v5/asset/transferable-coin","title":"Get Transferable Coin","description":"Get transferable coins","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/unitransfer":{"id":"api-explorer/v5/asset/unitransfer","title":"Create Universal Transfer","description":"Create universal transfer","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/unitransfer-list":{"id":"api-explorer/v5/asset/unitransfer-list","title":"Get Universal Transfer Records","description":"Get universal transfer record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/withdraw-record":{"id":"api-explorer/v5/asset/withdraw-record","title":"Get Withdraw Records","description":"Get withdraw record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/etp":{"id":"api-explorer/v5/lt/etp","title":"Spot Leverage Token","description":"Spot Leverage Token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/leverage-token-info":{"id":"api-explorer/v5/lt/leverage-token-info","title":"Get Leverage Token Info","description":"Get lt information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/leverage-token-reference":{"id":"api-explorer/v5/lt/leverage-token-reference","title":"Get Leverage Token Market","description":"Get lt market information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/order-record":{"id":"api-explorer/v5/lt/order-record","title":"Get Purchase or Redeem Records","description":"Get the order history of purchase or redeem","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/purchase":{"id":"api-explorer/v5/lt/purchase","title":"Purchase","description":"Purchase leverage token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/redeem":{"id":"api-explorer/v5/lt/redeem","title":"Redeem","description":"Redeem leverage token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/delivery-price":{"id":"api-explorer/v5/market/delivery-price","title":"Get Delivery Price","description":"Get delivery price","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/history-fund-rate":{"id":"api-explorer/v5/market/history-fund-rate","title":"Get Funding Rate History","description":"Get historical funding rate","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/index-kline":{"id":"api-explorer/v5/market/index-kline","title":"Get Index Price Kline","description":"Get Index Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/instrument":{"id":"api-explorer/v5/market/instrument","title":"Get Instrument Info","description":"Get launched instruments information.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/insurance":{"id":"api-explorer/v5/market/insurance","title":"Get Insurance","description":"Get Insurance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/iv":{"id":"api-explorer/v5/market/iv","title":"Get Historical Volatility","description":"Get historical volatility","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/kline":{"id":"api-explorer/v5/market/kline","title":"Get Kline","description":"Get kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/long-short-ratio":{"id":"api-explorer/v5/market/long-short-ratio","title":"Get Long Short Ratio","description":"Get long short ratio","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/mark-kline":{"id":"api-explorer/v5/market/mark-kline","title":"Get Mark Price Kline","description":"Get Mark Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/market":{"id":"api-explorer/v5/market/market","title":"Market","description":"Market","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/open-interest":{"id":"api-explorer/v5/market/open-interest","title":"Get Open Interest","description":"Get open interest","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/orderbook":{"id":"api-explorer/v5/market/orderbook","title":"Get Orderbook","description":"Get order book data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/premium-index-kline":{"id":"api-explorer/v5/market/premium-index-kline","title":"Get Premium Index Price Kline","description":"Get Premium Index Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/recent-trade":{"id":"api-explorer/v5/market/recent-trade","title":"Get Public Recent Trading History","description":"Get public trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/risk-limit":{"id":"api-explorer/v5/market/risk-limit","title":"Get Risk Limit","description":"Get risk limit","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/tickers":{"id":"api-explorer/v5/market/tickers","title":"Get Tickers","description":"Get all latest information of symbols. All parameters are needed for OPTION","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/time":{"id":"api-explorer/v5/market/time","title":"Get Bybit Server Time","description":"Get server time","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/auto-add-margin":{"id":"api-explorer/v5/position/auto-add-margin","title":"Set Auto Add Margin","description":"Set Auto Add Margin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/close-pnl":{"id":"api-explorer/v5/position/close-pnl","title":"Get Closed PnL","description":"Get closed pnl","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/cross-isolate":{"id":"api-explorer/v5/position/cross-isolate","title":"Switch Cross/Isolated Margin","description":"Select cross margin mode or isolated margin mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/execution":{"id":"api-explorer/v5/position/execution","title":"Get Execution (2 years)","description":"Get execution list","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/leverage":{"id":"api-explorer/v5/position/leverage","title":"Set Leverage","description":"Set levearage.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/manual-add-margin":{"id":"api-explorer/v5/position/manual-add-margin","title":"Add Or Reduce Margin","description":"Manually add or reduce margin for isolated margin position","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position":{"id":"api-explorer/v5/position/position","title":"Position","description":"Position","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position-info":{"id":"api-explorer/v5/position/position-info","title":"Get Position Info","description":"Get Position Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position-mode":{"id":"api-explorer/v5/position/position-mode","title":"Switch Position Mode","description":"Switch Position Mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/set-risk-limit":{"id":"api-explorer/v5/position/set-risk-limit","title":"Set Risk Limit","description":"Set risk limit.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/tpsl-mode":{"id":"api-explorer/v5/position/tpsl-mode","title":"Set TP/SL Mode","description":"Set tp/sl mode.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/trading-stop":{"id":"api-explorer/v5/position/trading-stop","title":"Set Trading Stop","description":"Set trade stop.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/account-info":{"id":"api-explorer/v5/spot-margin-normal/account-info","title":"Get Loan Account Info","description":"Get Loan Account Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrow":{"id":"api-explorer/v5/spot-margin-normal/borrow","title":"Borrow","description":"Borrow","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrow-order":{"id":"api-explorer/v5/spot-margin-normal/borrow-order","title":"Get Borrow Order Detail","description":"Get Borrow Order Detail","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrowable-data":{"id":"api-explorer/v5/spot-margin-normal/borrowable-data","title":"Get Borrowable Coin Info","description":"Get Borrowable Coin Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/interest-quota":{"id":"api-explorer/v5/spot-margin-normal/interest-quota","title":"Get Interest & Quota","description":"Get Interest & Quota","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/margin-data":{"id":"api-explorer/v5/spot-margin-normal/margin-data","title":"Get Margin Coin Info","description":"Get Margin Coin Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/normal-margin-trade":{"id":"api-explorer/v5/spot-margin-normal/normal-margin-trade","title":"Spot Margin Trade (Classic)","description":"Spot Margin Trade (Classic)","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/repay":{"id":"api-explorer/v5/spot-margin-normal/repay","title":"Repay","description":"Repay","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/repay-order":{"id":"api-explorer/v5/spot-margin-normal/repay-order","title":"Get Repayment Order Detail","description":"Get Repayment Order Detail","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/switch-mode":{"id":"api-explorer/v5/spot-margin-normal/switch-mode","title":"Toggle Margin Trade","description":"Toggle Margin Trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/vip-margin":{"id":"api-explorer/v5/spot-margin-normal/vip-margin","title":"Get VIP Margin Data","description":"Get vip margin data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/set-leverage":{"id":"api-explorer/v5/spot-margin-uta/set-leverage","title":"Set Leverage","description":"Set leverage for margin trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/status":{"id":"api-explorer/v5/spot-margin-uta/status","title":"Get Status And Leverage","description":"Get status and leverage","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/switch-mode":{"id":"api-explorer/v5/spot-margin-uta/switch-mode","title":"Toggle Margin Trade","description":"Toggle margin trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/uta-margin-trade":{"id":"api-explorer/v5/spot-margin-uta/uta-margin-trade","title":"Spot Margin Trade (UTA)","description":"Spot Margin Trade (UTA)","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/vip-margin":{"id":"api-explorer/v5/spot-margin-uta/vip-margin","title":"Get VIP Margin Data","description":"Get vip margin data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/amend-order":{"id":"api-explorer/v5/trade/amend-order","title":"Amend Order","description":"Amend an order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-amend":{"id":"api-explorer/v5/trade/batch-amend","title":"Batch Amend Order","description":"Batch amend orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-cancel":{"id":"api-explorer/v5/trade/batch-cancel","title":"Batch Cancel Order","description":"Batch cancel orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-place":{"id":"api-explorer/v5/trade/batch-place","title":"Batch Place Order","description":"Batch place orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/cancel-all":{"id":"api-explorer/v5/trade/cancel-all","title":"Cancel All Orders","description":"Cancel all orders.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/cancel-order":{"id":"api-explorer/v5/trade/cancel-order","title":"Cancel Order","description":"Cancel a single order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/create-order":{"id":"api-explorer/v5/trade/create-order","title":"Place Order","description":"Place an order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/open-order":{"id":"api-explorer/v5/trade/open-order","title":"Get Open Orders (real-time)","description":"Get unfilled orders or partially filled orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/order-list":{"id":"api-explorer/v5/trade/order-list","title":"Get Order History (2 years)","description":"Get order history.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/query-spot-quota":{"id":"api-explorer/v5/trade/query-spot-quota","title":"Get Borrow Quota (Spot)","description":"Query user\'s spot available quota","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/trade":{"id":"api-explorer/v5/trade/trade","title":"Trade","description":"Trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/affiliate-info":{"id":"api-explorer/v5/user/affiliate-info","title":"Get Affiliate User Info","description":"Get affiliate user info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/apikey-info":{"id":"api-explorer/v5/user/apikey-info","title":"Get API Key Information","description":"Get API Key Information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/list-sub-apikeys":{"id":"api-explorer/v5/user/list-sub-apikeys","title":"Get Sub Account All API Keys","description":"Get Sub Account All API Keys","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/user":{"id":"api-explorer/v5/user/user","title":"User","description":"User","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/wallet-type":{"id":"api-explorer/v5/user/wallet-type","title":"Get UID Wallet Type","description":"Get uid wallet type","sidebar":"apiExplorerSideBar"},"changelog/asset-v3":{"id":"changelog/asset-v3","title":"\u5e33\u6236\u8cc7\u7522 V3","description":"2024-05-09","sidebar":"changelogSidebar"},"changelog/copytrade":{"id":"changelog/copytrade","title":"\u8ddf\u55ae\u4ea4\u6613","description":"2023-06-24","sidebar":"changelogSidebar"},"changelog/derivatives-v3":{"id":"changelog/derivatives-v3","title":"\u884d\u751f\u54c1 V3","description":"2024-05-09","sidebar":"changelogSidebar"},"changelog/spot-v3":{"id":"changelog/spot-v3","title":"\u73fe\u8ca8 V3","description":"2023-04-20","sidebar":"changelogSidebar"},"changelog/v5":{"id":"changelog/v5","title":"V5","description":"20234-08-13","sidebar":"changelogSidebar"},"faq":{"id":"faq","title":"\u5e38\u898b\u554f\u984c","description":"Bybit\u7684\u670d\u52d9\u5668\u5728\u54ea\u88e1?"},"pilot-feature/pilot":{"id":"pilot-feature/pilot","title":"\u8a66\u9ede\u529f\u80fd","description":"Open API\u652f\u6301\u6a21\u64ec\u4ea4\u6613"},"v3/account-asset/enum":{"id":"v3/account-asset/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"accountType","sidebar":"v3SideBar"},"v3/account-asset/error":{"id":"v3/account-asset/error","title":"\u932f\u8aa4\u78bc","description":"|\u932f\u8aa4\u78bc |\u63cf\u8ff0 |","sidebar":"v3SideBar"},"v3/account-asset/rate-limit":{"id":"v3/account-asset/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b","sidebar":"v3SideBar"},"v3/account-asset/transfer/all-balance":{"id":"v3/account-asset/transfer/all-balance","title":"\u67e5\u8a62\u8cec\u6236\u6240\u6709\u5e63\u7a2e\u4f59\u984d","description":"\u652f\u6301\u67e5\u8a62\u6bcd\u5e33\u6236\u7684\u5404\u500b\u5e33\u6236\u985e\u578b\u7684\u5e63\u7a2e\u9918\u984d\uff0c\u4ee5\u53ca\u6bcd\u5e33\u6236\u4e0b\u5404\u5b50\u5e33\u6236\u7684\u5404\u500b\u5e33\u6236\u985e\u578b\u7684\u5e63\u7a2e\u9918\u984d\u3002","sidebar":"v3SideBar"},"v3/account-asset/transfer/asset-info":{"id":"v3/account-asset/transfer/asset-info","title":"\u67e5\u8a62\u8cc7\u7522\u4fe1\u606f","description":"\u50c5\u80fd\u67e5\u8a62\u5230\u73fe\u8ca8\u5e33\u6236\u7684\u8cc7\u7522","sidebar":"v3SideBar"},"v3/account-asset/transfer/coin-balance":{"id":"v3/account-asset/transfer/coin-balance","title":"\u67e5\u8a62\u8cec\u6236\u55ae\u500b\u5e63\u7a2e\u4f59\u984d","description":"\u652f\u6301\u67e5\u8a62\u6bcd\u5e33\u6236\u7684\u55ae\u500b\u5e63\u7a2e\u9918\u984d\uff0c\u4ee5\u53ca\u6bcd\u5e33\u6236\u4e0b\u5404\u5b50\u5e33\u6236\u7684\u55ae\u500b\u5e63\u7a2e\u9918\u984d\u3002","sidebar":"v3SideBar"},"v3/account-asset/transfer/enable-uni-transfer":{"id":"v3/account-asset/transfer/enable-uni-transfer","title":"\u914d\u7f6e\u53ef\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u8cec\u865f (\u5ee2\u68c4)","description":"\u914d\u7f6e\u53ef\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u8cec\u865f\u5217\u8868","sidebar":"v3SideBar"},"v3/account-asset/transfer/internal-transfer":{"id":"v3/account-asset/transfer/internal-transfer","title":"\u5283\u8f49(\u55ae\u5e33\u865f\u5167)","description":"\u5728\u500b\u4eba\u8cec\u6236\u7684\u4e0d\u540c\u696d\u52d9\u8cec\u6236\u4e4b\u9593\uff08\u800c\u975e\u5b50\u8cec\u6236\u4e4b\u9593\uff09\u8f49\u79fb\u8cc7\u91d1\u3002 \u4f8b\u5982\uff0c\u5728\u73fe\u8ca8\u548c\u884d\u751f\u54c1\u8cec\u6236\u4e4b\u9593\u3002","sidebar":"v3SideBar"},"v3/account-asset/transfer/internal-transfer-list":{"id":"v3/account-asset/transfer/internal-transfer-list","title":"\u67e5\u8a62\u5283\u8f49\u8a18\u9304(\u55ae\u5e33\u865f\u5167)","description":"\u67e5\u8a62\u5283\u8f49\u8a18\u9304\u5217\u8868","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-list":{"id":"v3/account-asset/transfer/subacct-list","title":"\u67e5\u8a62\u5b50\u8cec\u865f\u5217\u8868","description":"\u67e5\u8a62\u5b50\u8cec\u865f\u5217\u8868","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-transfer":{"id":"v3/account-asset/transfer/subacct-transfer","title":"\u5b50\u6bcd\u5283\u8f49","description":"\u89f8\u767c\u5b50\u6bcd\u5283\u8f49\u52d5\u4f5c","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-transfer-list":{"id":"v3/account-asset/transfer/subacct-transfer-list","title":"\u67e5\u8a62\u5b50\u6bcd\u9593\u5283\u8f49\u8a18\u9304","description":"\u67e5\u8a62\u5b50\u6bcd\u5e33\u6236\u9593\u7684\u5283\u8f49\u8a18\u9304","sidebar":"v3SideBar"},"v3/account-asset/transfer/transferable-coin-list":{"id":"v3/account-asset/transfer/transferable-coin-list","title":"\u8cec\u865f\u5167\u53ef\u5283\u8f49\u5e63\u7a2e\u5217\u8868","description":"\u8cec\u865f\u5167\u53ef\u5283\u8f49\u5e63\u7a2e\u5217\u8868","sidebar":"v3SideBar"},"v3/account-asset/transfer/uni-transfer":{"id":"v3/account-asset/transfer/uni-transfer","title":"\u842c\u80fd\u5283\u8f49","description":"\u842c\u80fd\u5283\u8f49, \u60a8\u53ef\u4ee5\u9032\u884c\u5b50\u5e33\u6236\u4e4b\u9593\uff0c\u4ee5\u53ca\u6bcd\u5b50\u4e4b\u9593\u7684\u5283\u8f49","sidebar":"v3SideBar"},"v3/account-asset/transfer/uni-transfer-list":{"id":"v3/account-asset/transfer/uni-transfer-list","title":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u8a18\u9304","description":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u8a18\u9304","sidebar":"v3SideBar"},"v3/account-asset/user/apikey-info":{"id":"v3/account-asset/user/apikey-info","title":"\u67e5\u8a62API Key\u76f8\u95dc\u4fe1\u606f","description":"\u7372\u53d6API key\u7684\u76f8\u95dc\u4fe1\u606f\u3002\u4f7f\u7528\u5f85\u67e5\u8a62\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9069\u7528\u65bc\u6bcd\u3001\u5b50\u5e33\u6236\u7684api key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/create-subuid":{"id":"v3/account-asset/user/create-subuid","title":"\u65b0\u5efa\u5b50\u5e33\u6236","description":"\u5275\u5efa\u65b0\u7684\u5b50\u5e33\u6236\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/create-subuid-apikey":{"id":"v3/account-asset/user/create-subuid-apikey","title":"\u65b0\u5efa\u5b50\u5e33\u6236\u7684API Key","description":"\u7d66\u65b0\u5efa\u597d\u7684\u5b50\u5e33\u6236\u5275\u5efa\u65b0\u7684API key\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/froze-subuid":{"id":"v3/account-asset/user/froze-subuid","title":"\u51cd\u7d50/\u89e3\u51cd\u5b50\u5e33\u6236","description":"\u51cd\u7d50\u6216\u89e3\u51cd\u5b50\u5e33\u6236\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/modify-master-apikey":{"id":"v3/account-asset/user/modify-master-apikey","title":"\u4fee\u6539\u6bcd\u5e33\u6236\u7684API Key\u8a2d\u7f6e","description":"\u4fee\u6539\u6bcd\u5e33\u6236API key\u7684\u8a2d\u7f6e\u3002\u4f7f\u7528\u5f85\u4fee\u6539\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/modify-sub-apikey":{"id":"v3/account-asset/user/modify-sub-apikey","title":"\u4fee\u6539\u5b50\u5e33\u6236\u7684API Key\u8a2d\u7f6e","description":"\u4fee\u6539\u5b50\u5e33\u6236API key\u7684\u8a2d\u7f6e, \u652f\u6301\u6bcd\u5e33\u6236\u7ba1\u7406\u5b50\u5e33\u6236key\u7684\u8a2d\u7f6e, \u6216\u8005\u5b50\u5e33\u6236key\u76f4\u63a5\u4fee\u6539\u672c\u8eab\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/rm-master-apikey":{"id":"v3/account-asset/user/rm-master-apikey","title":"\u522a\u9664\u6bcd\u5e33\u6236\u7684API Key","description":"\u522a\u9664\u6bcd\u5e33\u6236\u4e0b\u7684api key\u3002\u4f7f\u7528\u5f85\u522a\u9664\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/rm-sub-apikey":{"id":"v3/account-asset/user/rm-sub-apikey","title":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684API Key","description":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684api key\u3002\u4f7f\u7528\u5f85\u522a\u9664\u7684\u5b50\u5e33\u6236api key\u8abf\u7528\u63a5\u53e3\u6216\u8005\u4f7f\u7528\u6bcd\u5e33\u6236\u8abf\u7528\u522a\u9664\u6307\u5b9aapi key","sidebar":"v3SideBar"},"v3/account-asset/user/subuid-list":{"id":"v3/account-asset/user/subuid-list","title":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868","description":"\u7372\u53d6\u7576\u524d\u6bcd\u5e33\u6236\u4e0b\u6240\u6709\u7684\u5b50\u5e33\u6236\u5217\u8868\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/wallet-type":{"id":"v3/account-asset/user/wallet-type","title":"\u67e5\u8a62\u5e33\u6236\u652f\u6301\u7684\u9322\u5305\u985e\u578b","description":"\u67e5\u8a62\u6bcd\u5e33\u6236\u6216\u8005\u5b50\u5e33\u6236\u4e0b\u652f\u6301\u7684\u9322\u5305\u985e\u578b","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/cancel-withdraw":{"id":"v3/account-asset/withdraw-deposit/cancel-withdraw","title":"\u64a4\u92b7\u63d0\u5e63","description":"\u64a4\u92b7\u63d0\u5e63","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/coin-info":{"id":"v3/account-asset/withdraw-deposit/coin-info","title":"\u67e5\u8a62\u5e63\u7a2e\u4fe1\u606f","description":"\u5e63\u7a2e\u4fe1\u606f\u67e5\u8a62","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/deplay-amount":{"id":"v3/account-asset/withdraw-deposit/deplay-amount","title":"\u67e5\u8a62\u5ef6\u9072\u63d0\u5e63\u51cd\u7d50\u91d1\u984d","description":"\u5982\u4f55\u6703\u5c0e\u81f4\u90e8\u5206\u8cc7\u91d1\u88ab\u8981\u6c42\u5ef6\u9072\u63d0\u5e63\uff1f","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/deposit-spec":{"id":"v3/account-asset/withdraw-deposit/deposit-spec","title":"\u67e5\u8a62\u5145\u503c\u76f8\u95dc\u7684\u898f\u683c","description":"\u67e5\u8a62\u5145\u503c\u76f8\u95dc\u7684\u898f\u683c\u4fe1\u606f","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/internal-deposit-record":{"id":"v3/account-asset/withdraw-deposit/internal-deposit-record","title":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u5e73\u53f0\u8f6c\u8d26)","description":"\u67e5\u8a62Bybit\u5e73\u53f0\u5167\u90e8\u5145\u503c\u7d00\u9304","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/master-deposit-addr":{"id":"v3/account-asset/withdraw-deposit/master-deposit-addr","title":"\u67e5\u8a62\u4e3b\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f","description":"\u4e3b\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f\u67e5\u8a62","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/master-deposit-record":{"id":"v3/account-asset/withdraw-deposit/master-deposit-record","title":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u93c8\u4e0a)","description":"\u5145\u503c\u8a18\u9304\u67e5\u8a62","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/set-deposit-acct":{"id":"v3/account-asset/withdraw-deposit/set-deposit-acct","title":"\u8a2d\u7f6e\u5145\u503c\u5e33\u6236","description":"\u8a2d\u7f6e\u5145\u503c\u5f8c\u7684\u81ea\u52d5\u8f49\u5165\u5e33\u6236\u985e\u578b\u3002\u8a72\u529f\u80fd\u8207\u7db2\u9801\u7aef-\u8a2d\u7f6e-\u5145\u503c\u4fdd\u6301\u4e00\u81f4\u3002","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/sub-deposit-addr":{"id":"v3/account-asset/withdraw-deposit/sub-deposit-addr","title":"\u67e5\u8a62\u5b50\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f","description":"\u5b50\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f\u67e5\u8a62","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/sub-deposit-record":{"id":"v3/account-asset/withdraw-deposit/sub-deposit-record","title":"\u67e5\u8a62\u5b50\u5e33\u6236\u5145\u503c (\u93c8\u4e0a)","description":"\u5b50\u5e33\u6236\u5145\u503c\u7d00\u9304","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/vasp-list":{"id":"v3/account-asset/withdraw-deposit/vasp-list","title":"\u67e5\u8a62\u4ea4\u6613\u6240\u5217\u8868","description":"\u8a72\u63a5\u53e3\u4e3b\u8981\u7528\u65bckyc=KOR\u7684\u97d3\u570b\u500b\u4eba\u7528\u6236, \u5728\u63d0\u73fe\u6642\u9700\u8981\u586b\u5beb\u63a5\u6536\u65b9\u4ea4\u6613\u6240\u4fe1\u606f","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/withdraw":{"id":"v3/account-asset/withdraw-deposit/withdraw","title":"\u63d0\u73fe","description":"\u82e5\u76ee\u6a19\u5730\u5740\u662fBybit\u5e73\u53f0\u5167\u90e8\u5730\u5740\uff0c\u60a8\u53ef\u4ee5\u5be6\u73fe\u5167\u90e8\u5e73\u53f0\u8f49\u5e33","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/withdraw-record":{"id":"v3/account-asset/withdraw-deposit/withdraw-record","title":"\u67e5\u8a62\u63d0\u73fe\u8a18\u9304","description":"\u63d0\u73fe\u8a18\u9304\u67e5\u8a62","sidebar":"v3SideBar"},"v3/copy-trade/enum":{"id":"v3/copy-trade/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"accountType"},"v3/copy-trade/error":{"id":"v3/copy-trade/error","title":"\u932f\u8aa4\u78bc","description":"|\u932f\u8aa4\u78bc |\u63cf\u8ff0 |"},"v3/copy-trade/rate-limit":{"id":"v3/copy-trade/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b"},"v3/copy-trade/rest-public/symbol-info":{"id":"v3/copy-trade/rest-public/symbol-info","title":"\u4ea4\u6613\u54e1\u7372\u53d6\u53ef\u5e36\u55ae\u5408\u7d04\u898f\u683c","description":"\u4ea4\u6613\u54e1\u7372\u53d6\u53ef\u5e36\u55ae\u5408\u7d04\u7684\u898f\u683c"},"v3/copy-trade/rest-trade/account/transfer":{"id":"v3/copy-trade/rest-trade/account/transfer","title":"\u4ea4\u6613\u54e1\u5283\u8f49\u8cc7\u91d1","description":"\u4ea4\u6613\u54e1\u5283\u8f49\u8cc7\u91d1"},"v3/copy-trade/rest-trade/account/transfer-list":{"id":"v3/copy-trade/rest-trade/account/transfer-list","title":"\u67e5\u8a62\u5283\u8f49\u7d00\u9304","description":"\u67e5\u8a62\u5e36\u55ae\u9322\u5305\u7684\u5283\u8f49\u7d00\u9304"},"v3/copy-trade/rest-trade/account/wallet":{"id":"v3/copy-trade/rest-trade/account/wallet","title":"\u4ea4\u6613\u54e1\u7372\u53d6\u9322\u5305\u4f59\u984d","description":"\u4ea4\u6613\u54e1\u7372\u53d6\u8ddf\u55ae\u5e33\u6236\u7684\u9322\u5305\u4f59\u984d"},"v3/copy-trade/rest-trade/order/cancel-order":{"id":"v3/copy-trade/rest-trade/order/cancel-order","title":"\u4ea4\u6613\u54e1\u53d6\u6d88\u8a02\u55ae","description":"\u4ea4\u6613\u54e1\u53d6\u6d88\u8a02\u55ae"},"v3/copy-trade/rest-trade/order/close-order":{"id":"v3/copy-trade/rest-trade/order/close-order","title":"\u4ea4\u6613\u54e1\u767c\u8d77\u5e73\u5009-\u8a02\u55ae","description":"\u4ea4\u6613\u54e1\u767c\u8d77\u5e73\u5009-\u8a02\u55ae"},"v3/copy-trade/rest-trade/order/order-list":{"id":"v3/copy-trade/rest-trade/order/order-list","title":"\u67e5\u8a62\u4ea4\u6613\u54e1\u6b77\u53f2\u5e36\u55ae\u8a02\u55ae","description":"\u67e5\u8a62\u4ea4\u6613\u54e1\u5e36\u55ae\u8a02\u55ae"},"v3/copy-trade/rest-trade/order/place-order":{"id":"v3/copy-trade/rest-trade/order/place-order","title":"\u4ea4\u6613\u54e1\u5275\u5efa\u8a02\u55ae","description":"\u4ea4\u6613\u54e1\u5275\u5efa\u8a02\u55ae"},"v3/copy-trade/rest-trade/order/set-trading-stop":{"id":"v3/copy-trade/rest-trade/order/set-trading-stop","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","description":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d"},"v3/copy-trade/rest-trade/position/close-position":{"id":"v3/copy-trade/rest-trade/position/close-position","title":"\u4ea4\u6613\u54e1\u4e00\u9375\u5e73\u5009","description":"HTTP \u8acb\u6c42"},"v3/copy-trade/rest-trade/position/execution":{"id":"v3/copy-trade/rest-trade/position/execution","title":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304 (\u5169\u5e74)","description":"\u7372\u53d6\u7528\u6236\u6210\u4ea4\u7d00\u9304\uff0c\u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217"},"v3/copy-trade/rest-trade/position/position-info":{"id":"v3/copy-trade/rest-trade/position/position-info","title":"\u4ea4\u6613\u54e1\u5e36\u55ae\u5009\u4f4d\u532f\u7e3d","description":"\u4ea4\u6613\u54e1\u5e36\u55ae\u5009\u4f4d\u532f\u7e3d"},"v3/copy-trade/rest-trade/position/set-leverage":{"id":"v3/copy-trade/rest-trade/position/set-leverage","title":"\u4ea4\u6613\u54e1\u8a2d\u7f6e\u5e36\u55ae\u69d3\u687f","description":"\u4ea4\u6613\u54e1\u8a2d\u7f6e\u5e36\u55ae\u69d3\u687f, \u8a2d\u7f6e\u69d3\u687f\u53ea\u80fd\u8a2d\u7f6e\u6574\u6578"},"v3/copy-trade/wss-authentication":{"id":"v3/copy-trade/wss-authentication","title":"\u8a02\u95b1WebSocket","description":"\u8acb\u6ce8\u610f\uff0c\u76ee\u524dcopytrading\u53ea\u652f\u6301\u6b63\u5411\u6c38\u7e8c\uff0c\u4ee5\u4e0b\u63a5\u53e3\u50c5\u9069\u7528\u65bc \u6b63\u5411\u6c38\u7e8c"},"v3/copy-trade/wss-private/execution":{"id":"v3/copy-trade/wss-private/execution","title":"\u6210\u4ea4","description":"Topic:"},"v3/copy-trade/wss-private/order":{"id":"v3/copy-trade/wss-private/order","title":"\u8a02\u55ae","description":"Topic:"},"v3/copy-trade/wss-private/position":{"id":"v3/copy-trade/wss-private/position","title":"\u6301\u5009","description":"Topic:"},"v3/copy-trade/wss-private/wallet":{"id":"v3/copy-trade/wss-private/wallet","title":"\u9322\u5305","description":"Topic:"},"v3/copy-trade/wss-public/kline":{"id":"v3/copy-trade/wss-public/kline","title":"K\u7dda","description":"\u8a02\u95b1K\u7dda\u6578\u64da"},"v3/copy-trade/wss-public/liquidation":{"id":"v3/copy-trade/wss-public/liquidation","title":"\u5f37\u5e73\u63a8\u9001","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u7684\u671f\u8ca8\u5f37\u5e73\u63a8\u9001"},"v3/copy-trade/wss-public/orderbook":{"id":"v3/copy-trade/wss-public/orderbook","title":"\u6df1\u5ea6","description":"\u8a02\u95b1\u4e0d\u540c\u6df1\u5ea6\u7684\u63a8\u9001"},"v3/copy-trade/wss-public/tickers":{"id":"v3/copy-trade/wss-public/tickers","title":"\u884c\u60c5","description":"\u8a02\u95b1\u884c\u60c5\u6578\u64da"},"v3/copy-trade/wss-public/trade":{"id":"v3/copy-trade/wss-public/trade","title":"\u5e73\u53f0\u6210\u4ea4","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u6700\u8fd1\u6210\u4ea4\u7684\u63a8\u9001. \u5f9e\u7528\u6236\u8a02\u95b1\u958b\u59cb, \u5be6\u6642\u63a8\u9001\u589e\u91cf\u4ea4\u6613\u6b77\u53f2, \u6709\u6210\u4ea4\u6578\u64da\u5c31\u63a8\u9001."},"v3/derivatives/enum":{"id":"v3/derivatives/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"category","sidebar":"v3SideBar"},"v3/derivatives/error":{"id":"v3/derivatives/error","title":"\u932f\u8aa4\u78bc","description":"\u7d71\u4e00\u4fdd\u8b49\u91d1","sidebar":"v3SideBar"},"v3/derivatives/rate-limit":{"id":"v3/derivatives/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/trading-fee":{"id":"v3/derivatives/rest-contract/account/trading-fee","title":"\u67e5\u8a62\u4ea4\u6613\u8cbb\u7387","description":"\u7372\u53d6\u7528\u6236\u7684\u4ea4\u6613\u624b\u7e8c\u8cbb\u7387","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/wallet-balance":{"id":"v3/derivatives/rest-contract/account/wallet-balance","title":"\u9322\u5305\u9918\u984d","description":"\u7372\u53d6\u9322\u5305\u9918\u984d\u4fe1\u606f\uff0c\u5305\u62ec\u884d\u751f\u54c1\u5e33\u6236\u548cUSDC\u5e33\u6236","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/wallet-fund-record":{"id":"v3/derivatives/rest-contract/account/wallet-fund-record","title":"\u67e5\u8a62\u9322\u5305\u8cc7\u91d1\u7d00\u9304","description":"\u7372\u53d6\u9322\u5305\u8cc7\u91d1\u7d00\u9304. \u9019\u500b\u63a5\u53e3\u9084\u5c55\u793a\u4f86\u81ea\u7db2\u9801\u4e0a\u8cc7\u7522\u514c\u63db\u4e0b\u7684\u514c\u63db\u7d00\u9304, \u5176\u4e2d\u5c0d\u61c9\u7684type\u514c\u63db\u985e\u578b\u662fExchangeOrderWithdraw\u548cExchangeOrderDeposit\u3002","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/cancel-all":{"id":"v3/derivatives/rest-contract/order/cancel-all","title":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","description":"\u64a4\u92b7\u5168\u90e8\u59d4\u8a17\u55ae","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/cancel-order":{"id":"v3/derivatives/rest-contract/order/cancel-order","title":"\u64a4\u92b7\u59d4\u8a17\u55ae","description":"* \u60a8\u5fc5\u9808\u6307\u5b9aorderId\u6216\u8005orderLinkId.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/open-order":{"id":"v3/derivatives/rest-contract/order/open-order","title":"\u67e5\u8a62\u5be6\u6642\u59d4\u8a17\u55ae","description":"\u5be6\u6642\u67e5\u8a62\u672a\u6210\u4ea4\u6216\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u4fe1\u606f. \u82e5\u9700\u8981\u67e5\u8a62\u66f4\u4e45\u7684\u8a02\u55ae\u7d00\u9304\uff0c\u8acb\u4f7f\u7528\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae\u63a5\u53e3.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/order-list":{"id":"v3/derivatives/rest-contract/order/order-list","title":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae","description":"\u7372\u53d6\u6b77\u53f2\u8a02\u55ae\u7d00\u9304. \u7531\u65bc\u8a02\u55ae\u5275\u5efa/\u64a4\u92b7\u662f\u7570\u6b65\u7684, \u8a72\u63a5\u53e3\u8fd4\u56de\u6578\u64da\u53ef\u80fd\u6703\u6709\u5ef6\u9072. \u82e5\u60a8\u60f3\u5be6\u6642\u7372\u53d6\u8a02\u55ae\u4fe1\u606f, \u60a8\u53ef\u4ee5\u67e5\u8a62\u8a72\u63a5\u53e3\u6216\u8005\u901a\u904ewebsocket\u63a8\u9001(\u63a8\u85a6)","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/place-order":{"id":"v3/derivatives/rest-contract/order/place-order","title":"\u5275\u5efa\u59d4\u8a17\u55ae","description":"- \u5e02\u50f9\u55ae: \u4e00\u500b\u50b3\u7d71\u7684\u5e02\u5834\u50f9\u683c\u8a02\u55ae,","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/replace-order":{"id":"v3/derivatives/rest-contract/order/replace-order","title":"\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u60a8\u53ea\u80fd\u4fee\u6539\u90a3\u4e9b\u672a\u6210\u4ea4\u6216\u8005\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u3002","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/auto-margin":{"id":"v3/derivatives/rest-contract/position/auto-margin","title":"\u8a2d\u7f6e\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1","description":"\u958b\u95dc\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1. \u6b32\u4e86\u89e3\u66f4\u591a\uff0c\u8acb\u53c3\u95b1\u9019\u88e1","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/close-pnl":{"id":"v3/derivatives/rest-contract/position/close-pnl","title":"\u67e5\u8a62\u5e73\u5009\u76c8\u8667","description":"\u7372\u53d6\u7576\u524d\u7528\u6236\u7684\u6240\u6709\u5e73\u5009\u76c8\u8667\u6578\u64da\uff0c\u8fd4\u56de\u7d50\u679c\u6309\u7167updatedTime\u964d\u5e8f\u6392\u5217.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/confirm-mmr":{"id":"v3/derivatives/rest-contract/position/confirm-mmr","title":"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d","description":"\u50c5\u9069\u7528\u65bc\u7576\u7528\u6236\u88ab\u6a19\u8a18\u70ba\u50c5\u6e1b\u5009\u6642(\u8acb\u770b\u6301\u5009\u63a5\u53e3\u4e2d\u7684isReduceOnly\u5b57\u6bb5), \u5728\u7528\u6236\u4e3b\u52d5\u8abf\u6574\u98a8\u96aa\u6c34\u4f4d\u5f8c, \u8abf\u7528\u8a72\u63a5\u53e3\u4f86\u8a66\u7b97\u8abf\u6574\u5f8c\u7684\u98a8","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/cross-isolated-margin":{"id":"v3/derivatives/rest-contract/position/cross-isolated-margin","title":"\u5207\u63db\u5168\u5009/\u9010\u5009","description":"\u5207\u63db\u5168\u5009/\u9010\u5009\u6a21\u5f0f. \u6b32\u4e86\u89e3\u66f4\u591a\uff0c\u8acb\u53c3\u95b1\u9019\u88e1","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/execution":{"id":"v3/derivatives/rest-contract/position/execution","title":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304","description":"\u7372\u53d6\u7528\u6236\u6210\u4ea4\u7d00\u9304\uff0c\u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/leverage":{"id":"v3/derivatives/rest-contract/position/leverage","title":"\u8a2d\u7f6e\u69d3\u687f\u500d\u6578","description":"\u8a2d\u7f6e\u69d3\u687f","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/position-info":{"id":"v3/derivatives/rest-contract/position/position-info","title":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/position-mode":{"id":"v3/derivatives/rest-contract/position/position-mode","title":"\u5207\u63db\u5009\u4f4d\u6a21\u5f0f","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u5207\u63dbUSDT\u6c38\u7e8c\u548c\u53cd\u5411\u4ea4\u5272\u7684\u5009\u4f4d\u6a21\u5f0f\u3002\u55ae\u5009\u6a21\u5f0f\u4e0b\uff0c\u53ea\u80fd\u5728\u55ae\u65b9\u5411\u4e0b\u6301\u5009; \u96d9\u5009\u6a21\u5f0f\u4e0b\uff0c\u53ef\u4ee5\u540c\u6642\u5728\u5169\u500b\u65b9\u5411\u6301\u5009\u3002","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/set-risk-limit":{"id":"v3/derivatives/rest-contract/position/set-risk-limit","title":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d","description":"\u7531\u65bcBybit\u57282024\u5e743\u670812\u65e5\u4e0a\u7dda\u4e86\u81ea\u52d5\u8abf\u6574risk limit\u529f\u80fd, \u8a73\u60c5\u8acb\u898b\u9019\u88e1, \u56e0\u6b64\u5118\u7ba1\u63a5\u53e3\u80fd\u8abf\u901a, \u4f46\u662f\u6c92\u6709\u4efb\u4f55\u610f\u7fa9","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/tpsl-mode":{"id":"v3/derivatives/rest-contract/position/tpsl-mode","title":"\u5207\u63db\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","description":"\u67d0\u7a2e\u7a0b\u5ea6\u4e0a\u4f86\u8aaa\uff0c\u8a72\u63a5\u53e3\u5df2\u7d93**\u5ee2\u68c4**, \u539f\u56e0\u5728\u65bc\u65b0\u7248\u7684\u6b62\u76c8\u6b62\u640d\u6a5f\u5236\u662f\u57fa\u65bc\u8a02\u55ae\u7dad\u5ea6. \u9019\u500b\u63a5\u53e3\u7576\u521d\u4e3b\u8981\u662f\u7528\u65bc\u5009\u4f4d\u7dad\u5ea6\u7684\u6b62\u76c8\u6b62\u640d","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/trading-stop":{"id":"v3/derivatives/rest-contract/position/trading-stop","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u8a2d\u7f6e\u6b62\u76c8\u3001\u6b62\u640d\u548c\u8ffd\u8e64\u6b62\u640d.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/delivery-price":{"id":"v3/derivatives/rest-public/delivery-price","title":"\u67e5\u8a62\u671f\u6b0a\u4ea4\u5272\u50f9\u683c","description":"\u67e5\u8a62\u5e73\u53f0\u4ea4\u5272\u7522\u54c1\u7684\u4ea4\u5272\u50f9\u683c\uff0c\u76ee\u524d\u50c5\u652f\u6301\u671f\u6b0a","sidebar":"v3SideBar"},"v3/derivatives/rest-public/fund-rate-history":{"id":"v3/derivatives/rest-public/fund-rate-history","title":"\u67e5\u8a62\u6b77\u53f2\u8cc7\u91d1\u8cbb\u7387","description":"\u67e5\u8a62\u8cc7\u91d1\u8cbb\u7387\uff0c\u6bcf\u500bsymbol\u7684\u8cc7\u91d1\u8cbb\u7387\u7522\u751f\u9031\u671f\u4e0d\u540c\u3002\u5047\u8a2d\u8cc7\u91d1\u8cbb\u7387\u70ba8\u5c0f\u6642\uff0c\u7576\u524d\u6642\u9593\u662fUTC12\u9ede\uff0c\u5247\u8fd4\u56de\u7684\u662f\u4e0a\u4e00\u500b\u7d50\u7b97\u5373UTC8\u9ede\u7522\u751f\u7684\u8cc7\u91d1\u8cbb\u7387\u3002","sidebar":"v3SideBar"},"v3/derivatives/rest-public/index-kline":{"id":"v3/derivatives/rest-public/index-kline","title":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda","sidebar":"v3SideBar"},"v3/derivatives/rest-public/instrument-info":{"id":"v3/derivatives/rest-public/instrument-info","title":"\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u898f\u683c\u4fe1\u606f","description":"\u67e5\u8a62\u5168\u7ad9\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u57fa\u790e\u914d\u7f6e\u898f\u5247\u4fe1\u606f","sidebar":"v3SideBar"},"v3/derivatives/rest-public/kline":{"id":"v3/derivatives/rest-public/kline","title":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/rest-public/long-short-ratio":{"id":"v3/derivatives/rest-public/long-short-ratio","title":"\u67e5\u8a62\u591a\u7a7a\u6bd4","description":"HTTP\u8acb\u6c42","sidebar":"v3SideBar"},"v3/derivatives/rest-public/mark-kline":{"id":"v3/derivatives/rest-public/mark-kline","title":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda","sidebar":"v3SideBar"},"v3/derivatives/rest-public/open-interest":{"id":"v3/derivatives/rest-public/open-interest","title":"\u67e5\u8a62\u672a\u5e73\u5009\u5408\u7d04\u6301\u5009\u6578\u91cf","description":"\u67e5\u8a62\u5404\u500b\u5408\u7d04\u5e02\u5834\u5167\u6240\u6709\u672a\u5e73\u5009\u7684\u6578\u91cf","sidebar":"v3SideBar"},"v3/derivatives/rest-public/orderbook":{"id":"v3/derivatives/rest-public/orderbook","title":"Order Book (\u6df1\u5ea6)","description":"\u7372\u53d6\u6df1\u5ea6\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/rest-public/premium-index-kline":{"id":"v3/derivatives/rest-public/premium-index-kline","title":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/rest-public/public-trade":{"id":"v3/derivatives/rest-public/public-trade","title":"\u67e5\u8a62\u5e73\u53f0\u6210\u4ea4\u6b77\u53f2","description":"\u7372\u53d6\u5e73\u53f0\u6700\u8fd1\u6210\u4ea4\u6578\u64da. \u60a8\u53ef\u4ee5\u5f9e\u9019\u88e1\u4e0b\u8f09\u5230\u6b78\u6a94\u7684\u66f4\u591a\u7684\u6b77\u53f2\u6210\u4ea4\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/rest-public/risk-limit":{"id":"v3/derivatives/rest-public/risk-limit","title":"\u67e5\u8a62\u5408\u7d04\u98a8\u96aa\u9650\u984d","description":"\u67e5\u8a62\u671f\u8ca8\u5408\u7d04\u7684\u98a8\u96aa\u9650\u984d\u8868","sidebar":"v3SideBar"},"v3/derivatives/rest-public/ticker-info":{"id":"v3/derivatives/rest-public/ticker-info","title":"\u67e5\u8a62\u6700\u65b0\u884c\u60c5\u4fe1\u606f","description":"\u53ef\u7372\u53d6\u5230\u5feb\u7167\u7684\u6700\u65b0\u5e02\u5834\u50f9\u683c\uff0c\u6700\u4f73\u8cb7\u8ce3\u50f9\u683c\uff0c\u4ee5\u53ca\u904e\u53bb\u6642\u9593\u5167\u7684\u4ea4\u6613\u91cf\u7b49.","sidebar":"v3SideBar"},"v3/derivatives/rest-unified/account/account-info":{"id":"v3/derivatives/rest-unified/account/account-info","title":"\u67e5\u8a62\u5e33\u6236\u914d\u7f6e","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u67e5\u8a62\u8cec\u6236\u4e0b\u7684\u914d\u7f6e"},"v3/derivatives/rest-unified/account/borrow-history":{"id":"v3/derivatives/rest-unified/account/borrow-history","title":"\u67e5\u8a62\u5229\u606f\u8a18\u9304","description":"\u7372\u53d6\u5229\u606f\u8a18\u9304\uff0c\u6309\u7167\u5275\u5efa\u6642\u9593\u5012\u6558\u6392\u5217\u3002"},"v3/derivatives/rest-unified/account/borrow-rate":{"id":"v3/derivatives/rest-unified/account/borrow-rate","title":"\u501f\u8cb8\u5229\u7387\u67e5\u8a62","description":"HTTP \u8acb\u6c42"},"v3/derivatives/rest-unified/account/dcp":{"id":"v3/derivatives/rest-unified/account/dcp","title":"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593","description":"\u4ec0\u9ebc\u662f\u65b7\u7dda\u4fdd\u8b77 (Disconnection Protect)?"},"v3/derivatives/rest-unified/account/exchange":{"id":"v3/derivatives/rest-unified/account/exchange","title":"\u67e5\u8a62\u5e63\u5e63\u514c\u63db\u7d00\u9304\u67e5\u8a62","description":"\u7372\u53d6\u5e63\u5e63\u514c\u63db\u7d00\u9304"},"v3/derivatives/rest-unified/account/get-dcp":{"id":"v3/derivatives/rest-unified/account/get-dcp","title":"\u67e5\u8a62\u65b7\u7dda\u4fdd\u8b77\u914d\u7f6e","description":"HTTP\u8acb\u6c42"},"v3/derivatives/rest-unified/account/get-mmp-state":{"id":"v3/derivatives/rest-unified/account/get-mmp-state","title":"\u67e5\u8a62\u5e02\u5546\u4fdd\u8b77\u914d\u7f6e\u4fe1\u606f","description":"HTTP \u8acb\u6c42"},"v3/derivatives/rest-unified/account/reset-mmp":{"id":"v3/derivatives/rest-unified/account/reset-mmp","title":"\u91cd\u7f6e\u5e02\u5546\u4fdd\u8b77\u51cd\u7d50","description":"\u4e00\u65e6mmp\u88ab\u89f8\u767c, \u60a8\u7684\u5e33\u6236\u53ef\u4ee5\u8abf\u7528\u8a72\u63a5\u53e3\u9032\u884c\u4e3b\u52d5\u89e3\u51cd\u3002"},"v3/derivatives/rest-unified/account/set-margin-mode":{"id":"v3/derivatives/rest-unified/account/set-margin-mode","title":"\u8a2d\u7f6e\u4fdd\u8b49\u91d1\u6a21\u5f0f","description":"\u7528\u6236\u5982\u679c\u4e0d\u8a2d\u7f6e\uff0c\u9ed8\u8a8d\u6309\u5e38\u898f\u4fdd\u8b49\u91d1\u3002\u8a72\u6a21\u5f0f\u652f\u6301USDT\u6c38\u7e8c, USDC\u6c38\u7e8c\u548c\u671f\u6b0a"},"v3/derivatives/rest-unified/account/set-mmp":{"id":"v3/derivatives/rest-unified/account/set-mmp","title":"\u8bbe\u7f6e\u5e02\u5546\u4fdd\u8b77","description":"\u4ec0\u9ebc\u662fMMP?"},"v3/derivatives/rest-unified/account/transaction-log":{"id":"v3/derivatives/rest-unified/account/transaction-log","title":"\u67e5\u8a62\u4ea4\u6613\u65e5\u8a8c","description":"UNIFIED\u8cec\u6236\u7684\u4ea4\u6613\u65e5\u8a8c\u3002"},"v3/derivatives/rest-unified/account/upgrade-unified-account":{"id":"v3/derivatives/rest-unified/account/upgrade-unified-account","title":"\u5347\u7d1a\u81f3\u7d71\u4e00\u4fdd\u8b49\u91d1\u5e33\u6236","description":"\u5347\u7d1a\u81f3\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236"},"v3/derivatives/rest-unified/account/wallet-balance":{"id":"v3/derivatives/rest-unified/account/wallet-balance","title":"\u7372\u53d6\u9322\u5305\u9918\u984d","description":"\u7372\u53d6\u9322\u5305\u9918\u984d"},"v3/derivatives/rest-unified/order/batch-cancel":{"id":"v3/derivatives/rest-unified/order/batch-cancel","title":"\u6279\u91cf\u64a4\u92b7\u59d4\u8a17\u55ae","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u6279\u91cf\u64a4\u92b7\u591a\u7b46\u8a02\u55ae"},"v3/derivatives/rest-unified/order/batch-place":{"id":"v3/derivatives/rest-unified/order/batch-place","title":"\u6279\u91cf\u5275\u5efa\u59d4\u8a17\u55ae","description":"\u8a72\u63a5\u53e3\u652f\u6301\u6279\u91cf\u5275\u5efa\u59d4\u8a17\u55ae"},"v3/derivatives/rest-unified/order/batch-replace":{"id":"v3/derivatives/rest-unified/order/batch-replace","title":"\u6279\u91cf\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u8a72\u63a5\u53e3\u652f\u6301\u6279\u91cf\u4fee\u6539\u59d4\u8a17\u55ae"},"v3/derivatives/rest-unified/order/cancel-all":{"id":"v3/derivatives/rest-unified/order/cancel-all","title":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","description":"\u64a4\u92b7\u5168\u90e8\u59d4\u8a17\u55ae"},"v3/derivatives/rest-unified/order/cancel-order":{"id":"v3/derivatives/rest-unified/order/cancel-order","title":"\u64a4\u92b7\u59d4\u8a17\u55ae","description":"* \u60a8\u5fc5\u9808\u6307\u5b9aorderId\u6216\u8005orderLinkId."},"v3/derivatives/rest-unified/order/open-order":{"id":"v3/derivatives/rest-unified/order/open-order","title":"\u67e5\u8a62\u5be6\u6642\u59d4\u8a17\u55ae","description":"\u5be6\u6642\u67e5\u8a62\u672a\u6210\u4ea4\u6216\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u4fe1\u606f. \u82e5\u9700\u8981\u67e5\u8a62\u66f4\u4e45\u7684\u8a02\u55ae\u7d00\u9304\uff0c\u8acb\u4f7f\u7528\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae\u63a5\u53e3."},"v3/derivatives/rest-unified/order/order-list":{"id":"v3/derivatives/rest-unified/order/order-list","title":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae","description":"\u7372\u53d6\u6b77\u53f2\u8a02\u55ae\u7d00\u9304. \u7531\u65bc\u8a02\u55ae\u5275\u5efa/\u64a4\u92b7\u662f\u7570\u6b65\u7684, \u8a72\u63a5\u53e3\u8fd4\u56de\u6578\u64da\u53ef\u80fd\u6703\u6709\u5ef6\u9072. \u82e5\u60a8\u60f3\u5be6\u6642\u7372\u53d6\u8a02\u55ae\u4fe1\u606f, \u60a8\u53ef\u4ee5\u67e5\u8a62\u8a72\u63a5\u53e3\u6216\u8005\u901a\u904ewebsocket\u63a8\u9001(\u63a8\u85a6)"},"v3/derivatives/rest-unified/order/place-order":{"id":"v3/derivatives/rest-unified/order/place-order","title":"\u5275\u5efa\u59d4\u8a17\u55ae","description":"- \u5e02\u50f9\u55ae: \u4e00\u500b\u50b3\u7d71\u7684\u5e02\u5834\u50f9\u683c\u8a02\u55ae,"},"v3/derivatives/rest-unified/order/replace-order":{"id":"v3/derivatives/rest-unified/order/replace-order","title":"\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u60a8\u53ea\u80fd\u4fee\u6539\u90a3\u4e9b\u672a\u6210\u4ea4\u6216\u8005\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u3002"},"v3/derivatives/rest-unified/position/execution-list":{"id":"v3/derivatives/rest-unified/position/execution-list","title":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304 (\u534a\u5e74)","description":"\u7372\u53d6\u7528\u6236\u6210\u4ea4\u7d00\u9304\uff0c\u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217"},"v3/derivatives/rest-unified/position/full-partial-tpsl":{"id":"v3/derivatives/rest-unified/position/full-partial-tpsl","title":"\u5207\u63db\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","description":"\u53ef\u4ee5\u5c07\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f\u8a2d\u7f6e\u70ba\u90e8\u5206\u6b62\u76c8\u6b62\u640d\u6216\u8005\u5168\u90e8\u6b62\u76c8\u6b62\u640d"},"v3/derivatives/rest-unified/position/leverage":{"id":"v3/derivatives/rest-unified/position/leverage","title":"\u8a2d\u7f6e\u69d3\u687f\u500d\u6578","description":"\u8a2d\u7f6e\u69d3\u687f\u500d\u6578"},"v3/derivatives/rest-unified/position/option-delivery":{"id":"v3/derivatives/rest-unified/position/option-delivery","title":"\u67e5\u8a62\u4ea4\u5272\u7d00\u9304 (\u671f\u6b0a)","description":"\u67e5\u8a62\u671f\u6b0a\u4ea4\u5272\u7d00\u9304, \u8fd4\u56de\u7d50\u679c\u6309\u7167deliveryTime\u964d\u5e8f\u6392\u5217"},"v3/derivatives/rest-unified/position/position-info":{"id":"v3/derivatives/rest-unified/position/position-info","title":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49"},"v3/derivatives/rest-unified/position/set-risk-limit":{"id":"v3/derivatives/rest-unified/position/set-risk-limit","title":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d","description":"\u98a8\u96aa\u9650\u984d\u6703\u9650\u5236\u4f60\u5728\u4e0d\u540c\u7684\u4fdd\u8b49\u91d1\u8981\u6c42\u4e0b\u7684\u53ef\u6301\u5009\u7684\u6700\u5927\u5009\u4f4d\u6578\u91cf\uff0c\u5982\u679c\u8981\u6301\u6709\u66f4\u591a\u7684\u5009\u4f4d\uff0c\u9700\u8981\u66f4\u591a\u7684\u4fdd\u8b49\u91d1\u8981\u6c42\u3002\u672c\u63a5\u53e3\u53ef\u4ee5\u8a2d\u7f6e\u55ae\u500b\u5009\u4f4d\u7684\u98a8\u96aa\u9650\u984d\uff0c"},"v3/derivatives/rest-unified/position/trading-stop":{"id":"v3/derivatives/rest-unified/position/trading-stop","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u8a2d\u7f6e\u6b62\u76c8\u3001\u6b62\u640d\u548c\u8ffd\u8e64\u6b62\u640d"},"v3/derivatives/rest-unified/position/usdc-settlement":{"id":"v3/derivatives/rest-unified/position/usdc-settlement","title":"\u67e5\u8a62\u7d50\u7b97\u7d00\u9304 (USDC\u6c38\u7e8c)","description":"\u67e5\u8a62USDC\u6c38\u7e8c\u7684\u7d50\u7b97\u7d00\u9304"},"v3/derivatives/wss-authentication":{"id":"v3/derivatives/wss-authentication","title":"\u8a02\u95b1WebSocket","description":"\u8a02\u95b1\u5730\u5740:","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/execution":{"id":"v3/derivatives/wss-contract/execution","title":"\u500b\u4eba\u6210\u4ea4","description":"\u8a02\u95b1\u500b\u4eba\u6210\u4ea4\u7684\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/order":{"id":"v3/derivatives/wss-contract/order","title":"\u8a02\u55ae","description":"\u8a02\u95b1\u8a02\u55ae\u6578\u64da\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/position":{"id":"v3/derivatives/wss-contract/position","title":"\u6301\u5009","description":"\u8a02\u95b1\u6301\u5009\u6578\u64da\u7684\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/wallet":{"id":"v3/derivatives/wss-contract/wallet","title":"\u9322\u5305","description":"\u8a02\u95b1\u9322\u5305\u6578\u64da\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-public/kline":{"id":"v3/derivatives/wss-public/kline","title":"K\u7dda","description":"\u8a02\u95b1K\u7dda\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/wss-public/liquidation":{"id":"v3/derivatives/wss-public/liquidation","title":"\u5f37\u5e73\u63a8\u9001","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u7684\u671f\u8ca8\u5f37\u5e73\u63a8\u9001, symbol\u7ef4\u5ea6\u6700\u591a1\u79d2\u63a8\u4e00\u6761\u7206\u4ed3\u6570\u636e","sidebar":"v3SideBar"},"v3/derivatives/wss-public/orderbook":{"id":"v3/derivatives/wss-public/orderbook","title":"\u6df1\u5ea6","description":"\u8a02\u95b1\u4e0d\u540c\u6df1\u5ea6\u7684\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-public/tickers":{"id":"v3/derivatives/wss-public/tickers","title":"\u884c\u60c5","description":"\u8a02\u95b1\u884c\u60c5\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/wss-public/trade":{"id":"v3/derivatives/wss-public/trade","title":"\u5e73\u53f0\u6210\u4ea4","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u6700\u8fd1\u6210\u4ea4\u7684\u63a8\u9001. \u5f9e\u7528\u6236\u8a02\u95b1\u958b\u59cb, \u5be6\u6642\u63a8\u9001\u589e\u91cf\u4ea4\u6613\u6b77\u53f2, \u6709\u6210\u4ea4\u6578\u64da\u5c31\u63a8\u9001.","sidebar":"v3SideBar"},"v3/derivatives/wss-unified/execution":{"id":"v3/derivatives/wss-unified/execution","title":"\u500b\u4eba\u6210\u4ea4","description":"\u8a02\u95b1\u500b\u4eba\u6210\u4ea4\u7684\u63a8\u9001"},"v3/derivatives/wss-unified/greek":{"id":"v3/derivatives/wss-unified/greek","title":"\u7528\u6236\u5e0c\u81d8\u5b57\u6bcd\u4fe1\u606f (\u671f\u6b0a)","description":"\u8a02\u95b1\u5e0c\u81d8\u5b57\u6bcd\u4fe1\u606f\uff0c\u50c5\u671f\u6b0a"},"v3/derivatives/wss-unified/order":{"id":"v3/derivatives/wss-unified/order","title":"\u8a02\u55ae","description":"\u8a02\u95b1\u8a02\u55ae\u6578\u64da\u63a8\u9001"},"v3/derivatives/wss-unified/position":{"id":"v3/derivatives/wss-unified/position","title":"\u6301\u5009","description":"\u8a02\u95b1\u6301\u5009\u6578\u64da\u7684\u63a8\u9001\u3002\u7576\u5009\u4f4d\u6709\u8b8a\u52d5\u6642\uff0c\u5373\u63a8\u9001\u6d88\u606f\u3002"},"v3/derivatives/wss-unified/wallet":{"id":"v3/derivatives/wss-unified/wallet","title":"\u9322\u5305","description":"\u8a02\u95b1\u9322\u5305\u6578\u64da\u63a8\u9001"},"v3/intro":{"id":"v3/intro","title":"\u6982\u89bd","description":"Bybit V3 Open API \u80fd\u7d66\u8b93\u7528\u6236\u57fa\u65bc\u4e0d\u540c\u7684\u7522\u54c1\u69cb\u5efaAPI\u6a21\u578b\u3002","sidebar":"v3SideBar"},"v3/server-time":{"id":"v3/server-time","title":"Bybit\u670d\u52d9\u5668\u6642\u9593","description":"\u7372\u53d6Bybit\u670d\u52d9\u5668\u6642\u9593","sidebar":"v3SideBar"},"v3/smp":{"id":"v3/smp","title":"\u81ea\u6210\u4ea4\u6514\u622a","description":"\u4ec0\u9ebc\u662f\u81ea\u6210\u4ea4\uff1f","sidebar":"v3SideBar"},"v3/spot/enum":{"id":"v3/spot/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"side","sidebar":"v3SideBar"},"v3/spot/error":{"id":"v3/spot/error","title":"\u932f\u8aa4\u78bc","description":"|\u932f\u8aa4\u78bc |\u63cf\u8ff0 |","sidebar":"v3SideBar"},"v3/spot/rate-limit":{"id":"v3/spot/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b","sidebar":"v3SideBar"},"v3/spot/rest-etp/asset-info":{"id":"v3/spot/rest-etp/asset-info","title":"LT \u5168\u91cf\u8cc7\u7522\u57fa\u790e\u4fe1\u606f\u67e5\u8a62","description":"\u9019\u662f\u500b\u516c\u5171\u63a5\u53e3\uff0c\u7121\u9700\u9452\u6b0a\u3002","sidebar":"v3SideBar"},"v3/spot/rest-etp/market-info":{"id":"v3/spot/rest-etp/market-info","title":"LT \u884c\u60c5\u67e5\u8a62","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-etp/purchase":{"id":"v3/spot/rest-etp/purchase","title":"\u7533\u8cfc","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-etp/purchase-redeem-history":{"id":"v3/spot/rest-etp/purchase-redeem-history","title":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-etp/redeem":{"id":"v3/spot/rest-etp/redeem","title":"\u8d16\u56de","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/loan-info":{"id":"v3/spot/rest-institution-loan/loan-info","title":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u4fe1\u606f","description":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u7684\u8a73\u60c5","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/ltv":{"id":"v3/spot/rest-institution-loan/ltv","title":"\u67e5\u8a62\u98a8\u96aa\u7387","description":"\u82e5\u8a72\u63a5\u53e3\u8fd4\u56de\u7a7a\u6578\u64da\uff0c\u8acb\u524d\u5f80\u8a72\u63a5\u53e3\u67e5\u8a62LTV","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/margin-coin-info":{"id":"v3/spot/rest-institution-loan/margin-coin-info","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"\u9019\u662f\u516c\u5171\u63a5\u53e3\uff0c\u7121\u9700\u9452\u6b0a\u3002","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/margin-product-info":{"id":"v3/spot/rest-institution-loan/margin-product-info","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u7522\u54c1\u4fe1\u606f","description":"\u9019\u662f\u516c\u5171\u63a5\u53e3\uff0c\u7121\u9700\u9452\u6b0a\u3002","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/repay-info":{"id":"v3/spot/rest-institution-loan/repay-info","title":"\u67e5\u8a62\u9084\u6b3e\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-public/best-bid-ask":{"id":"v3/spot/rest-public/best-bid-ask","title":"\u6700\u4f73\u8cb7\u8ce3\u50f9","description":"\u5982\u679csymbol\u6c92\u6709\u88ab\u767c\u9001\uff0c\u6240\u6709symbol\u7684\u6700\u4f73\u8a02\u55ae\u7c3f\u50f9\u683c\u90fd\u6703\u88ab\u8fd4\u56de\u3002","sidebar":"v3SideBar"},"v3/spot/rest-public/instrument-info":{"id":"v3/spot/rest-public/instrument-info","title":"\u67e5\u8a62\u6240\u6709\u4ea4\u6613\u5c0d","description":"\u7372\u53d6\u6240\u6709\u4ea4\u6613\u5c0d","sidebar":"v3SideBar"},"v3/spot/rest-public/kline":{"id":"v3/spot/rest-public/kline","title":"\u67e5\u8a62K\u7dda\u6578\u64da","description":"\u8fd4\u56de\u6307\u5b9a\u7684\u6642\u9593\u9593\u9694\u6700\u8fd11000\u6839\u7684K\u7dda\u7d50\u679c","sidebar":"v3SideBar"},"v3/spot/rest-public/last-trade-price":{"id":"v3/spot/rest-public/last-trade-price","title":"Symbol\u6700\u65b0\u50f9","description":"\u5982\u679csymbol\u6c92\u6709\u88ab\u767c\u9001\uff0c\u6240\u6709symbol\u7684\u50f9\u683c\u90fd\u6703\u88ab\u8fd4\u56de","sidebar":"v3SideBar"},"v3/spot/rest-public/merge-orderbook":{"id":"v3/spot/rest-public/merge-orderbook","title":"\u5408\u4e26\u8a02\u55ae\u7c3f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-public/orderbook":{"id":"v3/spot/rest-public/orderbook","title":"\u8a02\u55ae\u7c3f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-public/public-trade":{"id":"v3/spot/rest-public/public-trade","title":"\u5e73\u81fa\u4ea4\u6613\u6b77\u53f2\u6578\u64da","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-public/ticker-info":{"id":"v3/spot/rest-public/ticker-info","title":"\u6700\u65b0\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/account-info":{"id":"v3/spot/rest-spot-margin/account-info","title":"\u67e5\u8a62\u501f\u8cb8\u5e33\u6236\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrow":{"id":"v3/spot/rest-spot-margin/borrow","title":"\u501f\u6b3e","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrow-info":{"id":"v3/spot/rest-spot-margin/borrow-info","title":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrowable-data":{"id":"v3/spot/rest-spot-margin/borrowable-data","title":"\u67e5\u8a62\u53ef\u501f\u5e63\u7a2e\u7cbe\u5ea6","description":"\u9019\u662f\u500b\u516c\u544a\u63a5\u53e3\uff0c\u4e0d\u9700\u8981\u9452\u6b0a","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/interest-quota":{"id":"v3/spot/rest-spot-margin/interest-quota","title":"\u67e5\u8a62\u5229\u7387\u53ca\u984d\u5ea6","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/margin-data":{"id":"v3/spot/rest-spot-margin/margin-data","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"\u9019\u662f\u500b\u516c\u5171\u63a5\u53e3\uff0c\u4e0d\u9700\u8981\u9452\u6b0a","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/repay":{"id":"v3/spot/rest-spot-margin/repay","title":"\u9084\u6b3e","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/repay-history":{"id":"v3/spot/rest-spot-margin/repay-history","title":"\u67e5\u8a62\u9084\u6b3e\u8a02\u55ae\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/switch-mode":{"id":"v3/spot/rest-spot-margin/switch-mode","title":"\u5168\u5009\u69d3\u687f\u958b\u95dc","description":"\u958b\u555f\u6216\u95dc\u9589\u5168\u5009\u69d3\u687f\u4ea4\u6613","sidebar":"v3SideBar"},"v3/spot/rest-spot/batch-cancel":{"id":"v3/spot/rest-spot/batch-cancel","title":"\u6279\u91cf\u64a4\u92b7\u8a02\u55ae","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/batch-cancel-by-id":{"id":"v3/spot/rest-spot/batch-cancel-by-id","title":"\u6839\u64da\u8a02\u55ae\u865f\u6279\u91cf\u64a4\u92b7\u8a02\u55ae","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/cancel-order":{"id":"v3/spot/rest-spot/cancel-order","title":"\u64a4\u92b7\u6d3b\u52d5\u59d4\u6258\u55ae","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/get-order":{"id":"v3/spot/rest-spot/get-order","title":"\u67e5\u8a62\u6d3b\u52d5\u59d4\u6258","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/open-order":{"id":"v3/spot/rest-spot/open-order","title":"\u8a02\u55ae\u5217\u8868","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/order-history":{"id":"v3/spot/rest-spot/order-history","title":"\u6b77\u53f2\u8a02\u55ae","description":"- \u5982\u679cstartTime\u548cendTime\u90fd\u4e0d\u50b3\uff0c\u5247\u9ed8\u8a8d\u67e5\u8a62\u8fd17\u5929\u7684\u6578\u64da\u3002","sidebar":"v3SideBar"},"v3/spot/rest-spot/place-order":{"id":"v3/spot/rest-spot/place-order","title":"\u5275\u5efa\u6d3b\u52d5\u59d4\u6258\u55ae","description":"\u666e\u901a\u55ae\u548c\u6b62\u76c8\u6b62\u640d\u55ae\u7684orderLinkId\u4e0d\u80fd\u91cd\u8907","sidebar":"v3SideBar"},"v3/spot/rest-spot/trade-history":{"id":"v3/spot/rest-spot/trade-history","title":"\u4ea4\u6613\u8a18\u9304","description":"* \u5982\u679c\u4e0d\u50b3startTime\uff0c\u53ea\u80fd\u67e5\u8a62\u6700\u8fd17\u5929\u7684\u4ea4\u6613\u6578\u64da\u3002\u5982\u679c\u8981\u67e5\u8a62\u4e00\u5468\u4e4b\u524d\u7684\u6b77\u53f2\u4ea4\u6613\u6578\u64da\uff0c\u9700\u8981\u50b3startTime","sidebar":"v3SideBar"},"v3/spot/wallet":{"id":"v3/spot/wallet","title":"\u67e5\u8a62\u9322\u5305\u4f59\u984d","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/wss-authentication":{"id":"v3/spot/wss-authentication","title":"\u8a02\u95b1WebSocket","description":"\u4ee5\u4e0bWSS\u5730\u5740\u50c5\u9069\u7528\u73fe\u8ca8. \u8981\u60f3\u63a5\u6536\u671f\u8ca8\u7684\u63a8\u9001\uff0c\u8acb\u524d\u5f80:","sidebar":"v3SideBar"},"v3/spot/wss-private/order":{"id":"v3/spot/wss-private/order","title":"\u8a02\u55ae","description":"\u8a72\u8a02\u95b1\u7528\u65bc\u63a8\u9001\u8a02\u55ae\u4fe1\u606f\uff0c\u5176\u4e2d \u6210\u4ea4\u5747\u50f9 = Z / z","sidebar":"v3SideBar"},"v3/spot/wss-private/outbound-account-info":{"id":"v3/spot/wss-private/outbound-account-info","title":"\u9322\u5305","description":"\u8a72\u8a02\u95b1\u7528\u65bc\u63a8\u9001\u73fe\u8ca8\u9322\u5305\u4fe1\u606f","sidebar":"v3SideBar"},"v3/spot/wss-private/stop-order":{"id":"v3/spot/wss-private/stop-order","title":"\u6b62\u76c8\u6b62\u640d\u8a02\u55ae","description":"\u8a72\u8a02\u95b1\u63a8\u9001web/app\u4e0b\u7684\u689d\u4ef6\u548c\u6b62\u76c8\u6b62\u640d\u8a02\u55ae\u4fe1\u606f, \u6216\u8005\u662fopenAPI\u4e0b\u7684\u6b62\u76c8\u6b62\u640d\u8a02\u55ae\u4fe1\u606f\u63a8\u9001\u3002\u53ea\u8981\u8a02\u55ae\u72c0\u614b\u767c\u751f\u6539\u8b8a\uff0c\u5c31\u6703\u63a8\u9001\u6d88\u606f\u3002","sidebar":"v3SideBar"},"v3/spot/wss-private/ticket-info":{"id":"v3/spot/wss-private/ticket-info","title":"\u500b\u4eba\u6210\u4ea4","description":"\u8a72\u8a02\u95b1\u63a8\u9001\u6210\u4ea4\u4fe1\u606f","sidebar":"v3SideBar"},"v3/spot/wss-public/bookticker":{"id":"v3/spot/wss-public/bookticker","title":"\u8cb7\u4e00\u8ce3\u4e00","description":"\u6700\u512a\u8cb7\u4e00\u8ce3\u4e00\u50f9","sidebar":"v3SideBar"},"v3/spot/wss-public/kline":{"id":"v3/spot/wss-public/kline","title":"K\u7dda","description":"\u8a02\u95b1K\u7dda\u6578\u64da\u63a8\u9001, \u8acb\u5728\u9019\u88e1\u67e5\u95b1\u671f\u671b\u8a02\u95b1\u7684\u7c92\u5ea6","sidebar":"v3SideBar"},"v3/spot/wss-public/orderbook":{"id":"v3/spot/wss-public/orderbook","title":"\u6df1\u5ea6","description":"\u4ea4\u6613\u5c0d\u7684\u6df1\u5ea6\u4fe1\u606f:","sidebar":"v3SideBar"},"v3/spot/wss-public/tickers":{"id":"v3/spot/wss-public/tickers","title":"\u884c\u60c5","description":"\u4ea4\u6613\u5c0d\u768424\u5c0f\u6642\u7d71\u8a08\u6578\u64da","sidebar":"v3SideBar"},"v3/spot/wss-public/trade":{"id":"v3/spot/wss-public/trade","title":"\u5e73\u81fa\u6210\u4ea4","description":"\u9010\u7b46\u4ea4\u6613\u63a8\u9001\u6bcf\u4e00\u7b46\u6210\u4ea4\u7684\u4fe1\u606f\u3002\u6210\u4ea4\uff0c\u6216\u8005\u8aaa\u4ea4\u6613\u7684\u5b9a\u7fa9\u662f\u50c5\u6709\u4e00\u500b\u5403\u55ae\u8005\u8207\u4e00\u500b\u639b\u55ae\u8005\u76f8\u4e92\u4ea4\u6613\u3002","sidebar":"v3SideBar"},"v3/tax/data-explain":{"id":"v3/tax/data-explain","title":"\u6578\u64da\u8aaa\u660e","description":"\u4ea4\u6613\u6b77\u53f2","sidebar":"v3SideBar"},"v3/tax/data-export":{"id":"v3/tax/data-export","title":"\u6578\u64da\u5c0e\u51fa","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/tax/enum":{"id":"v3/tax/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"ReportType","sidebar":"v3SideBar"},"v3/tax/register-time":{"id":"v3/tax/register-time","title":"\u67e5\u8a62\u7279\u5b9a\u7528\u6236\u5728\u5e73\u53f0\u8a3b\u518a\u65e5\u671f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/tax/report-status":{"id":"v3/tax/report-status","title":"\u67e5\u8a62\u5831\u544a\u5c0e\u51fa\u72c0\u614b","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/tax/request-report":{"id":"v3/tax/request-report","title":"\u5275\u5efa\u5c0e\u51fa\u5831\u544a\u8acb\u6c42","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v5/abandon/account-info":{"id":"v5/abandon/account-info","title":"\u67e5\u8a62\u4f59\u5e63\u5bf6\u5e33\u6236\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/abandon/cancel-redeem":{"id":"v5/abandon/cancel-redeem","title":"\u64a4\u92b7\u8d16\u56de","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/abandon/coin-info":{"id":"v5/abandon/coin-info","title":"\u67e5\u8a62\u53ef\u5b58\u5165\u5e63\u7a2e\u4fe1\u606f","description":"\u67e5\u8a62\u53ef\u5b58\u5165\u5e63\u7a2e\u7684\u57fa\u672c\u4fe1\u606f","sidebar":"v5SideBar"},"v5/abandon/deposit":{"id":"v5/abandon/deposit","title":"\u5b58\u5165\u8cc7\u91d1","description":"- \u7d93\u5178\u5e33\u6236&UMA\u5e33\u6236: \u8cc7\u91d1\u662f\u5f9e\u73fe\u8ca8\u9322\u5305\u6263\u9664","sidebar":"v5SideBar"},"v5/abandon/earning":{"id":"v5/abandon/earning","title":"\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63","description":"\u8a72\u63a5\u53e3\u5df2\u7d93\u5ee2\u68c4, \u8acb\u4f7f\u7528\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63\u4fe1\u606f","sidebar":"v5SideBar"},"v5/abandon/enable-unitransfer-subuid":{"id":"v5/abandon/enable-unitransfer-subuid","title":"\u914d\u7f6e\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u5e33\u865f","description":"\u7121\u9700\u518d\u914d\u7f6e\u53ef\u5283\u8f49\u7684\u5b50\u5e33\u865f, \u8a72\u9650\u5236\u5df2\u79fb\u9664, \u9ed8\u8a8d\u4efb\u610f\u5b50\u5e33\u865f\u4e4b\u9593\u53ef\u4ee5\u5283\u8f49","sidebar":"v5SideBar"},"v5/abandon/ltv":{"id":"v5/abandon/ltv","title":"\u67e5\u8a62\u98a8\u96aa\u7387","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/abandon/margin-coin-info":{"id":"v5/abandon/margin-coin-info","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"\u9019\u662f\u516c\u5171\u63a5\u53e3\uff0c\u7121\u9700\u9452\u6b0a\u3002","sidebar":"v5SideBar"},"v5/abandon/order-record":{"id":"v5/abandon/order-record","title":"\u67e5\u8a62\u8a02\u55ae\u6b77\u53f2","description":"\u67e5\u8a62\u5b58\u5165/\u8d16\u56de/\u6536\u76ca\u767c\u653e\u7684\u8a02\u55ae\u6b77\u53f2","sidebar":"v5SideBar"},"v5/abandon/redeem":{"id":"v5/abandon/redeem","title":"\u8d16\u56de\u8cc7\u91d1","description":"\u5728\u8d16\u56de\u672c\u91d1\u6642\uff0c\u7cfb\u7d71\u9084\u6703\u81ea\u52d5\u8d16\u56de\u7576\u524d\u7684\u6536\u76ca\u3002","sidebar":"v5SideBar"},"v5/account/account-info":{"id":"v5/account/account-info","title":"\u67e5\u8a62\u8cec\u6236\u914d\u7f6e","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u67e5\u8a62\u8cec\u6236\u4e0b\u7684\u914d\u7f6e","sidebar":"v5SideBar"},"v5/account/batch-set-collateral":{"id":"v5/account/batch-set-collateral","title":"\u6279\u91cf\u8a2d\u7f6e\u62b5\u62bc\u54c1\u5e63\u7a2e","description":"\u7528\u6236\u53ef\u4ee5\u6279\u91cf\u958b\u555f\u6216\u95dc\u9589\u7d71\u4e00\u5e33\u6236\u4e2d\u5e63\u7a2e\u62b5\u62bc\u5c6c\u6027\uff0c\u9ed8\u8a8d\u90fd\u662f\u95dc\u9589\u7684","sidebar":"v5SideBar"},"v5/account/borrow-history":{"id":"v5/account/borrow-history","title":"\u67e5\u8a62\u5229\u606f\u8a18\u9304","description":"\u7372\u53d6\u5229\u606f\u8a18\u9304\uff0c\u6309\u7167\u5275\u5efa\u6642\u9593\u5012\u6558\u6392\u5217\u3002","sidebar":"v5SideBar"},"v5/account/coin-greeks":{"id":"v5/account/coin-greeks","title":"\u67e5\u8a62Greeks\u4fe1\u606f","description":"\u7372\u53d6\u7576\u524d\u8cec\u6236Greeks\u4fe1\u606f","sidebar":"v5SideBar"},"v5/account/collateral-info":{"id":"v5/account/collateral-info","title":"\u67e5\u8a62\u62b5\u62bc\u54c1\u4fe1\u606f","description":"\u7372\u53d6\u7576\u524d\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236\u7684\u62b5\u62bc\u54c1\u4fe1\u606f\uff0c\u5305\u62ec\u501f\u8cb8\u5229\u7387\uff0c\u53ef\u85c9\u8cb8\u91d1\u984d\u4ee5\u53ca\u62b5\u62bc\u54c1\u6298\u7b97\u7387\uff0c\u662f\u5426\u53ef\u62b5\u62bc\u4f5c\u70ba\u4fdd\u8b49\u91d1\u7b49\u4fe1\u606f\u3002","sidebar":"v5SideBar"},"v5/account/contract-transaction-log":{"id":"v5/account/contract-transaction-log","title":"\u4ea4\u6613\u65e5\u8a8c","description":"\u652f\u6301\u67e5\u8a62\u7d93\u5178\u5e33\u6236\u4e0b\u5408\u7d04\u9322\u5305, \u4ee5\u53ca\u7d71\u4e00\u5e33\u6236\u4e0b\u53cd\u5411\u5408\u7d04\u9322\u5305\u88e1\u7684\u4ea4\u6613\u65e5\u8a8c","sidebar":"v5SideBar"},"v5/account/dcp-info":{"id":"v5/account/dcp-info","title":"\u67e5\u8a62DCP\u914d\u7f6e","description":"\u67e5\u8a62\u5e33\u6236\u7684\u5408\u7d04(USDT\u6c38\u7e8c, USDC\u6c38\u7e8c\u548cUSDC\u4ea4\u5272) / \u73fe\u8ca8 / \u671f\u6b0a\u7684dcp\u914d\u7f6e. \u5728\u8abf\u7528\u63a5\u53e3\u524d, \u8acb\u78ba\u4fdd\u5df2\u7d93\u548c\u5ba2\u6236\u7d93\u7406\u7533\u8acb\u4e86\u5e33\u6236DCP\u958b\u901a","sidebar":"v5SideBar"},"v5/account/fee-rate":{"id":"v5/account/fee-rate","title":"\u67e5\u8a62\u624b\u7e8c\u8cbb\u7387","description":"\u67e5\u8a62\u4ea4\u6613\u624b\u7e8c\u8cbb\u7387\u3002","sidebar":"v5SideBar"},"v5/account/get-mmp-state":{"id":"v5/account/get-mmp-state","title":"\u67e5\u8a62\u5e02\u5546\u4fdd\u8b77\u914d\u7f6e\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/account/repay-liability":{"id":"v5/account/repay-liability","title":"\u4e00\u9375\u9084\u6b3e","description":"\u60a8\u53ef\u4ee5\u901a\u904e\u8a72\u63a5\u53e3\u624b\u52d5\u9084\u6e05\u7d71\u4e00\u5e33\u6236\u4e2d\u7684\u501f\u6b3e","sidebar":"v5SideBar"},"v5/account/reset-mmp":{"id":"v5/account/reset-mmp","title":"\u91cd\u7f6e\u5e02\u5546\u4fdd\u8b77\u51cd\u7d50","description":"* \u4e00\u65e6mmp\u88ab\u89f8\u767c, \u60a8\u7684\u5e33\u6236\u53ef\u4ee5\u8abf\u7528\u8a72\u63a5\u53e3\u9032\u884c\u4e3b\u52d5\u89e3\u51cd, \u89e3\u51cd\u5f8c, qtyLimit\u548cdeltaLimit\u5c31\u91cd\u7f6e\u70ba0.","sidebar":"v5SideBar"},"v5/account/set-collateral":{"id":"v5/account/set-collateral","title":"\u8a2d\u7f6e\u62b5\u62bc\u54c1\u5e63\u7a2e","description":"\u7528\u6236\u53ef\u4ee5\u81ea\u884c\u6c7a\u5b9a\u662f\u5426\u958b\u555f\u7d71\u4e00\u5e33\u6236\u4e2d\u5e63\u7a2e\u662f\u5426\u9032\u884c\u62b5\u62bc\uff0c\u9ed8\u8a8d\u90fd\u662f\u95dc\u9589\u7684","sidebar":"v5SideBar"},"v5/account/set-margin-mode":{"id":"v5/account/set-margin-mode","title":"\u8a2d\u7f6e\u4fdd\u8b49\u91d1\u6a21\u5f0f(\u5e33\u6236)","description":"\u7528\u6236\u5982\u679c\u4e0d\u8a2d\u7f6e\uff0c\u9ed8\u8a8d\u6309\u5168\u5009\u4fdd\u8b49\u91d1","sidebar":"v5SideBar"},"v5/account/set-mmp":{"id":"v5/account/set-mmp","title":"\u8bbe\u7f6e\u5e02\u5546\u4fdd\u8b77","description":"\u4ec0\u9ebc\u662fMMP?","sidebar":"v5SideBar"},"v5/account/set-spot-hedge":{"id":"v5/account/set-spot-hedge","title":"\u8a2d\u7f6e\u73fe\u8ca8\u5c0d\u885d","description":"\u60a8\u53ef\u4ee5\u958b\u95dc\u73fe\u8ca8\u5c0d\u5f9e\u529f\u80fd, \u50c5\u9650\u7d71\u4e00\u5e33\u6236\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f\u4e0b","sidebar":"v5SideBar"},"v5/account/smp-group":{"id":"v5/account/smp-group","title":"\u67e5\u8a62SMP\u7d44ID","description":"\u67e5\u8a62\u81ea\u6210\u4ea4\u6514\u622a\u7684SMP\u4ea4\u6613\u7fa4\u7d44ID","sidebar":"v5SideBar"},"v5/account/transaction-log":{"id":"v5/account/transaction-log","title":"\u4ea4\u6613\u65e5\u8a8c","description":"\u6574\u500b\u8cec\u6236\u7d71\u4e00\u9322\u5305\u88e1\u7684\u4ea4\u6613\u65e5\u8a8c, \u652f\u6301\u6700\u591a\u67e5\u8a62\u904e\u53bb2\u5e74\u7684\u6578\u64da","sidebar":"v5SideBar"},"v5/account/upgrade-unified-account":{"id":"v5/account/upgrade-unified-account","title":"\u5347\u7d1a\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236","description":"\u5347\u7d1a\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236","sidebar":"v5SideBar"},"v5/account/wallet-balance":{"id":"v5/account/wallet-balance","title":"\u67e5\u8a62\u9322\u5305\u9918\u984d","description":"\u7372\u53d6\u7d71\u4e00\u5e33\u6236\u548c\u7d93\u5178\u5e33\u6236\u9322\u5305\u9918\u984d, \u67e5\u8a62\u5404\u500b\u5e63\u7a2e\u7684\u8cc7\u7522\u4fe1\u606f\uff0c\u4ee5\u53ca\u7d71\u4e00\u4fdd\u8b49\u91d1\u6a21\u5f0f\u4e0b\u7684\u5e33\u6236\u98a8\u96aa\u7387\u4fe1\u606f\u3002\u9ed8\u8a8d\u4e0d\u8fd4\u56de\u8cc7\u7522\u6216\u8ca0\u50b5\u70ba0\u7684\u5e63\u7a2e\u4fe1\u606f\u3002","sidebar":"v5SideBar"},"v5/announcement":{"id":"v5/announcement","title":"\u67e5\u8a62\u516c\u544a","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/asset/balance/account-coin-balance":{"id":"v5/asset/balance/account-coin-balance","title":"\u67e5\u8a62\u5e33\u6236\u55ae\u500b\u5e63\u7a2e\u9918\u984d","description":"\u7372\u53d6\u67d0\u5e33\u6236\u985e\u578b\u4e0b\u67d0\u6307\u5b9a\u5e63\u7a2e\u7684\u9918\u984d\u3002\u652f\u6301\u901a\u904e\u8f38\u5165\u5b50\u5e33\u6236id\u4f86\u67e5\u8a62\u5b50\u5e33\u6236\u7684\u67d0\u500b\u5e33\u6236\u985e\u578b\u4e0b\u7684\u67d0\u500b\u5e63\u7a2e\u9918\u984d","sidebar":"v5SideBar"},"v5/asset/balance/all-balance":{"id":"v5/asset/balance/all-balance","title":"\u67e5\u8a62\u8cec\u6236\u6240\u6709\u5e63\u7a2e\u4f59\u984d","description":"\u652f\u6301\u67e5\u8a62\u6bcd\u5e33\u6236\u7684\u5404\u500b\u5e33\u6236\u985e\u578b\u7684\u5e63\u7a2e\u9918\u984d\uff0c\u4ee5\u53ca\u6bcd\u5e33\u6236\u4e0b\u5404\u5b50\u5e33\u6236\u7684\u5404\u500b\u5e33\u6236\u985e\u578b\u7684\u5e63\u7a2e\u9918\u984d\u3002","sidebar":"v5SideBar"},"v5/asset/balance/asset-info":{"id":"v5/asset/balance/asset-info","title":"\u67e5\u8a62\u8cc7\u7522\u4fe1\u606f","description":"\u7576\u524d\u53ea\u80fd\u67e5\u8a62\u73fe\u8ca8\u5e33\u6236\u4e2d\u7684\u8cc7\u7522","sidebar":"v5SideBar"},"v5/asset/balance/delay-amount":{"id":"v5/asset/balance/delay-amount","title":"\u67e5\u8a62\u5ef6\u9072\u63d0\u5e63\u51cd\u7d50\u91d1\u984d","description":"\u5982\u4f55\u6703\u5c0e\u81f4\u90e8\u5206\u8cc7\u91d1\u88ab\u8981\u6c42\u5ef6\u9072\u63d0\u5e63\uff1f","sidebar":"v5SideBar"},"v5/asset/coin-info":{"id":"v5/asset/coin-info","title":"\u67e5\u8a62\u5e63\u7a2e\u4fe1\u606f","description":"\u7372\u53d6\u5e63\u7a2e\u4fe1\u606f\uff0c\u5305\u62ec\u93c8\u4fe1\u606f\uff0c\u662f\u5426\u53ef\u5145\u53ef\u63d0","sidebar":"v5SideBar"},"v5/asset/convert/apply-quote":{"id":"v5/asset/convert/apply-quote","title":"\u7533\u8acb\u5831\u50f9","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/asset/convert/confirm-quote":{"id":"v5/asset/convert/confirm-quote","title":"\u78ba\u8a8d\u5831\u50f9","description":"1. \u8a72\u63a5\u53e3\u662f\u7570\u6b65\u7684, \u8acb\u901a\u904e\u67e5\u8a62\u8acb\u6c42\u78ba\u8a8d\u6700\u7d42\u514c\u63db\u7d50\u679c","sidebar":"v5SideBar"},"v5/asset/convert/convert-coin-list":{"id":"v5/asset/convert/convert-coin-list","title":"\u67e5\u8a62\u514c\u63db\u5e63\u7a2e\u5217\u8868","description":"\u60a8\u53ef\u4ee5\u901a\u904e\u8a72\u63a5\u53e3\u7372\u53d6\u5230\u5404\u500b\u5e33\u6236\u5167\u7684\u514c\u5165\u514c\u51fa\u5e63\u7a2e\u5217\u8868","sidebar":"v5SideBar"},"v5/asset/convert/get-convert-history":{"id":"v5/asset/convert/get-convert-history","title":"\u67e5\u8a62\u514c\u63db\u6b77\u53f2","description":"\u90a3\u4e9b\u88ab\u78ba\u8a8d\u7684\u5831\u50f9\u55ae, \u4e0d\u7ba1\u6700\u7d42\u72c0\u614b\u5982\u4f55, \u8a72\u63a5\u53e3\u90fd\u6703\u8fd4\u56de","sidebar":"v5SideBar"},"v5/asset/convert/get-convert-result":{"id":"v5/asset/convert/get-convert-result","title":"\u67e5\u8a62\u5831\u50f9\u55ae\u72c0\u614b","description":"* \u60a8\u53ef\u4ee5\u901a\u904equoteTxId\u6307\u5b9a\u67e5\u8a62\u67d0\u7b46\u88ab\u78ba\u8a8d\u7684\u5831\u50f9\u55ae","sidebar":"v5SideBar"},"v5/asset/convert/guideline":{"id":"v5/asset/convert/guideline","title":"\u9583\u514c\u63a5\u5165\u6307\u5357","description":"* \u6240\u6709\u63a5\u53e3\u90fd\u9700\u8981\u9032\u884c\u9452\u6b0a","sidebar":"v5SideBar"},"v5/asset/delivery":{"id":"v5/asset/delivery","title":"\u67e5\u8a62\u4ea4\u5272\u7d00\u9304","description":"\u67e5\u8a62USDC\u4ea4\u5272\u548c\u671f\u6b0a\u7684\u4ea4\u5272\u7d00\u9304, \u8fd4\u56de\u7d50\u679c\u6309\u7167deliveryTime\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/asset/deposit/deposit-coin-spec":{"id":"v5/asset/deposit/deposit-coin-spec","title":"\u67e5\u8a62\u652f\u6301\u7684\u5145\u503c\u5e63\u7a2e\u4fe1\u606f","description":"\u901a\u904e\u5e63\u7a2e\u4fe1\u606f\u63a5\u53e3\uff0c\u7372\u53d6\u5e63\u93c8\u7d44\u5408","sidebar":"v5SideBar"},"v5/asset/deposit/deposit-record":{"id":"v5/asset/deposit/deposit-record","title":"\u67e5\u8a62\u5145\u503c\u7d00\u9304 (\u93c8\u4e0a)","description":"* endTime - startTime\u9700\u8981\u5c0f\u65bc\u7b49\u65bc30\u5929\uff0c\u9ed8\u8a8d\u67e5\u8a62\u6700\u8fd130\u5929\u7684\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/deposit/internal-deposit-record":{"id":"v5/asset/deposit/internal-deposit-record","title":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u5e73\u53f0\u8f6c\u8d26)","description":"\u67e5\u8a62Bybit\u5e73\u53f0\u5167\u90e8\u5145\u503c\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/deposit/master-deposit-addr":{"id":"v5/asset/deposit/master-deposit-addr","title":"\u67e5\u8a62\u4e3b\u5e33\u865f\u5145\u503c\u5730\u5740","description":"\u50c5\u652f\u6301\u6bcd\u5e33\u865fAPI key","sidebar":"v5SideBar"},"v5/asset/deposit/set-deposit-acct":{"id":"v5/asset/deposit/set-deposit-acct","title":"\u8a2d\u7f6e\u5145\u503c\u5e33\u6236","description":"\u8a2d\u7f6e\u5145\u503c\u5f8c\u7684\u81ea\u52d5\u8f49\u5165\u5e33\u6236\u985e\u578b\u3002\u8a72\u529f\u80fd\u8207\u7db2\u9801\u7aef-\u8a2d\u7f6e-\u5145\u503c\u4fdd\u6301\u4e00\u81f4\u3002","sidebar":"v5SideBar"},"v5/asset/deposit/sub-deposit-addr":{"id":"v5/asset/deposit/sub-deposit-addr","title":"\u67e5\u8a62\u5b50\u5e33\u865f\u5145\u503c\u5730\u5740","description":"\u50c5\u80fd\u4f7f\u7528\u8a72\u6bcd\u5e33\u865f\u7684API key","sidebar":"v5SideBar"},"v5/asset/deposit/sub-deposit-record":{"id":"v5/asset/deposit/sub-deposit-record","title":"\u67e5\u8a62\u5b50\u5e33\u865f\u7684\u5145\u503c\u7d00\u9304 (\u93c8\u4e0a)","description":"\u50c5\u80fd\u901a\u904e\u4e3b\u5e33\u865f\u7684API key\u4f86\u67e5\u8a62\u5b50\u5e33\u865f\u7684\u5145\u503c\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/exchange":{"id":"v5/asset/exchange","title":"\u67e5\u8a62\u514c\u63db\u8a02\u55ae\u7d00\u9304","description":"\u60a8\u53ef\u80fd\u6703\u906d\u9047\u8f03\u9577\u7684\u6578\u64da\u8fd4\u56de\u5ef6\u9072","sidebar":"v5SideBar"},"v5/asset/settlement":{"id":"v5/asset/settlement","title":"\u67e5\u8a62USDC\u7d50\u7b97\u7d00\u9304","description":"\u67e5\u8a62USDC\u6c38\u7e8c\u7684\u7d50\u7b97\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/sub-uid-list":{"id":"v5/asset/sub-uid-list","title":"\u67e5\u8a62\u5b50\u5e33\u865f\u5217\u8868","description":"\u67e5\u8a62\u67d0\u500b\u6bcd\u5e33\u6236\u7684\u5b50\u5e33\u865f\u5217\u8868, \u8fd4\u56de\u81f3\u591a2000\u500b\u5b50\u5e33\u6236, \u5982\u679c\u60a8\u6709\u66f4\u591a, \u53ef\u4ee5\u8abf\u7528\u9019\u500b\u63a5\u53e3.","sidebar":"v5SideBar"},"v5/asset/transfer/create-inter-transfer":{"id":"v5/asset/transfer/create-inter-transfer","title":"\u5283\u8f49 (\u55ae\u5e33\u865f\u5167)","description":"\u5275\u5efa\u55ae\u5e33\u865f\u4e0b\u5e33\u6236\u985e\u578b\u9593\u7684\u5283\u8f49\u64cd\u4f5c","sidebar":"v5SideBar"},"v5/asset/transfer/inter-transfer-list":{"id":"v5/asset/transfer/inter-transfer-list","title":"\u67e5\u8a62\u5283\u8f49\u7d00\u9304 (\u55ae\u5e33\u865f\u5167)","description":"\u7372\u53d6\u55ae\u5e33\u865f\u5167\u7684\u5283\u8f49\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/transfer/transferable-coin":{"id":"v5/asset/transfer/transferable-coin","title":"\u5e33\u6236\u985e\u578b\u9593\u53ef\u5283\u8f49\u7684\u5e63\u7a2e","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/asset/transfer/unitransfer":{"id":"v5/asset/transfer/unitransfer","title":"\u5275\u5efa\u842c\u80fd\u5283\u8f49","description":"\u652f\u6301\u5b50\u5b50\u5e33\u6236\u9593\u5283\u8f49\u6216\u6bcd\u5b50\u5e33\u865f\u9593\u5283\u8f49\u3002","sidebar":"v5SideBar"},"v5/asset/transfer/unitransfer-list":{"id":"v5/asset/transfer/unitransfer-list","title":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u7d00\u9304","description":"* \u6bcd\u5b50\u5e33\u865f\u7684api key\u90fd\u652f\u6301\u8abf\u7528","sidebar":"v5SideBar"},"v5/asset/withdraw/cancel-withdraw":{"id":"v5/asset/withdraw/cancel-withdraw","title":"\u64a4\u92b7\u63d0\u5e63","description":"\u50c5\u652f\u6301\u6bcd\u5e33\u865fAPI key","sidebar":"v5SideBar"},"v5/asset/withdraw/vasp-list":{"id":"v5/asset/withdraw/vasp-list","title":"\u67e5\u8a62\u4ea4\u6613\u6240\u5217\u8868","description":"\u8a72\u63a5\u53e3\u4e3b\u8981\u7528\u65bckyc=KOR\u7684\u97d3\u570b\u500b\u4eba\u7528\u6236, \u5728\u63d0\u73fe\u6642\u9700\u8981\u586b\u5beb\u63a5\u6536\u65b9\u4ea4\u6613\u6240\u4fe1\u606f","sidebar":"v5SideBar"},"v5/asset/withdraw/withdraw":{"id":"v5/asset/withdraw/withdraw","title":"\u63d0\u73fe","description":"\u82e5\u76ee\u6a19\u5730\u5740\u662fBybit\u5e73\u53f0\u5167\u90e8\u5730\u5740\uff0c\u60a8\u53ef\u4ee5\u5be6\u73fe\u5167\u90e8\u5e73\u53f0\u8f49\u5e33","sidebar":"v5SideBar"},"v5/asset/withdraw/withdraw-record":{"id":"v5/asset/withdraw/withdraw-record","title":"\u67e5\u8a62\u63d0\u73fe\u7d00\u9304","description":"* endTime - startTime\u9700\u8981\u5c0f\u65bc\u7b49\u65bc30\u5929. \u9ed8\u8a8d\u67e5\u8a62\u6700\u8fd130\u5929\u7684\u7d00\u9304\u3002","sidebar":"v5SideBar"},"v5/backup/set-pledge-token":{"id":"v5/backup/set-pledge-token","title":"Set Pledge Token","description":"Set Pledge Token in cross margin"},"v5/broker/account-info":{"id":"v5/broker/account-info","title":"\u67e5\u8a62\u7d93\u7d00\u5546\u5e33\u6236\u4fe1\u606f","description":"* \u4f7f\u7528\u7d93\u7d00\u5546\u7684\u6bcd\u5e33\u6236\u9032\u884c\u67e5\u8a62","sidebar":"v5SideBar"},"v5/broker/exchange-earning":{"id":"v5/broker/exchange-earning","title":"\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63\u4fe1\u606f","description":"* \u4f7f\u7528\u7d93\u7d00\u5546\u7684\u6bcd\u5e33\u6236\u9032\u884c\u67e5\u8a62","sidebar":"v5SideBar"},"v5/broker/sub-deposit-record":{"id":"v5/broker/sub-deposit-record","title":"\u67e5\u8a62\u7d93\u7d00\u5546\u7684\u5b50\u5e33\u865f\u5145\u503c\u7d00\u9304","description":"\u7d93\u7d00\u5546\u50c5\u80fd\u901a\u904e\u4e3b\u5e33\u865f\u7684API key\u4f86\u67e5\u8a62\u5b50\u5e33\u865f\u7684\u5145\u503c\u7d00\u9304","sidebar":"v5SideBar"},"v5/copytrade":{"id":"v5/copytrade","title":"\u5982\u4f55\u4f7f\u7528API\u5e36\u55ae","description":"\u6210\u70ba\u4ea4\u6613\u9054\u4eba","sidebar":"v5SideBar"},"v5/demo":{"id":"v5/demo","title":"\u6a21\u64ec\u4ea4\u6613","description":"\u6982\u89bd","sidebar":"v5SideBar"},"v5/enum":{"id":"v5/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"locale","sidebar":"v5SideBar"},"v5/error":{"id":"v5/error","title":"\u932f\u8aa4\u78bc","description":"HTTP \u97ff\u61c9\u78bc","sidebar":"v5SideBar"},"v5/guide":{"id":"v5/guide","title":"\u63a5\u5165\u6307\u5357","description":"\u6b32\u8a73\u7d30\u4e86\u89e3 V5 API \u5185\u5bb9\uff0c\u9084\u8acb\u4ed4\u7d30\u95b1\u8b80\u6982\u89bd","sidebar":"v5SideBar"},"v5/intro":{"id":"v5/intro","title":"\u6982\u89bd","description":"\u7c21\u4ecb","sidebar":"v5SideBar"},"v5/lt/leverage-token-info":{"id":"v5/lt/leverage-token-info","title":"LT\u5168\u91cf\u8cc7\u7522\u67e5\u8a62","description":"\u67e5\u8a62\u69d3\u687f\u4ee3\u5e63\u4fe1\u606f","sidebar":"v5SideBar"},"v5/lt/leverage-token-reference":{"id":"v5/lt/leverage-token-reference","title":"\u67e5\u8a62LT\u884c\u60c5","description":"\u67e5\u8a62LT\u884c\u60c5","sidebar":"v5SideBar"},"v5/lt/order-record":{"id":"v5/lt/order-record","title":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","description":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","sidebar":"v5SideBar"},"v5/lt/purchase":{"id":"v5/lt/purchase","title":"\u7533\u8cfc","description":"\u7533\u8cfc","sidebar":"v5SideBar"},"v5/lt/redeem":{"id":"v5/lt/redeem","title":"\u8d16\u56de","description":"\u8d16\u56de","sidebar":"v5SideBar"},"v5/market/delivery-price":{"id":"v5/market/delivery-price","title":"\u67e5\u8a62\u4ea4\u5272\u50f9\u683c","description":"\u67e5\u8a62\u5e73\u53f0\u4ea4\u5272\u7522\u54c1\u7684\u4ea4\u5272\u50f9\u683c\uff0c\u652f\u6301\u53cd\u5411\u4ea4\u5272, USDC\u4ea4\u5272\u548c\u671f\u6b0a","sidebar":"v5SideBar"},"v5/market/history-fund-rate":{"id":"v5/market/history-fund-rate","title":"\u67e5\u8a62\u6b77\u53f2\u8cc7\u91d1\u8cbb\u7387","description":"\u67e5\u8a62\u8cc7\u91d1\u8cbb\u7387\uff0c\u6bcf\u500bsymbol\u7684\u8cc7\u91d1\u8cbb\u7387\u7522\u751f\u9031\u671f\u4e0d\u540c\u3002\u5047\u8a2d\u8cc7\u91d1\u8cbb\u7387\u70ba8\u5c0f\u6642\uff0c\u7576\u524d\u6642\u9593\u662fUTC12\u9ede\uff0c\u5247\u8fd4\u56de\u7684\u662f\u4e0a\u4e00\u500b\u7d50\u7b97\u5373UTC8\u9ede\u7522\u751f\u7684\u8cc7\u91d1\u8cbb\u7387\u3002\u5982\u8981\u67e5\u8a62symbol\u7684\u8cc7\u91d1\u8cbb\u7387\u6642\u9593\u9593\u9694\uff0c\u8acb\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u898f\u683c\u63a5\u53e3","sidebar":"v5SideBar"},"v5/market/index-kline":{"id":"v5/market/index-kline","title":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda","sidebar":"v5SideBar"},"v5/market/instrument":{"id":"v5/market/instrument","title":"\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u898f\u683c\u4fe1\u606f","description":"\u67e5\u8a62\u5168\u7ad9\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u57fa\u790e\u914d\u7f6e\u898f\u5247\u4fe1\u606f","sidebar":"v5SideBar"},"v5/market/insurance":{"id":"v5/market/insurance","title":"\u67e5\u8a62\u4fdd\u96aa\u57fa\u91d1","description":"\u67e5\u8a62Bybit\u5e73\u53f0\u7684\u4fdd\u96aa\u57fa\u91d1\u7684\u6578\u64da\uff0c\u5305\u542b\u6240\u6709\u4fdd\u96aa\u6c60\u7684\u6578\u64da\uff0c\u6578\u64da\u6bcf24\u5c0f\u6642\u66f4\u65b0\u4e00\u6b21\u3002","sidebar":"v5SideBar"},"v5/market/iv":{"id":"v5/market/iv","title":"\u67e5\u8a62\u671f\u6b0a\u6ce2\u52d5\u7387","description":"\u7372\u53d6\u671f\u6b0a\u7684\u6b77\u53f2\u6ce2\u52d5\u7387\u6578\u64da","sidebar":"v5SideBar"},"v5/market/kline":{"id":"v5/market/kline","title":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","sidebar":"v5SideBar"},"v5/market/long-short-ratio":{"id":"v5/market/long-short-ratio","title":"\u67e5\u8a62\u591a\u7a7a\u6bd4","description":"HTTP\u8acb\u6c42","sidebar":"v5SideBar"},"v5/market/mark-kline":{"id":"v5/market/mark-kline","title":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda","sidebar":"v5SideBar"},"v5/market/open-interest":{"id":"v5/market/open-interest","title":"\u67e5\u8a62\u672a\u5e73\u5009\u5408\u7d04\u6301\u5009\u6578\u91cf","description":"\u67e5\u8a62\u5404\u500b\u5408\u7d04\u5e02\u5834\u5167\u6240\u6709\u672a\u5e73\u5009\u7684\u6578\u91cf","sidebar":"v5SideBar"},"v5/market/orderbook":{"id":"v5/market/orderbook","title":"Order Book (\u6df1\u5ea6)","description":"\u7372\u53d6\u6df1\u5ea6\u6578\u64da","sidebar":"v5SideBar"},"v5/market/preimum-index-kline":{"id":"v5/market/preimum-index-kline","title":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","sidebar":"v5SideBar"},"v5/market/recent-trade":{"id":"v5/market/recent-trade","title":"\u67e5\u8a62\u5e73\u53f0\u6700\u8fd1\u6210\u4ea4\u6b77\u53f2","description":"\u7372\u53d6\u5e73\u53f0\u6700\u8fd1\u6210\u4ea4\u6578\u64da","sidebar":"v5SideBar"},"v5/market/risk-limit":{"id":"v5/market/risk-limit","title":"\u67e5\u8a62\u5408\u7d04\u98a8\u96aa\u9650\u984d","description":"\u67e5\u8a62\u671f\u8ca8\u5408\u7d04\u7684\u98a8\u96aa\u9650\u984d\u8868","sidebar":"v5SideBar"},"v5/market/tickers":{"id":"v5/market/tickers","title":"\u67e5\u8a62\u6700\u65b0\u884c\u60c5\u4fe1\u606f","description":"\u53ef\u7372\u53d6\u5230\u5feb\u7167\u7684\u6700\u65b0\u5e02\u5834\u50f9\u683c\uff0c\u6700\u4f73\u8cb7\u8ce3\u50f9\u683c\uff0c\u4ee5\u53ca\u904e\u53bb\u6642\u9593\u5167\u7684\u4ea4\u6613\u91cf\u7b49.","sidebar":"v5SideBar"},"v5/market/time":{"id":"v5/market/time","title":"Bybit\u670d\u52d9\u5668\u6642\u9593","description":"\u7372\u53d6Bybit\u670d\u52d9\u5668\u6642\u9593","sidebar":"v5SideBar"},"v5/order/amend-order":{"id":"v5/order/amend-order","title":"\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u7d71\u4e00\u5e33\u6236\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 / USDT\u6c38\u7e8c / USDC\u6c38\u7e8c / USDC\u4ea4\u5272 / \u53cd\u5411\u5408\u7d04 / \u671f\u6b0a","sidebar":"v5SideBar"},"v5/order/batch-amend":{"id":"v5/order/batch-amend","title":"\u6279\u91cf\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 (\u7d71\u4e00\u5e33\u6236) / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236) / USDT\u6c38\u7e8c\u3001USDC\u6c38\u7e8c\u3001USDC\u4ea4\u5272 (UTA Pro)","sidebar":"v5SideBar"},"v5/order/batch-cancel":{"id":"v5/order/batch-cancel","title":"\u6279\u91cf\u64a4\u92b7\u59d4\u8a17\u55ae","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u6279\u91cf\u64a4\u92b7\u591a\u7b46\u8a02\u55ae","sidebar":"v5SideBar"},"v5/order/batch-place":{"id":"v5/order/batch-place","title":"\u6279\u91cf\u5275\u5efa\u59d4\u8a17\u55ae","description":"\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 (\u7d71\u4e00\u5e33\u6236) / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236) / USDT\u6c38\u7e8c\u3001USDC\u6c38\u7e8c\u3001USDC\u4ea4\u5272 (UTA Pro)","sidebar":"v5SideBar"},"v5/order/cancel-all":{"id":"v5/order/cancel-all","title":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","description":"\u64a4\u92b7\u5168\u90e8\u59d4\u8a17\u55ae","sidebar":"v5SideBar"},"v5/order/cancel-order":{"id":"v5/order/cancel-order","title":"\u64a4\u92b7\u59d4\u8a17\u55ae","description":"\u7d71\u4e00\u5e33\u6236\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 / USDT\u6c38\u7e8c / USDC\u6c38\u7e8c / USDC\u4ea4\u5272 / \u671f\u6b0a","sidebar":"v5SideBar"},"v5/order/create-order":{"id":"v5/order/create-order","title":"\u5275\u5efa\u59d4\u8a17\u55ae","description":"\u672c\u63a5\u53e3\u63d0\u4f9b\u5e63\u5e63\u4ea4\u6613\uff0c\u73fe\u8ca8\u69d3\u687f\u4ea4\u6613\uff0c\u5408\u7d04\u4ee5\u53ca\u671f\u6b0a\u7684\u8a02\u55ae\u5275\u5efa\u3002","sidebar":"v5SideBar"},"v5/order/dcp":{"id":"v5/order/dcp","title":"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593","description":"\u8986\u84cb\u7bc4\u570d: \u5408\u7d04 / \u73fe\u8ca8 / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236)","sidebar":"v5SideBar"},"v5/order/execution":{"id":"v5/order/execution","title":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304","description":"\u7372\u53d6\u7528\u6236\u6210\u4ea4\u7d00\u9304\uff0c\u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217\u3002\u4f46\u662f\uff0c\u5c0d\u65bc\u7d93\u5178\u5e33\u6236\u73fe\u8ca8\u4ea4\u6613\uff0c\u8fd4\u56de\u7d50\u679c\u6309execId\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/order/open-order":{"id":"v5/order/open-order","title":"\u67e5\u8a62\u5be6\u6642\u548c\u7d42\u614b\u59d4\u8a17\u55ae","description":"\u4e3b\u8981\u7528\u65bc\u5be6\u6642\u67e5\u8a62\u672a\u6210\u4ea4\u6216\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u4fe1\u606f, \u4f46\u7d50\u5408\u5165\u53c2openOnly\u80fd\u5920\u67e5\u8a62\u5230\u6700\u8fd1500\u689d\u5230\u9054\u7d42\u614b\u7684\u8a02\u55ae. \u82e5\u9700\u8981\u67e5\u8a62\u66f4\u4e45\u7684\u8a02\u55ae\u7d00\u9304\uff0c\u8acb\u4f7f\u7528\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae\u63a5\u53e3.","sidebar":"v5SideBar"},"v5/order/order-list":{"id":"v5/order/order-list","title":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae","description":"\u7372\u53d6\u6b77\u53f2\u8a02\u55ae\u7d00\u9304. \u7531\u65bc\u8a02\u55ae\u5275\u5efa/\u64a4\u92b7\u662f\u7570\u6b65\u7684, \u8a72\u63a5\u53e3\u8fd4\u56de\u6578\u64da\u53ef\u80fd\u6703\u6709\u5ef6\u9072. \u82e5\u60a8\u60f3\u5be6\u6642\u7372\u53d6\u8a02\u55ae\u4fe1\u606f, \u60a8\u53ef\u4ee5\u67e5\u8a62\u8a72\u63a5\u53e3\u6216\u8005\u901a\u904ewebsocket\u63a8\u9001(\u63a8\u85a6)","sidebar":"v5SideBar"},"v5/order/spot-borrow-quota":{"id":"v5/order/spot-borrow-quota","title":"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)","description":"\u53ef\u4ee5\u67e5\u8a62\u73fe\u8ca8\u5e63\u5e63\u4ea4\u6613\u4ee5\u53ca\u69d3\u687f\u4ea4\u6613\u6642, \u53ef\u7528\u5c0d\u61c9\u5e63\u7a2e\u7684\u5be6\u6642\u9918\u984d","sidebar":"v5SideBar"},"v5/otc/bind-uid":{"id":"v5/otc/bind-uid","title":"\u7d81\u5b9a/\u89e3\u7d81UID","description":"\u5c0d\u65bc\u5834\u5916\u501f\u8cb8\u7522\u54c1, \u60a8\u53ef\u4ee5\u81ea\u884c\u7d81\u5b9a\u65b0\u7684UID\u5230\u98a8\u96aa\u55ae\u5143\u5167\u6216\u8005\u89e3\u7d81\u67d0\u500bUID","sidebar":"v5SideBar"},"v5/otc/loan-info":{"id":"v5/otc/loan-info","title":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u4fe1\u606f","description":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u7684\u8a73\u60c5","sidebar":"v5SideBar"},"v5/otc/ltv-convert":{"id":"v5/otc/ltv-convert","title":"\u67e5\u8a62\u98a8\u96aa\u7387","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/otc/margin-coin-convert-info":{"id":"v5/otc/margin-coin-convert-info","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"* \u8a72\u63a5\u53e3\u5728\u4e0d\u50b3\u5165api key\u548csecret\u9032\u884c\u9452\u6b0a\u6642, \u5247\u8fd4\u56de\u516c\u5171\u6578\u64da","sidebar":"v5SideBar"},"v5/otc/margin-product-info":{"id":"v5/otc/margin-product-info","title":"\u67e5\u8a62\u7522\u54c1\u4fe1\u606f","description":"* \u8a72\u63a5\u53e3\u5728\u4e0d\u50b3\u5165api key\u548csecret\u9032\u884c\u9452\u6b0a\u6642, \u5247\u8fd4\u56de\u516c\u5171\u7522\u54c1\u6578\u64da","sidebar":"v5SideBar"},"v5/otc/repay-info":{"id":"v5/otc/repay-info","title":"\u67e5\u8a62\u9084\u6b3e\u4fe1\u606f","description":"* \u9ed8\u8a8d\u67e5\u8a62\u904e\u53bb2\u5e74\u7684\u6578\u64da","sidebar":"v5SideBar"},"v5/position/auto-add-margin":{"id":"v5/position/auto-add-margin","title":"\u8a2d\u7f6e\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1","description":"\u958b\u95dc\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1\uff0c\u50c5\u9069\u7528\u65bc\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f","sidebar":"v5SideBar"},"v5/position/close-pnl":{"id":"v5/position/close-pnl","title":"\u67e5\u8a62\u5e73\u5009\u76c8\u8667","description":"\u7372\u53d6\u7576\u524d\u7528\u6236\u7684\u6240\u6709\u5e73\u5009\u76c8\u8667\u6578\u64da\uff0c\u8fd4\u56de\u7d50\u679c\u6309\u7167createdTime\u964d\u5e8f\u6392\u5217.","sidebar":"v5SideBar"},"v5/position/confirm-mmr":{"id":"v5/position/confirm-mmr","title":"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d","description":"\u50c5\u9069\u7528\u65bc\u7576\u7528\u6236\u88ab\u6a19\u8a18\u70ba\u50c5\u6e1b\u5009 (\u8acb\u770b\u6301\u5009\u63a5\u53e3\u4e2d\u7684isReduceOnly\u5b57\u6bb5) \u6642, \u5728\u7528\u6236\u4e3b\u52d5\u8abf\u6574\u98a8\u96aa\u6c34\u4f4d\u5f8c, \u8abf\u7528\u8a72\u63a5\u53e3\u4f86\u8a66\u7b97\u8abf\u6574\u5f8c\u7684\u98a8","sidebar":"v5SideBar"},"v5/position/cross-isolate":{"id":"v5/position/cross-isolate","title":"\u5207\u63db\u5168\u5009/\u9010\u5009\u4fdd\u8b49\u91d1(\u4ea4\u6613\u5c0d)","description":"\u9078\u64c7\u5168\u5009\u4fdd\u8b49\u91d1\u6216\u8005\u662f\u9010\u5009\u4fdd\u8b49\u91d1\uff0c\u8acb\u53c3\u95b1\u9019\u88e1\u4e86\u89e3\u95dc\u65bc\u5168\u5009/\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f\u3002","sidebar":"v5SideBar"},"v5/position/leverage":{"id":"v5/position/leverage","title":"\u8a2d\u7f6e\u69d3\u687f","description":"\u8a2d\u7f6e\u69d3\u687f","sidebar":"v5SideBar"},"v5/position/manual-add-margin":{"id":"v5/position/manual-add-margin","title":"\u624b\u52d5\u589e\u52a0\u6216\u6e1b\u5c11\u4fdd\u8b49\u91d1","description":"\u624b\u52d5\u589e\u52a0\u6216\u6e1b\u5c11\u4fdd\u8b49\u91d1\uff0c\u50c5\u9069\u7528\u65bc\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f","sidebar":"v5SideBar"},"v5/position/move-position":{"id":"v5/position/move-position","title":"\u79fb\u5009","description":"\u60a8\u53ef\u4ee5\u5728\u540c\u4e00\u500b\u6bcd\u5b50\u5e33\u6236\u9ad4\u7cfb\u4e0b\u79fb\u52d5\u671f\u8ca8\u3001\u671f\u6b0a\u7684\u5009\u4f4d, \u4ee5\u53ca\u73fe\u8ca8\u7684\u5e63\u5e63\u4ea4\u6613","sidebar":"v5SideBar"},"v5/position/move-position-history":{"id":"v5/position/move-position-history","title":"\u67e5\u8a62\u79fb\u5009\u6b77\u53f2","description":"\u60a8\u53ef\u4ee5\u901a\u904e\u4f7f\u7528\u6bcd\u5e33\u6236\u7684api key\u67e5\u8a62\u904e\u53bb\u7684\u79fb\u5009\u6b77\u53f2\u7d00\u9304","sidebar":"v5SideBar"},"v5/position/position":{"id":"v5/position/position","title":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49","sidebar":"v5SideBar"},"v5/position/position-mode":{"id":"v5/position/position-mode","title":"\u5207\u63db\u6301\u5009\u6a21\u5f0f","description":"\u8a72\u63a5\u53e3\u652f\u6301\u5207\u63dbUSDT\u6c38\u7e8c\u548c\u53cd\u5411\u4ea4\u5272\u7684\u6301\u5009\u6a21\u5f0f\u3002\u5982\u679c\u8655\u65bc\u55ae\u5411\u6301\u5009\u6a21\u5f0f\u4e0b\uff0c\u60a8\u53ea\u80fd\u8981\u9ebc\u6301\u6709\u591a\u982d\u8981\u9ebc\u7a7a\u982d\u5009\u4f4d\uff1b\u5982\u679c\u8655\u65bc\u96d9\u5411\u6301\u5009\u6a21\u5f0f\u4e0b\uff0c\u60a8\u53ef\u4ee5\u540c\u6642\u6301\u5009\u591a\u982d\u548c\u7a7a\u982d\u7684\u5009\u4f4d\u3002","sidebar":"v5SideBar"},"v5/position/set-risk-limit":{"id":"v5/position/set-risk-limit","title":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d","description":"\u7531\u65bcBybit\u57282024\u5e743\u670812\u65e5\u4e0a\u7dda\u4e86\u81ea\u52d5\u8abf\u6574risk limit\u529f\u80fd, \u8a73\u60c5\u8acb\u898b\u9019\u88e1, \u56e0\u6b64\u5118\u7ba1\u63a5\u53e3\u80fd\u8abf\u901a, \u4f46\u662f\u6c92\u6709\u4efb\u4f55\u610f\u7fa9","sidebar":"v5SideBar"},"v5/position/tpsl-mode":{"id":"v5/position/tpsl-mode","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","description":"\u67d0\u7a2e\u7a0b\u5ea6\u4e0a\u4f86\u8aaa\uff0c\u8a72\u63a5\u53e3\u5df2\u7d93**\u5ee2\u68c4**, \u539f\u56e0\u5728\u65bc\u65b0\u7248\u7684\u6b62\u76c8\u6b62\u640d\u6a5f\u5236\u662f\u57fa\u65bc\u8a02\u55ae\u7dad\u5ea6. \u9019\u500b\u63a5\u53e3\u7576\u521d\u4e3b\u8981\u662f\u7528\u65bc\u5009\u4f4d\u7dad\u5ea6\u7684\u6b62\u76c8\u6b62\u640d","sidebar":"v5SideBar"},"v5/position/trading-stop":{"id":"v5/position/trading-stop","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u8a2d\u7f6e\u6b62\u76c8\u3001\u6b62\u640d\u548c\u8ffd\u8e64\u6b62\u640d","sidebar":"v5SideBar"},"v5/pre-upgrade/close-pnl":{"id":"v5/pre-upgrade/close-pnl","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u5e73\u5009\u76c8\u8667","description":"\u50c5\u652f\u6301\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684USDT\u6c38\u7e8c / \u53cd\u5411\u5408\u7d04, \u8fd4\u56de\u7d50\u679c\u6309\u7167updatedTime\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/pre-upgrade/delivery":{"id":"v5/pre-upgrade/delivery","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u671f\u6b0a\u4ea4\u5272\u7d00\u9304","description":"\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684\u671f\u6b0a\u7684\u4ea4\u5272\u7d00\u9304, \u8fd4\u56de\u7d50\u679c\u6309\u7167deliveryTime\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/pre-upgrade/execution":{"id":"v5/pre-upgrade/execution","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u6210\u4ea4\u7d00\u9304","description":"\u76ee\u524d\uff0c\u50c5\u652f\u6301\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684USDT\u6c38\u7e8c, USDC\u6c38\u7e8c, \u53cd\u5411\u5408\u7d04\u548c\u671f\u6b0a, \u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/pre-upgrade/order-list":{"id":"v5/pre-upgrade/order-list","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u8a02\u55ae\u7d00\u9304","description":"\u652f\u6301\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684USDT\u6c38\u7e8c, USDC\u6c38\u7e8c, \u53cd\u5411\u5408\u7d04\u548c\u671f\u6b0a","sidebar":"v5SideBar"},"v5/pre-upgrade/settlement":{"id":"v5/pre-upgrade/settlement","title":"\u67e5\u8a62\u5347\u7d1a\u524dUSDC\u7d50\u7b97\u7d00\u9304","description":"\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684USDC\u6c38\u7e8c\u7684\u7d50\u7b97\u7d00\u9304","sidebar":"v5SideBar"},"v5/pre-upgrade/transaction-log":{"id":"v5/pre-upgrade/transaction-log","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u4ea4\u6613\u65e5\u8a8c","description":"\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524dUSDC\u5408\u7d04\u5e33\u6236\u88e1\u7684\u4ea4\u6613\u65e5\u8a8c","sidebar":"v5SideBar"},"v5/rate-limit":{"id":"v5/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b","sidebar":"v5SideBar"},"v5/smp":{"id":"v5/smp","title":"\u81ea\u6210\u4ea4\u6514\u622a","description":"\u4ec0\u9ebc\u662f\u81ea\u6210\u4ea4\uff1f","sidebar":"v5SideBar"},"v5/spot-margin-normal/account-info":{"id":"v5/spot-margin-normal/account-info","title":"\u67e5\u8a62\u501f\u8cb8\u5e33\u6236\u4fe1\u606f","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/borrow":{"id":"v5/spot-margin-normal/borrow","title":"\u501f\u6b3e","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/borrow-order":{"id":"v5/spot-margin-normal/borrow-order","title":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/borrowable-data":{"id":"v5/spot-margin-normal/borrowable-data","title":"\u67e5\u8a62\u53ef\u501f\u5e63\u7a2e\u7cbe\u5ea6","description":"\u4e0d\u9700\u8981\u9452\u6b0a"},"v5/spot-margin-normal/interest-quota":{"id":"v5/spot-margin-normal/interest-quota","title":"\u67e5\u8a62\u5229\u7387\u53ca\u984d\u5ea6","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/margin-data":{"id":"v5/spot-margin-normal/margin-data","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"\u4e0d\u9700\u8981\u9452\u6b0a"},"v5/spot-margin-normal/repay":{"id":"v5/spot-margin-normal/repay","title":"\u9084\u6b3e","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/repay-order":{"id":"v5/spot-margin-normal/repay-order","title":"\u67e5\u8a62\u9084\u6b3e\u8a02\u55ae\u4fe1\u606f","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/switch-mode":{"id":"v5/spot-margin-normal/switch-mode","title":"\u5168\u5009\u69d3\u687f\u958b\u95dc","description":"\u958b\u555f\u6216\u95dc\u9589\u5168\u5009\u69d3\u687f\u4ea4\u6613"},"v5/spot-margin-normal/vip-margin":{"id":"v5/spot-margin-normal/vip-margin","title":"\u67e5\u8a62\u4e0d\u540cVIP\u7684\u69d3\u687f\u6578\u64da","description":"\u67e5\u8a62\u7d93\u5178\u5e33\u6236\u4e0b\u4e0d\u540cVIP\u7b49\u7d1a\u7684\u69d3\u687f\u6578\u64da"},"v5/spot-margin-uta/historical-interest":{"id":"v5/spot-margin-uta/historical-interest","title":"\u67e5\u8a62\u501f\u8cb8\u6b77\u53f2\u5229\u7387","description":"\u60a8\u53ef\u4ee5\u67e5\u8a62\u6700\u591a\u904e\u53bb6\u500b\u6708\u7684\u501f\u8cb8\u5229\u7387\u6578\u64da","sidebar":"v5SideBar"},"v5/spot-margin-uta/set-leverage":{"id":"v5/spot-margin-uta/set-leverage","title":"\u5168\u5009\u69d3\u687f\u8a2d\u7f6e","description":"\u5168\u5009\u69d3\u687f\u8a2d\u7f6e\u7528\u6236\u6700\u5927\u69d3\u687f\u500d\u6578","sidebar":"v5SideBar"},"v5/spot-margin-uta/status":{"id":"v5/spot-margin-uta/status","title":"\u67e5\u8a62\u958b\u95dc\u72c0\u614b\u548c\u500d\u6578","description":"\u67e5\u8a62\u7d71\u4e00\u5e33\u6236\u4e0b\u69d3\u687f\u4ea4\u6613\u7684\u958b\u95dc\u72c0\u614b\u548c\u69d3\u687f\u500d\u6578","sidebar":"v5SideBar"},"v5/spot-margin-uta/switch-mode":{"id":"v5/spot-margin-uta/switch-mode","title":"\u5168\u5009\u69d3\u687f\u958b\u95dc","description":"\u5168\u5009\u69d3\u687f\u958b\u95dc","sidebar":"v5SideBar"},"v5/spot-margin-uta/vip-margin":{"id":"v5/spot-margin-uta/vip-margin","title":"\u67e5\u8a62\u4e0d\u540cVIP\u7684\u69d3\u687f\u6578\u64da","description":"\u67e5\u8a62\u7d71\u4e00\u5e33\u6236\u4e0b\u4e0d\u540cVIP\u7b49\u7d1a\u7684\u69d3\u687f\u6578\u64da","sidebar":"v5SideBar"},"v5/user/affiliate-info":{"id":"v5/user/affiliate-info","title":"\u67e5\u8a62\u4ee3\u7406\u7528\u6236\u4fe1\u606f","description":"\u8981\u4f7f\u7528\u6b64\u63a5\u53e3\uff0c\u60a8\u5e94\u8be5\u6709\u4e00\u4e2a\u4ee3\u7406\u5546\u8d26\u6237\uff0c\u5e76\u4e14\u5728\u521b\u5efa API \u5bc6\u94a5\u65f6\u4ec5\u52fe\u9009\u201c\u4ee3\u7406\u5546\u201d\u6743\u9650\u3002","sidebar":"v5SideBar"},"v5/user/apikey-info":{"id":"v5/user/apikey-info","title":"\u67e5\u8a62API Key\u76f8\u95dc\u4fe1\u606f","description":"\u7372\u53d6API key\u7684\u76f8\u95dc\u4fe1\u606f\u3002\u4f7f\u7528\u5f85\u67e5\u8a62\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9069\u7528\u65bc\u6bcd\u3001\u5b50\u5e33\u6236\u7684api key\u3002","sidebar":"v5SideBar"},"v5/user/create-subuid":{"id":"v5/user/create-subuid","title":"\u65b0\u5efa\u5b50\u5e33\u6236","description":"\u5275\u5efa\u65b0\u7684\u5b50\u5e33\u6236\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/create-subuid-apikey":{"id":"v5/user/create-subuid-apikey","title":"\u65b0\u5efa\u5b50\u5e33\u6236\u7684API Key","description":"\u7d66\u65b0\u5efa\u597d\u7684\u5b50\u5e33\u6236\u5275\u5efa\u65b0\u7684API key\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/froze-subuid":{"id":"v5/user/froze-subuid","title":"\u51cd\u7d50/\u89e3\u51cd\u5b50\u5e33\u6236","description":"\u51cd\u7d50\u6216\u89e3\u51cd\u5b50\u5e33\u6236\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/list-sub-apikeys":{"id":"v5/user/list-sub-apikeys","title":"\u67e5\u8a62\u5b50\u5e33\u6236\u7684\u6240\u6709API Key\u4fe1\u606f","description":"\u67e5\u8a62\u67d0\u500b\u5b50\u5e33\u6236\u4e0b\u6240\u6709\u7684api key","sidebar":"v5SideBar"},"v5/user/modify-master-apikey":{"id":"v5/user/modify-master-apikey","title":"\u4fee\u6539\u6bcd\u5e33\u6236\u7684API Key\u8a2d\u7f6e","description":"\u4fee\u6539\u6bcd\u5e33\u6236API key\u7684\u8a2d\u7f6e\u3002\u4f7f\u7528\u5f85\u4fee\u6539\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/modify-sub-apikey":{"id":"v5/user/modify-sub-apikey","title":"\u4fee\u6539\u5b50\u5e33\u6236\u7684API Key\u8a2d\u7f6e","description":"\u4fee\u6539\u5b50\u5e33\u6236API key\u7684\u8a2d\u7f6e, \u652f\u6301\u6bcd\u5e33\u6236\u7ba1\u7406\u5b50\u5e33\u6236key\u7684\u8a2d\u7f6e, \u6216\u8005\u5b50\u5e33\u6236key\u76f4\u63a5\u4fee\u6539\u672c\u8eab\u3002","sidebar":"v5SideBar"},"v5/user/page-subuid":{"id":"v5/user/page-subuid","title":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868 (\u7121\u9650\u5236)","description":"\u901a\u904e\u7ffb\u9801\u7372\u53d6\u7576\u524d\u6bcd\u5e33\u6236\u4e0b\u6240\u6709\u7684\u5b50\u5e33\u6236\u5217\u8868\uff0c\u9069\u5408\u8d85\u904e\u64c1\u67091\u842c\u500b\u5b50\u5e33\u6236\u7684\u6bcd\u5e33\u6236\u9032\u884c\u8abf\u7528\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/rm-master-apikey":{"id":"v5/user/rm-master-apikey","title":"\u522a\u9664\u6bcd\u5e33\u6236\u7684API Key","description":"\u522a\u9664\u6bcd\u5e33\u6236\u4e0b\u7684api key\u3002\u4f7f\u7528\u5f85\u522a\u9664\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/rm-sub-apikey":{"id":"v5/user/rm-sub-apikey","title":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684API Key","description":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684api key\u3002\u4f7f\u7528\u5f85\u522a\u9664\u7684\u5b50\u5e33\u6236api key\u8abf\u7528\u63a5\u53e3\u6216\u8005\u4f7f\u7528\u6bcd\u5e33\u6236\u8abf\u7528\u522a\u9664\u6307\u5b9aapi key","sidebar":"v5SideBar"},"v5/user/rm-subuid":{"id":"v5/user/rm-subuid","title":"\u522a\u9664\u5b50\u5e33\u6236","description":"\u522a\u9664\u5b50\u5e33\u6236. \u5728\u522a\u9664\u524d, \u78ba\u4fdd\u8a72\u5e33\u6236\u5df2\u7d93\u6c92\u6709\u8cc7\u7522\u4e86","sidebar":"v5SideBar"},"v5/user/subuid-list":{"id":"v5/user/subuid-list","title":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868 (\u9650\u5236)","description":"\u6700\u591a\u8fd4\u56de10000\u500b\u5b50\u5e33\u6236, \u9069\u5408\u5c11\u65bc1\u842c\u500b\u5b50\u5e33\u6236\u7684\u6bcd\u5e33\u6236\u8abf\u7528\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/wallet-type":{"id":"v5/user/wallet-type","title":"\u67e5\u8a62\u5e33\u6236\u652f\u6301\u7684\u9322\u5305\u985e\u578b","description":"\u67e5\u8a62\u6bcd\u5e33\u6236\u6216\u8005\u5b50\u5e33\u6236\u4e0b\u652f\u6301\u7684\u9322\u5305\u985e\u578b","sidebar":"v5SideBar"},"v5/websocket/private/dcp":{"id":"v5/websocket/private/dcp","title":"\u65b7\u7dda\u4fdd\u8b77 (\u671f\u6b0a)","description":"\u901a\u904e\u8a02\u95b1DCP\u6d41\u4f86\u89f8\u767c\u529f\u80fd","sidebar":"v5SideBar"},"v5/websocket/private/execution":{"id":"v5/websocket/private/execution","title":"\u500b\u4eba\u6210\u4ea4","description":"\u8a02\u95b1\u500b\u4eba\u6210\u4ea4\u7684\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/private/fast-execution":{"id":"v5/websocket/private/fast-execution","title":"\u500b\u4eba\u6210\u4ea4 (Fast)","description":"\u7cbe\u7c21\u7248\u672c\u7684\u500b\u4eba\u6210\u4ea4\u63a8\u9001, \u76f8\u6bd4\u539f\u59cb\u7684\u5feb\u901f\u6210\u4ea4\u6d41, \u5ef6\u9072\u66f4\u52a0\u4f4e","sidebar":"v5SideBar"},"v5/websocket/private/greek":{"id":"v5/websocket/private/greek","title":"\u7528\u6236\u5e0c\u81d8\u5b57\u6bcd\u4fe1\u606f (\u671f\u6b0a)","description":"\u8a02\u95b1\u7528\u6236\u5e0c\u81d8\u5b57\u6bcd\u6578\u64da\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/private/order":{"id":"v5/websocket/private/order","title":"\u8a02\u55ae","description":"\u8a02\u95b1\u8a02\u55ae\u6578\u64da\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/private/position":{"id":"v5/websocket/private/position","title":"\u6301\u5009","description":"\u8a02\u95b1\u6301\u5009\u6578\u64da\u7684\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/private/wallet":{"id":"v5/websocket/private/wallet","title":"\u9322\u5305","description":"\u8a02\u95b1\u9322\u5305\u6578\u64da\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/public/etp-kline":{"id":"v5/websocket/public/etp-kline","title":"ETP\u6de8\u503cK\u7dda","description":"\u8a02\u95b1\u69d3\u687f\u4ee3\u5e63\u7684\u6de8\u503cK\u7dda\u884c\u60c5\u63a8\u9001\u670d\u52d9","sidebar":"v5SideBar"},"v5/websocket/public/etp-nav":{"id":"v5/websocket/public/etp-nav","title":"ETP\u6700\u65b0\u6de8\u503c\u63a8\u9001","description":"\u8a02\u95b1\u69d3\u687f\u4ee3\u5e63\u7684\u6700\u65b0\u6de8\u503c\u884c\u60c5\u6578\u64da","sidebar":"v5SideBar"},"v5/websocket/public/etp-ticker":{"id":"v5/websocket/public/etp-ticker","title":"ETP\u6de8\u503c\u884c\u60c5\u63a8\u9001","description":"\u8a02\u95b1\u69d3\u687f\u4ee3\u5e63\u6de8\u503c\u884c\u60c5\u6578\u64da","sidebar":"v5SideBar"},"v5/websocket/public/kline":{"id":"v5/websocket/public/kline","title":"K\u7dda","description":"\u8a02\u95b1K\u7dda\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/public/liquidation":{"id":"v5/websocket/public/liquidation","title":"\u5f37\u5e73\u63a8\u9001","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u7684\u5f37\u5e73\u63a8\u9001, symbol\u7ef4\u5ea6\u6700\u591a1\u79d2\u63a8\u4e00\u6761\u7206\u4ed3\u6570\u636e","sidebar":"v5SideBar"},"v5/websocket/public/orderbook":{"id":"v5/websocket/public/orderbook","title":"\u6df1\u5ea6","description":"\u8a02\u95b1\u4e0d\u540c\u6df1\u5ea6\u7684\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/public/ticker":{"id":"v5/websocket/public/ticker","title":"\u884c\u60c5","description":"\u8a02\u95b1\u884c\u60c5\u6578\u64da\u63a8\u9001.","sidebar":"v5SideBar"},"v5/websocket/public/trade":{"id":"v5/websocket/public/trade","title":"\u5e73\u53f0\u6210\u4ea4","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u6700\u8fd1\u6210\u4ea4\u7684\u63a8\u9001.","sidebar":"v5SideBar"},"v5/websocket/trade/guideline":{"id":"v5/websocket/trade/guideline","title":"Websocket\u4e0b\u55ae\u6307\u5357","description":"\u8def\u5f91","sidebar":"v5SideBar"},"v5/websocket/wss-authentication":{"id":"v5/websocket/wss-authentication","title":"\u8a02\u95b1WebSocket","description":"WebSocket\u516c\u5171\u983b\u9053:","sidebar":"v5SideBar"}}}')}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/935f2afb.f3a6bfb6.js b/zh-TW/assets/js/935f2afb.f3a6bfb6.js deleted file mode 100644 index 5be9c1bb66..0000000000 --- a/zh-TW/assets/js/935f2afb.f3a6bfb6.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[80053],{1109:e=>{e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"v3SideBar":[{"type":"link","label":"\u6982\u89bd","href":"/docs/zh-TW/v3/intro","docId":"v3/intro"},{"type":"link","label":"Bybit\u670d\u52d9\u5668\u6642\u9593","href":"/docs/zh-TW/v3/server-time","docId":"v3/server-time"},{"type":"link","label":"\u81ea\u6210\u4ea4\u6514\u622a","href":"/docs/zh-TW/v3/smp","docId":"v3/smp"},{"type":"category","label":"\u884d\u751f\u54c1","items":[{"type":"category","label":"REST\u63a5\u53e3","items":[{"type":"category","label":"\u5e02\u5834\u884c\u60c5","items":[{"type":"link","label":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/derivatives/public/kline","docId":"v3/derivatives/rest-public/kline"},{"type":"link","label":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/derivatives/public/mark-kline","docId":"v3/derivatives/rest-public/mark-kline"},{"type":"link","label":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/derivatives/public/index-kline","docId":"v3/derivatives/rest-public/index-kline"},{"type":"link","label":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/derivatives/public/premium-index-kline","docId":"v3/derivatives/rest-public/premium-index-kline"},{"type":"link","label":"Order Book (\u6df1\u5ea6)","href":"/docs/zh-TW/derivatives/public/orderbook","docId":"v3/derivatives/rest-public/orderbook"},{"type":"link","label":"\u67e5\u8a62\u6700\u65b0\u884c\u60c5\u4fe1\u606f","href":"/docs/zh-TW/derivatives/public/ticker","docId":"v3/derivatives/rest-public/ticker-info"},{"type":"link","label":"\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u898f\u683c\u4fe1\u606f","href":"/docs/zh-TW/derivatives/public/instrument-info","docId":"v3/derivatives/rest-public/instrument-info"},{"type":"link","label":"\u67e5\u8a62\u5e73\u53f0\u6210\u4ea4\u6b77\u53f2","href":"/docs/zh-TW/derivatives/public/trade","docId":"v3/derivatives/rest-public/public-trade"},{"type":"link","label":"\u67e5\u8a62\u5408\u7d04\u98a8\u96aa\u9650\u984d","href":"/docs/zh-TW/derivatives/public/risk-limit","docId":"v3/derivatives/rest-public/risk-limit"},{"type":"link","label":"\u67e5\u8a62\u6b77\u53f2\u8cc7\u91d1\u8cbb\u7387","href":"/docs/zh-TW/derivatives/public/funding-rate","docId":"v3/derivatives/rest-public/fund-rate-history"},{"type":"link","label":"\u67e5\u8a62\u672a\u5e73\u5009\u5408\u7d04\u6301\u5009\u6578\u91cf","href":"/docs/zh-TW/derivatives/public/open-interest","docId":"v3/derivatives/rest-public/open-interest"},{"type":"link","label":"\u67e5\u8a62\u671f\u6b0a\u4ea4\u5272\u50f9\u683c","href":"/docs/zh-TW/derivatives/public/option-delivery","docId":"v3/derivatives/rest-public/delivery-price"},{"type":"link","label":"\u67e5\u8a62\u591a\u7a7a\u6bd4","href":"/docs/zh-TW/derivatives/public/long-short-ratio","docId":"v3/derivatives/rest-public/long-short-ratio"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5408\u7d04","items":[{"type":"category","label":"\u4ea4\u6613","items":[{"type":"link","label":"\u5275\u5efa\u59d4\u8a17\u55ae","href":"/docs/zh-TW/derivatives/contract/place-order","docId":"v3/derivatives/rest-contract/order/place-order"},{"type":"link","label":"\u67e5\u8a62\u5be6\u6642\u59d4\u8a17\u55ae","href":"/docs/zh-TW/derivatives/contract/open-order","docId":"v3/derivatives/rest-contract/order/open-order"},{"type":"link","label":"\u4fee\u6539\u59d4\u8a17\u55ae","href":"/docs/zh-TW/derivatives/contract/replace-order","docId":"v3/derivatives/rest-contract/order/replace-order"},{"type":"link","label":"\u64a4\u92b7\u59d4\u8a17\u55ae","href":"/docs/zh-TW/derivatives/contract/cancel","docId":"v3/derivatives/rest-contract/order/cancel-order"},{"type":"link","label":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","href":"/docs/zh-TW/derivatives/contract/cancel-all","docId":"v3/derivatives/rest-contract/order/cancel-all"},{"type":"link","label":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae","href":"/docs/zh-TW/derivatives/contract/order-list","docId":"v3/derivatives/rest-contract/order/order-list"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u6301\u5009","items":[{"type":"link","label":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","href":"/docs/zh-TW/derivatives/contract/position-list","docId":"v3/derivatives/rest-contract/position/position-info"},{"type":"link","label":"\u8a2d\u7f6e\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1","href":"/docs/zh-TW/derivatives/contract/auto-margin","docId":"v3/derivatives/rest-contract/position/auto-margin"},{"type":"link","label":"\u5207\u63db\u5168\u5009/\u9010\u5009","href":"/docs/zh-TW/derivatives/contract/cross-isolated","docId":"v3/derivatives/rest-contract/position/cross-isolated-margin"},{"type":"link","label":"\u5207\u63db\u5009\u4f4d\u6a21\u5f0f","href":"/docs/zh-TW/derivatives/contract/position-mode","docId":"v3/derivatives/rest-contract/position/position-mode"},{"type":"link","label":"\u5207\u63db\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","href":"/docs/zh-TW/derivatives/contract/tpsl-mode","docId":"v3/derivatives/rest-contract/position/tpsl-mode"},{"type":"link","label":"\u8a2d\u7f6e\u69d3\u687f\u500d\u6578","href":"/docs/zh-TW/derivatives/contract/leverage","docId":"v3/derivatives/rest-contract/position/leverage"},{"type":"link","label":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","href":"/docs/zh-TW/derivatives/contract/trading-stop","docId":"v3/derivatives/rest-contract/position/trading-stop"},{"type":"link","label":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d (\u5ee2\u68c4)","href":"/docs/zh-TW/derivatives/contract/set-risk-limit","docId":"v3/derivatives/rest-contract/position/set-risk-limit"},{"type":"link","label":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304","href":"/docs/zh-TW/derivatives/contract/execution-list","docId":"v3/derivatives/rest-contract/position/execution"},{"type":"link","label":"\u67e5\u8a62\u5e73\u5009\u76c8\u8667","href":"/docs/zh-TW/derivatives/contract/closepnl","docId":"v3/derivatives/rest-contract/position/close-pnl"},{"type":"link","label":"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d","href":"/docs/zh-TW/derivatives/contract/confirm-mmr","docId":"v3/derivatives/rest-contract/position/confirm-mmr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5e33\u6236","items":[{"type":"link","label":"\u9322\u5305\u9918\u984d","href":"/docs/zh-TW/derivatives/contract/wallet","docId":"v3/derivatives/rest-contract/account/wallet-balance"},{"type":"link","label":"\u67e5\u8a62\u4ea4\u6613\u8cbb\u7387","href":"/docs/zh-TW/derivatives/contract/fee-rate","docId":"v3/derivatives/rest-contract/account/trading-fee"},{"type":"link","label":"\u67e5\u8a62\u9322\u5305\u8cc7\u91d1\u7d00\u9304","href":"/docs/zh-TW/derivatives/contract/wallet-fund","docId":"v3/derivatives/rest-contract/account/wallet-fund-record"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket\u63a8\u9001","items":[{"type":"link","label":"\u8a02\u95b1WebSocket","href":"/docs/zh-TW/derivatives/ws/connect","docId":"v3/derivatives/wss-authentication"},{"type":"category","label":"\u516c\u5171\u983b\u9053","items":[{"type":"link","label":"\u6df1\u5ea6","href":"/docs/zh-TW/derivatives/ws-public/orderbook","docId":"v3/derivatives/wss-public/orderbook"},{"type":"link","label":"\u5e73\u53f0\u6210\u4ea4","href":"/docs/zh-TW/derivatives/ws-public/trade","docId":"v3/derivatives/wss-public/trade"},{"type":"link","label":"\u884c\u60c5","href":"/docs/zh-TW/derivatives/ws-public/ticker","docId":"v3/derivatives/wss-public/tickers"},{"type":"link","label":"K\u7dda","href":"/docs/zh-TW/derivatives/ws-public/kline","docId":"v3/derivatives/wss-public/kline"},{"type":"link","label":"\u5f37\u5e73\u63a8\u9001","href":"/docs/zh-TW/derivatives/ws-public/liquidation","docId":"v3/derivatives/wss-public/liquidation"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u79c1\u6709\u983b\u9053(\u5408\u7d04)","items":[{"type":"link","label":"\u6301\u5009","href":"/docs/zh-TW/derivatives/ws-contract/position","docId":"v3/derivatives/wss-contract/position"},{"type":"link","label":"\u500b\u4eba\u6210\u4ea4","href":"/docs/zh-TW/derivatives/ws-contract/execution","docId":"v3/derivatives/wss-contract/execution"},{"type":"link","label":"\u8a02\u55ae","href":"/docs/zh-TW/derivatives/ws-contract/order","docId":"v3/derivatives/wss-contract/order"},{"type":"link","label":"\u9322\u5305","href":"/docs/zh-TW/derivatives/ws-contract/wallet","docId":"v3/derivatives/wss-contract/wallet"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"\u983b\u7387\u9650\u5236","href":"/docs/zh-TW/derivatives/rate-limit","docId":"v3/derivatives/rate-limit"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/derivatives/enum","docId":"v3/derivatives/enum"},{"type":"link","label":"\u932f\u8aa4\u78bc","href":"/docs/zh-TW/derivatives/error","docId":"v3/derivatives/error"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/category/derivatives"},{"type":"category","label":"\u73fe\u8ca8","items":[{"type":"category","label":"REST\u63a5\u53e3","items":[{"type":"category","label":"\u5e02\u5834\u884c\u60c5","items":[{"type":"link","label":"\u67e5\u8a62\u6240\u6709\u4ea4\u6613\u5c0d","href":"/docs/zh-TW/spot/public/instrument","docId":"v3/spot/rest-public/instrument-info"},{"type":"link","label":"\u8a02\u55ae\u7c3f","href":"/docs/zh-TW/spot/public/depth","docId":"v3/spot/rest-public/orderbook"},{"type":"link","label":"\u5408\u4e26\u8a02\u55ae\u7c3f","href":"/docs/zh-TW/spot/public/merge-depth","docId":"v3/spot/rest-public/merge-orderbook"},{"type":"link","label":"\u67e5\u8a62K\u7dda\u6578\u64da","href":"/docs/zh-TW/spot/public/kline","docId":"v3/spot/rest-public/kline"},{"type":"link","label":"\u5e73\u81fa\u4ea4\u6613\u6b77\u53f2\u6578\u64da","href":"/docs/zh-TW/spot/public/recent-trade","docId":"v3/spot/rest-public/public-trade"},{"type":"link","label":"\u6700\u4f73\u8cb7\u8ce3\u50f9","href":"/docs/zh-TW/spot/public/bid-ask","docId":"v3/spot/rest-public/best-bid-ask"},{"type":"link","label":"Symbol\u6700\u65b0\u50f9","href":"/docs/zh-TW/spot/public/last-price","docId":"v3/spot/rest-public/last-trade-price"},{"type":"link","label":"\u6700\u65b0\u4fe1\u606f","href":"/docs/zh-TW/spot/public/tickers","docId":"v3/spot/rest-public/ticker-info"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u4ea4\u6613","items":[{"type":"link","label":"\u5275\u5efa\u6d3b\u52d5\u59d4\u6258\u55ae","href":"/docs/zh-TW/spot/trade/place-order","docId":"v3/spot/rest-spot/place-order"},{"type":"link","label":"\u67e5\u8a62\u6d3b\u52d5\u59d4\u6258","href":"/docs/zh-TW/spot/trade/get-order","docId":"v3/spot/rest-spot/get-order"},{"type":"link","label":"\u64a4\u92b7\u6d3b\u52d5\u59d4\u6258\u55ae","href":"/docs/zh-TW/spot/trade/cancel","docId":"v3/spot/rest-spot/cancel-order"},{"type":"link","label":"\u8a02\u55ae\u5217\u8868","href":"/docs/zh-TW/spot/trade/open-order","docId":"v3/spot/rest-spot/open-order"},{"type":"link","label":"\u6279\u91cf\u64a4\u92b7\u8a02\u55ae","href":"/docs/zh-TW/spot/trade/batch-cancel","docId":"v3/spot/rest-spot/batch-cancel"},{"type":"link","label":"\u6839\u64da\u8a02\u55ae\u865f\u6279\u91cf\u64a4\u92b7\u8a02\u55ae","href":"/docs/zh-TW/spot/trade/cancel-by-id","docId":"v3/spot/rest-spot/batch-cancel-by-id"},{"type":"link","label":"\u6b77\u53f2\u8a02\u55ae","href":"/docs/zh-TW/spot/trade/order-history","docId":"v3/spot/rest-spot/order-history"},{"type":"link","label":"\u4ea4\u6613\u8a18\u9304","href":"/docs/zh-TW/spot/trade/my-trades","docId":"v3/spot/rest-spot/trade-history"}],"collapsed":true,"collapsible":true},{"type":"link","label":"\u67e5\u8a62\u9322\u5305\u4f59\u984d","href":"/docs/zh-TW/spot/wallet","docId":"v3/spot/wallet"},{"type":"category","label":"\u69d3\u687f\u4ee3\u5e63","items":[{"type":"link","label":"LT \u5168\u91cf\u8cc7\u7522\u57fa\u790e\u4fe1\u606f\u67e5\u8a62","href":"/docs/zh-TW/spot/etp/asset-info","docId":"v3/spot/rest-etp/asset-info"},{"type":"link","label":"LT \u884c\u60c5\u67e5\u8a62","href":"/docs/zh-TW/spot/etp/market-info","docId":"v3/spot/rest-etp/market-info"},{"type":"link","label":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","href":"/docs/zh-TW/spot/etp/order-history","docId":"v3/spot/rest-etp/purchase-redeem-history"},{"type":"link","label":"\u7533\u8cfc","href":"/docs/zh-TW/spot/etp/purchase","docId":"v3/spot/rest-etp/purchase"},{"type":"link","label":"\u8d16\u56de","href":"/docs/zh-TW/spot/etp/redeem","docId":"v3/spot/rest-etp/redeem"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5168\u5009\u69d3\u687f","items":[{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u5e33\u6236\u4fe1\u606f","href":"/docs/zh-TW/spot/margin/account","docId":"v3/spot/rest-spot-margin/account-info"},{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae","href":"/docs/zh-TW/spot/margin/borrow-history","docId":"v3/spot/rest-spot-margin/borrow-info"},{"type":"link","label":"\u501f\u6b3e","href":"/docs/zh-TW/spot/margin/borrow","docId":"v3/spot/rest-spot-margin/borrow"},{"type":"link","label":"\u67e5\u8a62\u53ef\u501f\u5e63\u7a2e\u7cbe\u5ea6","href":"/docs/zh-TW/spot/margin/borrowable-coin","docId":"v3/spot/rest-spot-margin/borrowable-data"},{"type":"link","label":"\u67e5\u8a62\u5229\u7387\u53ca\u984d\u5ea6","href":"/docs/zh-TW/spot/margin/interest","docId":"v3/spot/rest-spot-margin/interest-quota"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/spot/margin/margin-data","docId":"v3/spot/rest-spot-margin/margin-data"},{"type":"link","label":"\u67e5\u8a62\u9084\u6b3e\u8a02\u55ae\u4fe1\u606f","href":"/docs/zh-TW/spot/margin/repay-history","docId":"v3/spot/rest-spot-margin/repay-history"},{"type":"link","label":"\u9084\u6b3e","href":"/docs/zh-TW/spot/margin/repay","docId":"v3/spot/rest-spot-margin/repay"},{"type":"link","label":"\u5168\u5009\u69d3\u687f\u958b\u95dc","href":"/docs/zh-TW/spot/margin/toggle","docId":"v3/spot/rest-spot-margin/switch-mode"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u6a5f\u69cb\u501f\u8cb8","items":[{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u7522\u54c1\u4fe1\u606f","href":"/docs/zh-TW/spot/otc/product-info","docId":"v3/spot/rest-institution-loan/margin-product-info"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/spot/otc/coin-info","docId":"v3/spot/rest-institution-loan/margin-coin-info"},{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u4fe1\u606f","href":"/docs/zh-TW/spot/otc/loan-info","docId":"v3/spot/rest-institution-loan/loan-info"},{"type":"link","label":"\u67e5\u8a62\u9084\u6b3e\u4fe1\u606f","href":"/docs/zh-TW/spot/otc/repay-info","docId":"v3/spot/rest-institution-loan/repay-info"},{"type":"link","label":"\u67e5\u8a62\u98a8\u96aa\u7387","href":"/docs/zh-TW/spot/otc/ltv","docId":"v3/spot/rest-institution-loan/ltv"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket\u63a8\u9001","items":[{"type":"link","label":"\u8a02\u95b1WebSocket","href":"/docs/zh-TW/spot/ws/connect","docId":"v3/spot/wss-authentication"},{"type":"category","label":"\u516c\u5171\u983b\u9053","items":[{"type":"link","label":"\u6df1\u5ea6","href":"/docs/zh-TW/spot/ws-public/orderbook","docId":"v3/spot/wss-public/orderbook"},{"type":"link","label":"K\u7dda","href":"/docs/zh-TW/spot/ws-public/kline","docId":"v3/spot/wss-public/kline"},{"type":"link","label":"\u884c\u60c5","href":"/docs/zh-TW/spot/ws-public/ticker","docId":"v3/spot/wss-public/tickers"},{"type":"link","label":"\u8cb7\u4e00\u8ce3\u4e00","href":"/docs/zh-TW/spot/ws-public/bookticker","docId":"v3/spot/wss-public/bookticker"},{"type":"link","label":"\u5e73\u81fa\u6210\u4ea4","href":"/docs/zh-TW/spot/ws-public/public-trade","docId":"v3/spot/wss-public/trade"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u79c1\u6709\u983b\u9053","items":[{"type":"link","label":"\u8a02\u55ae","href":"/docs/zh-TW/spot/ws-private/order","docId":"v3/spot/wss-private/order"},{"type":"link","label":"\u6b62\u76c8\u6b62\u640d\u8a02\u55ae","href":"/docs/zh-TW/spot/ws-private/stop-order","docId":"v3/spot/wss-private/stop-order"},{"type":"link","label":"\u500b\u4eba\u6210\u4ea4","href":"/docs/zh-TW/spot/ws-private/execution","docId":"v3/spot/wss-private/ticket-info"},{"type":"link","label":"\u9322\u5305","href":"/docs/zh-TW/spot/ws-private/wallet","docId":"v3/spot/wss-private/outbound-account-info"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"\u983b\u7387\u9650\u5236","href":"/docs/zh-TW/spot/rate-limit","docId":"v3/spot/rate-limit"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/spot/enum","docId":"v3/spot/enum"},{"type":"link","label":"\u932f\u8aa4\u78bc","href":"/docs/zh-TW/spot/error","docId":"v3/spot/error"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/category/spot"},{"type":"category","label":"\u5e33\u6236\u8cc7\u7522","collapsed":true,"items":[{"type":"category","label":"\u5283\u8f49\u76f8\u95dc\u63a5\u53e3","collapsed":true,"items":[{"type":"link","label":"\u5283\u8f49(\u55ae\u5e33\u865f\u5167)","href":"/docs/zh-TW/account-asset/internal-transfer","docId":"v3/account-asset/transfer/internal-transfer"},{"type":"link","label":"\u67e5\u8a62\u5283\u8f49\u8a18\u9304(\u55ae\u5e33\u865f\u5167)","href":"/docs/zh-TW/account-asset/internal-transfer-list","docId":"v3/account-asset/transfer/internal-transfer-list"},{"type":"link","label":"\u5b50\u6bcd\u5283\u8f49","href":"/docs/zh-TW/account-asset/sub-transfer","docId":"v3/account-asset/transfer/subacct-transfer"},{"type":"link","label":"\u67e5\u8a62\u5b50\u6bcd\u9593\u5283\u8f49\u8a18\u9304","href":"/docs/zh-TW/account-asset/sub-transfer-list","docId":"v3/account-asset/transfer/subacct-transfer-list"},{"type":"link","label":"\u67e5\u8a62\u5b50\u8cec\u865f\u5217\u8868","href":"/docs/zh-TW/account-asset/sub-uid-list","docId":"v3/account-asset/transfer/subacct-list"},{"type":"link","label":"\u914d\u7f6e\u53ef\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u8cec\u865f (\u5ee2\u68c4)","href":"/docs/zh-TW/account-asset/enable-unitransfer","docId":"v3/account-asset/transfer/enable-uni-transfer"},{"type":"link","label":"\u842c\u80fd\u5283\u8f49","href":"/docs/zh-TW/account-asset/uni-transfer","docId":"v3/account-asset/transfer/uni-transfer"},{"type":"link","label":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u8a18\u9304","href":"/docs/zh-TW/account-asset/uni-transfer-list","docId":"v3/account-asset/transfer/uni-transfer-list"},{"type":"link","label":"\u8cec\u865f\u5167\u53ef\u5283\u8f49\u5e63\u7a2e\u5217\u8868","href":"/docs/zh-TW/account-asset/transferable-coin-list","docId":"v3/account-asset/transfer/transferable-coin-list"},{"type":"link","label":"\u67e5\u8a62\u8cec\u6236\u55ae\u500b\u5e63\u7a2e\u4f59\u984d","href":"/docs/zh-TW/account-asset/coin-balance","docId":"v3/account-asset/transfer/coin-balance"},{"type":"link","label":"\u67e5\u8a62\u8cec\u6236\u6240\u6709\u5e63\u7a2e\u4f59\u984d","href":"/docs/zh-TW/account-asset/all-balance","docId":"v3/account-asset/transfer/all-balance"},{"type":"link","label":"\u67e5\u8a62\u8cc7\u7522\u4fe1\u606f (\u73fe\u8ca8)","href":"/docs/zh-TW/account-asset/asset-info","docId":"v3/account-asset/transfer/asset-info"}],"collapsible":true},{"type":"category","label":"\u63d0\u73fe\u8207\u5145\u503c\u76f8\u95dc\u63a5\u53e3","collapsed":true,"items":[{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u76f8\u95dc\u7684\u898f\u683c","href":"/docs/zh-TW/account-asset/deposit-spec","docId":"v3/account-asset/withdraw-deposit/deposit-spec"},{"type":"link","label":"\u8a2d\u7f6e\u5145\u503c\u5e33\u6236","href":"/docs/zh-TW/account-asset/set-deposit-acct","docId":"v3/account-asset/withdraw-deposit/set-deposit-acct"},{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u93c8\u4e0a)","href":"/docs/zh-TW/account-asset/deposit-record","docId":"v3/account-asset/withdraw-deposit/master-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236\u5145\u503c (\u93c8\u4e0a)","href":"/docs/zh-TW/account-asset/sub-deposit-record","docId":"v3/account-asset/withdraw-deposit/sub-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u5e73\u53f0\u8f6c\u8d26)","href":"/docs/zh-TW/account-asset/internal-deposit-record","docId":"v3/account-asset/withdraw-deposit/internal-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u63d0\u73fe\u8a18\u9304","href":"/docs/zh-TW/account-asset/withdraw-record","docId":"v3/account-asset/withdraw-deposit/withdraw-record"},{"type":"link","label":"\u67e5\u8a62\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/account-asset/coin-info","docId":"v3/account-asset/withdraw-deposit/coin-info"},{"type":"link","label":"\u67e5\u8a62\u5ef6\u9072\u63d0\u5e63\u51cd\u7d50\u91d1\u984d","href":"/docs/zh-TW/account-asset/delay-amount","docId":"v3/account-asset/withdraw-deposit/deplay-amount"},{"type":"link","label":"\u67e5\u8a62\u4ea4\u6613\u6240\u5217\u8868 (\u97d3\u570b\u7528\u6236)","href":"/docs/zh-TW/account-asset/vasp-list","docId":"v3/account-asset/withdraw-deposit/vasp-list"},{"type":"link","label":"\u63d0\u73fe","href":"/docs/zh-TW/account-asset/withdraw","docId":"v3/account-asset/withdraw-deposit/withdraw"},{"type":"link","label":"\u64a4\u92b7\u63d0\u5e63","href":"/docs/zh-TW/account-asset/cancel-withdraw","docId":"v3/account-asset/withdraw-deposit/cancel-withdraw"},{"type":"link","label":"\u67e5\u8a62\u4e3b\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f","href":"/docs/zh-TW/account-asset/master-deposit-addr","docId":"v3/account-asset/withdraw-deposit/master-deposit-addr"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f","href":"/docs/zh-TW/account-asset/sub-deposit-addr","docId":"v3/account-asset/withdraw-deposit/sub-deposit-addr"}],"collapsible":true},{"type":"category","label":"\u6bcd\u5b50\u5e33\u6236\u76f8\u95dc\u63a5\u53e3","collapsed":true,"items":[{"type":"link","label":"\u65b0\u5efa\u5b50\u5e33\u6236","href":"/docs/zh-TW/account-asset/create-subuid","docId":"v3/account-asset/user/create-subuid"},{"type":"link","label":"\u65b0\u5efa\u5b50\u5e33\u6236\u7684API Key","href":"/docs/zh-TW/account-asset/create-subuid-apikey","docId":"v3/account-asset/user/create-subuid-apikey"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868","href":"/docs/zh-TW/account-asset/subuid-list","docId":"v3/account-asset/user/subuid-list"},{"type":"link","label":"\u51cd\u7d50/\u89e3\u51cd\u5b50\u5e33\u6236","href":"/docs/zh-TW/account-asset/froze-subuid","docId":"v3/account-asset/user/froze-subuid"},{"type":"link","label":"\u67e5\u8a62API Key\u76f8\u95dc\u4fe1\u606f","href":"/docs/zh-TW/account-asset/apikey-info","docId":"v3/account-asset/user/apikey-info"},{"type":"link","label":"\u67e5\u8a62\u5e33\u6236\u652f\u6301\u7684\u9322\u5305\u985e\u578b","href":"/docs/zh-TW/account-asset/wallet-type","docId":"v3/account-asset/user/wallet-type"},{"type":"link","label":"\u4fee\u6539\u6bcd\u5e33\u6236\u7684API Key\u8a2d\u7f6e","href":"/docs/zh-TW/account-asset/modify-master-apikey","docId":"v3/account-asset/user/modify-master-apikey"},{"type":"link","label":"\u4fee\u6539\u5b50\u5e33\u6236\u7684API Key\u8a2d\u7f6e","href":"/docs/zh-TW/account-asset/modify-sub-apikey","docId":"v3/account-asset/user/modify-sub-apikey"},{"type":"link","label":"\u522a\u9664\u6bcd\u5e33\u6236\u7684API Key","href":"/docs/zh-TW/account-asset/rm-master-apikey","docId":"v3/account-asset/user/rm-master-apikey"},{"type":"link","label":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684API Key","href":"/docs/zh-TW/account-asset/rm-sub-apikey","docId":"v3/account-asset/user/rm-sub-apikey"}],"collapsible":true},{"type":"link","label":"\u983b\u7387\u9650\u5236","href":"/docs/zh-TW/account-asset/rate-limit","docId":"v3/account-asset/rate-limit"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/account-asset/enum","docId":"v3/account-asset/enum"},{"type":"link","label":"\u932f\u8aa4\u78bc","href":"/docs/zh-TW/account-asset/error","docId":"v3/account-asset/error"}],"collapsible":true},{"type":"category","label":"\u7a05\u52d9","items":[{"type":"link","label":"\u67e5\u8a62\u7279\u5b9a\u7528\u6236\u5728\u5e73\u53f0\u8a3b\u518a\u65e5\u671f","href":"/docs/zh-TW/tax/time","docId":"v3/tax/register-time"},{"type":"link","label":"\u5275\u5efa\u5c0e\u51fa\u5831\u544a\u8acb\u6c42","href":"/docs/zh-TW/tax/report","docId":"v3/tax/request-report"},{"type":"link","label":"\u67e5\u8a62\u5831\u544a\u5c0e\u51fa\u72c0\u614b","href":"/docs/zh-TW/tax/status","docId":"v3/tax/report-status"},{"type":"link","label":"\u6578\u64da\u5c0e\u51fa","href":"/docs/zh-TW/tax/data-export","docId":"v3/tax/data-export"},{"type":"link","label":"\u6578\u64da\u8aaa\u660e","href":"/docs/zh-TW/tax/explain","docId":"v3/tax/data-explain"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/tax/enum","docId":"v3/tax/enum"}],"collapsed":true,"collapsible":true}],"v5SideBar":[{"type":"link","label":"\u6982\u89bd","href":"/docs/zh-TW/v5/intro","docId":"v5/intro"},{"type":"link","label":"\u63a5\u5165\u6307\u5357","href":"/docs/zh-TW/v5/guide","docId":"v5/guide"},{"type":"link","label":"\u67e5\u8a62\u516c\u544a","href":"/docs/zh-TW/v5/announcement","docId":"v5/announcement"},{"type":"link","label":"\u81ea\u6210\u4ea4\u6514\u622a","href":"/docs/zh-TW/v5/smp","docId":"v5/smp"},{"type":"link","label":"\u5982\u4f55\u4f7f\u7528API\u5e36\u55ae","href":"/docs/zh-TW/v5/copytrade","docId":"v5/copytrade"},{"type":"link","label":"\u6a21\u64ec\u4ea4\u6613","href":"/docs/zh-TW/v5/demo","docId":"v5/demo"},{"type":"category","label":"\u516c\u6709\u884c\u60c5","items":[{"type":"link","label":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/v5/market/kline","docId":"v5/market/kline"},{"type":"link","label":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/v5/market/mark-kline","docId":"v5/market/mark-kline"},{"type":"link","label":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/v5/market/index-kline","docId":"v5/market/index-kline"},{"type":"link","label":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","href":"/docs/zh-TW/v5/market/preimum-index-kline","docId":"v5/market/preimum-index-kline"},{"type":"link","label":"\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u898f\u683c\u4fe1\u606f","href":"/docs/zh-TW/v5/market/instrument","docId":"v5/market/instrument"},{"type":"link","label":"Order Book (\u6df1\u5ea6)","href":"/docs/zh-TW/v5/market/orderbook","docId":"v5/market/orderbook"},{"type":"link","label":"\u67e5\u8a62\u6700\u65b0\u884c\u60c5\u4fe1\u606f","href":"/docs/zh-TW/v5/market/tickers","docId":"v5/market/tickers"},{"type":"link","label":"\u67e5\u8a62\u6b77\u53f2\u8cc7\u91d1\u8cbb\u7387","href":"/docs/zh-TW/v5/market/history-fund-rate","docId":"v5/market/history-fund-rate"},{"type":"link","label":"\u67e5\u8a62\u5e73\u53f0\u6700\u8fd1\u6210\u4ea4\u6b77\u53f2","href":"/docs/zh-TW/v5/market/recent-trade","docId":"v5/market/recent-trade"},{"type":"link","label":"\u67e5\u8a62\u672a\u5e73\u5009\u5408\u7d04\u6301\u5009\u6578\u91cf","href":"/docs/zh-TW/v5/market/open-interest","docId":"v5/market/open-interest"},{"type":"link","label":"\u67e5\u8a62\u671f\u6b0a\u6ce2\u52d5\u7387","href":"/docs/zh-TW/v5/market/iv","docId":"v5/market/iv"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u96aa\u57fa\u91d1","href":"/docs/zh-TW/v5/market/insurance","docId":"v5/market/insurance"},{"type":"link","label":"\u67e5\u8a62\u5408\u7d04\u98a8\u96aa\u9650\u984d","href":"/docs/zh-TW/v5/market/risk-limit","docId":"v5/market/risk-limit"},{"type":"link","label":"\u67e5\u8a62\u4ea4\u5272\u50f9\u683c","href":"/docs/zh-TW/v5/market/delivery-price","docId":"v5/market/delivery-price"},{"type":"link","label":"\u67e5\u8a62\u591a\u7a7a\u6bd4","href":"/docs/zh-TW/v5/market/long-short-ratio","docId":"v5/market/long-short-ratio"},{"type":"link","label":"Bybit\u670d\u52d9\u5668\u6642\u9593","href":"/docs/zh-TW/v5/market/time","docId":"v5/market/time"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u4ea4\u6613","items":[{"type":"link","label":"\u5275\u5efa\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/create-order","docId":"v5/order/create-order"},{"type":"link","label":"\u4fee\u6539\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/amend-order","docId":"v5/order/amend-order"},{"type":"link","label":"\u64a4\u92b7\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/cancel-order","docId":"v5/order/cancel-order"},{"type":"link","label":"\u67e5\u8a62\u5be6\u6642\u548c\u7d42\u614b\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/open-order","docId":"v5/order/open-order"},{"type":"link","label":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","href":"/docs/zh-TW/v5/order/cancel-all","docId":"v5/order/cancel-all"},{"type":"link","label":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae (2\u5e74)","href":"/docs/zh-TW/v5/order/order-list","docId":"v5/order/order-list"},{"type":"link","label":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304 (2\u5e74)","href":"/docs/zh-TW/v5/order/execution","docId":"v5/order/execution"},{"type":"link","label":"\u6279\u91cf\u5275\u5efa\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/batch-place","docId":"v5/order/batch-place"},{"type":"link","label":"\u6279\u91cf\u4fee\u6539\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/batch-amend","docId":"v5/order/batch-amend"},{"type":"link","label":"\u6279\u91cf\u64a4\u92b7\u59d4\u8a17\u55ae","href":"/docs/zh-TW/v5/order/batch-cancel","docId":"v5/order/batch-cancel"},{"type":"link","label":"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)","href":"/docs/zh-TW/v5/order/spot-borrow-quota","docId":"v5/order/spot-borrow-quota"},{"type":"link","label":"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593 (\u671f\u6b0a)","href":"/docs/zh-TW/v5/order/dcp","docId":"v5/order/dcp"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u6301\u5009","items":[{"type":"link","label":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","href":"/docs/zh-TW/v5/position/","docId":"v5/position/position"},{"type":"link","label":"\u8a2d\u7f6e\u69d3\u687f","href":"/docs/zh-TW/v5/position/leverage","docId":"v5/position/leverage"},{"type":"link","label":"\u5207\u63db\u5168\u5009/\u9010\u5009\u4fdd\u8b49\u91d1(\u4ea4\u6613\u5c0d)","href":"/docs/zh-TW/v5/position/cross-isolate","docId":"v5/position/cross-isolate"},{"type":"link","label":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","href":"/docs/zh-TW/v5/position/tpsl-mode","docId":"v5/position/tpsl-mode"},{"type":"link","label":"\u5207\u63db\u6301\u5009\u6a21\u5f0f","href":"/docs/zh-TW/v5/position/position-mode","docId":"v5/position/position-mode"},{"type":"link","label":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d (\u5ee2\u68c4)","href":"/docs/zh-TW/v5/position/set-risk-limit","docId":"v5/position/set-risk-limit"},{"type":"link","label":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","href":"/docs/zh-TW/v5/position/trading-stop","docId":"v5/position/trading-stop"},{"type":"link","label":"\u8a2d\u7f6e\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1","href":"/docs/zh-TW/v5/position/auto-add-margin","docId":"v5/position/auto-add-margin"},{"type":"link","label":"\u624b\u52d5\u589e\u52a0\u6216\u6e1b\u5c11\u4fdd\u8b49\u91d1","href":"/docs/zh-TW/v5/position/manual-add-margin","docId":"v5/position/manual-add-margin"},{"type":"link","label":"\u67e5\u8a62\u5e73\u5009\u76c8\u8667","href":"/docs/zh-TW/v5/position/close-pnl","docId":"v5/position/close-pnl"},{"type":"link","label":"\u79fb\u5009","href":"/docs/zh-TW/v5/position/move-position","docId":"v5/position/move-position"},{"type":"link","label":"\u67e5\u8a62\u79fb\u5009\u6b77\u53f2","href":"/docs/zh-TW/v5/position/move-position-history","docId":"v5/position/move-position-history"},{"type":"link","label":"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d","href":"/docs/zh-TW/v5/position/confirm-mmr","docId":"v5/position/confirm-mmr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5347\u7d1a\u524d\u76f8\u95dc\u7d00\u9304","items":[{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u8a02\u55ae\u7d00\u9304","href":"/docs/zh-TW/v5/pre-upgrade/order-list","docId":"v5/pre-upgrade/order-list"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u6210\u4ea4\u7d00\u9304","href":"/docs/zh-TW/v5/pre-upgrade/execution","docId":"v5/pre-upgrade/execution"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u5e73\u5009\u76c8\u8667","href":"/docs/zh-TW/v5/pre-upgrade/close-pnl","docId":"v5/pre-upgrade/close-pnl"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u4ea4\u6613\u65e5\u8a8c","href":"/docs/zh-TW/v5/pre-upgrade/transaction-log","docId":"v5/pre-upgrade/transaction-log"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524d\u671f\u6b0a\u4ea4\u5272\u7d00\u9304","href":"/docs/zh-TW/v5/pre-upgrade/delivery","docId":"v5/pre-upgrade/delivery"},{"type":"link","label":"\u67e5\u8a62\u5347\u7d1a\u524dUSDC\u7d50\u7b97\u7d00\u9304","href":"/docs/zh-TW/v5/pre-upgrade/settlement","docId":"v5/pre-upgrade/settlement"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5e33\u6236","items":[{"type":"link","label":"\u67e5\u8a62\u9322\u5305\u9918\u984d","href":"/docs/zh-TW/v5/account/wallet-balance","docId":"v5/account/wallet-balance"},{"type":"link","label":"\u5347\u7d1a\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236","href":"/docs/zh-TW/v5/account/upgrade-unified-account","docId":"v5/account/upgrade-unified-account"},{"type":"link","label":"\u67e5\u8a62\u5229\u606f\u8a18\u9304 (2\u5e74)","href":"/docs/zh-TW/v5/account/borrow-history","docId":"v5/account/borrow-history"},{"type":"link","label":"\u4e00\u9375\u9084\u6b3e","href":"/docs/zh-TW/v5/account/repay-liability","docId":"v5/account/repay-liability"},{"type":"link","label":"\u8a2d\u7f6e\u62b5\u62bc\u54c1\u5e63\u7a2e","href":"/docs/zh-TW/v5/account/set-collateral","docId":"v5/account/set-collateral"},{"type":"link","label":"\u6279\u91cf\u8a2d\u7f6e\u62b5\u62bc\u54c1\u5e63\u7a2e","href":"/docs/zh-TW/v5/account/batch-set-collateral","docId":"v5/account/batch-set-collateral"},{"type":"link","label":"\u67e5\u8a62\u62b5\u62bc\u54c1\u4fe1\u606f","href":"/docs/zh-TW/v5/account/collateral-info","docId":"v5/account/collateral-info"},{"type":"link","label":"\u67e5\u8a62Greeks\u4fe1\u606f","href":"/docs/zh-TW/v5/account/coin-greeks","docId":"v5/account/coin-greeks"},{"type":"link","label":"\u67e5\u8a62\u624b\u7e8c\u8cbb\u7387","href":"/docs/zh-TW/v5/account/fee-rate","docId":"v5/account/fee-rate"},{"type":"link","label":"\u67e5\u8a62\u8cec\u6236\u914d\u7f6e","href":"/docs/zh-TW/v5/account/account-info","docId":"v5/account/account-info"},{"type":"link","label":"\u67e5\u8a62DCP\u914d\u7f6e","href":"/docs/zh-TW/v5/account/dcp-info","docId":"v5/account/dcp-info"},{"type":"link","label":"\u4ea4\u6613\u65e5\u8a8c (\u7d71\u4e00\u5e33\u6236)","href":"/docs/zh-TW/v5/account/transaction-log","docId":"v5/account/transaction-log"},{"type":"link","label":"\u4ea4\u6613\u65e5\u8a8c (\u7d93\u5178\u5e33\u6236)","href":"/docs/zh-TW/v5/account/contract-transaction-log","docId":"v5/account/contract-transaction-log"},{"type":"link","label":"\u67e5\u8a62SMP\u7d44ID","href":"/docs/zh-TW/v5/account/smp-group","docId":"v5/account/smp-group"},{"type":"link","label":"\u8a2d\u7f6e\u4fdd\u8b49\u91d1\u6a21\u5f0f(\u5e33\u6236)","href":"/docs/zh-TW/v5/account/set-margin-mode","docId":"v5/account/set-margin-mode"},{"type":"link","label":"\u8a2d\u7f6e\u73fe\u8ca8\u5c0d\u885d","href":"/docs/zh-TW/v5/account/set-spot-hedge","docId":"v5/account/set-spot-hedge"},{"type":"link","label":"\u8bbe\u7f6e\u5e02\u5546\u4fdd\u8b77","href":"/docs/zh-TW/v5/account/set-mmp","docId":"v5/account/set-mmp"},{"type":"link","label":"\u91cd\u7f6e\u5e02\u5546\u4fdd\u8b77\u51cd\u7d50","href":"/docs/zh-TW/v5/account/reset-mmp","docId":"v5/account/reset-mmp"},{"type":"link","label":"\u67e5\u8a62\u5e02\u5546\u4fdd\u8b77\u914d\u7f6e\u4fe1\u606f","href":"/docs/zh-TW/v5/account/get-mmp-state","docId":"v5/account/get-mmp-state"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u8cc7\u7522","items":[{"type":"link","label":"\u67e5\u8a62\u4ea4\u5272\u7d00\u9304 (2\u5e74)","href":"/docs/zh-TW/v5/asset/delivery","docId":"v5/asset/delivery"},{"type":"link","label":"\u67e5\u8a62USDC\u7d50\u7b97\u7d00\u9304 (2\u5e74)","href":"/docs/zh-TW/v5/asset/settlement","docId":"v5/asset/settlement"},{"type":"link","label":"\u67e5\u8a62\u514c\u63db\u8a02\u55ae\u7d00\u9304","href":"/docs/zh-TW/v5/asset/exchange","docId":"v5/asset/exchange"},{"type":"link","label":"\u67e5\u8a62\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/asset/coin-info","docId":"v5/asset/coin-info"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u865f\u5217\u8868","href":"/docs/zh-TW/v5/asset/sub-uid-list","docId":"v5/asset/sub-uid-list"},{"type":"category","label":"\u9918\u984d","items":[{"type":"link","label":"\u67e5\u8a62\u8cc7\u7522\u4fe1\u606f (\u73fe\u8ca8)","href":"/docs/zh-TW/v5/asset/balance/asset-info","docId":"v5/asset/balance/asset-info"},{"type":"link","label":"\u67e5\u8a62\u8cec\u6236\u6240\u6709\u5e63\u7a2e\u4f59\u984d","href":"/docs/zh-TW/v5/asset/balance/all-balance","docId":"v5/asset/balance/all-balance"},{"type":"link","label":"\u67e5\u8a62\u5e33\u6236\u55ae\u500b\u5e63\u7a2e\u9918\u984d","href":"/docs/zh-TW/v5/asset/balance/account-coin-balance","docId":"v5/asset/balance/account-coin-balance"},{"type":"link","label":"\u67e5\u8a62\u5ef6\u9072\u63d0\u5e63\u51cd\u7d50\u91d1\u984d","href":"/docs/zh-TW/v5/asset/balance/delay-amount","docId":"v5/asset/balance/delay-amount"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5283\u8f49","items":[{"type":"link","label":"\u67e5\u8a62\u5283\u8f49\u7d00\u9304 (\u55ae\u5e33\u865f\u5167)","href":"/docs/zh-TW/v5/asset/transfer/inter-transfer-list","docId":"v5/asset/transfer/inter-transfer-list"},{"type":"link","label":"\u5e33\u6236\u985e\u578b\u9593\u53ef\u5283\u8f49\u7684\u5e63\u7a2e","href":"/docs/zh-TW/v5/asset/transfer/transferable-coin","docId":"v5/asset/transfer/transferable-coin"},{"type":"link","label":"\u5283\u8f49 (\u55ae\u5e33\u865f\u5167)","href":"/docs/zh-TW/v5/asset/transfer/create-inter-transfer","docId":"v5/asset/transfer/create-inter-transfer"},{"type":"link","label":"\u5275\u5efa\u842c\u80fd\u5283\u8f49","href":"/docs/zh-TW/v5/asset/transfer/unitransfer","docId":"v5/asset/transfer/unitransfer"},{"type":"link","label":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u7d00\u9304","href":"/docs/zh-TW/v5/asset/transfer/unitransfer-list","docId":"v5/asset/transfer/unitransfer-list"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5145\u503c","items":[{"type":"link","label":"\u67e5\u8a62\u652f\u6301\u7684\u5145\u503c\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/asset/deposit/deposit-coin-spec","docId":"v5/asset/deposit/deposit-coin-spec"},{"type":"link","label":"\u8a2d\u7f6e\u5145\u503c\u5e33\u6236","href":"/docs/zh-TW/v5/asset/deposit/set-deposit-acct","docId":"v5/asset/deposit/set-deposit-acct"},{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u7d00\u9304 (\u93c8\u4e0a)","href":"/docs/zh-TW/v5/asset/deposit/deposit-record","docId":"v5/asset/deposit/deposit-record"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u865f\u7684\u5145\u503c\u7d00\u9304 (\u93c8\u4e0a)","href":"/docs/zh-TW/v5/asset/deposit/sub-deposit-record","docId":"v5/asset/deposit/sub-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u5e73\u53f0\u8f6c\u8d26)","href":"/docs/zh-TW/v5/asset/deposit/internal-deposit-record","docId":"v5/asset/deposit/internal-deposit-record"},{"type":"link","label":"\u67e5\u8a62\u4e3b\u5e33\u865f\u5145\u503c\u5730\u5740","href":"/docs/zh-TW/v5/asset/deposit/master-deposit-addr","docId":"v5/asset/deposit/master-deposit-addr"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u865f\u5145\u503c\u5730\u5740","href":"/docs/zh-TW/v5/asset/deposit/sub-deposit-addr","docId":"v5/asset/deposit/sub-deposit-addr"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u63d0\u73fe","items":[{"type":"link","label":"\u67e5\u8a62\u63d0\u73fe\u7d00\u9304","href":"/docs/zh-TW/v5/asset/withdraw/withdraw-record","docId":"v5/asset/withdraw/withdraw-record"},{"type":"link","label":"\u67e5\u8a62\u4ea4\u6613\u6240\u5217\u8868 (\u97d3\u570b\u7528\u6236)","href":"/docs/zh-TW/v5/asset/withdraw/vasp-list","docId":"v5/asset/withdraw/vasp-list"},{"type":"link","label":"\u63d0\u73fe","href":"/docs/zh-TW/v5/asset/withdraw/","docId":"v5/asset/withdraw/withdraw"},{"type":"link","label":"\u64a4\u92b7\u63d0\u5e63","href":"/docs/zh-TW/v5/asset/withdraw/cancel-withdraw","docId":"v5/asset/withdraw/cancel-withdraw"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u9583\u514c","items":[{"type":"link","label":"\u63a5\u5165\u6307\u5357","href":"/docs/zh-TW/v5/asset/convert/guideline","docId":"v5/asset/convert/guideline"},{"type":"link","label":"\u67e5\u8a62\u514c\u63db\u5e63\u7a2e\u5217\u8868","href":"/docs/zh-TW/v5/asset/convert/convert-coin-list","docId":"v5/asset/convert/convert-coin-list"},{"type":"link","label":"\u7533\u8acb\u5831\u50f9","href":"/docs/zh-TW/v5/asset/convert/apply-quote","docId":"v5/asset/convert/apply-quote"},{"type":"link","label":"\u78ba\u8a8d\u5831\u50f9","href":"/docs/zh-TW/v5/asset/convert/confirm-quote","docId":"v5/asset/convert/confirm-quote"},{"type":"link","label":"\u67e5\u8a62\u5831\u50f9\u55ae\u72c0\u614b","href":"/docs/zh-TW/v5/asset/convert/get-convert-result","docId":"v5/asset/convert/get-convert-result"},{"type":"link","label":"\u67e5\u8a62\u514c\u63db\u6b77\u53f2","href":"/docs/zh-TW/v5/asset/convert/get-convert-history","docId":"v5/asset/convert/get-convert-history"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u7528\u6236","items":[{"type":"link","label":"\u65b0\u5efa\u5b50\u5e33\u6236","href":"/docs/zh-TW/v5/user/create-subuid","docId":"v5/user/create-subuid"},{"type":"link","label":"\u65b0\u5efa\u5b50\u5e33\u6236\u7684API Key","href":"/docs/zh-TW/v5/user/create-subuid-apikey","docId":"v5/user/create-subuid-apikey"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868 (\u9650\u5236)","href":"/docs/zh-TW/v5/user/subuid-list","docId":"v5/user/subuid-list"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868 (\u7121\u9650\u5236)","href":"/docs/zh-TW/v5/user/page-subuid","docId":"v5/user/page-subuid"},{"type":"link","label":"\u51cd\u7d50/\u89e3\u51cd\u5b50\u5e33\u6236","href":"/docs/zh-TW/v5/user/froze-subuid","docId":"v5/user/froze-subuid"},{"type":"link","label":"\u67e5\u8a62API Key\u76f8\u95dc\u4fe1\u606f","href":"/docs/zh-TW/v5/user/apikey-info","docId":"v5/user/apikey-info"},{"type":"link","label":"\u67e5\u8a62\u5b50\u5e33\u6236\u7684\u6240\u6709API Key\u4fe1\u606f","href":"/docs/zh-TW/v5/user/list-sub-apikeys","docId":"v5/user/list-sub-apikeys"},{"type":"link","label":"\u67e5\u8a62\u5e33\u6236\u652f\u6301\u7684\u9322\u5305\u985e\u578b","href":"/docs/zh-TW/v5/user/wallet-type","docId":"v5/user/wallet-type"},{"type":"link","label":"\u4fee\u6539\u6bcd\u5e33\u6236\u7684API Key\u8a2d\u7f6e","href":"/docs/zh-TW/v5/user/modify-master-apikey","docId":"v5/user/modify-master-apikey"},{"type":"link","label":"\u4fee\u6539\u5b50\u5e33\u6236\u7684API Key\u8a2d\u7f6e","href":"/docs/zh-TW/v5/user/modify-sub-apikey","docId":"v5/user/modify-sub-apikey"},{"type":"link","label":"\u522a\u9664\u5b50\u5e33\u6236","href":"/docs/zh-TW/v5/user/rm-subuid","docId":"v5/user/rm-subuid"},{"type":"link","label":"\u522a\u9664\u6bcd\u5e33\u6236\u7684API Key","href":"/docs/zh-TW/v5/user/rm-master-apikey","docId":"v5/user/rm-master-apikey"},{"type":"link","label":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684API Key","href":"/docs/zh-TW/v5/user/rm-sub-apikey","docId":"v5/user/rm-sub-apikey"},{"type":"link","label":"\u67e5\u8a62\u4ee3\u7406\u7528\u6236\u4fe1\u606f","href":"/docs/zh-TW/v5/user/affiliate-info","docId":"v5/user/affiliate-info"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u69d3\u687f\u4ee3\u5e63","items":[{"type":"link","label":"LT\u5168\u91cf\u8cc7\u7522\u67e5\u8a62","href":"/docs/zh-TW/v5/lt/leverage-token-info","docId":"v5/lt/leverage-token-info"},{"type":"link","label":"\u67e5\u8a62LT\u884c\u60c5","href":"/docs/zh-TW/v5/lt/leverage-token-reference","docId":"v5/lt/leverage-token-reference"},{"type":"link","label":"\u7533\u8cfc","href":"/docs/zh-TW/v5/lt/purchase","docId":"v5/lt/purchase"},{"type":"link","label":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","href":"/docs/zh-TW/v5/lt/order-record","docId":"v5/lt/order-record"},{"type":"link","label":"\u8d16\u56de","href":"/docs/zh-TW/v5/lt/redeem","docId":"v5/lt/redeem"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u5168\u5009\u69d3\u687f (\u7d71\u4e00\u5e33\u6236)","items":[{"type":"link","label":"\u67e5\u8a62\u4e0d\u540cVIP\u7684\u69d3\u687f\u6578\u64da","href":"/docs/zh-TW/v5/spot-margin-uta/vip-margin","docId":"v5/spot-margin-uta/vip-margin"},{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u6b77\u53f2\u5229\u7387","href":"/docs/zh-TW/v5/spot-margin-uta/historical-interest","docId":"v5/spot-margin-uta/historical-interest"},{"type":"link","label":"\u5168\u5009\u69d3\u687f\u958b\u95dc","href":"/docs/zh-TW/v5/spot-margin-uta/switch-mode","docId":"v5/spot-margin-uta/switch-mode"},{"type":"link","label":"\u5168\u5009\u69d3\u687f\u8a2d\u7f6e","href":"/docs/zh-TW/v5/spot-margin-uta/set-leverage","docId":"v5/spot-margin-uta/set-leverage"},{"type":"link","label":"\u67e5\u8a62\u958b\u95dc\u72c0\u614b\u548c\u500d\u6578","href":"/docs/zh-TW/v5/spot-margin-uta/status","docId":"v5/spot-margin-uta/status"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u6a5f\u69cb\u501f\u8cb8","items":[{"type":"link","label":"\u67e5\u8a62\u7522\u54c1\u4fe1\u606f","href":"/docs/zh-TW/v5/otc/margin-product-info","docId":"v5/otc/margin-product-info"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/otc/margin-coin-convert-info","docId":"v5/otc/margin-coin-convert-info"},{"type":"link","label":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u4fe1\u606f","href":"/docs/zh-TW/v5/otc/loan-info","docId":"v5/otc/loan-info"},{"type":"link","label":"\u67e5\u8a62\u9084\u6b3e\u4fe1\u606f","href":"/docs/zh-TW/v5/otc/repay-info","docId":"v5/otc/repay-info"},{"type":"link","label":"\u67e5\u8a62\u98a8\u96aa\u7387","href":"/docs/zh-TW/v5/otc/ltv-convert","docId":"v5/otc/ltv-convert"},{"type":"link","label":"\u7d81\u5b9a/\u89e3\u7d81UID","href":"/docs/zh-TW/v5/otc/bind-uid","docId":"v5/otc/bind-uid"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u7d93\u7d00\u5546","items":[{"type":"link","label":"\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63\u4fe1\u606f","href":"/docs/zh-TW/v5/broker/exchange-earning","docId":"v5/broker/exchange-earning"},{"type":"link","label":"\u67e5\u8a62\u7d93\u7d00\u5546\u5e33\u6236\u4fe1\u606f","href":"/docs/zh-TW/v5/broker/account-info","docId":"v5/broker/account-info"},{"type":"link","label":"\u67e5\u8a62\u7d93\u7d00\u5546\u7684\u5b50\u5e33\u865f\u5145\u503c\u7d00\u9304","href":"/docs/zh-TW/v5/broker/sub-deposit-record","docId":"v5/broker/sub-deposit-record"}],"collapsed":true,"collapsible":true},{"type":"category","label":"WebSocket\u6d41","items":[{"type":"link","label":"\u8a02\u95b1WebSocket","href":"/docs/zh-TW/v5/ws/connect","docId":"v5/websocket/wss-authentication"},{"type":"category","label":"\u516c\u5171\u983b\u9053","items":[{"type":"link","label":"\u6df1\u5ea6","href":"/docs/zh-TW/v5/websocket/public/orderbook","docId":"v5/websocket/public/orderbook"},{"type":"link","label":"\u5e73\u53f0\u6210\u4ea4","href":"/docs/zh-TW/v5/websocket/public/trade","docId":"v5/websocket/public/trade"},{"type":"link","label":"\u884c\u60c5","href":"/docs/zh-TW/v5/websocket/public/ticker","docId":"v5/websocket/public/ticker"},{"type":"link","label":"K\u7dda","href":"/docs/zh-TW/v5/websocket/public/kline","docId":"v5/websocket/public/kline"},{"type":"link","label":"\u5f37\u5e73\u63a8\u9001","href":"/docs/zh-TW/v5/websocket/public/liquidation","docId":"v5/websocket/public/liquidation"},{"type":"link","label":"ETP\u6de8\u503cK\u7dda","href":"/docs/zh-TW/v5/websocket/public/etp-kline","docId":"v5/websocket/public/etp-kline"},{"type":"link","label":"ETP\u6de8\u503c\u884c\u60c5\u63a8\u9001","href":"/docs/zh-TW/v5/websocket/public/etp-ticker","docId":"v5/websocket/public/etp-ticker"},{"type":"link","label":"ETP\u6700\u65b0\u6de8\u503c\u63a8\u9001","href":"/docs/zh-TW/v5/websocket/public/etp-nav","docId":"v5/websocket/public/etp-nav"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u79c1\u6709\u983b\u9053","items":[{"type":"link","label":"\u6301\u5009","href":"/docs/zh-TW/v5/websocket/private/position","docId":"v5/websocket/private/position"},{"type":"link","label":"\u500b\u4eba\u6210\u4ea4","href":"/docs/zh-TW/v5/websocket/private/execution","docId":"v5/websocket/private/execution"},{"type":"link","label":"\u500b\u4eba\u6210\u4ea4 (Fast)","href":"/docs/zh-TW/v5/websocket/private/fast-execution","docId":"v5/websocket/private/fast-execution"},{"type":"link","label":"\u8a02\u55ae","href":"/docs/zh-TW/v5/websocket/private/order","docId":"v5/websocket/private/order"},{"type":"link","label":"\u9322\u5305","href":"/docs/zh-TW/v5/websocket/private/wallet","docId":"v5/websocket/private/wallet"},{"type":"link","label":"\u7528\u6236\u5e0c\u81d8\u5b57\u6bcd\u4fe1\u606f (\u671f\u6b0a)","href":"/docs/zh-TW/v5/websocket/private/greek","docId":"v5/websocket/private/greek"},{"type":"link","label":"\u65b7\u7dda\u4fdd\u8b77 (\u671f\u6b0a)","href":"/docs/zh-TW/v5/websocket/private/dcp","docId":"v5/websocket/private/dcp"}],"collapsed":true,"collapsible":true},{"type":"category","label":"\u4ea4\u6613","items":[{"type":"link","label":"Websocket\u4e0b\u55ae\u6307\u5357","href":"/docs/zh-TW/v5/websocket/trade/guideline","docId":"v5/websocket/trade/guideline"}],"collapsed":true,"collapsible":true}],"collapsed":true,"collapsible":true},{"type":"link","label":"\u983b\u7387\u9650\u5236","href":"/docs/zh-TW/v5/rate-limit","docId":"v5/rate-limit"},{"type":"link","label":"\u679a\u8209\u5b9a\u7fa9","href":"/docs/zh-TW/v5/enum","docId":"v5/enum"},{"type":"link","label":"\u932f\u8aa4\u78bc","href":"/docs/zh-TW/v5/error","docId":"v5/error"},{"type":"category","label":"\u5ee2\u68c4\u63a5\u53e3","items":[{"type":"link","label":"\u67e5\u8a62\u53ef\u5b58\u5165\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/abandon/coin-info","docId":"v5/abandon/coin-info"},{"type":"link","label":"\u67e5\u8a62\u98a8\u96aa\u7387","href":"/docs/zh-TW/v5/abandon/ltv","docId":"v5/abandon/ltv"},{"type":"link","label":"\u5b58\u5165\u8cc7\u91d1","href":"/docs/zh-TW/v5/abandon/deposit","docId":"v5/abandon/deposit"},{"type":"link","label":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","href":"/docs/zh-TW/v5/abandon/margin-coin-info","docId":"v5/abandon/margin-coin-info"},{"type":"link","label":"\u914d\u7f6e\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u5e33\u865f","href":"/docs/zh-TW/v5/abandon/enable-unitransfer-subuid","docId":"v5/abandon/enable-unitransfer-subuid"},{"type":"link","label":"\u8d16\u56de\u8cc7\u91d1","href":"/docs/zh-TW/v5/abandon/redeem","docId":"v5/abandon/redeem"},{"type":"link","label":"\u64a4\u92b7\u8d16\u56de","href":"/docs/zh-TW/v5/abandon/cancel-redeem","docId":"v5/abandon/cancel-redeem"},{"type":"link","label":"\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63","href":"/docs/zh-TW/v5/abandon/earning","docId":"v5/abandon/earning"},{"type":"link","label":"\u67e5\u8a62\u8a02\u55ae\u6b77\u53f2","href":"/docs/zh-TW/v5/abandon/order-record","docId":"v5/abandon/order-record"},{"type":"link","label":"\u67e5\u8a62\u4f59\u5e63\u5bf6\u5e33\u6236\u4fe1\u606f","href":"/docs/zh-TW/v5/abandon/account-info","docId":"v5/abandon/account-info"}],"collapsed":true,"collapsible":true}],"apiExplorerSideBar":[{"type":"category","label":"V5","items":[{"type":"category","label":"Market","items":[{"type":"link","label":"Get Bybit Server Time","href":"/docs/zh-TW/api-explorer/v5/market/time","className":"api-method get","docId":"api-explorer/v5/market/time"},{"type":"link","label":"Get Kline","href":"/docs/zh-TW/api-explorer/v5/market/kline","className":"api-method get","docId":"api-explorer/v5/market/kline"},{"type":"link","label":"Get Mark Price Kline","href":"/docs/zh-TW/api-explorer/v5/market/mark-kline","className":"api-method get","docId":"api-explorer/v5/market/mark-kline"},{"type":"link","label":"Get Index Price Kline","href":"/docs/zh-TW/api-explorer/v5/market/index-kline","className":"api-method get","docId":"api-explorer/v5/market/index-kline"},{"type":"link","label":"Get Premium Index Price Kline","href":"/docs/zh-TW/api-explorer/v5/market/premium-index-kline","className":"api-method get","docId":"api-explorer/v5/market/premium-index-kline"},{"type":"link","label":"Get Instrument Info","href":"/docs/zh-TW/api-explorer/v5/market/instrument","className":"api-method get","docId":"api-explorer/v5/market/instrument"},{"type":"link","label":"Get Orderbook","href":"/docs/zh-TW/api-explorer/v5/market/orderbook","className":"api-method get","docId":"api-explorer/v5/market/orderbook"},{"type":"link","label":"Get Tickers","href":"/docs/zh-TW/api-explorer/v5/market/tickers","className":"api-method get","docId":"api-explorer/v5/market/tickers"},{"type":"link","label":"Get Funding Rate History","href":"/docs/zh-TW/api-explorer/v5/market/history-fund-rate","className":"api-method get","docId":"api-explorer/v5/market/history-fund-rate"},{"type":"link","label":"Get Public Recent Trading History","href":"/docs/zh-TW/api-explorer/v5/market/recent-trade","className":"api-method get","docId":"api-explorer/v5/market/recent-trade"},{"type":"link","label":"Get Open Interest","href":"/docs/zh-TW/api-explorer/v5/market/open-interest","className":"api-method get","docId":"api-explorer/v5/market/open-interest"},{"type":"link","label":"Get Historical Volatility","href":"/docs/zh-TW/api-explorer/v5/market/iv","className":"api-method get","docId":"api-explorer/v5/market/iv"},{"type":"link","label":"Get Insurance","href":"/docs/zh-TW/api-explorer/v5/market/insurance","className":"api-method get","docId":"api-explorer/v5/market/insurance"},{"type":"link","label":"Get Risk Limit","href":"/docs/zh-TW/api-explorer/v5/market/risk-limit","className":"api-method get","docId":"api-explorer/v5/market/risk-limit"},{"type":"link","label":"Get Delivery Price","href":"/docs/zh-TW/api-explorer/v5/market/delivery-price","className":"api-method get","docId":"api-explorer/v5/market/delivery-price"},{"type":"link","label":"Get Long Short Ratio","href":"/docs/zh-TW/api-explorer/v5/market/long-short-ratio","className":"api-method get","docId":"api-explorer/v5/market/long-short-ratio"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/market/market"},{"type":"category","label":"Trade","items":[{"type":"link","label":"Place Order","href":"/docs/zh-TW/api-explorer/v5/trade/create-order","className":"api-method post","docId":"api-explorer/v5/trade/create-order"},{"type":"link","label":"Amend Order","href":"/docs/zh-TW/api-explorer/v5/trade/amend-order","className":"api-method post","docId":"api-explorer/v5/trade/amend-order"},{"type":"link","label":"Cancel Order","href":"/docs/zh-TW/api-explorer/v5/trade/cancel-order","className":"api-method post","docId":"api-explorer/v5/trade/cancel-order"},{"type":"link","label":"Get Open Orders (real-time)","href":"/docs/zh-TW/api-explorer/v5/trade/open-order","className":"api-method get","docId":"api-explorer/v5/trade/open-order"},{"type":"link","label":"Cancel All Orders","href":"/docs/zh-TW/api-explorer/v5/trade/cancel-all","className":"api-method post","docId":"api-explorer/v5/trade/cancel-all"},{"type":"link","label":"Get Order History (2 years)","href":"/docs/zh-TW/api-explorer/v5/trade/order-list","className":"api-method get","docId":"api-explorer/v5/trade/order-list"},{"type":"link","label":"Batch Place Order","href":"/docs/zh-TW/api-explorer/v5/trade/batch-place","className":"api-method post","docId":"api-explorer/v5/trade/batch-place"},{"type":"link","label":"Batch Amend Order","href":"/docs/zh-TW/api-explorer/v5/trade/batch-amend","className":"api-method post","docId":"api-explorer/v5/trade/batch-amend"},{"type":"link","label":"Batch Cancel Order","href":"/docs/zh-TW/api-explorer/v5/trade/batch-cancel","className":"api-method post","docId":"api-explorer/v5/trade/batch-cancel"},{"type":"link","label":"Get Borrow Quota (Spot)","href":"/docs/zh-TW/api-explorer/v5/trade/query-spot-quota","className":"api-method get","docId":"api-explorer/v5/trade/query-spot-quota"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/trade/trade"},{"type":"category","label":"Position","items":[{"type":"link","label":"Get Position Info","href":"/docs/zh-TW/api-explorer/v5/position/position-info","className":"api-method get","docId":"api-explorer/v5/position/position-info"},{"type":"link","label":"Set Leverage","href":"/docs/zh-TW/api-explorer/v5/position/leverage","className":"api-method post","docId":"api-explorer/v5/position/leverage"},{"type":"link","label":"Switch Cross/Isolated Margin","href":"/docs/zh-TW/api-explorer/v5/position/cross-isolate","className":"api-method post","docId":"api-explorer/v5/position/cross-isolate"},{"type":"link","label":"Set TP/SL Mode","href":"/docs/zh-TW/api-explorer/v5/position/tpsl-mode","className":"api-method post","docId":"api-explorer/v5/position/tpsl-mode"},{"type":"link","label":"Switch Position Mode","href":"/docs/zh-TW/api-explorer/v5/position/position-mode","className":"api-method post","docId":"api-explorer/v5/position/position-mode"},{"type":"link","label":"Set Risk Limit","href":"/docs/zh-TW/api-explorer/v5/position/set-risk-limit","className":"api-method post","docId":"api-explorer/v5/position/set-risk-limit"},{"type":"link","label":"Set Trading Stop","href":"/docs/zh-TW/api-explorer/v5/position/trading-stop","className":"api-method post","docId":"api-explorer/v5/position/trading-stop"},{"type":"link","label":"Set Auto Add Margin","href":"/docs/zh-TW/api-explorer/v5/position/auto-add-margin","className":"api-method post","docId":"api-explorer/v5/position/auto-add-margin"},{"type":"link","label":"Add Or Reduce Margin","href":"/docs/zh-TW/api-explorer/v5/position/manual-add-margin","className":"api-method post","docId":"api-explorer/v5/position/manual-add-margin"},{"type":"link","label":"Get Execution (2 years)","href":"/docs/zh-TW/api-explorer/v5/position/execution","className":"api-method get","docId":"api-explorer/v5/position/execution"},{"type":"link","label":"Get Closed PnL","href":"/docs/zh-TW/api-explorer/v5/position/close-pnl","className":"api-method get","docId":"api-explorer/v5/position/close-pnl"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/position/position"},{"type":"category","label":"Account","items":[{"type":"link","label":"Get Wallet Balance","href":"/docs/zh-TW/api-explorer/v5/account/wallet","className":"api-method get","docId":"api-explorer/v5/account/wallet"},{"type":"link","label":"Upgrade to Unified Account","href":"/docs/zh-TW/api-explorer/v5/account/upgrade-unified-account","className":"api-method post","docId":"api-explorer/v5/account/upgrade-unified-account"},{"type":"link","label":"Set Collateral Coin","href":"/docs/zh-TW/api-explorer/v5/account/set-collateral","className":"api-method post","docId":"api-explorer/v5/account/set-collateral"},{"type":"link","label":"Get Borrow History","href":"/docs/zh-TW/api-explorer/v5/account/borrow-history","className":"api-method get","docId":"api-explorer/v5/account/borrow-history"},{"type":"link","label":"Get Collateral Info","href":"/docs/zh-TW/api-explorer/v5/account/collateral-info","className":"api-method get","docId":"api-explorer/v5/account/collateral-info"},{"type":"link","label":"Get Coin Greeks","href":"/docs/zh-TW/api-explorer/v5/account/coin-greeks","className":"api-method get","docId":"api-explorer/v5/account/coin-greeks"},{"type":"link","label":"Get Fee Rate","href":"/docs/zh-TW/api-explorer/v5/account/fee-rate","className":"api-method get","docId":"api-explorer/v5/account/fee-rate"},{"type":"link","label":"Get Account Info","href":"/docs/zh-TW/api-explorer/v5/account/account-info","className":"api-method get","docId":"api-explorer/v5/account/account-info"},{"type":"link","label":"Get Transaction Log","href":"/docs/zh-TW/api-explorer/v5/account/transaction-log","className":"api-method get","docId":"api-explorer/v5/account/transaction-log"},{"type":"link","label":"Set Margin Mode","href":"/docs/zh-TW/api-explorer/v5/account/set-margin-mode","className":"api-method post","docId":"api-explorer/v5/account/set-margin-mode"},{"type":"link","label":"Set Spot Hedging","href":"/docs/zh-TW/api-explorer/v5/account/set-spot-hedge","className":"api-method post","docId":"api-explorer/v5/account/set-spot-hedge"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/account/account"},{"type":"category","label":"Asset","items":[{"type":"link","label":"Get Coin Exchange Records","href":"/docs/zh-TW/api-explorer/v5/asset/exchange","className":"api-method get","docId":"api-explorer/v5/asset/exchange"},{"type":"link","label":"Get Delivery Record","href":"/docs/zh-TW/api-explorer/v5/asset/delivery","className":"api-method get","docId":"api-explorer/v5/asset/delivery"},{"type":"link","label":"Get USDC Session Settlement","href":"/docs/zh-TW/api-explorer/v5/asset/settlement","className":"api-method get","docId":"api-explorer/v5/asset/settlement"},{"type":"link","label":"Get Asset Info (Spot)","href":"/docs/zh-TW/api-explorer/v5/asset/asset-info","className":"api-method get","docId":"api-explorer/v5/asset/asset-info"},{"type":"link","label":"Get All Coins Balance","href":"/docs/zh-TW/api-explorer/v5/asset/all-balance","className":"api-method get","docId":"api-explorer/v5/asset/all-balance"},{"type":"link","label":"Get Single Coin Balance","href":"/docs/zh-TW/api-explorer/v5/asset/account-coin-balance","className":"api-method get","docId":"api-explorer/v5/asset/account-coin-balance"},{"type":"link","label":"Get Transferable Coin","href":"/docs/zh-TW/api-explorer/v5/asset/transferable-coin","className":"api-method get","docId":"api-explorer/v5/asset/transferable-coin"},{"type":"link","label":"Create Internal Transfer","href":"/docs/zh-TW/api-explorer/v5/asset/create-inter-transfer","className":"api-method post","docId":"api-explorer/v5/asset/create-inter-transfer"},{"type":"link","label":"Get Internal Transfer Records","href":"/docs/zh-TW/api-explorer/v5/asset/inter-transfer-list","className":"api-method get","docId":"api-explorer/v5/asset/inter-transfer-list"},{"type":"link","label":"Get Sub UID","href":"/docs/zh-TW/api-explorer/v5/asset/sub-uid-list","className":"api-method get","docId":"api-explorer/v5/asset/sub-uid-list"},{"type":"link","label":"Create Universal Transfer","href":"/docs/zh-TW/api-explorer/v5/asset/unitransfer","className":"api-method post","docId":"api-explorer/v5/asset/unitransfer"},{"type":"link","label":"Get Universal Transfer Records","href":"/docs/zh-TW/api-explorer/v5/asset/unitransfer-list","className":"api-method get","docId":"api-explorer/v5/asset/unitransfer-list"},{"type":"link","label":"Get Allowed Deposit Coin Info","href":"/docs/zh-TW/api-explorer/v5/asset/deposit-coin-spec","className":"api-method get","docId":"api-explorer/v5/asset/deposit-coin-spec"},{"type":"link","label":"Set Deposit Account","href":"/docs/zh-TW/api-explorer/v5/asset/set-deposit-acct","className":"api-method post","docId":"api-explorer/v5/asset/set-deposit-acct"},{"type":"link","label":"Get Deposit Record (on-chain)","href":"/docs/zh-TW/api-explorer/v5/asset/deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/deposit-record"},{"type":"link","label":"Get Sub Account Deposit Records (on-chain)","href":"/docs/zh-TW/api-explorer/v5/asset/sub-deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/sub-deposit-record"},{"type":"link","label":"Get Internal Deposit Records (off-chain)","href":"/docs/zh-TW/api-explorer/v5/asset/internal-deposit-record","className":"api-method get","docId":"api-explorer/v5/asset/internal-deposit-record"},{"type":"link","label":"Get Master Deposit Address","href":"/docs/zh-TW/api-explorer/v5/asset/master-deposit-addr","className":"api-method get","docId":"api-explorer/v5/asset/master-deposit-addr"},{"type":"link","label":"Get Sub Deposit Address","href":"/docs/zh-TW/api-explorer/v5/asset/sub-deposit-addr","className":"api-method get","docId":"api-explorer/v5/asset/sub-deposit-addr"},{"type":"link","label":"Get Coin Info","href":"/docs/zh-TW/api-explorer/v5/asset/coin-info","className":"api-method get","docId":"api-explorer/v5/asset/coin-info"},{"type":"link","label":"Get Withdraw Records","href":"/docs/zh-TW/api-explorer/v5/asset/withdraw-record","className":"api-method get","docId":"api-explorer/v5/asset/withdraw-record"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/asset/asset"},{"type":"category","label":"User","items":[{"type":"link","label":"Get API Key Information","href":"/docs/zh-TW/api-explorer/v5/user/apikey-info","className":"api-method get","docId":"api-explorer/v5/user/apikey-info"},{"type":"link","label":"Get Sub Account All API Keys","href":"/docs/zh-TW/api-explorer/v5/user/list-sub-apikeys","className":"api-method get","docId":"api-explorer/v5/user/list-sub-apikeys"},{"type":"link","label":"Get UID Wallet Type","href":"/docs/zh-TW/api-explorer/v5/user/wallet-type","className":"api-method get","docId":"api-explorer/v5/user/wallet-type"},{"type":"link","label":"Get Affiliate User Info","href":"/docs/zh-TW/api-explorer/v5/user/affiliate-info","className":"api-method get","docId":"api-explorer/v5/user/affiliate-info"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/user/user"},{"type":"category","label":"Spot Leverage Token","items":[{"type":"link","label":"Get Leverage Token Info","href":"/docs/zh-TW/api-explorer/v5/lt/leverage-token-info","className":"api-method get","docId":"api-explorer/v5/lt/leverage-token-info"},{"type":"link","label":"Get Leverage Token Market","href":"/docs/zh-TW/api-explorer/v5/lt/leverage-token-reference","className":"api-method get","docId":"api-explorer/v5/lt/leverage-token-reference"},{"type":"link","label":"Purchase","href":"/docs/zh-TW/api-explorer/v5/lt/purchase","className":"api-method post","docId":"api-explorer/v5/lt/purchase"},{"type":"link","label":"Redeem","href":"/docs/zh-TW/api-explorer/v5/lt/redeem","className":"api-method post","docId":"api-explorer/v5/lt/redeem"},{"type":"link","label":"Get Purchase or Redeem Records","href":"/docs/zh-TW/api-explorer/v5/lt/order-record","className":"api-method get","docId":"api-explorer/v5/lt/order-record"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/lt/etp"},{"type":"category","label":"Spot Margin Trade (UTA)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/vip-margin","className":"api-method get","docId":"api-explorer/v5/spot-margin-uta/vip-margin"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/switch-mode","className":"api-method post","docId":"api-explorer/v5/spot-margin-uta/switch-mode"},{"type":"link","label":"Set Leverage","href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/set-leverage","className":"api-method post","docId":"api-explorer/v5/spot-margin-uta/set-leverage"},{"type":"link","label":"Get Status And Leverage","href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/status","className":"api-method get","docId":"api-explorer/v5/spot-margin-uta/status"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/spot-margin-uta/uta-margin-trade"},{"type":"category","label":"Spot Margin Trade (Classic)","items":[{"type":"link","label":"Get VIP Margin Data","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/vip-margin","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/vip-margin"},{"type":"link","label":"Get Margin Coin Info","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/margin-data","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/margin-data"},{"type":"link","label":"Get Borrowable Coin Info","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/borrowable-data","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/borrowable-data"},{"type":"link","label":"Get Interest & Quota","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/interest-quota","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/interest-quota"},{"type":"link","label":"Get Loan Account Info","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/account-info","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/account-info"},{"type":"link","label":"Borrow","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/borrow","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/borrow"},{"type":"link","label":"Repay","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/repay","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/repay"},{"type":"link","label":"Get Borrow Order Detail","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/borrow-order","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/borrow-order"},{"type":"link","label":"Get Repayment Order Detail","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/repay-order","className":"api-method get","docId":"api-explorer/v5/spot-margin-normal/repay-order"},{"type":"link","label":"Toggle Margin Trade","href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/switch-mode","className":"api-method post","docId":"api-explorer/v5/spot-margin-normal/switch-mode"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/spot-margin-normal/normal-margin-trade"}],"collapsed":true,"collapsible":true,"href":"/docs/zh-TW/api-explorer/v5/category/"}],"changelogSidebar":[{"type":"link","label":"V5","href":"/docs/zh-TW/changelog/v5","docId":"changelog/v5"},{"type":"link","label":"\u884d\u751f\u54c1 V3","href":"/docs/zh-TW/changelog/derivatives-v3","docId":"changelog/derivatives-v3"},{"type":"link","label":"\u73fe\u8ca8 V3","href":"/docs/zh-TW/changelog/spot-v3","docId":"changelog/spot-v3"},{"type":"link","label":"\u5e33\u6236\u8cc7\u7522 V3","href":"/docs/zh-TW/changelog/asset-v3","docId":"changelog/asset-v3"},{"type":"link","label":"\u8ddf\u55ae\u4ea4\u6613","href":"/docs/zh-TW/changelog/copytrade","docId":"changelog/copytrade"}]},"docs":{"api-explorer/v5/account/account":{"id":"api-explorer/v5/account/account","title":"Account","description":"Account","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/account-info":{"id":"api-explorer/v5/account/account-info","title":"Get Account Info","description":"Get account info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/borrow-history":{"id":"api-explorer/v5/account/borrow-history","title":"Get Borrow History","description":"Get borrow history","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/coin-greeks":{"id":"api-explorer/v5/account/coin-greeks","title":"Get Coin Greeks","description":"Get coin greek info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/collateral-info":{"id":"api-explorer/v5/account/collateral-info","title":"Get Collateral Info","description":"Get collateral info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/fee-rate":{"id":"api-explorer/v5/account/fee-rate","title":"Get Fee Rate","description":"Get fee rate","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-collateral":{"id":"api-explorer/v5/account/set-collateral","title":"Set Collateral Coin","description":"Set collateral coin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-margin-mode":{"id":"api-explorer/v5/account/set-margin-mode","title":"Set Margin Mode","description":"Set margin mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/set-spot-hedge":{"id":"api-explorer/v5/account/set-spot-hedge","title":"Set Spot Hedging","description":"Set spot hedging for Portfolio margin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/transaction-log":{"id":"api-explorer/v5/account/transaction-log","title":"Get Transaction Log","description":"Get transaction log","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/upgrade-unified-account":{"id":"api-explorer/v5/account/upgrade-unified-account","title":"Upgrade to Unified Account","description":"Upgrade to UTA","sidebar":"apiExplorerSideBar"},"api-explorer/v5/account/wallet":{"id":"api-explorer/v5/account/wallet","title":"Get Wallet Balance","description":"Get wallet balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/account-coin-balance":{"id":"api-explorer/v5/asset/account-coin-balance","title":"Get Single Coin Balance","description":"Get Single Coin Balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/all-balance":{"id":"api-explorer/v5/asset/all-balance","title":"Get All Coins Balance","description":"Get All Coins Balance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/asset":{"id":"api-explorer/v5/asset/asset","title":"Asset","description":"Asset","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/asset-info":{"id":"api-explorer/v5/asset/asset-info","title":"Get Asset Info (Spot)","description":"Get spot asset","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/coin-info":{"id":"api-explorer/v5/asset/coin-info","title":"Get Coin Info","description":"Get coin info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/create-inter-transfer":{"id":"api-explorer/v5/asset/create-inter-transfer","title":"Create Internal Transfer","description":"Create internal transfer","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/delivery":{"id":"api-explorer/v5/asset/delivery","title":"Get Delivery Record","description":"Get delivery record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/deposit-coin-spec":{"id":"api-explorer/v5/asset/deposit-coin-spec","title":"Get Allowed Deposit Coin Info","description":"Get allowed deposit coin info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/deposit-record":{"id":"api-explorer/v5/asset/deposit-record","title":"Get Deposit Record (on-chain)","description":"Get deposit record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/exchange":{"id":"api-explorer/v5/asset/exchange","title":"Get Coin Exchange Records","description":"Get exchange records","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/inter-transfer-list":{"id":"api-explorer/v5/asset/inter-transfer-list","title":"Get Internal Transfer Records","description":"Get internal transfer records","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/internal-deposit-record":{"id":"api-explorer/v5/asset/internal-deposit-record","title":"Get Internal Deposit Records (off-chain)","description":"Get deposit records through Bybit platform","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/master-deposit-addr":{"id":"api-explorer/v5/asset/master-deposit-addr","title":"Get Master Deposit Address","description":"Get master deposit address","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/set-deposit-acct":{"id":"api-explorer/v5/asset/set-deposit-acct","title":"Set Deposit Account","description":"Set Deposit Account","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/settlement":{"id":"api-explorer/v5/asset/settlement","title":"Get USDC Session Settlement","description":"Get usdc session settlement record.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-deposit-addr":{"id":"api-explorer/v5/asset/sub-deposit-addr","title":"Get Sub Deposit Address","description":"Get sub deposit address","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-deposit-record":{"id":"api-explorer/v5/asset/sub-deposit-record","title":"Get Sub Account Deposit Records (on-chain)","description":"Get sub account deposit record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/sub-uid-list":{"id":"api-explorer/v5/asset/sub-uid-list","title":"Get Sub UID","description":"Get sub uid","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/transferable-coin":{"id":"api-explorer/v5/asset/transferable-coin","title":"Get Transferable Coin","description":"Get transferable coins","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/unitransfer":{"id":"api-explorer/v5/asset/unitransfer","title":"Create Universal Transfer","description":"Create universal transfer","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/unitransfer-list":{"id":"api-explorer/v5/asset/unitransfer-list","title":"Get Universal Transfer Records","description":"Get universal transfer record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/asset/withdraw-record":{"id":"api-explorer/v5/asset/withdraw-record","title":"Get Withdraw Records","description":"Get withdraw record","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/etp":{"id":"api-explorer/v5/lt/etp","title":"Spot Leverage Token","description":"Spot Leverage Token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/leverage-token-info":{"id":"api-explorer/v5/lt/leverage-token-info","title":"Get Leverage Token Info","description":"Get lt information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/leverage-token-reference":{"id":"api-explorer/v5/lt/leverage-token-reference","title":"Get Leverage Token Market","description":"Get lt market information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/order-record":{"id":"api-explorer/v5/lt/order-record","title":"Get Purchase or Redeem Records","description":"Get the order history of purchase or redeem","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/purchase":{"id":"api-explorer/v5/lt/purchase","title":"Purchase","description":"Purchase leverage token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/lt/redeem":{"id":"api-explorer/v5/lt/redeem","title":"Redeem","description":"Redeem leverage token","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/delivery-price":{"id":"api-explorer/v5/market/delivery-price","title":"Get Delivery Price","description":"Get delivery price","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/history-fund-rate":{"id":"api-explorer/v5/market/history-fund-rate","title":"Get Funding Rate History","description":"Get historical funding rate","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/index-kline":{"id":"api-explorer/v5/market/index-kline","title":"Get Index Price Kline","description":"Get Index Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/instrument":{"id":"api-explorer/v5/market/instrument","title":"Get Instrument Info","description":"Get launched instruments information.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/insurance":{"id":"api-explorer/v5/market/insurance","title":"Get Insurance","description":"Get Insurance","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/iv":{"id":"api-explorer/v5/market/iv","title":"Get Historical Volatility","description":"Get historical volatility","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/kline":{"id":"api-explorer/v5/market/kline","title":"Get Kline","description":"Get kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/long-short-ratio":{"id":"api-explorer/v5/market/long-short-ratio","title":"Get Long Short Ratio","description":"Get long short ratio","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/mark-kline":{"id":"api-explorer/v5/market/mark-kline","title":"Get Mark Price Kline","description":"Get Mark Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/market":{"id":"api-explorer/v5/market/market","title":"Market","description":"Market","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/open-interest":{"id":"api-explorer/v5/market/open-interest","title":"Get Open Interest","description":"Get open interest","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/orderbook":{"id":"api-explorer/v5/market/orderbook","title":"Get Orderbook","description":"Get order book data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/premium-index-kline":{"id":"api-explorer/v5/market/premium-index-kline","title":"Get Premium Index Price Kline","description":"Get Premium Index Price Kline data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/recent-trade":{"id":"api-explorer/v5/market/recent-trade","title":"Get Public Recent Trading History","description":"Get public trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/risk-limit":{"id":"api-explorer/v5/market/risk-limit","title":"Get Risk Limit","description":"Get risk limit","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/tickers":{"id":"api-explorer/v5/market/tickers","title":"Get Tickers","description":"Get all latest information of symbols. All parameters are needed for OPTION","sidebar":"apiExplorerSideBar"},"api-explorer/v5/market/time":{"id":"api-explorer/v5/market/time","title":"Get Bybit Server Time","description":"Get server time","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/auto-add-margin":{"id":"api-explorer/v5/position/auto-add-margin","title":"Set Auto Add Margin","description":"Set Auto Add Margin","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/close-pnl":{"id":"api-explorer/v5/position/close-pnl","title":"Get Closed PnL","description":"Get closed pnl","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/cross-isolate":{"id":"api-explorer/v5/position/cross-isolate","title":"Switch Cross/Isolated Margin","description":"Select cross margin mode or isolated margin mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/execution":{"id":"api-explorer/v5/position/execution","title":"Get Execution (2 years)","description":"Get execution list","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/leverage":{"id":"api-explorer/v5/position/leverage","title":"Set Leverage","description":"Set levearage.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/manual-add-margin":{"id":"api-explorer/v5/position/manual-add-margin","title":"Add Or Reduce Margin","description":"Manually add or reduce margin for isolated margin position","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position":{"id":"api-explorer/v5/position/position","title":"Position","description":"Position","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position-info":{"id":"api-explorer/v5/position/position-info","title":"Get Position Info","description":"Get Position Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/position-mode":{"id":"api-explorer/v5/position/position-mode","title":"Switch Position Mode","description":"Switch Position Mode","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/set-risk-limit":{"id":"api-explorer/v5/position/set-risk-limit","title":"Set Risk Limit","description":"Set risk limit.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/tpsl-mode":{"id":"api-explorer/v5/position/tpsl-mode","title":"Set TP/SL Mode","description":"Set tp/sl mode.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/position/trading-stop":{"id":"api-explorer/v5/position/trading-stop","title":"Set Trading Stop","description":"Set trade stop.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/account-info":{"id":"api-explorer/v5/spot-margin-normal/account-info","title":"Get Loan Account Info","description":"Get Loan Account Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrow":{"id":"api-explorer/v5/spot-margin-normal/borrow","title":"Borrow","description":"Borrow","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrow-order":{"id":"api-explorer/v5/spot-margin-normal/borrow-order","title":"Get Borrow Order Detail","description":"Get Borrow Order Detail","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/borrowable-data":{"id":"api-explorer/v5/spot-margin-normal/borrowable-data","title":"Get Borrowable Coin Info","description":"Get Borrowable Coin Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/interest-quota":{"id":"api-explorer/v5/spot-margin-normal/interest-quota","title":"Get Interest & Quota","description":"Get Interest & Quota","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/margin-data":{"id":"api-explorer/v5/spot-margin-normal/margin-data","title":"Get Margin Coin Info","description":"Get Margin Coin Info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/normal-margin-trade":{"id":"api-explorer/v5/spot-margin-normal/normal-margin-trade","title":"Spot Margin Trade (Classic)","description":"Spot Margin Trade (Classic)","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/repay":{"id":"api-explorer/v5/spot-margin-normal/repay","title":"Repay","description":"Repay","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/repay-order":{"id":"api-explorer/v5/spot-margin-normal/repay-order","title":"Get Repayment Order Detail","description":"Get Repayment Order Detail","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/switch-mode":{"id":"api-explorer/v5/spot-margin-normal/switch-mode","title":"Toggle Margin Trade","description":"Toggle Margin Trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-normal/vip-margin":{"id":"api-explorer/v5/spot-margin-normal/vip-margin","title":"Get VIP Margin Data","description":"Get vip margin data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/set-leverage":{"id":"api-explorer/v5/spot-margin-uta/set-leverage","title":"Set Leverage","description":"Set leverage for margin trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/status":{"id":"api-explorer/v5/spot-margin-uta/status","title":"Get Status And Leverage","description":"Get status and leverage","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/switch-mode":{"id":"api-explorer/v5/spot-margin-uta/switch-mode","title":"Toggle Margin Trade","description":"Toggle margin trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/uta-margin-trade":{"id":"api-explorer/v5/spot-margin-uta/uta-margin-trade","title":"Spot Margin Trade (UTA)","description":"Spot Margin Trade (UTA)","sidebar":"apiExplorerSideBar"},"api-explorer/v5/spot-margin-uta/vip-margin":{"id":"api-explorer/v5/spot-margin-uta/vip-margin","title":"Get VIP Margin Data","description":"Get vip margin data","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/amend-order":{"id":"api-explorer/v5/trade/amend-order","title":"Amend Order","description":"Amend an order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-amend":{"id":"api-explorer/v5/trade/batch-amend","title":"Batch Amend Order","description":"Batch amend orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-cancel":{"id":"api-explorer/v5/trade/batch-cancel","title":"Batch Cancel Order","description":"Batch cancel orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/batch-place":{"id":"api-explorer/v5/trade/batch-place","title":"Batch Place Order","description":"Batch place orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/cancel-all":{"id":"api-explorer/v5/trade/cancel-all","title":"Cancel All Orders","description":"Cancel all orders.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/cancel-order":{"id":"api-explorer/v5/trade/cancel-order","title":"Cancel Order","description":"Cancel a single order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/create-order":{"id":"api-explorer/v5/trade/create-order","title":"Place Order","description":"Place an order.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/open-order":{"id":"api-explorer/v5/trade/open-order","title":"Get Open Orders (real-time)","description":"Get unfilled orders or partially filled orders","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/order-list":{"id":"api-explorer/v5/trade/order-list","title":"Get Order History (2 years)","description":"Get order history.","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/query-spot-quota":{"id":"api-explorer/v5/trade/query-spot-quota","title":"Get Borrow Quota (Spot)","description":"Query user\'s spot available quota","sidebar":"apiExplorerSideBar"},"api-explorer/v5/trade/trade":{"id":"api-explorer/v5/trade/trade","title":"Trade","description":"Trade","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/affiliate-info":{"id":"api-explorer/v5/user/affiliate-info","title":"Get Affiliate User Info","description":"Get affiliate user info","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/apikey-info":{"id":"api-explorer/v5/user/apikey-info","title":"Get API Key Information","description":"Get API Key Information","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/list-sub-apikeys":{"id":"api-explorer/v5/user/list-sub-apikeys","title":"Get Sub Account All API Keys","description":"Get Sub Account All API Keys","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/user":{"id":"api-explorer/v5/user/user","title":"User","description":"User","sidebar":"apiExplorerSideBar"},"api-explorer/v5/user/wallet-type":{"id":"api-explorer/v5/user/wallet-type","title":"Get UID Wallet Type","description":"Get uid wallet type","sidebar":"apiExplorerSideBar"},"changelog/asset-v3":{"id":"changelog/asset-v3","title":"\u5e33\u6236\u8cc7\u7522 V3","description":"2024-05-09","sidebar":"changelogSidebar"},"changelog/copytrade":{"id":"changelog/copytrade","title":"\u8ddf\u55ae\u4ea4\u6613","description":"2023-06-24","sidebar":"changelogSidebar"},"changelog/derivatives-v3":{"id":"changelog/derivatives-v3","title":"\u884d\u751f\u54c1 V3","description":"2024-05-09","sidebar":"changelogSidebar"},"changelog/spot-v3":{"id":"changelog/spot-v3","title":"\u73fe\u8ca8 V3","description":"2023-04-20","sidebar":"changelogSidebar"},"changelog/v5":{"id":"changelog/v5","title":"V5","description":"20234-08-13","sidebar":"changelogSidebar"},"faq":{"id":"faq","title":"\u5e38\u898b\u554f\u984c","description":"Bybit\u7684\u670d\u52d9\u5668\u5728\u54ea\u88e1?"},"pilot-feature/pilot":{"id":"pilot-feature/pilot","title":"\u8a66\u9ede\u529f\u80fd","description":"Open API\u652f\u6301\u6a21\u64ec\u4ea4\u6613"},"v3/account-asset/enum":{"id":"v3/account-asset/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"accountType","sidebar":"v3SideBar"},"v3/account-asset/error":{"id":"v3/account-asset/error","title":"\u932f\u8aa4\u78bc","description":"|\u932f\u8aa4\u78bc |\u63cf\u8ff0 |","sidebar":"v3SideBar"},"v3/account-asset/rate-limit":{"id":"v3/account-asset/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b","sidebar":"v3SideBar"},"v3/account-asset/transfer/all-balance":{"id":"v3/account-asset/transfer/all-balance","title":"\u67e5\u8a62\u8cec\u6236\u6240\u6709\u5e63\u7a2e\u4f59\u984d","description":"\u652f\u6301\u67e5\u8a62\u6bcd\u5e33\u6236\u7684\u5404\u500b\u5e33\u6236\u985e\u578b\u7684\u5e63\u7a2e\u9918\u984d\uff0c\u4ee5\u53ca\u6bcd\u5e33\u6236\u4e0b\u5404\u5b50\u5e33\u6236\u7684\u5404\u500b\u5e33\u6236\u985e\u578b\u7684\u5e63\u7a2e\u9918\u984d\u3002","sidebar":"v3SideBar"},"v3/account-asset/transfer/asset-info":{"id":"v3/account-asset/transfer/asset-info","title":"\u67e5\u8a62\u8cc7\u7522\u4fe1\u606f","description":"\u50c5\u80fd\u67e5\u8a62\u5230\u73fe\u8ca8\u5e33\u6236\u7684\u8cc7\u7522","sidebar":"v3SideBar"},"v3/account-asset/transfer/coin-balance":{"id":"v3/account-asset/transfer/coin-balance","title":"\u67e5\u8a62\u8cec\u6236\u55ae\u500b\u5e63\u7a2e\u4f59\u984d","description":"\u652f\u6301\u67e5\u8a62\u6bcd\u5e33\u6236\u7684\u55ae\u500b\u5e63\u7a2e\u9918\u984d\uff0c\u4ee5\u53ca\u6bcd\u5e33\u6236\u4e0b\u5404\u5b50\u5e33\u6236\u7684\u55ae\u500b\u5e63\u7a2e\u9918\u984d\u3002","sidebar":"v3SideBar"},"v3/account-asset/transfer/enable-uni-transfer":{"id":"v3/account-asset/transfer/enable-uni-transfer","title":"\u914d\u7f6e\u53ef\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u8cec\u865f (\u5ee2\u68c4)","description":"\u914d\u7f6e\u53ef\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u8cec\u865f\u5217\u8868","sidebar":"v3SideBar"},"v3/account-asset/transfer/internal-transfer":{"id":"v3/account-asset/transfer/internal-transfer","title":"\u5283\u8f49(\u55ae\u5e33\u865f\u5167)","description":"\u5728\u500b\u4eba\u8cec\u6236\u7684\u4e0d\u540c\u696d\u52d9\u8cec\u6236\u4e4b\u9593\uff08\u800c\u975e\u5b50\u8cec\u6236\u4e4b\u9593\uff09\u8f49\u79fb\u8cc7\u91d1\u3002 \u4f8b\u5982\uff0c\u5728\u73fe\u8ca8\u548c\u884d\u751f\u54c1\u8cec\u6236\u4e4b\u9593\u3002","sidebar":"v3SideBar"},"v3/account-asset/transfer/internal-transfer-list":{"id":"v3/account-asset/transfer/internal-transfer-list","title":"\u67e5\u8a62\u5283\u8f49\u8a18\u9304(\u55ae\u5e33\u865f\u5167)","description":"\u67e5\u8a62\u5283\u8f49\u8a18\u9304\u5217\u8868","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-list":{"id":"v3/account-asset/transfer/subacct-list","title":"\u67e5\u8a62\u5b50\u8cec\u865f\u5217\u8868","description":"\u67e5\u8a62\u5b50\u8cec\u865f\u5217\u8868","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-transfer":{"id":"v3/account-asset/transfer/subacct-transfer","title":"\u5b50\u6bcd\u5283\u8f49","description":"\u89f8\u767c\u5b50\u6bcd\u5283\u8f49\u52d5\u4f5c","sidebar":"v3SideBar"},"v3/account-asset/transfer/subacct-transfer-list":{"id":"v3/account-asset/transfer/subacct-transfer-list","title":"\u67e5\u8a62\u5b50\u6bcd\u9593\u5283\u8f49\u8a18\u9304","description":"\u67e5\u8a62\u5b50\u6bcd\u5e33\u6236\u9593\u7684\u5283\u8f49\u8a18\u9304","sidebar":"v3SideBar"},"v3/account-asset/transfer/transferable-coin-list":{"id":"v3/account-asset/transfer/transferable-coin-list","title":"\u8cec\u865f\u5167\u53ef\u5283\u8f49\u5e63\u7a2e\u5217\u8868","description":"\u8cec\u865f\u5167\u53ef\u5283\u8f49\u5e63\u7a2e\u5217\u8868","sidebar":"v3SideBar"},"v3/account-asset/transfer/uni-transfer":{"id":"v3/account-asset/transfer/uni-transfer","title":"\u842c\u80fd\u5283\u8f49","description":"\u842c\u80fd\u5283\u8f49, \u60a8\u53ef\u4ee5\u9032\u884c\u5b50\u5e33\u6236\u4e4b\u9593\uff0c\u4ee5\u53ca\u6bcd\u5b50\u4e4b\u9593\u7684\u5283\u8f49","sidebar":"v3SideBar"},"v3/account-asset/transfer/uni-transfer-list":{"id":"v3/account-asset/transfer/uni-transfer-list","title":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u8a18\u9304","description":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u8a18\u9304","sidebar":"v3SideBar"},"v3/account-asset/user/apikey-info":{"id":"v3/account-asset/user/apikey-info","title":"\u67e5\u8a62API Key\u76f8\u95dc\u4fe1\u606f","description":"\u7372\u53d6API key\u7684\u76f8\u95dc\u4fe1\u606f\u3002\u4f7f\u7528\u5f85\u67e5\u8a62\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9069\u7528\u65bc\u6bcd\u3001\u5b50\u5e33\u6236\u7684api key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/create-subuid":{"id":"v3/account-asset/user/create-subuid","title":"\u65b0\u5efa\u5b50\u5e33\u6236","description":"\u5275\u5efa\u65b0\u7684\u5b50\u5e33\u6236\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/create-subuid-apikey":{"id":"v3/account-asset/user/create-subuid-apikey","title":"\u65b0\u5efa\u5b50\u5e33\u6236\u7684API Key","description":"\u7d66\u65b0\u5efa\u597d\u7684\u5b50\u5e33\u6236\u5275\u5efa\u65b0\u7684API key\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/froze-subuid":{"id":"v3/account-asset/user/froze-subuid","title":"\u51cd\u7d50/\u89e3\u51cd\u5b50\u5e33\u6236","description":"\u51cd\u7d50\u6216\u89e3\u51cd\u5b50\u5e33\u6236\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/modify-master-apikey":{"id":"v3/account-asset/user/modify-master-apikey","title":"\u4fee\u6539\u6bcd\u5e33\u6236\u7684API Key\u8a2d\u7f6e","description":"\u4fee\u6539\u6bcd\u5e33\u6236API key\u7684\u8a2d\u7f6e\u3002\u4f7f\u7528\u5f85\u4fee\u6539\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/modify-sub-apikey":{"id":"v3/account-asset/user/modify-sub-apikey","title":"\u4fee\u6539\u5b50\u5e33\u6236\u7684API Key\u8a2d\u7f6e","description":"\u4fee\u6539\u5b50\u5e33\u6236API key\u7684\u8a2d\u7f6e, \u652f\u6301\u6bcd\u5e33\u6236\u7ba1\u7406\u5b50\u5e33\u6236key\u7684\u8a2d\u7f6e, \u6216\u8005\u5b50\u5e33\u6236key\u76f4\u63a5\u4fee\u6539\u672c\u8eab\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/rm-master-apikey":{"id":"v3/account-asset/user/rm-master-apikey","title":"\u522a\u9664\u6bcd\u5e33\u6236\u7684API Key","description":"\u522a\u9664\u6bcd\u5e33\u6236\u4e0b\u7684api key\u3002\u4f7f\u7528\u5f85\u522a\u9664\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/rm-sub-apikey":{"id":"v3/account-asset/user/rm-sub-apikey","title":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684API Key","description":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684api key\u3002\u4f7f\u7528\u5f85\u522a\u9664\u7684\u5b50\u5e33\u6236api key\u8abf\u7528\u63a5\u53e3\u6216\u8005\u4f7f\u7528\u6bcd\u5e33\u6236\u8abf\u7528\u522a\u9664\u6307\u5b9aapi key","sidebar":"v3SideBar"},"v3/account-asset/user/subuid-list":{"id":"v3/account-asset/user/subuid-list","title":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868","description":"\u7372\u53d6\u7576\u524d\u6bcd\u5e33\u6236\u4e0b\u6240\u6709\u7684\u5b50\u5e33\u6236\u5217\u8868\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v3SideBar"},"v3/account-asset/user/wallet-type":{"id":"v3/account-asset/user/wallet-type","title":"\u67e5\u8a62\u5e33\u6236\u652f\u6301\u7684\u9322\u5305\u985e\u578b","description":"\u67e5\u8a62\u6bcd\u5e33\u6236\u6216\u8005\u5b50\u5e33\u6236\u4e0b\u652f\u6301\u7684\u9322\u5305\u985e\u578b","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/cancel-withdraw":{"id":"v3/account-asset/withdraw-deposit/cancel-withdraw","title":"\u64a4\u92b7\u63d0\u5e63","description":"\u64a4\u92b7\u63d0\u5e63","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/coin-info":{"id":"v3/account-asset/withdraw-deposit/coin-info","title":"\u67e5\u8a62\u5e63\u7a2e\u4fe1\u606f","description":"\u5e63\u7a2e\u4fe1\u606f\u67e5\u8a62","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/deplay-amount":{"id":"v3/account-asset/withdraw-deposit/deplay-amount","title":"\u67e5\u8a62\u5ef6\u9072\u63d0\u5e63\u51cd\u7d50\u91d1\u984d","description":"\u5982\u4f55\u6703\u5c0e\u81f4\u90e8\u5206\u8cc7\u91d1\u88ab\u8981\u6c42\u5ef6\u9072\u63d0\u5e63\uff1f","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/deposit-spec":{"id":"v3/account-asset/withdraw-deposit/deposit-spec","title":"\u67e5\u8a62\u5145\u503c\u76f8\u95dc\u7684\u898f\u683c","description":"\u67e5\u8a62\u5145\u503c\u76f8\u95dc\u7684\u898f\u683c\u4fe1\u606f","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/internal-deposit-record":{"id":"v3/account-asset/withdraw-deposit/internal-deposit-record","title":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u5e73\u53f0\u8f6c\u8d26)","description":"\u67e5\u8a62Bybit\u5e73\u53f0\u5167\u90e8\u5145\u503c\u7d00\u9304","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/master-deposit-addr":{"id":"v3/account-asset/withdraw-deposit/master-deposit-addr","title":"\u67e5\u8a62\u4e3b\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f","description":"\u4e3b\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f\u67e5\u8a62","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/master-deposit-record":{"id":"v3/account-asset/withdraw-deposit/master-deposit-record","title":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u93c8\u4e0a)","description":"\u5145\u503c\u8a18\u9304\u67e5\u8a62","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/set-deposit-acct":{"id":"v3/account-asset/withdraw-deposit/set-deposit-acct","title":"\u8a2d\u7f6e\u5145\u503c\u5e33\u6236","description":"\u8a2d\u7f6e\u5145\u503c\u5f8c\u7684\u81ea\u52d5\u8f49\u5165\u5e33\u6236\u985e\u578b\u3002\u8a72\u529f\u80fd\u8207\u7db2\u9801\u7aef-\u8a2d\u7f6e-\u5145\u503c\u4fdd\u6301\u4e00\u81f4\u3002","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/sub-deposit-addr":{"id":"v3/account-asset/withdraw-deposit/sub-deposit-addr","title":"\u67e5\u8a62\u5b50\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f","description":"\u5b50\u5e33\u6236\u5145\u503c\u5730\u5740\u4fe1\u606f\u67e5\u8a62","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/sub-deposit-record":{"id":"v3/account-asset/withdraw-deposit/sub-deposit-record","title":"\u67e5\u8a62\u5b50\u5e33\u6236\u5145\u503c (\u93c8\u4e0a)","description":"\u5b50\u5e33\u6236\u5145\u503c\u7d00\u9304","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/vasp-list":{"id":"v3/account-asset/withdraw-deposit/vasp-list","title":"\u67e5\u8a62\u4ea4\u6613\u6240\u5217\u8868","description":"\u8a72\u63a5\u53e3\u4e3b\u8981\u7528\u65bckyc=KOR\u7684\u97d3\u570b\u500b\u4eba\u7528\u6236, \u5728\u63d0\u73fe\u6642\u9700\u8981\u586b\u5beb\u63a5\u6536\u65b9\u4ea4\u6613\u6240\u4fe1\u606f","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/withdraw":{"id":"v3/account-asset/withdraw-deposit/withdraw","title":"\u63d0\u73fe","description":"\u82e5\u76ee\u6a19\u5730\u5740\u662fBybit\u5e73\u53f0\u5167\u90e8\u5730\u5740\uff0c\u60a8\u53ef\u4ee5\u5be6\u73fe\u5167\u90e8\u5e73\u53f0\u8f49\u5e33","sidebar":"v3SideBar"},"v3/account-asset/withdraw-deposit/withdraw-record":{"id":"v3/account-asset/withdraw-deposit/withdraw-record","title":"\u67e5\u8a62\u63d0\u73fe\u8a18\u9304","description":"\u63d0\u73fe\u8a18\u9304\u67e5\u8a62","sidebar":"v3SideBar"},"v3/copy-trade/enum":{"id":"v3/copy-trade/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"accountType"},"v3/copy-trade/error":{"id":"v3/copy-trade/error","title":"\u932f\u8aa4\u78bc","description":"|\u932f\u8aa4\u78bc |\u63cf\u8ff0 |"},"v3/copy-trade/rate-limit":{"id":"v3/copy-trade/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b"},"v3/copy-trade/rest-public/symbol-info":{"id":"v3/copy-trade/rest-public/symbol-info","title":"\u4ea4\u6613\u54e1\u7372\u53d6\u53ef\u5e36\u55ae\u5408\u7d04\u898f\u683c","description":"\u4ea4\u6613\u54e1\u7372\u53d6\u53ef\u5e36\u55ae\u5408\u7d04\u7684\u898f\u683c"},"v3/copy-trade/rest-trade/account/transfer":{"id":"v3/copy-trade/rest-trade/account/transfer","title":"\u4ea4\u6613\u54e1\u5283\u8f49\u8cc7\u91d1","description":"\u4ea4\u6613\u54e1\u5283\u8f49\u8cc7\u91d1"},"v3/copy-trade/rest-trade/account/transfer-list":{"id":"v3/copy-trade/rest-trade/account/transfer-list","title":"\u67e5\u8a62\u5283\u8f49\u7d00\u9304","description":"\u67e5\u8a62\u5e36\u55ae\u9322\u5305\u7684\u5283\u8f49\u7d00\u9304"},"v3/copy-trade/rest-trade/account/wallet":{"id":"v3/copy-trade/rest-trade/account/wallet","title":"\u4ea4\u6613\u54e1\u7372\u53d6\u9322\u5305\u4f59\u984d","description":"\u4ea4\u6613\u54e1\u7372\u53d6\u8ddf\u55ae\u5e33\u6236\u7684\u9322\u5305\u4f59\u984d"},"v3/copy-trade/rest-trade/order/cancel-order":{"id":"v3/copy-trade/rest-trade/order/cancel-order","title":"\u4ea4\u6613\u54e1\u53d6\u6d88\u8a02\u55ae","description":"\u4ea4\u6613\u54e1\u53d6\u6d88\u8a02\u55ae"},"v3/copy-trade/rest-trade/order/close-order":{"id":"v3/copy-trade/rest-trade/order/close-order","title":"\u4ea4\u6613\u54e1\u767c\u8d77\u5e73\u5009-\u8a02\u55ae","description":"\u4ea4\u6613\u54e1\u767c\u8d77\u5e73\u5009-\u8a02\u55ae"},"v3/copy-trade/rest-trade/order/order-list":{"id":"v3/copy-trade/rest-trade/order/order-list","title":"\u67e5\u8a62\u4ea4\u6613\u54e1\u6b77\u53f2\u5e36\u55ae\u8a02\u55ae","description":"\u67e5\u8a62\u4ea4\u6613\u54e1\u5e36\u55ae\u8a02\u55ae"},"v3/copy-trade/rest-trade/order/place-order":{"id":"v3/copy-trade/rest-trade/order/place-order","title":"\u4ea4\u6613\u54e1\u5275\u5efa\u8a02\u55ae","description":"\u4ea4\u6613\u54e1\u5275\u5efa\u8a02\u55ae"},"v3/copy-trade/rest-trade/order/set-trading-stop":{"id":"v3/copy-trade/rest-trade/order/set-trading-stop","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","description":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d"},"v3/copy-trade/rest-trade/position/close-position":{"id":"v3/copy-trade/rest-trade/position/close-position","title":"\u4ea4\u6613\u54e1\u4e00\u9375\u5e73\u5009","description":"HTTP \u8acb\u6c42"},"v3/copy-trade/rest-trade/position/execution":{"id":"v3/copy-trade/rest-trade/position/execution","title":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304 (\u5169\u5e74)","description":"\u7372\u53d6\u7528\u6236\u6210\u4ea4\u7d00\u9304\uff0c\u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217"},"v3/copy-trade/rest-trade/position/position-info":{"id":"v3/copy-trade/rest-trade/position/position-info","title":"\u4ea4\u6613\u54e1\u5e36\u55ae\u5009\u4f4d\u532f\u7e3d","description":"\u4ea4\u6613\u54e1\u5e36\u55ae\u5009\u4f4d\u532f\u7e3d"},"v3/copy-trade/rest-trade/position/set-leverage":{"id":"v3/copy-trade/rest-trade/position/set-leverage","title":"\u4ea4\u6613\u54e1\u8a2d\u7f6e\u5e36\u55ae\u69d3\u687f","description":"\u4ea4\u6613\u54e1\u8a2d\u7f6e\u5e36\u55ae\u69d3\u687f, \u8a2d\u7f6e\u69d3\u687f\u53ea\u80fd\u8a2d\u7f6e\u6574\u6578"},"v3/copy-trade/wss-authentication":{"id":"v3/copy-trade/wss-authentication","title":"\u8a02\u95b1WebSocket","description":"\u8acb\u6ce8\u610f\uff0c\u76ee\u524dcopytrading\u53ea\u652f\u6301\u6b63\u5411\u6c38\u7e8c\uff0c\u4ee5\u4e0b\u63a5\u53e3\u50c5\u9069\u7528\u65bc \u6b63\u5411\u6c38\u7e8c"},"v3/copy-trade/wss-private/execution":{"id":"v3/copy-trade/wss-private/execution","title":"\u6210\u4ea4","description":"Topic:"},"v3/copy-trade/wss-private/order":{"id":"v3/copy-trade/wss-private/order","title":"\u8a02\u55ae","description":"Topic:"},"v3/copy-trade/wss-private/position":{"id":"v3/copy-trade/wss-private/position","title":"\u6301\u5009","description":"Topic:"},"v3/copy-trade/wss-private/wallet":{"id":"v3/copy-trade/wss-private/wallet","title":"\u9322\u5305","description":"Topic:"},"v3/copy-trade/wss-public/kline":{"id":"v3/copy-trade/wss-public/kline","title":"K\u7dda","description":"\u8a02\u95b1K\u7dda\u6578\u64da"},"v3/copy-trade/wss-public/liquidation":{"id":"v3/copy-trade/wss-public/liquidation","title":"\u5f37\u5e73\u63a8\u9001","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u7684\u671f\u8ca8\u5f37\u5e73\u63a8\u9001"},"v3/copy-trade/wss-public/orderbook":{"id":"v3/copy-trade/wss-public/orderbook","title":"\u6df1\u5ea6","description":"\u8a02\u95b1\u4e0d\u540c\u6df1\u5ea6\u7684\u63a8\u9001"},"v3/copy-trade/wss-public/tickers":{"id":"v3/copy-trade/wss-public/tickers","title":"\u884c\u60c5","description":"\u8a02\u95b1\u884c\u60c5\u6578\u64da"},"v3/copy-trade/wss-public/trade":{"id":"v3/copy-trade/wss-public/trade","title":"\u5e73\u53f0\u6210\u4ea4","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u6700\u8fd1\u6210\u4ea4\u7684\u63a8\u9001. \u5f9e\u7528\u6236\u8a02\u95b1\u958b\u59cb, \u5be6\u6642\u63a8\u9001\u589e\u91cf\u4ea4\u6613\u6b77\u53f2, \u6709\u6210\u4ea4\u6578\u64da\u5c31\u63a8\u9001."},"v3/derivatives/enum":{"id":"v3/derivatives/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"category","sidebar":"v3SideBar"},"v3/derivatives/error":{"id":"v3/derivatives/error","title":"\u932f\u8aa4\u78bc","description":"\u7d71\u4e00\u4fdd\u8b49\u91d1","sidebar":"v3SideBar"},"v3/derivatives/rate-limit":{"id":"v3/derivatives/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/trading-fee":{"id":"v3/derivatives/rest-contract/account/trading-fee","title":"\u67e5\u8a62\u4ea4\u6613\u8cbb\u7387","description":"\u7372\u53d6\u7528\u6236\u7684\u4ea4\u6613\u624b\u7e8c\u8cbb\u7387","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/wallet-balance":{"id":"v3/derivatives/rest-contract/account/wallet-balance","title":"\u9322\u5305\u9918\u984d","description":"\u7372\u53d6\u9322\u5305\u9918\u984d\u4fe1\u606f\uff0c\u5305\u62ec\u884d\u751f\u54c1\u5e33\u6236\u548cUSDC\u5e33\u6236","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/account/wallet-fund-record":{"id":"v3/derivatives/rest-contract/account/wallet-fund-record","title":"\u67e5\u8a62\u9322\u5305\u8cc7\u91d1\u7d00\u9304","description":"\u7372\u53d6\u9322\u5305\u8cc7\u91d1\u7d00\u9304. \u9019\u500b\u63a5\u53e3\u9084\u5c55\u793a\u4f86\u81ea\u7db2\u9801\u4e0a\u8cc7\u7522\u514c\u63db\u4e0b\u7684\u514c\u63db\u7d00\u9304, \u5176\u4e2d\u5c0d\u61c9\u7684type\u514c\u63db\u985e\u578b\u662fExchangeOrderWithdraw\u548cExchangeOrderDeposit\u3002","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/cancel-all":{"id":"v3/derivatives/rest-contract/order/cancel-all","title":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","description":"\u64a4\u92b7\u5168\u90e8\u59d4\u8a17\u55ae","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/cancel-order":{"id":"v3/derivatives/rest-contract/order/cancel-order","title":"\u64a4\u92b7\u59d4\u8a17\u55ae","description":"* \u60a8\u5fc5\u9808\u6307\u5b9aorderId\u6216\u8005orderLinkId.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/open-order":{"id":"v3/derivatives/rest-contract/order/open-order","title":"\u67e5\u8a62\u5be6\u6642\u59d4\u8a17\u55ae","description":"\u5be6\u6642\u67e5\u8a62\u672a\u6210\u4ea4\u6216\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u4fe1\u606f. \u82e5\u9700\u8981\u67e5\u8a62\u66f4\u4e45\u7684\u8a02\u55ae\u7d00\u9304\uff0c\u8acb\u4f7f\u7528\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae\u63a5\u53e3.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/order-list":{"id":"v3/derivatives/rest-contract/order/order-list","title":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae","description":"\u7372\u53d6\u6b77\u53f2\u8a02\u55ae\u7d00\u9304. \u7531\u65bc\u8a02\u55ae\u5275\u5efa/\u64a4\u92b7\u662f\u7570\u6b65\u7684, \u8a72\u63a5\u53e3\u8fd4\u56de\u6578\u64da\u53ef\u80fd\u6703\u6709\u5ef6\u9072. \u82e5\u60a8\u60f3\u5be6\u6642\u7372\u53d6\u8a02\u55ae\u4fe1\u606f, \u60a8\u53ef\u4ee5\u67e5\u8a62\u8a72\u63a5\u53e3\u6216\u8005\u901a\u904ewebsocket\u63a8\u9001(\u63a8\u85a6)","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/place-order":{"id":"v3/derivatives/rest-contract/order/place-order","title":"\u5275\u5efa\u59d4\u8a17\u55ae","description":"- \u5e02\u50f9\u55ae: \u4e00\u500b\u50b3\u7d71\u7684\u5e02\u5834\u50f9\u683c\u8a02\u55ae,","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/order/replace-order":{"id":"v3/derivatives/rest-contract/order/replace-order","title":"\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u60a8\u53ea\u80fd\u4fee\u6539\u90a3\u4e9b\u672a\u6210\u4ea4\u6216\u8005\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u3002","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/auto-margin":{"id":"v3/derivatives/rest-contract/position/auto-margin","title":"\u8a2d\u7f6e\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1","description":"\u958b\u95dc\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1. \u6b32\u4e86\u89e3\u66f4\u591a\uff0c\u8acb\u53c3\u95b1\u9019\u88e1","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/close-pnl":{"id":"v3/derivatives/rest-contract/position/close-pnl","title":"\u67e5\u8a62\u5e73\u5009\u76c8\u8667","description":"\u7372\u53d6\u7576\u524d\u7528\u6236\u7684\u6240\u6709\u5e73\u5009\u76c8\u8667\u6578\u64da\uff0c\u8fd4\u56de\u7d50\u679c\u6309\u7167updatedTime\u964d\u5e8f\u6392\u5217.","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/confirm-mmr":{"id":"v3/derivatives/rest-contract/position/confirm-mmr","title":"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d","description":"\u50c5\u9069\u7528\u65bc\u7576\u7528\u6236\u88ab\u6a19\u8a18\u70ba\u50c5\u6e1b\u5009\u6642(\u8acb\u770b\u6301\u5009\u63a5\u53e3\u4e2d\u7684isReduceOnly\u5b57\u6bb5), \u5728\u7528\u6236\u4e3b\u52d5\u8abf\u6574\u98a8\u96aa\u6c34\u4f4d\u5f8c, \u8abf\u7528\u8a72\u63a5\u53e3\u4f86\u8a66\u7b97\u8abf\u6574\u5f8c\u7684\u98a8","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/cross-isolated-margin":{"id":"v3/derivatives/rest-contract/position/cross-isolated-margin","title":"\u5207\u63db\u5168\u5009/\u9010\u5009","description":"\u5207\u63db\u5168\u5009/\u9010\u5009\u6a21\u5f0f. \u6b32\u4e86\u89e3\u66f4\u591a\uff0c\u8acb\u53c3\u95b1\u9019\u88e1","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/execution":{"id":"v3/derivatives/rest-contract/position/execution","title":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304","description":"\u7372\u53d6\u7528\u6236\u6210\u4ea4\u7d00\u9304\uff0c\u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/leverage":{"id":"v3/derivatives/rest-contract/position/leverage","title":"\u8a2d\u7f6e\u69d3\u687f\u500d\u6578","description":"\u8a2d\u7f6e\u69d3\u687f","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/position-info":{"id":"v3/derivatives/rest-contract/position/position-info","title":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/position-mode":{"id":"v3/derivatives/rest-contract/position/position-mode","title":"\u5207\u63db\u5009\u4f4d\u6a21\u5f0f","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u5207\u63dbUSDT\u6c38\u7e8c\u548c\u53cd\u5411\u4ea4\u5272\u7684\u5009\u4f4d\u6a21\u5f0f\u3002\u55ae\u5009\u6a21\u5f0f\u4e0b\uff0c\u53ea\u80fd\u5728\u55ae\u65b9\u5411\u4e0b\u6301\u5009; \u96d9\u5009\u6a21\u5f0f\u4e0b\uff0c\u53ef\u4ee5\u540c\u6642\u5728\u5169\u500b\u65b9\u5411\u6301\u5009\u3002","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/set-risk-limit":{"id":"v3/derivatives/rest-contract/position/set-risk-limit","title":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d","description":"\u7531\u65bcBybit\u57282024\u5e743\u670812\u65e5\u4e0a\u7dda\u4e86\u81ea\u52d5\u8abf\u6574risk limit\u529f\u80fd, \u8a73\u60c5\u8acb\u898b\u9019\u88e1, \u56e0\u6b64\u5118\u7ba1\u63a5\u53e3\u80fd\u8abf\u901a, \u4f46\u662f\u6c92\u6709\u4efb\u4f55\u610f\u7fa9","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/tpsl-mode":{"id":"v3/derivatives/rest-contract/position/tpsl-mode","title":"\u5207\u63db\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","description":"\u67d0\u7a2e\u7a0b\u5ea6\u4e0a\u4f86\u8aaa\uff0c\u8a72\u63a5\u53e3\u5df2\u7d93**\u5ee2\u68c4**, \u539f\u56e0\u5728\u65bc\u65b0\u7248\u7684\u6b62\u76c8\u6b62\u640d\u6a5f\u5236\u662f\u57fa\u65bc\u8a02\u55ae\u7dad\u5ea6. \u9019\u500b\u63a5\u53e3\u7576\u521d\u4e3b\u8981\u662f\u7528\u65bc\u5009\u4f4d\u7dad\u5ea6\u7684\u6b62\u76c8\u6b62\u640d","sidebar":"v3SideBar"},"v3/derivatives/rest-contract/position/trading-stop":{"id":"v3/derivatives/rest-contract/position/trading-stop","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u8a2d\u7f6e\u6b62\u76c8\u3001\u6b62\u640d\u548c\u8ffd\u8e64\u6b62\u640d.","sidebar":"v3SideBar"},"v3/derivatives/rest-public/delivery-price":{"id":"v3/derivatives/rest-public/delivery-price","title":"\u67e5\u8a62\u671f\u6b0a\u4ea4\u5272\u50f9\u683c","description":"\u67e5\u8a62\u5e73\u53f0\u4ea4\u5272\u7522\u54c1\u7684\u4ea4\u5272\u50f9\u683c\uff0c\u76ee\u524d\u50c5\u652f\u6301\u671f\u6b0a","sidebar":"v3SideBar"},"v3/derivatives/rest-public/fund-rate-history":{"id":"v3/derivatives/rest-public/fund-rate-history","title":"\u67e5\u8a62\u6b77\u53f2\u8cc7\u91d1\u8cbb\u7387","description":"\u67e5\u8a62\u8cc7\u91d1\u8cbb\u7387\uff0c\u6bcf\u500bsymbol\u7684\u8cc7\u91d1\u8cbb\u7387\u7522\u751f\u9031\u671f\u4e0d\u540c\u3002\u5047\u8a2d\u8cc7\u91d1\u8cbb\u7387\u70ba8\u5c0f\u6642\uff0c\u7576\u524d\u6642\u9593\u662fUTC12\u9ede\uff0c\u5247\u8fd4\u56de\u7684\u662f\u4e0a\u4e00\u500b\u7d50\u7b97\u5373UTC8\u9ede\u7522\u751f\u7684\u8cc7\u91d1\u8cbb\u7387\u3002","sidebar":"v3SideBar"},"v3/derivatives/rest-public/index-kline":{"id":"v3/derivatives/rest-public/index-kline","title":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda","sidebar":"v3SideBar"},"v3/derivatives/rest-public/instrument-info":{"id":"v3/derivatives/rest-public/instrument-info","title":"\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u898f\u683c\u4fe1\u606f","description":"\u67e5\u8a62\u5168\u7ad9\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u57fa\u790e\u914d\u7f6e\u898f\u5247\u4fe1\u606f","sidebar":"v3SideBar"},"v3/derivatives/rest-public/kline":{"id":"v3/derivatives/rest-public/kline","title":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/rest-public/long-short-ratio":{"id":"v3/derivatives/rest-public/long-short-ratio","title":"\u67e5\u8a62\u591a\u7a7a\u6bd4","description":"HTTP\u8acb\u6c42","sidebar":"v3SideBar"},"v3/derivatives/rest-public/mark-kline":{"id":"v3/derivatives/rest-public/mark-kline","title":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda","sidebar":"v3SideBar"},"v3/derivatives/rest-public/open-interest":{"id":"v3/derivatives/rest-public/open-interest","title":"\u67e5\u8a62\u672a\u5e73\u5009\u5408\u7d04\u6301\u5009\u6578\u91cf","description":"\u67e5\u8a62\u5404\u500b\u5408\u7d04\u5e02\u5834\u5167\u6240\u6709\u672a\u5e73\u5009\u7684\u6578\u91cf","sidebar":"v3SideBar"},"v3/derivatives/rest-public/orderbook":{"id":"v3/derivatives/rest-public/orderbook","title":"Order Book (\u6df1\u5ea6)","description":"\u7372\u53d6\u6df1\u5ea6\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/rest-public/premium-index-kline":{"id":"v3/derivatives/rest-public/premium-index-kline","title":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/rest-public/public-trade":{"id":"v3/derivatives/rest-public/public-trade","title":"\u67e5\u8a62\u5e73\u53f0\u6210\u4ea4\u6b77\u53f2","description":"\u7372\u53d6\u5e73\u53f0\u6700\u8fd1\u6210\u4ea4\u6578\u64da. \u60a8\u53ef\u4ee5\u5f9e\u9019\u88e1\u4e0b\u8f09\u5230\u6b78\u6a94\u7684\u66f4\u591a\u7684\u6b77\u53f2\u6210\u4ea4\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/rest-public/risk-limit":{"id":"v3/derivatives/rest-public/risk-limit","title":"\u67e5\u8a62\u5408\u7d04\u98a8\u96aa\u9650\u984d","description":"\u67e5\u8a62\u671f\u8ca8\u5408\u7d04\u7684\u98a8\u96aa\u9650\u984d\u8868","sidebar":"v3SideBar"},"v3/derivatives/rest-public/ticker-info":{"id":"v3/derivatives/rest-public/ticker-info","title":"\u67e5\u8a62\u6700\u65b0\u884c\u60c5\u4fe1\u606f","description":"\u53ef\u7372\u53d6\u5230\u5feb\u7167\u7684\u6700\u65b0\u5e02\u5834\u50f9\u683c\uff0c\u6700\u4f73\u8cb7\u8ce3\u50f9\u683c\uff0c\u4ee5\u53ca\u904e\u53bb\u6642\u9593\u5167\u7684\u4ea4\u6613\u91cf\u7b49.","sidebar":"v3SideBar"},"v3/derivatives/rest-unified/account/account-info":{"id":"v3/derivatives/rest-unified/account/account-info","title":"\u67e5\u8a62\u5e33\u6236\u914d\u7f6e","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u67e5\u8a62\u8cec\u6236\u4e0b\u7684\u914d\u7f6e"},"v3/derivatives/rest-unified/account/borrow-history":{"id":"v3/derivatives/rest-unified/account/borrow-history","title":"\u67e5\u8a62\u5229\u606f\u8a18\u9304","description":"\u7372\u53d6\u5229\u606f\u8a18\u9304\uff0c\u6309\u7167\u5275\u5efa\u6642\u9593\u5012\u6558\u6392\u5217\u3002"},"v3/derivatives/rest-unified/account/borrow-rate":{"id":"v3/derivatives/rest-unified/account/borrow-rate","title":"\u501f\u8cb8\u5229\u7387\u67e5\u8a62","description":"HTTP \u8acb\u6c42"},"v3/derivatives/rest-unified/account/dcp":{"id":"v3/derivatives/rest-unified/account/dcp","title":"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593","description":"\u4ec0\u9ebc\u662f\u65b7\u7dda\u4fdd\u8b77 (Disconnection Protect)?"},"v3/derivatives/rest-unified/account/exchange":{"id":"v3/derivatives/rest-unified/account/exchange","title":"\u67e5\u8a62\u5e63\u5e63\u514c\u63db\u7d00\u9304\u67e5\u8a62","description":"\u7372\u53d6\u5e63\u5e63\u514c\u63db\u7d00\u9304"},"v3/derivatives/rest-unified/account/get-dcp":{"id":"v3/derivatives/rest-unified/account/get-dcp","title":"\u67e5\u8a62\u65b7\u7dda\u4fdd\u8b77\u914d\u7f6e","description":"HTTP\u8acb\u6c42"},"v3/derivatives/rest-unified/account/get-mmp-state":{"id":"v3/derivatives/rest-unified/account/get-mmp-state","title":"\u67e5\u8a62\u5e02\u5546\u4fdd\u8b77\u914d\u7f6e\u4fe1\u606f","description":"HTTP \u8acb\u6c42"},"v3/derivatives/rest-unified/account/reset-mmp":{"id":"v3/derivatives/rest-unified/account/reset-mmp","title":"\u91cd\u7f6e\u5e02\u5546\u4fdd\u8b77\u51cd\u7d50","description":"\u4e00\u65e6mmp\u88ab\u89f8\u767c, \u60a8\u7684\u5e33\u6236\u53ef\u4ee5\u8abf\u7528\u8a72\u63a5\u53e3\u9032\u884c\u4e3b\u52d5\u89e3\u51cd\u3002"},"v3/derivatives/rest-unified/account/set-margin-mode":{"id":"v3/derivatives/rest-unified/account/set-margin-mode","title":"\u8a2d\u7f6e\u4fdd\u8b49\u91d1\u6a21\u5f0f","description":"\u7528\u6236\u5982\u679c\u4e0d\u8a2d\u7f6e\uff0c\u9ed8\u8a8d\u6309\u5e38\u898f\u4fdd\u8b49\u91d1\u3002\u8a72\u6a21\u5f0f\u652f\u6301USDT\u6c38\u7e8c, USDC\u6c38\u7e8c\u548c\u671f\u6b0a"},"v3/derivatives/rest-unified/account/set-mmp":{"id":"v3/derivatives/rest-unified/account/set-mmp","title":"\u8bbe\u7f6e\u5e02\u5546\u4fdd\u8b77","description":"\u4ec0\u9ebc\u662fMMP?"},"v3/derivatives/rest-unified/account/transaction-log":{"id":"v3/derivatives/rest-unified/account/transaction-log","title":"\u67e5\u8a62\u4ea4\u6613\u65e5\u8a8c","description":"UNIFIED\u8cec\u6236\u7684\u4ea4\u6613\u65e5\u8a8c\u3002"},"v3/derivatives/rest-unified/account/upgrade-unified-account":{"id":"v3/derivatives/rest-unified/account/upgrade-unified-account","title":"\u5347\u7d1a\u81f3\u7d71\u4e00\u4fdd\u8b49\u91d1\u5e33\u6236","description":"\u5347\u7d1a\u81f3\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236"},"v3/derivatives/rest-unified/account/wallet-balance":{"id":"v3/derivatives/rest-unified/account/wallet-balance","title":"\u7372\u53d6\u9322\u5305\u9918\u984d","description":"\u7372\u53d6\u9322\u5305\u9918\u984d"},"v3/derivatives/rest-unified/order/batch-cancel":{"id":"v3/derivatives/rest-unified/order/batch-cancel","title":"\u6279\u91cf\u64a4\u92b7\u59d4\u8a17\u55ae","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u6279\u91cf\u64a4\u92b7\u591a\u7b46\u8a02\u55ae"},"v3/derivatives/rest-unified/order/batch-place":{"id":"v3/derivatives/rest-unified/order/batch-place","title":"\u6279\u91cf\u5275\u5efa\u59d4\u8a17\u55ae","description":"\u8a72\u63a5\u53e3\u652f\u6301\u6279\u91cf\u5275\u5efa\u59d4\u8a17\u55ae"},"v3/derivatives/rest-unified/order/batch-replace":{"id":"v3/derivatives/rest-unified/order/batch-replace","title":"\u6279\u91cf\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u8a72\u63a5\u53e3\u652f\u6301\u6279\u91cf\u4fee\u6539\u59d4\u8a17\u55ae"},"v3/derivatives/rest-unified/order/cancel-all":{"id":"v3/derivatives/rest-unified/order/cancel-all","title":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","description":"\u64a4\u92b7\u5168\u90e8\u59d4\u8a17\u55ae"},"v3/derivatives/rest-unified/order/cancel-order":{"id":"v3/derivatives/rest-unified/order/cancel-order","title":"\u64a4\u92b7\u59d4\u8a17\u55ae","description":"* \u60a8\u5fc5\u9808\u6307\u5b9aorderId\u6216\u8005orderLinkId."},"v3/derivatives/rest-unified/order/open-order":{"id":"v3/derivatives/rest-unified/order/open-order","title":"\u67e5\u8a62\u5be6\u6642\u59d4\u8a17\u55ae","description":"\u5be6\u6642\u67e5\u8a62\u672a\u6210\u4ea4\u6216\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u4fe1\u606f. \u82e5\u9700\u8981\u67e5\u8a62\u66f4\u4e45\u7684\u8a02\u55ae\u7d00\u9304\uff0c\u8acb\u4f7f\u7528\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae\u63a5\u53e3."},"v3/derivatives/rest-unified/order/order-list":{"id":"v3/derivatives/rest-unified/order/order-list","title":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae","description":"\u7372\u53d6\u6b77\u53f2\u8a02\u55ae\u7d00\u9304. \u7531\u65bc\u8a02\u55ae\u5275\u5efa/\u64a4\u92b7\u662f\u7570\u6b65\u7684, \u8a72\u63a5\u53e3\u8fd4\u56de\u6578\u64da\u53ef\u80fd\u6703\u6709\u5ef6\u9072. \u82e5\u60a8\u60f3\u5be6\u6642\u7372\u53d6\u8a02\u55ae\u4fe1\u606f, \u60a8\u53ef\u4ee5\u67e5\u8a62\u8a72\u63a5\u53e3\u6216\u8005\u901a\u904ewebsocket\u63a8\u9001(\u63a8\u85a6)"},"v3/derivatives/rest-unified/order/place-order":{"id":"v3/derivatives/rest-unified/order/place-order","title":"\u5275\u5efa\u59d4\u8a17\u55ae","description":"- \u5e02\u50f9\u55ae: \u4e00\u500b\u50b3\u7d71\u7684\u5e02\u5834\u50f9\u683c\u8a02\u55ae,"},"v3/derivatives/rest-unified/order/replace-order":{"id":"v3/derivatives/rest-unified/order/replace-order","title":"\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u60a8\u53ea\u80fd\u4fee\u6539\u90a3\u4e9b\u672a\u6210\u4ea4\u6216\u8005\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u3002"},"v3/derivatives/rest-unified/position/execution-list":{"id":"v3/derivatives/rest-unified/position/execution-list","title":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304 (\u534a\u5e74)","description":"\u7372\u53d6\u7528\u6236\u6210\u4ea4\u7d00\u9304\uff0c\u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217"},"v3/derivatives/rest-unified/position/full-partial-tpsl":{"id":"v3/derivatives/rest-unified/position/full-partial-tpsl","title":"\u5207\u63db\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","description":"\u53ef\u4ee5\u5c07\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f\u8a2d\u7f6e\u70ba\u90e8\u5206\u6b62\u76c8\u6b62\u640d\u6216\u8005\u5168\u90e8\u6b62\u76c8\u6b62\u640d"},"v3/derivatives/rest-unified/position/leverage":{"id":"v3/derivatives/rest-unified/position/leverage","title":"\u8a2d\u7f6e\u69d3\u687f\u500d\u6578","description":"\u8a2d\u7f6e\u69d3\u687f\u500d\u6578"},"v3/derivatives/rest-unified/position/option-delivery":{"id":"v3/derivatives/rest-unified/position/option-delivery","title":"\u67e5\u8a62\u4ea4\u5272\u7d00\u9304 (\u671f\u6b0a)","description":"\u67e5\u8a62\u671f\u6b0a\u4ea4\u5272\u7d00\u9304, \u8fd4\u56de\u7d50\u679c\u6309\u7167deliveryTime\u964d\u5e8f\u6392\u5217"},"v3/derivatives/rest-unified/position/position-info":{"id":"v3/derivatives/rest-unified/position/position-info","title":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49"},"v3/derivatives/rest-unified/position/set-risk-limit":{"id":"v3/derivatives/rest-unified/position/set-risk-limit","title":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d","description":"\u98a8\u96aa\u9650\u984d\u6703\u9650\u5236\u4f60\u5728\u4e0d\u540c\u7684\u4fdd\u8b49\u91d1\u8981\u6c42\u4e0b\u7684\u53ef\u6301\u5009\u7684\u6700\u5927\u5009\u4f4d\u6578\u91cf\uff0c\u5982\u679c\u8981\u6301\u6709\u66f4\u591a\u7684\u5009\u4f4d\uff0c\u9700\u8981\u66f4\u591a\u7684\u4fdd\u8b49\u91d1\u8981\u6c42\u3002\u672c\u63a5\u53e3\u53ef\u4ee5\u8a2d\u7f6e\u55ae\u500b\u5009\u4f4d\u7684\u98a8\u96aa\u9650\u984d\uff0c"},"v3/derivatives/rest-unified/position/trading-stop":{"id":"v3/derivatives/rest-unified/position/trading-stop","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u8a2d\u7f6e\u6b62\u76c8\u3001\u6b62\u640d\u548c\u8ffd\u8e64\u6b62\u640d"},"v3/derivatives/rest-unified/position/usdc-settlement":{"id":"v3/derivatives/rest-unified/position/usdc-settlement","title":"\u67e5\u8a62\u7d50\u7b97\u7d00\u9304 (USDC\u6c38\u7e8c)","description":"\u67e5\u8a62USDC\u6c38\u7e8c\u7684\u7d50\u7b97\u7d00\u9304"},"v3/derivatives/wss-authentication":{"id":"v3/derivatives/wss-authentication","title":"\u8a02\u95b1WebSocket","description":"\u8a02\u95b1\u5730\u5740:","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/execution":{"id":"v3/derivatives/wss-contract/execution","title":"\u500b\u4eba\u6210\u4ea4","description":"\u8a02\u95b1\u500b\u4eba\u6210\u4ea4\u7684\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/order":{"id":"v3/derivatives/wss-contract/order","title":"\u8a02\u55ae","description":"\u8a02\u95b1\u8a02\u55ae\u6578\u64da\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/position":{"id":"v3/derivatives/wss-contract/position","title":"\u6301\u5009","description":"\u8a02\u95b1\u6301\u5009\u6578\u64da\u7684\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-contract/wallet":{"id":"v3/derivatives/wss-contract/wallet","title":"\u9322\u5305","description":"\u8a02\u95b1\u9322\u5305\u6578\u64da\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-public/kline":{"id":"v3/derivatives/wss-public/kline","title":"K\u7dda","description":"\u8a02\u95b1K\u7dda\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/wss-public/liquidation":{"id":"v3/derivatives/wss-public/liquidation","title":"\u5f37\u5e73\u63a8\u9001","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u7684\u671f\u8ca8\u5f37\u5e73\u63a8\u9001, symbol\u7ef4\u5ea6\u6700\u591a1\u79d2\u63a8\u4e00\u6761\u7206\u4ed3\u6570\u636e","sidebar":"v3SideBar"},"v3/derivatives/wss-public/orderbook":{"id":"v3/derivatives/wss-public/orderbook","title":"\u6df1\u5ea6","description":"\u8a02\u95b1\u4e0d\u540c\u6df1\u5ea6\u7684\u63a8\u9001","sidebar":"v3SideBar"},"v3/derivatives/wss-public/tickers":{"id":"v3/derivatives/wss-public/tickers","title":"\u884c\u60c5","description":"\u8a02\u95b1\u884c\u60c5\u6578\u64da","sidebar":"v3SideBar"},"v3/derivatives/wss-public/trade":{"id":"v3/derivatives/wss-public/trade","title":"\u5e73\u53f0\u6210\u4ea4","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u6700\u8fd1\u6210\u4ea4\u7684\u63a8\u9001. \u5f9e\u7528\u6236\u8a02\u95b1\u958b\u59cb, \u5be6\u6642\u63a8\u9001\u589e\u91cf\u4ea4\u6613\u6b77\u53f2, \u6709\u6210\u4ea4\u6578\u64da\u5c31\u63a8\u9001.","sidebar":"v3SideBar"},"v3/derivatives/wss-unified/execution":{"id":"v3/derivatives/wss-unified/execution","title":"\u500b\u4eba\u6210\u4ea4","description":"\u8a02\u95b1\u500b\u4eba\u6210\u4ea4\u7684\u63a8\u9001"},"v3/derivatives/wss-unified/greek":{"id":"v3/derivatives/wss-unified/greek","title":"\u7528\u6236\u5e0c\u81d8\u5b57\u6bcd\u4fe1\u606f (\u671f\u6b0a)","description":"\u8a02\u95b1\u5e0c\u81d8\u5b57\u6bcd\u4fe1\u606f\uff0c\u50c5\u671f\u6b0a"},"v3/derivatives/wss-unified/order":{"id":"v3/derivatives/wss-unified/order","title":"\u8a02\u55ae","description":"\u8a02\u95b1\u8a02\u55ae\u6578\u64da\u63a8\u9001"},"v3/derivatives/wss-unified/position":{"id":"v3/derivatives/wss-unified/position","title":"\u6301\u5009","description":"\u8a02\u95b1\u6301\u5009\u6578\u64da\u7684\u63a8\u9001\u3002\u7576\u5009\u4f4d\u6709\u8b8a\u52d5\u6642\uff0c\u5373\u63a8\u9001\u6d88\u606f\u3002"},"v3/derivatives/wss-unified/wallet":{"id":"v3/derivatives/wss-unified/wallet","title":"\u9322\u5305","description":"\u8a02\u95b1\u9322\u5305\u6578\u64da\u63a8\u9001"},"v3/intro":{"id":"v3/intro","title":"\u6982\u89bd","description":"Bybit V3 Open API \u80fd\u7d66\u8b93\u7528\u6236\u57fa\u65bc\u4e0d\u540c\u7684\u7522\u54c1\u69cb\u5efaAPI\u6a21\u578b\u3002","sidebar":"v3SideBar"},"v3/server-time":{"id":"v3/server-time","title":"Bybit\u670d\u52d9\u5668\u6642\u9593","description":"\u7372\u53d6Bybit\u670d\u52d9\u5668\u6642\u9593","sidebar":"v3SideBar"},"v3/smp":{"id":"v3/smp","title":"\u81ea\u6210\u4ea4\u6514\u622a","description":"\u4ec0\u9ebc\u662f\u81ea\u6210\u4ea4\uff1f","sidebar":"v3SideBar"},"v3/spot/enum":{"id":"v3/spot/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"side","sidebar":"v3SideBar"},"v3/spot/error":{"id":"v3/spot/error","title":"\u932f\u8aa4\u78bc","description":"|\u932f\u8aa4\u78bc |\u63cf\u8ff0 |","sidebar":"v3SideBar"},"v3/spot/rate-limit":{"id":"v3/spot/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b","sidebar":"v3SideBar"},"v3/spot/rest-etp/asset-info":{"id":"v3/spot/rest-etp/asset-info","title":"LT \u5168\u91cf\u8cc7\u7522\u57fa\u790e\u4fe1\u606f\u67e5\u8a62","description":"\u9019\u662f\u500b\u516c\u5171\u63a5\u53e3\uff0c\u7121\u9700\u9452\u6b0a\u3002","sidebar":"v3SideBar"},"v3/spot/rest-etp/market-info":{"id":"v3/spot/rest-etp/market-info","title":"LT \u884c\u60c5\u67e5\u8a62","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-etp/purchase":{"id":"v3/spot/rest-etp/purchase","title":"\u7533\u8cfc","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-etp/purchase-redeem-history":{"id":"v3/spot/rest-etp/purchase-redeem-history","title":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-etp/redeem":{"id":"v3/spot/rest-etp/redeem","title":"\u8d16\u56de","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/loan-info":{"id":"v3/spot/rest-institution-loan/loan-info","title":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u4fe1\u606f","description":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u7684\u8a73\u60c5","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/ltv":{"id":"v3/spot/rest-institution-loan/ltv","title":"\u67e5\u8a62\u98a8\u96aa\u7387","description":"\u82e5\u8a72\u63a5\u53e3\u8fd4\u56de\u7a7a\u6578\u64da\uff0c\u8acb\u524d\u5f80\u8a72\u63a5\u53e3\u67e5\u8a62LTV","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/margin-coin-info":{"id":"v3/spot/rest-institution-loan/margin-coin-info","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"\u9019\u662f\u516c\u5171\u63a5\u53e3\uff0c\u7121\u9700\u9452\u6b0a\u3002","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/margin-product-info":{"id":"v3/spot/rest-institution-loan/margin-product-info","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u7522\u54c1\u4fe1\u606f","description":"\u9019\u662f\u516c\u5171\u63a5\u53e3\uff0c\u7121\u9700\u9452\u6b0a\u3002","sidebar":"v3SideBar"},"v3/spot/rest-institution-loan/repay-info":{"id":"v3/spot/rest-institution-loan/repay-info","title":"\u67e5\u8a62\u9084\u6b3e\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-public/best-bid-ask":{"id":"v3/spot/rest-public/best-bid-ask","title":"\u6700\u4f73\u8cb7\u8ce3\u50f9","description":"\u5982\u679csymbol\u6c92\u6709\u88ab\u767c\u9001\uff0c\u6240\u6709symbol\u7684\u6700\u4f73\u8a02\u55ae\u7c3f\u50f9\u683c\u90fd\u6703\u88ab\u8fd4\u56de\u3002","sidebar":"v3SideBar"},"v3/spot/rest-public/instrument-info":{"id":"v3/spot/rest-public/instrument-info","title":"\u67e5\u8a62\u6240\u6709\u4ea4\u6613\u5c0d","description":"\u7372\u53d6\u6240\u6709\u4ea4\u6613\u5c0d","sidebar":"v3SideBar"},"v3/spot/rest-public/kline":{"id":"v3/spot/rest-public/kline","title":"\u67e5\u8a62K\u7dda\u6578\u64da","description":"\u8fd4\u56de\u6307\u5b9a\u7684\u6642\u9593\u9593\u9694\u6700\u8fd11000\u6839\u7684K\u7dda\u7d50\u679c","sidebar":"v3SideBar"},"v3/spot/rest-public/last-trade-price":{"id":"v3/spot/rest-public/last-trade-price","title":"Symbol\u6700\u65b0\u50f9","description":"\u5982\u679csymbol\u6c92\u6709\u88ab\u767c\u9001\uff0c\u6240\u6709symbol\u7684\u50f9\u683c\u90fd\u6703\u88ab\u8fd4\u56de","sidebar":"v3SideBar"},"v3/spot/rest-public/merge-orderbook":{"id":"v3/spot/rest-public/merge-orderbook","title":"\u5408\u4e26\u8a02\u55ae\u7c3f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-public/orderbook":{"id":"v3/spot/rest-public/orderbook","title":"\u8a02\u55ae\u7c3f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-public/public-trade":{"id":"v3/spot/rest-public/public-trade","title":"\u5e73\u81fa\u4ea4\u6613\u6b77\u53f2\u6578\u64da","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-public/ticker-info":{"id":"v3/spot/rest-public/ticker-info","title":"\u6700\u65b0\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/account-info":{"id":"v3/spot/rest-spot-margin/account-info","title":"\u67e5\u8a62\u501f\u8cb8\u5e33\u6236\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrow":{"id":"v3/spot/rest-spot-margin/borrow","title":"\u501f\u6b3e","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrow-info":{"id":"v3/spot/rest-spot-margin/borrow-info","title":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/borrowable-data":{"id":"v3/spot/rest-spot-margin/borrowable-data","title":"\u67e5\u8a62\u53ef\u501f\u5e63\u7a2e\u7cbe\u5ea6","description":"\u9019\u662f\u500b\u516c\u544a\u63a5\u53e3\uff0c\u4e0d\u9700\u8981\u9452\u6b0a","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/interest-quota":{"id":"v3/spot/rest-spot-margin/interest-quota","title":"\u67e5\u8a62\u5229\u7387\u53ca\u984d\u5ea6","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/margin-data":{"id":"v3/spot/rest-spot-margin/margin-data","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"\u9019\u662f\u500b\u516c\u5171\u63a5\u53e3\uff0c\u4e0d\u9700\u8981\u9452\u6b0a","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/repay":{"id":"v3/spot/rest-spot-margin/repay","title":"\u9084\u6b3e","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/repay-history":{"id":"v3/spot/rest-spot-margin/repay-history","title":"\u67e5\u8a62\u9084\u6b3e\u8a02\u55ae\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot-margin/switch-mode":{"id":"v3/spot/rest-spot-margin/switch-mode","title":"\u5168\u5009\u69d3\u687f\u958b\u95dc","description":"\u958b\u555f\u6216\u95dc\u9589\u5168\u5009\u69d3\u687f\u4ea4\u6613","sidebar":"v3SideBar"},"v3/spot/rest-spot/batch-cancel":{"id":"v3/spot/rest-spot/batch-cancel","title":"\u6279\u91cf\u64a4\u92b7\u8a02\u55ae","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/batch-cancel-by-id":{"id":"v3/spot/rest-spot/batch-cancel-by-id","title":"\u6839\u64da\u8a02\u55ae\u865f\u6279\u91cf\u64a4\u92b7\u8a02\u55ae","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/cancel-order":{"id":"v3/spot/rest-spot/cancel-order","title":"\u64a4\u92b7\u6d3b\u52d5\u59d4\u6258\u55ae","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/get-order":{"id":"v3/spot/rest-spot/get-order","title":"\u67e5\u8a62\u6d3b\u52d5\u59d4\u6258","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/open-order":{"id":"v3/spot/rest-spot/open-order","title":"\u8a02\u55ae\u5217\u8868","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/rest-spot/order-history":{"id":"v3/spot/rest-spot/order-history","title":"\u6b77\u53f2\u8a02\u55ae","description":"- \u5982\u679cstartTime\u548cendTime\u90fd\u4e0d\u50b3\uff0c\u5247\u9ed8\u8a8d\u67e5\u8a62\u8fd17\u5929\u7684\u6578\u64da\u3002","sidebar":"v3SideBar"},"v3/spot/rest-spot/place-order":{"id":"v3/spot/rest-spot/place-order","title":"\u5275\u5efa\u6d3b\u52d5\u59d4\u6258\u55ae","description":"\u666e\u901a\u55ae\u548c\u6b62\u76c8\u6b62\u640d\u55ae\u7684orderLinkId\u4e0d\u80fd\u91cd\u8907","sidebar":"v3SideBar"},"v3/spot/rest-spot/trade-history":{"id":"v3/spot/rest-spot/trade-history","title":"\u4ea4\u6613\u8a18\u9304","description":"* \u5982\u679c\u4e0d\u50b3startTime\uff0c\u53ea\u80fd\u67e5\u8a62\u6700\u8fd17\u5929\u7684\u4ea4\u6613\u6578\u64da\u3002\u5982\u679c\u8981\u67e5\u8a62\u4e00\u5468\u4e4b\u524d\u7684\u6b77\u53f2\u4ea4\u6613\u6578\u64da\uff0c\u9700\u8981\u50b3startTime","sidebar":"v3SideBar"},"v3/spot/wallet":{"id":"v3/spot/wallet","title":"\u67e5\u8a62\u9322\u5305\u4f59\u984d","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/spot/wss-authentication":{"id":"v3/spot/wss-authentication","title":"\u8a02\u95b1WebSocket","description":"\u4ee5\u4e0bWSS\u5730\u5740\u50c5\u9069\u7528\u73fe\u8ca8. \u8981\u60f3\u63a5\u6536\u671f\u8ca8\u7684\u63a8\u9001\uff0c\u8acb\u524d\u5f80:","sidebar":"v3SideBar"},"v3/spot/wss-private/order":{"id":"v3/spot/wss-private/order","title":"\u8a02\u55ae","description":"\u8a72\u8a02\u95b1\u7528\u65bc\u63a8\u9001\u8a02\u55ae\u4fe1\u606f\uff0c\u5176\u4e2d \u6210\u4ea4\u5747\u50f9 = Z / z","sidebar":"v3SideBar"},"v3/spot/wss-private/outbound-account-info":{"id":"v3/spot/wss-private/outbound-account-info","title":"\u9322\u5305","description":"\u8a72\u8a02\u95b1\u7528\u65bc\u63a8\u9001\u73fe\u8ca8\u9322\u5305\u4fe1\u606f","sidebar":"v3SideBar"},"v3/spot/wss-private/stop-order":{"id":"v3/spot/wss-private/stop-order","title":"\u6b62\u76c8\u6b62\u640d\u8a02\u55ae","description":"\u8a72\u8a02\u95b1\u63a8\u9001web/app\u4e0b\u7684\u689d\u4ef6\u548c\u6b62\u76c8\u6b62\u640d\u8a02\u55ae\u4fe1\u606f, \u6216\u8005\u662fopenAPI\u4e0b\u7684\u6b62\u76c8\u6b62\u640d\u8a02\u55ae\u4fe1\u606f\u63a8\u9001\u3002\u53ea\u8981\u8a02\u55ae\u72c0\u614b\u767c\u751f\u6539\u8b8a\uff0c\u5c31\u6703\u63a8\u9001\u6d88\u606f\u3002","sidebar":"v3SideBar"},"v3/spot/wss-private/ticket-info":{"id":"v3/spot/wss-private/ticket-info","title":"\u500b\u4eba\u6210\u4ea4","description":"\u8a72\u8a02\u95b1\u63a8\u9001\u6210\u4ea4\u4fe1\u606f","sidebar":"v3SideBar"},"v3/spot/wss-public/bookticker":{"id":"v3/spot/wss-public/bookticker","title":"\u8cb7\u4e00\u8ce3\u4e00","description":"\u6700\u512a\u8cb7\u4e00\u8ce3\u4e00\u50f9","sidebar":"v3SideBar"},"v3/spot/wss-public/kline":{"id":"v3/spot/wss-public/kline","title":"K\u7dda","description":"\u8a02\u95b1K\u7dda\u6578\u64da\u63a8\u9001, \u8acb\u5728\u9019\u88e1\u67e5\u95b1\u671f\u671b\u8a02\u95b1\u7684\u7c92\u5ea6","sidebar":"v3SideBar"},"v3/spot/wss-public/orderbook":{"id":"v3/spot/wss-public/orderbook","title":"\u6df1\u5ea6","description":"\u4ea4\u6613\u5c0d\u7684\u6df1\u5ea6\u4fe1\u606f:","sidebar":"v3SideBar"},"v3/spot/wss-public/tickers":{"id":"v3/spot/wss-public/tickers","title":"\u884c\u60c5","description":"\u4ea4\u6613\u5c0d\u768424\u5c0f\u6642\u7d71\u8a08\u6578\u64da","sidebar":"v3SideBar"},"v3/spot/wss-public/trade":{"id":"v3/spot/wss-public/trade","title":"\u5e73\u81fa\u6210\u4ea4","description":"\u9010\u7b46\u4ea4\u6613\u63a8\u9001\u6bcf\u4e00\u7b46\u6210\u4ea4\u7684\u4fe1\u606f\u3002\u6210\u4ea4\uff0c\u6216\u8005\u8aaa\u4ea4\u6613\u7684\u5b9a\u7fa9\u662f\u50c5\u6709\u4e00\u500b\u5403\u55ae\u8005\u8207\u4e00\u500b\u639b\u55ae\u8005\u76f8\u4e92\u4ea4\u6613\u3002","sidebar":"v3SideBar"},"v3/tax/data-explain":{"id":"v3/tax/data-explain","title":"\u6578\u64da\u8aaa\u660e","description":"\u4ea4\u6613\u6b77\u53f2","sidebar":"v3SideBar"},"v3/tax/data-export":{"id":"v3/tax/data-export","title":"\u6578\u64da\u5c0e\u51fa","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/tax/enum":{"id":"v3/tax/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"ReportType","sidebar":"v3SideBar"},"v3/tax/register-time":{"id":"v3/tax/register-time","title":"\u67e5\u8a62\u7279\u5b9a\u7528\u6236\u5728\u5e73\u53f0\u8a3b\u518a\u65e5\u671f","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/tax/report-status":{"id":"v3/tax/report-status","title":"\u67e5\u8a62\u5831\u544a\u5c0e\u51fa\u72c0\u614b","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v3/tax/request-report":{"id":"v3/tax/request-report","title":"\u5275\u5efa\u5c0e\u51fa\u5831\u544a\u8acb\u6c42","description":"HTTP \u8acb\u6c42","sidebar":"v3SideBar"},"v5/abandon/account-info":{"id":"v5/abandon/account-info","title":"\u67e5\u8a62\u4f59\u5e63\u5bf6\u5e33\u6236\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/abandon/cancel-redeem":{"id":"v5/abandon/cancel-redeem","title":"\u64a4\u92b7\u8d16\u56de","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/abandon/coin-info":{"id":"v5/abandon/coin-info","title":"\u67e5\u8a62\u53ef\u5b58\u5165\u5e63\u7a2e\u4fe1\u606f","description":"\u67e5\u8a62\u53ef\u5b58\u5165\u5e63\u7a2e\u7684\u57fa\u672c\u4fe1\u606f","sidebar":"v5SideBar"},"v5/abandon/deposit":{"id":"v5/abandon/deposit","title":"\u5b58\u5165\u8cc7\u91d1","description":"- \u7d93\u5178\u5e33\u6236&UMA\u5e33\u6236: \u8cc7\u91d1\u662f\u5f9e\u73fe\u8ca8\u9322\u5305\u6263\u9664","sidebar":"v5SideBar"},"v5/abandon/earning":{"id":"v5/abandon/earning","title":"\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63","description":"\u8a72\u63a5\u53e3\u5df2\u7d93\u5ee2\u68c4, \u8acb\u4f7f\u7528\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63\u4fe1\u606f","sidebar":"v5SideBar"},"v5/abandon/enable-unitransfer-subuid":{"id":"v5/abandon/enable-unitransfer-subuid","title":"\u914d\u7f6e\u4e92\u76f8\u5283\u8f49\u7684\u5b50\u5e33\u865f","description":"\u7121\u9700\u518d\u914d\u7f6e\u53ef\u5283\u8f49\u7684\u5b50\u5e33\u865f, \u8a72\u9650\u5236\u5df2\u79fb\u9664, \u9ed8\u8a8d\u4efb\u610f\u5b50\u5e33\u865f\u4e4b\u9593\u53ef\u4ee5\u5283\u8f49","sidebar":"v5SideBar"},"v5/abandon/ltv":{"id":"v5/abandon/ltv","title":"\u67e5\u8a62\u98a8\u96aa\u7387","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/abandon/margin-coin-info":{"id":"v5/abandon/margin-coin-info","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"\u9019\u662f\u516c\u5171\u63a5\u53e3\uff0c\u7121\u9700\u9452\u6b0a\u3002","sidebar":"v5SideBar"},"v5/abandon/order-record":{"id":"v5/abandon/order-record","title":"\u67e5\u8a62\u8a02\u55ae\u6b77\u53f2","description":"\u67e5\u8a62\u5b58\u5165/\u8d16\u56de/\u6536\u76ca\u767c\u653e\u7684\u8a02\u55ae\u6b77\u53f2","sidebar":"v5SideBar"},"v5/abandon/redeem":{"id":"v5/abandon/redeem","title":"\u8d16\u56de\u8cc7\u91d1","description":"\u5728\u8d16\u56de\u672c\u91d1\u6642\uff0c\u7cfb\u7d71\u9084\u6703\u81ea\u52d5\u8d16\u56de\u7576\u524d\u7684\u6536\u76ca\u3002","sidebar":"v5SideBar"},"v5/account/account-info":{"id":"v5/account/account-info","title":"\u67e5\u8a62\u8cec\u6236\u914d\u7f6e","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u67e5\u8a62\u8cec\u6236\u4e0b\u7684\u914d\u7f6e","sidebar":"v5SideBar"},"v5/account/batch-set-collateral":{"id":"v5/account/batch-set-collateral","title":"\u6279\u91cf\u8a2d\u7f6e\u62b5\u62bc\u54c1\u5e63\u7a2e","description":"\u7528\u6236\u53ef\u4ee5\u6279\u91cf\u958b\u555f\u6216\u95dc\u9589\u7d71\u4e00\u5e33\u6236\u4e2d\u5e63\u7a2e\u62b5\u62bc\u5c6c\u6027\uff0c\u9ed8\u8a8d\u90fd\u662f\u95dc\u9589\u7684","sidebar":"v5SideBar"},"v5/account/borrow-history":{"id":"v5/account/borrow-history","title":"\u67e5\u8a62\u5229\u606f\u8a18\u9304","description":"\u7372\u53d6\u5229\u606f\u8a18\u9304\uff0c\u6309\u7167\u5275\u5efa\u6642\u9593\u5012\u6558\u6392\u5217\u3002","sidebar":"v5SideBar"},"v5/account/coin-greeks":{"id":"v5/account/coin-greeks","title":"\u67e5\u8a62Greeks\u4fe1\u606f","description":"\u7372\u53d6\u7576\u524d\u8cec\u6236Greeks\u4fe1\u606f","sidebar":"v5SideBar"},"v5/account/collateral-info":{"id":"v5/account/collateral-info","title":"\u67e5\u8a62\u62b5\u62bc\u54c1\u4fe1\u606f","description":"\u7372\u53d6\u7576\u524d\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236\u7684\u62b5\u62bc\u54c1\u4fe1\u606f\uff0c\u5305\u62ec\u501f\u8cb8\u5229\u7387\uff0c\u53ef\u85c9\u8cb8\u91d1\u984d\u4ee5\u53ca\u62b5\u62bc\u54c1\u6298\u7b97\u7387\uff0c\u662f\u5426\u53ef\u62b5\u62bc\u4f5c\u70ba\u4fdd\u8b49\u91d1\u7b49\u4fe1\u606f\u3002","sidebar":"v5SideBar"},"v5/account/contract-transaction-log":{"id":"v5/account/contract-transaction-log","title":"\u4ea4\u6613\u65e5\u8a8c","description":"\u652f\u6301\u67e5\u8a62\u7d93\u5178\u5e33\u6236\u4e0b\u5408\u7d04\u9322\u5305, \u4ee5\u53ca\u7d71\u4e00\u5e33\u6236\u4e0b\u53cd\u5411\u5408\u7d04\u9322\u5305\u88e1\u7684\u4ea4\u6613\u65e5\u8a8c","sidebar":"v5SideBar"},"v5/account/dcp-info":{"id":"v5/account/dcp-info","title":"\u67e5\u8a62DCP\u914d\u7f6e","description":"\u67e5\u8a62\u5e33\u6236\u7684\u5408\u7d04(USDT\u6c38\u7e8c, USDC\u6c38\u7e8c\u548cUSDC\u4ea4\u5272) / \u73fe\u8ca8 / \u671f\u6b0a\u7684dcp\u914d\u7f6e. \u5728\u8abf\u7528\u63a5\u53e3\u524d, \u8acb\u78ba\u4fdd\u5df2\u7d93\u548c\u5ba2\u6236\u7d93\u7406\u7533\u8acb\u4e86\u5e33\u6236DCP\u958b\u901a","sidebar":"v5SideBar"},"v5/account/fee-rate":{"id":"v5/account/fee-rate","title":"\u67e5\u8a62\u624b\u7e8c\u8cbb\u7387","description":"\u67e5\u8a62\u4ea4\u6613\u624b\u7e8c\u8cbb\u7387\u3002","sidebar":"v5SideBar"},"v5/account/get-mmp-state":{"id":"v5/account/get-mmp-state","title":"\u67e5\u8a62\u5e02\u5546\u4fdd\u8b77\u914d\u7f6e\u4fe1\u606f","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/account/repay-liability":{"id":"v5/account/repay-liability","title":"\u4e00\u9375\u9084\u6b3e","description":"\u60a8\u53ef\u4ee5\u901a\u904e\u8a72\u63a5\u53e3\u624b\u52d5\u9084\u6e05\u7d71\u4e00\u5e33\u6236\u4e2d\u7684\u501f\u6b3e","sidebar":"v5SideBar"},"v5/account/reset-mmp":{"id":"v5/account/reset-mmp","title":"\u91cd\u7f6e\u5e02\u5546\u4fdd\u8b77\u51cd\u7d50","description":"* \u4e00\u65e6mmp\u88ab\u89f8\u767c, \u60a8\u7684\u5e33\u6236\u53ef\u4ee5\u8abf\u7528\u8a72\u63a5\u53e3\u9032\u884c\u4e3b\u52d5\u89e3\u51cd, \u89e3\u51cd\u5f8c, qtyLimit\u548cdeltaLimit\u5c31\u91cd\u7f6e\u70ba0.","sidebar":"v5SideBar"},"v5/account/set-collateral":{"id":"v5/account/set-collateral","title":"\u8a2d\u7f6e\u62b5\u62bc\u54c1\u5e63\u7a2e","description":"\u7528\u6236\u53ef\u4ee5\u81ea\u884c\u6c7a\u5b9a\u662f\u5426\u958b\u555f\u7d71\u4e00\u5e33\u6236\u4e2d\u5e63\u7a2e\u662f\u5426\u9032\u884c\u62b5\u62bc\uff0c\u9ed8\u8a8d\u90fd\u662f\u95dc\u9589\u7684","sidebar":"v5SideBar"},"v5/account/set-margin-mode":{"id":"v5/account/set-margin-mode","title":"\u8a2d\u7f6e\u4fdd\u8b49\u91d1\u6a21\u5f0f(\u5e33\u6236)","description":"\u7528\u6236\u5982\u679c\u4e0d\u8a2d\u7f6e\uff0c\u9ed8\u8a8d\u6309\u5168\u5009\u4fdd\u8b49\u91d1","sidebar":"v5SideBar"},"v5/account/set-mmp":{"id":"v5/account/set-mmp","title":"\u8bbe\u7f6e\u5e02\u5546\u4fdd\u8b77","description":"\u4ec0\u9ebc\u662fMMP?","sidebar":"v5SideBar"},"v5/account/set-spot-hedge":{"id":"v5/account/set-spot-hedge","title":"\u8a2d\u7f6e\u73fe\u8ca8\u5c0d\u885d","description":"\u60a8\u53ef\u4ee5\u958b\u95dc\u73fe\u8ca8\u5c0d\u5f9e\u529f\u80fd, \u50c5\u9650\u7d71\u4e00\u5e33\u6236\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f\u4e0b","sidebar":"v5SideBar"},"v5/account/smp-group":{"id":"v5/account/smp-group","title":"\u67e5\u8a62SMP\u7d44ID","description":"\u67e5\u8a62\u81ea\u6210\u4ea4\u6514\u622a\u7684SMP\u4ea4\u6613\u7fa4\u7d44ID","sidebar":"v5SideBar"},"v5/account/transaction-log":{"id":"v5/account/transaction-log","title":"\u4ea4\u6613\u65e5\u8a8c","description":"\u6574\u500b\u8cec\u6236\u7d71\u4e00\u9322\u5305\u88e1\u7684\u4ea4\u6613\u65e5\u8a8c, \u652f\u6301\u6700\u591a\u67e5\u8a62\u904e\u53bb2\u5e74\u7684\u6578\u64da","sidebar":"v5SideBar"},"v5/account/upgrade-unified-account":{"id":"v5/account/upgrade-unified-account","title":"\u5347\u7d1a\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236","description":"\u5347\u7d1a\u7d71\u4e00\u4fdd\u8b49\u91d1\u8cec\u6236","sidebar":"v5SideBar"},"v5/account/wallet-balance":{"id":"v5/account/wallet-balance","title":"\u67e5\u8a62\u9322\u5305\u9918\u984d","description":"\u7372\u53d6\u7d71\u4e00\u5e33\u6236\u548c\u7d93\u5178\u5e33\u6236\u9322\u5305\u9918\u984d, \u67e5\u8a62\u5404\u500b\u5e63\u7a2e\u7684\u8cc7\u7522\u4fe1\u606f\uff0c\u4ee5\u53ca\u7d71\u4e00\u4fdd\u8b49\u91d1\u6a21\u5f0f\u4e0b\u7684\u5e33\u6236\u98a8\u96aa\u7387\u4fe1\u606f\u3002\u9ed8\u8a8d\u4e0d\u8fd4\u56de\u8cc7\u7522\u6216\u8ca0\u50b5\u70ba0\u7684\u5e63\u7a2e\u4fe1\u606f\u3002","sidebar":"v5SideBar"},"v5/announcement":{"id":"v5/announcement","title":"\u67e5\u8a62\u516c\u544a","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/asset/balance/account-coin-balance":{"id":"v5/asset/balance/account-coin-balance","title":"\u67e5\u8a62\u5e33\u6236\u55ae\u500b\u5e63\u7a2e\u9918\u984d","description":"\u7372\u53d6\u67d0\u5e33\u6236\u985e\u578b\u4e0b\u67d0\u6307\u5b9a\u5e63\u7a2e\u7684\u9918\u984d\u3002\u652f\u6301\u901a\u904e\u8f38\u5165\u5b50\u5e33\u6236id\u4f86\u67e5\u8a62\u5b50\u5e33\u6236\u7684\u67d0\u500b\u5e33\u6236\u985e\u578b\u4e0b\u7684\u67d0\u500b\u5e63\u7a2e\u9918\u984d","sidebar":"v5SideBar"},"v5/asset/balance/all-balance":{"id":"v5/asset/balance/all-balance","title":"\u67e5\u8a62\u8cec\u6236\u6240\u6709\u5e63\u7a2e\u4f59\u984d","description":"\u652f\u6301\u67e5\u8a62\u6bcd\u5e33\u6236\u7684\u5404\u500b\u5e33\u6236\u985e\u578b\u7684\u5e63\u7a2e\u9918\u984d\uff0c\u4ee5\u53ca\u6bcd\u5e33\u6236\u4e0b\u5404\u5b50\u5e33\u6236\u7684\u5404\u500b\u5e33\u6236\u985e\u578b\u7684\u5e63\u7a2e\u9918\u984d\u3002","sidebar":"v5SideBar"},"v5/asset/balance/asset-info":{"id":"v5/asset/balance/asset-info","title":"\u67e5\u8a62\u8cc7\u7522\u4fe1\u606f","description":"\u7576\u524d\u53ea\u80fd\u67e5\u8a62\u73fe\u8ca8\u5e33\u6236\u4e2d\u7684\u8cc7\u7522","sidebar":"v5SideBar"},"v5/asset/balance/delay-amount":{"id":"v5/asset/balance/delay-amount","title":"\u67e5\u8a62\u5ef6\u9072\u63d0\u5e63\u51cd\u7d50\u91d1\u984d","description":"\u5982\u4f55\u6703\u5c0e\u81f4\u90e8\u5206\u8cc7\u91d1\u88ab\u8981\u6c42\u5ef6\u9072\u63d0\u5e63\uff1f","sidebar":"v5SideBar"},"v5/asset/coin-info":{"id":"v5/asset/coin-info","title":"\u67e5\u8a62\u5e63\u7a2e\u4fe1\u606f","description":"\u7372\u53d6\u5e63\u7a2e\u4fe1\u606f\uff0c\u5305\u62ec\u93c8\u4fe1\u606f\uff0c\u662f\u5426\u53ef\u5145\u53ef\u63d0","sidebar":"v5SideBar"},"v5/asset/convert/apply-quote":{"id":"v5/asset/convert/apply-quote","title":"\u7533\u8acb\u5831\u50f9","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/asset/convert/confirm-quote":{"id":"v5/asset/convert/confirm-quote","title":"\u78ba\u8a8d\u5831\u50f9","description":"1. \u8a72\u63a5\u53e3\u662f\u7570\u6b65\u7684, \u8acb\u901a\u904e\u67e5\u8a62\u8acb\u6c42\u78ba\u8a8d\u6700\u7d42\u514c\u63db\u7d50\u679c","sidebar":"v5SideBar"},"v5/asset/convert/convert-coin-list":{"id":"v5/asset/convert/convert-coin-list","title":"\u67e5\u8a62\u514c\u63db\u5e63\u7a2e\u5217\u8868","description":"\u60a8\u53ef\u4ee5\u901a\u904e\u8a72\u63a5\u53e3\u7372\u53d6\u5230\u5404\u500b\u5e33\u6236\u5167\u7684\u514c\u5165\u514c\u51fa\u5e63\u7a2e\u5217\u8868","sidebar":"v5SideBar"},"v5/asset/convert/get-convert-history":{"id":"v5/asset/convert/get-convert-history","title":"\u67e5\u8a62\u514c\u63db\u6b77\u53f2","description":"\u90a3\u4e9b\u88ab\u78ba\u8a8d\u7684\u5831\u50f9\u55ae, \u4e0d\u7ba1\u6700\u7d42\u72c0\u614b\u5982\u4f55, \u8a72\u63a5\u53e3\u90fd\u6703\u8fd4\u56de","sidebar":"v5SideBar"},"v5/asset/convert/get-convert-result":{"id":"v5/asset/convert/get-convert-result","title":"\u67e5\u8a62\u5831\u50f9\u55ae\u72c0\u614b","description":"* \u60a8\u53ef\u4ee5\u901a\u904equoteTxId\u6307\u5b9a\u67e5\u8a62\u67d0\u7b46\u88ab\u78ba\u8a8d\u7684\u5831\u50f9\u55ae","sidebar":"v5SideBar"},"v5/asset/convert/guideline":{"id":"v5/asset/convert/guideline","title":"\u9583\u514c\u63a5\u5165\u6307\u5357","description":"* \u6240\u6709\u63a5\u53e3\u90fd\u9700\u8981\u9032\u884c\u9452\u6b0a","sidebar":"v5SideBar"},"v5/asset/delivery":{"id":"v5/asset/delivery","title":"\u67e5\u8a62\u4ea4\u5272\u7d00\u9304","description":"\u67e5\u8a62USDC\u4ea4\u5272\u548c\u671f\u6b0a\u7684\u4ea4\u5272\u7d00\u9304, \u8fd4\u56de\u7d50\u679c\u6309\u7167deliveryTime\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/asset/deposit/deposit-coin-spec":{"id":"v5/asset/deposit/deposit-coin-spec","title":"\u67e5\u8a62\u652f\u6301\u7684\u5145\u503c\u5e63\u7a2e\u4fe1\u606f","description":"\u901a\u904e\u5e63\u7a2e\u4fe1\u606f\u63a5\u53e3\uff0c\u7372\u53d6\u5e63\u93c8\u7d44\u5408","sidebar":"v5SideBar"},"v5/asset/deposit/deposit-record":{"id":"v5/asset/deposit/deposit-record","title":"\u67e5\u8a62\u5145\u503c\u7d00\u9304 (\u93c8\u4e0a)","description":"* endTime - startTime\u9700\u8981\u5c0f\u65bc\u7b49\u65bc30\u5929\uff0c\u9ed8\u8a8d\u67e5\u8a62\u6700\u8fd130\u5929\u7684\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/deposit/internal-deposit-record":{"id":"v5/asset/deposit/internal-deposit-record","title":"\u67e5\u8a62\u5145\u503c\u8a18\u9304 (\u5e73\u53f0\u8f6c\u8d26)","description":"\u67e5\u8a62Bybit\u5e73\u53f0\u5167\u90e8\u5145\u503c\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/deposit/master-deposit-addr":{"id":"v5/asset/deposit/master-deposit-addr","title":"\u67e5\u8a62\u4e3b\u5e33\u865f\u5145\u503c\u5730\u5740","description":"\u50c5\u652f\u6301\u6bcd\u5e33\u865fAPI key","sidebar":"v5SideBar"},"v5/asset/deposit/set-deposit-acct":{"id":"v5/asset/deposit/set-deposit-acct","title":"\u8a2d\u7f6e\u5145\u503c\u5e33\u6236","description":"\u8a2d\u7f6e\u5145\u503c\u5f8c\u7684\u81ea\u52d5\u8f49\u5165\u5e33\u6236\u985e\u578b\u3002\u8a72\u529f\u80fd\u8207\u7db2\u9801\u7aef-\u8a2d\u7f6e-\u5145\u503c\u4fdd\u6301\u4e00\u81f4\u3002","sidebar":"v5SideBar"},"v5/asset/deposit/sub-deposit-addr":{"id":"v5/asset/deposit/sub-deposit-addr","title":"\u67e5\u8a62\u5b50\u5e33\u865f\u5145\u503c\u5730\u5740","description":"\u50c5\u80fd\u4f7f\u7528\u8a72\u6bcd\u5e33\u865f\u7684API key","sidebar":"v5SideBar"},"v5/asset/deposit/sub-deposit-record":{"id":"v5/asset/deposit/sub-deposit-record","title":"\u67e5\u8a62\u5b50\u5e33\u865f\u7684\u5145\u503c\u7d00\u9304 (\u93c8\u4e0a)","description":"\u50c5\u80fd\u901a\u904e\u4e3b\u5e33\u865f\u7684API key\u4f86\u67e5\u8a62\u5b50\u5e33\u865f\u7684\u5145\u503c\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/exchange":{"id":"v5/asset/exchange","title":"\u67e5\u8a62\u514c\u63db\u8a02\u55ae\u7d00\u9304","description":"\u60a8\u53ef\u80fd\u6703\u906d\u9047\u8f03\u9577\u7684\u6578\u64da\u8fd4\u56de\u5ef6\u9072","sidebar":"v5SideBar"},"v5/asset/settlement":{"id":"v5/asset/settlement","title":"\u67e5\u8a62USDC\u7d50\u7b97\u7d00\u9304","description":"\u67e5\u8a62USDC\u6c38\u7e8c\u7684\u7d50\u7b97\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/sub-uid-list":{"id":"v5/asset/sub-uid-list","title":"\u67e5\u8a62\u5b50\u5e33\u865f\u5217\u8868","description":"\u67e5\u8a62\u67d0\u500b\u6bcd\u5e33\u6236\u7684\u5b50\u5e33\u865f\u5217\u8868, \u8fd4\u56de\u81f3\u591a2000\u500b\u5b50\u5e33\u6236, \u5982\u679c\u60a8\u6709\u66f4\u591a, \u53ef\u4ee5\u8abf\u7528\u9019\u500b\u63a5\u53e3.","sidebar":"v5SideBar"},"v5/asset/transfer/create-inter-transfer":{"id":"v5/asset/transfer/create-inter-transfer","title":"\u5283\u8f49 (\u55ae\u5e33\u865f\u5167)","description":"\u5275\u5efa\u55ae\u5e33\u865f\u4e0b\u5e33\u6236\u985e\u578b\u9593\u7684\u5283\u8f49\u64cd\u4f5c","sidebar":"v5SideBar"},"v5/asset/transfer/inter-transfer-list":{"id":"v5/asset/transfer/inter-transfer-list","title":"\u67e5\u8a62\u5283\u8f49\u7d00\u9304 (\u55ae\u5e33\u865f\u5167)","description":"\u7372\u53d6\u55ae\u5e33\u865f\u5167\u7684\u5283\u8f49\u7d00\u9304","sidebar":"v5SideBar"},"v5/asset/transfer/transferable-coin":{"id":"v5/asset/transfer/transferable-coin","title":"\u5e33\u6236\u985e\u578b\u9593\u53ef\u5283\u8f49\u7684\u5e63\u7a2e","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/asset/transfer/unitransfer":{"id":"v5/asset/transfer/unitransfer","title":"\u5275\u5efa\u842c\u80fd\u5283\u8f49","description":"\u652f\u6301\u5b50\u5b50\u5e33\u6236\u9593\u5283\u8f49\u6216\u6bcd\u5b50\u5e33\u865f\u9593\u5283\u8f49\u3002","sidebar":"v5SideBar"},"v5/asset/transfer/unitransfer-list":{"id":"v5/asset/transfer/unitransfer-list","title":"\u67e5\u8a62\u842c\u80fd\u5283\u8f49\u7d00\u9304","description":"* \u6bcd\u5b50\u5e33\u865f\u7684api key\u90fd\u652f\u6301\u8abf\u7528","sidebar":"v5SideBar"},"v5/asset/withdraw/cancel-withdraw":{"id":"v5/asset/withdraw/cancel-withdraw","title":"\u64a4\u92b7\u63d0\u5e63","description":"\u50c5\u652f\u6301\u6bcd\u5e33\u865fAPI key","sidebar":"v5SideBar"},"v5/asset/withdraw/vasp-list":{"id":"v5/asset/withdraw/vasp-list","title":"\u67e5\u8a62\u4ea4\u6613\u6240\u5217\u8868","description":"\u8a72\u63a5\u53e3\u4e3b\u8981\u7528\u65bckyc=KOR\u7684\u97d3\u570b\u500b\u4eba\u7528\u6236, \u5728\u63d0\u73fe\u6642\u9700\u8981\u586b\u5beb\u63a5\u6536\u65b9\u4ea4\u6613\u6240\u4fe1\u606f","sidebar":"v5SideBar"},"v5/asset/withdraw/withdraw":{"id":"v5/asset/withdraw/withdraw","title":"\u63d0\u73fe","description":"\u82e5\u76ee\u6a19\u5730\u5740\u662fBybit\u5e73\u53f0\u5167\u90e8\u5730\u5740\uff0c\u60a8\u53ef\u4ee5\u5be6\u73fe\u5167\u90e8\u5e73\u53f0\u8f49\u5e33","sidebar":"v5SideBar"},"v5/asset/withdraw/withdraw-record":{"id":"v5/asset/withdraw/withdraw-record","title":"\u67e5\u8a62\u63d0\u73fe\u7d00\u9304","description":"* endTime - startTime\u9700\u8981\u5c0f\u65bc\u7b49\u65bc30\u5929. \u9ed8\u8a8d\u67e5\u8a62\u6700\u8fd130\u5929\u7684\u7d00\u9304\u3002","sidebar":"v5SideBar"},"v5/backup/set-pledge-token":{"id":"v5/backup/set-pledge-token","title":"Set Pledge Token","description":"Set Pledge Token in cross margin"},"v5/broker/account-info":{"id":"v5/broker/account-info","title":"\u67e5\u8a62\u7d93\u7d00\u5546\u5e33\u6236\u4fe1\u606f","description":"* \u4f7f\u7528\u7d93\u7d00\u5546\u7684\u6bcd\u5e33\u6236\u9032\u884c\u67e5\u8a62","sidebar":"v5SideBar"},"v5/broker/exchange-earning":{"id":"v5/broker/exchange-earning","title":"\u67e5\u8a62\u7d93\u7d00\u5546\u8fd4\u4f63\u4fe1\u606f","description":"* \u4f7f\u7528\u7d93\u7d00\u5546\u7684\u6bcd\u5e33\u6236\u9032\u884c\u67e5\u8a62","sidebar":"v5SideBar"},"v5/broker/sub-deposit-record":{"id":"v5/broker/sub-deposit-record","title":"\u67e5\u8a62\u7d93\u7d00\u5546\u7684\u5b50\u5e33\u865f\u5145\u503c\u7d00\u9304","description":"\u7d93\u7d00\u5546\u50c5\u80fd\u901a\u904e\u4e3b\u5e33\u865f\u7684API key\u4f86\u67e5\u8a62\u5b50\u5e33\u865f\u7684\u5145\u503c\u7d00\u9304","sidebar":"v5SideBar"},"v5/copytrade":{"id":"v5/copytrade","title":"\u5982\u4f55\u4f7f\u7528API\u5e36\u55ae","description":"\u6210\u70ba\u4ea4\u6613\u9054\u4eba","sidebar":"v5SideBar"},"v5/demo":{"id":"v5/demo","title":"\u6a21\u64ec\u4ea4\u6613","description":"\u6982\u89bd","sidebar":"v5SideBar"},"v5/enum":{"id":"v5/enum","title":"\u679a\u8209\u5b9a\u7fa9","description":"locale","sidebar":"v5SideBar"},"v5/error":{"id":"v5/error","title":"\u932f\u8aa4\u78bc","description":"HTTP \u97ff\u61c9\u78bc","sidebar":"v5SideBar"},"v5/guide":{"id":"v5/guide","title":"\u63a5\u5165\u6307\u5357","description":"\u6b32\u8a73\u7d30\u4e86\u89e3 V5 API \u5185\u5bb9\uff0c\u9084\u8acb\u4ed4\u7d30\u95b1\u8b80\u6982\u89bd","sidebar":"v5SideBar"},"v5/intro":{"id":"v5/intro","title":"\u6982\u89bd","description":"\u7c21\u4ecb","sidebar":"v5SideBar"},"v5/lt/leverage-token-info":{"id":"v5/lt/leverage-token-info","title":"LT\u5168\u91cf\u8cc7\u7522\u67e5\u8a62","description":"\u67e5\u8a62\u69d3\u687f\u4ee3\u5e63\u4fe1\u606f","sidebar":"v5SideBar"},"v5/lt/leverage-token-reference":{"id":"v5/lt/leverage-token-reference","title":"\u67e5\u8a62LT\u884c\u60c5","description":"\u67e5\u8a62LT\u884c\u60c5","sidebar":"v5SideBar"},"v5/lt/order-record":{"id":"v5/lt/order-record","title":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","description":"\u7533\u8d16\u8a18\u9304\u67e5\u8a62","sidebar":"v5SideBar"},"v5/lt/purchase":{"id":"v5/lt/purchase","title":"\u7533\u8cfc","description":"\u7533\u8cfc","sidebar":"v5SideBar"},"v5/lt/redeem":{"id":"v5/lt/redeem","title":"\u8d16\u56de","description":"\u8d16\u56de","sidebar":"v5SideBar"},"v5/market/delivery-price":{"id":"v5/market/delivery-price","title":"\u67e5\u8a62\u4ea4\u5272\u50f9\u683c","description":"\u67e5\u8a62\u5e73\u53f0\u4ea4\u5272\u7522\u54c1\u7684\u4ea4\u5272\u50f9\u683c\uff0c\u652f\u6301\u53cd\u5411\u4ea4\u5272, USDC\u4ea4\u5272\u548c\u671f\u6b0a","sidebar":"v5SideBar"},"v5/market/history-fund-rate":{"id":"v5/market/history-fund-rate","title":"\u67e5\u8a62\u6b77\u53f2\u8cc7\u91d1\u8cbb\u7387","description":"\u67e5\u8a62\u8cc7\u91d1\u8cbb\u7387\uff0c\u6bcf\u500bsymbol\u7684\u8cc7\u91d1\u8cbb\u7387\u7522\u751f\u9031\u671f\u4e0d\u540c\u3002\u5047\u8a2d\u8cc7\u91d1\u8cbb\u7387\u70ba8\u5c0f\u6642\uff0c\u7576\u524d\u6642\u9593\u662fUTC12\u9ede\uff0c\u5247\u8fd4\u56de\u7684\u662f\u4e0a\u4e00\u500b\u7d50\u7b97\u5373UTC8\u9ede\u7522\u751f\u7684\u8cc7\u91d1\u8cbb\u7387\u3002\u5982\u8981\u67e5\u8a62symbol\u7684\u8cc7\u91d1\u8cbb\u7387\u6642\u9593\u9593\u9694\uff0c\u8acb\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u898f\u683c\u63a5\u53e3","sidebar":"v5SideBar"},"v5/market/index-kline":{"id":"v5/market/index-kline","title":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6307\u6578\u50f9\u683cK\u7dda","sidebar":"v5SideBar"},"v5/market/instrument":{"id":"v5/market/instrument","title":"\u67e5\u8a62\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u898f\u683c\u4fe1\u606f","description":"\u67e5\u8a62\u5168\u7ad9\u53ef\u4ea4\u6613\u7522\u54c1\u7684\u57fa\u790e\u914d\u7f6e\u898f\u5247\u4fe1\u606f","sidebar":"v5SideBar"},"v5/market/insurance":{"id":"v5/market/insurance","title":"\u67e5\u8a62\u4fdd\u96aa\u57fa\u91d1","description":"\u67e5\u8a62Bybit\u5e73\u53f0\u7684\u4fdd\u96aa\u57fa\u91d1\u7684\u6578\u64da\uff0c\u5305\u542b\u6240\u6709\u4fdd\u96aa\u6c60\u7684\u6578\u64da\uff0c\u6578\u64da\u6bcf24\u5c0f\u6642\u66f4\u65b0\u4e00\u6b21\u3002","sidebar":"v5SideBar"},"v5/market/iv":{"id":"v5/market/iv","title":"\u67e5\u8a62\u671f\u6b0a\u6ce2\u52d5\u7387","description":"\u7372\u53d6\u671f\u6b0a\u7684\u6b77\u53f2\u6ce2\u52d5\u7387\u6578\u64da","sidebar":"v5SideBar"},"v5/market/kline":{"id":"v5/market/kline","title":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u5e02\u5834\u50f9\u683cK\u7dda\u6578\u64da","sidebar":"v5SideBar"},"v5/market/long-short-ratio":{"id":"v5/market/long-short-ratio","title":"\u67e5\u8a62\u591a\u7a7a\u6bd4","description":"HTTP\u8acb\u6c42","sidebar":"v5SideBar"},"v5/market/mark-kline":{"id":"v5/market/mark-kline","title":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6a19\u8a18\u50f9\u683cK\u7dda","sidebar":"v5SideBar"},"v5/market/open-interest":{"id":"v5/market/open-interest","title":"\u67e5\u8a62\u672a\u5e73\u5009\u5408\u7d04\u6301\u5009\u6578\u91cf","description":"\u67e5\u8a62\u5404\u500b\u5408\u7d04\u5e02\u5834\u5167\u6240\u6709\u672a\u5e73\u5009\u7684\u6578\u91cf","sidebar":"v5SideBar"},"v5/market/orderbook":{"id":"v5/market/orderbook","title":"Order Book (\u6df1\u5ea6)","description":"\u7372\u53d6\u6df1\u5ea6\u6578\u64da","sidebar":"v5SideBar"},"v5/market/preimum-index-kline":{"id":"v5/market/preimum-index-kline","title":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","description":"\u67e5\u8a62\u6ea2\u50f9\u6307\u6578\u50f9\u683cK\u7dda\u6578\u64da","sidebar":"v5SideBar"},"v5/market/recent-trade":{"id":"v5/market/recent-trade","title":"\u67e5\u8a62\u5e73\u53f0\u6700\u8fd1\u6210\u4ea4\u6b77\u53f2","description":"\u7372\u53d6\u5e73\u53f0\u6700\u8fd1\u6210\u4ea4\u6578\u64da","sidebar":"v5SideBar"},"v5/market/risk-limit":{"id":"v5/market/risk-limit","title":"\u67e5\u8a62\u5408\u7d04\u98a8\u96aa\u9650\u984d","description":"\u67e5\u8a62\u671f\u8ca8\u5408\u7d04\u7684\u98a8\u96aa\u9650\u984d\u8868","sidebar":"v5SideBar"},"v5/market/tickers":{"id":"v5/market/tickers","title":"\u67e5\u8a62\u6700\u65b0\u884c\u60c5\u4fe1\u606f","description":"\u53ef\u7372\u53d6\u5230\u5feb\u7167\u7684\u6700\u65b0\u5e02\u5834\u50f9\u683c\uff0c\u6700\u4f73\u8cb7\u8ce3\u50f9\u683c\uff0c\u4ee5\u53ca\u904e\u53bb\u6642\u9593\u5167\u7684\u4ea4\u6613\u91cf\u7b49.","sidebar":"v5SideBar"},"v5/market/time":{"id":"v5/market/time","title":"Bybit\u670d\u52d9\u5668\u6642\u9593","description":"\u7372\u53d6Bybit\u670d\u52d9\u5668\u6642\u9593","sidebar":"v5SideBar"},"v5/order/amend-order":{"id":"v5/order/amend-order","title":"\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u7d71\u4e00\u5e33\u6236\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 / USDT\u6c38\u7e8c / USDC\u6c38\u7e8c / USDC\u4ea4\u5272 / \u53cd\u5411\u5408\u7d04 / \u671f\u6b0a","sidebar":"v5SideBar"},"v5/order/batch-amend":{"id":"v5/order/batch-amend","title":"\u6279\u91cf\u4fee\u6539\u59d4\u8a17\u55ae","description":"\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 (\u7d71\u4e00\u5e33\u6236) / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236) / USDT\u6c38\u7e8c\u3001USDC\u6c38\u7e8c\u3001USDC\u4ea4\u5272 (UTA Pro)","sidebar":"v5SideBar"},"v5/order/batch-cancel":{"id":"v5/order/batch-cancel","title":"\u6279\u91cf\u64a4\u92b7\u59d4\u8a17\u55ae","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u6279\u91cf\u64a4\u92b7\u591a\u7b46\u8a02\u55ae","sidebar":"v5SideBar"},"v5/order/batch-place":{"id":"v5/order/batch-place","title":"\u6279\u91cf\u5275\u5efa\u59d4\u8a17\u55ae","description":"\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 (\u7d71\u4e00\u5e33\u6236) / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236) / USDT\u6c38\u7e8c\u3001USDC\u6c38\u7e8c\u3001USDC\u4ea4\u5272 (UTA Pro)","sidebar":"v5SideBar"},"v5/order/cancel-all":{"id":"v5/order/cancel-all","title":"\u64a4\u92b7\u6240\u6709\u8a02\u55ae","description":"\u64a4\u92b7\u5168\u90e8\u59d4\u8a17\u55ae","sidebar":"v5SideBar"},"v5/order/cancel-order":{"id":"v5/order/cancel-order","title":"\u64a4\u92b7\u59d4\u8a17\u55ae","description":"\u7d71\u4e00\u5e33\u6236\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 / USDT\u6c38\u7e8c / USDC\u6c38\u7e8c / USDC\u4ea4\u5272 / \u671f\u6b0a","sidebar":"v5SideBar"},"v5/order/create-order":{"id":"v5/order/create-order","title":"\u5275\u5efa\u59d4\u8a17\u55ae","description":"\u672c\u63a5\u53e3\u63d0\u4f9b\u5e63\u5e63\u4ea4\u6613\uff0c\u73fe\u8ca8\u69d3\u687f\u4ea4\u6613\uff0c\u5408\u7d04\u4ee5\u53ca\u671f\u6b0a\u7684\u8a02\u55ae\u5275\u5efa\u3002","sidebar":"v5SideBar"},"v5/order/dcp":{"id":"v5/order/dcp","title":"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593","description":"\u8986\u84cb\u7bc4\u570d: \u5408\u7d04 / \u73fe\u8ca8 / \u671f\u6b0a (\u7d71\u4e00\u5e33\u6236)","sidebar":"v5SideBar"},"v5/order/execution":{"id":"v5/order/execution","title":"\u67e5\u8a62\u6210\u4ea4\u7d00\u9304","description":"\u7372\u53d6\u7528\u6236\u6210\u4ea4\u7d00\u9304\uff0c\u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217\u3002\u4f46\u662f\uff0c\u5c0d\u65bc\u7d93\u5178\u5e33\u6236\u73fe\u8ca8\u4ea4\u6613\uff0c\u8fd4\u56de\u7d50\u679c\u6309execId\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/order/open-order":{"id":"v5/order/open-order","title":"\u67e5\u8a62\u5be6\u6642\u548c\u7d42\u614b\u59d4\u8a17\u55ae","description":"\u4e3b\u8981\u7528\u65bc\u5be6\u6642\u67e5\u8a62\u672a\u6210\u4ea4\u6216\u90e8\u5206\u6210\u4ea4\u7684\u8a02\u55ae\u4fe1\u606f, \u4f46\u7d50\u5408\u5165\u53c2openOnly\u80fd\u5920\u67e5\u8a62\u5230\u6700\u8fd1500\u689d\u5230\u9054\u7d42\u614b\u7684\u8a02\u55ae. \u82e5\u9700\u8981\u67e5\u8a62\u66f4\u4e45\u7684\u8a02\u55ae\u7d00\u9304\uff0c\u8acb\u4f7f\u7528\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae\u63a5\u53e3.","sidebar":"v5SideBar"},"v5/order/order-list":{"id":"v5/order/order-list","title":"\u67e5\u8a62\u6b77\u53f2\u8a02\u55ae","description":"\u7372\u53d6\u6b77\u53f2\u8a02\u55ae\u7d00\u9304. \u7531\u65bc\u8a02\u55ae\u5275\u5efa/\u64a4\u92b7\u662f\u7570\u6b65\u7684, \u8a72\u63a5\u53e3\u8fd4\u56de\u6578\u64da\u53ef\u80fd\u6703\u6709\u5ef6\u9072. \u82e5\u60a8\u60f3\u5be6\u6642\u7372\u53d6\u8a02\u55ae\u4fe1\u606f, \u60a8\u53ef\u4ee5\u67e5\u8a62\u8a72\u63a5\u53e3\u6216\u8005\u901a\u904ewebsocket\u63a8\u9001(\u63a8\u85a6)","sidebar":"v5SideBar"},"v5/order/spot-borrow-quota":{"id":"v5/order/spot-borrow-quota","title":"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)","description":"\u53ef\u4ee5\u67e5\u8a62\u73fe\u8ca8\u5e63\u5e63\u4ea4\u6613\u4ee5\u53ca\u69d3\u687f\u4ea4\u6613\u6642, \u53ef\u7528\u5c0d\u61c9\u5e63\u7a2e\u7684\u5be6\u6642\u9918\u984d","sidebar":"v5SideBar"},"v5/otc/bind-uid":{"id":"v5/otc/bind-uid","title":"\u7d81\u5b9a/\u89e3\u7d81UID","description":"\u5c0d\u65bc\u5834\u5916\u501f\u8cb8\u7522\u54c1, \u60a8\u53ef\u4ee5\u81ea\u884c\u7d81\u5b9a\u65b0\u7684UID\u5230\u98a8\u96aa\u55ae\u5143\u5167\u6216\u8005\u89e3\u7d81\u67d0\u500bUID","sidebar":"v5SideBar"},"v5/otc/loan-info":{"id":"v5/otc/loan-info","title":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u4fe1\u606f","description":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae\u7684\u8a73\u60c5","sidebar":"v5SideBar"},"v5/otc/ltv-convert":{"id":"v5/otc/ltv-convert","title":"\u67e5\u8a62\u98a8\u96aa\u7387","description":"HTTP \u8acb\u6c42","sidebar":"v5SideBar"},"v5/otc/margin-coin-convert-info":{"id":"v5/otc/margin-coin-convert-info","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"* \u8a72\u63a5\u53e3\u5728\u4e0d\u50b3\u5165api key\u548csecret\u9032\u884c\u9452\u6b0a\u6642, \u5247\u8fd4\u56de\u516c\u5171\u6578\u64da","sidebar":"v5SideBar"},"v5/otc/margin-product-info":{"id":"v5/otc/margin-product-info","title":"\u67e5\u8a62\u7522\u54c1\u4fe1\u606f","description":"* \u8a72\u63a5\u53e3\u5728\u4e0d\u50b3\u5165api key\u548csecret\u9032\u884c\u9452\u6b0a\u6642, \u5247\u8fd4\u56de\u516c\u5171\u7522\u54c1\u6578\u64da","sidebar":"v5SideBar"},"v5/otc/repay-info":{"id":"v5/otc/repay-info","title":"\u67e5\u8a62\u9084\u6b3e\u4fe1\u606f","description":"* \u9ed8\u8a8d\u67e5\u8a62\u904e\u53bb2\u5e74\u7684\u6578\u64da","sidebar":"v5SideBar"},"v5/position/auto-add-margin":{"id":"v5/position/auto-add-margin","title":"\u8a2d\u7f6e\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1","description":"\u958b\u95dc\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1\uff0c\u50c5\u9069\u7528\u65bc\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f","sidebar":"v5SideBar"},"v5/position/close-pnl":{"id":"v5/position/close-pnl","title":"\u67e5\u8a62\u5e73\u5009\u76c8\u8667","description":"\u7372\u53d6\u7576\u524d\u7528\u6236\u7684\u6240\u6709\u5e73\u5009\u76c8\u8667\u6578\u64da\uff0c\u8fd4\u56de\u7d50\u679c\u6309\u7167createdTime\u964d\u5e8f\u6392\u5217.","sidebar":"v5SideBar"},"v5/position/confirm-mmr":{"id":"v5/position/confirm-mmr","title":"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d","description":"\u50c5\u9069\u7528\u65bc\u7576\u7528\u6236\u88ab\u6a19\u8a18\u70ba\u50c5\u6e1b\u5009 (\u8acb\u770b\u6301\u5009\u63a5\u53e3\u4e2d\u7684isReduceOnly\u5b57\u6bb5) \u6642, \u5728\u7528\u6236\u4e3b\u52d5\u8abf\u6574\u98a8\u96aa\u6c34\u4f4d\u5f8c, \u8abf\u7528\u8a72\u63a5\u53e3\u4f86\u8a66\u7b97\u8abf\u6574\u5f8c\u7684\u98a8","sidebar":"v5SideBar"},"v5/position/cross-isolate":{"id":"v5/position/cross-isolate","title":"\u5207\u63db\u5168\u5009/\u9010\u5009\u4fdd\u8b49\u91d1(\u4ea4\u6613\u5c0d)","description":"\u9078\u64c7\u5168\u5009\u4fdd\u8b49\u91d1\u6216\u8005\u662f\u9010\u5009\u4fdd\u8b49\u91d1\uff0c\u8acb\u53c3\u95b1\u9019\u88e1\u4e86\u89e3\u95dc\u65bc\u5168\u5009/\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f\u3002","sidebar":"v5SideBar"},"v5/position/leverage":{"id":"v5/position/leverage","title":"\u8a2d\u7f6e\u69d3\u687f","description":"\u8a2d\u7f6e\u69d3\u687f","sidebar":"v5SideBar"},"v5/position/manual-add-margin":{"id":"v5/position/manual-add-margin","title":"\u624b\u52d5\u589e\u52a0\u6216\u6e1b\u5c11\u4fdd\u8b49\u91d1","description":"\u624b\u52d5\u589e\u52a0\u6216\u6e1b\u5c11\u4fdd\u8b49\u91d1\uff0c\u50c5\u9069\u7528\u65bc\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f","sidebar":"v5SideBar"},"v5/position/move-position":{"id":"v5/position/move-position","title":"\u79fb\u5009","description":"\u60a8\u53ef\u4ee5\u5728\u540c\u4e00\u500b\u6bcd\u5b50\u5e33\u6236\u9ad4\u7cfb\u4e0b\u79fb\u52d5\u671f\u8ca8\u3001\u671f\u6b0a\u7684\u5009\u4f4d, \u4ee5\u53ca\u73fe\u8ca8\u7684\u5e63\u5e63\u4ea4\u6613","sidebar":"v5SideBar"},"v5/position/move-position-history":{"id":"v5/position/move-position-history","title":"\u67e5\u8a62\u79fb\u5009\u6b77\u53f2","description":"\u60a8\u53ef\u4ee5\u901a\u904e\u4f7f\u7528\u6bcd\u5e33\u6236\u7684api key\u67e5\u8a62\u904e\u53bb\u7684\u79fb\u5009\u6b77\u53f2\u7d00\u9304","sidebar":"v5SideBar"},"v5/position/position":{"id":"v5/position/position","title":"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49","sidebar":"v5SideBar"},"v5/position/position-mode":{"id":"v5/position/position-mode","title":"\u5207\u63db\u6301\u5009\u6a21\u5f0f","description":"\u8a72\u63a5\u53e3\u652f\u6301\u5207\u63dbUSDT\u6c38\u7e8c\u548c\u53cd\u5411\u4ea4\u5272\u7684\u6301\u5009\u6a21\u5f0f\u3002\u5982\u679c\u8655\u65bc\u55ae\u5411\u6301\u5009\u6a21\u5f0f\u4e0b\uff0c\u60a8\u53ea\u80fd\u8981\u9ebc\u6301\u6709\u591a\u982d\u8981\u9ebc\u7a7a\u982d\u5009\u4f4d\uff1b\u5982\u679c\u8655\u65bc\u96d9\u5411\u6301\u5009\u6a21\u5f0f\u4e0b\uff0c\u60a8\u53ef\u4ee5\u540c\u6642\u6301\u5009\u591a\u982d\u548c\u7a7a\u982d\u7684\u5009\u4f4d\u3002","sidebar":"v5SideBar"},"v5/position/set-risk-limit":{"id":"v5/position/set-risk-limit","title":"\u8a2d\u7f6e\u98a8\u96aa\u9650\u984d","description":"\u7531\u65bcBybit\u57282024\u5e743\u670812\u65e5\u4e0a\u7dda\u4e86\u81ea\u52d5\u8abf\u6574risk limit\u529f\u80fd, \u8a73\u60c5\u8acb\u898b\u9019\u88e1, \u56e0\u6b64\u5118\u7ba1\u63a5\u53e3\u80fd\u8abf\u901a, \u4f46\u662f\u6c92\u6709\u4efb\u4f55\u610f\u7fa9","sidebar":"v5SideBar"},"v5/position/tpsl-mode":{"id":"v5/position/tpsl-mode","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d\u6a21\u5f0f","description":"\u67d0\u7a2e\u7a0b\u5ea6\u4e0a\u4f86\u8aaa\uff0c\u8a72\u63a5\u53e3\u5df2\u7d93**\u5ee2\u68c4**, \u539f\u56e0\u5728\u65bc\u65b0\u7248\u7684\u6b62\u76c8\u6b62\u640d\u6a5f\u5236\u662f\u57fa\u65bc\u8a02\u55ae\u7dad\u5ea6. \u9019\u500b\u63a5\u53e3\u7576\u521d\u4e3b\u8981\u662f\u7528\u65bc\u5009\u4f4d\u7dad\u5ea6\u7684\u6b62\u76c8\u6b62\u640d","sidebar":"v5SideBar"},"v5/position/trading-stop":{"id":"v5/position/trading-stop","title":"\u8a2d\u7f6e\u6b62\u76c8\u6b62\u640d","description":"\u8a72\u63a5\u53e3\u53ef\u4ee5\u8a2d\u7f6e\u6b62\u76c8\u3001\u6b62\u640d\u548c\u8ffd\u8e64\u6b62\u640d","sidebar":"v5SideBar"},"v5/pre-upgrade/close-pnl":{"id":"v5/pre-upgrade/close-pnl","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u5e73\u5009\u76c8\u8667","description":"\u50c5\u652f\u6301\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684USDT\u6c38\u7e8c / \u53cd\u5411\u5408\u7d04, \u8fd4\u56de\u7d50\u679c\u6309\u7167updatedTime\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/pre-upgrade/delivery":{"id":"v5/pre-upgrade/delivery","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u671f\u6b0a\u4ea4\u5272\u7d00\u9304","description":"\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684\u671f\u6b0a\u7684\u4ea4\u5272\u7d00\u9304, \u8fd4\u56de\u7d50\u679c\u6309\u7167deliveryTime\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/pre-upgrade/execution":{"id":"v5/pre-upgrade/execution","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u6210\u4ea4\u7d00\u9304","description":"\u76ee\u524d\uff0c\u50c5\u652f\u6301\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684USDT\u6c38\u7e8c, USDC\u6c38\u7e8c, \u53cd\u5411\u5408\u7d04\u548c\u671f\u6b0a, \u8fd4\u56de\u7d50\u679c\u6309execTime\u964d\u5e8f\u6392\u5217","sidebar":"v5SideBar"},"v5/pre-upgrade/order-list":{"id":"v5/pre-upgrade/order-list","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u8a02\u55ae\u7d00\u9304","description":"\u652f\u6301\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684USDT\u6c38\u7e8c, USDC\u6c38\u7e8c, \u53cd\u5411\u5408\u7d04\u548c\u671f\u6b0a","sidebar":"v5SideBar"},"v5/pre-upgrade/settlement":{"id":"v5/pre-upgrade/settlement","title":"\u67e5\u8a62\u5347\u7d1a\u524dUSDC\u7d50\u7b97\u7d00\u9304","description":"\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524d\u767c\u751f\u7684USDC\u6c38\u7e8c\u7684\u7d50\u7b97\u7d00\u9304","sidebar":"v5SideBar"},"v5/pre-upgrade/transaction-log":{"id":"v5/pre-upgrade/transaction-log","title":"\u67e5\u8a62\u5347\u7d1a\u524d\u4ea4\u6613\u65e5\u8a8c","description":"\u67e5\u8a62\u5347\u7d1a\u5230\u7d71\u4e00\u5e33\u6236\u4e4b\u524dUSDC\u5408\u7d04\u5e33\u6236\u88e1\u7684\u4ea4\u6613\u65e5\u8a8c","sidebar":"v5SideBar"},"v5/rate-limit":{"id":"v5/rate-limit","title":"\u983b\u7387\u9650\u5236","description":"IP\u9650\u983b","sidebar":"v5SideBar"},"v5/smp":{"id":"v5/smp","title":"\u81ea\u6210\u4ea4\u6514\u622a","description":"\u4ec0\u9ebc\u662f\u81ea\u6210\u4ea4\uff1f","sidebar":"v5SideBar"},"v5/spot-margin-normal/account-info":{"id":"v5/spot-margin-normal/account-info","title":"\u67e5\u8a62\u501f\u8cb8\u5e33\u6236\u4fe1\u606f","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/borrow":{"id":"v5/spot-margin-normal/borrow","title":"\u501f\u6b3e","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/borrow-order":{"id":"v5/spot-margin-normal/borrow-order","title":"\u67e5\u8a62\u501f\u8cb8\u8a02\u55ae","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/borrowable-data":{"id":"v5/spot-margin-normal/borrowable-data","title":"\u67e5\u8a62\u53ef\u501f\u5e63\u7a2e\u7cbe\u5ea6","description":"\u4e0d\u9700\u8981\u9452\u6b0a"},"v5/spot-margin-normal/interest-quota":{"id":"v5/spot-margin-normal/interest-quota","title":"\u67e5\u8a62\u5229\u7387\u53ca\u984d\u5ea6","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/margin-data":{"id":"v5/spot-margin-normal/margin-data","title":"\u67e5\u8a62\u4fdd\u8b49\u91d1\u5e63\u7a2e\u4fe1\u606f","description":"\u4e0d\u9700\u8981\u9452\u6b0a"},"v5/spot-margin-normal/repay":{"id":"v5/spot-margin-normal/repay","title":"\u9084\u6b3e","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/repay-order":{"id":"v5/spot-margin-normal/repay-order","title":"\u67e5\u8a62\u9084\u6b3e\u8a02\u55ae\u4fe1\u606f","description":"\u8986\u84cb\u7bc4\u570d: \u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"},"v5/spot-margin-normal/switch-mode":{"id":"v5/spot-margin-normal/switch-mode","title":"\u5168\u5009\u69d3\u687f\u958b\u95dc","description":"\u958b\u555f\u6216\u95dc\u9589\u5168\u5009\u69d3\u687f\u4ea4\u6613"},"v5/spot-margin-normal/vip-margin":{"id":"v5/spot-margin-normal/vip-margin","title":"\u67e5\u8a62\u4e0d\u540cVIP\u7684\u69d3\u687f\u6578\u64da","description":"\u67e5\u8a62\u7d93\u5178\u5e33\u6236\u4e0b\u4e0d\u540cVIP\u7b49\u7d1a\u7684\u69d3\u687f\u6578\u64da"},"v5/spot-margin-uta/historical-interest":{"id":"v5/spot-margin-uta/historical-interest","title":"\u67e5\u8a62\u501f\u8cb8\u6b77\u53f2\u5229\u7387","description":"\u60a8\u53ef\u4ee5\u67e5\u8a62\u6700\u591a\u904e\u53bb6\u500b\u6708\u7684\u501f\u8cb8\u5229\u7387\u6578\u64da","sidebar":"v5SideBar"},"v5/spot-margin-uta/set-leverage":{"id":"v5/spot-margin-uta/set-leverage","title":"\u5168\u5009\u69d3\u687f\u8a2d\u7f6e","description":"\u5168\u5009\u69d3\u687f\u8a2d\u7f6e\u7528\u6236\u6700\u5927\u69d3\u687f\u500d\u6578","sidebar":"v5SideBar"},"v5/spot-margin-uta/status":{"id":"v5/spot-margin-uta/status","title":"\u67e5\u8a62\u958b\u95dc\u72c0\u614b\u548c\u500d\u6578","description":"\u67e5\u8a62\u7d71\u4e00\u5e33\u6236\u4e0b\u69d3\u687f\u4ea4\u6613\u7684\u958b\u95dc\u72c0\u614b\u548c\u69d3\u687f\u500d\u6578","sidebar":"v5SideBar"},"v5/spot-margin-uta/switch-mode":{"id":"v5/spot-margin-uta/switch-mode","title":"\u5168\u5009\u69d3\u687f\u958b\u95dc","description":"\u5168\u5009\u69d3\u687f\u958b\u95dc","sidebar":"v5SideBar"},"v5/spot-margin-uta/vip-margin":{"id":"v5/spot-margin-uta/vip-margin","title":"\u67e5\u8a62\u4e0d\u540cVIP\u7684\u69d3\u687f\u6578\u64da","description":"\u67e5\u8a62\u7d71\u4e00\u5e33\u6236\u4e0b\u4e0d\u540cVIP\u7b49\u7d1a\u7684\u69d3\u687f\u6578\u64da","sidebar":"v5SideBar"},"v5/user/affiliate-info":{"id":"v5/user/affiliate-info","title":"\u67e5\u8a62\u4ee3\u7406\u7528\u6236\u4fe1\u606f","description":"\u8981\u4f7f\u7528\u6b64\u63a5\u53e3\uff0c\u60a8\u5e94\u8be5\u6709\u4e00\u4e2a\u4ee3\u7406\u5546\u8d26\u6237\uff0c\u5e76\u4e14\u5728\u521b\u5efa API \u5bc6\u94a5\u65f6\u4ec5\u52fe\u9009\u201c\u4ee3\u7406\u5546\u201d\u6743\u9650\u3002","sidebar":"v5SideBar"},"v5/user/apikey-info":{"id":"v5/user/apikey-info","title":"\u67e5\u8a62API Key\u76f8\u95dc\u4fe1\u606f","description":"\u7372\u53d6API key\u7684\u76f8\u95dc\u4fe1\u606f\u3002\u4f7f\u7528\u5f85\u67e5\u8a62\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9069\u7528\u65bc\u6bcd\u3001\u5b50\u5e33\u6236\u7684api key\u3002","sidebar":"v5SideBar"},"v5/user/create-subuid":{"id":"v5/user/create-subuid","title":"\u65b0\u5efa\u5b50\u5e33\u6236","description":"\u5275\u5efa\u65b0\u7684\u5b50\u5e33\u6236\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/create-subuid-apikey":{"id":"v5/user/create-subuid-apikey","title":"\u65b0\u5efa\u5b50\u5e33\u6236\u7684API Key","description":"\u7d66\u65b0\u5efa\u597d\u7684\u5b50\u5e33\u6236\u5275\u5efa\u65b0\u7684API key\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/froze-subuid":{"id":"v5/user/froze-subuid","title":"\u51cd\u7d50/\u89e3\u51cd\u5b50\u5e33\u6236","description":"\u51cd\u7d50\u6216\u89e3\u51cd\u5b50\u5e33\u6236\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/list-sub-apikeys":{"id":"v5/user/list-sub-apikeys","title":"\u67e5\u8a62\u5b50\u5e33\u6236\u7684\u6240\u6709API Key\u4fe1\u606f","description":"\u67e5\u8a62\u67d0\u500b\u5b50\u5e33\u6236\u4e0b\u6240\u6709\u7684api key","sidebar":"v5SideBar"},"v5/user/modify-master-apikey":{"id":"v5/user/modify-master-apikey","title":"\u4fee\u6539\u6bcd\u5e33\u6236\u7684API Key\u8a2d\u7f6e","description":"\u4fee\u6539\u6bcd\u5e33\u6236API key\u7684\u8a2d\u7f6e\u3002\u4f7f\u7528\u5f85\u4fee\u6539\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/modify-sub-apikey":{"id":"v5/user/modify-sub-apikey","title":"\u4fee\u6539\u5b50\u5e33\u6236\u7684API Key\u8a2d\u7f6e","description":"\u4fee\u6539\u5b50\u5e33\u6236API key\u7684\u8a2d\u7f6e, \u652f\u6301\u6bcd\u5e33\u6236\u7ba1\u7406\u5b50\u5e33\u6236key\u7684\u8a2d\u7f6e, \u6216\u8005\u5b50\u5e33\u6236key\u76f4\u63a5\u4fee\u6539\u672c\u8eab\u3002","sidebar":"v5SideBar"},"v5/user/page-subuid":{"id":"v5/user/page-subuid","title":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868 (\u7121\u9650\u5236)","description":"\u901a\u904e\u7ffb\u9801\u7372\u53d6\u7576\u524d\u6bcd\u5e33\u6236\u4e0b\u6240\u6709\u7684\u5b50\u5e33\u6236\u5217\u8868\uff0c\u9069\u5408\u8d85\u904e\u64c1\u67091\u842c\u500b\u5b50\u5e33\u6236\u7684\u6bcd\u5e33\u6236\u9032\u884c\u8abf\u7528\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/rm-master-apikey":{"id":"v5/user/rm-master-apikey","title":"\u522a\u9664\u6bcd\u5e33\u6236\u7684API Key","description":"\u522a\u9664\u6bcd\u5e33\u6236\u4e0b\u7684api key\u3002\u4f7f\u7528\u5f85\u522a\u9664\u7684api key\u8abf\u7528\u63a5\u53e3\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/rm-sub-apikey":{"id":"v5/user/rm-sub-apikey","title":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684API Key","description":"\u522a\u9664\u5b50\u5e33\u6236\u4e0b\u7684api key\u3002\u4f7f\u7528\u5f85\u522a\u9664\u7684\u5b50\u5e33\u6236api key\u8abf\u7528\u63a5\u53e3\u6216\u8005\u4f7f\u7528\u6bcd\u5e33\u6236\u8abf\u7528\u522a\u9664\u6307\u5b9aapi key","sidebar":"v5SideBar"},"v5/user/rm-subuid":{"id":"v5/user/rm-subuid","title":"\u522a\u9664\u5b50\u5e33\u6236","description":"\u522a\u9664\u5b50\u5e33\u6236. \u5728\u522a\u9664\u524d, \u78ba\u4fdd\u8a72\u5e33\u6236\u5df2\u7d93\u6c92\u6709\u8cc7\u7522\u4e86","sidebar":"v5SideBar"},"v5/user/subuid-list":{"id":"v5/user/subuid-list","title":"\u67e5\u8a62\u5b50\u5e33\u6236UID\u5217\u8868 (\u9650\u5236)","description":"\u6700\u591a\u8fd4\u56de10000\u500b\u5b50\u5e33\u6236, \u9069\u5408\u5c11\u65bc1\u842c\u500b\u5b50\u5e33\u6236\u7684\u6bcd\u5e33\u6236\u8abf\u7528\u3002\u9700\u4f7f\u7528\u6bcd\u5e33\u6236\u7684API key\u3002","sidebar":"v5SideBar"},"v5/user/wallet-type":{"id":"v5/user/wallet-type","title":"\u67e5\u8a62\u5e33\u6236\u652f\u6301\u7684\u9322\u5305\u985e\u578b","description":"\u67e5\u8a62\u6bcd\u5e33\u6236\u6216\u8005\u5b50\u5e33\u6236\u4e0b\u652f\u6301\u7684\u9322\u5305\u985e\u578b","sidebar":"v5SideBar"},"v5/websocket/private/dcp":{"id":"v5/websocket/private/dcp","title":"\u65b7\u7dda\u4fdd\u8b77 (\u671f\u6b0a)","description":"\u901a\u904e\u8a02\u95b1DCP\u6d41\u4f86\u89f8\u767c\u529f\u80fd","sidebar":"v5SideBar"},"v5/websocket/private/execution":{"id":"v5/websocket/private/execution","title":"\u500b\u4eba\u6210\u4ea4","description":"\u8a02\u95b1\u500b\u4eba\u6210\u4ea4\u7684\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/private/fast-execution":{"id":"v5/websocket/private/fast-execution","title":"\u500b\u4eba\u6210\u4ea4 (Fast)","description":"\u7cbe\u7c21\u7248\u672c\u7684\u500b\u4eba\u6210\u4ea4\u63a8\u9001, \u76f8\u6bd4\u539f\u59cb\u7684\u5feb\u901f\u6210\u4ea4\u6d41, \u5ef6\u9072\u66f4\u52a0\u4f4e","sidebar":"v5SideBar"},"v5/websocket/private/greek":{"id":"v5/websocket/private/greek","title":"\u7528\u6236\u5e0c\u81d8\u5b57\u6bcd\u4fe1\u606f (\u671f\u6b0a)","description":"\u8a02\u95b1\u7528\u6236\u5e0c\u81d8\u5b57\u6bcd\u6578\u64da\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/private/order":{"id":"v5/websocket/private/order","title":"\u8a02\u55ae","description":"\u8a02\u95b1\u8a02\u55ae\u6578\u64da\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/private/position":{"id":"v5/websocket/private/position","title":"\u6301\u5009","description":"\u8a02\u95b1\u6301\u5009\u6578\u64da\u7684\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/private/wallet":{"id":"v5/websocket/private/wallet","title":"\u9322\u5305","description":"\u8a02\u95b1\u9322\u5305\u6578\u64da\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/public/etp-kline":{"id":"v5/websocket/public/etp-kline","title":"ETP\u6de8\u503cK\u7dda","description":"\u8a02\u95b1\u69d3\u687f\u4ee3\u5e63\u7684\u6de8\u503cK\u7dda\u884c\u60c5\u63a8\u9001\u670d\u52d9","sidebar":"v5SideBar"},"v5/websocket/public/etp-nav":{"id":"v5/websocket/public/etp-nav","title":"ETP\u6700\u65b0\u6de8\u503c\u63a8\u9001","description":"\u8a02\u95b1\u69d3\u687f\u4ee3\u5e63\u7684\u6700\u65b0\u6de8\u503c\u884c\u60c5\u6578\u64da","sidebar":"v5SideBar"},"v5/websocket/public/etp-ticker":{"id":"v5/websocket/public/etp-ticker","title":"ETP\u6de8\u503c\u884c\u60c5\u63a8\u9001","description":"\u8a02\u95b1\u69d3\u687f\u4ee3\u5e63\u6de8\u503c\u884c\u60c5\u6578\u64da","sidebar":"v5SideBar"},"v5/websocket/public/kline":{"id":"v5/websocket/public/kline","title":"K\u7dda","description":"\u8a02\u95b1K\u7dda\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/public/liquidation":{"id":"v5/websocket/public/liquidation","title":"\u5f37\u5e73\u63a8\u9001","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u7684\u5f37\u5e73\u63a8\u9001, symbol\u7ef4\u5ea6\u6700\u591a1\u79d2\u63a8\u4e00\u6761\u7206\u4ed3\u6570\u636e","sidebar":"v5SideBar"},"v5/websocket/public/orderbook":{"id":"v5/websocket/public/orderbook","title":"\u6df1\u5ea6","description":"\u8a02\u95b1\u4e0d\u540c\u6df1\u5ea6\u7684\u63a8\u9001","sidebar":"v5SideBar"},"v5/websocket/public/ticker":{"id":"v5/websocket/public/ticker","title":"\u884c\u60c5","description":"\u8a02\u95b1\u884c\u60c5\u6578\u64da\u63a8\u9001.","sidebar":"v5SideBar"},"v5/websocket/public/trade":{"id":"v5/websocket/public/trade","title":"\u5e73\u53f0\u6210\u4ea4","description":"\u8a02\u95b1Bybit\u5e73\u53f0\u4e0a\u6700\u8fd1\u6210\u4ea4\u7684\u63a8\u9001.","sidebar":"v5SideBar"},"v5/websocket/trade/guideline":{"id":"v5/websocket/trade/guideline","title":"Websocket\u4e0b\u55ae\u6307\u5357","description":"\u8def\u5f91","sidebar":"v5SideBar"},"v5/websocket/wss-authentication":{"id":"v5/websocket/wss-authentication","title":"\u8a02\u95b1WebSocket","description":"WebSocket\u516c\u5171\u983b\u9053:","sidebar":"v5SideBar"}}}')}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/a8e44541.2e7dde30.js b/zh-TW/assets/js/a8e44541.bad43f20.js similarity index 95% rename from zh-TW/assets/js/a8e44541.2e7dde30.js rename to zh-TW/assets/js/a8e44541.bad43f20.js index e0eee9bcdb..ecb929a75d 100644 --- a/zh-TW/assets/js/a8e44541.2e7dde30.js +++ b/zh-TW/assets/js/a8e44541.bad43f20.js @@ -1 +1 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[81832],{3905:(t,l,n)=>{n.d(l,{Zo:()=>s,kt:()=>p});var e=n(67294);function r(t,l,n){return l in t?Object.defineProperty(t,l,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[l]=n,t}function a(t,l){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var e=Object.getOwnPropertySymbols(t);l&&(e=e.filter((function(l){return Object.getOwnPropertyDescriptor(t,l).enumerable}))),n.push.apply(n,e)}return n}function k(t){for(var l=1;l=0||(r[n]=t[n]);return r}(t,l);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);for(e=0;e=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(r[n]=t[n])}return r}var u=e.createContext({}),i=function(t){var l=e.useContext(u),n=l;return t&&(n="function"==typeof t?t(l):k(k({},l),t)),n},s=function(t){var l=i(t.components);return e.createElement(u.Provider,{value:l},t.children)},o={inlineCode:"code",wrapper:function(t){var l=t.children;return e.createElement(e.Fragment,{},l)}},c=e.forwardRef((function(t,l){var n=t.components,r=t.mdxType,a=t.originalType,u=t.parentName,s=d(t,["components","mdxType","originalType","parentName"]),c=i(n),p=r,m=c["".concat(u,".").concat(p)]||c[p]||o[p]||a;return n?e.createElement(m,k(k({ref:l},s),{},{components:n})):e.createElement(m,k({ref:l},s))}));function p(t,l){var n=arguments,r=l&&l.mdxType;if("string"==typeof t||r){var a=n.length,k=new Array(a);k[0]=c;var d={};for(var u in l)hasOwnProperty.call(l,u)&&(d[u]=l[u]);d.originalType=t,d.mdxType="string"==typeof t?t:r,k[1]=d;for(var i=2;i{n.r(l),n.d(l,{assets:()=>u,contentTitle:()=>k,default:()=>m,frontMatter:()=>a,metadata:()=>d,toc:()=>i});var e=n(87462),r=(n(67294),n(3905));const a={title:"\u983b\u7387\u9650\u5236",sidebar_label:"\u983b\u7387\u9650\u5236"},k=void 0,d={unversionedId:"v5/rate-limit",id:"v5/rate-limit",title:"\u983b\u7387\u9650\u5236",description:"IP\u9650\u983b",source:"@site/i18n/zh-TW/docusaurus-plugin-content-docs/current/v5/rate-limit.mdx",sourceDirName:"v5",slug:"/v5/rate-limit",permalink:"/docs/zh-TW/v5/rate-limit",draft:!1,tags:[],version:"current",frontMatter:{title:"\u983b\u7387\u9650\u5236",sidebar_label:"\u983b\u7387\u9650\u5236"},sidebar:"v5SideBar",previous:{title:"Websocket\u4e0b\u55ae\u6307\u5357",permalink:"/docs/zh-TW/v5/websocket/trade/guideline"},next:{title:"\u679a\u8209\u5b9a\u7fa9",permalink:"/docs/zh-TW/v5/enum"}},u={},i=[{value:"IP\u9650\u983b",id:"ip\u9650\u983b",level:2},{value:"\u8cec\u6236\u983b\u7387\u9650\u88fd",id:"\u8cec\u6236\u983b\u7387\u9650\u88fd",level:2},{value:"\u63a5\u53e3\u983b\u7387\u9650\u5236\u8868",id:"\u63a5\u53e3\u983b\u7387\u9650\u5236\u8868",level:3},{value:"\u4ea4\u6613",id:"\u4ea4\u6613",level:4},{value:"\u6301\u5009",id:"\u6301\u5009",level:4},{value:"\u5e33\u6236",id:"\u5e33\u6236",level:4},{value:"\u8cc7\u7522",id:"\u8cc7\u7522",level:4},{value:"\u7528\u6236",id:"\u7528\u6236",level:4},{value:"\u69d3\u687f\u4ee3\u5e63",id:"\u69d3\u687f\u4ee3\u5e63",level:4},{value:"\u5168\u5009\u69d3\u687f (\u7d71\u4e00\u5e33\u6236)",id:"\u5168\u5009\u69d3\u687f-\u7d71\u4e00\u5e33\u6236",level:4},{value:"\u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)",id:"\u5168\u5009\u69d3\u687f-\u7d93\u5178\u5e33\u6236",level:4},{value:"\u4e0d\u540cVIP/PRO\u7b49\u7d1a\u7684\u63a5\u53e3\u9650\u983b\u898f\u5247",id:"\u4e0d\u540cvippro\u7b49\u7d1a\u7684\u63a5\u53e3\u9650\u983b\u898f\u5247",level:2},{value:"\u5982\u4f55\u63d0\u9ad8\u983b\u7387\u9650\u88fd",id:"\u5982\u4f55\u63d0\u9ad8\u983b\u7387\u9650\u88fd",level:2}],s=t=>function(l){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,r.kt)("div",l)},o=s("Tabs"),c=s("TabItem"),p={toc:i};function m(t){let{components:l,...n}=t;return(0,r.kt)("wrapper",(0,e.Z)({},p,n,{components:l,mdxType:"MDXLayout"}),(0,r.kt)("h2",{id:"ip\u9650\u983b"},"IP\u9650\u983b"),(0,r.kt)("admonition",{type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"\u5982\u679c\u60a8\u6536\u5230",(0,r.kt)("strong",{parentName:"p"},"HTTP 403"),"\uff08\u62d2\u7d55\u8a2a\u554f\uff09\u97ff\u61c9, \u60a8\u7684 IP \u5df2\u88ab\u66ab\u6642\u6216\u6c38\u4e45\u7981\u6b62\u3002 ",(0,r.kt)("strong",{parentName:"p"},"\u60a8\u61c9\u7acb\u5373\u67e5\u770b\u4ee5\u4e0b\u6307\u5357\uff0c\u4ee5\u78ba\u4fdd\u60a8\u7684\u61c9\u7528\u7a0b\u5e8f\u4e0d\u6703\u7e7c\u7e8c\u9055\u53cd\u9650\u5236"),"\u3002\u5982\u679c\u60a8\u5728 30 \u5206\u9418\u5f8c\n\u4ecd\u88ab\u7981\u6b62\uff0c\u5247\u60a8\u53ef\u80fd\u6703\u88ab\u6c38\u4e45\u7981\u6b62\u3002")),(0,r.kt)("p",null,"\u6211\u5011\u4e0d\u5efa\u8b70\u60a8\u5728\u9019\u4e9b\u9650\u5236\u7684\u908a\u7de3\u904b\u884c\u60a8\u7684\u61c9\u7528\u7a0b\u5e8f\uff0c\u4ee5\u9632\u7570\u5e38\u7684\u7db2\u7d61\u6d3b\u52d5\u5c0e\u81f4\u610f\u5916\u9055\u898f\u3002"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"GET"),"/",(0,r.kt)("inlineCode",{parentName:"li"},"POST")," \u8acb\u6c42 (\u5171\u4eab):",(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"\u9023\u7e8c 5 \u79d2\u5167\u6bcf\u79d2\u4e0d\u8d85\u904e 600 \u500b\u8acb\u6c42")))),(0,r.kt)("admonition",{type:"note"},(0,r.kt)("p",{parentName:"admonition"},"\u6240\u6709\u5230",(0,r.kt)("inlineCode",{parentName:"p"},"api.bybit.com"),"\u6216",(0,r.kt)("inlineCode",{parentName:"p"},"api.bytick.com"),"\u7684\u6d41\u91cf\u5171\u4eab\u6b64\u9650\u5236\uff0c\u7121\u8ad6\u662f\u8a2a\u554f\u73fe\u8ca8\u3001\u671f\u8ca8\u9084\u662f\u671f\u6b0a\u3002")),(0,r.kt)("p",null,"\u9055\u53cd\u9650\u5236\u5f8c\uff0c\u60a8\u7684 IP \u5c07\u88ab\u7981\u6b62\u4e00\u6bb5\u6642\u9593\uff08\u901a\u5e38\u70ba 30 \u5206\u9418\uff09\u3002 \u6301\u7e8c\u9055\u53cd\u9650\u5236\u5c07\u5c0e\u81f4\u6c38\u4e45\u7981\u6b62\u3002 \u6211\u5011\u4e0d\u80fd\u64a4\u92b7\u6c38\u4e45\u7981\u4ee4\u6216\u7e2e\u77ed\u81e8\u6642\u7981\u4ee4\u3002"),(0,r.kt)("h2",{id:"\u8cec\u6236\u983b\u7387\u9650\u88fd"},"\u8cec\u6236\u983b\u7387\u9650\u88fd"),(0,r.kt)("admonition",{type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"\u5982\u679c\u60a8\u6536\u5230\u9019\u6a23\u7684\u97ff\u61c9",(0,r.kt)("inlineCode",{parentName:"p"},'"ret_msg": "Too many visits!"'),", \u5247\u8868\u793a\u60a8\u89f8\u767c\u4e86\u5e33\u6236\u983b\u7387\u9650\u5236, \u8acb\u7b49\u5230\u983b\u7387\u9650\u5236\u91cd\u7f6e\u4ee5\u5f8c, \u518d\u7e7c\u7e8c\u767c\u9001\u8acb\u6c42\u3002")),(0,r.kt)("p",null,"Bybit\u57fa\u65bc",(0,r.kt)("strong",{parentName:"p"},"\u6bcf\u79d2\u937e"),"\u7684\u6efe\u52d5\u6642\u9593\u7a97\u53e3\u4f86\u505a\u983b\u7387\u9650\u88fd\uff0c\u4e26\u4e14\u662f\u6309",(0,r.kt)("strong",{parentName:"p"},"\u8cec\u6236"),"\uff08uid\uff09\u4f86\u505a\u5283\u5206\u9650\u88fd\uff0c\u6bcf\u6b21\u8acb\u6c42API\u97ff\u61c9\u982d(response header)\u4e2d\u90fd\u6703\u5305\u542b\u5982\u4e0b\u5b57\u6bb5\uff1a"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit-Status")," - \u8a72\u63a5\u53e3\u7576\u524d\u6642\u9593\u7a97\u53e3\u5269\u4f59\u53ef\u7528\u8acb\u6c42\u6578"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit")," - \u8a72\u63a5\u53e3\u7576\u524d\u983b\u7387\u9650\u88fd\u4e0a\u9650"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit-Reset-Timestamp")," - \u5982\u679c\u60a8\u5df2\u8d85\u904e\u8a72\u63a5\u53e3\u7576\u524d\u7a97\u53e3\u983b\u7387\u9650\u88fd\uff0c\u8a72\u5b57\u6bb5\u8868\u793a\u4e0b\u500b\u53ef\u7528\u6642\u9593\u7a97\u53e3\u7684\u6642\u9593\u6233\uff08\u6beb\u79d2\uff09\uff0c\u5373\u4ec0\u9ebd\u6642\u5019\u53ef\u4ee5\u6062\u5fa9\u8a2a\u554f\uff1b\u5982\u679c\u60a8\u672a\u8d85\u904e\u8a72\u63a5\u53e3\u7576\u524d\u7a97\u53e3\u983b\u7387\u9650\u88fd\uff0c\u8a72\u5b57\u6bb5\u8868\u793a\u8fd4\u56de\u7684\u662f\u7576\u524d\u670d\u52d9\u5668\u6642\u9593\uff08\u6beb\u79d2).")),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},"Http \u97ff\u61c9\u982d\u793a\u4f8b")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-http"},"\u25b6Response Headers\nContent-Type: application/json; charset=utf-8\nContent-Length: 141\nX-Bapi-Limit: 100\nX-Bapi-Limit-Status: 99\nX-Bapi-Limit-Reset-Timestamp: 1672738134824\n")),(0,r.kt)("h3",{id:"\u63a5\u53e3\u983b\u7387\u9650\u5236\u8868"},"\u63a5\u53e3\u983b\u7387\u9650\u5236\u8868"),(0,r.kt)("h4",{id:"\u4ea4\u6613"},"\u4ea4\u6613"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"\u7d93\u5178\u5e33\u6236",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{rowSpan:"2"},"\u8def\u5f91"),(0,r.kt)("th",{colSpan:"3",align:"center"},"\u7d93\u5178\u5e33\u6236"),(0,r.kt)("th",{rowSpan:"2"},"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"4"},"POST"),(0,r.kt)("td",null,"/v5/order/create"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-all"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"GET"),(0,r.kt)("td",null,"/v5/order/realtime"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/history"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/execution/list"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{rowSpan:"2"},"\u8def\u5f91"),(0,r.kt)("th",{colSpan:"4",align:"center"},"UTA Pro"),(0,r.kt)("th",{rowSpan:"2"},"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"option"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"8"},"POST"),(0,r.kt)("td",null,"/v5/order/create"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-all"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"1/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/create-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/disconnected-cancel-all"),(0,r.kt)("td",{colSpan:"2",align:"center"},"-"),(0,r.kt)("td",{align:"center"},"1/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"4"},"GET"),(0,r.kt)("td",null,"/v5/order/realtime"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/history"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/execution/list"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/spot-borrow-check"),(0,r.kt)("td",{colSpan:"3",align:"center"},"-"),(0,r.kt)("td",{align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"\u6301\u5009"},"\u6301\u5009"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"\u7d93\u5178\u5e33\u6236",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{rowSpan:"2"},"\u8def\u5f91"),(0,r.kt)("th",{colSpan:"3",align:"center"},"\u7d93\u5178\u5e33\u6236"),(0,r.kt)("th",{rowSpan:"2"},"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"GET"),(0,r.kt)("td",null,"/v5/position/list"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/position/closed-pnl"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"POST"),(0,r.kt)("td",null,"/v5/position/set-leverage"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{rowSpan:"2"},"\u8def\u5f91"),(0,r.kt)("th",{colSpan:"4",align:"center"},"UTA Pro"),(0,r.kt)("th",{rowSpan:"2"},"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"option"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"GET"),(0,r.kt)("td",null,"/v5/position/list"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"2",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/position/closed-pnl"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"POST"),(0,r.kt)("td",null,"/v5/position/set-leverage"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"\u5e33\u6236"},"\u5e33\u6236"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"\u7d93\u5178\u5e33\u6236",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",null,"\u8def\u5f91"),(0,r.kt)("th",null),(0,r.kt)("th",null,"\u983b\u7387"),(0,r.kt)("th",null,"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"6"},"GET"),(0,r.kt)("td",null,"/v5/account/contract-transaction-log"),(0,r.kt)("td",null),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"/v5/account/wallet-balance"),(0,r.kt)("td",null,"accountType=SPOT"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"accountType=CONTRACT"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"/v5/account/fee-rate"),(0,r.kt)("td",null,"category=linear"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=spot"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=option"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",null,"\u8def\u5f91"),(0,r.kt)("th",null),(0,r.kt)("th",null,"\u983b\u7387"),(0,r.kt)("th",null,"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"9"},"GET"),(0,r.kt)("td",{rowSpan:"2"},"/v5/account/wallet-balance"),(0,r.kt)("td",null,"accountType=CONTRACT"),(0,r.kt)("td",{rowSpan:"2"},"50/s"),(0,r.kt)("td",{rowSpan:"2",align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"accountType=UNIFIED")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/borrow-history"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/collateral-info"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/coin-greeks"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/transaction-log"),(0,r.kt)("td",null,"accountType=UNIFIED"),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"/v5/account/fee-rate"),(0,r.kt)("td",null,"category=linear"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=spot"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=option"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"\u8cc7\u7522"},"\u8cc7\u7522"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",null,"\u8def\u5f91"),(0,r.kt)("th",null,"\u983b\u7387"),(0,r.kt)("td",null,"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"13"},"GET"),(0,r.kt)("td",null,"/v5/asset/transfer/query-asset-info"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-transfer-coin-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-inter-transfer-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-sub-member-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-universal-transfer-list"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-account-coins-balance"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-record"),(0,r.kt)("td",null,"100 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-sub-member-record"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-address"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-sub-member-address"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/query-record"),(0,r.kt)("td",null,"300 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/coin/query-info"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/exchange/order-record"),(0,r.kt)("td",null,"600 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"5"},"POST"),(0,r.kt)("td",null,"/v5/asset/transfer/inter-transfer"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/save-transfer-sub-member"),(0,r.kt)("td",null,"20 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/universal-transfer"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/create"),(0,r.kt)("td",null,"1 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/cancel"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")))),(0,r.kt)("h4",{id:"\u7528\u6236"},"\u7528\u6236"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",null,"\u8def\u5f91"),(0,r.kt)("th",null,"\u983b\u7387"),(0,r.kt)("td",null,"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"7"},"POST"),(0,r.kt)("td",null,"v5/user/create-sub-member"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/create-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/frozen-sub-member"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/update-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/update-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/delete-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/delete-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"GET"),(0,r.kt)("td",null,"/v5/user/query-sub-members"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/query-api"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/aff-customer-info"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")))),(0,r.kt)("h4",{id:"\u69d3\u687f\u4ee3\u5e63"},"\u69d3\u687f\u4ee3\u5e63"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{parentName:"tr",align:"center"},"\u8def\u5f91"),(0,r.kt)("th",{parentName:"tr",align:null},"\u983b\u7387"),(0,r.kt)("th",{parentName:"tr",align:null},"\u662f\u5426\u53ef\u63d0\u983b"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/order-record"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/purchase"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/redeem"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N"))))),(0,r.kt)("h4",{id:"\u5168\u5009\u69d3\u687f-\u7d71\u4e00\u5e33\u6236"},"\u5168\u5009\u69d3\u687f (\u7d71\u4e00\u5e33\u6236)"),(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("td",null,"\u76ee\u524d\uff0c\u8a72\u76ee\u9304\u4e0b\u7684\u63a5\u53e3\u6c92\u6709\u983b\u7387\u9650\u5236"))),(0,r.kt)("h4",{id:"\u5168\u5009\u69d3\u687f-\u7d93\u5178\u5e33\u6236"},"\u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{parentName:"tr",align:"center"},"\u8def\u5f91"),(0,r.kt)("th",{parentName:"tr",align:null},"\u983b\u7387"),(0,r.kt)("th",{parentName:"tr",align:null},"\u662f\u5426\u53ef\u63d0\u983b"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/loan-info"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/account"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/orders"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/repay-history"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/loan"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/repay"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/switch"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N"))))),(0,r.kt)("h2",{id:"\u4e0d\u540cvippro\u7b49\u7d1a\u7684\u63a5\u53e3\u9650\u983b\u898f\u5247"},"\u4e0d\u540cVIP/PRO\u7b49\u7d1a\u7684\u63a5\u53e3\u9650\u983b\u898f\u5247"),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},"\u8868\u683c\u4e2d\u7684\u6578\u503c\uff0c\u4ee3\u8868\u5c0d\u61c9\u7b49\u7d1a\u7684\u53ef\u7533\u8acb\u4e0a\u9650\uff0c\u4e26\u4e0d\u4ee3\u8868\u8655\u65bc\u8a72\u7b49\u7d1a\u7684\u7528\u6236\u5be6\u969b\u9ed8\u8a8d\u81ea\u52d5\u4eab\u6709\u5c0d\u61c9\u7684API Rate Limit"),(0,r.kt)("li",{parentName:"ul"},"\u7d93\u5178\u5e33\u6236\u4e0d\u652f\u6301\u4ea4\u6613USDC\u884d\u751f\u54c1"))),(0,r.kt)("admonition",{title:"\u6279\u91cf\u63a5\u53e3\u7279\u5225\u8aaa\u660e",type:"tip"},(0,r.kt)("p",{parentName:"admonition"},"\u6279\u6b21\u8a02\u55ae\u63a5\u53e3\uff08\u5305\u62ec\u5275\u5efa\u3001\u4fee\u6539\u548c\u53d6\u6d88\uff09\u7684\u901f\u7387\u9650\u5236\u4e0d\u6703\u8207\u55ae\u4e00\u7684\u4e0b\u6539\u64a4\u8acb\u6c42\u5171\u4eab\u3002",(0,r.kt)("em",{parentName:"p"},"\u4f8b\u5982\uff0c\u55ae\u4e00\u4e0b\u55ae\u63a5\u53e3\u983b\u7387\u662f100/\u79d2, \u6279\u91cf\u4e0b\u55ae\u63a5\u53e3\u662f100/\u79d2,\uff0c\u90a3\u9ebc\u7576\u7d50\u5408\u5169\u500b\u63a5\u53e3\u4e00\u8d77\u4e0b\u55ae\u6642\uff0c\n\u5c31\u64c1\u6709200\u55ae\u6bcf\u79d2\u7684\u80fd\u529b"),"\u3002"),(0,r.kt)("h4",{parentName:"admonition",id:"\u50c5categorylinear\u6216spot\u6642"},"\u50c5category=linear\u6216spot\u6642"),(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"\u6279\u91cf\u4e0b\u55ae\u7684\u63a5\u53e3\uff0capi rate limit\uff1a\u63a5\u53e3\u7684\u983b\u6b21\uff0c\u9084\u662f\u7d71\u4e00\u6cbf\u7528\u7576\u524d\u914d\u7f6e\uff0c\u4f46\u662f\u8a08\u6578\u6d88\u8017\u6703\u6839\u64da\u5be6\u969b\u7684\u8a02\u55ae\u6578\u4f86\u6d88\u8017\u3002\uff08\u6d88\u8017\u6578 = \u8acb\u6c42\u6578 * \u8acb\u6c42\u4e2d\u5305\u542b\u7684\u8a02\u55ae\u6578\uff09\uff0c\u696d\u52d9\u7dda\u914d\u7f6e\u76f8\u4e92\u7368\u7acb\u3002")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"\u6279\u91cf\u63a5\u53e3\u5141\u8a311-10orders/request\uff0c\u4f8b\u5982\uff0c\u6279\u91cf\u4e0b\u55ae\u8acb\u6c42\u4e00\u6b21\uff0c\u5305\u542b5\u500borders\uff0c\u5247\u672c\u6b21\u8acb\u6c42limit\u6578\u91cf\u6d88\u80175\u3002")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"\u82e51s\u5167\u7684\u6700\u5f8c\u4e00\u6b21\u8acb\u6c42\u7684\u6279\u91cf\u8a02\u55ae\uff0c\u90e8\u5206\u8d85\u9650\uff0c\u5247\u8d85\u904e\u7684\u90e8\u5206\u6703\u5931\u6557\uff08\u5831\u932f\u8d85\u904e\u4e0a\u9650\uff09\uff0c\u672a\u8d85\u904e\u7684\u90e8\u5206\u6703\u6210\u529f\u3002\u4f8b\u5982\uff0c\u90191s\u4e2d\uff0climit\u9084\u52695\uff0c\u4f46\u662f\u6b64\u6642\u4e0b\u4e86\u4e00\u500b\u5305\u542b8\u500borders\u7684\u6279\u91cf\u8acb\u6c42\uff0c\n\u90a3\u9ebc\u524d5\u500borders\u6703\u4e0b\u55ae\u6210\u529f\uff0c\u7b2c6-8\u7684orders\uff0c\u6703\u5831\u932f\u8d85\u904e\u4e0a\u9650\uff0c\u4e0b\u55ae\u5931\u6557\u3002")))),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{class:"custom_table"},(0,r.kt)("tr",null,(0,r.kt)("th",null),(0,r.kt)("th",{colSpan:"3",align:"center"},"\u7d93\u5178\u5e33\u6236"),(0,r.kt)("th",{colSpan:"3"},"UTA Pro")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"\u7b49\u7d1a\\\u7522\u54c1"),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u671f\u8ca8")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u671f\u6b0a")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u73fe\u8ca8")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u671f\u8ca8")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u671f\u6b0a")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u73fe\u8ca8"))),(0,r.kt)("tr",null,(0,r.kt)("td",null,"\u9ed8\u8a8d"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"20/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 1"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"25/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"25/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 2"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"30/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"30/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 3"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 4"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 5"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"\u81f3\u5c0aVIP"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO1"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO2"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"75/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO3"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"250/s"),(0,r.kt)("td",null,"250/s"),(0,r.kt)("td",null,"250/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO4"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO5"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")))),(0,r.kt)("h2",{id:"\u5982\u4f55\u63d0\u9ad8\u983b\u7387\u9650\u88fd"},"\u5982\u4f55\u63d0\u9ad8\u983b\u7387\u9650\u88fd"),(0,r.kt)("p",null,"\u8acb\u806f\u7e6b\u60a8\u7684\u5ba2\u6236\u7d93\u7406\u6216\u8005\u767c\u9001\u90f5\u4ef6\u5230 ",(0,r.kt)("a",{parentName:"p",href:"mailto:institutional_services@bybit.com"},"institutional_services@bybit.com"),"\uff0c\u6211\u5011\u6703\u5728 1-4 \u500b\u5de5\u4f5c\u65e5\u5167\u7b54\u5fa9\u3002\u90f5\u4ef6\u5167\u5bb9\u5fc5\u9808\u5305\u542b\u4ee5\u4e0b\u5167\u5bb9\uff1a"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"\u60a8\u7684\u59d3\u540d\u548c\u516c\u53f8\u540d\u7a31\u548c\u7c21\u4ecb"),(0,r.kt)("li",{parentName:"ol"},"\u60a8\u7684bybit \u8cec\u865fuid\u6216\u8a3b\u518a\u90f5\u7bb1\u624b\u6a5f\u865f,\u4ee5\u53ca\u60a8\u8981\u7533\u8acb\u63d0\u983b\u7684\u4ea4\u6613\u5c0d"),(0,r.kt)("li",{parentName:"ol"},"\u60a8\u4e0a\u500b\u6708\u7684\u4ea4\u6613\u91cf\uff08\u5403\u55ae/\u639b\u55ae\uff09\u4e26\u63d0\u4f9b\u622a\u5716"),(0,r.kt)("li",{parentName:"ol"},"\u7c21\u55ae\u4ecb\u7d39\u60a8\u7684\u4ea4\u6613\u7b56\u7565\u548c\u70ba\u4ec0\u9ebd\u9700\u8981\u66f4\u9ad8\u9650\u983b"),(0,r.kt)("li",{parentName:"ol"},"\u5982\u679c\u53ef\u4ee5\uff0c\u8acb\u63d0\u4f9b\u60a8\u7684\u6210\u4ea4\u8a18\u9304csv\u6587\u6a94")))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[81832],{3905:(t,l,n)=>{n.d(l,{Zo:()=>s,kt:()=>p});var e=n(67294);function r(t,l,n){return l in t?Object.defineProperty(t,l,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[l]=n,t}function a(t,l){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var e=Object.getOwnPropertySymbols(t);l&&(e=e.filter((function(l){return Object.getOwnPropertyDescriptor(t,l).enumerable}))),n.push.apply(n,e)}return n}function k(t){for(var l=1;l=0||(r[n]=t[n]);return r}(t,l);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);for(e=0;e=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(r[n]=t[n])}return r}var u=e.createContext({}),i=function(t){var l=e.useContext(u),n=l;return t&&(n="function"==typeof t?t(l):k(k({},l),t)),n},s=function(t){var l=i(t.components);return e.createElement(u.Provider,{value:l},t.children)},o={inlineCode:"code",wrapper:function(t){var l=t.children;return e.createElement(e.Fragment,{},l)}},c=e.forwardRef((function(t,l){var n=t.components,r=t.mdxType,a=t.originalType,u=t.parentName,s=d(t,["components","mdxType","originalType","parentName"]),c=i(n),p=r,m=c["".concat(u,".").concat(p)]||c[p]||o[p]||a;return n?e.createElement(m,k(k({ref:l},s),{},{components:n})):e.createElement(m,k({ref:l},s))}));function p(t,l){var n=arguments,r=l&&l.mdxType;if("string"==typeof t||r){var a=n.length,k=new Array(a);k[0]=c;var d={};for(var u in l)hasOwnProperty.call(l,u)&&(d[u]=l[u]);d.originalType=t,d.mdxType="string"==typeof t?t:r,k[1]=d;for(var i=2;i{n.r(l),n.d(l,{assets:()=>u,contentTitle:()=>k,default:()=>m,frontMatter:()=>a,metadata:()=>d,toc:()=>i});var e=n(87462),r=(n(67294),n(3905));const a={title:"\u983b\u7387\u9650\u5236",sidebar_label:"\u983b\u7387\u9650\u5236"},k=void 0,d={unversionedId:"v5/rate-limit",id:"v5/rate-limit",title:"\u983b\u7387\u9650\u5236",description:"IP\u9650\u983b",source:"@site/i18n/zh-TW/docusaurus-plugin-content-docs/current/v5/rate-limit.mdx",sourceDirName:"v5",slug:"/v5/rate-limit",permalink:"/docs/zh-TW/v5/rate-limit",draft:!1,tags:[],version:"current",frontMatter:{title:"\u983b\u7387\u9650\u5236",sidebar_label:"\u983b\u7387\u9650\u5236"},sidebar:"v5SideBar",previous:{title:"Websocket\u4e0b\u55ae\u6307\u5357",permalink:"/docs/zh-TW/v5/websocket/trade/guideline"},next:{title:"\u679a\u8209\u5b9a\u7fa9",permalink:"/docs/zh-TW/v5/enum"}},u={},i=[{value:"IP\u9650\u983b",id:"ip\u9650\u983b",level:2},{value:"\u8cec\u6236\u983b\u7387\u9650\u88fd",id:"\u8cec\u6236\u983b\u7387\u9650\u88fd",level:2},{value:"\u63a5\u53e3\u983b\u7387\u9650\u5236\u8868",id:"\u63a5\u53e3\u983b\u7387\u9650\u5236\u8868",level:3},{value:"\u4ea4\u6613",id:"\u4ea4\u6613",level:4},{value:"\u6301\u5009",id:"\u6301\u5009",level:4},{value:"\u5e33\u6236",id:"\u5e33\u6236",level:4},{value:"\u8cc7\u7522",id:"\u8cc7\u7522",level:4},{value:"\u7528\u6236",id:"\u7528\u6236",level:4},{value:"\u69d3\u687f\u4ee3\u5e63",id:"\u69d3\u687f\u4ee3\u5e63",level:4},{value:"\u5168\u5009\u69d3\u687f (\u7d71\u4e00\u5e33\u6236)",id:"\u5168\u5009\u69d3\u687f-\u7d71\u4e00\u5e33\u6236",level:4},{value:"\u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)",id:"\u5168\u5009\u69d3\u687f-\u7d93\u5178\u5e33\u6236",level:4},{value:"\u4e0d\u540cVIP/PRO\u7b49\u7d1a\u7684\u63a5\u53e3\u9650\u983b\u898f\u5247",id:"\u4e0d\u540cvippro\u7b49\u7d1a\u7684\u63a5\u53e3\u9650\u983b\u898f\u5247",level:2},{value:"\u5982\u4f55\u63d0\u9ad8\u983b\u7387\u9650\u88fd",id:"\u5982\u4f55\u63d0\u9ad8\u983b\u7387\u9650\u88fd",level:2}],s=t=>function(l){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,r.kt)("div",l)},o=s("Tabs"),c=s("TabItem"),p={toc:i};function m(t){let{components:l,...n}=t;return(0,r.kt)("wrapper",(0,e.Z)({},p,n,{components:l,mdxType:"MDXLayout"}),(0,r.kt)("h2",{id:"ip\u9650\u983b"},"IP\u9650\u983b"),(0,r.kt)("admonition",{type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"\u5982\u679c\u60a8\u6536\u5230",(0,r.kt)("strong",{parentName:"p"},"HTTP 403"),"\uff08\u62d2\u7d55\u8a2a\u554f\uff09\u97ff\u61c9, \u60a8\u7684 IP \u5df2\u88ab\u66ab\u6642\u6216\u6c38\u4e45\u7981\u6b62\u3002 ",(0,r.kt)("strong",{parentName:"p"},"\u60a8\u61c9\u7acb\u5373\u67e5\u770b\u4ee5\u4e0b\u6307\u5357\uff0c\u4ee5\u78ba\u4fdd\u60a8\u7684\u61c9\u7528\u7a0b\u5e8f\u4e0d\u6703\u7e7c\u7e8c\u9055\u53cd\u9650\u5236"),"\u3002\u5982\u679c\u60a8\u5728 30 \u5206\u9418\u5f8c\n\u4ecd\u88ab\u7981\u6b62\uff0c\u5247\u60a8\u53ef\u80fd\u6703\u88ab\u6c38\u4e45\u7981\u6b62\u3002")),(0,r.kt)("p",null,"\u6211\u5011\u4e0d\u5efa\u8b70\u60a8\u5728\u9019\u4e9b\u9650\u5236\u7684\u908a\u7de3\u904b\u884c\u60a8\u7684\u61c9\u7528\u7a0b\u5e8f\uff0c\u4ee5\u9632\u7570\u5e38\u7684\u7db2\u7d61\u6d3b\u52d5\u5c0e\u81f4\u610f\u5916\u9055\u898f\u3002"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"GET"),"/",(0,r.kt)("inlineCode",{parentName:"li"},"POST")," \u8acb\u6c42 (\u5171\u4eab):",(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"\u9023\u7e8c 5 \u79d2\u5167\u6bcf\u79d2\u4e0d\u8d85\u904e 600 \u500b\u8acb\u6c42")))),(0,r.kt)("admonition",{type:"note"},(0,r.kt)("p",{parentName:"admonition"},"\u6240\u6709\u5230",(0,r.kt)("inlineCode",{parentName:"p"},"api.bybit.com"),"\u6216",(0,r.kt)("inlineCode",{parentName:"p"},"api.bytick.com"),"\u7684\u6d41\u91cf\u5171\u4eab\u6b64\u9650\u5236\uff0c\u7121\u8ad6\u662f\u8a2a\u554f\u73fe\u8ca8\u3001\u671f\u8ca8\u9084\u662f\u671f\u6b0a\u3002")),(0,r.kt)("p",null,"\u9055\u53cd\u9650\u5236\u5f8c\uff0c\u60a8\u7684 IP \u5c07\u88ab\u7981\u6b62\u4e00\u6bb5\u6642\u9593\uff08\u901a\u5e38\u70ba 30 \u5206\u9418\uff09\u3002 \u6301\u7e8c\u9055\u53cd\u9650\u5236\u5c07\u5c0e\u81f4\u6c38\u4e45\u7981\u6b62\u3002 \u6211\u5011\u4e0d\u80fd\u64a4\u92b7\u6c38\u4e45\u7981\u4ee4\u6216\u7e2e\u77ed\u81e8\u6642\u7981\u4ee4\u3002"),(0,r.kt)("h2",{id:"\u8cec\u6236\u983b\u7387\u9650\u88fd"},"\u8cec\u6236\u983b\u7387\u9650\u88fd"),(0,r.kt)("admonition",{type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"\u5982\u679c\u60a8\u6536\u5230\u9019\u6a23\u7684\u97ff\u61c9",(0,r.kt)("inlineCode",{parentName:"p"},'"ret_msg": "Too many visits!"'),", \u5247\u8868\u793a\u60a8\u89f8\u767c\u4e86\u5e33\u6236\u983b\u7387\u9650\u5236, \u8acb\u7b49\u5230\u983b\u7387\u9650\u5236\u91cd\u7f6e\u4ee5\u5f8c, \u518d\u7e7c\u7e8c\u767c\u9001\u8acb\u6c42\u3002")),(0,r.kt)("p",null,"Bybit\u57fa\u65bc",(0,r.kt)("strong",{parentName:"p"},"\u6bcf\u79d2\u937e"),"\u7684\u6efe\u52d5\u6642\u9593\u7a97\u53e3\u4f86\u505a\u983b\u7387\u9650\u88fd\uff0c\u4e26\u4e14\u662f\u6309",(0,r.kt)("strong",{parentName:"p"},"\u8cec\u6236"),"\uff08uid\uff09\u4f86\u505a\u5283\u5206\u9650\u88fd\uff0c\u6bcf\u6b21\u8acb\u6c42API\u97ff\u61c9\u982d(response header)\u4e2d\u90fd\u6703\u5305\u542b\u5982\u4e0b\u5b57\u6bb5\uff1a"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit-Status")," - \u8a72\u63a5\u53e3\u7576\u524d\u6642\u9593\u7a97\u53e3\u5269\u4f59\u53ef\u7528\u8acb\u6c42\u6578"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit")," - \u8a72\u63a5\u53e3\u7576\u524d\u983b\u7387\u9650\u88fd\u4e0a\u9650"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"X-Bapi-Limit-Reset-Timestamp")," - \u5982\u679c\u60a8\u5df2\u8d85\u904e\u8a72\u63a5\u53e3\u7576\u524d\u7a97\u53e3\u983b\u7387\u9650\u88fd\uff0c\u8a72\u5b57\u6bb5\u8868\u793a\u4e0b\u500b\u53ef\u7528\u6642\u9593\u7a97\u53e3\u7684\u6642\u9593\u6233\uff08\u6beb\u79d2\uff09\uff0c\u5373\u4ec0\u9ebd\u6642\u5019\u53ef\u4ee5\u6062\u5fa9\u8a2a\u554f\uff1b\u5982\u679c\u60a8\u672a\u8d85\u904e\u8a72\u63a5\u53e3\u7576\u524d\u7a97\u53e3\u983b\u7387\u9650\u88fd\uff0c\u8a72\u5b57\u6bb5\u8868\u793a\u8fd4\u56de\u7684\u662f\u7576\u524d\u670d\u52d9\u5668\u6642\u9593\uff08\u6beb\u79d2).")),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},"Http \u97ff\u61c9\u982d\u793a\u4f8b")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-http"},"\u25b6Response Headers\nContent-Type: application/json; charset=utf-8\nContent-Length: 141\nX-Bapi-Limit: 100\nX-Bapi-Limit-Status: 99\nX-Bapi-Limit-Reset-Timestamp: 1672738134824\n")),(0,r.kt)("h3",{id:"\u63a5\u53e3\u983b\u7387\u9650\u5236\u8868"},"\u63a5\u53e3\u983b\u7387\u9650\u5236\u8868"),(0,r.kt)("h4",{id:"\u4ea4\u6613"},"\u4ea4\u6613"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"\u7d93\u5178\u5e33\u6236",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{rowSpan:"2"},"\u8def\u5f91"),(0,r.kt)("th",{colSpan:"3",align:"center"},"\u7d93\u5178\u5e33\u6236"),(0,r.kt)("th",{rowSpan:"2"},"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"4"},"POST"),(0,r.kt)("td",null,"/v5/order/create"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-all"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"GET"),(0,r.kt)("td",null,"/v5/order/realtime"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/history"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/execution/list"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{rowSpan:"2"},"\u8def\u5f91"),(0,r.kt)("th",{colSpan:"4",align:"center"},"UTA Pro"),(0,r.kt)("th",{rowSpan:"2"},"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"option"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"8"},"POST"),(0,r.kt)("td",null,"/v5/order/create"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-all"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"1/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/create-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/amend-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/cancel-batch"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"20/s"),(0,r.kt)("td",{align:"center"},"Y")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/disconnected-cancel-all"),(0,r.kt)("td",{colSpan:"2",align:"center"},"-"),(0,r.kt)("td",{align:"center"},"1/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"4"},"GET"),(0,r.kt)("td",null,"/v5/order/realtime"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/history"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/execution/list"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"3",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/order/spot-borrow-check"),(0,r.kt)("td",{colSpan:"3",align:"center"},"-"),(0,r.kt)("td",{align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"\u6301\u5009"},"\u6301\u5009"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"\u7d93\u5178\u5e33\u6236",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{rowSpan:"2"},"\u8def\u5f91"),(0,r.kt)("th",{colSpan:"3",align:"center"},"\u7d93\u5178\u5e33\u6236"),(0,r.kt)("th",{rowSpan:"2"},"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"GET"),(0,r.kt)("td",null,"/v5/position/list"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/position/closed-pnl"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"POST"),(0,r.kt)("td",null,"/v5/position/set-leverage"),(0,r.kt)("td",{colSpan:"2",align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",{rowSpan:"2"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{rowSpan:"2"},"\u8def\u5f91"),(0,r.kt)("th",{colSpan:"4",align:"center"},"UTA Pro"),(0,r.kt)("th",{rowSpan:"2"},"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("th",null,"inverse"),(0,r.kt)("th",null,"linear"),(0,r.kt)("th",null,"option"),(0,r.kt)("th",null,"spot")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"GET"),(0,r.kt)("td",null,"/v5/position/list"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{colSpan:"2",align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/position/closed-pnl"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"50/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"POST"),(0,r.kt)("td",null,"/v5/position/set-leverage"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"10/s"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"-"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"\u5e33\u6236"},"\u5e33\u6236"),(0,r.kt)(o,{groupId:"account-type",mdxType:"Tabs"},(0,r.kt)(c,{value:"classic",label:"\u7d93\u5178\u5e33\u6236",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",null,"\u8def\u5f91"),(0,r.kt)("th",null),(0,r.kt)("th",null,"\u983b\u7387"),(0,r.kt)("th",null,"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"6"},"GET"),(0,r.kt)("td",null,"/v5/account/contract-transaction-log"),(0,r.kt)("td",null),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"2"},"/v5/account/wallet-balance"),(0,r.kt)("td",null,"accountType=SPOT"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"accountType=CONTRACT"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"/v5/account/fee-rate"),(0,r.kt)("td",null,"category=linear"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=spot"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=option"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N"))))),(0,r.kt)(c,{value:"uta-pro",label:"UTA Pro",mdxType:"TabItem"},(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",null,"\u8def\u5f91"),(0,r.kt)("th",null),(0,r.kt)("th",null,"\u983b\u7387"),(0,r.kt)("th",null,"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"9"},"GET"),(0,r.kt)("td",{rowSpan:"2"},"/v5/account/wallet-balance"),(0,r.kt)("td",null,"accountType=CONTRACT"),(0,r.kt)("td",{rowSpan:"2"},"50/s"),(0,r.kt)("td",{rowSpan:"2",align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"accountType=UNIFIED")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/borrow-history"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/collateral-info"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/coin-greeks"),(0,r.kt)("td",null),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/account/transaction-log"),(0,r.kt)("td",null,"accountType=UNIFIED"),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"/v5/account/fee-rate"),(0,r.kt)("td",null,"category=linear"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=spot"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"category=option"),(0,r.kt)("td",null,"5/s"),(0,r.kt)("td",{align:"center"},"N")))))),(0,r.kt)("h4",{id:"\u8cc7\u7522"},"\u8cc7\u7522"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",null,"\u8def\u5f91"),(0,r.kt)("th",null,"\u983b\u7387"),(0,r.kt)("td",null,"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"13"},"GET"),(0,r.kt)("td",null,"/v5/asset/transfer/query-asset-info"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-transfer-coin-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-inter-transfer-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-sub-member-list"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-universal-transfer-list"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/query-account-coins-balance"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-record"),(0,r.kt)("td",null,"100 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-sub-member-record"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-address"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/deposit/query-sub-member-address"),(0,r.kt)("td",null,"300 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/query-record"),(0,r.kt)("td",null,"300 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/coin/query-info"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/exchange/order-record"),(0,r.kt)("td",null,"600 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"5"},"POST"),(0,r.kt)("td",null,"/v5/asset/transfer/inter-transfer"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/save-transfer-sub-member"),(0,r.kt)("td",null,"20 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/transfer/universal-transfer"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/create"),(0,r.kt)("td",null,"1 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/asset/withdraw/cancel"),(0,r.kt)("td",null,"60 req/min"),(0,r.kt)("td",null,"N")))),(0,r.kt)("h4",{id:"\u7528\u6236"},"\u7528\u6236"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("th",null,"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",null,"\u8def\u5f91"),(0,r.kt)("th",null,"\u983b\u7387"),(0,r.kt)("td",null,"\u662f\u5426\u53ef\u63d0\u983b")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"7"},"POST"),(0,r.kt)("td",null,"v5/user/create-sub-member"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/create-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/frozen-sub-member"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/update-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/update-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/delete-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/delete-sub-api"),(0,r.kt)("td",null,"5 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",{rowSpan:"3"},"GET"),(0,r.kt)("td",null,"/v5/user/query-sub-members"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/query-api"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"/v5/user/aff-customer-info"),(0,r.kt)("td",null,"10 req/s"),(0,r.kt)("td",null,"N")))),(0,r.kt)("h4",{id:"\u69d3\u687f\u4ee3\u5e63"},"\u69d3\u687f\u4ee3\u5e63"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{parentName:"tr",align:"center"},"\u8def\u5f91"),(0,r.kt)("th",{parentName:"tr",align:null},"\u983b\u7387"),(0,r.kt)("th",{parentName:"tr",align:null},"\u662f\u5426\u53ef\u63d0\u983b"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/order-record"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/purchase"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-lever-token/redeem"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N"))))),(0,r.kt)("h4",{id:"\u5168\u5009\u69d3\u687f-\u7d71\u4e00\u5e33\u6236"},"\u5168\u5009\u69d3\u687f (\u7d71\u4e00\u5e33\u6236)"),(0,r.kt)("table",{border:"0.8"},(0,r.kt)("tr",null,(0,r.kt)("td",null,"\u76ee\u524d\uff0c\u8a72\u76ee\u9304\u4e0b\u7684\u63a5\u53e3\u6c92\u6709\u983b\u7387\u9650\u5236"))),(0,r.kt)("h4",{id:"\u5168\u5009\u69d3\u687f-\u7d93\u5178\u5e33\u6236"},"\u5168\u5009\u69d3\u687f (\u7d93\u5178\u5e33\u6236)"),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"\u8acb\u6c42\u65b9\u5f0f"),(0,r.kt)("th",{parentName:"tr",align:"center"},"\u8def\u5f91"),(0,r.kt)("th",{parentName:"tr",align:null},"\u983b\u7387"),(0,r.kt)("th",{parentName:"tr",align:null},"\u662f\u5426\u53ef\u63d0\u983b"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/loan-info"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/account"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/orders"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"GET"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/repay-history"),(0,r.kt)("td",{parentName:"tr",align:null},"50 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/loan"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/repay"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"POST"),(0,r.kt)("td",{parentName:"tr",align:"center"},"/v5/spot-cross-margin-trade/switch"),(0,r.kt)("td",{parentName:"tr",align:null},"20 req/s"),(0,r.kt)("td",{parentName:"tr",align:null},"N"))))),(0,r.kt)("h2",{id:"\u4e0d\u540cvippro\u7b49\u7d1a\u7684\u63a5\u53e3\u9650\u983b\u898f\u5247"},"\u4e0d\u540cVIP/PRO\u7b49\u7d1a\u7684\u63a5\u53e3\u9650\u983b\u898f\u5247"),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},"\u8868\u683c\u4e2d\u7684\u6578\u503c\uff0c\u4ee3\u8868\u5c0d\u61c9\u7b49\u7d1a\u7684\u53ef\u7533\u8acb\u4e0a\u9650\uff0c\u4e26\u4e0d\u4ee3\u8868\u8655\u65bc\u8a72\u7b49\u7d1a\u7684\u7528\u6236\u5be6\u969b\u9ed8\u8a8d\u81ea\u52d5\u4eab\u6709\u5c0d\u61c9\u7684API Rate Limit"),(0,r.kt)("li",{parentName:"ul"},"\u7d93\u5178\u5e33\u6236\u4e0d\u652f\u6301\u4ea4\u6613USDC\u884d\u751f\u54c1"))),(0,r.kt)("admonition",{title:"\u6279\u91cf\u63a5\u53e3\u7279\u5225\u8aaa\u660e",type:"tip"},(0,r.kt)("p",{parentName:"admonition"},"\u6279\u6b21\u8a02\u55ae\u63a5\u53e3\uff08\u5305\u62ec\u5275\u5efa\u3001\u4fee\u6539\u548c\u53d6\u6d88\uff09\u7684\u901f\u7387\u9650\u5236\u4e0d\u6703\u8207\u55ae\u4e00\u7684\u4e0b\u6539\u64a4\u8acb\u6c42\u5171\u4eab\u3002",(0,r.kt)("em",{parentName:"p"},"\u4f8b\u5982\uff0c\u55ae\u4e00\u4e0b\u55ae\u63a5\u53e3\u983b\u7387\u662f100/\u79d2, \u6279\u91cf\u4e0b\u55ae\u63a5\u53e3\u662f100/\u79d2,\uff0c\u90a3\u9ebc\u7576\u7d50\u5408\u5169\u500b\u63a5\u53e3\u4e00\u8d77\u4e0b\u55ae\u6642\uff0c\n\u5c31\u64c1\u6709200\u55ae\u6bcf\u79d2\u7684\u80fd\u529b"),"\u3002"),(0,r.kt)("h4",{parentName:"admonition",id:"\u50c5categorylinear\u6216spot\u6642"},"\u50c5category=linear\u6216spot\u6642"),(0,r.kt)("ul",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"\u6279\u91cf\u4e0b\u55ae\u7684\u63a5\u53e3\uff0capi rate limit\uff1a\u63a5\u53e3\u7684\u983b\u6b21\uff0c\u9084\u662f\u7d71\u4e00\u6cbf\u7528\u7576\u524d\u914d\u7f6e\uff0c\u4f46\u662f\u8a08\u6578\u6d88\u8017\u6703\u6839\u64da\u5be6\u969b\u7684\u8a02\u55ae\u6578\u4f86\u6d88\u8017\u3002\uff08\u6d88\u8017\u6578 = \u8acb\u6c42\u6578 * \u8acb\u6c42\u4e2d\u5305\u542b\u7684\u8a02\u55ae\u6578\uff09\uff0c\u696d\u52d9\u7dda\u914d\u7f6e\u76f8\u4e92\u7368\u7acb\u3002")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"\u6279\u91cf\u63a5\u53e3\u5141\u8a311-10orders/request\uff0c\u4f8b\u5982\uff0c\u6279\u91cf\u4e0b\u55ae\u8acb\u6c42\u4e00\u6b21\uff0c\u5305\u542b5\u500borders\uff0c\u5247\u672c\u6b21\u8acb\u6c42limit\u6578\u91cf\u6d88\u80175\u3002")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"\u82e51s\u5167\u7684\u6700\u5f8c\u4e00\u6b21\u8acb\u6c42\u7684\u6279\u91cf\u8a02\u55ae\uff0c\u90e8\u5206\u8d85\u9650\uff0c\u5247\u8d85\u904e\u7684\u90e8\u5206\u6703\u5931\u6557\uff08\u5831\u932f\u8d85\u904e\u4e0a\u9650\uff09\uff0c\u672a\u8d85\u904e\u7684\u90e8\u5206\u6703\u6210\u529f\u3002\u4f8b\u5982\uff0c\u90191s\u4e2d\uff0climit\u9084\u52695\uff0c\u4f46\u662f\u6b64\u6642\u4e0b\u4e86\u4e00\u500b\u5305\u542b8\u500borders\u7684\u6279\u91cf\u8acb\u6c42\uff0c\n\u90a3\u9ebc\u524d5\u500borders\u6703\u4e0b\u55ae\u6210\u529f\uff0c\u7b2c6-8\u7684orders\uff0c\u6703\u5831\u932f\u8d85\u904e\u4e0a\u9650\uff0c\u4e0b\u55ae\u5931\u6557\u3002")))),(0,r.kt)("span",{class:"blocky_table"},(0,r.kt)("table",{class:"custom_table"},(0,r.kt)("tr",null,(0,r.kt)("th",null),(0,r.kt)("th",{colSpan:"3",align:"center"},"\u7d93\u5178\u5e33\u6236"),(0,r.kt)("th",{colSpan:"3"},"UTA Pro")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"\u7b49\u7d1a\\\u7522\u54c1"),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u671f\u8ca8")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u671f\u6b0a")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u73fe\u8ca8")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u671f\u8ca8")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u671f\u6b0a")),(0,r.kt)("td",null,(0,r.kt)("b",null,"\u73fe\u8ca8"))),(0,r.kt)("tr",null,(0,r.kt)("td",null,"\u9ed8\u8a8d"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"10/s"),(0,r.kt)("td",null,"20/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 1"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"25/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"20/s"),(0,r.kt)("td",null,"25/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 2"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"30/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"30/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 3"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 4"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"VIP 5"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"\u81f3\u5c0aVIP"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"60/s"),(0,r.kt)("td",null,"40/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO1"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"50/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO2"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"150/s"),(0,r.kt)("td",null,"75/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO3"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"250/s"),(0,r.kt)("td",null,"250/s"),(0,r.kt)("td",null,"250/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO4"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO5"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")),(0,r.kt)("tr",null,(0,r.kt)("td",null,"PRO6"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"200/s"),(0,r.kt)("td",null,"100/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s"),(0,r.kt)("td",null,"300/s")))),(0,r.kt)("h2",{id:"\u5982\u4f55\u63d0\u9ad8\u983b\u7387\u9650\u88fd"},"\u5982\u4f55\u63d0\u9ad8\u983b\u7387\u9650\u88fd"),(0,r.kt)("p",null,"\u8acb\u806f\u7e6b\u60a8\u7684\u5ba2\u6236\u7d93\u7406\u6216\u8005\u767c\u9001\u90f5\u4ef6\u5230 ",(0,r.kt)("a",{parentName:"p",href:"mailto:institutional_services@bybit.com"},"institutional_services@bybit.com"),"\uff0c\u6211\u5011\u6703\u5728 1-4 \u500b\u5de5\u4f5c\u65e5\u5167\u7b54\u5fa9\u3002\u90f5\u4ef6\u5167\u5bb9\u5fc5\u9808\u5305\u542b\u4ee5\u4e0b\u5167\u5bb9\uff1a"),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"\u60a8\u7684\u59d3\u540d\u548c\u516c\u53f8\u540d\u7a31\u548c\u7c21\u4ecb"),(0,r.kt)("li",{parentName:"ol"},"\u60a8\u7684bybit \u8cec\u865fuid\u6216\u8a3b\u518a\u90f5\u7bb1\u624b\u6a5f\u865f,\u4ee5\u53ca\u60a8\u8981\u7533\u8acb\u63d0\u983b\u7684\u4ea4\u6613\u5c0d"),(0,r.kt)("li",{parentName:"ol"},"\u60a8\u4e0a\u500b\u6708\u7684\u4ea4\u6613\u91cf\uff08\u5403\u55ae/\u639b\u55ae\uff09\u4e26\u63d0\u4f9b\u622a\u5716"),(0,r.kt)("li",{parentName:"ol"},"\u7c21\u55ae\u4ecb\u7d39\u60a8\u7684\u4ea4\u6613\u7b56\u7565\u548c\u70ba\u4ec0\u9ebd\u9700\u8981\u66f4\u9ad8\u9650\u983b"),(0,r.kt)("li",{parentName:"ol"},"\u5982\u679c\u53ef\u4ee5\uff0c\u8acb\u63d0\u4f9b\u60a8\u7684\u6210\u4ea4\u8a18\u9304csv\u6587\u6a94")))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/b7cfb3da.1366f4ef.js b/zh-TW/assets/js/b7cfb3da.1366f4ef.js new file mode 100644 index 0000000000..7d76def565 --- /dev/null +++ b/zh-TW/assets/js/b7cfb3da.1366f4ef.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[69998],{3905:(t,e,n)=>{n.d(e,{Zo:()=>m,kt:()=>N});var a=n(67294);function r(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}function l(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);e&&(a=a.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,a)}return n}function i(t){for(var e=1;e=0||(r[n]=t[n]);return r}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(r[n]=t[n])}return r}var o=a.createContext({}),d=function(t){var e=a.useContext(o),n=e;return t&&(n="function"==typeof t?t(e):i(i({},e),t)),n},m=function(t){var e=d(t.components);return a.createElement(o.Provider,{value:e},t.children)},k={inlineCode:"code",wrapper:function(t){var e=t.children;return a.createElement(a.Fragment,{},e)}},s=a.forwardRef((function(t,e){var n=t.components,r=t.mdxType,l=t.originalType,o=t.parentName,m=p(t,["components","mdxType","originalType","parentName"]),s=d(n),N=r,g=s["".concat(o,".").concat(N)]||s[N]||k[N]||l;return n?a.createElement(g,i(i({ref:e},m),{},{components:n})):a.createElement(g,i({ref:e},m))}));function N(t,e){var n=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var l=n.length,i=new Array(l);i[0]=s;var p={};for(var o in e)hasOwnProperty.call(e,o)&&(p[o]=e[o]);p.originalType=t,p.mdxType="string"==typeof t?t:r,i[1]=p;for(var d=2;d{n.r(e),n.d(e,{assets:()=>o,contentTitle:()=>i,default:()=>u,frontMatter:()=>l,metadata:()=>p,toc:()=>d});var a=n(87462),r=(n(67294),n(3905));const l={title:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",sidebar_label:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",sidebar_position:1},i=void 0,p={unversionedId:"v5/position/position",id:"v5/position/position",title:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",description:"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49",source:"@site/i18n/zh-TW/docusaurus-plugin-content-docs/current/v5/position/position.mdx",sourceDirName:"v5/position",slug:"/v5/position/",permalink:"/docs/zh-TW/v5/position/",draft:!1,tags:[],version:"current",sidebarPosition:1,frontMatter:{title:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",sidebar_label:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",sidebar_position:1},sidebar:"v5SideBar",previous:{title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",permalink:"/docs/zh-TW/v5/order/dcp"},next:{title:"\u8a2d\u7f6e\u69d3\u687f",permalink:"/docs/zh-TW/v5/position/leverage"}},o={},d=[{value:"HTTP \u8acb\u6c42",id:"http-\u8acb\u6c42",level:3},{value:"\u8acb\u6c42\u53c3\u6578",id:"\u8acb\u6c42\u53c3\u6578",level:3},{value:"\u97ff\u61c9\u53c3\u6578",id:"\u97ff\u61c9\u53c3\u6578",level:3},{value:"\u8acb\u6c42\u793a\u4f8b",id:"\u8acb\u6c42\u793a\u4f8b",level:3},{value:"\u97ff\u61c9\u793a\u4f8b",id:"\u97ff\u61c9\u793a\u4f8b",level:3}],m=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,r.kt)("div",e)},k=m("Button"),s=m("Tabs"),N=m("TabItem"),g={toc:d};function u(t){let{components:e,...n}=t;return(0,r.kt)("wrapper",(0,a.Z)({},g,n,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49"),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},(0,r.kt)("strong",{parentName:"p"},"\u7d71\u4e00\u5e33\u6236\u8986\u84cb\u7bc4\u570d: USDT\u6c38\u7e8c / USDC\u6c38\u7e8c / USDC\u4ea4\u5272 / \u53cd\u5411\u5408\u7d04 / \u671f\u6b0a"),(0,r.kt)("br",null),"\n",(0,r.kt)("strong",{parentName:"p"},"\u7d93\u5178\u5e33\u6236\u8986\u84cb\u7bc4\u570d: USDT\u6c38\u7e8c / \u53cd\u5411\u5408\u7d04"))),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("p",{parentName:"admonition"},"\u95dc\u65bc\u53cd\u5411\u5408\u7d04\u7684\u984d\u5916\u67e5\u8a62\u898f\u5247,"),(0,r.kt)("ol",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ol"},'\u901a\u904e\u9019\u6a23\u5b50\u67e5\u8a62"/v5/position/list?category=inverse", \u60a8\u53ef\u4ee5\u67e5\u8a62\u5230\u6240\u6709\u7576\u524d\u6301\u6709\u7684\u53cd\u5411\u5408\u7d04\u5009\u4f4d;'),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("inlineCode",{parentName:"li"},"symbol"),"\u5b57\u6bb5\u652f\u6301\u50b3\u5165\u6700\u591a10\u500b\u53cd\u5411\u5408\u7d04;"))),(0,r.kt)("h3",{id:"http-\u8acb\u6c42"},"HTTP \u8acb\u6c42"),(0,r.kt)("p",null,"GET ",(0,r.kt)("inlineCode",{parentName:"p"},"/v5/position/list")),(0,r.kt)("h3",{id:"\u8acb\u6c42\u53c3\u6578"},"\u8acb\u6c42\u53c3\u6578"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,r.kt)("th",{parentName:"tr",align:"left"},"\u662f\u5426\u5fc5\u9700"),(0,r.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,r.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("a",{parentName:"td",href:"../v5/enum#category"},"category")),(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("strong",{parentName:"td"},"true")),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7522\u54c1\u985e\u578b ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236: ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),",",(0,r.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"option")),(0,r.kt)("li",null,"\u7d93\u5178\u5e33\u6236: ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5408\u7d04\u540d\u7a31",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u82e5\u50b3\u4e86",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),", \u5247\u4e0d\u7ba1\u662f\u5426\u6709\u5009\u4f4d\u90fd\u8fd4\u56de\u8a72symbol\u6578\u64da"),(0,r.kt)("li",null,"\u82e5",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),"\u4e0d\u50b3\u4f46\u50b3\u4e86",(0,r.kt)("inlineCode",{parentName:"td"},"settleCoin"),", \u5247\u50c5\u8fd4\u56de\u6709\u5be6\u969b\u5009\u4f4d\u7684\u6578\u64da")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"baseCoin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u5e63\u7a2e. \u50c5",(0,r.kt)("inlineCode",{parentName:"td"},"option"),". \u82e5\u4e0d\u50b3\uff0c\u5247\u8fd4\u56de\u671f\u6b0a\u4e0b\u6240\u6709\u6301\u5009")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"settleCoin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7d50\u7b97\u5e63\u7a2e. \u5c0d\u65bcUSDT\u548cUSDC\u671f\u8ca8\u800c\u8a00\uff0c",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),"\u548c",(0,r.kt)("inlineCode",{parentName:"td"},"settleCon"),(0,r.kt)("strong",{parentName:"td"},"\u5fc5\u50b3"),"\u5176\u4e2d\u4e00\u500b, \u82e5\u90fd\u50b3\uff0c\u5247",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),"\u6709\u66f4\u9ad8\u7684\u512a\u5148\u7d1a")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"limit"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6bcf\u9801\u6578\u91cf\u9650\u5236. ","[",(0,r.kt)("inlineCode",{parentName:"td"},"1"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"200"),"]",". \u9ed8\u8a8d: ",(0,r.kt)("inlineCode",{parentName:"td"},"20"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"cursor"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6e38\u6a19\uff0c\u7528\u65bc\u7ffb\u9801")))),(0,r.kt)("h3",{id:"\u97ff\u61c9\u53c3\u6578"},"\u97ff\u61c9\u53c3\u6578"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,r.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,r.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("a",{parentName:"td",href:"../v5/enum#category"},"category")),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7522\u54c1\u985e\u578b")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"list"),(0,r.kt)("td",{parentName:"tr",align:"left"},"array"),(0,r.kt)("td",{parentName:"tr",align:null},"Object")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#positionidx"},"positionIdx")),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u6a19\u8b58\u7b26, \u7528\u4e8e\u5728\u4e0d\u540c\u4ed3\u4f4d\u6a21\u5f0f\u4e0b\u6807\u8bc6\u4ed3\u4f4d")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> riskId"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u98ce\u9669\u9650\u989dID\uff0c\u53c3\u898b",(0,r.kt)("a",{parentName:"td",href:"../v5/market/risk-limit#"},"\u98a8\u96aa\u9650\u984d"),"\u63a5\u53e3. ",(0,r.kt)("em",{parentName:"td"},"\u6ce8\u610f\uff1a\u82e5\u8cec\u6236\u70ba\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\uff0c\u8a72\u5b57\u6bb5\u8fd4\u56de0\uff0c\u98a8\u96aa\u9650\u984d\u898f\u5247\u5931\u6548"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> riskLimitValue"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u98a8\u96aa\u9650\u984dID\u5c0d\u61c9\u7684\u6301\u5009\u9650\u5236\u91cf. ",(0,r.kt)("em",{parentName:"td"},'\u6ce8\u610f\uff1a\u82e5\u8cec\u6236\u70ba\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\uff0c\u8a72\u5b57\u6bb5\u8fd4\u56de""\uff0c\u98a8\u96aa\u9650\u984d\u898f\u5247\u5931\u6548'))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> symbol"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5408\u7d04\u540d\u79f0")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> side"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6301\u5009\u65b9\u5411\uff0cBuy\uff1a\u591a\u5934\uff1bSell\uff1a\u7a7a\u5934. ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7d93\u5178\u5e33\u6236\u7684\u55ae\u5411\u6a21\u5f0f\u4e0b\u548c\u7d71\u4e00\u5e33\u6236\u7684\u53cd\u5411\u5408\u7d04: \u7a7a\u5009\u6642\u8fd4\u56de",(0,r.kt)("inlineCode",{parentName:"td"},"None"),"."),(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236(\u6b63\u5411\u5408\u7d04): \u55ae\u5411\u6216\u5c0d\u6c96\u6a21\u5f0f\u7a7a\u7684\u4ed3\u4f4d\u8fd4\u56de\u7a7a\u5b57\u7b26\u4e32")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> size"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u5009\u4f4d\u7684\u5408\u7ea6\u6578\u91cf")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> avgPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u5009\u4f4d\u7684\u5e73\u5747\u5165\u5834\u50f9\u683c ",(0,r.kt)("li",null,"\u5c0d\u65bc8\u5c0f\u6642\u7d50\u7b97\u7684USDC\u5408\u7d04\u5009\u4f4d, \u8a72\u5b57\u6bb5\u8868\u793a\u7684\u662f\u5e73\u5747\u958b\u5009\u50f9\u683c, \u4e0d\u96a8\u8457\u7d50\u7b97\u800c\u6539\u8b8a"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionValue"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u4ed3\u4f4d\u7684\u50f9\u503c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> tradeMode"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u6a21\u5f0f\u3002",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236 (\u53cd\u5411\u5408\u7d04) & \u7d93\u5178\u5e33\u6236: ",(0,r.kt)("inlineCode",{parentName:"td"},"0"),": \u5168\u5009, ",(0,r.kt)("inlineCode",{parentName:"td"},"1"),": \u9010\u5009"),(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236: \u5ee2\u68c4, \u7e3d\u662f ",(0,r.kt)("inlineCode",{parentName:"td"},"0"))))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> autoAddMargin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u662f\u5426\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1. ",(0,r.kt)("inlineCode",{parentName:"td"},"0"),": \u5426, ",(0,r.kt)("inlineCode",{parentName:"td"},"1"),": \u662f. \u50c5\u7576\u7d71\u4e00\u5e33\u6236(\u9664\u53cd\u5411\u5408\u7d04)\u958b\u555f\u4e86\u5e33\u6236\u7dad\u5ea6\u7684\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f, \u8a72\u5b57\u6bb5\u624d\u6709\u610f\u7fa9")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#positionstatus"},"positionStatus")),(0,r.kt)("td",{parentName:"tr",align:"left"},"String"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u72b6\u6001. ",(0,r.kt)("inlineCode",{parentName:"td"},"Normal"),",",(0,r.kt)("inlineCode",{parentName:"td"},"Liq"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"Adl"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> leverage"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u5009\u4f4d\u7684\u69d3\u687f\uff0c",(0,r.kt)("strong",{parentName:"td"},"\u4ec5\u9002\u7528\u4e8e\u5408\u7ea6"),". ",(0,r.kt)("em",{parentName:"td"},"\u6ce8\u610f\uff1a\u82e5\u8cec\u6236\u70ba\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\uff0c\u8a72\u5b57\u6bb5\u8fd4\u56de\u7a7a\u5b57\u7b26\u4e32\uff0c\u69d3\u687f\u898f\u5247\u5931\u6548"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> markPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"symbol \u7684\u6700\u65b0\u6a19\u8a18\u50f9\u683c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> liqPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u5f37\u5e73\u50f9\u683c\uff0c",(0,r.kt)("ul",null,(0,r.kt)("li",null,"UTA(\u53cd\u5411\u5408\u7d04) & \u666e\u901a\u8d26\u6237 & UTA(\u958b\u555f\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f)\uff1a\u662f\u9010\u5009\u548c\u5168\u5009\u6301\u4ed3\u7684\u771f\u5be6\u50f9\u683c, \u7576\u5f37\u5e73\u50f9 <= minPrice\u6216\u8005 \u5f37\u5e73\u50f9 >= maxPrice, \u5247\u70ba",(0,r.kt)("inlineCode",{parentName:"td"},'""'),"\u3002"),(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236(\u5168\u5009\u4fdd\u8b49\u91d1)\uff1a\u662f\u5168\u5009\u6301\u4ed3\u7684\u9884\u4f30\u4ef7\u683c\uff08\u56e0\u4e3a\u7edf\u4e00\u5e33\u6236\u6a21\u5f0f\u662f\u6309\u7167\u5e33\u6236\u7dad\u5ea6\u63a7\u5236\u98ce\u9669\u7387), \u7576\u5f37\u5e73\u50f9 <= minPrice\u6216\u8005 \u5f37\u5e73\u50f9 >= maxPrice, \u5247\u70ba",(0,r.kt)("inlineCode",{parentName:"td"},'""'))),"\u4f46\u662f\u5c0d\u65bc\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f\uff0c\u6b64\u5b57\u6bb5\u70ba\u7a7a\uff0c\u4e0d\u6703\u63d0\u4f9b\u5f37\u5e73\u50f9\u683c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> bustPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u7834\u7522\u50f9\u683c. \u7d71\u4e00\u4fdd\u8b49\u91d1\u6a21\u5f0f\u8fd4\u56de",(0,r.kt)("inlineCode",{parentName:"td"},'""'),", \u7121\u5009\u4f4d\u7834\u7522\u50f9\u683c (\u4e0d\u5305\u62ec\u7d71\u4e00\u5e33\u6236\u4e0b\u7684\u53cd\u5411\u4ea4\u6613)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionIM"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u8d77\u59cb\u4fdd\u8b49\u91d1. \u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\u4e0b, \u8a72\u5b57\u6bb5\u8fd4\u56de\u70ba\u7a7a\u5b57\u7b26\u4e32")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionMM"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u7dad\u6301\u4fdd\u8b49\u91d1. \u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\u4e0b, \u8a72\u5b57\u6bb5\u8fd4\u56de\u70ba\u7a7a\u5b57\u7b26\u4e32")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> tpslMode"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},'\u8a72\u5b57\u6bb5\u5ee2\u68c4, \u7121\u610f\u7fa9, \u7e3d\u662f\u8fd4\u56de"Full". \u671f\u6b0a\u7e3d\u662f\u8fd4\u56de""')),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionBalance"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u4fdd\u8b49\u91d1 ",(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236(linear): \u50c5\u5728\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f\u4e0b\u6709\u610f\u7fa9"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> takeProfit"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6b62\u76c8\u50f9\u683c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> stopLoss"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6b62\u640d\u50f9\u683c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> trailingStop"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u8ffd\u8e64\u6b62\u640d\uff08\u8207\u7576\u524d\u50f9\u683c\u7684\u8ddd\u96e2\uff09")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> sessionAvgPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"USDC\u5408\u7d04\u5e73\u5747\u6301\u5009\u50f9\u683c, \u6703\u96a8\u84578\u5c0f\u6642\u7d50\u7b97\u800c\u8b8a\u52d5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> delta"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Delta, \u671f\u6b0a\u7684\u7368\u6709\u5b57\u6bb5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> gamma"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Gamma, \u671f\u6b0a\u7684\u7368\u6709\u5b57\u6bb5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> vega"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Vega, \u671f\u6b0a\u7684\u7368\u6709\u5b57\u6bb5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> theta"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Theta, \u671f\u6b0a\u7684\u7368\u6709\u5b57\u6bb5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> unrealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u672a\u7ed3\u76c8\u4e8f")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> curRealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u6301\u5009\u7684\u5df2\u7d50\u76c8\u8667")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> cumRealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7d2f\u8ba1\u5df2\u7ed3\u76c8\u4e8f ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u671f\u8ca8: \u662f\u5f9e\u7b2c\u4e00\u6b21\u958b\u59cb\u6709\u6301\u5009\u52a0\u7e3d\u7684\u5df2\u7d50\u76c8\u8667"),(0,r.kt)("li",null,'\u671f\u6b0a: \u7e3d\u662f"", \u7121\u610f\u7fa9')))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#adlrankindicator"},"adlRankIndicator")),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u81ea\u52d5\u6e1b\u5009\u71c8. ",(0,r.kt)("a",{href:"https://www.bybit.com/zh-TW/help-center/s/article/What-is-Auto-Deleveraging-ADL"},"\u4ec0\u9ebc\u662f\u81ea\u52d5\u6e1b\u5009\u6a5f\u5236?"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> isReduceOnly"),(0,r.kt)("td",{parentName:"tr",align:"left"},"boolean"),(0,r.kt)("td",{parentName:"tr",align:null},"\u50c5\u7576Bybit\u9700\u8981\u964d\u4f4e\u67d0\u500bSymbol\u7684\u98a8\u96aa\u9650\u984d\u6642\u6709\u7528 ",(0,r.kt)("ul",null,(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"true"),": \u50c5\u5141\u8a31\u6e1b\u5009\u64cd\u4f5c. \u60a8\u53ef\u4ee5\u8003\u616e\u4e00\u7cfb\u5217\u7684\u65b9\u5f0f, \u6bd4\u5982, \u964d\u4f4erisk limit\u6a94\u4f4d, \u6216\u8005\u540c\u6a94\u4f4d\u4fee\u6539\u69d3\u687f\u6216\u6e1b\u5c11\u5009\u4f4d, \u6216\u8005\u589e\u52a0\u4fdd\u8b49\u91d1, \u6216\u8005\u64a4\u55ae, \u9019\u4e9b\u64cd\u4f5c\u505a\u5b8c\u5f8c, \u53ef\u4ee5\u4e3b\u52d5\u8abf\u7528",(0,r.kt)("a",{parentName:"td",href:"position/confirm-mmr#"},"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d"),"\u63a5\u53e3"),(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"false"),"(\u9ed8\u8a8d): \u6c92\u6709\u4ea4\u6613\u9650\u5236, \u8868\u793a\u60a8\u7684\u5009\u4f4d\u5728\u7cfb\u7d71\u8abf\u6574\u6642\u8655\u65bc\u98a8\u96aa\u6c34\u5e73\u4e4b\u4e0b"),(0,r.kt)("li",null,"\u50c5\u5c0d\u9010\u5009\u548c\u5168\u5009\u7684\u671f\u8ca8\u5009\u4f4d\u6709\u610f\u7fa9")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> mmrSysUpdatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u50c5\u7576Bybit\u9700\u8981\u964d\u4f4e\u67d0\u500bSymbol\u7684\u98a8\u96aa\u9650\u984d\u6642\u6709\u7528 ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7576isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"true"),": \u9019\u500b\u6642\u9593\u6233\u8868\u793a\u7cfb\u7d71\u5f37\u5236\u4fee\u6539MMR\u7684\u6642\u9593"),"\u7576isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"false"),": \u82e5\u4e0d\u70ba\u7a7a, \u5247\u8868\u793a\u7cfb\u7d71\u5df2\u7d93\u5b8c\u6210\u4e86MMR\u8abf\u6574\u7684\u6642\u9593",(0,r.kt)("li",null,"\u50c5\u7576\u7cfb\u7d71\u8abf\u6574\u624d\u6703\u8ce6\u503c, \u5c0d\u65bc\u4e3b\u52d5\u7684\u8abf\u6574, \u4e0d\u6703\u5728\u9019\u88e1\u5c55\u793a\u6642\u9593\u6233"),(0,r.kt)("li",null,"\u9ed8\u8a8d\u70ba",(0,r.kt)("inlineCode",{parentName:"td"},'""'),", \u4f46\u5982\u679c\u66fe\u7d93\u9019\u500bsymbol\u6709\u904e\u7cfb\u7d71\u964d\u6a94\u7684\u64cd\u4f5c, \u90a3\u9ebc\u9019\u88e1\u6703\u986f\u793a\u4e0a\u4e00\u6b21\u64cd\u4f5c\u7684\u6642\u9593"),(0,r.kt)("li",null,"\u50c5\u5c0d\u9010\u5009\u548c\u5168\u5009\u7684\u671f\u8ca8\u5009\u4f4d\u6709\u610f\u7fa9")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> leverageSysUpdatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u50c5\u7576Bybit\u9700\u8981\u964d\u4f4e\u67d0\u500bSymbol\u7684\u98a8\u96aa\u9650\u984d\u6642\u6709\u7528 ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7576isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"true"),": \u9019\u500b\u6642\u9593\u6233\u8868\u793a\u7cfb\u7d71\u5f37\u5236\u4fee\u6539\u69d3\u687f\u7684\u6642\u9593"),"\u7576isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"false"),": \u82e5\u4e0d\u70ba\u7a7a, \u5247\u8868\u793a\u7cfb\u7d71\u5df2\u7d93\u5b8c\u6210\u4e86\u69d3\u687f\u8abf\u6574\u7684\u6642\u9593",(0,r.kt)("li",null,"\u50c5\u7576\u7cfb\u7d71\u8abf\u6574\u624d\u6703\u8ce6\u503c, \u5c0d\u65bc\u4e3b\u52d5\u7684\u8abf\u6574, \u4e0d\u6703\u5728\u9019\u88e1\u5c55\u793a\u6642\u9593\u6233"),(0,r.kt)("li",null,"\u9ed8\u8a8d\u70ba",(0,r.kt)("inlineCode",{parentName:"td"},'""'),", \u4f46\u5982\u679c\u66fe\u7d93\u9019\u500bsymbol\u6709\u904e\u7cfb\u7d71\u964d\u6a94\u7684\u64cd\u4f5c, \u90a3\u9ebc\u9019\u88e1\u6703\u986f\u793a\u4e0a\u4e00\u6b21\u64cd\u4f5c\u7684\u6642\u9593"),(0,r.kt)("li",null,"\u50c5\u5c0d\u9010\u5009\u548c\u5168\u5009\u7684\u671f\u8ca8\u5009\u4f4d\u6709\u610f\u7fa9")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> createdTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u5275\u5efa\u6642\u9593")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> updatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u6578\u64da\u66f4\u65b0\u6642\u9593")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> seq"),(0,r.kt)("td",{parentName:"tr",align:"left"},"long"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5e8f\u5217\u865f, \u7528\u65bc\u95dc\u806f\u6210\u4ea4\u548c\u5009\u4f4d\u7684\u66f4\u65b0",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u4e0d\u540c\u7684\u5e63\u5c0d\u6703\u5b58\u5728\u76f8\u540cseq, \u53ef\u4ee5\u4f7f\u7528seq + symbol\u4f86\u505a\u552f\u4e00\u6027\u8b58\u5225"),(0,r.kt)("li",null,"\u5982\u679c\u8a72\u5e63\u5c0d\u5f9e\u672a\u88ab\u4ea4\u6613\u904e, \u67e5\u8a62\u6642\u5247\u6703\u8fd4\u56de",(0,r.kt)("inlineCode",{parentName:"td"},'"-1"')),(0,r.kt)("li",null,"\u5c0d\u65bc\u66f4\u65b0\u69d3\u687f\u3001\u66f4\u65b0\u98a8\u96aa\u9650\u984d\u7b49\u975e\u4ea4\u6613\u884c\u70ba, \u5c07\u6703\u8fd4\u56de\u4e0a\u4e00\u6b21\u6210\u4ea4\u6642\u66f4\u65b0\u7684seq")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"nextPageCursor"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6e38\u6a19\uff0c\u7528\u65bc\u7ffb\u9801")))),(0,r.kt)("a",{href:"/api-explorer/v5/position/position-info"},(0,r.kt)(k,{mdxType:"Button"},"\u904b\u884c\u5be6\u4f8b >>")),(0,r.kt)("hr",null),(0,r.kt)("h3",{id:"\u8acb\u6c42\u793a\u4f8b"},"\u8acb\u6c42\u793a\u4f8b"),(0,r.kt)(s,{groupId:"programming-languages",mdxType:"Tabs"},(0,r.kt)(N,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/position/list?category=linear&symbol=XRPUSDT HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672280218882\nX-BAPI-RECV-WINDOW: 5000\n"))),(0,r.kt)(N,{value:"python",label:"Python",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_positions(\n category="linear",\n symbol="XRPUSDT",\n))\n'))),(0,r.kt)(N,{value:"java",label:"Java",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.position.*;\nimport com.bybit.api.client.domain.position.request.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance().newAsyncPositionRestClient();\nvar positionListRequest = PositionDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").build();\nclient.getPositionInfo(positionListRequest, System.out::println);\n'))),(0,r.kt)(N,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getPositionInfo({\n category: 'inverse',\n symbol: 'BTCUSD',\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,r.kt)("h3",{id:"\u97ff\u61c9\u793a\u4f8b"},"\u97ff\u61c9\u793a\u4f8b"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "list": [\n {\n "positionIdx": 0,\n "riskId": 1,\n "riskLimitValue": "150",\n "symbol": "BTCUSD",\n "side": "Sell",\n "size": "300",\n "avgPrice": "27464.50441675",\n "positionValue": "0.01092319",\n "tradeMode": 0,\n "positionStatus": "Normal",\n "autoAddMargin": 1,\n "adlRankIndicator": 2,\n "leverage": "10",\n "positionBalance": "0.00139186",\n "markPrice": "28224.50",\n "liqPrice": "",\n "bustPrice": "999999.00",\n "positionMM": "0.0000015",\n "positionIM": "0.00010923",\n "tpslMode": "Full",\n "takeProfit": "0.00",\n "stopLoss": "0.00",\n "trailingStop": "0.00",\n "unrealisedPnl": "-0.00029413",\n "sessionAvgPrice": "",\n "curRealisedPnl": "0.00013123",\n "cumRealisedPnl": "-0.00096902",\n "seq": 5723621632,\n "isReduceOnly": false,\n "mmrSysUpdateTime": "",\n "leverageSysUpdatedTime": "",\n "createdTime": "1676538056258",\n "updatedTime": "1697673600012"\n }\n ],\n "nextPageCursor": "",\n "category": "inverse"\n },\n "retExtInfo": {},\n "time": 1697684980172\n}\n')))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/b7cfb3da.969e656d.js b/zh-TW/assets/js/b7cfb3da.969e656d.js deleted file mode 100644 index 2a859e96a8..0000000000 --- a/zh-TW/assets/js/b7cfb3da.969e656d.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[69998],{3905:(t,e,n)=>{n.d(e,{Zo:()=>m,kt:()=>N});var a=n(67294);function r(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}function l(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);e&&(a=a.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,a)}return n}function i(t){for(var e=1;e=0||(r[n]=t[n]);return r}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(r[n]=t[n])}return r}var o=a.createContext({}),d=function(t){var e=a.useContext(o),n=e;return t&&(n="function"==typeof t?t(e):i(i({},e),t)),n},m=function(t){var e=d(t.components);return a.createElement(o.Provider,{value:e},t.children)},k={inlineCode:"code",wrapper:function(t){var e=t.children;return a.createElement(a.Fragment,{},e)}},s=a.forwardRef((function(t,e){var n=t.components,r=t.mdxType,l=t.originalType,o=t.parentName,m=p(t,["components","mdxType","originalType","parentName"]),s=d(n),N=r,g=s["".concat(o,".").concat(N)]||s[N]||k[N]||l;return n?a.createElement(g,i(i({ref:e},m),{},{components:n})):a.createElement(g,i({ref:e},m))}));function N(t,e){var n=arguments,r=e&&e.mdxType;if("string"==typeof t||r){var l=n.length,i=new Array(l);i[0]=s;var p={};for(var o in e)hasOwnProperty.call(e,o)&&(p[o]=e[o]);p.originalType=t,p.mdxType="string"==typeof t?t:r,i[1]=p;for(var d=2;d{n.r(e),n.d(e,{assets:()=>o,contentTitle:()=>i,default:()=>u,frontMatter:()=>l,metadata:()=>p,toc:()=>d});var a=n(87462),r=(n(67294),n(3905));const l={title:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",sidebar_label:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",sidebar_position:1},i=void 0,p={unversionedId:"v5/position/position",id:"v5/position/position",title:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",description:"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49",source:"@site/i18n/zh-TW/docusaurus-plugin-content-docs/current/v5/position/position.mdx",sourceDirName:"v5/position",slug:"/v5/position/",permalink:"/docs/zh-TW/v5/position/",draft:!1,tags:[],version:"current",sidebarPosition:1,frontMatter:{title:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",sidebar_label:"\u67e5\u8a62\u6301\u5009 (\u5be6\u6642)",sidebar_position:1},sidebar:"v5SideBar",previous:{title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593 (\u671f\u6b0a)",permalink:"/docs/zh-TW/v5/order/dcp"},next:{title:"\u8a2d\u7f6e\u69d3\u687f",permalink:"/docs/zh-TW/v5/position/leverage"}},o={},d=[{value:"HTTP \u8acb\u6c42",id:"http-\u8acb\u6c42",level:3},{value:"\u8acb\u6c42\u53c3\u6578",id:"\u8acb\u6c42\u53c3\u6578",level:3},{value:"\u97ff\u61c9\u53c3\u6578",id:"\u97ff\u61c9\u53c3\u6578",level:3},{value:"\u8acb\u6c42\u793a\u4f8b",id:"\u8acb\u6c42\u793a\u4f8b",level:3},{value:"\u97ff\u61c9\u793a\u4f8b",id:"\u97ff\u61c9\u793a\u4f8b",level:3}],m=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,r.kt)("div",e)},k=m("Button"),s=m("Tabs"),N=m("TabItem"),g={toc:d};function u(t){let{components:e,...n}=t;return(0,r.kt)("wrapper",(0,a.Z)({},g,n,{components:e,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"\u8a72\u63a5\u53e3\u53ef\u4ee5\u7372\u53d6\u7528\u6236\u7684\u6301\u5009\u4fe1\u606f\uff0c\u6bd4\u5982\u6301\u5009\u6578\u91cf\uff0c\u7d2f\u8a08\u76c8\u8667\u7b49"),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},(0,r.kt)("strong",{parentName:"p"},"\u7d71\u4e00\u5e33\u6236\u8986\u84cb\u7bc4\u570d: USDT\u6c38\u7e8c / USDC\u6c38\u7e8c / USDC\u4ea4\u5272 / \u53cd\u5411\u5408\u7d04 / \u671f\u6b0a"),(0,r.kt)("br",null),"\n",(0,r.kt)("strong",{parentName:"p"},"\u7d93\u5178\u5e33\u6236\u8986\u84cb\u7bc4\u570d: USDT\u6c38\u7e8c / \u53cd\u5411\u5408\u7d04"))),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("p",{parentName:"admonition"},"\u95dc\u65bc\u53cd\u5411\u5408\u7d04\u7684\u984d\u5916\u67e5\u8a62\u898f\u5247,"),(0,r.kt)("ol",{parentName:"admonition"},(0,r.kt)("li",{parentName:"ol"},'\u901a\u904e\u9019\u6a23\u5b50\u67e5\u8a62"/v5/position/list?category=inverse", \u60a8\u53ef\u4ee5\u67e5\u8a62\u5230\u6240\u6709\u7576\u524d\u6301\u6709\u7684\u53cd\u5411\u5408\u7d04\u5009\u4f4d;'),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("inlineCode",{parentName:"li"},"symbol"),"\u5b57\u6bb5\u652f\u6301\u50b3\u5165\u6700\u591a10\u500b\u53cd\u5411\u5408\u7d04;"))),(0,r.kt)("h3",{id:"http-\u8acb\u6c42"},"HTTP \u8acb\u6c42"),(0,r.kt)("p",null,"GET ",(0,r.kt)("inlineCode",{parentName:"p"},"/v5/position/list")),(0,r.kt)("h3",{id:"\u8acb\u6c42\u53c3\u6578"},"\u8acb\u6c42\u53c3\u6578"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,r.kt)("th",{parentName:"tr",align:"left"},"\u662f\u5426\u5fc5\u9700"),(0,r.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,r.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("a",{parentName:"td",href:"../v5/enum#category"},"category")),(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("strong",{parentName:"td"},"true")),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7522\u54c1\u985e\u578b ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236: ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),",",(0,r.kt)("inlineCode",{parentName:"td"},"inverse"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"option")),(0,r.kt)("li",null,"\u7d93\u5178\u5e33\u6236: ",(0,r.kt)("inlineCode",{parentName:"td"},"linear"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"inverse"))))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5408\u7d04\u540d\u7a31",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u82e5\u50b3\u4e86",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),", \u5247\u4e0d\u7ba1\u662f\u5426\u6709\u5009\u4f4d\u90fd\u8fd4\u56de\u8a72symbol\u6578\u64da"),(0,r.kt)("li",null,"\u82e5",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),"\u4e0d\u50b3\u4f46\u50b3\u4e86",(0,r.kt)("inlineCode",{parentName:"td"},"settleCoin"),", \u5247\u50c5\u8fd4\u56de\u6709\u5be6\u969b\u5009\u4f4d\u7684\u6578\u64da")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"baseCoin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u5e63\u7a2e. \u50c5",(0,r.kt)("inlineCode",{parentName:"td"},"option"),". \u82e5\u4e0d\u50b3\uff0c\u5247\u8fd4\u56de\u671f\u6b0a\u4e0b\u6240\u6709\u6301\u5009")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"settleCoin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7d50\u7b97\u5e63\u7a2e. \u5c0d\u65bcUSDT\u548cUSDC\u671f\u8ca8\u800c\u8a00\uff0c",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),"\u548c",(0,r.kt)("inlineCode",{parentName:"td"},"settleCon"),(0,r.kt)("strong",{parentName:"td"},"\u5fc5\u50b3"),"\u5176\u4e2d\u4e00\u500b, \u82e5\u90fd\u50b3\uff0c\u5247",(0,r.kt)("inlineCode",{parentName:"td"},"symbol"),"\u6709\u66f4\u9ad8\u7684\u512a\u5148\u7d1a")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"limit"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6bcf\u9801\u6578\u91cf\u9650\u5236. ","[",(0,r.kt)("inlineCode",{parentName:"td"},"1"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"200"),"]",". \u9ed8\u8a8d: ",(0,r.kt)("inlineCode",{parentName:"td"},"20"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"cursor"),(0,r.kt)("td",{parentName:"tr",align:"left"},"false"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6e38\u6a19\uff0c\u7528\u65bc\u7ffb\u9801")))),(0,r.kt)("h3",{id:"\u97ff\u61c9\u53c3\u6578"},"\u97ff\u61c9\u53c3\u6578"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,r.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,r.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},(0,r.kt)("a",{parentName:"td",href:"../v5/enum#category"},"category")),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7522\u54c1\u985e\u578b")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"list"),(0,r.kt)("td",{parentName:"tr",align:"left"},"array"),(0,r.kt)("td",{parentName:"tr",align:null},"Object")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#positionidx"},"positionIdx")),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u6a19\u8b58\u7b26, \u7528\u4e8e\u5728\u4e0d\u540c\u4ed3\u4f4d\u6a21\u5f0f\u4e0b\u6807\u8bc6\u4ed3\u4f4d")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> riskId"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u98ce\u9669\u9650\u989dID\uff0c\u53c3\u898b",(0,r.kt)("a",{parentName:"td",href:"../v5/market/risk-limit#"},"\u98a8\u96aa\u9650\u984d"),"\u63a5\u53e3. ",(0,r.kt)("em",{parentName:"td"},"\u6ce8\u610f\uff1a\u82e5\u8cec\u6236\u70ba\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\uff0c\u8a72\u5b57\u6bb5\u8fd4\u56de0\uff0c\u98a8\u96aa\u9650\u984d\u898f\u5247\u5931\u6548"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> riskLimitValue"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u98a8\u96aa\u9650\u984dID\u5c0d\u61c9\u7684\u6301\u5009\u9650\u5236\u91cf. ",(0,r.kt)("em",{parentName:"td"},'\u6ce8\u610f\uff1a\u82e5\u8cec\u6236\u70ba\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\uff0c\u8a72\u5b57\u6bb5\u8fd4\u56de""\uff0c\u98a8\u96aa\u9650\u984d\u898f\u5247\u5931\u6548'))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> symbol"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5408\u7d04\u540d\u79f0")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> side"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6301\u5009\u65b9\u5411\uff0cBuy\uff1a\u591a\u5934\uff1bSell\uff1a\u7a7a\u5934. ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7d93\u5178\u5e33\u6236\u7684\u55ae\u5411\u6a21\u5f0f\u4e0b\u548c\u7d71\u4e00\u5e33\u6236\u7684\u53cd\u5411\u5408\u7d04: \u7a7a\u5009\u6642\u8fd4\u56de",(0,r.kt)("inlineCode",{parentName:"td"},"None"),"."),(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236(\u6b63\u5411\u5408\u7d04): \u55ae\u5411\u6216\u5c0d\u6c96\u6a21\u5f0f\u7a7a\u7684\u4ed3\u4f4d\u8fd4\u56de\u7a7a\u5b57\u7b26\u4e32")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> size"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u5009\u4f4d\u7684\u5408\u7ea6\u6578\u91cf")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> avgPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u5009\u4f4d\u7684\u5e73\u5747\u5165\u5834\u50f9\u683c ",(0,r.kt)("li",null,"\u5c0d\u65bc8\u5c0f\u6642\u7d50\u7b97\u7684USDC\u5408\u7d04\u5009\u4f4d, \u8a72\u5b57\u6bb5\u8868\u793a\u7684\u662f\u5e73\u5747\u958b\u5009\u50f9\u683c, \u4e0d\u96a8\u8457\u7d50\u7b97\u800c\u6539\u8b8a"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionValue"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u4ed3\u4f4d\u7684\u50f9\u503c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> tradeMode"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u6a21\u5f0f\u3002",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236 (\u53cd\u5411\u5408\u7d04) & \u7d93\u5178\u5e33\u6236: ",(0,r.kt)("inlineCode",{parentName:"td"},"0"),": \u5168\u5009, ",(0,r.kt)("inlineCode",{parentName:"td"},"1"),": \u9010\u5009"),(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236: \u5ee2\u68c4, \u7e3d\u662f ",(0,r.kt)("inlineCode",{parentName:"td"},"0"))))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> autoAddMargin"),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u662f\u5426\u81ea\u52d5\u8ffd\u52a0\u4fdd\u8b49\u91d1. ",(0,r.kt)("inlineCode",{parentName:"td"},"0"),": \u5426, ",(0,r.kt)("inlineCode",{parentName:"td"},"1"),": \u662f. \u50c5\u7576\u7d71\u4e00\u5e33\u6236(\u9664\u53cd\u5411\u5408\u7d04)\u958b\u555f\u4e86\u5e33\u6236\u7dad\u5ea6\u7684\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f, \u8a72\u5b57\u6bb5\u624d\u6709\u610f\u7fa9")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#positionstatus"},"positionStatus")),(0,r.kt)("td",{parentName:"tr",align:"left"},"String"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u72b6\u6001. ",(0,r.kt)("inlineCode",{parentName:"td"},"Normal"),",",(0,r.kt)("inlineCode",{parentName:"td"},"Liq"),", ",(0,r.kt)("inlineCode",{parentName:"td"},"Adl"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> leverage"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u5009\u4f4d\u7684\u69d3\u687f\uff0c",(0,r.kt)("strong",{parentName:"td"},"\u4ec5\u9002\u7528\u4e8e\u5408\u7ea6"),". ",(0,r.kt)("em",{parentName:"td"},"\u6ce8\u610f\uff1a\u82e5\u8cec\u6236\u70ba\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\uff0c\u8a72\u5b57\u6bb5\u8fd4\u56de\u7a7a\u5b57\u7b26\u4e32\uff0c\u69d3\u687f\u898f\u5247\u5931\u6548"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> markPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"symbol \u7684\u6700\u65b0\u6a19\u8a18\u50f9\u683c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> liqPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u5f37\u5e73\u50f9\u683c\uff0c",(0,r.kt)("ul",null,(0,r.kt)("li",null,"UTA(\u53cd\u5411\u5408\u7d04) & \u666e\u901a\u8d26\u6237 & UTA(\u958b\u555f\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f)\uff1a\u662f\u9010\u5009\u548c\u5168\u5009\u6301\u4ed3\u7684\u771f\u5be6\u50f9\u683c, \u7576\u5f37\u5e73\u50f9 <= minPrice\u6216\u8005 \u5f37\u5e73\u50f9 >= maxPrice, \u5247\u70ba",(0,r.kt)("inlineCode",{parentName:"td"},'""'),"\u3002"),(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236(\u5168\u5009\u4fdd\u8b49\u91d1)\uff1a\u662f\u5168\u5009\u6301\u4ed3\u7684\u9884\u4f30\u4ef7\u683c\uff08\u56e0\u4e3a\u7edf\u4e00\u5e33\u6236\u6a21\u5f0f\u662f\u6309\u7167\u5e33\u6236\u7dad\u5ea6\u63a7\u5236\u98ce\u9669\u7387), \u7576\u5f37\u5e73\u50f9 <= minPrice\u6216\u8005 \u5f37\u5e73\u50f9 >= maxPrice, \u5247\u70ba",(0,r.kt)("inlineCode",{parentName:"td"},'""'))),"\u4f46\u662f\u5c0d\u65bc\u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f\uff0c\u6b64\u5b57\u6bb5\u70ba\u7a7a\uff0c\u4e0d\u6703\u63d0\u4f9b\u5f37\u5e73\u50f9\u683c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> bustPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u7834\u7522\u50f9\u683c. \u7d71\u4e00\u4fdd\u8b49\u91d1\u6a21\u5f0f\u8fd4\u56de",(0,r.kt)("inlineCode",{parentName:"td"},'""'),", \u7121\u5009\u4f4d\u7834\u7522\u50f9\u683c (\u4e0d\u5305\u62ec\u7d71\u4e00\u5e33\u6236\u4e0b\u7684\u53cd\u5411\u4ea4\u6613)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionIM"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u8d77\u59cb\u4fdd\u8b49\u91d1. \u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\u4e0b, \u8a72\u5b57\u6bb5\u8fd4\u56de\u70ba\u7a7a\u5b57\u7b26\u4e32")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionMM"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u7dad\u6301\u4fdd\u8b49\u91d1. \u7d44\u5408\u4fdd\u8b49\u91d1\u6a21\u5f0f(PM)\u4e0b, \u8a72\u5b57\u6bb5\u8fd4\u56de\u70ba\u7a7a\u5b57\u7b26\u4e32")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> tpslMode"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},'\u8a72\u5b57\u6bb5\u5ee2\u68c4, \u7121\u610f\u7fa9, \u7e3d\u662f\u8fd4\u56de"Full". \u671f\u6b0a\u7e3d\u662f\u8fd4\u56de""')),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> positionBalance"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u4fdd\u8b49\u91d1 ",(0,r.kt)("li",null,"\u7d71\u4e00\u5e33\u6236(linear): \u50c5\u5728\u9010\u5009\u4fdd\u8b49\u91d1\u6a21\u5f0f\u4e0b\u6709\u610f\u7fa9"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> takeProfit"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6b62\u76c8\u50f9\u683c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> stopLoss"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6b62\u640d\u50f9\u683c")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> trailingStop"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u8ffd\u8e64\u6b62\u640d\uff08\u8207\u7576\u524d\u50f9\u683c\u7684\u8ddd\u96e2\uff09")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> sessionAvgPrice"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"USDC\u5408\u7d04\u5e73\u5747\u6301\u5009\u50f9\u683c, \u6703\u96a8\u84578\u5c0f\u6642\u7d50\u7b97\u800c\u8b8a\u52d5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> delta"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Delta, \u671f\u6b0a\u7684\u7368\u6709\u5b57\u6bb5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> gamma"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Gamma, \u671f\u6b0a\u7684\u7368\u6709\u5b57\u6bb5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> vega"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Vega, \u671f\u6b0a\u7684\u7368\u6709\u5b57\u6bb5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> theta"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"Theta, \u671f\u6b0a\u7684\u7368\u6709\u5b57\u6bb5")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> unrealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u672a\u7ed3\u76c8\u4e8f")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> curRealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7576\u524d\u6301\u5009\u7684\u5df2\u7d50\u76c8\u8667")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> cumRealisedPnl"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u7d2f\u8ba1\u5df2\u7ed3\u76c8\u4e8f ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u671f\u8ca8: \u662f\u5f9e\u7b2c\u4e00\u6b21\u958b\u59cb\u6709\u6301\u5009\u52a0\u7e3d\u7684\u5df2\u7d50\u76c8\u8667"),(0,r.kt)("li",null,'\u671f\u6b0a: \u7e3d\u662f"", \u7121\u610f\u7fa9')))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> ",(0,r.kt)("a",{parentName:"td",href:"../v5/enum#adlrankindicator"},"adlRankIndicator")),(0,r.kt)("td",{parentName:"tr",align:"left"},"integer"),(0,r.kt)("td",{parentName:"tr",align:null},"\u81ea\u52d5\u6e1b\u5009\u71c8. ",(0,r.kt)("a",{href:"https://www.bybit.com/zh-TW/help-center/s/article/What-is-Auto-Deleveraging-ADL"},"\u4ec0\u9ebc\u662f\u81ea\u52d5\u6e1b\u5009\u6a5f\u5236?"))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> isReduceOnly"),(0,r.kt)("td",{parentName:"tr",align:"left"},"boolean"),(0,r.kt)("td",{parentName:"tr",align:null},"\u50c5\u7576Bybit\u9700\u8981\u964d\u4f4e\u67d0\u500bSymbol\u7684\u98a8\u96aa\u9650\u984d\u6642\u6709\u7528 ",(0,r.kt)("ul",null,(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"true"),": \u50c5\u5141\u8a31\u6e1b\u5009\u64cd\u4f5c. \u60a8\u53ef\u4ee5\u8003\u616e\u4e00\u7cfb\u5217\u7684\u65b9\u5f0f, \u6bd4\u5982, \u964d\u4f4erisk limit\u6a94\u4f4d, \u6216\u8005\u540c\u6a94\u4f4d\u4fee\u6539\u69d3\u687f\u6216\u6e1b\u5c11\u5009\u4f4d, \u6216\u8005\u589e\u52a0\u4fdd\u8b49\u91d1, \u6216\u8005\u64a4\u55ae, \u9019\u4e9b\u64cd\u4f5c\u505a\u5b8c\u5f8c, \u53ef\u4ee5\u4e3b\u52d5\u8abf\u7528",(0,r.kt)("a",{parentName:"td",href:"position/confirm-mmr#"},"\u78ba\u8a8d\u65b0\u7684\u98a8\u96aa\u9650\u984d"),"\u63a5\u53e3"),(0,r.kt)("li",null,(0,r.kt)("inlineCode",{parentName:"td"},"false"),"(\u9ed8\u8a8d): \u6c92\u6709\u4ea4\u6613\u9650\u5236, \u8868\u793a\u60a8\u7684\u5009\u4f4d\u5728\u7cfb\u7d71\u8abf\u6574\u6642\u8655\u65bc\u98a8\u96aa\u6c34\u5e73\u4e4b\u4e0b"),(0,r.kt)("li",null,"\u50c5\u5c0d\u9010\u5009\u548c\u5168\u5009\u7684\u671f\u8ca8\u5009\u4f4d\u6709\u610f\u7fa9")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> mmrSysUpdatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u50c5\u7576Bybit\u9700\u8981\u964d\u4f4e\u67d0\u500bSymbol\u7684\u98a8\u96aa\u9650\u984d\u6642\u6709\u7528 ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7576isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"true"),": \u9019\u500b\u6642\u9593\u6233\u8868\u793a\u7cfb\u7d71\u5f37\u5236\u4fee\u6539MMR\u7684\u6642\u9593"),"\u7576isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"false"),": \u82e5\u4e0d\u70ba\u7a7a, \u5247\u8868\u793a\u7cfb\u7d71\u5df2\u7d93\u5b8c\u6210\u4e86MMR\u8abf\u6574\u7684\u6642\u9593",(0,r.kt)("li",null,"\u50c5\u7576\u7cfb\u7d71\u8abf\u6574\u624d\u6703\u8ce6\u503c, \u5c0d\u65bc\u4e3b\u52d5\u7684\u8abf\u6574, \u4e0d\u6703\u5728\u9019\u88e1\u5c55\u793a\u6642\u9593\u6233"),(0,r.kt)("li",null,"\u9ed8\u8a8d\u70ba",(0,r.kt)("inlineCode",{parentName:"td"},'""'),", \u4f46\u5982\u679c\u66fe\u7d93\u9019\u500bsymbol\u6709\u904e\u7cfb\u7d71\u964d\u6a94\u7684\u64cd\u4f5c, \u90a3\u9ebc\u9019\u88e1\u6703\u986f\u793a\u4e0a\u4e00\u6b21\u64cd\u4f5c\u7684\u6642\u9593"),(0,r.kt)("li",null,"\u50c5\u5c0d\u9010\u5009\u548c\u5168\u5009\u7684\u671f\u8ca8\u5009\u4f4d\u6709\u610f\u7fa9")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> leverageSysUpdatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u50c5\u7576Bybit\u9700\u8981\u964d\u4f4e\u67d0\u500bSymbol\u7684\u98a8\u96aa\u9650\u984d\u6642\u6709\u7528 ",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u7576isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"true"),": \u9019\u500b\u6642\u9593\u6233\u8868\u793a\u7cfb\u7d71\u5f37\u5236\u4fee\u6539\u69d3\u687f\u7684\u6642\u9593"),"\u7576isReduceOnly=",(0,r.kt)("inlineCode",{parentName:"td"},"false"),": \u82e5\u4e0d\u70ba\u7a7a, \u5247\u8868\u793a\u7cfb\u7d71\u5df2\u7d93\u5b8c\u6210\u4e86\u69d3\u687f\u8abf\u6574\u7684\u6642\u9593",(0,r.kt)("li",null,"\u50c5\u7576\u7cfb\u7d71\u8abf\u6574\u624d\u6703\u8ce6\u503c, \u5c0d\u65bc\u4e3b\u52d5\u7684\u8abf\u6574, \u4e0d\u6703\u5728\u9019\u88e1\u5c55\u793a\u6642\u9593\u6233"),(0,r.kt)("li",null,"\u9ed8\u8a8d\u70ba",(0,r.kt)("inlineCode",{parentName:"td"},'""'),", \u4f46\u5982\u679c\u66fe\u7d93\u9019\u500bsymbol\u6709\u904e\u7cfb\u7d71\u964d\u6a94\u7684\u64cd\u4f5c, \u90a3\u9ebc\u9019\u88e1\u6703\u986f\u793a\u4e0a\u4e00\u6b21\u64cd\u4f5c\u7684\u6642\u9593"),(0,r.kt)("li",null,"\u50c5\u5c0d\u9010\u5009\u548c\u5168\u5009\u7684\u671f\u8ca8\u5009\u4f4d\u6709\u610f\u7fa9")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> createdTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u5275\u5efa\u6642\u9593")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> updatedTime"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5009\u4f4d\u6578\u64da\u66f4\u65b0\u6642\u9593")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"> seq"),(0,r.kt)("td",{parentName:"tr",align:"left"},"long"),(0,r.kt)("td",{parentName:"tr",align:null},"\u5e8f\u5217\u865f, \u7528\u65bc\u95dc\u806f\u6210\u4ea4\u548c\u5009\u4f4d\u7684\u66f4\u65b0",(0,r.kt)("ul",null,(0,r.kt)("li",null,"\u4e0d\u540c\u7684\u5e63\u5c0d\u6703\u5b58\u5728\u76f8\u540cseq, \u53ef\u4ee5\u4f7f\u7528seq + symbol\u4f86\u505a\u552f\u4e00\u6027\u8b58\u5225"),(0,r.kt)("li",null,"\u5982\u679c\u8a72\u5e63\u5c0d\u5f9e\u672a\u88ab\u4ea4\u6613\u904e, \u67e5\u8a62\u6642\u5247\u6703\u8fd4\u56de",(0,r.kt)("inlineCode",{parentName:"td"},'"-1"')),(0,r.kt)("li",null,"\u5c0d\u65bc\u66f4\u65b0\u69d3\u687f\u3001\u66f4\u65b0\u98a8\u96aa\u9650\u984d\u7b49\u975e\u4ea4\u6613\u884c\u70ba, \u5c07\u6703\u8fd4\u56de\u4e0a\u4e00\u6b21\u6210\u4ea4\u6642\u66f4\u65b0\u7684seq")))),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:"left"},"nextPageCursor"),(0,r.kt)("td",{parentName:"tr",align:"left"},"string"),(0,r.kt)("td",{parentName:"tr",align:null},"\u6e38\u6a19\uff0c\u7528\u65bc\u7ffb\u9801")))),(0,r.kt)("a",{href:"/api-explorer/v5/position/position-info"},(0,r.kt)(k,{mdxType:"Button"},"\u904b\u884c\u5be6\u4f8b >>")),(0,r.kt)("hr",null),(0,r.kt)("h3",{id:"\u8acb\u6c42\u793a\u4f8b"},"\u8acb\u6c42\u793a\u4f8b"),(0,r.kt)(s,{groupId:"programming-languages",mdxType:"Tabs"},(0,r.kt)(N,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/position/list?category=linear&symbol=XRPUSDT HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672280218882\nX-BAPI-RECV-WINDOW: 5000\n"))),(0,r.kt)(N,{value:"python",label:"Python",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_positions(\n category="linear",\n symbol="XRPUSDT",\n))\n'))),(0,r.kt)(N,{value:"java",label:"Java",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.position.*;\nimport com.bybit.api.client.domain.position.request.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance().newAsyncPositionRestClient();\nvar positionListRequest = PositionDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").build();\nclient.getPositionInfo(positionListRequest, System.out::println);\n'))),(0,r.kt)(N,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getPositionInfo({\n category: 'inverse',\n symbol: 'BTCUSD',\n })\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,r.kt)("h3",{id:"\u97ff\u61c9\u793a\u4f8b"},"\u97ff\u61c9\u793a\u4f8b"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "list": [\n {\n "positionIdx": 0,\n "riskId": 1,\n "riskLimitValue": "150",\n "symbol": "BTCUSD",\n "side": "Sell",\n "size": "300",\n "avgPrice": "27464.50441675",\n "positionValue": "0.01092319",\n "tradeMode": 0,\n "positionStatus": "Normal",\n "autoAddMargin": 1,\n "adlRankIndicator": 2,\n "leverage": "10",\n "positionBalance": "0.00139186",\n "markPrice": "28224.50",\n "liqPrice": "",\n "bustPrice": "999999.00",\n "positionMM": "0.0000015",\n "positionIM": "0.00010923",\n "tpslMode": "Full",\n "takeProfit": "0.00",\n "stopLoss": "0.00",\n "trailingStop": "0.00",\n "unrealisedPnl": "-0.00029413",\n "sessionAvgPrice": "",\n "curRealisedPnl": "0.00013123",\n "cumRealisedPnl": "-0.00096902",\n "seq": 5723621632,\n "isReduceOnly": false,\n "mmrSysUpdateTime": "",\n "leverageSysUpdatedTime": "",\n "createdTime": "1676538056258",\n "updatedTime": "1697673600012"\n }\n ],\n "nextPageCursor": "",\n "category": "inverse"\n },\n "retExtInfo": {},\n "time": 1697684980172\n}\n')))}u.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/e9b84ed8.0233031b.js b/zh-TW/assets/js/e9b84ed8.0233031b.js new file mode 100644 index 0000000000..7993dc20f5 --- /dev/null +++ b/zh-TW/assets/js/e9b84ed8.0233031b.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[24947],{3905:(t,e,r)=>{r.d(e,{Zo:()=>m,kt:()=>c});var n=r(67294);function a(t,e,r){return e in t?Object.defineProperty(t,e,{value:r,enumerable:!0,configurable:!0,writable:!0}):t[e]=r,t}function l(t,e){var r=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),r.push.apply(r,n)}return r}function o(t){for(var e=1;e=0||(a[r]=t[r]);return a}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(t,r)&&(a[r]=t[r])}return a}var p=n.createContext({}),d=function(t){var e=n.useContext(p),r=e;return t&&(r="function"==typeof t?t(e):o(o({},e),t)),r},m=function(t){var e=d(t.components);return n.createElement(p.Provider,{value:e},t.children)},s={inlineCode:"code",wrapper:function(t){var e=t.children;return n.createElement(n.Fragment,{},e)}},u=n.forwardRef((function(t,e){var r=t.components,a=t.mdxType,l=t.originalType,p=t.parentName,m=i(t,["components","mdxType","originalType","parentName"]),u=d(r),c=a,k=u["".concat(p,".").concat(c)]||u[c]||s[c]||l;return r?n.createElement(k,o(o({ref:e},m),{},{components:r})):n.createElement(k,o({ref:e},m))}));function c(t,e){var r=arguments,a=e&&e.mdxType;if("string"==typeof t||a){var l=r.length,o=new Array(l);o[0]=u;var i={};for(var p in e)hasOwnProperty.call(e,p)&&(i[p]=e[p]);i.originalType=t,i.mdxType="string"==typeof t?t:a,o[1]=i;for(var d=2;d{r.r(e),r.d(e,{assets:()=>p,contentTitle:()=>o,default:()=>g,frontMatter:()=>l,metadata:()=>i,toc:()=>d});var n=r(87462),a=(r(67294),r(3905));const l={title:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",sidebar_label:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",sidebar_position:10},o=void 0,i={unversionedId:"v5/order/spot-borrow-quota",id:"v5/order/spot-borrow-quota",title:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",description:"\u53ef\u4ee5\u67e5\u8a62\u73fe\u8ca8\u5e63\u5e63\u4ea4\u6613\u4ee5\u53ca\u69d3\u687f\u4ea4\u6613\u6642, \u53ef\u7528\u5c0d\u61c9\u5e63\u7a2e\u7684\u5be6\u6642\u9918\u984d",source:"@site/i18n/zh-TW/docusaurus-plugin-content-docs/current/v5/order/spot-borrow-quota.mdx",sourceDirName:"v5/order",slug:"/v5/order/spot-borrow-quota",permalink:"/docs/zh-TW/v5/order/spot-borrow-quota",draft:!1,tags:[],version:"current",sidebarPosition:10,frontMatter:{title:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",sidebar_label:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",sidebar_position:10},sidebar:"v5SideBar",previous:{title:"\u6279\u91cf\u64a4\u92b7\u59d4\u8a17\u55ae",permalink:"/docs/zh-TW/v5/order/batch-cancel"},next:{title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593",permalink:"/docs/zh-TW/v5/order/dcp"}},p={},d=[{value:"HTTP\u8acb\u6c42",id:"http\u8acb\u6c42",level:3},{value:"\u8acb\u6c42\u53c3\u6578",id:"\u8acb\u6c42\u53c3\u6578",level:3},{value:"\u97ff\u61c9\u53c3\u6578",id:"\u97ff\u61c9\u53c3\u6578",level:3},{value:"\u8acb\u6c42\u793a\u4f8b",id:"\u8acb\u6c42\u793a\u4f8b",level:3},{value:"\u97ff\u61c9\u793a\u4f8b",id:"\u97ff\u61c9\u793a\u4f8b",level:3}],m=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",e)},s=m("Button"),u=m("Tabs"),c=m("TabItem"),k={toc:d};function g(t){let{components:e,...r}=t;return(0,a.kt)("wrapper",(0,n.Z)({},k,r,{components:e,mdxType:"MDXLayout"}),(0,a.kt)("p",null,"\u53ef\u4ee5\u67e5\u8a62\u73fe\u8ca8\u5e63\u5e63\u4ea4\u6613\u4ee5\u53ca\u69d3\u687f\u4ea4\u6613\u6642, \u53ef\u7528\u5c0d\u61c9\u5e63\u7a2e\u7684\u5be6\u6642\u9918\u984d"),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 (\u7d71\u4e00\u5e33\u6236)"))),(0,a.kt)("h3",{id:"http\u8acb\u6c42"},"HTTP\u8acb\u6c42"),(0,a.kt)("p",null,"GET ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/spot-borrow-check")),(0,a.kt)("h3",{id:"\u8acb\u6c42\u53c3\u6578"},"\u8acb\u6c42\u53c3\u6578"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u662f\u5426\u5fc5\u9700"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,a.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("a",{parentName:"td",href:"../enum#category"},"category")),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u7522\u54c1\u985e\u578b. ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u5c0d\u540d\u7a31")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"side"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u65b9\u5411. ",(0,a.kt)("inlineCode",{parentName:"td"},"Buy"),",",(0,a.kt)("inlineCode",{parentName:"td"},"Sell"))))),(0,a.kt)("h3",{id:"\u97ff\u61c9\u53c3\u6578"},"\u97ff\u61c9\u53c3\u6578"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,a.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u5c0d\u540d\u7a31")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"side"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u65b9\u5411")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"maxTradeQty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u6700\u5927\u53ef\u7528\u65bc\u4ea4\u6613\u7684\u4ea4\u6613\u5e63\u7a2e\u6578\u91cf",(0,a.kt)("ul",null,(0,a.kt)("li",null,"\u82e5\u555f\u7528\u4e86\u5168\u5009\u69d3\u687f\u4e14\u662f\u69d3\u687f\u5e63\u5c0d, \u5247\u8fd4\u56de\u73fe\u8ca8\u53ef\u7528+\u6700\u5927\u53ef\u501f\u8cb8\u6578\u91cf = min(\u5e73\u53f0\u55ae\u4e00\u7528\u6236\u53ef\u501f\u8cb8\u4e0a\u9650\uff0cUTA\u5e33\u6236IMR MMR\u53cd\u63a8\u51fa\u4f86\u7684\u6700\u5927\u53ef\u501f\uff0c\u5e73\u53f0\u8cc7\u91d1\u6c60\u53ef\u7528\u984d\u5ea6)"),(0,a.kt)("li",null,"\u5426\u5247, \u50c5\u4ee3\u8868\u73fe\u8ca8\u53ef\u7528"),(0,a.kt)("li",null,"\u6700\u591a\u652f\u63014\u4f4d\u5c0f\u6578")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"maxTradeAmount"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u6700\u5927\u53ef\u7528\u65bc\u4ea4\u6613\u7684\u5831\u50f9\u5e63\u7a2e\u91d1\u984d",(0,a.kt)("ul",null,(0,a.kt)("li",null,"\u82e5\u555f\u7528\u4e86\u5168\u5009\u69d3\u687f\u4e14\u662f\u69d3\u687f\u5e63\u5c0d, \u5247\u8fd4\u56de\u73fe\u8ca8\u53ef\u7528+\u6700\u5927\u53ef\u501f\u8cb8\u6578\u91cf = min(\u5e73\u53f0\u55ae\u4e00\u7528\u6236\u53ef\u501f\u8cb8\u4e0a\u9650\uff0cUTA\u5e33\u6236IMR MMR\u53cd\u63a8\u51fa\u4f86\u7684\u6700\u5927\u53ef\u501f\uff0c\u5e73\u53f0\u8cc7\u91d1\u6c60\u53ef\u7528\u984d\u5ea6) "),(0,a.kt)("li",null,"\u5426\u5247, \u50c5\u4ee3\u8868\u73fe\u8ca8\u53ef\u7528"),(0,a.kt)("li",null,"\u6700\u591a\u652f\u63018\u4f4d\u5c0f\u6578")," "))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"spotMaxTradeQty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u7121\u8ad6\u662f\u5426\u958b\u555f\u4e86\u69d3\u687f, \u9019\u500b\u5b57\u6bb5\u8868\u793a\u4ea4\u6613\u5e63\u7a2e\u5728\u5e63\u5e63\u4ea4\u6613\u4e0b\u7684\u53ef\u4ea4\u6613\u6578\u91cf\u6216\u8005\u9918\u984d (\u4e0d\u5305\u542b\u53ef\u501f\u8cb8\u6578\u91cf), \u6700\u591a\u652f\u63014\u4f4d\u5c0f\u6578")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"spotMaxTradeAmount"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u7121\u8ad6\u662f\u5426\u958b\u555f\u4e86\u69d3\u687f, \u9019\u500b\u5b57\u6bb5\u8868\u793a\u5831\u50f9\u5e63\u7a2e\u5728\u5e63\u5e63\u4ea4\u6613\u4e0b\u7684\u53ef\u4ea4\u6613\u6578\u91cf\u6216\u8005\u9918\u984d (\u4e0d\u5305\u542b\u53ef\u501f\u8cb8\u6578\u91cf), \u6700\u591a\u652f\u63018\u4f4d\u5c0f\u6578")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"borrowCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u501f\u8cb8\u5e63\u7a2e")))),(0,a.kt)("a",{href:"/api-explorer/v5/trade/query-spot-quota"},(0,a.kt)(s,{mdxType:"Button"},"\u904b\u884c\u5be6\u4f8b >>")),(0,a.kt)("hr",null),(0,a.kt)("h3",{id:"\u8acb\u6c42\u793a\u4f8b"},"\u8acb\u6c42\u793a\u4f8b"),(0,a.kt)(u,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(c,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/order/spot-borrow-check?category=spot&symbol=BTCUSDT&side=Buy HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672228522214\nX-BAPI-RECV-WINDOW: 5000\n"))),(0,a.kt)(c,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_borrow_quota(\n category="spot",\n symbol="BTCUSDT",\n side="Buy",\n))\n'))),(0,a.kt)(c,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar getBorrowQuotaRequest = TradeOrderRequest.builder().category(CategoryType.SPOT).symbol("BTCUSDT").side(Side.BUY).build();\nSystem.out.println(client.getBorrowQuota(getBorrowQuotaRequest));\n'))),(0,a.kt)(c,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getSpotBorrowCheck('BTCUSDT', 'Buy')\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"\u97ff\u61c9\u793a\u4f8b"},"\u97ff\u61c9\u793a\u4f8b"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "symbol": "BTCUSDT",\n "maxTradeQty": "6.6065",\n "side": "Buy",\n "spotMaxTradeAmount": "9004.75628594",\n "maxTradeAmount": "218014.01330797",\n "borrowCoin": "USDT",\n "spotMaxTradeQty": "0.2728"\n },\n "retExtInfo": {},\n "time": 1698895841534\n}\n')))}g.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/e9b84ed8.615bfb87.js b/zh-TW/assets/js/e9b84ed8.615bfb87.js deleted file mode 100644 index ada0725cbc..0000000000 --- a/zh-TW/assets/js/e9b84ed8.615bfb87.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocusaurus_docs=self.webpackChunkdocusaurus_docs||[]).push([[24947],{3905:(t,e,r)=>{r.d(e,{Zo:()=>m,kt:()=>c});var n=r(67294);function a(t,e,r){return e in t?Object.defineProperty(t,e,{value:r,enumerable:!0,configurable:!0,writable:!0}):t[e]=r,t}function l(t,e){var r=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),r.push.apply(r,n)}return r}function o(t){for(var e=1;e=0||(a[r]=t[r]);return a}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(t,r)&&(a[r]=t[r])}return a}var p=n.createContext({}),d=function(t){var e=n.useContext(p),r=e;return t&&(r="function"==typeof t?t(e):o(o({},e),t)),r},m=function(t){var e=d(t.components);return n.createElement(p.Provider,{value:e},t.children)},s={inlineCode:"code",wrapper:function(t){var e=t.children;return n.createElement(n.Fragment,{},e)}},u=n.forwardRef((function(t,e){var r=t.components,a=t.mdxType,l=t.originalType,p=t.parentName,m=i(t,["components","mdxType","originalType","parentName"]),u=d(r),c=a,k=u["".concat(p,".").concat(c)]||u[c]||s[c]||l;return r?n.createElement(k,o(o({ref:e},m),{},{components:r})):n.createElement(k,o({ref:e},m))}));function c(t,e){var r=arguments,a=e&&e.mdxType;if("string"==typeof t||a){var l=r.length,o=new Array(l);o[0]=u;var i={};for(var p in e)hasOwnProperty.call(e,p)&&(i[p]=e[p]);i.originalType=t,i.mdxType="string"==typeof t?t:a,o[1]=i;for(var d=2;d{r.r(e),r.d(e,{assets:()=>p,contentTitle:()=>o,default:()=>g,frontMatter:()=>l,metadata:()=>i,toc:()=>d});var n=r(87462),a=(r(67294),r(3905));const l={title:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",sidebar_label:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",sidebar_position:10},o=void 0,i={unversionedId:"v5/order/spot-borrow-quota",id:"v5/order/spot-borrow-quota",title:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",description:"\u53ef\u4ee5\u67e5\u8a62\u73fe\u8ca8\u5e63\u5e63\u4ea4\u6613\u4ee5\u53ca\u69d3\u687f\u4ea4\u6613\u6642, \u53ef\u7528\u5c0d\u61c9\u5e63\u7a2e\u7684\u5be6\u6642\u9918\u984d",source:"@site/i18n/zh-TW/docusaurus-plugin-content-docs/current/v5/order/spot-borrow-quota.mdx",sourceDirName:"v5/order",slug:"/v5/order/spot-borrow-quota",permalink:"/docs/zh-TW/v5/order/spot-borrow-quota",draft:!1,tags:[],version:"current",sidebarPosition:10,frontMatter:{title:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",sidebar_label:"\u67e5\u8a62\u7528\u6236\u53ef\u7528\u984d\u5ea6 (\u73fe\u8ca8)",sidebar_position:10},sidebar:"v5SideBar",previous:{title:"\u6279\u91cf\u64a4\u92b7\u59d4\u8a17\u55ae",permalink:"/docs/zh-TW/v5/order/batch-cancel"},next:{title:"\u8a2d\u7f6e\u65b7\u7dda\u4fdd\u8b77\u6642\u9593 (\u671f\u6b0a)",permalink:"/docs/zh-TW/v5/order/dcp"}},p={},d=[{value:"HTTP\u8acb\u6c42",id:"http\u8acb\u6c42",level:3},{value:"\u8acb\u6c42\u53c3\u6578",id:"\u8acb\u6c42\u53c3\u6578",level:3},{value:"\u97ff\u61c9\u53c3\u6578",id:"\u97ff\u61c9\u53c3\u6578",level:3},{value:"\u8acb\u6c42\u793a\u4f8b",id:"\u8acb\u6c42\u793a\u4f8b",level:3},{value:"\u97ff\u61c9\u793a\u4f8b",id:"\u97ff\u61c9\u793a\u4f8b",level:3}],m=t=>function(e){return console.warn("Component "+t+" was not imported, exported, or provided by MDXProvider as global scope"),(0,a.kt)("div",e)},s=m("Button"),u=m("Tabs"),c=m("TabItem"),k={toc:d};function g(t){let{components:e,...r}=t;return(0,a.kt)("wrapper",(0,n.Z)({},k,r,{components:e,mdxType:"MDXLayout"}),(0,a.kt)("p",null,"\u53ef\u4ee5\u67e5\u8a62\u73fe\u8ca8\u5e63\u5e63\u4ea4\u6613\u4ee5\u53ca\u69d3\u687f\u4ea4\u6613\u6642, \u53ef\u7528\u5c0d\u61c9\u5e63\u7a2e\u7684\u5be6\u6642\u9918\u984d"),(0,a.kt)("blockquote",null,(0,a.kt)("p",{parentName:"blockquote"},(0,a.kt)("strong",{parentName:"p"},"\u8986\u84cb\u7bc4\u570d: \u73fe\u8ca8 (\u7d71\u4e00\u5e33\u6236)"))),(0,a.kt)("h3",{id:"http\u8acb\u6c42"},"HTTP\u8acb\u6c42"),(0,a.kt)("p",null,"GET ",(0,a.kt)("inlineCode",{parentName:"p"},"/v5/order/spot-borrow-check")),(0,a.kt)("h3",{id:"\u8acb\u6c42\u53c3\u6578"},"\u8acb\u6c42\u53c3\u6578"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u662f\u5426\u5fc5\u9700"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,a.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("a",{parentName:"td",href:"../enum#category"},"category")),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u7522\u54c1\u985e\u578b. ",(0,a.kt)("inlineCode",{parentName:"td"},"spot"))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u5c0d\u540d\u7a31")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"side"),(0,a.kt)("td",{parentName:"tr",align:"left"},(0,a.kt)("strong",{parentName:"td"},"true")),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u65b9\u5411. ",(0,a.kt)("inlineCode",{parentName:"td"},"Buy"),",",(0,a.kt)("inlineCode",{parentName:"td"},"Sell"))))),(0,a.kt)("h3",{id:"\u97ff\u61c9\u53c3\u6578"},"\u97ff\u61c9\u53c3\u6578"),(0,a.kt)("table",null,(0,a.kt)("thead",{parentName:"table"},(0,a.kt)("tr",{parentName:"thead"},(0,a.kt)("th",{parentName:"tr",align:"left"},"\u53c3\u6578"),(0,a.kt)("th",{parentName:"tr",align:"left"},"\u985e\u578b"),(0,a.kt)("th",{parentName:"tr",align:null},"\u8aaa\u660e"))),(0,a.kt)("tbody",{parentName:"table"},(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"symbol"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u4ea4\u6613\u5c0d\u540d\u7a31")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"side"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u65b9\u5411")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"maxTradeQty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u6700\u5927\u53ef\u7528\u65bc\u4ea4\u6613\u7684\u4ea4\u6613\u5e63\u7a2e\u6578\u91cf",(0,a.kt)("ul",null,(0,a.kt)("li",null,"\u82e5\u555f\u7528\u4e86\u5168\u5009\u69d3\u687f\u4e14\u662f\u69d3\u687f\u5e63\u5c0d, \u5247\u8fd4\u56de\u73fe\u8ca8\u53ef\u7528+\u6700\u5927\u53ef\u501f\u8cb8\u6578\u91cf = min(\u5e73\u53f0\u55ae\u4e00\u7528\u6236\u53ef\u501f\u8cb8\u4e0a\u9650\uff0cUTA\u5e33\u6236IMR MMR\u53cd\u63a8\u51fa\u4f86\u7684\u6700\u5927\u53ef\u501f\uff0c\u5e73\u53f0\u8cc7\u91d1\u6c60\u53ef\u7528\u984d\u5ea6)"),(0,a.kt)("li",null,"\u5426\u5247, \u50c5\u4ee3\u8868\u73fe\u8ca8\u53ef\u7528"),(0,a.kt)("li",null,"\u6700\u591a\u652f\u63014\u4f4d\u5c0f\u6578")))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"maxTradeAmount"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u6700\u5927\u53ef\u7528\u65bc\u4ea4\u6613\u7684\u5831\u50f9\u5e63\u7a2e\u91d1\u984d",(0,a.kt)("ul",null,(0,a.kt)("li",null,"\u82e5\u555f\u7528\u4e86\u5168\u5009\u69d3\u687f\u4e14\u662f\u69d3\u687f\u5e63\u5c0d, \u5247\u8fd4\u56de\u73fe\u8ca8\u53ef\u7528+\u6700\u5927\u53ef\u501f\u8cb8\u6578\u91cf = min(\u5e73\u53f0\u55ae\u4e00\u7528\u6236\u53ef\u501f\u8cb8\u4e0a\u9650\uff0cUTA\u5e33\u6236IMR MMR\u53cd\u63a8\u51fa\u4f86\u7684\u6700\u5927\u53ef\u501f\uff0c\u5e73\u53f0\u8cc7\u91d1\u6c60\u53ef\u7528\u984d\u5ea6) "),(0,a.kt)("li",null,"\u5426\u5247, \u50c5\u4ee3\u8868\u73fe\u8ca8\u53ef\u7528"),(0,a.kt)("li",null,"\u6700\u591a\u652f\u63018\u4f4d\u5c0f\u6578")," "))),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"spotMaxTradeQty"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u7121\u8ad6\u662f\u5426\u958b\u555f\u4e86\u69d3\u687f, \u9019\u500b\u5b57\u6bb5\u8868\u793a\u4ea4\u6613\u5e63\u7a2e\u5728\u5e63\u5e63\u4ea4\u6613\u4e0b\u7684\u53ef\u4ea4\u6613\u6578\u91cf\u6216\u8005\u9918\u984d (\u4e0d\u5305\u542b\u53ef\u501f\u8cb8\u6578\u91cf), \u6700\u591a\u652f\u63014\u4f4d\u5c0f\u6578")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"spotMaxTradeAmount"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u7121\u8ad6\u662f\u5426\u958b\u555f\u4e86\u69d3\u687f, \u9019\u500b\u5b57\u6bb5\u8868\u793a\u5831\u50f9\u5e63\u7a2e\u5728\u5e63\u5e63\u4ea4\u6613\u4e0b\u7684\u53ef\u4ea4\u6613\u6578\u91cf\u6216\u8005\u9918\u984d (\u4e0d\u5305\u542b\u53ef\u501f\u8cb8\u6578\u91cf), \u6700\u591a\u652f\u63018\u4f4d\u5c0f\u6578")),(0,a.kt)("tr",{parentName:"tbody"},(0,a.kt)("td",{parentName:"tr",align:"left"},"borrowCoin"),(0,a.kt)("td",{parentName:"tr",align:"left"},"string"),(0,a.kt)("td",{parentName:"tr",align:null},"\u501f\u8cb8\u5e63\u7a2e")))),(0,a.kt)("a",{href:"/api-explorer/v5/trade/query-spot-quota"},(0,a.kt)(s,{mdxType:"Button"},"\u904b\u884c\u5be6\u4f8b >>")),(0,a.kt)("hr",null),(0,a.kt)("h3",{id:"\u8acb\u6c42\u793a\u4f8b"},"\u8acb\u6c42\u793a\u4f8b"),(0,a.kt)(u,{groupId:"programming-languages",mdxType:"Tabs"},(0,a.kt)(c,{value:"http",label:"HTTP",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-http"},"GET /v5/order/spot-borrow-check?category=spot&symbol=BTCUSDT&side=Buy HTTP/1.1\nHost: api-testnet.bybit.com\nX-BAPI-SIGN: XXXXX\nX-BAPI-API-KEY: XXXXX\nX-BAPI-TIMESTAMP: 1672228522214\nX-BAPI-RECV-WINDOW: 5000\n"))),(0,a.kt)(c,{value:"python",label:"Python",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-python"},'from pybit.unified_trading import HTTP\nsession = HTTP(\n testnet=True,\n api_key="XXXXX",\n api_secret="XXXXX",\n)\nprint(session.get_borrow_quota(\n category="spot",\n symbol="BTCUSDT",\n side="Buy",\n))\n'))),(0,a.kt)(c,{value:"java",label:"Java",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-java"},'import com.bybit.api.client.config.BybitApiConfig;\nimport com.bybit.api.client.domain.trade.request.TradeOrderRequest;\nimport com.bybit.api.client.domain.*;\nimport com.bybit.api.client.domain.trade.*;\nimport com.bybit.api.client.service.BybitApiClientFactory;\nvar client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();\nvar getBorrowQuotaRequest = TradeOrderRequest.builder().category(CategoryType.SPOT).symbol("BTCUSDT").side(Side.BUY).build();\nSystem.out.println(client.getBorrowQuota(getBorrowQuotaRequest));\n'))),(0,a.kt)(c,{value:"Node",label:"Node.js",mdxType:"TabItem"},(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-n4js"},"const { RestClientV5 } = require('bybit-api');\n\nconst client = new RestClientV5({\n testnet: true,\n key: 'apikey',\n secret: 'apisecret',\n});\n\nclient\n .getSpotBorrowCheck('BTCUSDT', 'Buy')\n .then((response) => {\n console.log(response);\n })\n .catch((error) => {\n console.error(error);\n });\n")))),(0,a.kt)("h3",{id:"\u97ff\u61c9\u793a\u4f8b"},"\u97ff\u61c9\u793a\u4f8b"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "retCode": 0,\n "retMsg": "OK",\n "result": {\n "symbol": "BTCUSDT",\n "maxTradeQty": "6.6065",\n "side": "Buy",\n "spotMaxTradeAmount": "9004.75628594",\n "maxTradeAmount": "218014.01330797",\n "borrowCoin": "USDT",\n "spotMaxTradeQty": "0.2728"\n },\n "retExtInfo": {},\n "time": 1698895841534\n}\n')))}g.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/zh-TW/assets/js/runtime~main.54c7b63e.js b/zh-TW/assets/js/runtime~main.7694db80.js similarity index 91% rename from zh-TW/assets/js/runtime~main.54c7b63e.js rename to zh-TW/assets/js/runtime~main.7694db80.js index c937cf6af7..b671ae5918 100644 --- a/zh-TW/assets/js/runtime~main.54c7b63e.js +++ b/zh-TW/assets/js/runtime~main.7694db80.js @@ -1 +1 @@ -(()=>{"use strict";var e,a,b,c,f,d={},r={};function t(e){var a=r[e];if(void 0!==a)return a.exports;var b=r[e]={id:e,loaded:!1,exports:{}};return d[e].call(b.exports,b,b.exports,t),b.loaded=!0,b.exports}t.m=d,e=[],t.O=(a,b,c,f)=>{if(!b){var d=1/0;for(i=0;i=f)&&Object.keys(t.O).every((e=>t.O[e](b[o])))?b.splice(o--,1):(r=!1,f0&&e[i-1][2]>f;i--)e[i]=e[i-1];e[i]=[b,c,f]},t.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return t.d(a,{a:a}),a},b=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,t.t=function(e,c){if(1&c&&(e=this(e)),8&c)return e;if("object"==typeof e&&e){if(4&c&&e.__esModule)return e;if(16&c&&"function"==typeof e.then)return e}var f=Object.create(null);t.r(f);var d={};a=a||[null,b({}),b([]),b(b)];for(var r=2&c&&e;"object"==typeof r&&!~a.indexOf(r);r=b(r))Object.getOwnPropertyNames(r).forEach((a=>d[a]=()=>e[a]));return d.default=()=>e,t.d(f,d),f},t.d=(e,a)=>{for(var b in a)t.o(a,b)&&!t.o(e,b)&&Object.defineProperty(e,b,{enumerable:!0,get:a[b]})},t.f={},t.e=e=>Promise.all(Object.keys(t.f).reduce(((a,b)=>(t.f[b](e,a),a)),[])),t.u=e=>"assets/js/"+({16:"a2a78cd2",17:"5df371ad",288:"575a2139",482:"4ef5f34b",520:"fb1a77b4",547:"3365bb5d",930:"bc8f9087",1045:"3ef25e43",1288:"ecc882d7",1325:"1ff2c95d",1369:"2be8d75a",1764:"8f25d185",1893:"4c5e977b",2050:"f54e89d1",2201:"8ba34e88",2222:"0c82f1cb",2269:"a596dc7e",2281:"652aa3bb",2487:"b7b09b70",2751:"faa6790b",3300:"655c39d2",3507:"2425c15c",3909:"3e441ee4",4086:"78ec6490",4746:"93a1b6a2",5253:"1bcb7f60",6147:"1f54c2ac",6352:"e628edd4",6542:"af2c52ce",6729:"e2cf295d",7415:"5ea9e4ca",7848:"b760913b",8156:"38784009",8179:"136658e4",8214:"9755f20c",8392:"8d4600d0",8478:"401fb871",8883:"6860968b",9642:"0002f649",9706:"2eca92d8",9817:"14eb3368",9862:"d5ac6535",9904:"f62a7bc0",10040:"954c355d",10235:"a7d19085",10293:"fa570740",10471:"b71c170b",11013:"e8acd80e",11053:"7205acf7",11120:"7c3d9323",11434:"99aca8b2",11500:"d68165b9",11606:"5016f915",11968:"f34bbf22",12920:"ee2d7736",12944:"a4a7c88e",13055:"97600ac6",13085:"1f391b9e",13408:"fdf22a50",13586:"c668d467",13667:"bf60373a",13874:"643f775f",13959:"2d0f081e",14030:"c5d3bb95",14188:"035fc0a7",14243:"0744e06b",14710:"2492320d",15114:"ee7f03d8",15365:"b82d00b2",15772:"b568538e",15975:"1bab1317",16021:"a42811bf",16039:"4e6201a8",16052:"8aab06bf",16175:"567ff302",16649:"a19cf377",16950:"b43e4353",16991:"3f53f1c4",17175:"c4f64aee",17217:"4ef1736a",17277:"72ceeaac",17446:"eaca4732",17661:"265355c2",17882:"e88bed7b",17929:"d56e3bd7",18350:"0f2e9443",18387:"2be7eaec",18471:"2bfafb22",18610:"c5a9135f",19219:"f2bfa581",19396:"9f35e670",19423:"1912069b",20202:"1e049e66",20367:"05a3c259",21413:"6dfd8a52",21493:"79022373",22043:"269c0fa1",22190:"89f7284f",22465:"1955e4c9",22620:"cf587678",22821:"dac58f9a",22982:"f041af6f",23105:"6ac88df6",23198:"15df18f8",23349:"5b6fa4ec",23389:"9041aea1",23563:"935cb8db",23733:"b82293b3",23891:"642b1006",24669:"f552bd00",24697:"c54eca7f",24698:"92e11b3f",24947:"e9b84ed8",25090:"87897be6",25370:"af4a2ad4",25382:"632d2515",25760:"31e78686",25817:"7988f281",25968:"156751cf",26158:"d2de2978",26467:"302d24dc",26560:"5b788f5c",27e3:"3326e4c4",27078:"d7ac3c03",27079:"49a0e813",27133:"92e99bf6",27188:"5036ec9d",28135:"89179ad6",28268:"b8161d6a",28271:"f7eb3a66",28429:"b052b80c",28751:"e31a16ba",28800:"1dbaa503",29010:"8c2621f5",29140:"1d8ede30",29513:"0ac7fcd1",29514:"1be78505",29538:"4c950052",29681:"4d96b439",29728:"38c90751",29776:"5dab34b6",30321:"751792b8",30561:"bc670d5c",30601:"e5d84bc0",30708:"124f7953",30717:"ecdb20a1",31287:"b2d0af62",31404:"3e301362",31538:"19b883ea",31626:"3394f7b8",31640:"4f7dcb1e",31657:"8fbaa47b",31833:"86fd2478",31854:"b45ff73d",32074:"13063a10",32446:"6870c8c4",32854:"6c46dea8",33034:"41ed4202",33232:"6131b9f8",33263:"005fee41",33404:"afdda5b6",33431:"e35d3956",33451:"f5b6c895",33509:"786f71e5",33790:"c423df2e",33887:"10ca1dd8",33912:"1bc94aef",34204:"269acb60",34346:"1db637b2",34533:"3abccbcc",34756:"9c643b6e",34826:"70e3a7c5",34980:"ea7cec67",35226:"e7958aaa",35330:"eadead04",35424:"3635a766",35708:"41eb0037",35943:"bc53881b",36206:"90c3ec62",36586:"8c3021dd",36904:"e71641ea",37442:"f6ef3039",37486:"dcc6b54d",37487:"a9bf2227",37742:"969753d7",38145:"28e7e1e3",38270:"5393ce94",38461:"917300a3",38499:"a88f137d",38527:"4f9fd89c",38601:"f7242226",39066:"a4a7a840",39220:"7114ac56",39229:"429a6f3e",39494:"01804294",39626:"fd867f7c",40541:"816b2b7d",40701:"1ce0a301",40916:"e4459066",41003:"d0d62bb5",41150:"fe26f94f",41650:"c7707dd8",41916:"2a38ab5e",41957:"d69803c7",42008:"9e43e7b6",42070:"7cb4903f",42124:"19357a65",42181:"be510d4c",42355:"2f504c6e",42573:"ce346131",42885:"acdbee8e",42954:"2814cf01",43600:"1dcc65e0",43777:"b9aefb1a",43819:"fc1db29b",44209:"278665dc",44484:"3cd952ae",44497:"d32e6b20",44588:"3c5750f8",44685:"f5c87087",44758:"0a13a0e4",44962:"1c5f7d2b",45044:"17abfa8d",45350:"e8c60e9b",45841:"0c0bbaea",45843:"e4bacbbb",45960:"5b3c1c53",46294:"db229a81",46581:"c2d91591",47234:"ae346411",47328:"6daf901a",47422:"1cf37028",47615:"84ebbbbf",47629:"0cd0cfa8",47834:"09be2ba2",48343:"2c056d5d",48733:"d21505c8",48890:"d5603669",48954:"b0bdb7f3",49157:"9de65041",49346:"b8919bdb",49486:"e72cf26a",49549:"48e0b5d4",49567:"f0cf672d",49871:"b2f83e6d",49907:"f2e41396",50561:"254ac25b",51435:"fe2b089e",51537:"431ad29b",51613:"27b935de",51618:"2cbe9533",51953:"c3e83a7d",52021:"25b6fab0",52486:"de127d6b",52631:"c46f1db0",52745:"68843839",53068:"c3d815ae",53302:"cb8de75d",53587:"73567145",53609:"81be975d",53685:"8c00b41d",53861:"3e96b4b5",54487:"5ebc7423",54709:"2b93221c",54736:"a5463d8a",54749:"bf25430f",55035:"ea64ac1c",55260:"9e4d6f26",55480:"006095b2",55841:"a67bdd24",55945:"79aa13fb",56025:"c3aed80f",56248:"8a1c8da1",56364:"281b126c",56370:"36f93d19",56419:"80e8986a",56615:"b4f4317d",56963:"1b80e345",56979:"d005934a",57103:"77d0fddc",57287:"bde9fb45",57361:"3e26f8b3",57573:"e3e4fe7d",58424:"03edb22c",58729:"dbbfa97d",59131:"3b0223df",59213:"f6bb9d12",59273:"fcae69e8",59728:"aa5bd2a7",59856:"e5c88a3e",59865:"e8ee0390",60439:"fca48710",60946:"bb292d37",60974:"11314fda",61304:"8d5fe6f9",61928:"15113e52",61931:"4c21dbbd",62062:"988ba51e",62536:"431b5d0e",62726:"748490a7",62781:"703f575d",62954:"90305fb4",63119:"d7567838",63157:"586e3f5e",63453:"37da3438",64131:"52c1dace",64195:"c4f5d8e4",64302:"05c5421d",64549:"788d9fe0",64807:"8a495097",64841:"b49164a1",65064:"4840c3eb",65135:"789f108c",65368:"cc468388",65369:"c15b67f7",65649:"8047f3a3",65787:"c4ae09d4",65858:"1290c878",65882:"6aa5826c",65954:"b9776525",65957:"e4627c87",66073:"97b92a45",66334:"3c39ccf9",67140:"e8b2d68f",67365:"18f77871",67396:"a9dd1cc8",67673:"6eb57332",67744:"6ca8826f",67813:"8894256f",67818:"baa3212e",67995:"ff2d6dd8",68026:"e63b451d",68122:"db9559d3",68189:"26e12baa",68224:"78bca219",68265:"389bb65e",68349:"3d3a07f6",68436:"68408d35",68618:"88e3fe7e",68755:"a79a2e70",68960:"03cc88eb",69043:"9ad8637e",69345:"01a16f71",69360:"98a6b9c4",69413:"71063c2b",69905:"e23eefc0",69998:"b7cfb3da",70207:"68556356",70421:"a934672d",70520:"e2df322b",70611:"fa114b0c",70633:"b50c9021",70838:"22bdf908",71147:"1a99b1ee",71253:"970a27d6",71360:"17b00a4a",71386:"b1892b20",71525:"3b7cd1e1",71670:"6d8024b7",71723:"0328b0c9",72371:"47c64002",72464:"8b8c4320",72474:"f9e1fd09",72556:"5614add0",72939:"a626e327",73088:"955e06fd",73555:"3627f230",73634:"e0bec19d",74010:"37cea19d",74123:"a8654aa2",74190:"84cf2087",74199:"67db246e",74298:"48db5030",74318:"b8d9b1bd",74400:"aacc2fee",74904:"c0ad5dc6",75034:"30a22249",75062:"add4d791",75063:"cf69f832",75212:"19b0499c",75248:"e82ff315",75384:"42bb1101",75478:"200e51df",75647:"2b3e7a7f",76413:"777bd32a",76559:"93b78259",76907:"a208e2a5",77183:"a94c7dba",77184:"11b4dd89",77769:"60ea2d86",77771:"56a38f24",77787:"53bd4095",78023:"2b20c80a",78297:"71051dda",78301:"676afd3b",78382:"1a77ceda",78494:"e49348be",78560:"fd37922c",78880:"44befa6d",78897:"8a942fcc",79022:"9beaa53d",79376:"6249c7de",79527:"20358428",79639:"7cd86536",79796:"d2c4b928",80053:"935f2afb",80371:"c038b4a2",80536:"17c91901",80693:"cfc8b1e5",80802:"48d397c0",80954:"db449848",81355:"9ad476bb",81832:"a8e44541",81981:"c8450cf2",82251:"989904ef",82591:"de89bf85",82946:"3b83c135",83e3:"cc7f3e03",83443:"f47c1d11",83540:"6500be67",83667:"ab4a8e8f",83771:"8c02dfd8",83882:"3a4337ef",83922:"cc806444",84453:"fc15d889",84683:"25b7eef7",85015:"f21b2fb0",85064:"d02b76f9",85185:"e1b9cf16",85228:"2fcb69bb",85694:"db0d392c",85897:"6b3775fc",85953:"b700f6c8",86072:"26183636",86098:"149e5a51",86181:"a01bbcd4",86401:"fed0304a",86455:"e8c8f122",86764:"d8958d75",86948:"af7ab695",87074:"6268d0ca",87306:"aebe3827",87414:"393be207",87582:"7fc0684b",87593:"50219e10",87655:"40230f21",88115:"d0e9a494",88184:"87f76dec",89101:"e2c0c813",89645:"e760b063",89987:"9ccbc3bf",90206:"4a9b1fdb",90558:"93f8b8b5",90888:"5c18dc43",91172:"864138a2",91218:"29cd8cc9",91250:"8758e270",91919:"d51ffe49",92546:"cc24cbe6",92903:"84ee34f2",93337:"bef6aaf2",93387:"007a6c32",93519:"6f951ae3",93546:"1010372b",93610:"caba9b9f",93822:"7d52489f",93903:"5610cdb3",94018:"046df3c9",94089:"d9ffe17e",94091:"5c128c28",94194:"4b3e38af",94229:"c8a044ba",94319:"d0816b53",94708:"23cc9db4",94722:"5282f1c8",94900:"5787f6d3",94907:"29f28a73",95034:"64be7568",95188:"b42420f8",95461:"308641fb",95690:"f4bc196f",96276:"8aadacf1",96374:"6135d371",97482:"4a3e680b",97889:"02193fc8",97920:"1a4e3797",98016:"ffb2e417",98276:"2205312d",98444:"cc9c20e3",98509:"92ac5c16",98623:"394c74c3",98630:"68e9a632",98666:"f64e920b",98692:"67044a7a",99074:"e8646b2e",99156:"ff6e33f8",99235:"fe793f9f",99350:"196bfd5c",99438:"b5511831",99875:"57d9a11e",99889:"f56b8973",99959:"ebec70a2"}[e]||e)+"."+{16:"95e0997a",17:"02142ea6",288:"33a85255",482:"d9f5e639",520:"c21570a5",547:"bdec885e",930:"ea3478bd",1045:"ca6b16e4",1288:"cec758fd",1325:"36daf010",1369:"eb6ba0a8",1764:"1a6031d3",1893:"4a98b5fe",2050:"7b453b74",2201:"ad3df26d",2222:"ec9f034c",2269:"d8675fc0",2281:"05e72793",2487:"2b476883",2751:"4b562ced",3300:"1f36e88e",3507:"3145d6a9",3909:"d63592c0",4086:"6391b158",4746:"9948c140",4972:"c1e0c51c",5253:"3c8fc32e",6147:"eb09fe54",6338:"a4b54b32",6352:"5d14f184",6542:"b3f1d6d5",6729:"893492e4",7415:"a4a917a1",7848:"4c2aa69e",8156:"2d6a320e",8179:"350c6a2c",8214:"7f863a65",8392:"95aff25c",8478:"7bac00a3",8883:"ddf92a47",9642:"6869b485",9706:"349d0471",9799:"51815cbe",9817:"f9d79ca6",9862:"33c1d656",9904:"7ea4de16",10040:"7ac06fa5",10235:"ab4f13c3",10293:"87f68b44",10471:"5fe12cb7",11013:"ade95505",11053:"373f5210",11120:"150310d8",11434:"8e1d9c59",11500:"3dff2bcd",11606:"56683491",11968:"a755f5af",12920:"d03eea4e",12944:"2add0bd9",13055:"65361055",13085:"74c4de50",13408:"2e25889f",13586:"8c682e32",13667:"8d362cf8",13874:"cbb8c1d9",13959:"42f78561",14030:"57c1e1f4",14188:"030cce6e",14243:"e3763bcb",14710:"f3c09649",15114:"a0cebd68",15365:"45578418",15772:"d1e773f2",15975:"27374c8d",16021:"264ad229",16039:"38a142bf",16052:"dbdda7e2",16175:"12751b0b",16649:"91482eba",16950:"5d956fb9",16991:"82fcf322",17175:"d885a1cf",17217:"7e67cf71",17277:"97db1a5c",17446:"89ee35f9",17661:"0f5a68ec",17882:"97bd30d2",17929:"e95d3f51",18350:"af482d40",18387:"ecdb23e9",18471:"e7dc7dc4",18610:"8a8f909a",18894:"2da9821d",19219:"8a00ddc5",19396:"e4d6fd46",19423:"6a27f650",20202:"2a93bb92",20367:"e00fbdaa",21413:"0a7dfec7",21493:"7363f840",22043:"ee188a85",22190:"51ace0d8",22465:"f149b9ad",22620:"1e0d15a3",22761:"365a347a",22821:"5ff384bd",22982:"7827ecbf",23105:"696a8879",23198:"5687d4c2",23349:"c40a6a59",23389:"f05fa93a",23563:"143e8437",23733:"3abb3db5",23891:"142c057e",24669:"e5147b47",24697:"c8162876",24698:"cafbaf96",24947:"615bfb87",25090:"a928e25d",25370:"6a7b305e",25382:"e77243fd",25760:"4b393b11",25817:"a09a6bc8",25968:"8988001f",26158:"25c83335",26467:"a246bca1",26560:"d5cc94c4",27e3:"76b5d8af",27078:"d33f03f0",27079:"b7725e8c",27133:"242a66cb",27188:"6e60fd6f",28135:"68b3b465",28268:"c2ebb553",28271:"798bcbda",28429:"1399b650",28751:"a3f317d7",28800:"b7ae44b4",29010:"c946c638",29140:"7afbbfab",29513:"760b6e5b",29514:"e4bcc747",29538:"8ebe6590",29681:"027863ff",29728:"651a8f72",29776:"49e857bf",30321:"ebeac310",30561:"039f452c",30601:"6cd65da7",30708:"4fc498e6",30717:"467f93e7",31287:"54c4de8f",31404:"81c31d94",31538:"f7fbf7d0",31626:"86039d8a",31640:"59558e17",31657:"b4731330",31833:"b2b7fa8e",31854:"11dd85d1",32074:"cfa3f3e9",32446:"0337a8ff",32854:"ddf29eef",33034:"784e6a16",33232:"2f974a7f",33263:"e9a2bf67",33404:"a71820ed",33431:"52e788b4",33451:"7ae801f2",33509:"8d723cab",33790:"d0c835a8",33887:"9eb42a33",33912:"5a8cbc49",34204:"94a1db98",34346:"0df99d03",34533:"cfa02200",34756:"44c0f5f9",34826:"d052436e",34980:"cb37b898",35226:"c1a6f8ac",35330:"0efdba7e",35424:"a0ae2d81",35708:"3302f660",35943:"ef743e8d",36206:"d0188849",36586:"3412dbbe",36904:"692a4593",37442:"855253b6",37486:"30e1048f",37487:"77385b9d",37742:"6df71594",38145:"ba3bdceb",38270:"47996dae",38461:"9e4da240",38499:"e68b2541",38527:"b8282fa0",38601:"2994690a",39066:"240b9b15",39220:"fa15e92c",39229:"d4fc6f4b",39494:"7fd53958",39626:"87b8e7f0",40541:"ff5ab4f6",40701:"4fca1903",40916:"9faa28b3",41003:"c513ea13",41150:"54f1938d",41650:"87e23358",41916:"a563cbc0",41957:"872fd2cc",42008:"4baa50ab",42070:"bbe5918a",42124:"c3f15a6b",42181:"c63517e6",42355:"a6103dd9",42573:"5923682b",42885:"707968a0",42954:"982828f1",43600:"a6c32670",43777:"4e0bdea2",43819:"f4f44adf",44209:"28c163b6",44484:"f64995ae",44497:"5a4e81f9",44588:"bf959556",44685:"608ba60a",44758:"2647b91d",44962:"8ee523a8",45044:"319d5a87",45350:"fd8b516f",45841:"3cda1b69",45843:"bcf9d914",45960:"7978ebf9",46294:"1c2833b0",46581:"d63d089d",46945:"11021670",47234:"2d89e5c0",47328:"494e9e64",47422:"8ce35e9c",47615:"2c0ce109",47629:"72d9f63d",47834:"a88f922d",48343:"b7f71889",48733:"59d26878",48890:"adb90665",48954:"ba099550",49157:"c5ceae49",49346:"f771bb40",49486:"08093aae",49549:"e9848ed5",49567:"92eb0037",49871:"e1429d77",49907:"47cabb35",50561:"77dfad07",51435:"99a83279",51537:"e2d07b22",51613:"0517bb7c",51618:"c7cef798",51953:"f98dbc91",52021:"8d7b0aff",52486:"199db7e6",52631:"18e460be",52745:"12ccc982",53068:"a8a7c89a",53302:"bf64e0b6",53587:"1fb9decf",53609:"a92abd6d",53685:"1f4e0d5f",53861:"3082678d",54487:"ad59b2d4",54709:"e849da75",54736:"5ad4aad6",54749:"392dc4ca",55035:"98dbe40d",55260:"5d41948f",55480:"269d4a93",55841:"96391cd4",55945:"1e6fe5d2",56025:"a3c35d87",56248:"0b9a9c44",56364:"d1082acc",56370:"463c9fd5",56419:"49bee624",56615:"6af21355",56963:"98579cc6",56979:"a3e32621",57103:"7ae80bb8",57287:"c717609b",57361:"9e1a42d7",57573:"d981bab5",58424:"559534ac",58729:"d9e7d269",59131:"6321bc6c",59213:"d5789a20",59273:"de1b77b0",59728:"6474cfc6",59856:"05158744",59865:"5e11a3f2",60439:"933bd6f9",60946:"4cb32984",60974:"97c72ade",61304:"b5145ede",61928:"7e1d334f",61931:"7f952791",62062:"353aded2",62536:"0e9efbf3",62726:"a4cb7dcf",62781:"e0de6259",62954:"9962cb52",63119:"bd396e75",63157:"fb4e705c",63453:"404737d0",64131:"9dd0ebf3",64195:"07350901",64302:"b378118d",64549:"29ef3ede",64807:"012554aa",64841:"2185b4d7",65064:"8e325daa",65135:"e398eaec",65368:"a9c66679",65369:"d5e7d0d4",65649:"b62f9c6f",65787:"0bdb95a3",65858:"4c869c9e",65882:"f0e68a30",65954:"ec720aed",65957:"fee0bf24",66073:"44a91d45",66334:"501cd9fc",67140:"c47f094f",67365:"bcaab239",67396:"2292c9b1",67673:"bae0b73d",67744:"157c94a2",67813:"e6d17ef0",67818:"babc89ec",67995:"2b2b3914",68026:"15fd8f87",68122:"7e850de8",68189:"974dced1",68224:"4795aaa2",68265:"63ef79da",68349:"079b6e78",68436:"499df18c",68618:"629b88a8",68724:"bd00f8e9",68755:"ff5fc04a",68960:"c8fcea47",69043:"5b3372ec",69345:"a9a29a15",69360:"b0ad318b",69413:"4eb3fec6",69905:"b7945067",69998:"969e656d",70207:"407299fe",70421:"36abd26a",70520:"8c0695df",70611:"32ff9875",70633:"85e93002",70838:"f11d1f21",71147:"157ba2f9",71253:"a6bc6c99",71360:"f03023e7",71386:"f3348c48",71525:"a6ed29d8",71670:"d2e6e43a",71723:"4709da61",71814:"56dd82a2",72371:"a3c669a6",72464:"2f3537e5",72474:"773f920d",72556:"b4ea6c17",72939:"3a3441fd",73088:"98f34523",73555:"983f0e56",73634:"17860f4d",74010:"9eb2cd2e",74123:"ea47ea58",74190:"05e92f95",74199:"2aa5f99d",74298:"a6a915f6",74318:"ad46b4b0",74400:"78ed677d",74904:"9e1e08a1",75034:"bdf96616",75062:"ee60c5b9",75063:"579d8500",75212:"cdafcb6e",75248:"c64c9475",75384:"ffa1d26f",75478:"3ee066fd",75647:"c79bb3a9",76413:"3c778b15",76559:"718e9bd1",76780:"a2521cf6",76907:"e13d00cb",77183:"c0ad547e",77184:"5344e158",77769:"b98f4bd0",77771:"d3e7506f",77787:"ec5cef53",78023:"f1b2fc67",78297:"e4f53ff6",78301:"77cdbff5",78382:"76c0d111",78494:"05fed9af",78560:"ecc9e3d8",78880:"ba3defe8",78897:"8b852a89",79022:"887e7198",79376:"a35faf3e",79527:"bd63dac4",79639:"16f4f0ae",79796:"3a32726b",80053:"f3a6bfb6",80371:"23ddacc4",80536:"6f369947",80693:"e6026f56",80802:"240a9b32",80954:"eb30c055",81355:"c0630deb",81832:"2e7dde30",81981:"b924f531",82251:"f49cb2c9",82591:"a17d8a02",82946:"7aa5038a",83e3:"195954f3",83443:"74b93655",83540:"e709cdec",83667:"e6c21a7a",83771:"0981c21d",83882:"1cba5326",83922:"b74510b1",84453:"a175f0b0",84683:"aa837944",85015:"6922a556",85064:"8f791a22",85185:"31a48b3e",85228:"218217bc",85694:"ab54dd1a",85897:"736db16a",85953:"eeb2a562",86072:"5080c454",86098:"dd1b5cbc",86181:"fbf80418",86401:"223755ab",86455:"d22696db",86764:"21660651",86948:"a6813667",87074:"914e646e",87306:"038baecb",87414:"a1d1b84b",87582:"d8c159ba",87593:"b5b5099f",87655:"e65ff3fe",88115:"b037e7eb",88184:"4d0515ff",89101:"df7e2695",89645:"1108f5d1",89987:"9ce9ed67",90206:"4fe580ee",90558:"64e938f3",90888:"2be72233",91172:"4f311445",91218:"6553173b",91250:"ac023bc8",91919:"6b6753c6",92546:"438b2f58",92903:"84ca9238",93337:"c3f50868",93387:"09b65a76",93519:"80c34a74",93546:"8c92d65e",93610:"97e39690",93822:"abc403e4",93903:"8c75acce",94018:"b831695c",94089:"96e09e44",94091:"85ea2c44",94194:"4c05d3ad",94229:"39be4c83",94319:"f653c4f9",94708:"c292e4a2",94722:"974775bd",94900:"3959d337",94907:"9ea3a473",95034:"36eef0a9",95188:"d5c0ca2e",95461:"f5c04beb",95690:"fffc088f",96276:"7dc68782",96374:"132c5041",97482:"f5466d75",97889:"abe5362e",97920:"d5457aa2",98016:"75b6d8f9",98276:"2904fbe2",98444:"ea450473",98509:"97e0d0cb",98623:"65824ddc",98630:"a1951a5d",98666:"ef80b98e",98692:"74506fb9",99074:"a1d05c43",99156:"64490ce3",99235:"b6625b1f",99350:"d2165e86",99438:"d621c348",99875:"14b35e8a",99889:"c23c19b6",99959:"03d89ae8"}[e]+".js",t.miniCssF=e=>{},t.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),t.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),c={},f="docusaurus-docs:",t.l=(e,a,b,d)=>{if(c[e])c[e].push(a);else{var r,o;if(void 0!==b)for(var n=document.getElementsByTagName("script"),i=0;i{r.onerror=r.onload=null,clearTimeout(l);var f=c[e];if(delete c[e],r.parentNode&&r.parentNode.removeChild(r),f&&f.forEach((e=>e(b))),a)return a(b)},l=setTimeout(s.bind(null,void 0,{type:"timeout",target:r}),12e4);r.onerror=s.bind(null,r.onerror),r.onload=s.bind(null,r.onload),o&&document.head.appendChild(r)}},t.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.nmd=e=>(e.paths=[],e.children||(e.children=[]),e),t.p="/docs/zh-TW/",t.gca=function(e){return e={20358428:"79527",26183636:"86072",38784009:"8156",68556356:"70207",68843839:"52745",73567145:"53587",79022373:"21493",a2a78cd2:"16","5df371ad":"17","575a2139":"288","4ef5f34b":"482",fb1a77b4:"520","3365bb5d":"547",bc8f9087:"930","3ef25e43":"1045",ecc882d7:"1288","1ff2c95d":"1325","2be8d75a":"1369","8f25d185":"1764","4c5e977b":"1893",f54e89d1:"2050","8ba34e88":"2201","0c82f1cb":"2222",a596dc7e:"2269","652aa3bb":"2281",b7b09b70:"2487",faa6790b:"2751","655c39d2":"3300","2425c15c":"3507","3e441ee4":"3909","78ec6490":"4086","93a1b6a2":"4746","1bcb7f60":"5253","1f54c2ac":"6147",e628edd4:"6352",af2c52ce:"6542",e2cf295d:"6729","5ea9e4ca":"7415",b760913b:"7848","136658e4":"8179","9755f20c":"8214","8d4600d0":"8392","401fb871":"8478","6860968b":"8883","0002f649":"9642","2eca92d8":"9706","14eb3368":"9817",d5ac6535:"9862",f62a7bc0:"9904","954c355d":"10040",a7d19085:"10235",fa570740:"10293",b71c170b:"10471",e8acd80e:"11013","7205acf7":"11053","7c3d9323":"11120","99aca8b2":"11434",d68165b9:"11500","5016f915":"11606",f34bbf22:"11968",ee2d7736:"12920",a4a7c88e:"12944","97600ac6":"13055","1f391b9e":"13085",fdf22a50:"13408",c668d467:"13586",bf60373a:"13667","643f775f":"13874","2d0f081e":"13959",c5d3bb95:"14030","035fc0a7":"14188","0744e06b":"14243","2492320d":"14710",ee7f03d8:"15114",b82d00b2:"15365",b568538e:"15772","1bab1317":"15975",a42811bf:"16021","4e6201a8":"16039","8aab06bf":"16052","567ff302":"16175",a19cf377:"16649",b43e4353:"16950","3f53f1c4":"16991",c4f64aee:"17175","4ef1736a":"17217","72ceeaac":"17277",eaca4732:"17446","265355c2":"17661",e88bed7b:"17882",d56e3bd7:"17929","0f2e9443":"18350","2be7eaec":"18387","2bfafb22":"18471",c5a9135f:"18610",f2bfa581:"19219","9f35e670":"19396","1912069b":"19423","1e049e66":"20202","05a3c259":"20367","6dfd8a52":"21413","269c0fa1":"22043","89f7284f":"22190","1955e4c9":"22465",cf587678:"22620",dac58f9a:"22821",f041af6f:"22982","6ac88df6":"23105","15df18f8":"23198","5b6fa4ec":"23349","9041aea1":"23389","935cb8db":"23563",b82293b3:"23733","642b1006":"23891",f552bd00:"24669",c54eca7f:"24697","92e11b3f":"24698",e9b84ed8:"24947","87897be6":"25090",af4a2ad4:"25370","632d2515":"25382","31e78686":"25760","7988f281":"25817","156751cf":"25968",d2de2978:"26158","302d24dc":"26467","5b788f5c":"26560","3326e4c4":"27000",d7ac3c03:"27078","49a0e813":"27079","92e99bf6":"27133","5036ec9d":"27188","89179ad6":"28135",b8161d6a:"28268",f7eb3a66:"28271",b052b80c:"28429",e31a16ba:"28751","1dbaa503":"28800","8c2621f5":"29010","1d8ede30":"29140","0ac7fcd1":"29513","1be78505":"29514","4c950052":"29538","4d96b439":"29681","38c90751":"29728","5dab34b6":"29776","751792b8":"30321",bc670d5c:"30561",e5d84bc0:"30601","124f7953":"30708",ecdb20a1:"30717",b2d0af62:"31287","3e301362":"31404","19b883ea":"31538","3394f7b8":"31626","4f7dcb1e":"31640","8fbaa47b":"31657","86fd2478":"31833",b45ff73d:"31854","13063a10":"32074","6870c8c4":"32446","6c46dea8":"32854","41ed4202":"33034","6131b9f8":"33232","005fee41":"33263",afdda5b6:"33404",e35d3956:"33431",f5b6c895:"33451","786f71e5":"33509",c423df2e:"33790","10ca1dd8":"33887","1bc94aef":"33912","269acb60":"34204","1db637b2":"34346","3abccbcc":"34533","9c643b6e":"34756","70e3a7c5":"34826",ea7cec67:"34980",e7958aaa:"35226",eadead04:"35330","3635a766":"35424","41eb0037":"35708",bc53881b:"35943","90c3ec62":"36206","8c3021dd":"36586",e71641ea:"36904",f6ef3039:"37442",dcc6b54d:"37486",a9bf2227:"37487","969753d7":"37742","28e7e1e3":"38145","5393ce94":"38270","917300a3":"38461",a88f137d:"38499","4f9fd89c":"38527",f7242226:"38601",a4a7a840:"39066","7114ac56":"39220","429a6f3e":"39229","01804294":"39494",fd867f7c:"39626","816b2b7d":"40541","1ce0a301":"40701",e4459066:"40916",d0d62bb5:"41003",fe26f94f:"41150",c7707dd8:"41650","2a38ab5e":"41916",d69803c7:"41957","9e43e7b6":"42008","7cb4903f":"42070","19357a65":"42124",be510d4c:"42181","2f504c6e":"42355",ce346131:"42573",acdbee8e:"42885","2814cf01":"42954","1dcc65e0":"43600",b9aefb1a:"43777",fc1db29b:"43819","278665dc":"44209","3cd952ae":"44484",d32e6b20:"44497","3c5750f8":"44588",f5c87087:"44685","0a13a0e4":"44758","1c5f7d2b":"44962","17abfa8d":"45044",e8c60e9b:"45350","0c0bbaea":"45841",e4bacbbb:"45843","5b3c1c53":"45960",db229a81:"46294",c2d91591:"46581",ae346411:"47234","6daf901a":"47328","1cf37028":"47422","84ebbbbf":"47615","0cd0cfa8":"47629","09be2ba2":"47834","2c056d5d":"48343",d21505c8:"48733",d5603669:"48890",b0bdb7f3:"48954","9de65041":"49157",b8919bdb:"49346",e72cf26a:"49486","48e0b5d4":"49549",f0cf672d:"49567",b2f83e6d:"49871",f2e41396:"49907","254ac25b":"50561",fe2b089e:"51435","431ad29b":"51537","27b935de":"51613","2cbe9533":"51618",c3e83a7d:"51953","25b6fab0":"52021",de127d6b:"52486",c46f1db0:"52631",c3d815ae:"53068",cb8de75d:"53302","81be975d":"53609","8c00b41d":"53685","3e96b4b5":"53861","5ebc7423":"54487","2b93221c":"54709",a5463d8a:"54736",bf25430f:"54749",ea64ac1c:"55035","9e4d6f26":"55260","006095b2":"55480",a67bdd24:"55841","79aa13fb":"55945",c3aed80f:"56025","8a1c8da1":"56248","281b126c":"56364","36f93d19":"56370","80e8986a":"56419",b4f4317d:"56615","1b80e345":"56963",d005934a:"56979","77d0fddc":"57103",bde9fb45:"57287","3e26f8b3":"57361",e3e4fe7d:"57573","03edb22c":"58424",dbbfa97d:"58729","3b0223df":"59131",f6bb9d12:"59213",fcae69e8:"59273",aa5bd2a7:"59728",e5c88a3e:"59856",e8ee0390:"59865",fca48710:"60439",bb292d37:"60946","11314fda":"60974","8d5fe6f9":"61304","15113e52":"61928","4c21dbbd":"61931","988ba51e":"62062","431b5d0e":"62536","748490a7":"62726","703f575d":"62781","90305fb4":"62954",d7567838:"63119","586e3f5e":"63157","37da3438":"63453","52c1dace":"64131",c4f5d8e4:"64195","05c5421d":"64302","788d9fe0":"64549","8a495097":"64807",b49164a1:"64841","4840c3eb":"65064","789f108c":"65135",cc468388:"65368",c15b67f7:"65369","8047f3a3":"65649",c4ae09d4:"65787","1290c878":"65858","6aa5826c":"65882",b9776525:"65954",e4627c87:"65957","97b92a45":"66073","3c39ccf9":"66334",e8b2d68f:"67140","18f77871":"67365",a9dd1cc8:"67396","6eb57332":"67673","6ca8826f":"67744","8894256f":"67813",baa3212e:"67818",ff2d6dd8:"67995",e63b451d:"68026",db9559d3:"68122","26e12baa":"68189","78bca219":"68224","389bb65e":"68265","3d3a07f6":"68349","68408d35":"68436","88e3fe7e":"68618",a79a2e70:"68755","03cc88eb":"68960","9ad8637e":"69043","01a16f71":"69345","98a6b9c4":"69360","71063c2b":"69413",e23eefc0:"69905",b7cfb3da:"69998",a934672d:"70421",e2df322b:"70520",fa114b0c:"70611",b50c9021:"70633","22bdf908":"70838","1a99b1ee":"71147","970a27d6":"71253","17b00a4a":"71360",b1892b20:"71386","3b7cd1e1":"71525","6d8024b7":"71670","0328b0c9":"71723","47c64002":"72371","8b8c4320":"72464",f9e1fd09:"72474","5614add0":"72556",a626e327:"72939","955e06fd":"73088","3627f230":"73555",e0bec19d:"73634","37cea19d":"74010",a8654aa2:"74123","84cf2087":"74190","67db246e":"74199","48db5030":"74298",b8d9b1bd:"74318",aacc2fee:"74400",c0ad5dc6:"74904","30a22249":"75034",add4d791:"75062",cf69f832:"75063","19b0499c":"75212",e82ff315:"75248","42bb1101":"75384","200e51df":"75478","2b3e7a7f":"75647","777bd32a":"76413","93b78259":"76559",a208e2a5:"76907",a94c7dba:"77183","11b4dd89":"77184","60ea2d86":"77769","56a38f24":"77771","53bd4095":"77787","2b20c80a":"78023","71051dda":"78297","676afd3b":"78301","1a77ceda":"78382",e49348be:"78494",fd37922c:"78560","44befa6d":"78880","8a942fcc":"78897","9beaa53d":"79022","6249c7de":"79376","7cd86536":"79639",d2c4b928:"79796","935f2afb":"80053",c038b4a2:"80371","17c91901":"80536",cfc8b1e5:"80693","48d397c0":"80802",db449848:"80954","9ad476bb":"81355",a8e44541:"81832",c8450cf2:"81981","989904ef":"82251",de89bf85:"82591","3b83c135":"82946",cc7f3e03:"83000",f47c1d11:"83443","6500be67":"83540",ab4a8e8f:"83667","8c02dfd8":"83771","3a4337ef":"83882",cc806444:"83922",fc15d889:"84453","25b7eef7":"84683",f21b2fb0:"85015",d02b76f9:"85064",e1b9cf16:"85185","2fcb69bb":"85228",db0d392c:"85694","6b3775fc":"85897",b700f6c8:"85953","149e5a51":"86098",a01bbcd4:"86181",fed0304a:"86401",e8c8f122:"86455",d8958d75:"86764",af7ab695:"86948","6268d0ca":"87074",aebe3827:"87306","393be207":"87414","7fc0684b":"87582","50219e10":"87593","40230f21":"87655",d0e9a494:"88115","87f76dec":"88184",e2c0c813:"89101",e760b063:"89645","9ccbc3bf":"89987","4a9b1fdb":"90206","93f8b8b5":"90558","5c18dc43":"90888","864138a2":"91172","29cd8cc9":"91218","8758e270":"91250",d51ffe49:"91919",cc24cbe6:"92546","84ee34f2":"92903",bef6aaf2:"93337","007a6c32":"93387","6f951ae3":"93519","1010372b":"93546",caba9b9f:"93610","7d52489f":"93822","5610cdb3":"93903","046df3c9":"94018",d9ffe17e:"94089","5c128c28":"94091","4b3e38af":"94194",c8a044ba:"94229",d0816b53:"94319","23cc9db4":"94708","5282f1c8":"94722","5787f6d3":"94900","29f28a73":"94907","64be7568":"95034",b42420f8:"95188","308641fb":"95461",f4bc196f:"95690","8aadacf1":"96276","6135d371":"96374","4a3e680b":"97482","02193fc8":"97889","1a4e3797":"97920",ffb2e417:"98016","2205312d":"98276",cc9c20e3:"98444","92ac5c16":"98509","394c74c3":"98623","68e9a632":"98630",f64e920b:"98666","67044a7a":"98692",e8646b2e:"99074",ff6e33f8:"99156",fe793f9f:"99235","196bfd5c":"99350",b5511831:"99438","57d9a11e":"99875",f56b8973:"99889",ebec70a2:"99959"}[e]||e,t.p+t.u(e)},(()=>{var e={51303:0,40532:0};t.f.j=(a,b)=>{var c=t.o(e,a)?e[a]:void 0;if(0!==c)if(c)b.push(c[2]);else if(/^(40532|51303)$/.test(a))e[a]=0;else{var f=new Promise(((b,f)=>c=e[a]=[b,f]));b.push(c[2]=f);var d=t.p+t.u(a),r=new Error;t.l(d,(b=>{if(t.o(e,a)&&(0!==(c=e[a])&&(e[a]=void 0),c)){var f=b&&("load"===b.type?"missing":b.type),d=b&&b.target&&b.target.src;r.message="Loading chunk "+a+" failed.\n("+f+": "+d+")",r.name="ChunkLoadError",r.type=f,r.request=d,c[1](r)}}),"chunk-"+a,a)}},t.O.j=a=>0===e[a];var a=(a,b)=>{var c,f,d=b[0],r=b[1],o=b[2],n=0;if(d.some((a=>0!==e[a]))){for(c in r)t.o(r,c)&&(t.m[c]=r[c]);if(o)var i=o(t)}for(a&&a(b);n{"use strict";var e,b,a,c,f,d={},r={};function t(e){var b=r[e];if(void 0!==b)return b.exports;var a=r[e]={id:e,loaded:!1,exports:{}};return d[e].call(a.exports,a,a.exports,t),a.loaded=!0,a.exports}t.m=d,e=[],t.O=(b,a,c,f)=>{if(!a){var d=1/0;for(i=0;i=f)&&Object.keys(t.O).every((e=>t.O[e](a[o])))?a.splice(o--,1):(r=!1,f0&&e[i-1][2]>f;i--)e[i]=e[i-1];e[i]=[a,c,f]},t.n=e=>{var b=e&&e.__esModule?()=>e.default:()=>e;return t.d(b,{a:b}),b},a=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,t.t=function(e,c){if(1&c&&(e=this(e)),8&c)return e;if("object"==typeof e&&e){if(4&c&&e.__esModule)return e;if(16&c&&"function"==typeof e.then)return e}var f=Object.create(null);t.r(f);var d={};b=b||[null,a({}),a([]),a(a)];for(var r=2&c&&e;"object"==typeof r&&!~b.indexOf(r);r=a(r))Object.getOwnPropertyNames(r).forEach((b=>d[b]=()=>e[b]));return d.default=()=>e,t.d(f,d),f},t.d=(e,b)=>{for(var a in b)t.o(b,a)&&!t.o(e,a)&&Object.defineProperty(e,a,{enumerable:!0,get:b[a]})},t.f={},t.e=e=>Promise.all(Object.keys(t.f).reduce(((b,a)=>(t.f[a](e,b),b)),[])),t.u=e=>"assets/js/"+({16:"a2a78cd2",17:"5df371ad",288:"575a2139",482:"4ef5f34b",520:"fb1a77b4",547:"3365bb5d",930:"bc8f9087",1045:"3ef25e43",1288:"ecc882d7",1325:"1ff2c95d",1369:"2be8d75a",1764:"8f25d185",1893:"4c5e977b",2050:"f54e89d1",2201:"8ba34e88",2222:"0c82f1cb",2269:"a596dc7e",2281:"652aa3bb",2487:"b7b09b70",2751:"faa6790b",3300:"655c39d2",3507:"2425c15c",3909:"3e441ee4",4086:"78ec6490",4746:"93a1b6a2",5253:"1bcb7f60",6147:"1f54c2ac",6352:"e628edd4",6542:"af2c52ce",6729:"e2cf295d",7415:"5ea9e4ca",7848:"b760913b",8156:"38784009",8179:"136658e4",8214:"9755f20c",8392:"8d4600d0",8478:"401fb871",8883:"6860968b",9642:"0002f649",9706:"2eca92d8",9817:"14eb3368",9862:"d5ac6535",9904:"f62a7bc0",10040:"954c355d",10235:"a7d19085",10293:"fa570740",10471:"b71c170b",11013:"e8acd80e",11053:"7205acf7",11120:"7c3d9323",11434:"99aca8b2",11500:"d68165b9",11606:"5016f915",11968:"f34bbf22",12920:"ee2d7736",12944:"a4a7c88e",13055:"97600ac6",13085:"1f391b9e",13408:"fdf22a50",13586:"c668d467",13667:"bf60373a",13874:"643f775f",13959:"2d0f081e",14030:"c5d3bb95",14188:"035fc0a7",14243:"0744e06b",14710:"2492320d",15114:"ee7f03d8",15365:"b82d00b2",15772:"b568538e",15975:"1bab1317",16021:"a42811bf",16039:"4e6201a8",16052:"8aab06bf",16175:"567ff302",16649:"a19cf377",16950:"b43e4353",16991:"3f53f1c4",17175:"c4f64aee",17217:"4ef1736a",17277:"72ceeaac",17446:"eaca4732",17661:"265355c2",17882:"e88bed7b",17929:"d56e3bd7",18350:"0f2e9443",18387:"2be7eaec",18471:"2bfafb22",18610:"c5a9135f",19219:"f2bfa581",19396:"9f35e670",19423:"1912069b",20202:"1e049e66",20367:"05a3c259",21413:"6dfd8a52",21493:"79022373",22043:"269c0fa1",22190:"89f7284f",22465:"1955e4c9",22620:"cf587678",22821:"dac58f9a",22982:"f041af6f",23105:"6ac88df6",23198:"15df18f8",23349:"5b6fa4ec",23389:"9041aea1",23563:"935cb8db",23733:"b82293b3",23891:"642b1006",24669:"f552bd00",24697:"c54eca7f",24698:"92e11b3f",24947:"e9b84ed8",25090:"87897be6",25370:"af4a2ad4",25382:"632d2515",25760:"31e78686",25817:"7988f281",25968:"156751cf",26158:"d2de2978",26467:"302d24dc",26560:"5b788f5c",27e3:"3326e4c4",27078:"d7ac3c03",27079:"49a0e813",27133:"92e99bf6",27188:"5036ec9d",28135:"89179ad6",28268:"b8161d6a",28271:"f7eb3a66",28429:"b052b80c",28751:"e31a16ba",28800:"1dbaa503",29010:"8c2621f5",29140:"1d8ede30",29513:"0ac7fcd1",29514:"1be78505",29538:"4c950052",29681:"4d96b439",29728:"38c90751",29776:"5dab34b6",30321:"751792b8",30561:"bc670d5c",30601:"e5d84bc0",30708:"124f7953",30717:"ecdb20a1",31287:"b2d0af62",31404:"3e301362",31538:"19b883ea",31626:"3394f7b8",31640:"4f7dcb1e",31657:"8fbaa47b",31833:"86fd2478",31854:"b45ff73d",32074:"13063a10",32446:"6870c8c4",32854:"6c46dea8",33034:"41ed4202",33232:"6131b9f8",33263:"005fee41",33404:"afdda5b6",33431:"e35d3956",33451:"f5b6c895",33509:"786f71e5",33790:"c423df2e",33887:"10ca1dd8",33912:"1bc94aef",34204:"269acb60",34346:"1db637b2",34533:"3abccbcc",34756:"9c643b6e",34826:"70e3a7c5",34980:"ea7cec67",35226:"e7958aaa",35330:"eadead04",35424:"3635a766",35708:"41eb0037",35943:"bc53881b",36206:"90c3ec62",36586:"8c3021dd",36904:"e71641ea",37442:"f6ef3039",37486:"dcc6b54d",37487:"a9bf2227",37742:"969753d7",38145:"28e7e1e3",38270:"5393ce94",38461:"917300a3",38499:"a88f137d",38527:"4f9fd89c",38601:"f7242226",39066:"a4a7a840",39220:"7114ac56",39229:"429a6f3e",39494:"01804294",39626:"fd867f7c",40541:"816b2b7d",40701:"1ce0a301",40916:"e4459066",41003:"d0d62bb5",41150:"fe26f94f",41650:"c7707dd8",41916:"2a38ab5e",41957:"d69803c7",42008:"9e43e7b6",42070:"7cb4903f",42124:"19357a65",42181:"be510d4c",42355:"2f504c6e",42573:"ce346131",42885:"acdbee8e",42954:"2814cf01",43600:"1dcc65e0",43777:"b9aefb1a",43819:"fc1db29b",44209:"278665dc",44484:"3cd952ae",44497:"d32e6b20",44588:"3c5750f8",44685:"f5c87087",44758:"0a13a0e4",44962:"1c5f7d2b",45044:"17abfa8d",45350:"e8c60e9b",45841:"0c0bbaea",45843:"e4bacbbb",45960:"5b3c1c53",46294:"db229a81",46581:"c2d91591",47234:"ae346411",47328:"6daf901a",47422:"1cf37028",47615:"84ebbbbf",47629:"0cd0cfa8",47834:"09be2ba2",48343:"2c056d5d",48733:"d21505c8",48890:"d5603669",48954:"b0bdb7f3",49157:"9de65041",49346:"b8919bdb",49486:"e72cf26a",49549:"48e0b5d4",49567:"f0cf672d",49871:"b2f83e6d",49907:"f2e41396",50561:"254ac25b",51435:"fe2b089e",51537:"431ad29b",51613:"27b935de",51618:"2cbe9533",51953:"c3e83a7d",52021:"25b6fab0",52486:"de127d6b",52631:"c46f1db0",52745:"68843839",53068:"c3d815ae",53302:"cb8de75d",53587:"73567145",53609:"81be975d",53685:"8c00b41d",53861:"3e96b4b5",54487:"5ebc7423",54709:"2b93221c",54736:"a5463d8a",54749:"bf25430f",55035:"ea64ac1c",55260:"9e4d6f26",55480:"006095b2",55841:"a67bdd24",55945:"79aa13fb",56025:"c3aed80f",56248:"8a1c8da1",56364:"281b126c",56370:"36f93d19",56419:"80e8986a",56615:"b4f4317d",56963:"1b80e345",56979:"d005934a",57103:"77d0fddc",57287:"bde9fb45",57361:"3e26f8b3",57573:"e3e4fe7d",58424:"03edb22c",58729:"dbbfa97d",59131:"3b0223df",59213:"f6bb9d12",59273:"fcae69e8",59728:"aa5bd2a7",59856:"e5c88a3e",59865:"e8ee0390",60439:"fca48710",60946:"bb292d37",60974:"11314fda",61304:"8d5fe6f9",61928:"15113e52",61931:"4c21dbbd",62062:"988ba51e",62536:"431b5d0e",62726:"748490a7",62781:"703f575d",62954:"90305fb4",63119:"d7567838",63157:"586e3f5e",63453:"37da3438",64131:"52c1dace",64195:"c4f5d8e4",64302:"05c5421d",64549:"788d9fe0",64807:"8a495097",64841:"b49164a1",65064:"4840c3eb",65135:"789f108c",65368:"cc468388",65369:"c15b67f7",65649:"8047f3a3",65787:"c4ae09d4",65858:"1290c878",65882:"6aa5826c",65954:"b9776525",65957:"e4627c87",66073:"97b92a45",66334:"3c39ccf9",67140:"e8b2d68f",67365:"18f77871",67396:"a9dd1cc8",67673:"6eb57332",67744:"6ca8826f",67813:"8894256f",67818:"baa3212e",67995:"ff2d6dd8",68026:"e63b451d",68122:"db9559d3",68189:"26e12baa",68224:"78bca219",68265:"389bb65e",68349:"3d3a07f6",68436:"68408d35",68618:"88e3fe7e",68755:"a79a2e70",68960:"03cc88eb",69043:"9ad8637e",69345:"01a16f71",69360:"98a6b9c4",69413:"71063c2b",69905:"e23eefc0",69998:"b7cfb3da",70207:"68556356",70421:"a934672d",70520:"e2df322b",70611:"fa114b0c",70633:"b50c9021",70838:"22bdf908",71147:"1a99b1ee",71253:"970a27d6",71360:"17b00a4a",71386:"b1892b20",71525:"3b7cd1e1",71670:"6d8024b7",71723:"0328b0c9",72371:"47c64002",72464:"8b8c4320",72474:"f9e1fd09",72556:"5614add0",72939:"a626e327",73088:"955e06fd",73555:"3627f230",73634:"e0bec19d",74010:"37cea19d",74123:"a8654aa2",74190:"84cf2087",74199:"67db246e",74298:"48db5030",74318:"b8d9b1bd",74400:"aacc2fee",74904:"c0ad5dc6",75034:"30a22249",75062:"add4d791",75063:"cf69f832",75212:"19b0499c",75248:"e82ff315",75384:"42bb1101",75478:"200e51df",75647:"2b3e7a7f",76413:"777bd32a",76559:"93b78259",76907:"a208e2a5",77183:"a94c7dba",77184:"11b4dd89",77769:"60ea2d86",77771:"56a38f24",77787:"53bd4095",78023:"2b20c80a",78297:"71051dda",78301:"676afd3b",78382:"1a77ceda",78494:"e49348be",78560:"fd37922c",78880:"44befa6d",78897:"8a942fcc",79022:"9beaa53d",79376:"6249c7de",79527:"20358428",79639:"7cd86536",79796:"d2c4b928",80053:"935f2afb",80371:"c038b4a2",80536:"17c91901",80693:"cfc8b1e5",80802:"48d397c0",80954:"db449848",81355:"9ad476bb",81832:"a8e44541",81981:"c8450cf2",82251:"989904ef",82591:"de89bf85",82946:"3b83c135",83e3:"cc7f3e03",83443:"f47c1d11",83540:"6500be67",83667:"ab4a8e8f",83771:"8c02dfd8",83882:"3a4337ef",83922:"cc806444",84453:"fc15d889",84683:"25b7eef7",85015:"f21b2fb0",85064:"d02b76f9",85185:"e1b9cf16",85228:"2fcb69bb",85694:"db0d392c",85897:"6b3775fc",85953:"b700f6c8",86072:"26183636",86098:"149e5a51",86181:"a01bbcd4",86401:"fed0304a",86455:"e8c8f122",86764:"d8958d75",86948:"af7ab695",87074:"6268d0ca",87306:"aebe3827",87414:"393be207",87582:"7fc0684b",87593:"50219e10",87655:"40230f21",88115:"d0e9a494",88184:"87f76dec",89101:"e2c0c813",89645:"e760b063",89987:"9ccbc3bf",90206:"4a9b1fdb",90558:"93f8b8b5",90888:"5c18dc43",91172:"864138a2",91218:"29cd8cc9",91250:"8758e270",91919:"d51ffe49",92546:"cc24cbe6",92903:"84ee34f2",93337:"bef6aaf2",93387:"007a6c32",93519:"6f951ae3",93546:"1010372b",93610:"caba9b9f",93822:"7d52489f",93903:"5610cdb3",94018:"046df3c9",94089:"d9ffe17e",94091:"5c128c28",94194:"4b3e38af",94229:"c8a044ba",94319:"d0816b53",94708:"23cc9db4",94722:"5282f1c8",94900:"5787f6d3",94907:"29f28a73",95034:"64be7568",95188:"b42420f8",95461:"308641fb",95690:"f4bc196f",96276:"8aadacf1",96374:"6135d371",97482:"4a3e680b",97889:"02193fc8",97920:"1a4e3797",98016:"ffb2e417",98276:"2205312d",98444:"cc9c20e3",98509:"92ac5c16",98623:"394c74c3",98630:"68e9a632",98666:"f64e920b",98692:"67044a7a",99074:"e8646b2e",99156:"ff6e33f8",99235:"fe793f9f",99350:"196bfd5c",99438:"b5511831",99875:"57d9a11e",99889:"f56b8973",99959:"ebec70a2"}[e]||e)+"."+{16:"95e0997a",17:"02142ea6",288:"33a85255",482:"d9f5e639",520:"c21570a5",547:"bdec885e",930:"ea3478bd",1045:"ca6b16e4",1288:"cec758fd",1325:"36daf010",1369:"eb6ba0a8",1764:"1a6031d3",1893:"4a98b5fe",2050:"7b453b74",2201:"ad3df26d",2222:"ec9f034c",2269:"d8675fc0",2281:"05e72793",2487:"2b476883",2751:"4b562ced",3300:"1f36e88e",3507:"3145d6a9",3909:"d63592c0",4086:"6391b158",4746:"9948c140",4972:"c1e0c51c",5253:"3c8fc32e",6147:"eb09fe54",6338:"a4b54b32",6352:"5d14f184",6542:"b3f1d6d5",6729:"893492e4",7415:"a4a917a1",7848:"4c2aa69e",8156:"2d6a320e",8179:"350c6a2c",8214:"7f863a65",8392:"95aff25c",8478:"7bac00a3",8883:"ddf92a47",9642:"6869b485",9706:"349d0471",9799:"51815cbe",9817:"f9d79ca6",9862:"33c1d656",9904:"7ea4de16",10040:"7ac06fa5",10235:"ab4f13c3",10293:"87f68b44",10471:"5fe12cb7",11013:"ade95505",11053:"373f5210",11120:"150310d8",11434:"8e1d9c59",11500:"3dff2bcd",11606:"56683491",11968:"a755f5af",12920:"d03eea4e",12944:"2add0bd9",13055:"65361055",13085:"74c4de50",13408:"2e25889f",13586:"8c682e32",13667:"8d362cf8",13874:"cbb8c1d9",13959:"42f78561",14030:"57c1e1f4",14188:"030cce6e",14243:"e3763bcb",14710:"f3c09649",15114:"a0cebd68",15365:"45578418",15772:"d1e773f2",15975:"27374c8d",16021:"264ad229",16039:"38a142bf",16052:"dbdda7e2",16175:"12751b0b",16649:"91482eba",16950:"5d956fb9",16991:"82fcf322",17175:"d885a1cf",17217:"7e67cf71",17277:"97db1a5c",17446:"89ee35f9",17661:"0f5a68ec",17882:"97bd30d2",17929:"e95d3f51",18350:"af482d40",18387:"ecdb23e9",18471:"e7dc7dc4",18610:"8a8f909a",18894:"2da9821d",19219:"8a00ddc5",19396:"e4d6fd46",19423:"6a27f650",20202:"2a93bb92",20367:"e00fbdaa",21413:"0a7dfec7",21493:"7363f840",22043:"ee188a85",22190:"51ace0d8",22465:"f149b9ad",22620:"1e0d15a3",22761:"365a347a",22821:"5ff384bd",22982:"7827ecbf",23105:"696a8879",23198:"5687d4c2",23349:"c40a6a59",23389:"f05fa93a",23563:"143e8437",23733:"3abb3db5",23891:"142c057e",24669:"e5147b47",24697:"c8162876",24698:"cafbaf96",24947:"0233031b",25090:"a928e25d",25370:"6a7b305e",25382:"e77243fd",25760:"4b393b11",25817:"a09a6bc8",25968:"8988001f",26158:"25c83335",26467:"a246bca1",26560:"d5cc94c4",27e3:"76b5d8af",27078:"d33f03f0",27079:"b7725e8c",27133:"242a66cb",27188:"6e60fd6f",28135:"68b3b465",28268:"c2ebb553",28271:"798bcbda",28429:"1399b650",28751:"a3f317d7",28800:"b7ae44b4",29010:"c946c638",29140:"7afbbfab",29513:"760b6e5b",29514:"e4bcc747",29538:"8ebe6590",29681:"027863ff",29728:"651a8f72",29776:"49e857bf",30321:"ebeac310",30561:"039f452c",30601:"6cd65da7",30708:"4fc498e6",30717:"467f93e7",31287:"54c4de8f",31404:"81c31d94",31538:"f7fbf7d0",31626:"86039d8a",31640:"59558e17",31657:"b4731330",31833:"b2b7fa8e",31854:"11dd85d1",32074:"cfa3f3e9",32446:"0337a8ff",32854:"ddf29eef",33034:"784e6a16",33232:"2f974a7f",33263:"e9a2bf67",33404:"a71820ed",33431:"52e788b4",33451:"7ae801f2",33509:"8d723cab",33790:"d0c835a8",33887:"9eb42a33",33912:"5a8cbc49",34204:"94a1db98",34346:"0df99d03",34533:"cfa02200",34756:"44c0f5f9",34826:"d052436e",34980:"cb37b898",35226:"c1a6f8ac",35330:"0efdba7e",35424:"a0ae2d81",35708:"3302f660",35943:"ef743e8d",36206:"d0188849",36586:"3412dbbe",36904:"692a4593",37442:"855253b6",37486:"30e1048f",37487:"77385b9d",37742:"6df71594",38145:"ba3bdceb",38270:"47996dae",38461:"9e4da240",38499:"e68b2541",38527:"b8282fa0",38601:"2994690a",39066:"240b9b15",39220:"fa15e92c",39229:"d4fc6f4b",39494:"7fd53958",39626:"87b8e7f0",40541:"ff5ab4f6",40701:"4fca1903",40916:"9faa28b3",41003:"c513ea13",41150:"54f1938d",41650:"87e23358",41916:"a563cbc0",41957:"872fd2cc",42008:"4baa50ab",42070:"bbe5918a",42124:"c3f15a6b",42181:"c63517e6",42355:"a6103dd9",42573:"5923682b",42885:"707968a0",42954:"982828f1",43600:"a6c32670",43777:"4e0bdea2",43819:"f4f44adf",44209:"28c163b6",44484:"f64995ae",44497:"5a4e81f9",44588:"bf959556",44685:"608ba60a",44758:"2647b91d",44962:"8ee523a8",45044:"319d5a87",45350:"fd8b516f",45841:"3cda1b69",45843:"bcf9d914",45960:"7978ebf9",46294:"1c2833b0",46581:"d63d089d",46945:"11021670",47234:"2d89e5c0",47328:"494e9e64",47422:"8ce35e9c",47615:"2c0ce109",47629:"72d9f63d",47834:"a88f922d",48343:"b7f71889",48733:"59d26878",48890:"adb90665",48954:"ba099550",49157:"c5ceae49",49346:"f771bb40",49486:"08093aae",49549:"e9848ed5",49567:"92eb0037",49871:"e1429d77",49907:"47cabb35",50561:"77dfad07",51435:"99a83279",51537:"e2d07b22",51613:"0517bb7c",51618:"c7cef798",51953:"f98dbc91",52021:"8d7b0aff",52486:"199db7e6",52631:"18e460be",52745:"12ccc982",53068:"a8a7c89a",53302:"bf64e0b6",53587:"1fb9decf",53609:"a92abd6d",53685:"1f4e0d5f",53861:"3082678d",54487:"ad59b2d4",54709:"e849da75",54736:"5ad4aad6",54749:"392dc4ca",55035:"98dbe40d",55260:"5d41948f",55480:"269d4a93",55841:"96391cd4",55945:"1e6fe5d2",56025:"a3c35d87",56248:"0b9a9c44",56364:"d1082acc",56370:"463c9fd5",56419:"49bee624",56615:"6af21355",56963:"98579cc6",56979:"a3e32621",57103:"7ae80bb8",57287:"c717609b",57361:"9e1a42d7",57573:"d981bab5",58424:"559534ac",58729:"d9e7d269",59131:"6321bc6c",59213:"d5789a20",59273:"de1b77b0",59728:"6474cfc6",59856:"05158744",59865:"5e11a3f2",60439:"933bd6f9",60946:"4cb32984",60974:"97c72ade",61304:"b5145ede",61928:"7e1d334f",61931:"7f952791",62062:"353aded2",62536:"0e9efbf3",62726:"a4cb7dcf",62781:"e0de6259",62954:"9962cb52",63119:"bd396e75",63157:"fb4e705c",63453:"404737d0",64131:"9dd0ebf3",64195:"07350901",64302:"b378118d",64549:"29ef3ede",64807:"012554aa",64841:"2185b4d7",65064:"8e325daa",65135:"e398eaec",65368:"a9c66679",65369:"d5e7d0d4",65649:"b62f9c6f",65787:"0bdb95a3",65858:"4c869c9e",65882:"f0e68a30",65954:"ec720aed",65957:"fee0bf24",66073:"44a91d45",66334:"501cd9fc",67140:"c47f094f",67365:"bcaab239",67396:"2292c9b1",67673:"bae0b73d",67744:"157c94a2",67813:"e6d17ef0",67818:"babc89ec",67995:"2b2b3914",68026:"15fd8f87",68122:"7e850de8",68189:"974dced1",68224:"4795aaa2",68265:"63ef79da",68349:"079b6e78",68436:"499df18c",68618:"629b88a8",68724:"bd00f8e9",68755:"ff5fc04a",68960:"c8fcea47",69043:"5b3372ec",69345:"a9a29a15",69360:"b0ad318b",69413:"4eb3fec6",69905:"b7945067",69998:"1366f4ef",70207:"407299fe",70421:"36abd26a",70520:"8c0695df",70611:"32ff9875",70633:"85e93002",70838:"f11d1f21",71147:"157ba2f9",71253:"a6bc6c99",71360:"f03023e7",71386:"f3348c48",71525:"a6ed29d8",71670:"d2e6e43a",71723:"4709da61",71814:"56dd82a2",72371:"a3c669a6",72464:"2f3537e5",72474:"773f920d",72556:"b4ea6c17",72939:"3a3441fd",73088:"98f34523",73555:"983f0e56",73634:"17860f4d",74010:"9eb2cd2e",74123:"ea47ea58",74190:"05e92f95",74199:"2aa5f99d",74298:"a6a915f6",74318:"ad46b4b0",74400:"78ed677d",74904:"9e1e08a1",75034:"bdf96616",75062:"ee60c5b9",75063:"579d8500",75212:"cdafcb6e",75248:"c64c9475",75384:"ffa1d26f",75478:"3ee066fd",75647:"c79bb3a9",76413:"3c778b15",76559:"718e9bd1",76780:"a2521cf6",76907:"e13d00cb",77183:"c0ad547e",77184:"5344e158",77769:"b98f4bd0",77771:"d3e7506f",77787:"ec5cef53",78023:"f1b2fc67",78297:"e4f53ff6",78301:"77cdbff5",78382:"76c0d111",78494:"05fed9af",78560:"ecc9e3d8",78880:"ba3defe8",78897:"8b852a89",79022:"887e7198",79376:"a35faf3e",79527:"bd63dac4",79639:"16f4f0ae",79796:"3a32726b",80053:"b8ca5cff",80371:"23ddacc4",80536:"6f369947",80693:"e6026f56",80802:"240a9b32",80954:"eb30c055",81355:"c0630deb",81832:"bad43f20",81981:"b924f531",82251:"f49cb2c9",82591:"a17d8a02",82946:"beb24b95",83e3:"195954f3",83443:"74b93655",83540:"e709cdec",83667:"e6c21a7a",83771:"0981c21d",83882:"1cba5326",83922:"b74510b1",84453:"a175f0b0",84683:"aa837944",85015:"6922a556",85064:"8f791a22",85185:"31a48b3e",85228:"218217bc",85694:"ab54dd1a",85897:"736db16a",85953:"eeb2a562",86072:"5080c454",86098:"dd1b5cbc",86181:"fbf80418",86401:"223755ab",86455:"d22696db",86764:"21660651",86948:"a6813667",87074:"914e646e",87306:"038baecb",87414:"a1d1b84b",87582:"d8c159ba",87593:"b5b5099f",87655:"e65ff3fe",88115:"b037e7eb",88184:"4d0515ff",89101:"df7e2695",89645:"1108f5d1",89987:"9ce9ed67",90206:"4fe580ee",90558:"64e938f3",90888:"2be72233",91172:"4f311445",91218:"6553173b",91250:"ac023bc8",91919:"6b6753c6",92546:"438b2f58",92903:"84ca9238",93337:"c3f50868",93387:"09b65a76",93519:"80c34a74",93546:"8c92d65e",93610:"97e39690",93822:"abc403e4",93903:"8c75acce",94018:"b831695c",94089:"96e09e44",94091:"85ea2c44",94194:"4c05d3ad",94229:"39be4c83",94319:"f653c4f9",94708:"c292e4a2",94722:"974775bd",94900:"3959d337",94907:"9ea3a473",95034:"36eef0a9",95188:"d5c0ca2e",95461:"f5c04beb",95690:"fffc088f",96276:"7dc68782",96374:"132c5041",97482:"f5466d75",97889:"abe5362e",97920:"d5457aa2",98016:"75b6d8f9",98276:"2904fbe2",98444:"ea450473",98509:"97e0d0cb",98623:"65824ddc",98630:"a1951a5d",98666:"ef80b98e",98692:"74506fb9",99074:"a1d05c43",99156:"64490ce3",99235:"b6625b1f",99350:"d2165e86",99438:"d621c348",99875:"14b35e8a",99889:"c23c19b6",99959:"03d89ae8"}[e]+".js",t.miniCssF=e=>{},t.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),t.o=(e,b)=>Object.prototype.hasOwnProperty.call(e,b),c={},f="docusaurus-docs:",t.l=(e,b,a,d)=>{if(c[e])c[e].push(b);else{var r,o;if(void 0!==a)for(var n=document.getElementsByTagName("script"),i=0;i{r.onerror=r.onload=null,clearTimeout(l);var f=c[e];if(delete c[e],r.parentNode&&r.parentNode.removeChild(r),f&&f.forEach((e=>e(a))),b)return b(a)},l=setTimeout(s.bind(null,void 0,{type:"timeout",target:r}),12e4);r.onerror=s.bind(null,r.onerror),r.onload=s.bind(null,r.onload),o&&document.head.appendChild(r)}},t.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.nmd=e=>(e.paths=[],e.children||(e.children=[]),e),t.p="/docs/zh-TW/",t.gca=function(e){return e={20358428:"79527",26183636:"86072",38784009:"8156",68556356:"70207",68843839:"52745",73567145:"53587",79022373:"21493",a2a78cd2:"16","5df371ad":"17","575a2139":"288","4ef5f34b":"482",fb1a77b4:"520","3365bb5d":"547",bc8f9087:"930","3ef25e43":"1045",ecc882d7:"1288","1ff2c95d":"1325","2be8d75a":"1369","8f25d185":"1764","4c5e977b":"1893",f54e89d1:"2050","8ba34e88":"2201","0c82f1cb":"2222",a596dc7e:"2269","652aa3bb":"2281",b7b09b70:"2487",faa6790b:"2751","655c39d2":"3300","2425c15c":"3507","3e441ee4":"3909","78ec6490":"4086","93a1b6a2":"4746","1bcb7f60":"5253","1f54c2ac":"6147",e628edd4:"6352",af2c52ce:"6542",e2cf295d:"6729","5ea9e4ca":"7415",b760913b:"7848","136658e4":"8179","9755f20c":"8214","8d4600d0":"8392","401fb871":"8478","6860968b":"8883","0002f649":"9642","2eca92d8":"9706","14eb3368":"9817",d5ac6535:"9862",f62a7bc0:"9904","954c355d":"10040",a7d19085:"10235",fa570740:"10293",b71c170b:"10471",e8acd80e:"11013","7205acf7":"11053","7c3d9323":"11120","99aca8b2":"11434",d68165b9:"11500","5016f915":"11606",f34bbf22:"11968",ee2d7736:"12920",a4a7c88e:"12944","97600ac6":"13055","1f391b9e":"13085",fdf22a50:"13408",c668d467:"13586",bf60373a:"13667","643f775f":"13874","2d0f081e":"13959",c5d3bb95:"14030","035fc0a7":"14188","0744e06b":"14243","2492320d":"14710",ee7f03d8:"15114",b82d00b2:"15365",b568538e:"15772","1bab1317":"15975",a42811bf:"16021","4e6201a8":"16039","8aab06bf":"16052","567ff302":"16175",a19cf377:"16649",b43e4353:"16950","3f53f1c4":"16991",c4f64aee:"17175","4ef1736a":"17217","72ceeaac":"17277",eaca4732:"17446","265355c2":"17661",e88bed7b:"17882",d56e3bd7:"17929","0f2e9443":"18350","2be7eaec":"18387","2bfafb22":"18471",c5a9135f:"18610",f2bfa581:"19219","9f35e670":"19396","1912069b":"19423","1e049e66":"20202","05a3c259":"20367","6dfd8a52":"21413","269c0fa1":"22043","89f7284f":"22190","1955e4c9":"22465",cf587678:"22620",dac58f9a:"22821",f041af6f:"22982","6ac88df6":"23105","15df18f8":"23198","5b6fa4ec":"23349","9041aea1":"23389","935cb8db":"23563",b82293b3:"23733","642b1006":"23891",f552bd00:"24669",c54eca7f:"24697","92e11b3f":"24698",e9b84ed8:"24947","87897be6":"25090",af4a2ad4:"25370","632d2515":"25382","31e78686":"25760","7988f281":"25817","156751cf":"25968",d2de2978:"26158","302d24dc":"26467","5b788f5c":"26560","3326e4c4":"27000",d7ac3c03:"27078","49a0e813":"27079","92e99bf6":"27133","5036ec9d":"27188","89179ad6":"28135",b8161d6a:"28268",f7eb3a66:"28271",b052b80c:"28429",e31a16ba:"28751","1dbaa503":"28800","8c2621f5":"29010","1d8ede30":"29140","0ac7fcd1":"29513","1be78505":"29514","4c950052":"29538","4d96b439":"29681","38c90751":"29728","5dab34b6":"29776","751792b8":"30321",bc670d5c:"30561",e5d84bc0:"30601","124f7953":"30708",ecdb20a1:"30717",b2d0af62:"31287","3e301362":"31404","19b883ea":"31538","3394f7b8":"31626","4f7dcb1e":"31640","8fbaa47b":"31657","86fd2478":"31833",b45ff73d:"31854","13063a10":"32074","6870c8c4":"32446","6c46dea8":"32854","41ed4202":"33034","6131b9f8":"33232","005fee41":"33263",afdda5b6:"33404",e35d3956:"33431",f5b6c895:"33451","786f71e5":"33509",c423df2e:"33790","10ca1dd8":"33887","1bc94aef":"33912","269acb60":"34204","1db637b2":"34346","3abccbcc":"34533","9c643b6e":"34756","70e3a7c5":"34826",ea7cec67:"34980",e7958aaa:"35226",eadead04:"35330","3635a766":"35424","41eb0037":"35708",bc53881b:"35943","90c3ec62":"36206","8c3021dd":"36586",e71641ea:"36904",f6ef3039:"37442",dcc6b54d:"37486",a9bf2227:"37487","969753d7":"37742","28e7e1e3":"38145","5393ce94":"38270","917300a3":"38461",a88f137d:"38499","4f9fd89c":"38527",f7242226:"38601",a4a7a840:"39066","7114ac56":"39220","429a6f3e":"39229","01804294":"39494",fd867f7c:"39626","816b2b7d":"40541","1ce0a301":"40701",e4459066:"40916",d0d62bb5:"41003",fe26f94f:"41150",c7707dd8:"41650","2a38ab5e":"41916",d69803c7:"41957","9e43e7b6":"42008","7cb4903f":"42070","19357a65":"42124",be510d4c:"42181","2f504c6e":"42355",ce346131:"42573",acdbee8e:"42885","2814cf01":"42954","1dcc65e0":"43600",b9aefb1a:"43777",fc1db29b:"43819","278665dc":"44209","3cd952ae":"44484",d32e6b20:"44497","3c5750f8":"44588",f5c87087:"44685","0a13a0e4":"44758","1c5f7d2b":"44962","17abfa8d":"45044",e8c60e9b:"45350","0c0bbaea":"45841",e4bacbbb:"45843","5b3c1c53":"45960",db229a81:"46294",c2d91591:"46581",ae346411:"47234","6daf901a":"47328","1cf37028":"47422","84ebbbbf":"47615","0cd0cfa8":"47629","09be2ba2":"47834","2c056d5d":"48343",d21505c8:"48733",d5603669:"48890",b0bdb7f3:"48954","9de65041":"49157",b8919bdb:"49346",e72cf26a:"49486","48e0b5d4":"49549",f0cf672d:"49567",b2f83e6d:"49871",f2e41396:"49907","254ac25b":"50561",fe2b089e:"51435","431ad29b":"51537","27b935de":"51613","2cbe9533":"51618",c3e83a7d:"51953","25b6fab0":"52021",de127d6b:"52486",c46f1db0:"52631",c3d815ae:"53068",cb8de75d:"53302","81be975d":"53609","8c00b41d":"53685","3e96b4b5":"53861","5ebc7423":"54487","2b93221c":"54709",a5463d8a:"54736",bf25430f:"54749",ea64ac1c:"55035","9e4d6f26":"55260","006095b2":"55480",a67bdd24:"55841","79aa13fb":"55945",c3aed80f:"56025","8a1c8da1":"56248","281b126c":"56364","36f93d19":"56370","80e8986a":"56419",b4f4317d:"56615","1b80e345":"56963",d005934a:"56979","77d0fddc":"57103",bde9fb45:"57287","3e26f8b3":"57361",e3e4fe7d:"57573","03edb22c":"58424",dbbfa97d:"58729","3b0223df":"59131",f6bb9d12:"59213",fcae69e8:"59273",aa5bd2a7:"59728",e5c88a3e:"59856",e8ee0390:"59865",fca48710:"60439",bb292d37:"60946","11314fda":"60974","8d5fe6f9":"61304","15113e52":"61928","4c21dbbd":"61931","988ba51e":"62062","431b5d0e":"62536","748490a7":"62726","703f575d":"62781","90305fb4":"62954",d7567838:"63119","586e3f5e":"63157","37da3438":"63453","52c1dace":"64131",c4f5d8e4:"64195","05c5421d":"64302","788d9fe0":"64549","8a495097":"64807",b49164a1:"64841","4840c3eb":"65064","789f108c":"65135",cc468388:"65368",c15b67f7:"65369","8047f3a3":"65649",c4ae09d4:"65787","1290c878":"65858","6aa5826c":"65882",b9776525:"65954",e4627c87:"65957","97b92a45":"66073","3c39ccf9":"66334",e8b2d68f:"67140","18f77871":"67365",a9dd1cc8:"67396","6eb57332":"67673","6ca8826f":"67744","8894256f":"67813",baa3212e:"67818",ff2d6dd8:"67995",e63b451d:"68026",db9559d3:"68122","26e12baa":"68189","78bca219":"68224","389bb65e":"68265","3d3a07f6":"68349","68408d35":"68436","88e3fe7e":"68618",a79a2e70:"68755","03cc88eb":"68960","9ad8637e":"69043","01a16f71":"69345","98a6b9c4":"69360","71063c2b":"69413",e23eefc0:"69905",b7cfb3da:"69998",a934672d:"70421",e2df322b:"70520",fa114b0c:"70611",b50c9021:"70633","22bdf908":"70838","1a99b1ee":"71147","970a27d6":"71253","17b00a4a":"71360",b1892b20:"71386","3b7cd1e1":"71525","6d8024b7":"71670","0328b0c9":"71723","47c64002":"72371","8b8c4320":"72464",f9e1fd09:"72474","5614add0":"72556",a626e327:"72939","955e06fd":"73088","3627f230":"73555",e0bec19d:"73634","37cea19d":"74010",a8654aa2:"74123","84cf2087":"74190","67db246e":"74199","48db5030":"74298",b8d9b1bd:"74318",aacc2fee:"74400",c0ad5dc6:"74904","30a22249":"75034",add4d791:"75062",cf69f832:"75063","19b0499c":"75212",e82ff315:"75248","42bb1101":"75384","200e51df":"75478","2b3e7a7f":"75647","777bd32a":"76413","93b78259":"76559",a208e2a5:"76907",a94c7dba:"77183","11b4dd89":"77184","60ea2d86":"77769","56a38f24":"77771","53bd4095":"77787","2b20c80a":"78023","71051dda":"78297","676afd3b":"78301","1a77ceda":"78382",e49348be:"78494",fd37922c:"78560","44befa6d":"78880","8a942fcc":"78897","9beaa53d":"79022","6249c7de":"79376","7cd86536":"79639",d2c4b928:"79796","935f2afb":"80053",c038b4a2:"80371","17c91901":"80536",cfc8b1e5:"80693","48d397c0":"80802",db449848:"80954","9ad476bb":"81355",a8e44541:"81832",c8450cf2:"81981","989904ef":"82251",de89bf85:"82591","3b83c135":"82946",cc7f3e03:"83000",f47c1d11:"83443","6500be67":"83540",ab4a8e8f:"83667","8c02dfd8":"83771","3a4337ef":"83882",cc806444:"83922",fc15d889:"84453","25b7eef7":"84683",f21b2fb0:"85015",d02b76f9:"85064",e1b9cf16:"85185","2fcb69bb":"85228",db0d392c:"85694","6b3775fc":"85897",b700f6c8:"85953","149e5a51":"86098",a01bbcd4:"86181",fed0304a:"86401",e8c8f122:"86455",d8958d75:"86764",af7ab695:"86948","6268d0ca":"87074",aebe3827:"87306","393be207":"87414","7fc0684b":"87582","50219e10":"87593","40230f21":"87655",d0e9a494:"88115","87f76dec":"88184",e2c0c813:"89101",e760b063:"89645","9ccbc3bf":"89987","4a9b1fdb":"90206","93f8b8b5":"90558","5c18dc43":"90888","864138a2":"91172","29cd8cc9":"91218","8758e270":"91250",d51ffe49:"91919",cc24cbe6:"92546","84ee34f2":"92903",bef6aaf2:"93337","007a6c32":"93387","6f951ae3":"93519","1010372b":"93546",caba9b9f:"93610","7d52489f":"93822","5610cdb3":"93903","046df3c9":"94018",d9ffe17e:"94089","5c128c28":"94091","4b3e38af":"94194",c8a044ba:"94229",d0816b53:"94319","23cc9db4":"94708","5282f1c8":"94722","5787f6d3":"94900","29f28a73":"94907","64be7568":"95034",b42420f8:"95188","308641fb":"95461",f4bc196f:"95690","8aadacf1":"96276","6135d371":"96374","4a3e680b":"97482","02193fc8":"97889","1a4e3797":"97920",ffb2e417:"98016","2205312d":"98276",cc9c20e3:"98444","92ac5c16":"98509","394c74c3":"98623","68e9a632":"98630",f64e920b:"98666","67044a7a":"98692",e8646b2e:"99074",ff6e33f8:"99156",fe793f9f:"99235","196bfd5c":"99350",b5511831:"99438","57d9a11e":"99875",f56b8973:"99889",ebec70a2:"99959"}[e]||e,t.p+t.u(e)},(()=>{var e={51303:0,40532:0};t.f.j=(b,a)=>{var c=t.o(e,b)?e[b]:void 0;if(0!==c)if(c)a.push(c[2]);else if(/^(40532|51303)$/.test(b))e[b]=0;else{var f=new Promise(((a,f)=>c=e[b]=[a,f]));a.push(c[2]=f);var d=t.p+t.u(b),r=new Error;t.l(d,(a=>{if(t.o(e,b)&&(0!==(c=e[b])&&(e[b]=void 0),c)){var f=a&&("load"===a.type?"missing":a.type),d=a&&a.target&&a.target.src;r.message="Loading chunk "+b+" failed.\n("+f+": "+d+")",r.name="ChunkLoadError",r.type=f,r.request=d,c[1](r)}}),"chunk-"+b,b)}},t.O.j=b=>0===e[b];var b=(b,a)=>{var c,f,d=a[0],r=a[1],o=a[2],n=0;if(d.some((b=>0!==e[b]))){for(c in r)t.o(r,c)&&(t.m[c]=r[c]);if(o)var i=o(t)}for(b&&b(a);n Derivatives Guides | Bybit API Documentation - +

    Derivatives Guides

    Let's learn about derivatives concepts!

    - + \ No newline at end of file diff --git a/zh-TW/category/spot.html b/zh-TW/category/spot.html index 7319023239..def43124e2 100644 --- a/zh-TW/category/spot.html +++ b/zh-TW/category/spot.html @@ -4,13 +4,13 @@ Spot Guides | Bybit API Documentation - +

    Spot Guides

    Let's learn about spot concepts!

    - + \ No newline at end of file diff --git a/zh-TW/changelog/asset-v3.html b/zh-TW/changelog/asset-v3.html index 6e492cbbc3..8ff9027c2e 100644 --- a/zh-TW/changelog/asset-v3.html +++ b/zh-TW/changelog/asset-v3.html @@ -4,13 +4,13 @@ 帳戶資產 V3 | Bybit API Documentation - +

    帳戶資產 V3

    2024-05-09​

    REST API​

    • 提現 [更新]

      • 新增請求參數beneficiary, vaspEntityId, beneficiaryName, 僅用於kyc為韓國的用戶在提現時需要填寫travel rule信息

    • 查詢交易所列表 [新增]

      • 新增接口給到kyc=韓國的用戶來查詢提現目標交易所的信息

    • 劃轉(單帳號內) [更新]

      • 新增響應字段status, 如果遇到PENDING, 請調用查詢接口確認最終狀態

    • 萬能劃轉 [更新]

      • 新增響應字段status, 如果遇到PENDING, 請調用查詢接口確認最終狀態

    2024-04-23​

    REST API​

    2024-03-22​

    REST API​

    2024-02-28​

    REST API​

    2023-11-14​

    REST API​

    • 提現 [更新]
      • 接口頻率從10次/分鐘變更為1次/秒

    2023-09-18​

    REST API​

    • 新建子帳戶的API Key [更新]
      • 請求參數ips字段實際上是字符串類型, 但原有的數組類型依然可以使用.
      • 請求參數Derivatives字段已經廢棄, 系統會自動識別帳戶類型來決定是否添加統一帳戶權限
    • 修改母帳戶的API Key設置 [更新]
      • 請求參數ips字段實際上是字符串類型, 但原有的數組類型依然可以使用.
      • 請求參數Derivatives字段已經廢棄, 系統會自動識別帳戶類型來決定是否添加統一帳戶權限
    • 修改子帳戶的API Key設置 [更新]
      • 新增請求字段apikey, 用於母帳戶管理子帳戶的key
      • 請求參數ips字段實際上是字符串類型, 但原有的數組類型依然可以使用.
      • 請求參數Derivatives字段已經廢棄, 系統會自動識別帳戶類型來決定是否添加統一帳戶權限
    • 刪除子帳戶的API Key [更新]
      • 新增請求字段apikey, 用於母帳戶刪除子帳戶的key

    2023-08-31​

    REST API​

    • Get Deposit Records (on chain) [更新]
      • 新增響應字段depositType, 表示該筆充值的類型, 如觸發了每日充值限額或者充值異常, 可以在網站上處理那些無法充值成功的資產
    • Get Sub Deposit Records (on chain) [更新]
      • 新增響應字段depositType, 表示該筆充值的類型, 如觸發了每日充值限額或者充值異常, 可以在網站上處理那些無法充值成功的資產

    2023-08-30​

    REST API​

    2023-08-17​

    REST API​

    2023-08-07​

    REST API​

    2023-07-24​

    REST API​

    • 查詢賬戶單個幣種余額 [更新]
      • 新增請求參數: toAccountType, toMemberId, withLtvTransferSafeAmount
      • 新增響應字段: ltvTransferSafeAmount

    2023-06-15​

    REST API​

    2023-06-06​

    REST API​

    • 提現 [更新]
      • 新增請求參數 feeType, 支持選擇手續費內扣還是外扣

    2023-03-23​

    REST API​

    2023-03-15​

    REST API​

    2023-02-28​

    REST API​

    2023-02-20​

    REST API​

    2023-02-14​

    REST API​

    • 提現 [更新]
      • 支持選擇出金帳戶
      • 默認出金錢包是現貨錢包
    入参是否必需類型說明
    accountTypefalsestring設置出金帳戶.
    • SPOT：走現貨錢包出金 (默認)
    • FUND：走資金錢包出金

    2023-02-09​

    REST API​

    2023-02-06​

    REST API​

    - + \ No newline at end of file diff --git a/zh-TW/changelog/copytrade.html b/zh-TW/changelog/copytrade.html index f79234d89b..8b4fe4f222 100644 --- a/zh-TW/changelog/copytrade.html +++ b/zh-TW/changelog/copytrade.html @@ -4,13 +4,13 @@ 跟單交易 | Bybit API Documentation - +

    跟單交易

    2023-06-24​

    REST API​

    • Bybit將在6月24日開始陸續開啟帶單交易uid允許升級到新的帶單交易功能, 如果您選擇升級, 請注意以下事項:
      • 您的帳戶將會被分配一個全新子帳戶, 並擁有USDT永續的帶單交易功能
      • 您需要為此帳戶創建新的api key, 並且勾選"合約"權限
      • 您不再允許使用老版本的Copy Trade V3接口, 然而可選擇合約 V3 or V5進行帶單交易, V5接口更為推薦.

    2023-03-23​

    REST API​

    2023-03-15​

    REST API​

    - + \ No newline at end of file diff --git a/zh-TW/changelog/derivatives-v3.html b/zh-TW/changelog/derivatives-v3.html index 30e508029f..d8ef48c95c 100644 --- a/zh-TW/changelog/derivatives-v3.html +++ b/zh-TW/changelog/derivatives-v3.html @@ -4,13 +4,13 @@ 衍生品 V3 | Bybit API Documentation - +

    衍生品 V3

    2024-05-09​

    REST API​

    • 查詢合約風險限額 [更新]
      • 當查詢category="linear"時, API每次返回30個symbol的數據集, 請使用請求參數cursor來翻頁
      • 新增響應字段nextPageCursor

    2024-04-11​

    REST API​

    2024-03-12​

    REST API​

    • 設置風險限額 [廢棄]
      • 由於自動設置risk limit功能已上線, 該接口被廢棄

    2024-03-04​

    REST API​

    Websocket API​

    2023-11-09​

    REST API​

    2023-10-25​

    REST API​

    • 查詢持倉 (實時) [更新]

      • 新增響應字段 isReduceOnly, mmrSysUpdatedTime, leverageSysUpdatedTime

    • 確認新的風險限額 [新增]

      • 新增接口, 用於在主動調整完風險水位後, 觸發接口來讓系統移除只減倉限制

    Websocket API​

    • 持倉 [更新]
      • 新增響應字段 isReduceOnly, mmrSysUpdatedTime, leverageSysUpdatedTime

    2023-09-28​

    REST API​

    2023-08-11​

    REST API​

    WebSocket API​

    • 錢包
      • availableToBorrow 總是返回"" 因為母子共享借貸上限

    2023-07-31​

    REST API​

    WebSocket API​

    2023-07-13​

    REST API​

    2023-05-23​

    REST API​

    • 創建委託單 [更新]
      • 針對新版止盈止損, 新增請求參數 tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType
    • 修改委託單 [更新]
      • 針對新版止盈止損, 新增請求參數 tpLimitPrice, slLimitPrice
    • 查詢實時委託單 [更新]
      • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice
    • 查詢歷史訂單 [更新]
      • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice
    • 查詢持倉 (實時) [更新]
      • tpSlMode 字段從倉位數據中廢棄
    • 設置止盈止損 [更新]
      • 針對新版止盈止損, 新增請求參數 tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType

    WebSocket API​

    • 持倉 [更新]
      • tpSlMode 字段從倉位數據中廢棄
    • 訂單 [更新]
      • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice

    2023-05-10​

    REST API​

    老錯誤碼新錯誤碼消息
    10001140071RiskId is not modified

    2023-04-20​

    REST API​

    • 查詢帳戶配置 [更新]
      • 新增響應參數 dcpStatus, timeWindow, smpGroup
    • 創建委託單 [更新]
      • 新增請求參數 smpType 來選擇自成交執行類型
    • 查詢實時委託單 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增cancelType枚舉cancelBySmp
    • 查詢歷史訂單 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增cancelType枚舉cancelBySmp

    WebSocket API​

    • 訂單 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增cancelType枚舉cancelBySmp

    2023-04-12​

    REST API​

    WebSocket API​

    • 持倉 [更新]
      • 新增響應字段adlRankIndicator

    2023-03-08​

    REST API​

    2023-03-03​

    REST API​

    2023-02-28​

    REST API​

    • IP限頻 [更新]
      • 由於切換到CloundFront, 因此IP規則做了適當調整

    2023-02-20​

    WebSocket API​

    • 個人成交 [更新]
      • 新增返回字段: blockTradeId, markPrice

    2023-02-09​

    REST API​

    WebSocket API​

    • 訂單 [更新]
      • 新增返回字段: avgPrice, blockTradeId, cancelType, cumExecFee, leavesValue, positionIdx, rejectReason

    2023-01-19​

    REST API​

    WebSocket API​

    • 持倉
      • 組合保證金模式下, positionIM, positionMM, leverage返回"", riskId返回0
    • 訂單
      • 組合保證金模式下, orderIM返回""
    • 錢包
      • 組合保證金模式下, totalOrderIM, totalPositionIM, totoalPositionMM返回""

    2023-01-16​

    WebSocket API​

    • 深度
      • 增加500檔的推送，頻率為100ms

    2023-01-05​

    WebSocket API​

    • 行情
      • nextFundingTime 從日期2023-01-05T08:00:00Z變動為UTC時間戳(毫秒)1672905600000
      • predicatedFundingRate 從消息中移除
    - + \ No newline at end of file diff --git a/zh-TW/changelog/spot-v3.html b/zh-TW/changelog/spot-v3.html index 4a8ca28785..122a21ab21 100644 --- a/zh-TW/changelog/spot-v3.html +++ b/zh-TW/changelog/spot-v3.html @@ -4,13 +4,13 @@ 現貨 V3 | Bybit API Documentation - +

    現貨 V3

    2023-04-20​

    REST API​

    • 創建活動委托單 [更新]
      • 新增請求參數 smpType 來選擇自成交執行類型
      • 新增響應參數 smpType
    • 訂單列表 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增響應參數 cancelType, 對應枚舉值為CancelBySmp 和 UNKNOWN
    • 查詢活動委托 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增響應參數 cancelType, 對應枚舉值為CancelBySmp 和 UNKNOWN
    • 歷史訂單 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增響應參數 cancelType, 對應枚舉值為 CancelBySmp 和 UNKNOWN

    WebSocket API​

    • 訂單 [更新]
      • 新增響應參數 st, sg, so
      • 新增響應參數 ct, 對應枚舉值為 CancelBySmp 和 UNKNOWN

    2023-04-12​

    REST API​

    • 訂單列表 [更新]
      • 新增返回字段 blockTradeId 大宗交易ID
    • 查詢活動委托 [更新]
      • 新增返回字段 blockTradeId 大宗交易ID
    • 歷史訂單 [更新]
      • 新增返回字段 blockTradeId 大宗交易ID
    • 交易記錄 [更新]
      • 新增返回字段 blockTradeId 大宗交易ID

    WebSocket API​

    • 訂單 [更新]
      • 新增返回字段 b 表示大宗交易ID
    • 個人成交 [更新]
      • 新增返回字段 b 表示大宗交易ID

    2023-03-13​

    WebSocket API​

    2023-03-09​

    REST API​

    2023-02-28​

    REST API​

    2023-01-16​

    WebSocket API​

    • 行情
      • xp 已經添加到推送中. 該字段表示為USD指數價格, 可以為空。
    - + \ No newline at end of file diff --git a/zh-TW/changelog/v5.html b/zh-TW/changelog/v5.html index 0d6de0b7d0..eca59c8783 100644 --- a/zh-TW/changelog/v5.html +++ b/zh-TW/changelog/v5.html @@ -4,7 +4,7 @@ V5 | Bybit API Documentation - + @@ -14,7 +14,7 @@ USDTPerpetualLeverage, symbol, leverage, USDCContractLeverage
  • 查詢借貸訂單信息
    • 新增響應字段USDTPerpetualOpenLine, USDCContractOpenLine, USDCOptionsOpenLine, USDTPerpetualCloseLine, USDCContractCloseLine, USDCOptionsCloseLine, USDCContractSymbols, USDCOptionsSymbols, marginLeverage, USDTPerpetualLeverage, symbol, leverage, USDCContractLeverage
  • 查詢賬戶單個幣種余額
    • 新增請求參數: toAccountType, toMemberId, withLtvTransferSafeAmount
    • 新增響應字段: ltvTransferSafeAmount
  • 新增錯誤碼適配UTA帳戶支持場外借貸的交易限制場景
    • 新增錯誤碼描述
    30133USDT永續: 當交易對不在白名單內
    30134USDT合約: 當交易對不在白名單內
    30135USDT永續: 當設置的槓桿大於機構借貸規定的
    30136USDC合約: 當設置的槓桿大於機構借貸規定的
    3200316期權: 限制交易
    3200317期權: 限制買入
    170709現貨: 當交易對不在白名單內
    170215現貨: 限制買入
    170216現貨: 全倉槓桿倍數超過機構借貸規定的
    170220現貨: 限制交易

    2023-07-13​

    REST API​

    2023-07-04​

    REST API​

    2023-06-29​

    WebSocket API​

    2023-06-26​

    WebSocket API​

    • 深度 [現貨]
      • 將50檔位的頻率從100ms提升到20ms

    2023-06-24​

    REST API​

    2023-06-15​

    REST API​

    2023-06-14​

    REST API​

    2023-06-08​

    REST API​

    2023-06-07​

    REST API​

    • 提現 [更新]
      • 新增請求參數 feeType, 支持選擇手續費內扣還是外扣

    2023-06-02​

    REST API​

    2023-06-01​

    REST API​

    WebSocket API​

    • 持倉 [更新]
      • 新增響應參數字段 positionBalance

    2023-05-30​

    REST API​

    2023-05-23​

    REST API​

    • 創建委託單 [更新]
      • 針對新版止盈止損, 新增請求參數 tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType
    • 修改委託單 [更新]
      • 針對新版止盈止損, 新增請求參數 tpLimitPrice, slLimitPrice
    • 查詢實時委託單 [更新]
      • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice
    • 查詢歷史訂單 [更新]
      • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice
    • 查詢持倉 (實時) [更新]
      • tpslMode 字段從倉位數據中廢棄
    • 設置止盈止損 [更新]
      • 針對新版止盈止損, 新增請求參數 tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType

    WebSocket API​

    • 持倉 [更新]
      • tpslMode 字段從倉位數據中廢棄
    • 訂單 [更新]
      • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice

    2023-05-10​

    REST API​

    老錯誤碼新錯誤碼消息
    10001110075RiskId is not modified

    2023-05-05​

    REST API​

    2023-05-04​

    REST API​

    • 查詢成交紀錄 [更新]
      • 對於普通帳戶查詢期貨時，symbol 不再是必傳字段
    • 查詢平倉盈虧 [更新]
      • 對於普通帳戶查詢期貨時，symbol 不再是必傳字段

    2023-04-20​

    REST API​

    • 創建委託單 [更新]
      • 新增請求參數 smpType 來選擇自成交執行類型
    • 查詢實時委託單 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增cancelType枚舉cancelBySmp
    • 查詢歷史訂單 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增cancelType枚舉cancelBySmp
    • 查詢賬戶配置 [更新]
      • 新增響應參數 dcpStatus, timeWindow, smpGroup

    WebSocket API​

    • 訂單 [更新]
      • 新增響應參數 smpType, smpOrderId, smpGroup
      • 新增cancelType枚舉cancelBySmp

    2023-04-06​

    REST API​

    2023-04-04​

    REST API​

    WebSocket API​

    • 持倉 [更新]
      • 新增響應字段adlRankIndicator
      • UTA帳戶的推送新增字段category
    • 訂單 [更新]
      • 新增響應字段 placeType, 供期權訂單使用
    • 個人成交 [更新]
      • 新增響應字段 closedSize

    2023-03-24​

    REST API​

    2023-03-23​

    REST API​

    WebSocket API​

    • 錢包 [更新]
      • 新增返回字段 accountLTV

    2023-03-22​

    REST API​

    2023-03-15​

    REST API​

    2023-03-10​

    REST API​

    • 查詢可交易產品的規格信息 [更新]
      • 統一現貨、期貨和期權的交易對狀態枚舉值。統一使用Trading, Closed, Settling, PreLaunch, Deliverying
      • 移除期權響應體中多餘的字段category
    • 查詢手續費率 [更新]
      • 支持查詢期權的手續費率

    2023-03-09​

    REST API​

    • 全倉槓桿設置 [更新]
      • UTA用戶支持10倍全倉槓桿交易
    • 查詢錢包餘額 [更新]
      • 更新前: 普通帳戶調用接口, accountType=UNIFIED時, 返回錯誤碼和錯誤信息.
        更新後: 普通帳戶調用接口, accountType=UNIFIED時, 返回http code 400

    2023-02-28​

    REST API​

    WebSocket API​

    • 錢包 [更新]
      • 新增推送字段 bonus

    2023-02-20​

    REST API​

    2023-02-15​

    REST API​

    • 用戶 [新增]
      • 增加一組用戶API Key管理的接口

    2023-02-14​

    REST API​

    入参是否必需類型說明
    accountTypefalsestring設置出金帳戶.
    • SPOT：走現貨錢包出金 (默認)
    • FUND：走資金錢包出金

    2023-02-09​

    REST API​

    2023-01-19​

    REST API​

    WebSocket API​

    • 持倉
      • 組合保證金模式下, positionIM, positionMM, leverage, riskLimitValue 返回 "", riskId 返回 0
    • 錢包
      • 組合保證金模式下, totalOrderIM, totalPositionIM, totoalPositionMM 返回 ""

    2023-01-16​

    REST API​

    • 查詢最新行情信息 [現貨]
      • usdIndexPrice 已經添加到響應體中. 該字段表示為USD指數價格, 可以為空。

    WebSocket API​

    • 行情 [現貨]
      • usdIndexPrice 已經添加到推送中. 該字段表示為USD指數價格, 可以為空。
    • 深度 [正向合約以及反向合約]
      • 增加500檔的推送，頻率為100ms

    2023-01-09​

    WebSocket API​

    • 行情 [正向合約以及反向合約]
      - `nextFundingTime` 從日期 `2023-01-05T08:00:00Z` 變動為UTC時間戳(毫秒) `1672905600000`
      - `predicatedFundingRate` 從消息中移除
      ��
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/account/transfer-list.html b/zh-TW/copy-trade/account/transfer-list.html index 64de73f76f..be2e5cf37b 100644 --- a/zh-TW/copy-trade/account/transfer-list.html +++ b/zh-TW/copy-trade/account/transfer-list.html @@ -4,13 +4,13 @@ 查詢劃轉紀錄 | Bybit API Documentation - +

    查詢劃轉紀錄

    查詢帶單錢包的劃轉紀錄

    提示

    需要: 錢包 - "帳戶劃轉" 權限

    HTTP Request​

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

    請求參數​

    參數是否必須類型說明
    transferIdfalsestring劃轉ID
    coinfalsestring幣種名稱
    statusfalsestring劃轉狀態. 不傳，默認查全部
    copyTradeTypefalseinteger帶單類型. 0: 所有, 1: 合約帶單, 2 (暫不支持): 現貨帶單
    startTimefalseinteger開始時間戳 (毫秒). 不傳，默認查詢過去30天
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    返回參數​

    參數類型說明
    listarrayObject
    > transferIdstring劃轉ID
    > coinstring幣種名稱
    > amountstring金額
    > fromAccountTypestring劃出錢包
    > toAccountTypestring劃入錢包
    > timestampstring劃轉時間戳 (毫秒)
    > statusstring劃轉狀態
    > copyTradeTypeinteger帶單類型. 1: 合約帶單, 2 (暫不支持): 現貨帶單
    nextPageCursorstring游標, 用於翻頁

    請求示例​

    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

    響應示例​

    {
        "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
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/account/transfer.html b/zh-TW/copy-trade/account/transfer.html index 67581a5d54..76beaa3fa3 100644 --- a/zh-TW/copy-trade/account/transfer.html +++ b/zh-TW/copy-trade/account/transfer.html @@ -4,13 +4,13 @@ 交易員劃轉資金 | Bybit API Documentation - +

    交易員劃轉資金

    交易員劃轉資金

    HTTP 請求​

    POST /contract/v3/private/copytrading/wallet/transfer

    請求參數​

    參數是否必須類型說明
    transferIdtruestringUUID,全局唯一
    cointruestring幣種類型. 僅USDT
    amounttruestring兌入數量
    fromAccountTypetruestringfrom賬戶類型
    toAccountTypetruestringTo賬戶類型

    返回參數​

    參數類型說明
    transferIdstringUUID,全局唯一

    請求示例​

    POST /contract/v3/private/copytrading/wallet/transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673257786588
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 173

    {
        "transferId": "5f95de08-b10f-43be-9746-7b95c4a37d307",
        "coin": "USDT",
        "amount": "500",
        "fromAccountType": "UNIFIED",
        "toAccountType": "COPYTRADING"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "transferId": "5f95de08-b10f-43be-9746-7b95c4a37d307"
        },
        "retExtInfo": {},
        "time": 1673258002526
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/account/wallet.html b/zh-TW/copy-trade/account/wallet.html index e05cd3f374..f1bc8ec6d7 100644 --- a/zh-TW/copy-trade/account/wallet.html +++ b/zh-TW/copy-trade/account/wallet.html @@ -4,13 +4,13 @@ 交易員獲取錢包余額 | Bybit API Documentation - +

    交易員獲取錢包余額

    交易員獲取跟單帳戶的錢包余額

    HTTP 請求​

    GET /contract/v3/private/copytrading/wallet/balance

    請求參數​

    無

    返回參數​

    參數類型說明
    coinstring幣種類型
    equitystring用戶資產 (wallet_balance + unrealised_pnl)
    availableBalancestring可用余額 = wallet balance - used margin
    usedMarginstring已用保證金
    orderMarginstring委托預占用保證金
    positionMarginstring倉位保證金
    walletBalancestring錢包余額
    realisedPnlstring當日已結盈虧
    unrealisedPnlstring未結盈虧
    cumRealisedPnlstring累計已結盈虧

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/contract/v3/private/copytrading/wallet/balance' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670841373442' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "availableBalance": "985.4988359",
            "usedMargin": "0",
            "orderMargin": "0",
            "positionMargin": "0",
            "walletBalance": "985.4988359",
            "realisedPnl": "0",
            "unrealisedPnl": "0",
            "cumRealisedPnl": "-14.5011641",
            "coin": "USDT",
            "equity": "985.4988359"
        },
        "retExtInfo": {},
        "time": 1673257786956
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/enum.html b/zh-TW/copy-trade/enum.html index b9311e0456..b1ffb3e8a2 100644 --- a/zh-TW/copy-trade/enum.html +++ b/zh-TW/copy-trade/enum.html @@ -4,13 +4,13 @@ 枚舉定義 | Bybit API Documentation - +

    枚舉定義

    accountType​

    • UNIFIED 統一帳戶
    • CONTRACT 期貨帳戶
    • COPYTRADING 跟單帳戶

    transferStatus​

    • SUCCESS
    • PENDING
    • FAILED

    symbol​

    跟單交易僅支持USDT永續

    • BTCUSDT
    • ETHUSDT
    • SOLUSDT
    • ...

    orderType​

    • Market
    • Limit

    execType​

    triggerBy​

    • LastPrice
    • IndexPrice
    • MarkPrice

    lastLiquidityInd​

    • AddedLiquidity 增加流動性
    • RemovedLiquidity 吃流動性
    • LiquidityIndNA 不存在流動性變化

    copyTradeOrderStatus​

    • UNKNOWN
    • PendingNew
    • New
    • OpenOrderPartiallyFilled
    • OpenOrderFilled
    • OpenOrderClosing
    • OpenOrderClosedFilled
    • CloseOrderPartiallyFilled
    • CloseOrderFilled
    • Cancelled
    • Untriggered
    • Triggered

    timeInForce​

    • GoodTillCancel
    • ImmediateOrCancel
    • FillOrKill
    • PostOnly

    positionIdx​

    • 0 單向持倉
    • 1 買側的雙向持倉
    • 2 賣側的雙向持倉

    interval​

    • 1 3 5 15 30 60 120 240 360 720 分鐘
    • D 天
    • W 週
    • M 月

    tickDirection​

    • PlusTick 價格上漲
    • ZeroPlusTick 交易的價格與前一筆交易的價格相同，前一筆交易的價格高於前一筆交易的價格
    • MinusTick 價格下跌
    • ZeroMinusTick 交易的價格與前一筆交易的價格相同，前一筆交易的價格低於前一筆交易的價格
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/error.html b/zh-TW/copy-trade/error.html index af9e5fec5f..eab6e700bb 100644 --- a/zh-TW/copy-trade/error.html +++ b/zh-TW/copy-trade/error.html @@ -4,13 +4,13 @@ 錯誤碼 | Bybit API Documentation - +

    錯誤碼

    錯誤碼描述
    10000處理請求時發生未知錯誤。
    10001傳遞給API的值有問題。
    10002請求未授權-API金鑰是必需的，應包含在所有請求中。
    10003無效的api金鑰
    10004無效的symbol
    10005當前apikey的許可權被拒絕。 API金鑰是在沒有正確許可權的情况下創建的（例如，沒有Order許可權，或設定為只讀）
    10006訪問次數太多。 參攷API速率限制。 請使用WebSocket進行即時更新。 當前限制為每分鐘%s個請求。
    10007後端服務器的響應超時。 傳遞和請求狀態未知。
    10010請求IP不匹配。
    10012資料庫錯誤
    10014不支持交易對。
    10015新訂單太多。 請降低請求頻率。
    10016服務不可用。
    10017未找到請求路徑或請求方法無效
    10018超過IP速率限制。
    10020不支持請求。
    10021請求的時間戳記在recvWindow之外。 此請求的時間戳記比服務器時間早1000毫秒。 請檢查本地時間和服務器時間。
    10022請求簽名無效。
    11000不支持參數字元。
    11001為此終結點發送的參數太多。
    11002未發送所需參數。 參數為空/null或格式不正確。
    11003發送了未知參數。
    11004未讀取發送的所有參數。
    11005空參數。
    11006不再需要時發送了參數。
    11011訂單價格超過上限。
    11012交易對不存在。
    11014不需要時發送TimeInForce參數。
    11015timeInForce無效。
    11016orderType無效。
    11017方向無效。
    11018用戶生成的訂單ID為空。
    11019用戶生成的訂單ID為空。
    11020間隔無效。
    11021無效symbol。
    11025listenKey不存在。
    11027査詢間隔太大。
    11028參數組合無效。
    11030發送的參數無效。
    11031餘額不足。
    11032訂單價格超過上限。
    11033訂單價格超過下限。
    11034訂單價格小數位數太多。
    11035訂單數量超過上限。
    11036訂單數量超過下限。
    11037訂單數量的小數位數太多。
    11038訂單價格超出限制。
    11039訂單已完成。
    11040訂單值超過下限。
    11041clientOrderId重複。
    11042訂單已取消。
    11043未找到訂單。
    11044訂單被取消。 不支持操作。
    11045無法取消訂單。
    11046訂單創建超時。
    11047訂單取消超時。
    11090取消訂單已完成。
    11091無法取消訂單，請稍後再試。
    20001訂單不存在。
    20003缺少參數side
    20004無效參數side
    20005缺少參數symbol
    20006無效參數symbol
    20007缺少參數order_type
    20008無效參數order_type
    20009缺少參數數量
    20010新訂單被拒絕。
    20011取消被拒絕。
    20012數量必須大於零且小於100萬
    20013訂單不存在。
    20014API金鑰格式無效。
    20015API金鑰或IP無效。
    20016當前對的交易視窗尚未打開。
    20017缺少參數order_id
    20018無效的日期格式
    20019缺少參數stop_px
    20020缺少參數base_price
    20021缺少參數stop_order_id
    20022缺少參數杠杆
    20023杠杆必須是一個數位
    20031杠杆率必須大於零
    20070缺少參數margin
    20071margin必須大於零
    20084需要＜code＞order_id＜/code＞或＜code＞order_link_id＜/code＞
    20094order_link_id不是唯一的。
    30002退出訂單已存在。
    30003qty必須高於允許的最小值。
    30004qty必須高於允許的最小值。 合約數量超過了允許的最大限制。 每個訂單的訂單數量應少於100萬。
    30005訂單價格超出允許範圍。
    30006否last_price。
    30007訂單價格超出允許範圍。
    30008無效的order_type。
    30009找不到倉位。
    30010錢包餘額不足。
    30011由於頭寸正在清算，囙此不允許操作
    30012由於倉位正在進行ADL，囙此不允許操作
    30013倉位處於liq或adl狀態
    30014關閉訂單無效，數量不應大於大小。
    30015關閉順序無效，一側應相反。
    30016關閉倉位前必須取消TP和SL。
    30017估計填充價格不能低於當前購買liq_price。
    30018估計填充價格不能高於當前的賣出liq_price。
    30019下非開放倉位訂單時，無法為非零倉位附加TP/SL參數。
    30020倉位已具有TP/SL參數。
    30021無法提供估計的position_margin。
    30022估計買入liq_price不能高於當前mark_price。
    30023預計銷售價格不能低於當前價格。
    30024無法為零倉位設定TP/SL/TS
    30025觸發價格應大於上次價格的10%。
    30026價格太高。
    30027為獲利設定的價格應高於上次交易價格。
    30028止損價格應介於清算價格和最後交易價格之間。
    30029止損價格應介於最後交易價格和清算價格之間。
    30030為Take Profit設定的價格應低於上次交易價格。
    30031訂單成本可用餘額不足。
    30032訂單已填寫或取消。
    30033停止訂單的數量超過了允許的最大限制。
    30034未找到停止訂單。
    30035取消太快，請稍後再試。
    30036訂單執行後的預期倉位值超過當前風險限額
    30037訂單已取消
    30038無標記價格。
    30039施加的杠杆已超出允許範圍。
    30040所做的任何調整都將引發立即清算。
    30041找不到倉位。
    30042錢包餘額不足。
    30043由於頭寸正在清算，囙此不允許操作。
    30044不允許操作，因為倉位正在進行ADL。
    30045由於倉位不在正常狀態，不允許操作。
    30046有多個未觸發的止損單。
    30047p:o不一致。
    30048施加的杠杆已超出允許範圍。
    30049可用餘額不足。
    30050所做的任何調整都將引發立即清算！
    30051由於風險限制，無法調整杠杆。
    30052杠杆率不能低於1倍。
    30053max_affordable_position_bmargin<=0，倉位：%s
    30054fixed_new_position_margin無效。
    30055可用餘額不足以新增保證金。
    30056倉位在cross_margin中。
    30057請求的合約數量超過了風險限額，請在重試之前調整您的風險限額級別。
    30063不滿足僅减少規則
    30066設定自動添加保證金失敗。
    30067可用餘額不足。
    30068退出值必須為正。
    30073活動訂單數大於500。
    30074無法創建止損單，因為您希望當LastPrice（或IndexPrice, MarkPrice]，由trigger_by確定）上升到stop_px時觸發止損單，但LastPrice（或IndexPrice，MarkPrice）已等於或大於stop_px， 請調整base_price或stop_px
    30075無法創建止損單，因為您希望當LastPrice（或IndexPrice,MarkPrice]，由trigger_by確定）降至stop_px時觸發止損單，但LastPrice（或IndexPrice，MarkPrice）已等於或小於stop_px， 請調整base_price或stop_px
    30076替換參數無效。 訂單未修改。
    30077根據公開利益，提交訂單將導致違反用戶限制。
    30078非交易狀態的合約
    30079該頭寸即將引發清算
    30080價格不能低於當前購買liq_Price
    30081價格不能大於當前銷售價格
    30082倉位存在不允許切換倉位模式
    30083倉位模式無變化
    30084未更改每個倉位的完整倉位模型
    30085保證金不變
    30086對於委託訂單，不允許切換倉位模式
    30087symbol不支持雙向打開倉位
    30088symbol不存在
    30089重複訂單號
    30090風險限額資訊不存在
    30091非法訂單（意味著訂單在各種情况下都不合法）
    30092不允許任何倉位設定保證金
    30093無淨頭寸
    30094在清算未結束前撤回命令
    30095不允許滿倉修改杠杆
    31003使用者帳戶被禁用
    32006可用餘額不足以支付手續費。
    32008可用保證金不足。
    32009所做的任何調整都將引發立即清算。
    32010由於可用保證金不足，無法調整風險限額。
    32011由於當前/預期持倉價值超過修訂後的風險限額，囙此無法調整風險限額。
    33004apikey已過期
    34010錢包餘額小於零。
    34015無法設定新杠杆，因為它等於以前的杠杆。
    34017當前杠杆率小於1X
    34018無法將杠杆設定為低於1X
    34019不能將杠杆設定為大於maxLeverage。
    34020無法設定與先前杠杆相同的杠杆。
    34021無法取消occ_calc_data，數據錯誤。
    34022無法設定將導致可用餘額小於0的杠杆。
    34023請求已取消，因為源請求已處理。
    34024請求不包括添加保證金數據。
    34025杠杆率的新增失敗了。
    34026新限制等於舊限制（無變化）。
    34027無法調整杠杆。
    34028重新計算資金費用失敗。
    34030positionInfo與當前exec_rpt不同步。
    34032撤回時PositionSeq不匹配。
    34033已實現PNL已旋轉。
    34035添加未修改的保證金。
    34036未修改設定杠杆。
    34037設定未修改的自定義費率。
    34038更新未修改的去杠杆名額。
    34039更新倉位狀態未修改。
    34040設定TP/SL/TS未修改。
    35014超過未結利息。
    37001兩側倉位tp_sl_mode相等。
    37002相同的tp_sl_mode。
    37003此倉位至少有一個止損連結訂單，無法在止損和獲利模式之間切換。
    37004此倉位至少有一個止損連結訂單，無法在止損和獲利模式之間切換。
    37005此倉位至少有一個尾隨止損或尾隨止損連結訂單，無法切換為獲利止損模式。
    37006有條件或限制訂單帶有獲利和止損參數
    37007剩餘倉位數量不足，無法設定止損和獲利
    37008活動訂單在修改觸發價格時不允許修改價格和數量
    37009如果訂單已部分完成，則不允許活動訂單修改止損和獲利設定
    37010在完全獲利止損模式下，不允許修改止盈止損大小
    37011在部分SL模式下，SL設定為大於20。 設定SL/TP超過限制oldTpNum+oldStNum+newNum=（2，num為TP+SL）
    37012止損價格必須大於基本價格。
    37013止損價格必須低於基本價格。
    38101根據公開利益，更換訂單將導致違反用戶限制。
    90015餘額不足
    90016被風險控制拒絕。 轉讓後可能導致清算。
    90063正在進行清算
    90066在對賬中
    90067對賬失敗
    131200服務器錯誤
    131201Biz err
    131212用戶餘額不足
    131217風險檢查錯誤
    131203請求參數錯誤
    131204帳戶資訊錯誤
    131206無法傳輸
    131214transferId存在
    131215金額誤差
    131216查詢餘額錯誤
    131218統一轉出風險，用戶的頭寸目前處於強制清算狀態
    131219統一轉出風險，轉出預警
    131220統一轉出風險，轉出無息貸款限額預警
    131221統一轉出風險，轉出預警
    131222統一轉出風險，對賬檢查失敗
    131223統一轉出風險，拒絕
    131224統一轉出風險，餘額不足
    131225不支持的統一狀態
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/position/close-position.html b/zh-TW/copy-trade/position/close-position.html index f18dbe280d..16aeb590b9 100644 --- a/zh-TW/copy-trade/position/close-position.html +++ b/zh-TW/copy-trade/position/close-position.html @@ -4,13 +4,13 @@ 交易員一鍵平倉 | Bybit API Documentation - +

    交易員一鍵平倉

    HTTP 請求​

    GET /contract/v3/private/copytrading/position/close

    請求參數​

    參數是否必須類型說明
    symboltruestring合約類型
    positionIdxtruestringPosition idx, 用於在不同倉位模式下標識倉位：0-單向持倉; 1-雙向持倉Buy; 2-雙向持倉Sell

    返回參數​

    無

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/position/close' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670841189767' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{"symbol":"BTCUSDT","positionIdx":"1"}'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1670841190031
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/position/execution-list.html b/zh-TW/copy-trade/position/execution-list.html index b5b001a842..7dc39b2e51 100644 --- a/zh-TW/copy-trade/position/execution-list.html +++ b/zh-TW/copy-trade/position/execution-list.html @@ -4,13 +4,13 @@ 查詢成交紀錄 (兩年) | Bybit API Documentation - +

    查詢成交紀錄 (兩年)

    獲取用戶成交紀錄，返回結果按execTime降序排列

    提示

    單筆訂單可能會有多次成交

    HTTP 請求​

    GET /contract/v3/private/copytrading/execution/list

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    orderIdfalsestring訂單ID
    orderLinkIdfalsestring用戶自定義訂單iD
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    execTypefalsestring成交類型
    limitfalseinteger每頁數量限制. [1, 100]. default: 50
    cursorfalsestring游標，用於翻頁，需要對返回的游標字符串進行urlencode

    響應參數​

    參數類型說明
    nextPageCursorstring游標，用於翻頁
    listarrayObject
    > symbolstring合約名稱
    > sidestringBuy,Sell
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義訂單iD
    > orderPricestring訂單價格
    > orderQtystring訂單數量
    > orderTypestring訂單類型. 市價單: Market,限價單: Limit
    > execFeestring交易手續費
    > execIdstring成交Id
    > execPricestring成交價格
    > execQtystring成交數量
    > execTypestring交易類型
    > execValuestring成交價值
    > feeRatestring手續費率
    > lastLiquidityIndstring流動性類型. AddedLiquidity, RemovedLiquidity, LiquidityIndNA
    > isMakerboolean是否是maker單
    > leavesQtystring剩餘委託未成交價值
    > closedSizestring平倉數量
    > markPricestring成交執行時，該 symbol 當時的標記價格
    > execTimestring成交時間（毫秒）

    請求示例​

    GET /contract/v3/private/copytrading/execution/list?symbol=XRPUSDT&execType=Funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1678788154878
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "nextPageCursor": "0o+MpbbRsIrLhRXdulAiDPRZFkidzCCKmEOQR4TzFIYyq1tofpJ/bOX92Vn8uwRBSEUuSxC/9jnLZs7oFLgcMQ==",
            "list": [
                {
                    "symbol": "XRPUSDT",
                    "side": "Buy",
                    "orderId": "1678780800-XRPUSDT-1019213-Buy",
                    "orderLinkId": "",
                    "orderPrice": "0.0000",
                    "orderQty": "0",
                    "orderType": "UNKNOWN",
                    "execFee": "0.003679",
                    "execId": "73729a92-caf5-4911-8e85-5194dd2ee1c5",
                    "execPrice": "0.3679",
                    "execQty": "100",
                    "execType": "Funding",
                    "execValue": "36.79",
                    "feeRate": "0.0001",
                    "lastLiquidityInd": "LiquidityIndNA",
                    "isMaker": false,
                    "leavesQty": "0",
                    "closedSize": "0",
                    "markPrice": "0.3679",
                    "execTime": "1678780800000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1678788155282
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/position/leverage.html b/zh-TW/copy-trade/position/leverage.html index 92501b3d95..b1bbb94b04 100644 --- a/zh-TW/copy-trade/position/leverage.html +++ b/zh-TW/copy-trade/position/leverage.html @@ -4,13 +4,13 @@ 交易員設置帶單槓桿 | Bybit API Documentation - +

    交易員設置帶單槓桿

    交易員設置帶單槓桿, 設置槓桿只能設置整數

    HTTP 請求​

    GET /contract/v3/private/copytrading/position/set-leverage

    請求參數​

    參數是否必須類型說明
    symboltruestring合約類型
    buyLeveragetruestring全倉/逐倉切換，需要傳杠桿並且buy_leverage和sell_leverage必須傳入相同參數。
    sellLeveragetruestring全倉/逐倉切換，需要傳杠桿並且buy_leverage和sell_leverage必須傳入相同參數。

    返回參數​

    無

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/position/set-leverage' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670841373442' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{"symbol":"BTCUSDT","buyLeverage":"4","sellLeverage":"4"}'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1670841190031
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/position/position-info.html b/zh-TW/copy-trade/position/position-info.html index 05f7717a68..5feee0f678 100644 --- a/zh-TW/copy-trade/position/position-info.html +++ b/zh-TW/copy-trade/position/position-info.html @@ -4,13 +4,13 @@ 交易員帶單倉位匯總 | Bybit API Documentation - +

    交易員帶單倉位匯總

    交易員帶單倉位匯總

    HTTP 請求​

    GET /contract/v3/private/copytrading/position/list

    請求示例​

    參數是否必須類型說明
    symbolfalsestring合約類型

    響應示例​

    參數類型說明
    listarrayObject
    > symbolstring合約類型
    > sidestring方向
    > sizestring倉位數量
    > positionValuestring倉位價值
    > entryPricestring平均入場價
    > liqPricestring強平價格
    > bustPricestring破產價格
    > markPricestring標記價格
    > leveragestring逐倉模式下, 值為用戶設置的杠桿；全倉模式下，值為當前風險限額下最大杠桿
    > isIsolatedboolean是否逐倉，true-逐倉 false-全倉
    > positionMarginstring倉位保證金
    > occClosingFeestring倉位占用的平倉手續費
    > occFundingFeestring倉位size和當前資金費率預占用資金費用
    > cumRealisedPnlstring累計已結盈虧
    > freeQtystring可平倉位數量（如果您有多頭頭寸，free_qty 為負數。反之亦然）
    > unrealisedPnlstring未結盈虧
    > positionIdxstring倉位標識, 用於在不同倉位模式下標識倉位：0-單向持倉; 1-雙向持倉Buy; 2-雙向持倉Sell
    > createdTimestring創建時間
    > updatedTimestring更新時間

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/contract/v3/private/copytrading/position/list' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670831398044' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "symbol": "ETHUSDT",
                    "side": "Sell",
                    "size": "0.02",
                    "positionValue": "25.2665",
                    "entryPrice": "1263.325",
                    "liqPrice": "1383.30",
                    "bustPrice": "1389.65",
                    "markPrice": "1254.60",
                    "leverage": "10",
                    "isIsolated": true,
                    "positionMargin": "2.52665009",
                    "occClosingFee": "0.0166758",
                    "occFundingFee": "0",
                    "cumRealisedPnl": "132.46751301",
                    "freeQty": "0.02",
                    "unrealisedPnl": "0.1745",
                    "positionIdx": "2",
                    "createdTime": "1652324549816",
                    "updatedTime": "1670841190027"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1670841190031
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/rate-limit.html b/zh-TW/copy-trade/rate-limit.html index cb5cc2dd4b..5628b12c32 100644 --- a/zh-TW/copy-trade/rate-limit.html +++ b/zh-TW/copy-trade/rate-limit.html @@ -4,14 +4,14 @@ 頻率限制 | Bybit API Documentation - +

    頻率限制

    IP限頻​

    警告

    如果您收到HTTP 403（拒絕訪問）響應, 您的 IP 已被暫時或永久禁止。 您應立即查看以下指南，以確保您的應用程序不會繼續違反限制。如果您在 30 分鐘後 仍被禁止，則您可能會被永久禁止。

    我們不建議您在這些限制的邊緣運行您的應用程序，以防異常的網絡活動導致意外違規。

    • GET/POST 請求 (共享):
      • 連續 5 秒內每秒不超過 120 個請求
    備註

    所有到api.bybit.com或api.bytick.com的流量共享此限制，無論是訪問現貨、期貨還是期權。

    違反限制後，您的 IP 將被禁止一段時間（通常為 30 分鐘）。 持續違反限制將導致永久禁止。 我們不能撤銷永久禁令或縮短臨時禁令。

    賬戶頻率限製​

    警告

    如果您收到這樣的響應"ret_msg": "Too many visits!", 則表示您觸發了帳戶頻率限制, 請等到頻率限制重置以後, 再繼續發送請求。

    Bybit基於每分鍾的滾動時間窗口來做頻率限製，並且是按賬戶（uid）來做劃分限製，每次請求API響應頭(response header)中都會包含如下字段：

    • X-Bapi-Limit-Status - 該接口當前時間窗口剩余可用請求數
    • X-Bapi-Limit - 該接口當前頻率限製上限
    • X-Bapi-Limit-Reset-Timestamp - 如果您已超過該接口當前窗口頻率限製，該字段表示下個可用時間窗口的時間戳（毫秒），即什麽時候可以恢復訪問；如果您未超過該接口當前窗口頻率限製，該字段表示返回的是當前服務器時間（毫秒).

    Http 響應頭示例

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    接口頻率限制表​

    路徑頻率消費
    /contract/v3/private/copytrading/position/set-leverage75 req/min1/request
    /contract/v3/private/copytrading/position/close1/request
    /contract/v3/private/copytrading/position/list1/request
    /contract/v3/private/copytrading/order/create100 req/min1/request
    /contract/v3/private/copytrading/order/close1/request
    /contract/v3/private/copytrading/order/cancel1/request
    /contract/v3/private/copytrading/order/list 1/request
    /contract/v3/private/copytrading/wallet/balance120 req/min1/request
    /contract/v3/private/copytrading/wallet/transfer1/request

    如何提高頻率限製​

    請發送郵件到 api@bybit.com，我們會在 1-4 個工作日內答復。郵件內容必須包含以下內容：

    1. 您的姓名和公司名稱和簡介
    2. 您的bybit 賬號uid或註冊郵箱手機號,以及您要申請提頻的交易對
    3. 您上個月的交易量（吃單/掛單）並提供截圖
    4. 簡單介紹您的交易策略和為什麽需要更高限頻
    5. 如果可以，請提供您的成交記錄csv文檔
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/trade/cancel.html b/zh-TW/copy-trade/trade/cancel.html index 9d0781abef..39a31e2e9f 100644 --- a/zh-TW/copy-trade/trade/cancel.html +++ b/zh-TW/copy-trade/trade/cancel.html @@ -4,13 +4,13 @@ 交易員取消訂單 | Bybit API Documentation - +

    交易員取消訂單

    交易員取消訂單

    HTTP 請求​

    POST /contract/v3/private/copytrading/order/cancel

    請求參數​

    參數是否必須類型說明
    symboltruestring合約類型
    orderIdfalsestring訂單ID. orderId和orderLinkId二者必傳一個
    orderLinkIdfalsestring自定義機構ID. orderId和orderLinkId二者必傳一個

    返回參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/order/cancel' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670831398044' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{"orderId": "a4f60d8d-2957-46cb-9fff-126367e7fdc6"}'

    響應示例​

    {
      "retCode": 0,
        "retMsg": "success",
        "result": {
            "orderId": "419190fe-016c-469a-810e-936bef2f5d59",
            "orderLinkId": ""
          }
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/trade/close-order.html b/zh-TW/copy-trade/trade/close-order.html index ad0745825f..b7e4b93ff3 100644 --- a/zh-TW/copy-trade/trade/close-order.html +++ b/zh-TW/copy-trade/trade/close-order.html @@ -4,13 +4,13 @@ 交易員發起平倉-訂單 | Bybit API Documentation - +

    交易員發起平倉-訂單

    交易員發起平倉-訂單

    HTTP 請求​

    POST /contract/v3/private/copytrading/order/close

    請求參數​

    參數是否必須類型說明
    symboltruestring合約類型
    orderLinkIdfalsestring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復
    parentOrderIdfalsestring訂單ID。如果未填parentOrderLinkId, 則該字段為必填
    parentOrderLinkIdfalsestring機構ID。如果未填parentOrderId, 則該字段為必填

    返回參數​

    參數類型說明
    orderIdstring用戶ID
    orderLinkIdstring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/order/close' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670831398044' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{"symbol":"BTCUSDT","parentOrderId":"cf252fd5-f25f-4623-9080-c60201b22575"}'

    響應示例​

    {
      "retCode": 0,
        "retMsg": "success",
        "result": {
        "orderId": "419190fe-016c-469a-810e-936bef2f5d59",
        "orderLinkId": ""
      }
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/trade/create-order.html b/zh-TW/copy-trade/trade/create-order.html index 84bcdeb436..0023e6622e 100644 --- a/zh-TW/copy-trade/trade/create-order.html +++ b/zh-TW/copy-trade/trade/create-order.html @@ -4,13 +4,13 @@ 交易員創建訂單 | Bybit API Documentation - +

    交易員創建訂單

    交易員創建訂單

    HTTP 請求​

    POST /contract/v3/private/copytrading/order/create

    請求參數​

    參數是否必須類型說明
    sidetruestring方向
    symboltruestring合約類型
    orderTypetruestring委托單價格類型
    qtytruestring委托數量
    pricefalsestring委托價格
    takeProfitfalsestring止盈價格
    stopLossfalsestring止損價格
    tpTriggerByfalsestring止盈激活價格類型，默認為LastPrice
    slTriggerByfalsestring止損激活價格類型，默認為LastPrice
    orderLinkIdfalsestring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復

    返回參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/contract/v3/private/copytrading/order/create' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1670831398044' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json; charset=utf-8' \
    --data-raw '{"side":"Sell","symbol":"BTCUSDT","orderType":"Limit","qty":"0.001","price":"20000","takeProfit":"0","stopLoss":"0","tpTriggerBy":"LastPrice","slTriggerBy":"LastPrice"}'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "orderId": "419190fe-016c-469a-810e-936bef2f5d59",
            "orderLinkId": "234590fe-016c-44f6-fg78"
          }
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/trade/get-order.html b/zh-TW/copy-trade/trade/get-order.html index 7dae736240..72e470c326 100644 --- a/zh-TW/copy-trade/trade/get-order.html +++ b/zh-TW/copy-trade/trade/get-order.html @@ -4,13 +4,13 @@ 查詢交易員歷史帶單訂單 | Bybit API Documentation - +

    查詢交易員歷史帶單訂單

    查詢交易員帶單訂單

    HTTP 請求​

    GET /contract/v3/private/copytrading/order/list

    請求參數​

    參數是否必須類型說明
    symbolfalsestring合約類型
    orderIdfalsestring訂單ID
    orderLinkIdfalsestring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復
    copyTradeOrderTypefalsestring跟單交易委托單類型

    返回參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復
    symbolstring合約類型
    sidestring方向
    pricestring委托價格
    qtystring委托數量
    timeInForcestring執行策略
    isIsolatedboolean是否逐倉，true-逐倉 false-全倉
    leveragestring逐倉模式下, 值為用戶設置的杠桿；全倉模式下，值為當前風險限額下最大杠桿
    copyTradeOrderStatusstring跟單交易記錄類型
    leavesQtystring剩余委托數量
    leavesValuestring剩余掛單數量對應的預估價值
    cumExecValuestring累計成交價值
    cumExecFeestring累計成交手續費
    takeProfitstring止盈價格
    stopLossstring止損價格
    tpTriggerBystring止盈激活價格類型，默認為LastPrice
    slTriggerBystring止損激活價格類型，默認為LastPrice
    createdTimestring創建時間 (毫秒)
    updatedTimestring更新時間 (毫秒)

    請求示例​

    curl "https://api-testnet.bybit.com/contract/v3/private/copytrading/order/list?api_key={api_key}&timestamp={timestamp}&sign={sign}&symbol=ETHUSDT"

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "orderId": "ae0700f6-c990-4de5-9d6e-0fdf8d5aabea",
                    "symbol": "ETHUSDT",
                    "orderLinkId": "234500f6-c45f-4de5-9d6e",
                    "side": "Sell",
                    "copyTradeOrderStatus": "New",
                    "price": "4000.00",
                    "qty": "5.55",
                    "timeInForce": "GoodTillCancel",
                    "leavesQty": "5.55",
                    "isIsolated": true,
                    "leavesValue": "22200",
                    "leverage": "44",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "createdTime": "1652216213331",
                    "updatedTime": "1652216213365"
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/trade/trading-stop.html b/zh-TW/copy-trade/trade/trading-stop.html index 7771882c7f..ed3a65e71c 100644 --- a/zh-TW/copy-trade/trade/trading-stop.html +++ b/zh-TW/copy-trade/trade/trading-stop.html @@ -4,13 +4,13 @@ 設置止盈止損 | Bybit API Documentation - +

    設置止盈止損

    設置止盈止損

    HTTP 請求​

    POST /contract/v3/private/copytrading/order/trading-stop

    請求參數​

    參數是否必須類型說明
    symboltruestring合約類型
    parentOrderIdtruestring母訂單Id
    takeProfitfalsestring止盈觸發價格. 傳 0, 表示清除止盈設置; 傳"", 表示不做修改
    stopLossfalsestring止損觸發價格. 傳 0, 表示清除止損設置; 傳"", 表示不做修改
    tpTriggerByfalsestring止盈激活價格類型，默認為LastPrice
    slTriggerByfalsestring止損激活價格類型，默認為LastPrice
    parentOrderLinkIdfalsestring母訂單orderLinkID

    返回參數​

    參數類型說明

    請求示例​

    curl --location --request POST 'https://api.bybit.com/contract/v3/private/copytrading/order/trading-stop' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662026807816' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "symbol": "BTCUSDT",
        "parentOrderId": "XXXXXXXX",
        "takeProfit": "0",
        "stopLoss": "0",
        "tpTriggerBy": "MarkPrice",
        "slTriggerBy": "LastPrice",
        "parentOrderLinkId": "XXXXXXXX"
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {}
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-private/execution.html b/zh-TW/copy-trade/ws-private/execution.html index cc3285fe51..b531093019 100644 --- a/zh-TW/copy-trade/ws-private/execution.html +++ b/zh-TW/copy-trade/ws-private/execution.html @@ -4,14 +4,14 @@ 成交 | Bybit API Documentation - +

    成交

    Topic:
    copyTradeExecution

    返回參數​

    ParameterTypeComments
    orderIdstring訂單ID
    orderLinkIdstring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復
    symbolstring合約類型
    sidestring方向
    execIdstring成交ID
    execQtystring成交數量
    execTypestring交易類型(不能為"Funding")
    execFeestring交易手續費
    pricestring成交價格
    orderQtystring訂單數量
    tradeTimenumber交易時間

    請求訂閱​

    ws.send('{"op": "subscribe", "args": ["copyTradeExecution"]}')

    響應示例​

    {
        "topic": "copyTradeExecution",
        "data": [
            {
                "orderId": "6d667921-3cf4-4efd-b93f-727bd10a3b62",
                "orderLinkId": "w11a313223ddd132111",
                "symbol": "ETHUSDT",
                "side": "Sell",
                "execId": "0182b08b-a3ce-5038-a8be-5e1e9f862e90",
                "execQty": "0.010000",
                "execType": "Trade",
                "execFee": "0.01175970",
                "price": "1863.250000",
                "orderQty": "0.010000",
                "tradeTime": 1652932133873
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-private/order.html b/zh-TW/copy-trade/ws-private/order.html index 00580f5ae7..8f37e7bb48 100644 --- a/zh-TW/copy-trade/ws-private/order.html +++ b/zh-TW/copy-trade/ws-private/order.html @@ -4,14 +4,14 @@ 訂單 | Bybit API Documentation - +

    訂單

    Topic:
    copyTradeOrder

    返回參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring機構自定義訂單ID, 最大長度36位，且同一機構下自定義ID不可重復
    symbolstring合約類型
    orderTypestring委托單下單類型
    pricestring委托價格
    qtystring成交數量
    sidestring方向
    positionIdxstringPosition idx, 用於在不同倉位模式下標識倉位：1-雙向持倉Buy; 2-雙向持倉Sell
    cumExecFeestring累計成交手續費
    cumExecValuestring累計成交價值
    lastExecPricestring最近一次成交價格
    cumExecQtystring累計成交數量
    takeProfitstring止盈價格
    stopLossstring止損價格
    tpTriggerBystring止盈激活價格類型，默認為LastPrice
    slTriggerBystring止損激活價格類型，默認為LastPrice
    createTimenumber委托時間
    updateTimenumber成交時間
    copyTradeOrderStatusstringcopy trade 訂單狀態

    請求訂閱​

    ws.send('{"op": "subscribe", "args": ["copyTradeOrder"]}')

    響應示例​

    {
        "topic": "copyTradeOrder",
        "data": [
            {
                "orderId": "6d667921-3cf4-4efd-b93f-727bd10a3b62",
                "orderLinkId": "w11a313223ddd132111",
                "symbol": "ETHUSDT",
                "orderType": "Market",
                "price": "1863.250000",
                "qty": "0.010000",
                "side": "Sell",
                "positionIdx": "2",
                "cumExecFee": "0.01175970",
                "cumExecValue": "19.59950000",
                "lastExecPrice": "1959.949951",
                "cumExecQty": "0.010000",
                "takeProfit": "1750",
                "stopLoss": "2000",
                "tpTriggerBy": "LastPrice",
                "slTriggerBy": "LastPrice",
                "createTime": 1652932133873,
                "updateTime": 1652932133892,
                "copyTradeOrderStatus": "OpenOrderFilled"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-private/position.html b/zh-TW/copy-trade/ws-private/position.html index 8489711596..6cf45a9c7c 100644 --- a/zh-TW/copy-trade/ws-private/position.html +++ b/zh-TW/copy-trade/ws-private/position.html @@ -4,14 +4,14 @@ 持倉 | Bybit API Documentation - +

    持倉

    Topic:
    copyTradePosition

    返回參數​

    參數類型說明
    symbolstring合約類型
    positionIdxstringPosition idx, 用於在不同倉位模式下標識倉位：1-雙向持倉Buy; 2-雙向持倉Sell
    positionValuestring倉位價值
    riskIdinteger風險限額ID
    leveragestring逐倉模式下, 值為用戶設置的杠桿
    isolatedboolean是否逐倉，true-逐倉 false-全倉
    sidestring方向
    sizestring倉位數量
    unrealisedPnlstring未結盈虧
    liqPricestring強平價格
    bustPricestring破產價格
    entryPricestring平均入場價
    positionMarginstring倉位保證金
    orderMarginstring委托預占用保證金
    occClosingFeestring倉位占用的平倉手續費
    cumRealisedPnlstring累計已結盈虧
    positionStatusstring倉位狀態，Normal: 正常，Liq: 強平，Adl: 減倉
    positionSeqnumber倉位變化版本號

    請求訂閱​

    ws.send('{"op": "subscribe", "args": ["copyTradePosition"]}')

    響應示例​

    {
        "topic": "copyTradePosition",
        "data": [
            {
                "symbol": "ETHUSDT",
                "positionIdx": "2",
                "positionValue": "80.05065626",
                "riskId": 11,
                "leverage": "10.000000",
                "isIsolated": true,
                "side": "Sell",
                "size": "0.040000",
                "unrealisedPnl": "1.62665626",
                "liqPrice": "2191.350098",
                "bustPrice": "2201.350098",
                "entryPrice": "2001.26640650",
                "positionMargin": "8.00506666",
                "orderMargin": "0.00000000",
                "occClosingFee": "0.05283240",
                "cumRealisedPnl": "0.55284374",
                "positionStatus": "Normal",
                "positionSeq": 0
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-private/wallet.html b/zh-TW/copy-trade/ws-private/wallet.html index 1d8fa79611..52b825ee42 100644 --- a/zh-TW/copy-trade/ws-private/wallet.html +++ b/zh-TW/copy-trade/ws-private/wallet.html @@ -4,14 +4,14 @@ 錢包 | Bybit API Documentation - +

    錢包

    Topic:
    copyTradeWallet

    返回參數​

    參數類型說明
    walletBalancenumber錢包余額
    availableBalancenumber可用余額 = wallet balance - used margin

    請求訂閱​

    ws.send('{"op": "subscribe", "args": ["copyTradeWallet"]}')

    響應示例​

    {
        "topic": "copyTradeWallet",
        "data": {
            "walletBalance": "14009.12164704",
            "availableBalance": "13998.97749271"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-public/kline.html b/zh-TW/copy-trade/ws-public/kline.html index f439a2f8d8..3ea26b6709 100644 --- a/zh-TW/copy-trade/ws-public/kline.html +++ b/zh-TW/copy-trade/ws-public/kline.html @@ -4,14 +4,14 @@ K線 | Bybit API Documentation - +

    K線

    訂閱K線數據

    可用時間粒度:

    • 1 3 5 15 30 60 120 240 360 720 分鐘
    • D 天
    • W 週
    • M 月
    信息

    註意如果字段confirm為true, 則表明這是這根K線的最後一個tick；否則，這只是一個快照數據，即中間價格

    推送頻率: 1-60s

    Topic: kline.{interval}.{symbol} e.g., kline.30.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > startnumber開始時間戳 (毫秒)
    > endnumber結束時間戳 (毫秒). 若時間還未到時間跨度的最後時間，則表示當前時間
    > intervalstringK線粒度
    > openstring開盤價
    > closestring收盤價
    > highstring最高價
    > lowstring最低價
    > volumestring交易量
    > turnoverstring交易額
    > confirmboolean是否確認
    > timestampnumber蠟燭中最後一筆淨值時間戳 (毫秒)

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
          "kline.5.BTCUSDT"
        ],
        "req_id": "test" // 可選
    }

    推送示例​

    {
        "topic": "kline.5.BTCUSDT",
        "data": [
            {
                "start": 1671187800000,
                "end": 1671188099999,
                "interval": "5",
                "open": "16991",
                "close": "16980.5",
                "high": "16991",
                "low": "16980.5",
                "volume": "2.501",
                "turnover": "42493.2305",
                "confirm": false,
                "timestamp": 1671187815755
            }
        ],
        "ts": 1671187815755,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-public/liquidation.html b/zh-TW/copy-trade/ws-public/liquidation.html index ccbfec3cb5..260b854e9b 100644 --- a/zh-TW/copy-trade/ws-public/liquidation.html +++ b/zh-TW/copy-trade/ws-public/liquidation.html @@ -4,14 +4,14 @@ 強平推送 | Bybit API Documentation - +

    強平推送

    訂閱Bybit平台上的期貨強平推送

    推送頻率: 實時

    Topic: liquidation.{symbol} e.g., liquidation.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > updatedTimenumber數據更新時間戳 (毫秒)
    > symbolstring合約名稱
    > sizestring成交數量
    > pricestring成交價格
    > sidestring方向

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
        "liquidation.GALAUSDT"
        ],
        "req_id": "test" // optional
    }

    推送示例​

    {
        "data": {
            "price": "0.03803",
            "side": "Buy",
            "size": "1637",
            "symbol": "GALAUSDT",
            "updatedTime": 1673251091822
        },
        "topic": "liquidation.GALAUSDT",
        "ts": 1673251091822,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-public/orderbook.html b/zh-TW/copy-trade/ws-public/orderbook.html index dbd395ff63..84fab38297 100644 --- a/zh-TW/copy-trade/ws-public/orderbook.html +++ b/zh-TW/copy-trade/ws-public/orderbook.html @@ -4,14 +4,14 @@ 深度 | Bybit API Documentation - +

    深度

    訂閱不同深度的推送

    信息
    • 訂閱成功後，會立即得到一個當前快照包的推送消息.
    • websocket將會繼續推送這些增量數據. 收到snapshot的報文，就需要重置本地的orderbook.
    • snapshot=全量orderbook, delta=增量orderbook
    • 如果因為Bybit服務原因，會重新發送snapshot報文，該報文已保證是最新且準確的.
    提示

    1檔數據: 若3秒內無變化，將會再次推送snapshot數據.

    • 1 檔數據, 推送頻率: 10ms
    • 50 檔數據, 推送頻率: 20ms
    • 200 檔數據, 推送頻率: 100ms

    Topic:
    orderbook.{depth}.{symbol} e.g., orderbook.1.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot,delta
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > sstring合約名稱
    > barrayBid, 買方. 按照價格從大到小
    >> b[0]string買方報價
    >> b[1]string買方數量
    > aarrayAsk, 賣方. 按照價格從小到大
    >> a[0]string賣方報價
    >> a[1]string賣方數量
    uinteger更新id, 一般情況下該id是連續的。偶爾會因後台的重啟而發送"u"=1的全量數據，接收到後請覆蓋本地保存的orderbook
    seqinteger撮合版本號

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
        "orderbook.50.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    推送示例​

    {
        "topic": "orderbook.50.BTCUSDT",
        "type": "snapshot",
        "ts": 1671179923028,
        "data": {
            "s": "BTCUSDT",
            "b": [
                [
                    "17440.00",
                    "40.833"
                ],
                [
                    "17439.50",
                    "0.513"
                ],
                ...
                [
                    "17416.00",
                    "6.156"
                ],
                [
                    "17415.50",
                    "32.268"
                ]
        ],
        "a": [
            [
                "17440.50",
                "78.815"
            ],
            [
                "17441.00",
                "8.858"
            ],
            ...
            [
                "17464.50",
                "4.901"
            ],
            [
                "17465.00",
                "5.744"
            ]
        ],
        "u": 13079592,
        "seq": 22520573250
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-public/ticker.html b/zh-TW/copy-trade/ws-public/ticker.html index c564a45af4..dc9cb09f89 100644 --- a/zh-TW/copy-trade/ws-public/ticker.html +++ b/zh-TW/copy-trade/ws-public/ticker.html @@ -4,14 +4,14 @@ 行情 | Bybit API Documentation - +

    行情

    訂閱行情數據

    重要

    該topic推送delta數據和snapshot数据。如果delta數據為空，表明信息沒有發生變化。

    推送頻率: 實時

    Topic: tickers.{symbol}

    響應參數​

    參數類型說明
    topicstringTopic名稱
    typestring數據類型. `snapshot`,`delta`
    csinteger撮合版本號
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > symbolstring合約名稱
    > tickDirectionstring價格變化方向
    > price24hPcntstring市場價格相對24h前變化的百分比
    > lastPricestring最新市場成交價
    > prevPrice24hstring24小時前的整點市價
    > highPrice24hstring最近24小時的最高價
    > lowPrice24hstring最近24小時的最低價
    > prevPrice1hstring1小時前的整點市價
    > markPricestring標記價格
    > indexPricestring指數價格
    > openIntereststring未平倉合約的數量
    > openInterestValuestring未平倉合約的價值
    > turnover24hstring最近24小時成交額
    > volume24hstring最近24小時成交量
    > nextFundingTimestring下次結算資金費用的時間戳 (毫秒)
    > fundingRatestring資金費率
    > bid1Pricestring買1價
    > bid1Sizestring買1價的數量
    > ask1Pricestring賣1價
    > ask1Sizestring賣1價的數量

    推送示例​

    {
        "topic": "tickers.BTCUSDT",
        "type": "snapshot",
        "data": {
            "symbol": "BTCUSDT",
            "tickDirection": "MinusTick",
            "price24hPcnt": "0.017367",
            "lastPrice": "17222.00",
            "prevPrice24h": "16928.00",
            "highPrice24h": "17281.50",
            "lowPrice24h": "16915.00",
            "prevPrice1h": "17238.00",
            "markPrice": "17224.40",
            "indexPrice": "17234.84",
            "openInterest": "68795.534",
            "openInterestValue": "1184961795.83",
            "turnover24h": "1572429119.324499",
            "volume24h": "91823.449",
            "nextFundingTime": "1673280000000",
            "fundingRate": "-0.000211",
            "bid1Price": "17222.00",
            "bid1Size": "220.358",
            "ask1Price": "17222.50",
            "ask1Size": "3.902"
        },
        "cs": 24988405605,
        "ts": 1673273043686
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws-public/trade.html b/zh-TW/copy-trade/ws-public/trade.html index 87d9867d53..fb72b8a0c4 100644 --- a/zh-TW/copy-trade/ws-public/trade.html +++ b/zh-TW/copy-trade/ws-public/trade.html @@ -4,14 +4,14 @@ 平台成交 | Bybit API Documentation - +

    平台成交

    訂閱Bybit平台上最近成交的推送. 從用戶訂閱開始, 實時推送增量交易歷史, 有成交數據就推送.

    推送頻率: 實時

    Topic: publicTrade.{symbol}

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > Tnumber成交時間戳 (毫秒)
    > sstring合約名稱
    > Sstring方向. Buy,Sell
    > vstring成交數量
    > pstring成交價格
    > Lstring價格變化的方向
    > istring成交Id
    > BTboolean成交類型是否為大宗交易

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
        "publicTrade.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    推送示例​

    {
        "topic": "publicTrade.BTCUSDT",
        "type": "snapshot",
        "ts": 1671181689023,
        "data": [
            {
                "T": 1671181689021,
                "s": "BTCUSDT",
                "S": "Buy",
                "v": "0.002",
                "p": "17032.50",
                "L": "MinusTick",
                "i": "d9cd8295-40dc-5dce-8deb-42882580a7ab",
                "BT": false
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/copy-trade/ws/connect.html b/zh-TW/copy-trade/ws/connect.html index 56c24b213c..c5ff7b60dd 100644 --- a/zh-TW/copy-trade/ws/connect.html +++ b/zh-TW/copy-trade/ws/connect.html @@ -4,14 +4,14 @@ 訂閱WebSocket | Bybit API Documentation - +

    訂閱WebSocket

    警告

    請注意，目前copytrading只支持正向永續，以下接口僅適用於 正向永續

    訂閱地址:
    測試網:

    • 公有頻道: wss://stream-testnet.bybit.com/contract/usdt/public/v3
    • 私有頻道: wss://stream-testnet.bybit.com/realtime_private

    主網:

    • 公有頻道: wss://stream.bybit.com/contract/usdt/public/v3
    • 私有頻道: wss://stream.bybit.com/realtime_private
    信息

    公有頻道不需要鑒權. 以下內容僅適用於私有頻道的訂閱

    構建連接時，創建鑒權請求。

    注意: 如果您正在使用pybit, bybit-api或者其他第三方庫, 您可以忽略此項-因為鑒權已經內建。

    {
        "op": "auth",
        "args": [
            "api_key",
            1662350400000, //過期時間應當大於當前時間戳
            "singature"
        ]
    }
    # 基於: https://github.com/bybit-exchange/pybit/blob/master/pybit/_http_manager.py

    import hmac
    import json
    import time
    import websocket

    api_key = ""
    api_secret = ""

    # 生成expires
    expires = int((time.time() + 1) * 1000)

    # 生成簽名
    signature = str(hmac.new(
        bytes(api_secret, "utf-8"),
        bytes(f"GET/realtime{expires}", "utf-8"), digestmod="sha256"
    ).hexdigest())

    ws = websocket.WebSocketApp(
        url=url,
        ...
    )

    # 發送鑒權請求
    ws.send(
        json.dumps({
            "op": "auth",
            "args": [api_key, expires, signature]
        })
    )

    鑒權成功的響應示例

    {
        "success": true,
        "ret_msg": "",
        "conn_id": "16c79bf6-267d-4e06-a0c1-3ca4ed3a293d",
        "request": {
            "op": "auth",
            "args": [
                "OZUDHROKUZZNVZWHKN",
                "1673261297304",
                "63ae5f1064130d8e931b5d937500461b87c00b2a939284e455fe8ea1e27387f6"
            ]
        }
    }
    信息

    簽名生成的示例可以參考這裡。

    警告

    由於網絡的複雜性，您可能隨時遇到斷連。請參考以下建議確保您能即時接收到推送：

    1. 通過發送心跳
    2. 遇到斷連時，立即重新連接

    IP限頻​

    • 不要嘗試頻繁地構建連接與斷開連接；
    • 不要在5分鐘內構建超過500個連接。

    如何發送心跳​

    發送ping的示例

    ws.send('{"op":"ping"}');

    接收到pong的響應示例

    // 公共頻道的Pong示例
    {
        "success": true,
        "ret_msg": "pong",
        "conn_id": "13271fcb-53ed-4e80-948e-2bdbe3a6587d",
        "req_id": "",
        "op": "ping"
    }
    // 私有頻道的Pong示例
    {
        "success": true,
        "ret_msg": "pong",
        "conn_id": "16c79bf6-267d-4e06-a0c1-3ca4ed3a293d",
        "request": {
            "op": "ping",
            "args": null
        }
    }
    警告

    為了維持連接，我們推薦您每20秒發送一次心跳。

    如何訂閱topic​

    理解Websocket裡的args​

    通過傳入args來訂閱指定topic

    {
        "req_id": "test", // 可選
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT"
        ]
    }

    通過","來訂閱同一個topic下的多個交易對

    // 示例: 訂閱trade下的BTCUSDT和ETHUSDT
    {
        "req_id": "test", // 可選
        "op": "subscribe",
        "args": [
            "publicTrade.BTCUSDT",
            "publicTrade.ETHUSDT"
        ]
    }

    訂閱多個topic

    ws.send('{"op": "subscribe", "args": ["orderbook.1.BTCUSDT","publicTrade.BTCUSDT","orderbook.1.ETHUSDT]}')

    理解如何取消訂閱​

    您可以通過發送請求來動態地停止訂閱

    ws.send('{"op": "unsubscribe", "args": ["publicTrade.BTCUSDT"]}');
    {
        "op": "unsubscribe",
        "args": [
            "publicTrade.BTCUSDT"
        ]
    }

    理解訂閱的響應​

    訂閱成功後的響應示例

    // 公共頻道的訂閱響應
    {
        "success": true,
        "ret_msg": "",
        "conn_id": "322b49ce-d6a5-494a-9019-f1d51cd541ae",
        "req_id": "",
        "op": "subscribe"
    }
    // 私有頻道的訂閱響應
    {
        "success": true,
        "ret_msg": "",
        "conn_id": "16c79bf6-267d-4e06-a0c1-3ca4ed3a293d",
        "request": {
            "op": "subscribe",
            "args": [
                "copyTradePosition",
                "copyTradeOrder",
                "copyTradeExecution"
            ]
        }
    }

    訂閱成功後，您將收到結果信息。可以根據響應判斷訂閱是否成功。

    - + \ No newline at end of file diff --git a/zh-TW/copytrade/public/instrument-info.html b/zh-TW/copytrade/public/instrument-info.html index deb2e47a53..5636b63ecc 100644 --- a/zh-TW/copytrade/public/instrument-info.html +++ b/zh-TW/copytrade/public/instrument-info.html @@ -4,13 +4,13 @@ 交易員獲取可帶單合約規格 | Bybit API Documentation - +

    交易員獲取可帶單合約規格

    交易員獲取可帶單合約的規格

    提示

    該接口是公共接口，無需鑒權

    HTTP 請求​

    GET /contract/v3/public/copytrading/symbol/list

    請求參數​

    無

    返回參數​

    參數類型說明
    listarrayObject
    > symbolstring合約類型
    > baseCurrencystring基礎貨幣
    > quoteCurrencystring報價貨幣
    > priceScalestring價格範圍（可以提交價格的小數位數，儘管最終價格可能會四捨五入以符合 價格最小增加或減少數量）
    > takerFeestringtaker 手續費
    > makerFeestringmaker 手續費
    > fundingIntervalstring資金費用結算週期
    > leverageFilterObject槓桿屬性
    >> maxLeveragestring最大杠桿數 (假設在最低風險限額設置時候的最大槓桿數)
    >> minLeveragestring最小杠桿數
    > priceFilterObject價格屬性
    >> minPricestring最小價格
    >> maxPricestring最大價格
    >> tickSizestring價格最小增加或減少數量
    > lotSizeFilterObject下單數量屬性
    >> qtyStepstring合約數量最小單位
    >> maxOrderQtystring最大交易數量
    >> minOrderQtystring最小交易數量

    請求示例​

    curl https://api-testnet.bybit.com/contract/v3/public/copytrading/symbol/list

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "baseCurrency": "BTC",
                    "quoteCurrency": "USDT",
                    "priceScale": "1",
                    "takerFee": "0.00075",
                    "makerFee": "-0.00025",
                    "fundingInterval": "480",
                    "leverageFilter": {
                        "maxLeverage": "100",
                        "minLeverage": "1"
                    },
                    "priceFilter": {
                        "minPrice": "0.5",
                        "maxPrice": "999999.0",
                        "tickSize": "0.5"
                    },
                    "lotSizeFilter": {
                        "qtyStep": "0.001",
                        "maxOrderQty": "100.000",
                        "minOrderQty": "0.001"
                    }
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/auto-margin.html b/zh-TW/derivatives/contract/auto-margin.html index 311ebd34d7..b5ae72d859 100644 --- a/zh-TW/derivatives/contract/auto-margin.html +++ b/zh-TW/derivatives/contract/auto-margin.html @@ -4,13 +4,13 @@ 設置自動追加保證金 | Bybit API Documentation - +

    設置自動追加保證金

    開關自動追加保證金. 欲了解更多，請參閱這裡

    提示

    該功能僅支持逐倉模式下的USDT永續

    HTTP 請求​

    POST /contract/v3/private/position/set-auto-add-margin

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    sidetruestring方向. Buy,Sell
    autoAddMargintrueinteger開關自動追加保證金. 0: 關閉. 1: 打開
    positionIdxtrueinteger倉位標識符

    響應參數​

    無

    請求示例​

    POST /contract/v3/private/position/set-auto-add-margin HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670826151188
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol": "ETHUSDT",
        "side": "Buy",
        "autoAddMargin": 1,
        "positionIdx": 1
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670826151500
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/cancel-all.html b/zh-TW/derivatives/contract/cancel-all.html index 7c2cdb4166..d633882e9a 100644 --- a/zh-TW/derivatives/contract/cancel-all.html +++ b/zh-TW/derivatives/contract/cancel-all.html @@ -4,13 +4,13 @@ 撤銷所有訂單 | Bybit API Documentation - +

    撤銷所有訂單

    撤銷全部委託單

    提示
    • baseCoin, settleCoin, symbol三個參數必傳其中一個

    HTTP 請求​

    POST /contract/v3/private/order/cancel-all

    請求參數​

    參數是否必需類型說明
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種
    settleCoinfalsestring結算幣種

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> orderIdstring訂單ID
    >> orderLinkIdstring用戶自定義ID

    请求示例​

    POST /contract/v3/private/order/cancel-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670571959925
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "settleCoin": "USDT",
        "symbol": null
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "4545cab5-0f98-45c4-b137-6c42f3b33d4a",
                    "orderLinkId": ""
                },
                {
                    "orderId": "66c1beaf-aadd-4b36-be37-7f80ec315422",
                    "orderLinkId": ""
                }
            ]
    },
        "retExtInfo": {},
        "time": 1670571961179
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/cancel.html b/zh-TW/derivatives/contract/cancel.html index fca54c5eb7..1ff2903d10 100644 --- a/zh-TW/derivatives/contract/cancel.html +++ b/zh-TW/derivatives/contract/cancel.html @@ -4,13 +4,13 @@ 撤銷委託單 | Bybit API Documentation - +

    撤銷委託單

    備註
    • 您必須指定orderId或者orderLinkId.
    • 若orderId和orderLinkId之間不匹配, 系統將會優先處理orderId.
    • 您只能撤銷未成交和部分成交的訂單.

    HTTP 請求​

    POST /contract/v3/private/order/cancel

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個

    響應參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring用戶自定義訂單ID

    请求示例​

    POST /contract/v3/private/order/cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670570871662
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol": "BTCUSDT",
        "orderLinkId": null,
        "orderId": "a0c76874-1777-48dd-9f99-b4120ec71cc0"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "a0c76874-1777-48dd-9f99-b4120ec71cc0",
            "orderLinkId": "xrp_12"
        },
        "retExtInfo": {},
        "time": 1670570872075
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/closepnl.html b/zh-TW/derivatives/contract/closepnl.html index 68335a5cf3..ae8cb0dd3e 100644 --- a/zh-TW/derivatives/contract/closepnl.html +++ b/zh-TW/derivatives/contract/closepnl.html @@ -4,13 +4,13 @@ 查詢平倉盈虧 | Bybit API Documentation - +

    查詢平倉盈虧

    獲取當前用戶的所有平倉盈虧數據，返回結果按照updatedTime降序排列.

    信息

    支持 USDT永續, 反向永續和反向交割

    查詢時間範圍:

    • 指定的了startTime 和 endTime, 您可以查詢過去2年的數據
    • 若不指定startTime 和 endTime, 默認返回近6個月的數據

    HTTP 請求​

    GET /contract/v3/private/position/closed-pnl

    請求參數​

    參數是否必需類型說明
    symboltruestring產品類型
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    • 若不傳startTime，則查詢startTime和startTime+7天的數據
    • 若不傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 200]. default: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > symbolstring合約名稱
    > orderIdstring訂單Id
    > sidestring買賣方向. Buy, Side
    > qtystring訂單數量
    > leveragestring持倉槓桿
    > orderPricestring訂單價格
    > orderTypestring訂單類型. Market,Limit
    > execTypestring執行類型
    > closedSizestring平倉數量
    > cumEntryValuestring被平倉位的累計入場價值
    > avgEntryPricestring平均入場價格
    > cumExitValuestring被平倉位的累計出場價值
    > avgExitPricestring平均出場價格
    > closedPnlstring被平倉位的盈虧
    > fillCountstring單筆訂單的成交筆數
    > createdAtstring訂單創建時間, 同createdTime
    > createdTimestring訂單創建時間, 同createdAt
    > updatedTimestring訂單更新時間
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /contract/v3/private/position/closed-pnl?symbol=ETHUSDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670855140626
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "list": [
            {
                "symbol": "ETHUSDT",
                "orderId": "ee650123-74bf-4094-aadb-efa139d99c50",
                "side": "Buy",
                "qty": "0.30",
                "orderPrice": "1314.75",
                "orderType": "Market",
                "execType": "Trade",
                "closedSize": "0.30",
                "cumEntryValue": "373.71078947",
                "avgEntryPrice": "1245.7026",
                "cumExitValue": "375.532",
                "avgExitPrice": "1251.7734",
                "closedPnl": "-2.27050237",
                "fillCount": "2",
                "leverage": "50",
                "createdAt": "1670838034412",
                "createdTime": "1670838034412",
                "updatedTime": "1670838034450"
            }
        ],
        "nextPageCursor": "eyJza2lwX2xvY2FsX3N5bWJvbCI6ZmFsc2UsInBhZ2VfdG9rZW4iOiJleUpOSWpwN0lsOTFjM2N4WHlJNmV5SkNJam9pUVRnMlZFcEJSVWRCVVVVOUluMHNJbkJySWpwN0lrSWlPaUpLUjFac1RtcFZkMDFVU1hwTVZHTXdXVzFaZEU1RVFUVk9RekZvV1ZkU2FVeFhWbTFaVkVWNlQxZFJOVTlYVFRGTlFUMDlJbjBzSWw5emExOGlPbnNpUWlJNklrWjZRVU5XZGpWcVkyTXlSblJoTTJSQlp6MDlJbjE5ZlE9PSJ9"
    },
        "retExtInfo": {},
        "time": 1670855140831
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/confirm-mmr.html b/zh-TW/derivatives/contract/confirm-mmr.html index 0847d0d0aa..7d23ba20ec 100644 --- a/zh-TW/derivatives/contract/confirm-mmr.html +++ b/zh-TW/derivatives/contract/confirm-mmr.html @@ -4,14 +4,14 @@ 確認新的風險限額 | Bybit API Documentation - +

    確認新的風險限額

    僅適用於當用戶被標記為僅減倉時(請看持倉接口中的isReduceOnly字段), 在用戶主動調整風險水位後, 調用該接口來試算調整後的風 險水平, 若通過(retCode=0), 則系統會移除僅減倉標記, 推薦自行再調用下倉位接口確認isReduceOnly字段是否變成false

    HTTP 請求​

    POST /contract/v3/private/position/confirm-pending-mmr

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱

    響應參數​

    無

    請求示例​

    POST /contract/v3/private/position/confirm-pending-mmr HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1698051546759
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 32

    {

        "symbol": "BTCUSDT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1698051124588
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/cross-isolated.html b/zh-TW/derivatives/contract/cross-isolated.html index 2815080c06..e58eaa66a6 100644 --- a/zh-TW/derivatives/contract/cross-isolated.html +++ b/zh-TW/derivatives/contract/cross-isolated.html @@ -4,13 +4,13 @@ 切換全倉/逐倉 | Bybit API Documentation - +

    切換全倉/逐倉

    切換全倉/逐倉模式. 欲了解更多，請參閱這裡

    信息

    支持USDT永續，反向永續和反向交割

    HTTP 請求​

    POST /contract/v3/private/position/switch-isolated

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    tradeModetrueinteger0: 全倉. 1: 逐倉
    buyLeveragetruestring買方向的槓桿倍數. 確保buyLeverage等於sellLeverage
    sellLeveragetruestring賣方向的槓桿倍數. 確保buyLeverage等於sellLeverage

    響應參數​

    無

    請求示例​

    POST /contract/v3/private/position/switch-isolated HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670848559156
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"BTCUSDT",
        "tradeMode": 1,
        "buyLeverage": "8",
        "sellLeverage": "8"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670848559569
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/execution-list.html b/zh-TW/derivatives/contract/execution-list.html index 8d9492c65e..6467ef22b0 100644 --- a/zh-TW/derivatives/contract/execution-list.html +++ b/zh-TW/derivatives/contract/execution-list.html @@ -4,13 +4,13 @@ 查詢成交紀錄 | Bybit API Documentation - +

    查詢成交紀錄

    獲取用戶成交紀錄，返回結果按execTime降序排列

    支持時間範圍:

    • USDT永續, 反向永續, 反向交割: 過去兩年
    提示

    單筆訂單可能會有多次成交

    HTTP 請求​

    GET /contract/v3/private/execution/list

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    orderIdfalsestring訂單ID
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    • 若不傳startTime，則查詢startTime和startTime+7天的數據
    • 若不傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    execTypefalsestring成交類型
    limitfalseinteger每頁數量限制. [1, 100]. default: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listarrayObject
    > symbolstring合約名稱
    > sidestringBuy,Sell
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義訂單iD
    > orderPricestring訂單價格
    > orderQtystring訂單數量
    > orderTypestring訂單類型. 市價單: Market,限價單: Limit
    > stopOrderTypestring条件单的订单类型。如果该订单不是条件单，则不会返回任何类型
    > execFeestring交易手續費
    > execIdstring成交Id
    > execPricestring成交價格
    > execQtystring成交數量
    > execTypestring交易類型
    > execValuestring成交價值
    > feeRatestring手續費率
    > lastLiquidityIndstring流動性類型. AddedLiquidity, RemovedLiquidity
    > isMakerboolean是否是maker單
    > leavesQtystring剩餘委託未成交價值
    > closedSizestring平倉數量
    > ivstring隱含波動率
    > blockTradeIdstring大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID
    > markPricestring成交執行時，該 symbol 當時的標記價格
    > indexPricestring成交執行時，該 symbol 當時的指數價格
    > markIvstring標記價格的隱含波動率
    > underlyingPricestring成交執行時，該 symbol 當時的底層資產價格
    > execTimestring成交時間（毫秒）

    請求示例​

    GET /contract/v3/private/execution/list?symbol=ETHUSDT&limit=1&category=linear HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670853954362
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "ETHUSDT",
                    "execFee": "-0.08720013",
                    "execId": "208751d8-f70e-4570-a5fd-d208c82af99d",
                    "execPrice": "1263.77",
                    "execQty": "0.69",
                    "execType": "Funding",
                    "execValue": "872.0013",
                    "feeRate": "-0.0001",
                    "lastLiquidityInd": "UNKNOWN",
                    "leavesQty": "0.00",
                    "orderId": "1673136000-ETHUSDT-592334-Sell",
                    "orderLinkId": "",
                    "orderPrice": "0.00",
                    "orderQty": "0.00",
                    "orderType": "UNKNOWN",
                    "stopOrderType": "UNKNOWN",
                    "side": "Sell",
                    "execTime": "1673136000000",
                    "closedSize": "0.00",
                    "iv": "",
                    "blockTradeId": "",
                    "markPrice": "",
                    "markIv": "",
                    "underlyingPrice": "",
                    "indexPrice": "",
                    "isMaker": false
                }
            ],
            "nextPageCursor": "ZzU3NlU4M1JlLzhFTWkzeW9hemRVcitqUk4wVW9LL21KVTRWV3JPR0tYTG9uTENWSkFvUDJuWk44OVBlNnB0ZjJHTTFwdlJRV0tpZFM0Z0RzUlQ0d2FSbzVRN2lpZ0ZrZmt2UTZuRlJVSHdQSHdoYXUvdDN6aExzOEpmcDNFY2NLc2dYTnRvOXhmTmY3NVNreVgzQ2RKUFZtekptU0NQNU1rOWd5YzZRV1ZDejVFM0t0MGdlMENNc04ybzQvc2JQQ3BVRkQycHU3MFdBK3RqdFlWaVRkMTNGQmZRUUZpaVc4MkE1SnRCT09iZDRNL2FlNDVSMithdU96NTROWGFxcTFucW1MSnJSaTluM29pZm85dHVkNzJMSVQwODk4UTJLbHEybDJ0Uk9UYmtCcU5ScU9zZWRCa2Znc0dwbmNEOWJoaCtnZkRkWjlrMEl6elRmWnljeHZpYXBPWVdzZSs0UEtvdnZ4cTJHQ2JZcm1UQkU3TXFKS01yU1dmaloyT3pVS1psbmVaamh3N3Ntc0hFbEgwckxtQT09",
            "category": ""
        },
        "retExtInfo": {},
        "time": 1673150404910
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/fee-rate.html b/zh-TW/derivatives/contract/fee-rate.html index 4415174bd3..d43627cf10 100644 --- a/zh-TW/derivatives/contract/fee-rate.html +++ b/zh-TW/derivatives/contract/fee-rate.html @@ -4,13 +4,13 @@ 查詢交易費率 | Bybit API Documentation - +

    查詢交易費率

    獲取用戶的交易手續費率

    HTTP 請求​

    GET /contract/v3/private/account/fee-rate

    請求參數​

    參數是否必需類型說明
    symbolfalsestring合約名稱

    響應參數​

    參數類型說明
    listarrayObject
    > symbolstring合約名稱
    > takerFeeRatestringTaker手續費率
    > makerFeeRatestringMaker手續費率

    請求示例​

    GET /contract/v3/private/account/fee-rate?symbol=SOLUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670924049902
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "list": [
            {
                "symbol": "SOLUSDT",
                "takerFeeRate": "0.0006",
                "makerFeeRate": "0.0001"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1670924050413
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/leverage.html b/zh-TW/derivatives/contract/leverage.html index 7f10c7824b..28570d3812 100644 --- a/zh-TW/derivatives/contract/leverage.html +++ b/zh-TW/derivatives/contract/leverage.html @@ -4,13 +4,13 @@ 設置槓桿倍數 | Bybit API Documentation - +

    設置槓桿倍數

    設置槓桿

    HTTP 請求​

    POST /contract/v3/private/position/set-leverage

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    buyLeveragetruestring(0, 風險限額允許的最大槓桿數]. 單倉模式下，buyLeverage需要和sellLeverage保持一致
    sellLeveragetruestring(0, 風險限額允許的最大槓桿數]. 單倉模式下，buyLeverage需要和sellLeverage保持一致

    響應參數​

    無

    請求示例​

    POST /contract/v3/private/position/set-leverage HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670849911829
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"BTCUSD",
        "buyLeverage":"20",
        "sellLeverage":"20"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670849912024
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/open-order.html b/zh-TW/derivatives/contract/open-order.html index 1f82b9da26..afc8ba188b 100644 --- a/zh-TW/derivatives/contract/open-order.html +++ b/zh-TW/derivatives/contract/open-order.html @@ -4,13 +4,13 @@ 查詢實時委託單 | Bybit API Documentation - +

    查詢實時委託單

    實時查詢未成交或部分成交的訂單信息. 若需要查詢更久的訂單紀錄，請使用查詢歷史訂單接口.

    提示
    • 當不指定orderId和orderLinkId時，最多500條紀錄返回
    • 返回的結果將以createdTime從新到舊排序.

    HTTP 請求​

    GET /contract/v3/private/order/unfilled-orders

    請求參數​

    參數是否必需類型說明
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種
    settleCoinfalsestring結算幣種. symbol,baseCoin和settleCoin必傳其中一個. 優先級: symbol > baseCoin > settleCoin
    orderIdfalsestring訂單id
    orderLinkIdfalsestring用戶自定義訂單Id
    orderFilterfalsestringOrder: 普通單, StopOrder: 條件單
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listarraystring
    > symbolstring合約名稱
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義ID
    > sidestringSide. Buy,Sell
    > orderTypestring訂單類型. Market,Limit. 對於止盈止損單, 則表示為觸發後的訂單類型
    > pricestring訂單價格
    > ivstring隱含波動率
    > qtystring訂單數量
    > timeInForcestring執行策略
    > orderStatusstring訂單狀態
    > lastPriceOnCreatedstring下單時的市場價格
    > cancelTypestring訂單被取消類型
    > stopOrderTypestring條件單類型
    > triggerDirectionstring1: 上升時觸發, 2: 下降時觸發
    > triggerBystring觸發價格的觸發類型
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
    > cumExecValuestring訂單累計成交價值
    > cumExecFeestring訂單累計成交的手續費
    > cumExecQtystring訂單累計成交數量
    > leavesValuestring訂單剩餘未成交的價值
    > leavesQtystring訂單剩餘未成交的數量
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > tpslModestring止盈止損模式 Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損
    > tpLimitPricestring觸發止盈後轉換為限價單的價格
    > slLimitPricestring觸發止損後轉換為限價單的價格
    > tpTriggerBystring觸發止盈的價格類型
    > slTriggerBystring觸發止損的價格類型
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?. 該字段對期權無效，一直是""
    > smpTypestringSMP執行類型
    > smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    > smpOrderIdstring觸發此SMP執行的交易對手的 orderID
    > createdTimestring訂單創建時間戳 (毫秒)
    > updatedTimestring訂單更新時間戳 (毫秒)

    請求示例​

    GET /contract/v3/private/order/unfilled-orders?symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670564324211
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "orderId": "806f5fc6-d487-46d1-9a57-4b4964126c90",
                    "side": "Buy",
                    "orderType": "Limit",
                    "stopOrderType": "UNKNOWN",
                    "price": "26864.40",
                    "qty": "0.003",
                    "timeInForce": "PostOnly",
                    "orderStatus": "New",
                    "triggerPrice": "0.00",
                    "orderLinkId": "YLxaWKMiHU",
                    "createdTime": "1684810640078",
                    "updatedTime": "1684810640080",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "triggerBy": "UNKNOWN",
                    "reduceOnly": false,
                    "leavesQty": "0.003",
                    "leavesValue": "80.5932",
                    "cumExecQty": "0.000",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "triggerDirection": 0,
                    "cancelType": "UNKNOWN",
                    "lastPriceOnCreated": "",
                    "iv": "",
                    "closeOnTrigger": false,
                    "tpslMode": "Full",
                    "tpLimitPrice": "",
                    "slLimitPrice": "",
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": ""
                }
            ],
            "nextPageCursor": "",
            "category": ""
        },
        "retExtInfo": {},
        "time": 1684810643363
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/order-list.html b/zh-TW/derivatives/contract/order-list.html index be53c1e375..63ec42fbcb 100644 --- a/zh-TW/derivatives/contract/order-list.html +++ b/zh-TW/derivatives/contract/order-list.html @@ -4,13 +4,13 @@ 查詢歷史訂單 | Bybit API Documentation - +

    查詢歷史訂單

    提示

    獲取歷史訂單紀錄. 由於訂單創建/撤銷是異步的, 該接口返回數據可能會有延遲. 若您想實時獲取訂單信息, 您可以查詢該接口或者通過websocket推送(推薦)

    HTTP 請求​

    GET /contract/v3/private/order/list

    請求參數​

    參數是否必需類型說明
    symbolfalsestring合約名稱
    orderIdfalsestring訂單ID
    orderLinkIdfalsestring用戶自定義訂單ID
    orderStatusfalsestring訂單狀態。不傳則默認查詢所有狀態
    orderFilterfalsestringOrder,StopOrder
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listlistObject
    > symbolstringSymbol name
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義ID
    > sidestring方向. Buy,Sell
    > orderTypestring訂單類型. Market,Limit. 對於止盈止損單, 則表示為觸發後的訂單類型
    > pricestring訂單價格
    > ivstring隱含波動率
    > qtystring訂單數量
    > timeInForcestring執行策略
    > orderStatusstring訂單狀態
    > positionIdxinteger倉位標識. 0: 單向持倉, 1: 買側雙向持倉, 2: 賣側雙向持倉
    > lastPriceOnCreatedstring創建訂單時的市場價
    > cancelTypestring取消類型
    > rejectReasonstring被拒絕原因
    > stopOrderTypestring條件單類型
    > triggerDirectionstring1: 上升時觸發, 2: 下降時觸發
    > triggerBystring觸發價格的觸發類型
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
    > cumExecValuestring訂單累計成交價值
    > cumExecFeestring訂單累計成交的手續費
    > cumExecQtystring訂單累計成交數量
    > leavesValuestring訂單剩餘未成交的價值
    > leavesQtystring訂單剩餘未成交的數量
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > tpslModestring止盈止損模式 Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損
    > tpLimitPricestring觸發止盈後轉換為限價單的價格
    > slLimitPricestring觸發止損後轉換為限價單的價格
    > tpTriggerBystring觸發止盈的價格類型
    > slTriggerBystring觸發止損的價格類型
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?
    > blockTradeIdstringParadigm 大宗交易ID
    > smpTypestringSMP執行類型
    > smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    > smpOrderIdstring觸發此SMP執行的交易對手的 orderID
    > createdTimestring訂單創建時間戳 (毫秒)
    > updatedTimestring訂單更新時間戳 (毫秒)

    請求示例​

    GET /contract/v3/private/order/list?symbol=BTCUSDT&orderId=806f5fc6-d487-46d1-9a57-4b4964126c90 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673420679798
    X-BAPI-RECV-WINDOW: 5000
    cdn-request-id: test-10

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "side": "Buy",
                    "orderType": "Limit",
                    "price": "26864.40",
                    "qty": "0.003",
                    "reduceOnly": false,
                    "timeInForce": "PostOnly",
                    "orderStatus": "Cancelled",
                    "leavesQty": "0.000",
                    "leavesValue": "0",
                    "cumExecQty": "0.000",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "lastPriceOnCreated": "0.00",
                    "rejectReason": "EC_PerCancelRequest",
                    "orderLinkId": "YLxaWKMiHU",
                    "createdTime": "1684810640078",
                    "updatedTime": "1684810770380",
                    "orderId": "806f5fc6-d487-46d1-9a57-4b4964126c90",
                    "stopOrderType": "UNKNOWN",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "triggerPrice": "0.00",
                    "closeOnTrigger": false,
                    "triggerDirection": 0,
                    "positionIdx": 1,
                    "cancelType": "CancelByUser",
                    "iv": "",
                    "triggerBy": "UNKNOWN",
                    "blockTradeId": "",
                    "tpslMode": "Full",
                    "tpLimitPrice": "",
                    "slLimitPrice": "",
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": ""
                }
            ],
            "nextPageCursor": "eyJza2lwX2xvY2FsX3N5bWJvbCI6ZmFsc2UsInBhZ2VfdG9rZW4iOiIzOTQ3NCJ9",
            "category": ""
        },
        "retExtInfo": {},
        "time": 1684810802126
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/place-order.html b/zh-TW/derivatives/contract/place-order.html index e6e264b4db..a1c7b863db 100644 --- a/zh-TW/derivatives/contract/place-order.html +++ b/zh-TW/derivatives/contract/place-order.html @@ -4,7 +4,7 @@ 創建委託單 | Bybit API Documentation - + @@ -16,7 +16,7 @@ 該訂單ID去取消活動委托，同時要求您傳遞的自定義訂單ID 最大長度不超過36個字段且唯一。

  • 訂單持有上限: 期貨: 單個账户针对合约可持有每个 symbol 最多可同时持有500个普通活动订单。这是针对合约的，因此可以允许出现例如：账户同时持有300个BTCUSD的活动单、 280个ETHUSD合约的活动单。針對條件單，單個帳戶針對合約可持有每個 symbol 最多同時持有 10 個條件單。 期權: 最多可持有100個委託單

    • HTTP 請求​

    POST /contract/v3/private/order/create

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    sidetruestring方向. Buy,Sell
    orderTypetruestring訂單類型. Market, Limit
    qtytruestring下單數量
    timeInForcetruestring訂單策略.
    pricefalsestring訂單價格. orderType=Market時，值將被忽略
    positionIdxfalseinteger倉位標識. 0: 單向持倉, 1: 買側雙向持倉, 2: 賣側雙向持倉. 雙向模式下，該字段必傳
    triggerDirectionfalseinteger條件單參數. 用於辨別期望的方向.
    • 1: 當市場價上漲到了triggerPrice時觸發條件單
    • 2: 當市場價下跌到了triggerPrice時觸發條件單
    triggerPricefalsestring條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保::
    triggerPrice > 市場價格
    否則, triggerPrice < 市場價格
    triggerByfalsestring觸發價格類型. LastPrice, IndexPrice, MarkPrice. 默認: LastPrice
    orderLinkIdfalsestring用戶自定義訂單ID, 最大長度36位，且同一機構下自定義ID支持數字、字母（大小寫）、中劃線、下劃線這些字符的組合
    期貨規則:
    • 該參數選填
    • USDC永續和USDT永續的orderLinkId互相獨立，即orderLinkId可相同
    • 在訂單未完全成交或取消前，orderLinkId需保持不一致; 訂單完全成交或取消後，orderLinkId可使用之前使用過的
      • 期權規則:
    • 該參數必傳
    • 總是唯一
    takeProfitfalsestring止盈價格
    stopLossfalsestring止損價格
    tpTriggerByfalsestring止盈激活價格類型，MarkPrice, IndexPrice, 默認:LastPrice
    slTriggerByfalsestring止損激活價格類型. MarkPrice, IndexPrice, 默認:LastPrice
    reduceOnlyfalseboolean什麼是只減倉? true 將這筆訂單設為只減倉. 只減倉單的止盈止損不生效
    closeOnTriggerfalseboolean什麼是觸發後平倉委託? 此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行.
    smpTypefalsestringSmp執行類型. 什麼是SMP?
    tpslModefalsestring止盈止損模式
    • Full: 全部倉位止盈止損. 此時, tpOrderType或者slOrderType必須傳Market
    • Partial: 部分倉位止盈止損. 支持創建限價止盈止損. 注意: 創建限價止盈止損時, tpslMode必傳且為Partial
    tpLimitPricefalsestring觸發止盈後轉換為限價單的價格. 僅tpslMode=Partial且tpOrderType=Limit時有效
    slLimitPricefalsestring觸發止損後轉換為限價單的價格. 僅tpslMode=Partial且slOrderType=Limit時有效
    tpOrderTypefalsestring止盈觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持tpOrderType=Market
    slOrderTypefalsestring止損觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持slOrderType=Market

    響應參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring用戶自定義訂單ID

    請求示例​

    POST /contract/v3/private/order/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670487164902
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json; charset=utf-8
    {
        "symbol": "BTCUSDT",
        "side": "Buy",
        "orderType": "Limit",
        "qty": "0.05",
        "price": "18500",
        "timeInForce": "GoodTillCancel",
        "positionIdx": null,
        "triggerDirection": 1,
        "triggerPrice": "19000"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "0cf62262-7dc2-4503-9566-8835c841509b",
            "orderLinkId": ""
        },
        "retExtInfo": {},
        "time": 1670486764551
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/position-list.html b/zh-TW/derivatives/contract/position-list.html index 5df08f2abf..04427e3a5d 100644 --- a/zh-TW/derivatives/contract/position-list.html +++ b/zh-TW/derivatives/contract/position-list.html @@ -4,13 +4,13 @@ 查詢持倉 (實時) | Bybit API Documentation - +

    查詢持倉 (實時)

    該接口可以獲取用戶的持倉信息，比如持倉數量，累計盈虧等

    HTTP 請求​

    GET /contract/v3/private/position/list

    請求參數​

    參數是否必需類型說明
    symbolfalsestring合約名稱
    settleCoinfalsestring結算幣種. 查詢期貨時, symbol 和 settleCoin二者必傳一個. symbol優先級更高

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listarrayObject
    > symbolstring合約名称
    > sidestring方向. Buy, Sell. 單倉模式下，無倉位則返回None
    > sizestring當前倉位的數量，按照合約張數計算
    > entryPricestring平均入場價
    > leveragestring槓桿倍數
    > positionValuestring仓位的價值
    > positionIdxinteger倉位標識符, 用于在不同仓位模式下标识仓位
    > riskIdinteger风险限额ID. 參見風險限額接口
    > riskLimitValuestring當前風險限額ID對應的持倉限制量
    > tradeModeinteger0: 全倉模式. 1: 逐倉模式
    > autoAddMargininteger0: 否. 1: 是. 僅適用於逐倉模式
    > positionBalancestring倉位保證金
    > liqPricestring預估強平價. 當強平價 <= minPrice 或者強平價 >= maxPrice時, 則為""
    > bustPricestring預估破產價
    > tpSlModestring該字段已廢棄, 無意義, 總是返回"Full"
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > trailingStopstring追蹤止損（與當前價格的距離）
    > activePricestring追蹤止損的激活價格
    > markPricestring實時標記價格
    > unrealisedPnlstring未结盈亏
    > cumRealisedPnlstring累计已结盈亏
    > positionMMstring倉位維持保證金
    > positionIMstring倉位起始保證金
    > positionStatusstring倉位狀態
    > sessionAvgPricestring結算價格
    > occClosingFeestring預佔用平倉手續費
    > adlRankIndicatorinteger自動減倉燈. 什麼是自動減倉機制?
    > isReduceOnlyboolean僅當Bybit需要降低某個Symbol的風險限額時有用
    • true: 僅允許減倉操作. 您可以考慮一系列的方式, 比如, 降低risk limit檔位, 或者同檔位修改槓桿或減少倉位, 或者增加保證金, 或者撤單, 這些操作做完後, 可以主動調用確認新的風險限額接口
    • false(默認): 沒有交易限制, 表示您的倉位在系統調整時處於風險水平之下
    • 僅對逐倉和全倉的期貨倉位有意義
    > mmrSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改MMR的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了MMR調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > leverageSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改槓桿的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了槓桿調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > createdTimestring倉位創建時間戳 (毫秒)
    > updatedTimestring倉位數據更新時間 (毫秒)

    請求示例​

    GET /contract/v3/private/position/list?symbol=ETCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673421074950
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "positionIdx": 0,
                    "riskId": 236,
                    "symbol": "ETCUSDT",
                    "side": "None",
                    "size": "0.0",
                    "positionValue": "0",
                    "entryPrice": "0",
                    "tradeMode": 0,
                    "autoAddMargin": 0,
                    "leverage": "10",
                    "positionBalance": "0",
                    "liqPrice": "",
                    "bustPrice": "0.000",
                    "takeProfit": "0.000",
                    "stopLoss": "0.000",
                    "trailingStop": "0.000",
                    "unrealisedPnl": "0",
                    "createdTime": "1672986751942",
                    "updatedTime": "1675382400091",
                    "tpSlMode": "Full",
                    "riskLimitValue": "200000",
                    "activePrice": "0.000",
                    "markPrice": "15.126",
                    "cumRealisedPnl": "-10.69094915",
                    "positionMM": "0",
                    "positionIM": "0",
                    "positionStatus": "Normal",
                    "sessionAvgPrice": "0.000",
                    "occClosingFee": "0",
                    "avgPrice": "0",
                    "adlRankIndicator": 0,
                    "isReduceOnly": false,
                    "mmrSysUpdatedTime": "",
                    "leverageSysUpdatedTime": ""
                }
            ],
            "category": "",
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1697685149803
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/position-mode.html b/zh-TW/derivatives/contract/position-mode.html index 13918046ca..a6bdcabda1 100644 --- a/zh-TW/derivatives/contract/position-mode.html +++ b/zh-TW/derivatives/contract/position-mode.html @@ -4,13 +4,13 @@ 切換倉位模式 | Bybit API Documentation - +

    切換倉位模式

    該接口可以切換USDT永續和反向交割的倉位模式。單倉模式下，只能在單方向下持倉; 雙倉模式下，可以同時在兩個方向持倉。

    提示
    • 配置生效的優先級：symbol 配置 > coin 配置 > 系统默认配置
    • 目前系統默認配置：單向持倉模式
    • 如果請求參數中是按照coin的配置參數（此coin=settleCoin），則僅對該settleCoin下無持倉無委託單的symbol進行批量設置，並且未來新上線基於該settleCoin的結算的symol也是該模式。

    舉例​

    系統默認coinsymbol
    初始配置單向持倉未設置過未設置過
    生效結果所有USDT正向交易對都是單向持倉
    變更 1--BTCUSDT 設置為雙向持倉模式
    生效結果當前交易對BTCUSDT為雙向持倉，其他交易對都是單向持倉（繼承系統默認規則）
    新上線交易對 ETHUSDT新上線的ETHUSDT為單向持倉 （繼承系統默認規則）
    變更 2-USDT 設置為雙向持倉-
    生效結果當前所有未持倉未有訂單的交易對都是雙向持倉，有持倉和有委託單的交易對不做調整
    新上線交易對 SOLUSDT新上線的SOLUSDT為雙向持倉 (繼承coin規則)
    變更 3--ASXUSDT 設置為單向持倉模式
    生效結果AXSUSDT為單向持倉模式，其餘交易對不做任何變更（繼承coin規則）
    新上線交易對 BITUSDT新上線的BITUSDT為雙向持倉 (繼承coin規則)

    當前合約單雙向持倉切換能力​

    非統一保證金模式統一保證金模式
    USDT永續合約支持單雙向持倉僅支持單向持倉
    USDC永續合約僅支持單向持倉僅支持單向持倉
    反向永續合約僅支持單向持倉不支持該模式下交易該合約
    反向交割合約支持單雙向持倉不支持該模式下交易該合約

    HTTP 請求​

    POST /contract/v3/private/position/switch-mode

    請求參數​

    參數是否必需類型說明
    symbolfalsestring合約名稱. symbol 和 coin二者必傳一個. symbol優先級更高
    coinfalsestring幣種名稱
    modetrueinteger倉位模式. 0: 單向持倉. 3: 雙向持倉

    響應參數​

    無

    請求示例​

    POST /contract/v3/private/position/switch-mode HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670848915553
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"CHZUSDT",
        "coin": null,
        "mode": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670848915768
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/replace-order.html b/zh-TW/derivatives/contract/replace-order.html index 28c3f26cb7..4710fb6be7 100644 --- a/zh-TW/derivatives/contract/replace-order.html +++ b/zh-TW/derivatives/contract/replace-order.html @@ -4,13 +4,13 @@ 修改委託單 | Bybit API Documentation - +

    修改委託單

    備註

    您只能修改那些未成交或者部分成交的訂單。

    HTTP 請求​

    POST /contract/v3/private/order/replace

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
    pricefalsestring修改後的訂單價格. 若不修改，請不要傳該字段
    qtyfalsestring修改後的訂單數量. 若不修改，請不要傳該字段
    triggerPricefalsestring觸發價格. 若不修改，請不要傳該字段
    takeProfitfalsestring修改後的止盈價格. 若不修改，請不要傳該字段
    stopLossfalsestring修改後的止損價格. 若不修改，請不要傳該字段
    tpTriggerByfalsestring止盈價格觸發類型. 若下單時未設置該值，則調用該接口修改止盈價格時，該字段必傳
    slTriggerByfalsestring止損價格觸發類型. 若下單時未設置該值，則調用該接口修改止損價格時，該字段必傳
    triggerByfalsestring觸發價格的觸發類型. LastPrice, IndexPrice, MarkPrice
    tpLimitPricefalsestring觸發止盈後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效
    slLimitPricefalsestring觸發止損後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效

    響應參數​

    參數類型說明
    orderIdstring訂單Id
    orderLinkIdstring用戶自定義訂單Id

    請求示例​

    POST /contract/v3/private/order/replace HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670554903846
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol": "XRPUSDT",
        "orderId": "5ba57394-0ff0-4cb8-8000-59085d2c3aba",
        "orderLinkId": null,
        "price": "14.5"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "5ba57394-0ff0-4cb8-8000-59085d2c3aba",
            "orderLinkId": ""
        },
        "retExtInfo": {},
        "time": 1670554904609
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/set-risk-limit.html b/zh-TW/derivatives/contract/set-risk-limit.html index 3b098b7a07..2e6653e2fc 100644 --- a/zh-TW/derivatives/contract/set-risk-limit.html +++ b/zh-TW/derivatives/contract/set-risk-limit.html @@ -4,13 +4,13 @@ 設置風險限額 | Bybit API Documentation - +

    設置風險限額

    由於Bybit在2024年3月12日上線了自動調整risk limit功能, 詳情請見這裡, 因此儘管接口能調通, 但是沒有任何意義

    HTTP 請求​

    POST /contract/v3/private/position/set-risk-limit

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    riskIdtrueinteger風險限額Id
    positionIdxtrueinteger倉位標識，用於標識不同倉位
    • 0: 單向持倉模式
    • 1: 買側雙向模式
    • 2: 賣側雙向模式

    響應參數​

    無

    請求示例​

    POST /contract/v3/private/position/set-risk-limit HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670853142896
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"ETHUSDT",
        "riskId": 12,
        "positionIdx": 1
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670853143027
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/tpsl-mode.html b/zh-TW/derivatives/contract/tpsl-mode.html index 78e8f4d7c3..e9221b6184 100644 --- a/zh-TW/derivatives/contract/tpsl-mode.html +++ b/zh-TW/derivatives/contract/tpsl-mode.html @@ -4,14 +4,14 @@ 切換止盈止損模式 | Bybit API Documentation - +

    切換止盈止損模式

    提示

    某種程度上來說，該接口已經廢棄, 原因在於新版的止盈止損機制是基於訂單維度. 這個接口當初主要是用於倉位維度的止盈止損

    但是, 您仍然可以使用該接口, 為某個合約設置一個隱式的止盈止損模式, 因為當您在下單接口或者設置止盈止損接口時, 不傳入字段"tpslMode"時, 系統將會獲取一個默認值, 該 默認值實際上是源於是否調用過該接口做過修改, 不曾修改過的symbol, 都是默認Full

    可以將止盈止損模式設置為部分止盈止損或者全部止盈止損

    備註

    支持USDT永續, 反向永續和反向交割

    HTTP 請求​

    POST /contract/v3/private/position/switch-tpsl-mode

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    tpSlModetruestringFull: 全部倉位止盈止損. Partial: 部分倉位止盈止損

    響應參數​

    無

    請求示例​

    POST /contract/v3/private/position/switch-tpsl-mode HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670849702461
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol":"BTCUSDT",
        "tpSlMode":"Full"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670849702655
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/trading-stop.html b/zh-TW/derivatives/contract/trading-stop.html index f80920ea0e..80b52dc466 100644 --- a/zh-TW/derivatives/contract/trading-stop.html +++ b/zh-TW/derivatives/contract/trading-stop.html @@ -4,14 +4,14 @@ 設置止盈止損 | Bybit API Documentation - +

    設置止盈止損

    該接口可以設置止盈、止損和追蹤止損.

    提示
    • 在提交請求後，系統內部將會自動創建對應類型的條件單
    • 若倉位被平，系統將會調整相關條件訂單數量或者取消這些條件單。
    • 支持USDT永續，USDC永續，反向永續和反向交割.
    信息

    新版止盈止損, 支持既持有全部止盈止損單, 也可以持有部分止盈止損單

    • 全部倉位止盈止損單: 該接口可用於修改該類型的止盈止損單的參數
    • 部分倉位止盈止損單: 該接口僅能新增部分倉位止盈止損單
    備註

    新版止盈止損下, 調用該接口對持倉上的已有的止盈止損進行單邊止盈或者止損修改時, 會導致成對的tp/sl訂單失去綁定關係, 這意味著當通過tp/sl訂單ID調用 取消接口時, 只會取消對應訂單ID的單邊止盈或止損.

    HTTP 請求​

    POST /contract/v3/private/position/trading-stop

    請求參數​

    參數是否必需類型說明
    symboltruestring合約名稱
    takeProfitfalsestring不能小於0. 設置為0時，則表示取消止盈. 部分止盈止損無法通過設置0來取消
    stopLossfalsestring不能小於0. 設置為0時，則表示取消止損. 部分止盈止損無法通過設置0來取消
    tpSizefalsestring止盈倉位數量. 僅部分止盈止損時有效. 注意: tpSize和slSize的數值必須相等
    slSizefalsestring止盈倉位數量. 僅部分止盈止損時有效. 注意: tpSize和slSize的數值必須相等
    tpTriggerByfalsestring止盈價格類型
    slTriggerByfalsestring止損價格類型
    trailingStopfalsestring不能小於0. 設置為0時，則表示取消追蹤止損. 注意: 僅對USDT永續有效
    activePricefalsestring追蹤止損激活價格. 追蹤止損會在到達該價格時觸發
    tpslModefalsestring止盈止損模式. Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損. 由於每個合約都有初始的止盈止損模式(Full), 若曾經修改過, 那麼可能是Partial, 因此若不傳入, 則系統會自動獲取該合約當前的止盈止損模式配置
    tpLimitPricefalsestring觸發止盈後轉換為限價單的價格. 僅tpslMode=Partial且tpOrderType=Limit時有效
    slLimitPricefalsestring觸發止損後轉換為限價單的價格. 僅tpslMode=Partial且slOrderType=Limit時有效
    tpOrderTypefalsestring止盈觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持tpOrderType=Market
    slOrderTypefalsestring止損觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持slOrderType=Market
    positionIdxtrueinteger倉位標識，用於識別倉位.
    • 0: 單向持倉
    • 1: 買側雙向持倉
    • 2: 賣側雙向持倉

    響應參數​

    無

    請求示例​

    POST /contract/v3/private/position/trading-stop HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670852788387
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {
        "symbol": "SOLPERP",
        "takeProfit": "19",
        "stopLoss": "10",
        "activePrice": null,
        "trailingStop": null,
        "tpTriggerBy": null,
        "slTriggerBy": null,
        "tpslMode": "Partial",
        "tpOrderType": "Limit"
        "slOrderType": "Limit"
        "tpSize": "50",
        "slSize": "50",
        "tpLimitPrice": "18",
        "slLimitPrice": "11",
        "positionIdx": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1670852788558
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/wallet-fund.html b/zh-TW/derivatives/contract/wallet-fund.html index 9bf302b773..690a84e102 100644 --- a/zh-TW/derivatives/contract/wallet-fund.html +++ b/zh-TW/derivatives/contract/wallet-fund.html @@ -4,13 +4,13 @@ 查詢錢包資金紀錄 | Bybit API Documentation - +

    查詢錢包資金紀錄

    獲取錢包資金紀錄. 這個接口還展示來自網頁上資產兌換下的兌換紀錄, 其中對應的type兌換類型是ExchangeOrderWithdraw和ExchangeOrderDeposit。

    提示
    • 這個接口返回的關於衍生品帳戶下的劃轉紀錄的內容是不完整的。推薦使用帳戶資產API完成資產劃轉的操作和紀錄檢索。
    • 該接口不顯示2021-07-15之後發生的充值提現記錄。要在此日期之後獲取記錄，您應該調用 查詢充值記錄 和 查詢提現記錄接口。這是由於此時引入了現貨錢包。

    HTTP 請求​

    GET /contract/v3/private/account/wallet/fund-records

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種
    walletFundTypefalsestring資金類型
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring幣種
    > typestring資金類型
    > amountstring金額
    > walletBalancestring錢包餘額
    > execTimestring執行時間戳 (毫秒)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /contract/v3/private/account/wallet/fund-records?limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670931970500
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "list": [
            {
                "coin": "BTC",
                "type": "RealisedPNL",
                "amount": "-0.00003034",
                "walletBalance": "0.68146653",
                "execTime": "1665792000030"
            }
        ],
        "nextPageCursor": "K2tqR0xUQ1B1Tyt1a0ZFeVZRa1I2R2ZOT2pVekNKeGZPOTEyWFNpeXd1ejRmRTFoUkhabnVKVlRBNnFtZGk0dlBhRThLdFNHTGxFdWJGQVFMdXBnZ29Bb3JmSDlkczZHV1p1V1JoZmc2dnlRc1VMZ1ZVYlRXeW51ZUVBT3QycjlYSml3alNZampKTHdrdDJzSzFWdnlWK0djRklqczB1M0JYN04wVXltV0ljPQ=="
    },
        "retExtInfo": {},
        "time": 1670931971341
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/contract/wallet.html b/zh-TW/derivatives/contract/wallet.html index e2995b47f6..e1487f30b1 100644 --- a/zh-TW/derivatives/contract/wallet.html +++ b/zh-TW/derivatives/contract/wallet.html @@ -4,13 +4,13 @@ 錢包餘額 | Bybit API Documentation - +

    錢包餘額

    獲取錢包餘額信息，包括衍生品帳戶和USDC帳戶

    HTTP 請求​

    GET /contract/v3/private/account/wallet/balance

    請求參數​

    參數是否必需類型說明
    coinfalsestring币种
    • 如果不傳參數coin，將返回所有錢包余額
    • 可以傳遞多個幣，逗號隔開，比如：USDT,USDC

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring幣種
    > equitystring總資產淨值
    > walletBalancestring錢包余額
    > positionMarginstring倉位保證金
    > availableBalancestring可用餘額
    > orderMarginstring委托預占用保證金
    > occClosingFeestring倉位占用的平倉手續費
    > occFundingFeestring預占用資金費用
    > unrealisedPnlstring未結盈虧
    > cumRealisedPnlstring累計已結盈虧
    > givenCashstring體驗金. 點擊這裡, 了解更多
    > serviceCashstring抵扣金. 點擊這裡, 了解更多
    > accountIMstringUSDC帳戶的初始保證金
    > accountMMstringUSDC帳戶的維持保證金

    請求示例​

    GET /contract/v3/private/account/wallet/balance?coin=USDC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670923630734
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "list": [
            {
                "coin": "USDC",
                "equity": "1259.7788251",
                "walletBalance": "1259.7488251",
                "positionMargin": "1259.7788251",
                "availableBalance": "1246.7387871",
                "orderMargin": "0",
                "occClosingFee": "0",
                "occFundingFee": "0",
                "unrealisedPnl": "0.03",
                "cumRealisedPnl": "26.6561752",
                "givenCash": "0",
                "serviceCash": "0",
                "accountIM": "13.040038",
                "accountMM": "1.367038"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1670923631261
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/enum.html b/zh-TW/derivatives/enum.html index b1658ba530..b7b90569f4 100644 --- a/zh-TW/derivatives/enum.html +++ b/zh-TW/derivatives/enum.html @@ -4,13 +4,13 @@ 枚舉定義 | Bybit API Documentation - +

    枚舉定義

    category​

    合約

    • linear 正向合約，包含USDT永續
    • inverse 反向合約，包含反向永續, 反向交割

    統一保證金

    • linear 正向合約，包含USDT永續, USDC永續
    • option 期權

    interval​

    • 1 3 5 15 30 60 120 240 360 720 分鐘
    • D 天
    • W 週
    • M 月

    symbol​

    USDT永續:

    • BTCUSDT
    • ETHUSDT

    USDC永續:

    • BTCPERP
    • ETHPERP

    反向永續:

    • BTCUSD
    • ETHUSD

    反向交割:

    • BTCUSDH23 H: 第一季度; 23: 2023
    • BTCUSDM23 M: 第二季度; 23: 2023
    • BTCUSDU23 U: 第三季度; 23: 2023
    • BTCUSDZ23 Z: 第四季度; 23: 2023

    positionIdx​

    • 0 單向持倉
    • 1 買側的雙向持倉
    • 2 賣側的雙向持倉

    positionStatus​

    • Normal
    • Liq 強平中
    • Adl 自動減倉中

    triggerBy​

    • LastPrice
    • MarkPrice
    • IndexPrice

    timeInForce​

    • GoodTillCancel 一直有效至取消
    • ImmediateOrCancel 立即成交或取消
    • FillOrKlii 完全成交或取消
    • PostOnly 被動委託

    orderFilter​

    • Order 普通單
    • StopOrder 條件單

    orderStatus​

    • Created 訂單已經被系統接收但還沒有推送到撮合引擎中
    • New 訂單成功下達
    • Rejected
    • PartiallyFilled
    • Filled
    • PendingCancel 撮合引擎收到了取消申請但是還未成功取消
    • Cancelled
    • Untriggered
    • Triggered
    • Deactivated
    • Active 條件單已經被觸發，並且活動單已經成功創建。該狀態是條件單成功觸發後的終態

    cancelType​

    • CancelByUser
    • CancelByReduceOnly
    • CancelByPrepareLiq CancelAllBeforeLiq 由於強平而取消
    • CancelByPrepareAdl CancelAllBeforeAdl 由於自動減倉而取消
    • CancelByAdmin
    • CancelByTpSlTsClear
    • CancelBySmp

    期權:

    • CancelByUser
    • CancelByReduceOnly
    • CancelAllBeforeLiq 由於強平而取消
    • CancelAllBeforeAdl 由於自動減倉而取消
    • CancelBySettle
    • CancelByCannotAffordOrderCost
    • CancelByPmTrialMmOverEquity
    • CancelByAccountBlocking
    • CancelByDelivery
    • CancelByMmpTriggered
    • CancelByCrossSelfMuch
    • CancelByCrossReachMaxTradeNum
    • CancelByDCP

    stopOrderType​

    • TakeProfit 止盈單
    • StopLoss 止損單
    • TrailingStop 追蹤止損單
    • Stop 條件單
    • PartialTakeProfit 部分止盈單
    • PartialStopLoss 部分止損單

    rejectReason​

    • EC_NoError
    • EC_Others
    • EC_UnknownMessageType
    • EC_MissingClOrdID
    • EC_MissingOrigClOrdID
    • EC_ClOrdIDOrigClOrdIDAreTheSame
    • EC_DuplicatedClOrdID
    • EC_OrigClOrdIDDoesNotExist
    • EC_TooLateToCancel
    • EC_UnknownOrderType
    • EC_UnknownSide
    • EC_UnknownTimeInForce
    • EC_WronglyRouted
    • EC_MarketOrderPriceIsNotZero
    • EC_LimitOrderInvalidPrice
    • EC_NoEnoughQtyToFill
    • EC_NoImmediateQtyToFill
    • EC_PerCancelRequest
    • EC_MarketOrderCannotBePostOnly
    • EC_PostOnlyWillTakeLiquidity
    • EC_CancelReplaceOrder
    • EC_InvalidSymbolStatus

    positionMode​

    • 0 單向持倉模式
    • 3 雙向持倉模式

    execType​

    lastLiquidityInd​

    統一保證金

    • TAKER
    • MAKER

    合約

    • AddedLiquidity 增加流動性
    • RemovedLiquidity 吃流動性

    walletFundType​

    • Deposit 入金
    • Withdraw 提幣
    • RealisedPNL 已結盈虧
    • Commission 佣金
    • Refund 系統返還
    • Prize 贈金
    • ExchangeOrderWithdraw 兌出
    • ExchangeOrderDeposit 兌入
    • ReturnServiceCash 返還手續費贈金
    • Insurance 保險金
    • SubMember 母子帳戶劃轉
    • Coupon 生息券
    • AccountTransfer 帳戶劃轉
    • CashBack 返現

    type​

    • TRANSFER_IN
    • TRANSFER_OUT
    • TRADE
    • SETTLEMENT
    • DELIVERY
    • LIQUIDATION
    • BONUS
    • FEE_REFUND
    • INTEREST
    • CURRENCY_BUY
    • CURRENCY_SELL

    tickDirection​

    • PlusTick 價格上漲
    • ZeroPlusTick 交易的價格與前一筆交易的價格相同，前一筆交易的價格高於前一筆交易的價格
    • MinusTick 價格下跌
    • ZeroMinusTick 交易的價格與前一筆交易的價格相同，前一筆交易的價格低於前一筆交易的價格

    adlRankIndicator​

    • 0 空倉時默認值
    • 1
    • 2
    • 3
    • 4
    • 5

    smpType​

    • 默認: None
    • CancelMaker
    • CancelTaker
    • CancelBoth

    unifiedMarginStatus​

    • 1 普通帳戶
    • 2 已升級到了統一保證金帳戶，僅支持交易期貨和期權
    • 3 已升級到了統一帳戶，支持交易期貨、期權和現貨
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/error.html b/zh-TW/derivatives/error.html index 430acddbeb..a1df669755 100644 --- a/zh-TW/derivatives/error.html +++ b/zh-TW/derivatives/error.html @@ -4,13 +4,13 @@ 錯誤碼 | Bybit API Documentation - +

    錯誤碼

    統一保證金​

    錯誤碼描述
    10000服務超時
    10001參數錯誤
    10002請求無效，請檢查時間戳記和recv_window參數
    10003無效的api_key
    10004錯誤標誌
    10005許可權被拒絕
    10006訪問次數過多
    10008當前用戶被禁止訪問
    10009IP已被禁止
    10010不匹配的IP
    10014請求重複
    10016服務器錯誤
    10018超出IP的頻率限制
    10024合規牆攔截
    10027禁止交易
    110001訂單不存在
    110003訂單價格超出允許範圍
    110004錢包餘額不足
    110005倉位狀態
    110006無法承擔估計的倉位邊際
    110007可用餘額不足
    110008訂單已完成或取消
    110009停止訂單數量超過允許的最大限制
    110010訂單已取消
    110011所做的任何調整都將引發立即清算
    110012可用餘額不足
    110013由於風險限制，無法設定杠杆
    110014可用餘額不足以新增保證金
    110015倉位處於全倉保證金模式下
    110016請求的合約數量超過風險限額，請在重試之前調整風險限額級別
    110017不滿足reduceOnly規則
    110018userId非法
    110019orderId非法
    110020大於500的有效訂單數
    110021超過未結利息
    110022數量已被限制，無法修改訂單以添加數量
    110023本合約僅支持減倉操作，詳情請聯系客服
    110024您有一個現有倉位，因此無法切換倉位模式
    110025倉位模式未修改
    110026未修改全倉/逐倉保證金模式
    110027未修改保證金
    110028存在未結訂單，因此您無法更改倉位模式
    110029對沖模式不適用於此合約
    110030訂單ID重複
    110031風險限額資訊不存在
    110032非法訂單
    110033沒有倉位，無法設定保證金
    110034沒有淨頭寸
    110035清算前未完成取消訂單
    110036全倉保證金模式不允許更改杠杆
    110037用戶設置清單沒有此合約
    110038投資組合保證金模式不允許更改杠杆
    110039維持保證金率過高，可能引發清算
    110040訂單將觸發強制清算，請重新提交訂單
    110041當存在倉位或製造商訂單時，不允許跳過清算
    110042交割前狀態只能减少倉位
    110043未修改設定杠杆
    110044可用保證金不足
    110045錢包餘額不足
    110046所做的任何調整都將引發立即清算
    110047由於可用保證金不足，無法調整風險限額
    110048由於當前/預期持倉價值超過修訂後的風險限額，因此無法調整風險限額
    110049記號筆只能是數位
    110050幣種不在所選範圍內
    110051用戶的可用餘額不能覆蓋當前市場的最低價格
    110052用戶的可用餘額不足以設定價格
    110053用戶可用餘額不能覆蓋當前市場價格和上限價格
    110054此倉位至少有一個止盈連結訂單，因此無法切換止盈和止損模式
    110055此倉位至少有一個止損連結訂單，因此無法切換止盈和止損模式
    110056此倉位至少有一個尾隨止損連結訂單，因此無法切換止盈和止損模式
    110057條件訂單或限制訂單包含TP/SL相關參數
    110058剩餘倉位數量不足，無法設定止盈和止損
    110059在未結訂單部分填充的情况下，不允許修改未結訂單的止盈和止損設定
    110060在完全TP/SL模式下，不允許修改TP/SL
    110061在部分TP/SL模式下，TP/SL設定超過20
    110062未找到機构MMP設定檔。
    110063結算正在進行中！ ｛｛key0｝｝不可用於交易。
    110064修改的合约數不能小於或等於已成交的數量
    110065尚未為您的帳戶啟用MMP。 請聯系您的BD經理。
    110066當前時間不允許交易
    110067不支持統一帳戶
    110068不允許杠杆用戶交易
    110069不允許場外借貸用戶進行交易
    110070ETP合約不允許交易
    3400045設置保證金模式失敗
    340099系統異常

    合約​

    錯誤碼描述
    10000服務超時
    10001參數錯誤
    10002請求無效，請檢查時間戳記和recv_window參數
    10003無效的api_key
    10004錯誤標誌
    10005許可權被拒絕
    10006訪問次數過多
    10008當前用戶被禁止訪問
    10009IP已被禁止
    10010不匹配的IP
    10014請求重複
    10016服務器錯誤
    10018超出IP的頻率限制
    10027禁止交易
    140001訂單不存在
    140003訂單價格超出允許範圍
    140004錢包餘額不足
    140005倉位狀態
    140006無法承擔估計的倉位保證金
    140007可用餘額不足
    140008訂單已完成或取消
    140009停止訂單數量超過允許的最大限制
    140010訂單已取消
    140011所做的任何調整都將引發立即清算
    140012可用餘額不足
    140013由於風險限制，無法設定杠杆
    140014可用餘額不足以新增保證金
    140015倉位在全倉邊緣
    140016請求的合約數量超過風險限額，請在重試之前調整風險限額級別
    140017不滿足僅减少規則
    140018userId非法
    140019orderId非法
    140020大於500的有效訂單數
    140021超過未結利息
    140022數量已被限制，無法修改訂單以添加數量
    140023本合約僅支持減倉操作，詳情請聯系客服
    140024您有一個現有倉位，因此無法切換倉位模式
    140025倉位模式未修改
    140026未修改全倉/逐倉保證金模式
    140027未修改保證金
    140028存在未結訂單，因此您無法更改倉位模式
    140029對沖模式不適用於此合約
    140030訂單ID重複
    140031風險限額資訊不存在
    140032非法訂單
    140033沒有倉位，無法設定保證金
    140034沒有淨頭寸
    140035清算前未完成取消訂單
    140036全倉保證金模式不允許更改杠杆
    140037用戶設置清單沒有此合約
    140038投資組合保證金模式不允許更改杠杆
    140039維持保證金率過高，可能引發清算
    140040訂單將觸發強制清算，請重新提交訂單
    140041當存在倉位或製造商訂單時，不允許跳過清算
    140042交割前狀態只能减少倉位
    140043未修改設定杠杆
    140044可用保證金不足
    140045錢包餘額不足
    140046所做的任何調整都將引發立即清算
    140047由於可用保證金不足，無法調整風險限額
    140048由於當前/預期持倉價值超過修訂後的風險限額，因此無法調整風險限額
    140049記號筆只能是數位
    140050幣種不在所選範圍內
    140051用戶的可用餘額不能覆蓋當前市場的最低價格
    140052用戶的可用餘額不足以設定價格
    140053用戶可用餘額不能覆蓋當前市場價格和上限價格
    140054此倉位至少有一個止盈連結訂單，因此無法切換止盈和止損模式
    140055此倉位至少有一個止損連結訂單，因此無法切換止盈和止損模式
    140056此倉位至少有一個尾隨止損連結訂單，因此無法切換止盈和止損模式
    140057條件訂單或限制訂單包含TP/SL相關參數
    140058剩餘倉位數量不足，無法設定止盈和止損
    140059在未結訂單部分填充的情况下，不允許修改未結訂單的止盈和止損設定
    140060在完全TP/SL模式下，不允許修改TP/SL
    140061在部分TP/SL模式下，TP/SL設定超過20
    140062未找到機构MMP設定檔。
    140063結算正在進行中！ ｛｛key0｝｝不可用於交易。
    140064修改的合約數不能小於或等於填寫的數量
    140065尚未為您的帳戶啟用MMP。 請聯系您的BD經理。
    140066當前時間不允許交易
    140067不支持統一帳戶
    140068不允許杠杆用戶交易
    140069不允許場外借貸用戶進行交易
    140070ETP合約不允許交易
    140071RiskId沒有修改
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/funding-rate.html b/zh-TW/derivatives/public/funding-rate.html index 15ae28a99d..402f96e459 100644 --- a/zh-TW/derivatives/public/funding-rate.html +++ b/zh-TW/derivatives/public/funding-rate.html @@ -4,14 +4,14 @@ 查詢歷史資金費率 | Bybit API Documentation - +

    查詢歷史資金費率

    查詢資金費率，每個symbol的資金費率產生週期不同。假設資金費率為8小時，當前時間是UTC12點，則返回的是上一個結算即UTC8點產生的資金費率。 如要查詢symbol的資金費率時間間隔，請查詢可交易產品規格接口

    時間入参規則
    • 只傳startTime會報錯
    • 只傳endTime，則返回endTime往前的200條數據
    • 都不傳，返回當前時間的往前200條數據

    HTTP請求​

    GET /derivatives/v3/public/funding/history-funding-rate

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse. 默認: linear, 當不傳時，響應返回""
    symboltruestring合約名稱
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 200

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > fundingRatestring資金費率
    > fundingRateTimestampstring資金費率時間戳(毫秒)

    請求示例​

    GET /derivatives/v3/public/funding/history-funding-rate?symbol=BTCPERP&limit=2 HTTP/1.1
    Host: api.bybit.com​​

    響應示例​

        {
            "retCode": 0,
            "retMsg": "OK",
            "result": {
                "category": "",
                "list": [
                    {
                        "symbol": "BTCPERP",
                        "fundingRate": "0.0001",
                        "fundingRateTimestamp": "1671955200000"
                    },
                    {
                        "symbol": "BTCPERP",
                        "fundingRate": "0.0001",
                        "fundingRateTimestamp": "1671926400000"
                    }
                ]
        },
            "retExtInfo": {},
            "time": 1671970750651
        }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/index-kline.html b/zh-TW/derivatives/public/index-kline.html index ab9732232e..be706a2867 100644 --- a/zh-TW/derivatives/public/index-kline.html +++ b/zh-TW/derivatives/public/index-kline.html @@ -4,13 +4,13 @@ 查詢指數價格K線數據 | Bybit API Documentation - +

    查詢指數價格K線數據

    查詢指數價格K線

    HTTP請求​

    GET /derivatives/v3/public/index-price-kline

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse. 默認: linear, 當不傳時，響應返回 ""
    symboltruestring合約名稱
    intervaltruestring時間粒度. 1 3 5 15 30 60 120 240 360 720 D M W
    starttrueinteger開始時間戳 (毫秒)
    endtrueinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 200

    響應參數​

    參數類型說明
    symbolstring合約名稱
    categorystring產品類型
    listarray
    • 一個字符串數組構成單個蠟燭
    • 按照start降序排列
    • 蠟燭數組中的元素分別是start, open, high, low, close

    請求示例​

    GET /derivatives/v3/public/index-price-kline?category=linear&symbol=BTCUSDT&interval=60&start=1668441600000&end=1668528000000&limit=2 HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "symbol": "BTCUSDT",
        "category": "linear",
        "list": [
            [
                "1668445200000",
                "16471.28",
                "16619.57",
                "16445.28",
                "16584.01"
            ],
            [
                "1668441600000",
                "16594.06",
                "16624.76",
                "16358",
                "16471.28"
            ]
        ]
    },
        "retExtInfo": {},
        "time": 1671968874797
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/instrument-info.html b/zh-TW/derivatives/public/instrument-info.html index d4b63f1494..b212324f9f 100644 --- a/zh-TW/derivatives/public/instrument-info.html +++ b/zh-TW/derivatives/public/instrument-info.html @@ -4,13 +4,13 @@ 查詢可交易產品的規格信息 | Bybit API Documentation - +

    查詢可交易產品的規格信息

    查詢全站可交易產品的基礎配置規則信息

    HTTP請求​

    GET /derivatives/v3/public/instruments-info

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse,option. 默認返回期貨
    symbolfalsestring合約名稱.
    • 查詢期權時, category要必傳
    baseCoinfalsestring交易幣種.
    • 僅option有效
    • 不傳時，默認返回BTC相關數據
    limitfalseinteger每頁數量限制. [1,1000]. 默認: 500
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > contractTypestring合約類型. `LinearPerpetual`, `InversePerpetual`, `InverseFutures`
    > statusstring合約狀態
    > baseCoinstring交易幣種. e.g BTCUSDT中的BTC
    > quoteCoinstring報價幣種. e.g BTCPERP中的USDC
    > settleCoinstring結算幣種. e.g BTCUSD的結算幣種是BTC
    > launchTimestring發佈時間 (毫秒)
    > deliveryTimestring交割時間戳 (毫秒). 永續返回`"0"`
    > deliveryFeeRatestring交割費率
    > priceScalestring價格精度
    > leverageFilterObject槓桿屬性
    >> minLeveragestring最低槓桿
    >> maxLeveragestring最高槓桿
    >> leverageStepstring修改槓桿的步長
    > priceFilterObject價格屬性
    >> minPricestring最小訂單價格
    >> maxPricestring最大訂單價格
    >> tickSizestring修改價格的步長
    > lotSizeFilterObject下單數量屬性
    >> maxOrderQtystring單筆訂單的最大下單量
    >> minOrderQtystring單筆訂單的最小下單量
    >> qtyStepstring修改訂單下單量的步長
    >> postOnlyMaxOrderQtystring廢棄, 請參照maxOrderQty
    >> minNotionalValuestring訂單最小名義價值
    > unifiedMarginTradeboolean是否支持統一保證金交易
    > fundingIntervalstring資金費率週期 (分鐘)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /derivatives/v3/public/instruments-info?symbol=BTCPERP&category=linear HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "category": "linear",
        "list": [
            {
                "symbol": "BTCPERP",
                "contractType": "LinearPerpetual",
                "status": "Trading",
                "baseCoin": "BTC",
                "quoteCoin": "USD",
                "launchTime": "1610604231000",
                "deliveryTime": "0",
                "deliveryFeeRate": "",
                "priceScale": "2",
                "leverageFilter": {
                    "minLeverage": "1",
                    "maxLeverage": "125.00",
                    "leverageStep": "0.01"
            },
                "priceFilter": {
                    "minPrice": "0.50",
                    "maxPrice": "999999.00",
                    "tickSize": "0.50"
            },
                "lotSizeFilter": {
                    "maxTradingQty": "20.000",
                    "minTradingQty": "0.001",
                    "qtyStep": "0.001",
                    "postOnlyMaxOrderQty": "100.000",
                    "maxOrderQty": "20.000",
                    "minOrderQty": "0.001",
                    "minNotionalValue": "5"
            },
                "unifiedMarginTrade": true,
                "fundingInterval": 480,
                "settleCoin": "USDC"
            }
        ],
        "nextPageCursor": ""
    },
        "retExtInfo": {},
        "time": 1671969788515
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/kline.html b/zh-TW/derivatives/public/kline.html index 840fef43db..e34226e841 100644 --- a/zh-TW/derivatives/public/kline.html +++ b/zh-TW/derivatives/public/kline.html @@ -4,13 +4,13 @@ 查詢市場價格K線數據 | Bybit API Documentation - +

    查詢市場價格K線數據

    查詢市場價格K線數據

    HTTP請求​

    GET /derivatives/v3/public/kline

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse. 默認: linear, 當不傳時，響應返回""
    symboltruestring合約名稱
    intervaltruestring時間粒度. 1 3 5 15 30 60 120 240 360 720 D M W
    starttrueinteger開始時間戳 (毫秒)
    endtrueinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 200

    響應參數​

    參數類型說明
    symbolstring合約名稱
    categorystring產品類型
    listarray
    • 一個字符串數組構成單個蠟燭
    • 按照start降序排列
    • 蠟燭數組中的元素分別是start, open, high, low, close, volume, turnover

    請求示例​

    GET /derivatives/v3/public/kline?category=linear&symbol=BTCPERP&interval=1&start=1670371140000&end=1670371200000 HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "symbol": "BTCPERP",
        "category": "linear",
        "list": [
            [
                "1670371200000",
                "17077",
                "17084",
                "17077",
                "17084",
                "0.017",
                "290.412"
            ],
            [
                "1670371140000",
                "17074",
                "17077.5",
                "17074",
                "17077",
                "0.006",
                "102.457"
            ]
        ]
    },
        "retExtInfo": {},
        "time": 1671968612436
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/long-short-ratio.html b/zh-TW/derivatives/public/long-short-ratio.html index 9b523289e6..9db96410fd 100644 --- a/zh-TW/derivatives/public/long-short-ratio.html +++ b/zh-TW/derivatives/public/long-short-ratio.html @@ -4,13 +4,13 @@ 查詢多空比 | Bybit API Documentation - +

    查詢多空比

    HTTP請求​

    GET /derivatives/v3/public/account-ratio

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear(僅USDT永續),inverse
    symboltruestring合約名稱
    periodtruestring數據週期. 5min, 15min, 30min, 1h, 4h, 4d
    limitfalseinteger每頁數量限制. [1, 500]. 默認: 50

    響應參數​

    參數類型說明
    listarrayObject
    > symbolstring合約名稱
    > buyRatiostring持多倉的用户比例
    > sellRatiostring持空倉的用户比例
    > timestampstring時間戳 (毫秒)

    請求示例​

    GET /derivatives/v3/public/account-ratio?category=linear&symbol=BTCUSDT&period=1d&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "buyRatio": "0.5777",
                    "sellRatio": "0.4223",
                    "timestamp": "1695772800000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1695785131028
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/mark-kline.html b/zh-TW/derivatives/public/mark-kline.html index 7a14702895..c56cea50e8 100644 --- a/zh-TW/derivatives/public/mark-kline.html +++ b/zh-TW/derivatives/public/mark-kline.html @@ -4,13 +4,13 @@ 查詢標記價格K線數據 | Bybit API Documentation - +

    查詢標記價格K線數據

    查詢標記價格K線

    HTTP請求​

    GET /derivatives/v3/public/mark-price-kline

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse. 默認: linear, 當不傳時，響應返回 ""
    symboltruestring合約名稱
    intervaltruestring時間粒度. 1 3 5 15 30 60 120 240 360 720 D M W
    starttrueinteger開始時間戳 (毫秒)
    endtrueinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 200

    響應參數​

    參數類型說明
    symbolstring合約名稱
    categorystring產品類型
    listarray
    • 一個字符串數組構成單個蠟燭
    • 按照start降序排列
    • 蠟燭數組中的元素分別是start, open, high, low, close

    請求示例​

    GET /derivatives/v3/public/mark-price-kline?symbol=BTCUSD&interval=1&start=1670261100000&end=1670261280000&category=inverse HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "symbol": "BTCUSD",
        "category": "inverse",
        "list": [
            [
                "1670261280000",
                "17064.76",
                "17068.45",
                "17063.5",
                "17067"
            ],
            [
                "1670261220000",
                "17062.5",
                "17064.88",
                "17062.5",
                "17064.76"
            ],
            [
                "1670261160000",
                "17064",
                "17064",
                "17062.5",
                "17062.5"
            ],
            [
                "1670261100000",
                "17072",
                "17072",
                "17064",
                "17064"
            ]
        ]
    },
        "retExtInfo": {},
        "time": 1671968706092
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/open-interest.html b/zh-TW/derivatives/public/open-interest.html index 1e0f09f3a3..90076ee466 100644 --- a/zh-TW/derivatives/public/open-interest.html +++ b/zh-TW/derivatives/public/open-interest.html @@ -4,13 +4,13 @@ 查詢未平倉合約持倉數量 | Bybit API Documentation - +

    查詢未平倉合約持倉數量

    查詢各個合約市場內所有未平倉的數量

    信息
    • 返回單邊數據
    • 最久可以查詢到自合約上線開始的數據

    HTTP請求​

    GET /derivatives/v3/public/open-interest

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse. 默認: linear, 當不傳時，響應返回 ""
    symboltruestring合約名稱
    intervaltruestring時間粒度. 5min 15min 30min 1h 4h 1d
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 50
    cursorfalsestring游標，用於翻頁

    Response Parameters​

    ParameterTypeComments
    symbolstring合約名稱
    categorystring產品類型
    listarrayObject
    > openIntereststring未平倉合約數量
    > timestampstring數據產生的時間戳（毫秒）
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /derivatives/v3/public/open-interest?category=linear&symbol=ETHUSDT&interval=5min&limit=2 HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "ETHUSDT",
            "category": "linear",
            "list": [
                {
                    "openInterest": "411496.22000000",
                    "timestamp": "1677832800000"
                },
                {
                    "openInterest": "411484.61000000",
                    "timestamp": "1677832500000"
                }
            ],
            "nextPageCursor": "lastid%3D44487872"
        },
        "retExtInfo": {},
        "time": 1677832955976
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/option-delivery.html b/zh-TW/derivatives/public/option-delivery.html index 5b305427e9..5368683ced 100644 --- a/zh-TW/derivatives/public/option-delivery.html +++ b/zh-TW/derivatives/public/option-delivery.html @@ -4,13 +4,13 @@ 查詢期權交割價格 | Bybit API Documentation - +

    查詢期權交割價格

    查詢平台交割產品的交割價格，目前僅支持期權

    HTTP請求​

    GET /derivatives/v3/public/delivery-price

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. 僅option
    symbolfalsestring合約名稱
    baseCoinfalsestring交易貨幣. 默認: BTC
    directionfalsestring翻頁方向. prev, next. 默認: next
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 50
    cursorfalsestring游標，用於分頁

    響應參數​

    參數類型說明
    resultTotalSizeinteger返回結果數量
    cursorstring游標，用於分頁
    dataListarrayObject
    > categorystring產品類型
    > symbolstring合約名稱
    > deliveryPricestring交割價格
    > deliveryTimestring交割時間戳 (毫秒)

    請求示例​

    GET /derivatives/v3/public/delivery-price?limit=1&baseCoin=ETH HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "resultTotalSize": 4830,
            "cursor": "0%2C1",
            "dataList": [
                {
                    "category": "option",
                    "symbol": "ETH-25DEC22-1450-C",
                    "deliveryPrice": "1218.856238890",
                    "deliveryTime": "1671955200000"
                }
            ]
    },
        "retExtInfo": {},
        "time": 1671971138308
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/orderbook.html b/zh-TW/derivatives/public/orderbook.html index f9868342c8..19c6077f5e 100644 --- a/zh-TW/derivatives/public/orderbook.html +++ b/zh-TW/derivatives/public/orderbook.html @@ -4,13 +4,13 @@ Order Book (深度) | Bybit API Documentation - +

    Order Book (深度)

    獲取深度數據

    信息

    響應是當前時間的切片數據

    HTTP請求​

    GET /derivatives/v3/public/order-book/L2

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse,option. 默認: linear, 當不傳時，響應返回 ""
    symboltruestring合約名稱. 查詢期權時，category需必傳
    limitfalseinteger每頁數量限制 [1, 500]. 默認: 25. option僅25可用

    響應參數​

    參數類型說明
    sstring合約名稱
    bstringBid, 買方. 按照價格從小到大
    astringAsk, 賣方. 按照價格從小到大
    tsinteger行情服務生成數據時間戳（毫秒）
    uinteger表示數據連續性的id
    seqinteger撮合版本號
  • 該字段可以用於關聯不同檔位的orderbook, 如果值越小, 則說明數據生成越早
  • 期權目前不存在此字段
    • ctsnumber產生此訂單簿數據時來自撮合引擎的時間戳. 可用於與平台成交頻道中的T進行關聯. linear, inverse有這個字段

    請求示例​

    GET /derivatives/v3/public/order-book/L2?category=linear&symbol=BTCPERP&limit=2 HTTP/1.1
    Host: api.bybit.com​

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "s": "BTCUSDT",
            "b": [
                [
                    "68749.6",
                    "40.381"
                ]
            ],
            "a": [
                [
                    "68755.1",
                    "67.505"
                ]
            ],
            "ts": 1716863768890,
            "u": 1109539,
            "seq": 9239580568,
            "cts": 1716863768873
        },
        "retExtInfo": {},
        "time": 1716863769891
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/premium-index-kline.html b/zh-TW/derivatives/public/premium-index-kline.html index 04b400ba42..7d335b2fa3 100644 --- a/zh-TW/derivatives/public/premium-index-kline.html +++ b/zh-TW/derivatives/public/premium-index-kline.html @@ -4,13 +4,13 @@ 查詢溢價指數價格K線數據 | Bybit API Documentation - +

    查詢溢價指數價格K線數據

    查詢溢價指數價格K線數據

    HTTP請求​

    GET /derivatives/v3/public/premium-index-price-kline

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse. 默認: linear, 當不傳時，響應返回 ""
    symboltruestring合約名稱
    intervaltruestring時間粒度. 1 3 5 15 30 60 120 240 360 720 D M W
    starttrueinteger開始時間戳 (毫秒)
    endtrueinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 200

    響應參數​

    參數類型說明
    symbolstring合約名稱
    categorystring產品類型
    listarray
    • 一個字符串數組構成單個蠟燭
    • 按照start降序排列
    • 蠟燭數組中的元素分別是start, open, high, low, close

    請求示例​

    GET /derivatives/v3/public/premium-index-price-kline?symbol=BTCUSDT&interval=D&start=1668441600000&end=1668528000000 HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "symbol": "BTCUSDT",
        "category": "",
        "list": [
            [
                "1668470400000",
                "-0.000754",
                "-0.001071",
                "-0.001072",
                "-0.001072"
            ]
        ]
    },
        "retExtInfo": {},
        "time": 1671969006930
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/risk-limit.html b/zh-TW/derivatives/public/risk-limit.html index d94c2222b6..fc69bc62e4 100644 --- a/zh-TW/derivatives/public/risk-limit.html +++ b/zh-TW/derivatives/public/risk-limit.html @@ -4,13 +4,13 @@ 查詢合約風險限額 | Bybit API Documentation - +

    查詢合約風險限額

    查詢期貨合約的風險限額表

    提示

    什麼是風險限額? 風險限額(USDT合約)

    信息

    當category=linear, 每次請求返回30個symbol的風險限額數據, 請通過cursor來實現翻頁查詢下一組30個symbol的數據

    HTTP請求​

    GET /derivatives/v3/public/risk-limit/list

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse. 默認: linear, 當不傳時，響應返回 ""
    symbolfalsestring合約名稱
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring合約類型
    listarrayObject
    > idstring風險限額id
    > symbolstring合約名稱
    > limitstring風險限制額度
    > maintainMarginstring維持保證金率
    > initialMarginstring初始保證金率
    > isLowerRiskinteger是否是最低風險限額. 1: true, 0: false
    > maxLeveragestring該風險限額允許的最大槓桿
    nextPageCursorstring下一頁游標, 配合cursor使用

    請求示例​

    GET /derivatives/v3/public/risk-limit/list?symbol=ETHPERP HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "",
            "list": [
                {
                    "id": 1,
                    "symbol": "ETHPERP",
                    "limit": "500000",
                    "maintainMargin": "0.01",
                    "initialMargin": "0.015",
                    "isLowestRisk": 1,
                    "maxLeverage": "66.67"
                },
            ...,

                ]
            },
        "retExtInfo": {},
        "time": 1671970615467
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/ticker.html b/zh-TW/derivatives/public/ticker.html index 7b6b460dcb..a2babf5583 100644 --- a/zh-TW/derivatives/public/ticker.html +++ b/zh-TW/derivatives/public/ticker.html @@ -4,13 +4,13 @@ 查詢最新行情信息 | Bybit API Documentation - +

    查詢最新行情信息

    可獲取到快照的最新市場價格，最佳買賣價格，以及過去時間內的交易量等.

    HTTP請求​

    GET /derivatives/v3/public/tickers

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse,option. 默認: linear, 當不傳時，響應返回""
    symbolfalsestring合約名稱.
    • 查詢期權相關合約時，symbol 和 category都是必傳

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > bidPricestring買1價
    > askPricestring賣1價
    > lastPricestring最新市場成交價
    > lastTickDirectionstring價格變化方向
    > prevPrice24hstring24小時前的整點市價
    > price24hPcntstring市場價格相對24h前變化的百分比
    > highPrice24hstring最近24小時的最高價
    > lowPrice24hstring最近24小時的最低價
    > prevPrice1hstring1小時前的整點市價
    > markPricestring標記價格
    > indexPricestring指數價格
    > openIntereststring未平倉合約的數量
    > turnover24hstring最近24小時成交額
    > volume24hstring最近24小時成交量
    > fundingRatestring資金費率
    > nextFundingTimestring下次結算資金費用的時間 (毫秒)
    > predictedDeliveryPricestring預計交割價格. 交割前30分鐘有值
    > basisRatestring交割合約基差率
    > deliveryFeeRatestring交割費率
    > deliveryTimestring交割時間戳 (毫秒)
    > openInterestValuestring未平倉合約價值

    請求示例​

    GET /derivatives/v3/public/tickers?category=linear&symbol=BTCUSDZ22 HTTP/1.1
    Host: api.bybit.com​

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        "category": "inverse",
        "list": [
            {
                "symbol": "BTCUSDZ22",
                "bidPrice": "16825",
                "askPrice": "16825.5",
                "lastPrice": "16825.00",
                "lastTickDirection": "ZeroPlusTick",
                "prevPrice24h": "16830.50",
                "price24hPcnt": "-0.000326",
                "highPrice24h": "16859.50",
                "lowPrice24h": "16798.50",
                "prevPrice1h": "16824.50",
                "markPrice": "16824.02",
                "indexPrice": "16825.28",
                "openInterest": "7653441",
                "turnover24h": "30.80109312",
                "volume24h": "518542",
                "fundingRate": "",
                "nextFundingTime": "0",
                "predictedDeliveryPrice": "0.00",
                "basisRate": "-0.00009093",
                "deliveryFeeRate": "0.0005",
                "deliveryTime": "1672387200000",
                "openInterestValue": "21887.06"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1671969377669
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/public/trade.html b/zh-TW/derivatives/public/trade.html index bd723edc9f..8984fb5323 100644 --- a/zh-TW/derivatives/public/trade.html +++ b/zh-TW/derivatives/public/trade.html @@ -4,13 +4,13 @@ 查詢平台成交歷史 | Bybit API Documentation - +

    查詢平台成交歷史

    獲取平台最近成交數據. 您可以從這裡下載到歸檔的更多的歷史成交數據

    HTTP請求​

    GET /derivatives/v3/public/recent-trade

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型.linear,inverse,option
    • 當category不傳，或者傳的是linear,inverse, 那麼 symbol必傳
    • 當category=option, 那麼symbol is 可選
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種. 默認: BTC. 僅category=option時有效
    optionTypefalsestring期權類型. Call,Put. 僅category=option時有效
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 500

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > execIdstring成交id
    > symbolstring合約名稱
    > pricestring成交價格
    > sizestring成交數量
    > sidestring吃單方向. Buy, Sell
    > timestring成交時間戳 (毫秒)
    > isBlockTradeboolean成交類型是否為大宗交易
    > mPstring標記價格, 期權的特有字段
    > iPstring指數價格, 期權的特有字段
    > mIvstring標記iv, 期權的特有字段
    > ivstringiv, 期權的特有字段

    請求示例​

    GET /derivatives/v3/public/recent-trade?category=linear&symbol=BTCUSDT&limit=1 HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                "execId": "5706445b-8543-59bc-8988-93e0f4a3f0f9",
                "symbol": "BTCUSDT",
                "price": "16814.50",
                "size": "0.001",
                "side": "Buy",
                "time": "1671970297430",
                "isBlockTrade": false
            }
        ]
    },
        "retExtInfo": {},
        "time": 1671970297723
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/rate-limit.html b/zh-TW/derivatives/rate-limit.html index 083785b4bb..d2c66c3c2a 100644 --- a/zh-TW/derivatives/rate-limit.html +++ b/zh-TW/derivatives/rate-limit.html @@ -4,14 +4,14 @@ 頻率限制 | Bybit API Documentation - +

    頻率限制

    IP限頻​

    警告

    如果您收到HTTP 403（拒絕訪問）響應, 您的 IP 已被暫時或永久禁止。 您應立即查看以下指南，以確保您的應用程序不會繼續違反限制。如果您在 30 分鐘後 仍被禁止，則您可能會被永久禁止。

    我們不建議您在這些限制的邊緣運行您的應用程序，以防異常的網絡活動導致意外違規。

    • GET/POST 請求 (共享):
      • 連續 5 秒內每秒不超過 120 個請求
    備註

    所有到api.bybit.com或api.bytick.com的流量共享此限制，無論是訪問現貨、期貨還是期權。

    違反限制後，您的 IP 將被禁止一段時間（通常為 30 分鐘）。 持續違反限制將導致永久禁止。 我們不能撤銷永久禁令或縮短臨時禁令。

    賬戶頻率限製​

    警告

    如果您收到這樣的響應"ret_msg": "Too many visits!", 則表示您觸發了帳戶頻率限制, 請等到頻率限制重置以後, 再繼續發送請求。

    提示

    目前, 統一保證金(unified/v3)的帳戶頻率會有一些不一樣.

    • linear: 按分鐘計算限頻率
    • option: 按秒計算限制頻率

    Bybit基於每秒鍾的滾動時間窗口來做頻率限製，並且是按賬戶（uid）來做劃分限製，每次請求API響應頭(response header)中都會包含如下字段：

    • X-Bapi-Limit-Status - 該接口當前時間窗口剩余可用請求數
    • X-Bapi-Limit - 該接口當前頻率限製上限
    • X-Bapi-Limit-Reset-Timestamp - 如果您已超過該接口當前窗口頻率限製，該字段表示下個可用時間窗口的時間戳（毫秒），即什麽時候可以恢復訪問；如果您未超過該接口當前窗口頻率限製，該字段表示返回的是當前服務器時間（毫秒).

    Http 響應頭示例

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    接口頻率限制表​

    合約​

    路徑頻率
    所有私有接口10 req/s

    如何提高頻率限製​

    請發送郵件到 api@bybit.com，我們會在 1-4 個工作日內答復。郵件內容必須包含以下內容：

    1. 您的姓名和公司名稱和簡介
    2. 您的bybit 賬號uid或註冊郵箱手機號,以及您要申請提頻的交易對
    3. 您上個月的交易量（吃單/掛單）並提供截圖
    4. 簡單介紹您的交易策略和為什麽需要更高限頻
    5. 如果可以，請提供您的成交記錄csv文檔
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/batch-cancel.html b/zh-TW/derivatives/unified/batch-cancel.html index 9ec41913b4..47744e4f96 100644 --- a/zh-TW/derivatives/unified/batch-cancel.html +++ b/zh-TW/derivatives/unified/batch-cancel.html @@ -4,13 +4,13 @@ 批量撤銷委託單 | Bybit API Documentation - +

    批量撤銷委託單

    提示

    該接口可以批量撤銷多筆訂單

    • 您必須指定orderId或者orderLinkId.
    • 若orderId和orderLinkId之間不匹配, 系統將會優先處理orderId
    • 您只能撤銷未成交和部分成交的訂單.
    • 期貨和期權的訂單撤銷無法同時在一次請求裏同時撤單。如果期貨和期權的訂單都在一個請求裏，則根據category的類型，僅會操作與category相匹配的訂單。

    HTTP請求​

    POST /unified/v3/private/order/cancel-batch

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear,option
    requesttruearrayObject
    > symboltruestring合約名稱
    > orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    > orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> categorystring產品類型
    >> symbolstring合約名稱
    >> orderIdstring訂單Id
    >> orderLinkIdstring用戶自定義訂單Id
    retExtInfoObject
    > listarrayObject
    >> codeinteger成功/錯誤碼
    >> msgstring成功/錯誤信息

    請求示例​

    POST /unified/v3/private/order/cancel-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672818987475
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "request": [
            {
                "symbol": "ETHUSDT",
                "orderLinkId": "test-002"
            },
            {
                "symbol": "XRPUSDT",
                "orderLinkId": "test-003"
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "",
                    "orderLinkId": "test-002"
                },
                {
                    "category": "linear",
                    "symbol": "XRPUSDT",
                    "orderId": "",
                    "orderLinkId": "test-003"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "success"
                },
                {
                    "code": 110001,
                    "msg": "order not exists or too late to cancel"
                }
            ]
        },
        "time": 1672818989928
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/batch-place.html b/zh-TW/derivatives/unified/batch-place.html index 709cc142e3..f43b551b3b 100644 --- a/zh-TW/derivatives/unified/batch-place.html +++ b/zh-TW/derivatives/unified/batch-place.html @@ -4,13 +4,13 @@ 批量創建委託單 | Bybit API Documentation - +

    批量創建委託單

    提示

    該接口支持批量創建委託單

    • 下單時需確保帳戶內有足夠的資金。一旦下單，根據訂單所需資金，您的帳戶資金將在訂單生命週期內凍結相應額度，被凍結的資金額度取決於訂單屬性。
    • 同一個請求中只能包含同一種合約的訂單，期權、期貨不可同時下單。僅支持Limit / Market order，不支持條件單。
    • 如果期貨和期權的訂單都在一個請求裏 ，則根據category的類型，僅會操作symbol與category相匹配的訂單。
    • 每個請求包含的訂單數最大10筆訂單。返回的數據列表中分成兩個 list，訂單創建的 list 和創建的信息返回，兩個 list 的訂單是完全序列保持一致的。

    HTTP請求​

    POST /unified/v3/private/order/create-batch

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    requesttruearrayObject
    > symboltruestring合約名稱
    > sidetruestring訂單方向. Buy, Sell
    > orderTypetruestring訂單類型. Market, Limit
    > qtytruestring訂單數量
    > pricefalsestring訂單價格. 當orderType=Market時，設置的價格將被忽略
    > ivfalsestring隱含波動率. 僅option有效. 按照實際值傳慘，如10%，則傳0.1
    > timeInForcetruestring訂單執行策略. GoodTillCancel, ImmediateOrCancel, FillOrKill, PostOnly
    > positionIdxfalseinteger倉位標識. 0: 單向持倉, 1: 買側雙向持倉, 2: 賣側雙向持倉. 統一保證金僅支持單向持倉
    > orderLinkIdfalsestring用戶自定義訂單Id, 最大長度36位，且同一機構下自定義ID支持數字、字母（大小寫）、中劃線、下劃線這些字符的組合
    期貨規則:
    • 該參數選填
    • USDC永續和USDT永續的orderLinkId互相獨立，即orderLinkId可相同
    • 在訂單未完全成交或取消前，orderLinkId需保持不一致; 訂單完全成交或取消後，orderLinkId可使用之前使用過的
      • 期權規則:
    • 該參數必傳
    • 總是唯一
    > reduceOnlyfalseboolean什麼是只減倉? true 將這筆訂單設為只減倉. 只減倉單的止盈止損不生效
    > closeOnTriggerfalseboolean什麼是觸發後平倉委託? 此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行.
    > mmpfalseboolean做市商保護. 僅對期權生效. true表示該訂單是做市商保護訂單

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> categorystring產品類型
    >> symbolstring合約名稱
    >> orderIdstring訂單Id
    >> orderLinkIdstring用戶自定義訂單Id
    >> createAtstring訂單創建時間 (毫秒)
    retExtInfoObject
    > listarrayObject
    >> codeinteger成功/錯誤碼
    >> msgstring成功/錯誤信息

    請求示例​

    POST /unified/v3/private/order/create-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672817108675
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "request": [
            {
                "symbol": "ETHUSDT",
                "orderType": "Limit",
                "side": "Buy",
                "qty": "0.05",
                "price": "1000",
                "timeInForce": "GoodTillCancel",
                "orderLinkId": "test-002",
                "reduceOnly": false,
                "closeOntrigger": false
            },
            {
                "symbol": "XRPUSDT",
                "orderType": "Limit",
                "side": "Buy",
                "qty": "100",
                "price": "0.3",
                "timeInForce": "GoodTillCancel",
                "orderLinkId": "test-003",
                "reduceOnly": false,
                "closeOntrigger": false
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "ce295fcb-8c8a-4f12-89f4-4ab23d38ccd8",
                    "orderLinkId": "test-002",
                    "createAt": "1672817109797"
                },
                {
                    "category": "linear",
                    "symbol": "XRPUSDT",
                    "orderId": "e97f0355-6586-49a4-965f-feb7253cef14",
                    "orderLinkId": "test-003",
                    "createAt": "1672817109796"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "success"
                },
                {
                    "code": 0,
                    "msg": "success"
                }
            ]
        },
        "time": 1672817109804
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/batch-replace.html b/zh-TW/derivatives/unified/batch-replace.html index cc5be601f6..9741bd2db3 100644 --- a/zh-TW/derivatives/unified/batch-replace.html +++ b/zh-TW/derivatives/unified/batch-replace.html @@ -4,13 +4,13 @@ 批量修改委託單 | Bybit API Documentation - +

    批量修改委託單

    提示

    該接口支持批量修改委託單

    • 您只能修改那些未成交或部分成交的訂單. 條件單不支持批量修改..
    • 如果期貨和期權的訂單都在一個請求裏，則根據category的類型，僅會操作與category相匹配的訂單.

    HTTP 請求​

    POST /unified/v3/private/order/replace-batch

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    requesttruearrayObject
    > symboltruestring合約名稱
    > orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    > orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
    > qtyfalsestring修改後的訂單數量. 若不修改，請不要傳該字段
    > pricefalsestring修改後的訂單價格. 若不修改，請不要傳該字段
    > ivfalsestring隱含波動率. 僅對期權有效. 按照實際值傳入, e.g., 對於10%, 則傳入0.1

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> categorystring產品類型
    >> symbolstring合約名稱
    >> orderIdstring訂單Id
    >> orderLinkIdstring用戶自定義訂單Id
    retExtInfoObject
    > listarrayObject
    >> codeinteger成功/錯誤碼
    >> msgstring成功/錯誤信息

    請求示例​

    POST /unified/v3/private/order/replace-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672818010133
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "request": [
            {
                "symbol": "ETHUSDT",
                "orderId": null,
                "price": null,
                "qty": "0.1",
                "orderLinkId": "test-002"
            },
            {
                "symbol": "XRPUSDT",
                "orderId": null,
                "price": "120",
                "qty": null,
                "orderLinkId": "test-003"
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "",
                    "orderLinkId": "test-002"
                },
                {
                    "category": "linear",
                    "symbol": "XRPUSDT",
                    "orderId": "",
                    "orderLinkId": "test-003"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "success"
                },
                {
                    "code": 0,
                    "msg": "success"
                }
            ]
        },
        "time": 1672818011076
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/borrow-history.html b/zh-TW/derivatives/unified/borrow-history.html index 18910e7d29..7700d7ca9a 100644 --- a/zh-TW/derivatives/unified/borrow-history.html +++ b/zh-TW/derivatives/unified/borrow-history.html @@ -4,13 +4,13 @@ 查詢利息記錄 | Bybit API Documentation - +

    查詢利息記錄

    獲取利息記錄，按照創建時間倒敘排列。

    HTTP 請求​

    GET /unified/v3/private/account/borrow-history

    請求參數​

    參數是否必需類型說明
    currencyfalsestringUSDC、USDT、BTC、ETH
    startTimefalseinteger開始時間 (毫秒)
    endTimefalseinteger結束時間 (毫秒)
    directionfalsestring翻頁方向: prev: 上一頁, next: 下一頁, 默認 next
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    nextPageCursorstring游標，用於翻頁
    currencystringnull
    listarrayObject
    > currencystringUSDC、USDT、BTC、ETH
    > createTimeinteger創建時間戳（毫秒）
    > borrowCoststring利息
    > hourlyBorrowRatestring每小時利率
    > InterestBearingBorrowSizestring豁免利息額度
    > costExemptionstring豁免計息成本

    請求示例​

    GET /unified/v3/private/account/borrow-history?limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673078071099
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "1625%3A0%2C1625%3A0",
            "currency": null,
            "list": [
                {
                    "createTime": 1667282700269,
                    "costExemption": "0.00063175360150218",
                    "InterestBearingBorrowSize": "0",
                    "currency": "USDT",
                    "hourlyBorrowRate": "0.000001142",
                    "borrowCost": "0"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1673078071991
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/borrow-rate.html b/zh-TW/derivatives/unified/borrow-rate.html index ec7a893c89..c55a8ef1e3 100644 --- a/zh-TW/derivatives/unified/borrow-rate.html +++ b/zh-TW/derivatives/unified/borrow-rate.html @@ -4,13 +4,13 @@ 借貸利率查詢 | Bybit API Documentation - +

    借貸利率查詢

    HTTP 請求​

    GET /unified/v3/private/account/borrow-rate

    請求參數​

    參數是否必需類型說明
    currencyfalsestring僅USDC, USDT (UMA)

    響應參數​

    參數類型說明
    listarrayObject
    > currencystring抵押品幣種
    > hourlyBorrowRatestring每小時借款利率
    > maxBorrowAmountstring最大可借貸額度
    > freeBorrowAmountstring免息借貸額度

    請求示例​

    GET /unified/v3/private/account/borrow-rate HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673078229194
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "list": [
                {
                    "freeBorrowingAmount": "30000",
                    "currency": "USDT",
                    "maxBorrowingAmount": "2500000",
                    "hourlyBorrowRate": "0.0000055139"
                },
                {
                    "freeBorrowingAmount": "15000",
                    "currency": "USDC",
                    "maxBorrowingAmount": "1500000",
                    "hourlyBorrowRate": "0.00000342460000000000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672023307465
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/cancel-all.html b/zh-TW/derivatives/unified/cancel-all.html index 82d381c2b3..1770d83ab5 100644 --- a/zh-TW/derivatives/unified/cancel-all.html +++ b/zh-TW/derivatives/unified/cancel-all.html @@ -4,13 +4,13 @@ 撤銷所有訂單 | Bybit API Documentation - +

    撤銷所有訂單

    撤銷全部委託單

    提示
    • 若category=linear, 則baseCoin, settleCoin, symbol三個參數必傳其中一個

    HTTP請求​

    POST /unified/v3/private/order/cancel-all

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種
    settleCoinfalsestring結算幣種. 僅期貨有效
    orderFilterfalsestringOrder: 活動單, StopOrder: 條件單

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> categorystring產品類型
    >> symbolstring合約名稱
    >> orderIdstring訂單Id
    >> orderLinkIdstring用戶自定義Id
    retExtInfoObject
    > listarrayObject
    >> codeinteger成功/錯誤碼
    >> msgstring成功/錯誤信息

    请求示例​

    POST /unified/v3/private/order/cancel-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672810386137
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
      "category": "linear",
      "baseCoin": "ETH",
      "settleCoin": null
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "6cba55ea-6996-44f5-bd0f-ac09ffda4ab1",
                    "orderLinkId": "liang-001"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "success"
                }
            ]
        },
        "time": 1672810388787
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/cancel.html b/zh-TW/derivatives/unified/cancel.html index 1b6b75d085..4465bc279d 100644 --- a/zh-TW/derivatives/unified/cancel.html +++ b/zh-TW/derivatives/unified/cancel.html @@ -4,13 +4,13 @@ 撤銷委託單 | Bybit API Documentation - +

    撤銷委託單

    警告
    • 您必須指定orderId或者orderLinkId.
    • 若orderId和orderLinkId之間不匹配, 系統將會優先處理orderId.
    • 您只能撤銷未成交和部分成交的訂單.

    HTTP 請求​

    POST /unified/v3/private/order/cancel

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    symboltruestring合約名稱
    orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
    orderFilterfalsestringOrder: 普通單, StopOrder: 條件單

    響應參數​

    參數類型說明
    orderIdstring訂單Id
    orderLinkIdstring用戶自定義訂單Id

    请求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/unified/v3/private/order/cancel' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1657871228347' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
    "category": "linear",
    "orderId": "4c51a45f-7795-4b38-9b66-3c306b73f112",
    "symbol": "BTCUSDT"
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "4c51a45f-7795-4b38-9b66-3c306b73f112",
            "orderLinkId": "e80d558e-ed"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/dcp.html b/zh-TW/derivatives/unified/dcp.html index 4dfb9a5858..020f56adb4 100644 --- a/zh-TW/derivatives/unified/dcp.html +++ b/zh-TW/derivatives/unified/dcp.html @@ -4,7 +4,7 @@ 設置斷線保護時間 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    設置斷線保護時間

    信息

    什麼是斷線保護 (Disconnection Protect)?​

    Bybit基於websocket私有連接和心跳機制，提供斷線保護功能。這計時從第一次斷開開始。如果Bybit服務器在一段時間內沒有收到客戶端的重連超過10秒（默認）並 恢復心跳“ping”，則客戶端處於“斷線保護”狀態，客戶所有活躍的期權訂單將自動取消。如果在 10 秒內，客戶端重新連接並恢復心跳“ping”，計時會在下次斷線 時重置並重新開始。

    如何啟用斷線保護​

    若您需要開啟/關閉斷線保護功能, 您可以諮詢客戶經理. 開啟後，默認的斷線保護時間為10秒。

    適用對象​

    僅適用於期權交易。

    提示

    API請求發送成功後，系統需要一定的時間才能生效。建議10秒後再查詢或設置。

    HTTP請求​

    POST /derivatives/v3/private/dcp-set-timewindow

    請求參數​

    參數是否必需類型說明
    timeWindowtrueinteger斷線保護時間窗口. [3, 300], 單位: 秒

    響應參數​

    無

    請求示例​

    POST /derivatives/v3/private/dcp-set-timewindow HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675852742375
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
      "timeWindow": 40
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/delivery.html b/zh-TW/derivatives/unified/delivery.html index f3580fccf1..eb994cd783 100644 --- a/zh-TW/derivatives/unified/delivery.html +++ b/zh-TW/derivatives/unified/delivery.html @@ -4,13 +4,13 @@ 查詢交割紀錄 (期權) | Bybit API Documentation - +

    查詢交割紀錄 (期權)

    查詢期權交割紀錄, 返回結果按照deliveryTime降序排列

    HTTP 請求​

    GET /unified/v3/private/delivery-record

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. option
    symbolfalsestring合約名稱
    expDatefalsestring到期日. 格式: 25MAR22. 默認: 返回所有
    directionfalsestringprev: 前一頁, next: 後一頁. 默認: next
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    nextPageCursorstring游標，用於翻頁
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > sidestring方向. Buy,Sell
    > strikestring行權價
    > feestring手續費，正數表支出，負數表收取
    > positionstring交割數量
    > deliveryTimenumber交割時間戳 (毫秒)
    > deliveryPricestring交割價格
    > deliveryRplstring交割已實現盈虧

    Request Example​

    GET /unified/v3/private/delivery-record?category=option&limit=5 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672020598623
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "nextPageCursor": "45%3A0%2C45%3A0",
            "category": "option",
            "list": [
                {
                    "symbol": "BTC-29JUL22-27000-C",
                    "side": "Sell",
                    "deliveryTime": 1659081601928,
                    "strike": "27000",
                    "fee": "0.00000000",
                    "position": "0.0300",
                    "deliveryPrice": "23927.85304688",
                    "deliveryRpl": "0.00000000"
                }
        ]
    },
        "retExtInfo": {},
        "time": 1672020600013
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/exchange.html b/zh-TW/derivatives/unified/exchange.html index 6a51147069..55c31de094 100644 --- a/zh-TW/derivatives/unified/exchange.html +++ b/zh-TW/derivatives/unified/exchange.html @@ -4,13 +4,13 @@ 查詢幣幣兌換紀錄查詢 | Bybit API Documentation - +

    查詢幣幣兌換紀錄查詢

    獲取幣幣兌換紀錄

    HTTP 請求​

    GET /asset/v2/private/exchange/exchange-order-all

    請求參數​

    參數是否必需類型說明
    fromCoinfalsestring兌出幣種. e.g,BTC
    toCoinfalsestring兌入幣種. e.g,USDT

    響應參數​

    參數類型說明
    totalCountstring返回數據數量
    orderarrayObject
    > fromCoinstring兌出幣種
    > fromAmountstring兌出金額
    > toCoinstring兌入幣種
    > toAmountstring兌入金額
    > exchangeRatestring兌換匯率
    > createdTimestring兌換創建時間戳 (秒)
    > exchangeTxIdstring兌換訂單號

    請求示例​

    GET /asset/v2/private/exchange/exchange-order-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673079087093
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "order": [
                {
                    "fromCoin": "ETH",
                    "fromAmount": "0.10000000",
                    "toCoin": "XRP",
                    "toAmount": "372.37487085",
                    "exchangeRate": "3723.74870857",
                    "createdTime": "1672989418000",
                    "exchangeTxId": "251239533285211865273079980032"
                },
                {
                    "fromCoin": "BTC",
                    "fromAmount": "0.10000000",
                    "toCoin": "ETH",
                    "toAmount": "1.38586623",
                    "exchangeRate": "13.85866238",
                    "createdTime": "1672197760000",
                    "exchangeTxId": "145102533285208544812654440448"
                }
            ],
            "totalCount": "2"
        },
        "retExtInfo": {},
        "time": 1673079089361
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/execution-list.html b/zh-TW/derivatives/unified/execution-list.html index cbb4d77af7..aec664b9f3 100644 --- a/zh-TW/derivatives/unified/execution-list.html +++ b/zh-TW/derivatives/unified/execution-list.html @@ -4,13 +4,13 @@ 查詢成交紀錄 (半年) | Bybit API Documentation - +

    查詢成交紀錄 (半年)

    獲取用戶成交紀錄，返回結果按execTime降序排列

    提示
    • 單筆訂單可能會有多次成交
    • 該接口支持查詢半年內數據

    HTTP 請求​

    POST /unified/v3/private/execution/list

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear,option
    symbolfalsestring合約名稱
    orderIdfalsestring訂單Id
    orderLinkIdfalsestring用戶自定義訂單id
    baseCoinfalsestring交易幣種. 僅對option有效. 若不傳，則返回所有類型的交易幣種數據
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    execTypefalsestring成交類型
    directionfalsestringprev: 前一頁, next: 後一頁. 默認: next
    limitfalseinteger每頁數量限制. [1, 100]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型. linear,option
    listarrayObject
    > symbolstring合約名稱
    > orderIdstring訂單Id
    > orderLinkIdstring用戶自定義訂單id
    > sidestring訂單方向. Buy,Sell
    > orderPricestring訂單價格
    > orderQtystring訂單數量
    > leavesQtystring剩餘委託未成交數量，如果訂單被取消了，則 leavesQty 會返回為 0
    > orderTypestring訂單類型. 市價單: Market,限價單: Limit
    > stopOrderTypestring条件单的订单类型。如果该订单不是条件单，则不会返回任何类型
    > execFeestring交易手續費
    > execIdstring成交Id
    > execPricestring成交價格
    > execQtystring成交數量
    > execTypestring交易類型
    > execValuestring成交價值
    > execTimenumber成交時間（毫秒）
    > feeRatestring手續費率
    > blockTradeIdstring大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /unified/v3/private/execution/list?category=linear&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672020216382
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "nextPageCursor": "2203%3A0%2C2203%3A0",
            "category": "option",
            "list": [
            {
                "orderType": "Market",
                "symbol": "ETH-30DEC22-700-C",
                "orderLinkId": "",
                "side": "Sell",
                "orderId": "cc8012bc-ddc1-443c-8dd9-88cfb946d3b0",
                "leavesQty": "0.0000",
                "execTime": 1672018465365,
                "execFee": "0.03656010",
                "feeRate": "0.000300",
                "execId": "f4309658-62be-5f2b-b262-852909c45bba",
                "blockTradeId": "",
                "execPrice": "498.00000000",
                "lastLiquidityInd": "TAKER",
                "orderQty": "0.1000",
                "orderPrice": "496.50000000",
                "execValue": "49.80000000",
                "execType": "Trade",
                "execQty": "0.1000"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1672019908409
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/get-dcp.html b/zh-TW/derivatives/unified/get-dcp.html index 995bdfb315..5d41ff4a13 100644 --- a/zh-TW/derivatives/unified/get-dcp.html +++ b/zh-TW/derivatives/unified/get-dcp.html @@ -4,13 +4,13 @@ 查詢斷線保護配置 | Bybit API Documentation - +

    查詢斷線保護配置

    HTTP請求​

    GET /derivatives/v3/private/query-dcp-info

    請求參數​

    無

    響應參數​

    參數類型說明
    retCodeinteger成功/錯誤碼
    retMsgstring成功/錯誤信息
    dcpStatusstringDCP狀態. ON: 開啟, OFF: 關閉
    timeWindowstring設置的斷線保護時間窗口 (秒)

    請求示例​

    GET /derivatives/v3/private/query-dcp-info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675861979020
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "dcpStatus": "ON",
        "timeWindow": "40"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/get-mmp-state.html b/zh-TW/derivatives/unified/get-mmp-state.html index 9ed2a7541e..3f5bd9ed26 100644 --- a/zh-TW/derivatives/unified/get-mmp-state.html +++ b/zh-TW/derivatives/unified/get-mmp-state.html @@ -4,13 +4,13 @@ 查詢市商保護配置信息 | Bybit API Documentation - +

    查詢市商保護配置信息

    HTTP 請求​

    GET /unified/v3/private/account/mmp-state

    請求參數​

    參數是否必需類型說明
    baseCointruestringBase coin

    響應參數​

    參數類型說明
    resultarrayObject
    > baseCoinstring交易幣種
    > mmpEnabledboolean帳戶是否開啟了mmp
    > windowstring時間窗口 (毫秒)
    > frozenPeriodstring凍結時間長度 (毫秒)
    > qtyLimitstring成交數量上限
    > deltaLimitstringDelta值上限
    > mmpFrozenUntilstring解凍時間戳 (毫秒)
    > mmpFrozenboolean當前是否觸發了mmp凍結.
    • true: mmpFrozenUntil的值有意義
    • false: 請忽略mmpFrozenUntil字段的值

    請求示例​

    POST /unified/v3/private/account/mmp-state HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675842997277
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "baseCoin": "ETH"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "result": [
                {
                    "baseCoin": "BTC",
                    "mmpEnabled": true,
                    "window": "5000",
                    "frozenPeriod": "100000",
                    "qtyLimit": "0.01",
                    "deltaLimit": "0.01",
                    "mmpFrozenUntil": "1675760625519",
                    "mmpFrozen": false
                }
            ]
        },
        "retExtInfo": {},
        "time": 1675843188984
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/leverage.html b/zh-TW/derivatives/unified/leverage.html index addf8b8062..88f78f0865 100644 --- a/zh-TW/derivatives/unified/leverage.html +++ b/zh-TW/derivatives/unified/leverage.html @@ -4,13 +4,13 @@ 設置槓桿倍數 | Bybit API Documentation - +

    設置槓桿倍數

    設置槓桿倍數

    HTTP 請求​

    POST /unified/v3/private/position/set-leverage

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. 僅linear
    symboltruestring合約名稱
    buyLeveragetruestring(0, 風險限額允許的最大槓桿數]. 注意：單倉模式下，buyLeverage需要和sellLeverage保持一致
    sellLeveragetruestring(0, 風險限額允許的最大槓桿數]. 注意：單倉模式下，buyLeverage需要和sellLeverage保持一致

    響應參數​

    無

    請求示例​

    POST /unified/v3/private/position/set-leverage HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672016383313
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "ARUSDT",
        "buyLeverage": "11",
        "sellLeverage": "11"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1672016384347
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/open-order.html b/zh-TW/derivatives/unified/open-order.html index 372e59fcc1..1fb2fed555 100644 --- a/zh-TW/derivatives/unified/open-order.html +++ b/zh-TW/derivatives/unified/open-order.html @@ -4,13 +4,13 @@ 查詢實時委託單 | Bybit API Documentation - +

    查詢實時委託單

    實時查詢未成交或部分成交的訂單信息. 若需要查詢更久的訂單紀錄，請使用查詢歷史訂單接口.

    提示
    • 當orderId和orderLinkId不傳時，最多返回500條紀錄
    • 返回的結果將以createdTime從新到舊排序.

    HTTP 請求​

    GET /unified/v3/private/order/unfilled-orders

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種. 若category=option，不傳時，默認返回BTC相關數據
    orderIdfalsestring訂單id
    orderLinkIdfalsestring用戶自定義訂單Id
    orderFilterfalsestringOrder: 普通單, StopOrder: 條件單
    directionfalsestring翻頁方向. prev: 向前翻頁, next: 向後翻頁. 默認: next
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listarrayObject
    > orderIdstring訂單Id
    > orderLinkIdstring用戶自定義ID
    > blockTradeIdstringParadigm大宗交易ID
    > symbolstring合約名稱
    > ivstring隱含波動率. linear沒有該字段
    > pricestring訂單價格
    > qtystring訂單數量
    > sidestring方向. Buy,Sell
    > orderStatusstring訂單狀態
    > orderTypestring訂單類型. Market,Limit
    > stopOrderTypestring條件單類型. option沒有該字段
    > cumExecValuestring訂單累計成交價值
    > cumExecFeestring訂單累計成交的手續費
    > cumExecQtystring訂單累計成交數量
    > tpTriggerBystring觸發止盈的價格類型. option沒有該字段
    > slTriggerBystring觸發止損的價格類型. option沒有該字段
    > timeInForcestring執行策略
    > basePricestring當前市價，用於條件單
    > triggerBystring觸發價格的觸發類型. option沒有該字段
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格. option沒有該字段
    > leavesQtystring訂單剩餘未成交的數量
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. option沒有該字段
    > takeProfitstring止盈價格. option沒有該字段
    > stopLossstring止損價格. option沒有該字段
    > orderIMstring訂單初始保證金. 組合保證金模式下，該字段返回空字符串
    > createdTimenumber創建訂單的時間戳 (毫秒)
    > updatedTimenumber訂單更新的時間戳 (毫秒)

    請求示例​

    GET /unified/v3/private/order/unfilled-orders?category=option&baseCoin=BTC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1673079658059
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "d00b5b7b-4e05-4a12-a81c-8afb6ddf76bc%3A1673079539417%2Cd00b5b7b-4e05-4a12-a81c-8afb6ddf76bc%3A1673079539417",
            "category": "linear",
            "list": [
                {
                    "symbol": "MATICUSDT",
                    "orderType": "Limit",
                    "orderLinkId": "",
                    "orderId": "d00b5b7b-4e05-4a12-a81c-8afb6ddf76bc",
                    "stopOrderType": "UNKNOWN",
                    "orderStatus": "New",
                    "takeProfit": "",
                    "cumExecValue": "0.00000000",
                    "blockTradeId": "",
                    "price": "1.00000000",
                    "createdTime": 1673079539417,
                    "tpTriggerBy": "UNKNOWN",
                    "timeInForce": "PostOnly",
                    "basePrice": "",
                    "updatedTime": 1673079539426,
                    "side": "Sell",
                    "triggerPrice": "",
                    "cumExecFee": "0.00000000",
                    "slTriggerBy": "UNKNOWN",
                    "leavesQty": "500.0000",
                    "closeOnTrigger": true,
                    "cumExecQty": "0.00000000",
                    "reduceOnly": true,
                    "qty": "500.0000",
                    "stopLoss": "",
                    "triggerBy": "UNKNOWN",
                    "orderIM": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1673079551691
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/order-list.html b/zh-TW/derivatives/unified/order-list.html index 692c7b5280..0cfa290b4e 100644 --- a/zh-TW/derivatives/unified/order-list.html +++ b/zh-TW/derivatives/unified/order-list.html @@ -4,13 +4,13 @@ 查詢歷史訂單 | Bybit API Documentation - +

    查詢歷史訂單

    提示

    獲取歷史訂單紀錄. 由於訂單創建/撤銷是異步的, 該接口返回數據可能會有延遲. 若您想實時獲取訂單信息, 您可以查詢該接口或者通過websocket推送(推薦)

    HTTP 請求​

    GET /unified/v3/private/order/list

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種. 若category=option，不傳時，默認返回BTC相關數據
    orderIdfalsestring訂單Id
    orderLinkIdfalsestring用戶自定義訂單Id
    orderStatusfalsestring訂單狀態。不傳則默認查詢所有狀態
    orderFilterfalsestringOrder: 普通單, StopOrder: 條件單
    directionfalsestring翻頁方向. prev: 向前, next: 向後. 默認: next
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listarrayObject
    > orderIdstring訂單Id
    > orderLinkIdstring用戶自定義Id
    > blockTradeIdstringParadigm大宗交易Id
    > symbolstring合約名稱
    > ivstring隱含波動率. linear沒有該字段
    > pricestring訂單價格
    > qtystring訂單數量
    > sidestring方向. Buy,Sell
    > orderStatusstring訂單狀態
    > orderTypestring訂單類型. Market,Limit
    > stopOrderTypestring條件單類型. option沒有該字段
    > rejectReasonstring被拒絕原因
    > cumExecValuestring訂單累計成交價值
    > cumExecFeestring訂單累計成交的手續費
    > cumExecQtystring訂單累計成交數量
    > tpTriggerBystring觸發止盈的價格類型. option沒有該字段
    > slTriggerBystringStop loss price. option沒有該字段
    > timeInForcestring執行策略
    > basePricestring當前市價，用於條件單
    > triggerBystring觸發價格的觸發類型. option沒有該字段
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格. option沒有該字段
    > leavesQtystring訂單剩餘未成交的數量
    > leavesValuestring訂單剩餘未成交的價值. option沒有該字段
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. option沒有該字段
    > takeProfitstring止盈價格. option沒有該字段
    > stopLossstring止損價格. option沒有該字段
    > orderIMstring訂單初始保證金. 組合保證金模式下，該字段返回空字符串
    > createdTimenumber創建訂單的時間戳 (毫秒)
    > updatedTimenumber訂單更新的時間戳 (毫秒)

    請求示例​

    GET /unified/v3/private/order/list?category=linear&orderFilter=StopOrder&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672811957817
    X-BAPI-RECV-WINDOW: 5000
    cdn-request-id: test-002

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "c6f055d9-7f21-4079-913d-e6523a9cfffa%3A1672216686849%2Cc6f055d9-7f21-4079-913d-e6523a9cfffa%3A1672216686849",
            "category": "linear",
            "list": [
                {
                    "symbol": "ETHPERP",
                    "orderType": "Limit",
                    "orderLinkId": "linear-004",
                    "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
                    "stopOrderType": "Stop",
                    "orderStatus": "Deactivated",
                    "takeProfit": "",
                    "cumExecValue": "0",
                    "blockTradeId": "",
                    "rejectReason": "EC_NoError",
                    "price": "1050",
                    "createdTime": 1672216686849,
                    "tpTriggerBy": "UNKNOWN",
                    "timeInForce": "GoodTillCancel",
                    "basePrice": "1188",
                    "leavesValue": "0",
                    "updatedTime": 1672217377166,
                    "side": "Sell",
                    "triggerPrice": "1145.00000000",
                    "cumExecFee": "0",
                    "slTriggerBy": "UNKNOWN",
                    "leavesQty": "0",
                    "closeOnTrigger": false,
                    "cumExecQty": "0",
                    "reduceOnly": false,
                    "qty": "0.15",
                    "stopLoss": "",
                    "triggerBy": "MarkPrice",
                    "orderIM": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672811958171
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/place-order.html b/zh-TW/derivatives/unified/place-order.html index 08c6a584f6..d81056e60a 100644 --- a/zh-TW/derivatives/unified/place-order.html +++ b/zh-TW/derivatives/unified/place-order.html @@ -4,7 +4,7 @@ 創建委託單 | Bybit API Documentation - + @@ -16,7 +16,7 @@ 該訂單ID去取消活動委托，同時要求您傳遞的自定義訂單ID 最大長度不超過36個字段且唯一。

  • 訂單持有上限: 期貨: 單個账户针对合约可持有每个 symbol 最多可同时持有500个普通活动订单。这是针对合约的，因此可以允许出现例如：账户同时持有300个BTCUSD的活动单、 280个ETHUSD合约的活动单。針對條件單，單個帳戶針對合約可持有每個 symbol 最多同時持有 10 個條件單。 期權: 最多可持有100個委託單

  • 期權不支持創建條件單

    • HTTP 請求​

    POST /unified/v3/private/order/create

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    symboltruestring合約名稱
    sidetruestring方向. Buy, Sell
    orderTypetruestring訂單類型. Market, Limit
    qtytruestring下單數量
    pricefalsestring訂單價格. orderType=Market時，值將被忽略
    basePricefalsestring當前市價
    • 用於和triggerPrice值進行比較，確定當前條件委托是看空到triggerPrice時觸發還是看多到triggerPrice觸發
    • 主要是用來標識當前條件單預期的方向
    triggerPricefalsestring觸發價格. 如果您期望價格上漲时觸發您的條件訂單, 請確保:
    triggerPrice > max(market price, basePrice)
    否則, triggerPrice < min(market price, basePrice)
    triggerByfalsestring觸發價格類型. LastPrice, IndexPrice, MarkPrice. 默認: LastPrice
    ivfalsestring隱含波動率. 僅適用於option. 按照實際值傳慘，如10%，則傳0.1
    timeInForcetruestring訂單執行策略 GoodTillCancel, ImmediateOrCancel, FillOrKill, PostOnly
    positionIdxfalseinteger倉位標識. 0: 單向持倉, 1: 買側雙向持倉, 2: 賣側雙向持倉. 統一保證金僅支持單向持倉
    orderLinkIdfalsestring用戶自定義訂單ID, 最大長度36位，且同一機構下自定義ID支持數字、字母（大小寫）、中劃線、下劃線這些字符的組合
    期貨規則:
    • 該參數選填
    • USDC永續和USDT永續的orderLinkId互相獨立，即orderLinkId可相同
    • 在訂單未完全成交或取消前，orderLinkId需保持不一致; 訂單完全成交或取消後，orderLinkId可使用之前使用過的
      • 期權規則:
    • 該參數必傳
    • 總是唯一
    takeProfitfalsestring止盈價格
    stopLossfalsestring止損價格
    tpTriggerByfalsestring止盈激活價格類型，MarkPrice, IndexPrice, 默認:LastPrice
    slTriggerByfalsestring止損激活價格類型. MarkPrice, IndexPrice, 默認:LastPrice
    reduceOnlyfalseboolean什麼是只減倉? true 將這筆訂單設為只減倉. 只減倉單的止盈止損不生效
    closeOnTriggerfalseboolean什麼是觸發後平倉委託? 此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行.
    mmpfalseboolean做市商保護. 僅對期權生效. true表示該訂單是做市商保護訂單

    響應參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring用戶自定義訂單ID

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/unified/v3/private/order/create' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1657871228347' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "symbol": "BTCUSDT",
        "orderType": "Limit",
        "side": "Buy",
        "qty": "0.01",
        "price": "20002",
        "timeInForce": "GoodTillCancel",
        "category": "linear"
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "e10b0716-7c91-4091-b98a-1fa0f401c7d5",
            "orderLinkId": "test0000003"
        },
        "retExtInfo": {},
        "time": 1664441344238
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/position-info.html b/zh-TW/derivatives/unified/position-info.html index 25eafaccbf..b53558bdfa 100644 --- a/zh-TW/derivatives/unified/position-info.html +++ b/zh-TW/derivatives/unified/position-info.html @@ -4,13 +4,13 @@ 查詢持倉 (實時) | Bybit API Documentation - +

    查詢持倉 (實時)

    該接口可以獲取用戶的持倉信息，比如持倉數量，累計盈虧等

    HTTP 請求​

    GET /unified/v3/private/position/list

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種.
    • 僅category=option時有效, 若不傳，則僅返回BTC持倉
    settleCoinfalsestring結算幣種
    directionfalsestring翻頁方向. prev: 向前, next: 向後. 默認: next
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    nextPageCursorstring游標，用於翻頁
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > leveragestring槓桿倍數. 注意: 組合保證金模式下，該字段返回""，槓桿規則失效
    > updatedTimeinteger倉位數據更新時間戳 (ms)
    > sidestring訂單方向. `Buy`, `Sell`
    > positionValuestring倉位價值
    > takeProfitstring止盈價格
    > tpslModestring止盈止損模式. `Partial`, `Full`
    > riskIdinteger風險限額ID. 注意: 組合保證金模式下，該字段返回0，風險限額規則失效
    > trailingStopstring追蹤止損 (距離當前價格的距離)
    > entryPricestring平均入場價
    > unrealisedPnlstring未結盈虧
    > markPricestring標記價格
    > sizestring倉位大小
    > stopLossstring止損價格
    > cumRealisedPnlstring累計已結盈虧
    > positionMMstring倉位維持保證金. 組合保證金模式下，該字段返回""
    > createdTimeinteger建立倉位時間戳 (毫秒)
    > positionIdxinteger倉位標識, 用于在不同仓位模式下标识仓位
  • `0`: 單向持倉, 統一保證金只有單向持倉
    • > positionIMstring倉位初始保證金. 組合保證金模式下，該字段返回""

    請求示例​

    GET /unified/v3/private/position/list?category=linear&symbol=XRPUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672820718517
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "updateAt%3D1672819200214",
            "category": "linear",
            "list": [
                {
                    "symbol": "XRPUSDT",
                    "updatedTime": 1672819200214,
                    "leverage": "10",
                    "side": "Buy",
                    "positionValue": "34.91000000",
                    "takeProfit": "",
                    "tpslMode": "Partial",
                    "riskId": 41,
                    "trailingStop": "0",
                    "entryPrice": "0.34910000",
                    "unrealisedPnl": "0.00000000",
                    "markPrice": "0.34910000",
                    "size": "100.0000",
                    "cumRealisedPnl": "-0.02444200",
                    "stopLoss": "",
                    "positionMM": "0.36795140",
                    "createdTime": 1672016298024,
                    "positionIdx": 0,
                    "positionIM": "3.50985140"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672820720159
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/replace-order.html b/zh-TW/derivatives/unified/replace-order.html index bfe1d1938d..efdfe264e3 100644 --- a/zh-TW/derivatives/unified/replace-order.html +++ b/zh-TW/derivatives/unified/replace-order.html @@ -4,13 +4,13 @@ 修改委託單 | Bybit API Documentation - +

    修改委託單

    警告

    您只能修改那些未成交或者部分成交的訂單。

    HTTP 請求​

    POST /unified/v3/private/order/replace

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    symboltruestring合約名稱
    orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
    orderFilterfalsestringOrder: 普通單, StopOrder: 條件單
    ivfalsestring隱含波動率. 僅對期權有效. 按照實際值傳入, e.g., 對於10%, 則傳入0.1
    triggerPricefalsestring觸發價格. 若希望市場趨勢是上漲至觸發條件單, 則確保:
    triggerPrice > max(market price, basePrice) 否則,
    triggerPrice < min(market price, basePrice)
    qtyfalsestring修改後的訂單數量. 若不修改，請不要傳該字段
    pricefalsestring修改後的訂單價格. 若不修改，請不要傳該字段
    takeProfitfalsestring修改後的止盈價格. 若不修改，請不要傳該字段
    stopLossfalsestring修改後的止損價格. 若不修改，請不要傳該字段
    tpTriggerByfalsestring止盈價格觸發類型. 若下單時未設置該值，則調用該接口修改止盈價格時，該字段必傳
    slTriggerByfalsestring止損價格觸發類型. 若下單時未設置該值，則調用該接口修改止損價格時，該字段必傳
    triggerByfalsestring觸發價格的觸發類型

    響應參數​

    參數類型說明
    orderIdstring訂單Id
    orderLinkIdstring用戶自定義訂單Id

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/unified/v3/private/order/replace' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1657871228347' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "category": "linear",
        "symbol":"BTCUSDT",
        "orderId":"1a1ae001-2034-4a6b-8b25-45aa9100b1ec",
        "price":"35000"
        }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1a1ae001-2034-4a6b-8b25-45aa9100b1ec",
            "orderLinkId": "e80d558e-ed"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/reset-mmp.html b/zh-TW/derivatives/unified/reset-mmp.html index 5f358690de..56ed77cf7b 100644 --- a/zh-TW/derivatives/unified/reset-mmp.html +++ b/zh-TW/derivatives/unified/reset-mmp.html @@ -4,13 +4,13 @@ 重置市商保護凍結 | Bybit API Documentation - +

    重置市商保護凍結

    信息

    一旦mmp被觸發, 您的帳戶可以調用該接口進行主動解凍。

    HTTP 請求​

    POST /unified/v3/private/account/mmp-reset

    請求參數​

    參數是否必需類型說明
    baseCointruestring交易幣種

    響應參數​

    無

    請求示例​

    POST /unified/v3/private/account/mmp-reset HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675842997277
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "baseCoin": "ETH"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/risk-limit.html b/zh-TW/derivatives/unified/risk-limit.html index d5d892f1f5..8fbc6bea1f 100644 --- a/zh-TW/derivatives/unified/risk-limit.html +++ b/zh-TW/derivatives/unified/risk-limit.html @@ -4,14 +4,14 @@ 設置風險限額 | Bybit API Documentation - +

    設置風險限額

    風險限額會限制你在不同的保證金要求下的可持倉的最大倉位數量，如果要持有更多的倉位，需要更多的保證金要求。本接口可以設置單個倉位的風險限額， 下單時如果超過當前的風險限額，則會被拒絕。點擊這裡了解更多關於風險限額.

    提示

    您可以獲取通過該接口查詢到風險限額信息.

    HTTP 請求​

    POST /unified/v3/private/position/set-risk-limit

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear
    symboltruestring合約名稱
    riskIdtrueinteger風險限額Id
    positionIdxfalseinteger倉位標識，用於標識不同倉位. 0: 單倉模式, 統一保證金僅有單倉模式

    響應參數​

    無

    請求示例​

    POST /unified/v3/private/position/set-risk-limit HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672016123862
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "BTCUSDT",
        "riskId": 2,
        "positionIdx": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1672016125676
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/set-mmp.html b/zh-TW/derivatives/unified/set-mmp.html index fac03c3aae..7199394fa2 100644 --- a/zh-TW/derivatives/unified/set-mmp.html +++ b/zh-TW/derivatives/unified/set-mmp.html @@ -4,7 +4,7 @@ 设置市商保護 | Bybit API Documentation - + @@ -13,7 +13,7 @@ 在短時間內的總交易額超過了配置的限額，該賬戶的做市商保護將被觸發。當做市商保護被觸發時，賬戶現有的做市商保護訂單（被標記為做市商保護的訂單）將被 交易引擎自動取消，而該賬戶新的做市商保護訂單將在未來一段時間（稱為凍結期）被拒絕（常規非MMP訂單不受影響）。用戶可以利用這段時間重新評估行情並修改報價。

    如何開通MMP​

    您可通過郵件Bybit【financial.inst@bybit.com】或聯繫對應的客戶經理申請開通。 開通後，MMP的默認配置為:

    參數類型說明默認值
    baseCoinstring交易幣種BTC
    windowstring時間窗口 (毫秒)5000
    frozenPeriodstring凍結時間段 (毫秒)100
    qtyLimitstring成交數量上限100
    deltaLimitstringDelta值上限100

    適用對象​

    僅適用於期權交易. 當創建期權訂單時, 設置參數mmp=true, 則表示將此訂單納入市商保護。

    HTTP 請求​

    POST /unified/v3/private/account/mmp-modify

    請求參數​

    參數是否必需類型說明
    baseCointruestring交易幣種
    windowtruestring時間窗口 (毫秒)
    frozenPeriodtruestring凍結時間長度 (毫秒). 設置為"0"則表示帳戶會保持凍結狀態，除非手動重置
    qtyLimittruestring成交數量上限 (正數，至多2位小數)
    deltaLimittruestringDelta上限 (正數，至多2位小數)

    響應參數​

    無

    請求示例​

    POST /unified/v3/private/account/mmp-modify HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675833524616
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
        "baseCoin": "ETH",
        "window":"5000",
        "frozenPeriod":"100000",
        "qtyLimit":"50",
        "deltaLimit":"20"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/settlement.html b/zh-TW/derivatives/unified/settlement.html index eb84d8ec16..edc8087e9b 100644 --- a/zh-TW/derivatives/unified/settlement.html +++ b/zh-TW/derivatives/unified/settlement.html @@ -4,13 +4,13 @@ 查詢結算紀錄 (USDC永續) | Bybit API Documentation - +

    查詢結算紀錄 (USDC永續)

    查詢USDC永續的結算紀錄

    HTTP 請求​

    GET /unified/v3/private/settlement-record

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear
    symbolfalsestring合約名稱
    directionfalsestringprev: 前一頁, next: 後一頁. 默認: next
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    nextPageCursorstring游標，用於翻頁
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > sidestring方向. Buy,Sell
    > sizestring倉位大小
    > sessionAvgPricestring結算價格
    > markPricestring標記價格
    > realisedPnlstring已實現盈虧
    > timestring結算時間 (毫秒)

    請求示例​

    GET /unified/v3/private/settlement-record?category=linear&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672020804664
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "nextPageCursor": "1516%3A0%2C1516%3A0",
            "category": "linear",
            "list": [
            {
                "realisedPnl": "0.72230000",
                "symbol": "BTCPERP",
                "side": "Buy",
                "markPrice": "19769.82000000",
                "size": "0.0100",
                "time": "1666828800000",
                "sessionAvgPrice": "19769.82000000"
            },
        ]
    },
        "retExtInfo": {},
        "time": 1672020805170
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/tp-sl-mode.html b/zh-TW/derivatives/unified/tp-sl-mode.html index 18877e2eee..a30e75707f 100644 --- a/zh-TW/derivatives/unified/tp-sl-mode.html +++ b/zh-TW/derivatives/unified/tp-sl-mode.html @@ -4,13 +4,13 @@ 切換止盈止損模式 | Bybit API Documentation - +

    切換止盈止損模式

    可以將止盈止損模式設置為部分止盈止損或者全部止盈止損

    HTTP 請求​

    POST /unified/v3/private/position/tpsl/switch-mode

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear
    symboltruestring合約名稱
    tpSlModetruestring止盈止損模式. Full, Partial

    響應參數​

    無

    請求示例​

    POST /unified/v3/private/position/tpsl/switch-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672016302990
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "XRPUSDT",
        "tpSlMode": "Partial"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1672016303452
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/trading-stop.html b/zh-TW/derivatives/unified/trading-stop.html index 05bb47af8b..72f02aea75 100644 --- a/zh-TW/derivatives/unified/trading-stop.html +++ b/zh-TW/derivatives/unified/trading-stop.html @@ -4,13 +4,13 @@ 設置止盈止損 | Bybit API Documentation - +

    設置止盈止損

    該接口可以設置止盈、止損和追蹤止損

    提示

    在提交請求後，系統內部將會自動創建對應類型的條件單。若倉位被平，系統將會調整相關條件訂單數量或者取消這些條件單。

    HTTP 請求​

    POST /unified/v3/private/position/trading-stop

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear
    symboltruestring合約名稱
    takeProfitfalsestring不能小於0. 設置為0時，則表示取消止盈. 部分止盈止損無法通過設置0來取消
    stopLossfalsestring不能小於0. 設置為0時，則表示取消止損. 部分止盈止損無法通過設置0來取消
    trailingStopfalsestring不能小於0. 設置為0時，則表示取消追蹤止損. 注意: 僅對USDT永續有效
    tpTriggerByfalsestring止盈價格類型
    slTriggerByfalsestring止損價格類型
    activePricefalsestring追蹤止損激活價格. 追蹤止損會在到達該價格時觸發
    tpSizefalsestring止盈倉位數量. 僅部分止盈止損時有效. 注意: 部分止盈止損模式僅限USDT永續
    slSizefalsestring止盈倉位數量. 僅部分止盈止損時有效. 注意: 部分止盈止損模式僅限USDT永續
    positionIdxtrueinteger倉位標識，用於識別倉位. 0: 單向持倉，對於統一保證金，僅有單向持倉模式

    響應參數​

    無

    請求示例​

    POST /unified/v3/private/position/trading-stop HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXX
    X-BAPI-API-KEY: XXXX
    X-BAPI-TIMESTAMP: 1672017116301
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol":"BTCUSDT",
        "takeProfit":"18000",
        "stopLoss":"15500",
        "tpTriggerBy":"MarkPrice",
        "slTriggerBy":"MarkPrice",
        "trailingStop": null,
        "activePrice": null,
        "slSize": "0.05",
        "tpSize": "0.1",
        "positionIdx": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1672017116958
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/transaction-log.html b/zh-TW/derivatives/unified/transaction-log.html index 377c5762bf..b4d6fcdca8 100644 --- a/zh-TW/derivatives/unified/transaction-log.html +++ b/zh-TW/derivatives/unified/transaction-log.html @@ -4,13 +4,13 @@ 查詢交易日誌 | Bybit API Documentation - +

    查詢交易日誌

    UNIFIED賬戶的交易日誌。

    HTTP 請求​

    GET /unified/v3/private/account/transaction-log

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear,option
    currencytruestring幣種. 比如：USDC、USDT、BTC、ETH
    baseCoinfalsestring交易幣種
    typefalsestring默認返回該category下所有交易日誌（除劃轉外）. 注意: 查詢轉入轉出日誌，必須要傳 type=TRANSFER_IN，type=TRANSFER_OUT，否則查不到劃轉日誌.
    startTimefalseinteger開始時間戳（毫秒）
    endTimefalseinteger結束時間戳（毫秒）
    directionfalsestring搜索方向：prev:上一頁,next:下一頁,默認為 next
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於分頁

    響應參數​

    參數類型說明
    categorystring產品類型
    currencystring幣種
    listarrayObject
    > transactionTimenumber交易時間戳 (毫秒)
    > typestring類型
    > symbolstring合約名稱
    > sidestring方向. Buy,Sell,None
    > qtystring訂單數量
    > sizeinteger倉位數量
    > tradePricestring交易價格
    > fundingstring資金費用
    > feestring手續費，取資產的fee，正數表示用戶付出xx手續費，負數表示賺取
    > cashFlowstring現金流
    > changestring變更
    > cashBalancestring余額（當前幣種）
    > feeRatestring手續費率
    > tradeIdstring交易ID
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義訂單ID
    nextPageCursorstring游標，用於分頁

    請求示例​

    GET /unified/v3/private/account/transaction-log?category=linear&currency=USDC&limit=1&type=SETTLEMENT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672023156071
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "nextPageCursor": "1516%3A0%2C1516%3A0",
            "currency": "USDC",
            "category": "linear",
            "list": [
            {
                "symbol": "BTCPERP",
                "side": "None",
                "funding": "0.00000000",
                "orderLinkId": "",
                "orderId": "",
                "fee": "",
                "change": "0.00000000",
                "cashFlow": "0.00000000",
                "transactionTime": 1666857600000,
                "type": "SETTLEMENT",
                "feeRate": "",
                "size": "0.0000",
                "qty": "",
                "cashBalance": "22.96780168",
                "tradePrice": "",
                "tradeId": ""
            }
        ]
    },
        "retExtInfo": {},
        "time": 1672023157776
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/upgrade.html b/zh-TW/derivatives/unified/upgrade.html index 568df9abdd..27ed5fb9c5 100644 --- a/zh-TW/derivatives/unified/upgrade.html +++ b/zh-TW/derivatives/unified/upgrade.html @@ -4,13 +4,13 @@ 升級至統一保證金帳戶 | Bybit API Documentation - +

    升級至統一保證金帳戶

    升級至統一保證金賬戶

    HTTP 請求​

    POST /unified/v3/private/account/upgrade-unified-account

    請求參數​

    無

    響應參數​

    參數類型說明
    statusstring升級狀態. FAIL, SUCCESS
    > relieveLimitBizResponsearray若請求成功，則返回空數組[]
    >> relieveLimitCodestring失敗碼值
    >> relieveLimitMsgstring失敗的消息
    >> relieveLimitMobileUrlstring""
    >> relieveLimitWebUrlstring""
    >> passboolean是否滿足升級要求

    請求示例​

    POST /unified/v3/private/account/upgrade-unified-account HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672022838777
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {}

    響應示例​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "result": {
            "status": "FAIL",
            "relieveLimitBizResponse": [
                {
                    "relieveLimitCode": "3400071",
                    "relieveLimitMsg": "unable to upgrade as you haven’t met the minimum asset requirement.",
                    "relieveLimitMobileUrl": "",
                    "relieveLimitWebUrl": "",
                    "pass": false
                },
                {
                    "relieveLimitCode": "3400051",
                    "relieveLimitMsg": "unable to upgrade, please close the usdt perpetual positions in USDT account.",
                    "relieveLimitMobileUrl": "",
                    "relieveLimitWebUrl": "",
                    "pass": false
                }
            ]
    },
        "retExtInfo": {},
        "time": 1672022840011
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/usc-account-info.html b/zh-TW/derivatives/unified/usc-account-info.html index c0b0f70769..9d4bc22209 100644 --- a/zh-TW/derivatives/unified/usc-account-info.html +++ b/zh-TW/derivatives/unified/usc-account-info.html @@ -4,13 +4,13 @@ 查詢帳戶配置 | Bybit API Documentation - +

    查詢帳戶配置

    該接口可以查詢賬戶下的配置

    HTTP 請求​

    GET /unified/v3/private/account/info

    請求參數​

    無

    響應參數​

    參數類型說明
    unifiedMarginStatusinteger帳戶狀態類型
    marginModestringREGULAR_MARGIN（常規保證金模式） PORTFOLIO_MARGIN（組合保證金模式）
    dcpStatusstring設置斷線保護時間 開關狀態: ON, OFF
    timeWindowinteger設置的DCP觸發時間窗口. 範圍為[10, 300] 秒, 默認: 10 秒
    smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    updatedTimestring賬戶數據更新的時間，毫秒時間戳

    請求示例​

    GET /unified/v3/private/account/info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672023630281
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "marginMode": "REGULAR_MARGIN",
            "updatedTime": "1672918286000",
            "unifiedMarginStatus": 3,
            "dcpStatus": "ON",
            "timeWindow": 30,
            "smpGroup": 0
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/usc-margin-mode.html b/zh-TW/derivatives/unified/usc-margin-mode.html index 37421ff9ff..4a87aaabc4 100644 --- a/zh-TW/derivatives/unified/usc-margin-mode.html +++ b/zh-TW/derivatives/unified/usc-margin-mode.html @@ -4,13 +4,13 @@ 設置保證金模式 | Bybit API Documentation - +

    設置保證金模式

    用戶如果不設置，默認按常規保證金。該模式支持USDT永續, USDC永續和期權

    HTTP 請求​

    POST /unified/v3/private/account/setMarginMode

    請求參數​

    參數是否必需類型說明
    setMarginModetruestringREGULAR_MARGIN（常規保證金模式）PORTFOLIO_MARGIN（組合保證金模式）默認常規，傳常規則返回設置成功

    響應參數​

    參數類型說明
    reasonsarrayObject. 若請求提交成功, 則返回空數組
    > reasonCodestring失敗錯誤碼
    > reasonMsgstring失敗錯誤消息

    請求示例​

    POST /unified/v3/private/account/setMarginMode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672023475526
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "setMarginMode": "REGULAR_MARGIN"
    }

    響應示例​

    {
        "retCode": 3400045,
        "retMsg": "Set margin mode failed",
        "result": {
            "reasons": [
                {
                    "reasonCode": "3400102",
                    "reasonMsg": "Please ensure that there are no active orders in your USDC account, including Limit, Market and Conditional orders"
                },
                {
                    "reasonCode": "3400101",
                    "reasonMsg": "Please ensure that there are no positions in your USDC account, including USDC perpetual and options"
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/unified/wallet.html b/zh-TW/derivatives/unified/wallet.html index 6eef2b6cd4..e49da5aae3 100644 --- a/zh-TW/derivatives/unified/wallet.html +++ b/zh-TW/derivatives/unified/wallet.html @@ -4,13 +4,13 @@ 獲取錢包餘額 | Bybit API Documentation - +

    獲取錢包餘額

    獲取錢包餘額

    HTTP 請求​

    GET /unified/v3/private/account/wallet/balance

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種名稱. 允許傳多個, 用逗號隔開. 例如: BTC,ETH

    響應參數​

    參數類型說明
    accountIMRatestring帳戶初始保證金率: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin.
    accountMMRatestring帳戶維持保證金率: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin。
    totalEquitystring賬戶維度換算成usd的資產淨值：Account Margin Balance Base Coin + Account Option Value Base Coin。
    totalWalletBalancestring賬戶維度換算成usd的產錢包餘額：∑ Asset Wallet Balance Base Coin。
    totalMarginBalancestring賬戶維度換算成usd的保證金餘額：Account Wallet Balance Base Coin + Account Perp UPL Base Coin。
    totalAvailableBalancestring賬戶維度換算成usd的可用餘額：RM：Account Margin Balance Base Coin - Account Initial Margin Base Coin。
    totalPerpUPLstring賬戶維度換算成usd的永續浮動盈虧：∑ Asset Perp UPL Base Coin。
    totalInitialMarginstring賬戶維度換算成usd的總初始保證金：∑ Asset Total Initial Margin Base Coin。
    totalMaintenanceMarginstring賬戶維度換算成usd的總維持保證金: ∑ Asset Total Maintenance Margin Base Coin。
    coinarray幣種列表
    > currencyCoinstring錢包幣種的名稱，例如 BTC，ETH，USDT，USDC
    > availableToBorrowstring由於母子共享借貸限額, 該字段已廢棄, 總是返回""
    > borrowSizestring已借數額. 只有 USDC，USDT 有。 BTC 和 ETH 則返回為 0
    > bonusstring體驗金
    > accruedIntereststring某資產應計利息
    > availableBalanceWithoutConvertstring可用餘額. Margin Balance - Total Initial Margin
    > totalOrderIMstring訂單委託預佔用保證金. 組合保證金模式下，該字段返回空字符串
    > equitystring用戶資產
    > totalPositionMMstring所有倉位維持保證金求和. 組合保證金模式下，該字段返回空字符串
    > usdValuestring折算成 usd 的價值
    > availableBalancestring可用餘額（其餘資產可用餘額 + 該幣種實際可用餘額）
    > unrealisedPnlstring未結盈虧
    > totalPositionIMstring所有倉位起始保證金求和 + 預佔用平倉手續費. 組合保證金模式下，該字段返回空字符串
    > marginBalanceWithoutConvertstring保證金餘額
    > walletBalancestring錢包餘額
    > cumRealisedPnlstring累計已結盈虧
    > marginBalancestring保證金餘額（其餘資產的MB + 該幣種下實際的MB）

    請求示例​

    GET /unified/v3/private/account/wallet/balance?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672021457498
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
            "totalEquity": "5952.13539158",
            "accountIMRate": "0.1037",
            "totalMarginBalance": "6003.96034690",
            "totalInitialMargin": "622.37237856",
            "totalAvailableBalance": "5381.58796835",
            "accountMMRate": "0.0361",
            "totalPerpUPL": "-733.16272882",
            "totalWalletBalance": "6733.45726207",
            "totalMaintenanceMargin": "216.49590186",
            "coin": [
            {
                "currencyCoin": "ETH",
                "availableToBorrow": "0.00000000",
                "borrowSize": "0.00000000",
                "bonus": "0.00000000",
                "accruedInterest": "0.00000000",
                "availableBalanceWithoutConvert": "0.00000000",
                "totalOrderIM": "",
                "equity": "0.00000000",
                "totalPositionMM": "",
                "usdValue": "0.00000000",
                "availableBalance": "4.41128415",
                "unrealisedPnl": "",
                "totalPositionIM": "",
                "marginBalanceWithoutConvert": "0.00000000",
                "walletBalance": "0.00000000",
                "cumRealisedPnl": "",
                "marginBalance": "4.92144238"
            }
        ]
    },
        "retExtInfo": {},
        "time": 1672021457963
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-contract/execution.html b/zh-TW/derivatives/ws-contract/execution.html index a305490ce3..799bacf5f0 100644 --- a/zh-TW/derivatives/ws-contract/execution.html +++ b/zh-TW/derivatives/ws-contract/execution.html @@ -4,14 +4,14 @@ 個人成交 | Bybit API Documentation - +

    個人成交

    訂閱個人成交的推送

    覆蓋範圍: USDT永續, 反向合約

    推送頻率: 實時

    Topic: user.execution.contractAccount

    響應參數​

    參數類型說明
    topicstringTopic名
    dataarrayObject
    > symbolstring合約名稱
    > sidestring方向. Buy,Sell
    > execIdstring成交ID
    > feeRatestring手續費率
    > execFeestring交易手續費
    > execPricestring成交價格
    > execQtystring成交數量
    > leavesQtystring剩餘委託未成交數量
    > execTypestring交易類型
    > execValuestring成交價值
    > lastLiquidityIndstring流動性標識. AddLiquidity,RemovedLiquidity
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義訂單ID
    > orderPricestring訂單價格
    > orderQtystring訂單數量
    > orderTypestring訂單類型. Market,Limit
    > stopOrderTypestring條件單類型. 若不是條件單，則不會返回任何類型
    > execTimestring交易時間戳 (毫秒)
    > closedSizestring平倉數量
    > blockTradeIdstringParadigm大宗商品交易ID
    > markPricestring標記價格

    推送示例​

    {
        "topic": "user.execution.contractAccount",
        "data": [
            {
                "symbol": "ETHUSDT",
                "execFee": "0.1017888",
                "execId": "8b4b2e8c-caa1-5fde-be59-d483166885e7",
                "execPrice": "1696.48",
                "execQty": "0.1",
                "execType": "Trade",
                "execValue": "169.648",
                "feeRate": "0.0006",
                "lastLiquidityInd": "RemovedLiquidity",
                "leavesQty": "0",
                "orderId": "cd2f6f95-8031-4272-9339-e7054ff56567",
                "orderLinkId": "",
                "orderPrice": "1781.09",
                "orderQty": "0.1",
                "orderType": "Market",
                "stopOrderType": "UNKNOWN",
                "side": "Buy",
                "execTime": "1676885237382",
                "closedSize": "0",
                "blockTradeId": "",
                "markPrice": "1696.25"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-contract/order.html b/zh-TW/derivatives/ws-contract/order.html index 617891c096..e2b23e0a87 100644 --- a/zh-TW/derivatives/ws-contract/order.html +++ b/zh-TW/derivatives/ws-contract/order.html @@ -4,14 +4,14 @@ 訂單 | Bybit API Documentation - +

    訂單

    訂閱訂單數據推送

    覆蓋範圍: USDT永續, 反向合約

    推送頻率: 實時

    Topic: user.order.contractAccount

    響應參數​

    參數類型說明
    topicstringTopic名
    dataarrayObject
    > symbolstring合約名稱
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義ID
    > sidestring方向. Buy,Sell
    > orderTypestring訂單類型. Market,Limit. 對於止盈止損單, 則表示為觸發後的訂單類型
    > stopOrderTypestring條件單類型. 若不是條件單，則不會返回任何類型
    > pricestring訂單價格
    > qtystring訂單數量
    > blockTradeIdstring大宗交易訂單Id
    > timeInForcestring執行策略
    > orderStatusstring訂單狀態
    > positionIdxinteger倉位標識。用戶不同倉位模式
    > cancelTypestring訂單被取消類型
    > rejectReasonstring拒絕原因
    > avgPricestring訂單平均成交價格. 若沒有成交，則返回""
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > tpslModestring止盈止損模式 Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損
    > tpLimitPricestring觸發止盈後轉換為限價單的價格
    > slLimitPricestring觸發止損後轉換為限價單的價格
    > tpTriggerBystring觸發止盈的價格類型
    > slTriggerBystring觸發止損的價格類型
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
    > triggerDirectioninteger觸發方向. 0: 上漲, 1: 下跌
    > triggerBystring觸發類型
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?
    > leavesQtystring訂單剩餘未成交的數量
    > leavesValuestring訂單剩餘未成交的價值
    > lastExecQtystring成交數量
    • 當訂單狀態是成交或者部分成交時, 該字段展示的是成交數量
    • 當訂單狀態是取消時, 該字段展示的是剩餘未成交數量
    > lastExecPricestring成交價格
    > cumExecQtystring累計成交數量
    > cumExecValuestring累計成交價值
    > cumExecFeestring訂單累計成交的手續費
    > smpTypestringSMP執行類型
    > smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    > smpOrderIdstring觸發此SMP執行的交易對手的 orderID
    > createdTimestring創建訂單的時間戳 (毫秒)
    > updatedTimestring訂單更新的時間戳 (毫秒)

    推送示例​

    {
        "topic": "user.order.contractAccount",
        "data": [
            {
                "symbol": "ETHUSDT",
                "orderId": "e62a3099-eced-499f-bd81-185e8747187f",
                "side": "Buy",
                "orderType": "Market",
                "stopOrderType": "UNKNOWN",
                "price": "1622.55",
                "qty": "0.2",
                "timeInForce": "ImmediateOrCancel",
                "orderStatus": "Filled",
                "triggerPrice": "0.00",
                "orderLinkId": "",
                "createdTime": "1675999655229",
                "updatedTime": "1675999655232",
                "takeProfit": "0.00",
                "stopLoss": "0.00",
                "tpslMode": "Full",
                "tpLimitPrice": "",
                "slLimitPrice": "",
                "tpTriggerBy": "UNKNOWN",
                "slTriggerBy": "UNKNOWN",
                "triggerBy": "UNKNOWN",
                "reduceOnly": false,
                "closeOnTrigger": false,
                "triggerDirection": 0,
                "leavesQty": "0",
                "lastExecQty": "0.2",
                "lastExecPrice": "1545.30",
                "cumExecQty": "0.2",
                "cumExecValue": "309.06",
                "avgPrice": "1545.30",
                "blockTradeId": "",
                "cancelType": "UNKNOWN",
                "cumExecFee": "0.185436",
                "leavesValue": "0",
                "positionIdx": 1,
                "rejectReason": "EC_NoError",
                "smpType": "None",
                "smpGroup": 0,
                "smpOrderId": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-contract/position.html b/zh-TW/derivatives/ws-contract/position.html index 918e50d872..072034ebf0 100644 --- a/zh-TW/derivatives/ws-contract/position.html +++ b/zh-TW/derivatives/ws-contract/position.html @@ -4,14 +4,14 @@ 持倉 | Bybit API Documentation - +

    持倉

    訂閱持倉數據的推送

    覆蓋範圍: USDT永續，反向合約

    Topic: user.position.contractAccount

    響應參數​

    參數類型說明
    topicstringTopic名
    dataarrayObject
    > symbolstring合約名稱
    > riskIdinteger風險限額ID
    > riskLimitValuestring風險限額
    > sidestring方向. Buy,Sell
    > sizestring持倉大小
    > entryPricestring平均入場價
    > positionValuestring倉位價值
    > positionIdxinteger倉位標識, 用於辨別不同持倉模式
    • 0: 單向持倉模式
    • 1: 買側雙向持倉模式
    • 2: 賣側雙向持倉模式
    > tradeModeinteger交易模式. 0: 全倉, 1: 逐倉
    > autoAddMargininteger是否自動增加保證金. 0: 否, 1: 是
    > leveragestring槓桿倍數
    > positionBalancestring倉位保證金
    > markPricestring標記價格
    > liqPricestring強平價格. 當強平價 <= minPrice 或者強平價 >= maxPrice時, 則為""
    > bustPricestring破產價格
    > tpSlModestring該字段已廢棄, 無意義, 總是返回"Full"
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > trailingStopstring追蹤止損
    > activePricestring追蹤止損的激活價格
    > unrealisedPnlstring未結盈虧
    > cumRealisedPnlstring累計盈虧
    > occClosingFeestring預佔用平倉手續費
    > sessionAvgPricestring結算價格
    > positionStatusstring倉位狀態. Normal, Abnormal
    > positionMMstring倉位初始保證金
    > positionIMstring倉位維持保證金
    > adlRankIndicatorinteger自動減倉燈. 什麼是自動減倉機制?
    > isReduceOnlyboolean僅當Bybit需要降低某個Symbol的風險限額時有用
    • true: 僅允許減倉操作. 您可以考慮一系列的方式, 比如, 降低risk limit檔位, 或者同檔位修改槓桿或減少倉位, 或者增加保證金, 或者撤單, 這些操作做完後, 可以主動調用確認新的風險限額接口
    • false(默認): 沒有交易限制, 表示您的倉位在系統調整時處於風險水平之下
    • 僅對逐倉和全倉的期貨倉位有意義
    > mmrSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改MMR的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了MMR調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > leverageSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改槓桿的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了槓桿調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > createdTimestring倉位創建時間戳 (毫秒)
    > updatedTimestring倉位創建時間戳 (毫秒)

    推送示例​

    {
        "topic": "user.position.contractAccount",
        "data": [
            {
                "positionIdx": 0,
                "riskId": 1,
                "symbol": "ARBUSDT",
                "side": "None",
                "size": "0",
                "positionValue": "0",
                "entryPrice": "0",
                "tradeMode": 0,
                "autoAddMargin": 0,
                "leverage": "10",
                "positionBalance": "0",
                "liqPrice": "",
                "bustPrice": "0.0000",
                "takeProfit": "0.0000",
                "stopLoss": "0.0000",
                "trailingStop": "0.0000",
                "unrealisedPnl": "0",
                "createdTime": "1695115891722",
                "updatedTime": "1697686565866",
                "tpSlMode": "Full",
                "sessionAvgPrice": "0.0000",
                "positionStatus": "Normal",
                "occClosingFee": "0",
                "markPrice": "0.7747",
                "cumRealisedPnl": "21.84890946",
                "activePrice": "0.0000",
                "riskLimitValue": "200000",
                "positionMM": "0",
                "positionIM": "0",
                "adlRankIndicator": 0,
                "isReduceOnly": false,
                "mmrSysUpdateTime": "",
                "leverageSysUpdatedTime": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-contract/wallet.html b/zh-TW/derivatives/ws-contract/wallet.html index 6f2fadbfed..4ae7c7ab1e 100644 --- a/zh-TW/derivatives/ws-contract/wallet.html +++ b/zh-TW/derivatives/ws-contract/wallet.html @@ -4,14 +4,14 @@ 錢包 | Bybit API Documentation - +

    錢包

    訂閱錢包數據推送

    覆蓋範圍: USDT永續, 反向合約

    推送頻率: 實時

    Topic: user.wallet.contractAccount

    響應參數​

    參數類型說明
    topicstringTopic名
    dataarrayObject
    > coinstring幣種
    > equitystring總資產
    > walletBalancestring錢包餘額
    > positionMarginstring倉位保證金
    > availableBalancestring可用餘額
    > orderMarginstring委託單預佔用保證金
    > unrealisedPnlstring未結盈虧
    > cumRealisedPnlstring累計已結盈虧

    推送示例​

    {
        "topic": "user.wallet.contractAccount",
        "data": [
            {
                "coin": "USDT",
                "equity": "8538.34927711",
                "walletBalance": "8505.77505604",
                "positionMargin": "58.93257631",
                "availableBalance": "8436.20247873",
                "orderMargin": "10.640001",
                "unrealisedPnl": "32.57422107",
                "cumRealisedPnl": "-195.05231821"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-public/kline.html b/zh-TW/derivatives/ws-public/kline.html index 9ce7dfb895..8daf683ac8 100644 --- a/zh-TW/derivatives/ws-public/kline.html +++ b/zh-TW/derivatives/ws-public/kline.html @@ -4,14 +4,14 @@ K線 | Bybit API Documentation - +

    K線

    訂閱K線數據

    覆蓋範圍: 正向合約，反向合約

    可用時間粒度:

    • 1 3 5 15 30 60 120 240 360 720 分鐘
    • D 天
    • W 週
    • M 月
    信息

    註意如果字段confirm為true, 則表明這是這根K線的最後一個tick；否則，這只是一個快照數據，即中間價格

    推送頻率: 1-60s

    Topic: kline.{interval}.{symbol} e.g., kline.30.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > startnumber開始時間戳 (毫秒)
    > endnumber結束時間戳 (毫秒). 若時間還未到時間跨度的最後時間，則表示當前時間
    > intervalstringK線粒度
    > openstring開盤價
    > closestring收盤價
    > highstring最高價
    > lowstring最低價
    > volumestring交易量
    > turnoverstring交易額
    > confirmboolean是否確認
    > timestampnumber蠟燭中最後一筆淨值時間戳 (毫秒)

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
          "kline.5.BTCPERP"
        ],
        "req_id": "test" // 可選
    }

    推送示例​

    {
        "topic": "kline.5.BTCPERP",
        "data": [
            {
                "start": 1671187800000,
                "end": 1671188099999,
                "interval": "5",
                "open": "16991",
                "close": "16980.5",
                "high": "16991",
                "low": "16980.5",
                "volume": "2.501",
                "turnover": "42493.2305",
                "confirm": false,
                "timestamp": 1671187815755
            }
        ],
        "ts": 1671187815755,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-public/liquidation.html b/zh-TW/derivatives/ws-public/liquidation.html index f36ceef19c..c1ee577ba6 100644 --- a/zh-TW/derivatives/ws-public/liquidation.html +++ b/zh-TW/derivatives/ws-public/liquidation.html @@ -4,14 +4,14 @@ 強平推送 | Bybit API Documentation - +

    強平推送

    訂閱Bybit平台上的期貨強平推送, symbol维度最多1秒推一条爆仓数据

    覆蓋範圍: 正向合約，反向合約

    推送頻率: 1秒

    Topic: liquidation.{symbol} e.g., liquidation.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > updatedTimenumber數據更新時間戳 (毫秒)
    > symbolstring合約名稱
    > sizestring成交數量
    > pricestring成交價格
    > sidestring方向

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
        "liquidation.GALAUSDT"
        ],
        "req_id": "test" // optional
    }

    推送示例​

    {
        "data": {
            "price": "0.03803",
            "side": "Buy",
            "size": "1637",
            "symbol": "GALAUSDT",
            "updatedTime": 1673251091822
        },
        "topic": "liquidation.GALAUSDT",
        "ts": 1673251091822,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-public/orderbook.html b/zh-TW/derivatives/ws-public/orderbook.html index e83fa9cfa3..a13ec704cb 100644 --- a/zh-TW/derivatives/ws-public/orderbook.html +++ b/zh-TW/derivatives/ws-public/orderbook.html @@ -4,14 +4,14 @@ 深度 | Bybit API Documentation - +

    深度

    訂閱不同深度的推送

    覆蓋範圍: 正向合約, 反向合約, 期權

    信息
    • 訂閱成功後，會立即得到一個當前快照包的推送消息.
    • websocket將會繼續推送這些增量數據. 收到snapshot的報文，就需要重置本地的orderbook.
    • snapshot=全量orderbook, delta=增量orderbook
    • 如果因為Bybit服務原因，會重新發送snapshot報文，該報文已保證是最新且準確的.
    提示

    正向合約 & 反向合約 1檔數據: 若3秒內無變化，將會再次推送snapshot數據.

    正向合約 & 反向合約:

    • 1 檔數據, 推送頻率: 10ms
    • 50 檔數據, 推送頻率: 20ms
    • 200 檔數據, 推送頻率: 100ms
    • 500 檔數據, 推送頻率: 100ms

    Option:

    • 25 檔數據, 推送頻率: 20ms
    • 100 檔數據, 推送頻率: 100ms

    Topic:
    orderbook.{depth}.{symbol} e.g., orderbook.1.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot,delta
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > sstring合約名稱
    > barrayBid, 買方. snapshot數據，是按照價格從大到小
    >> b[0]string買方報價
    >> b[1]string買方數量
    > aarrayAsk, 賣方. snapshot數據，是按照價格從小到大
    >> a[0]string賣方報價
    >> a[1]string賣方數量
    uinteger更新id, 一般情況下該id是連續的。偶爾會因後台的重啟而發送"u"=1的全量數據，接收到後請覆蓋本地保存的orderbook
    seqinteger撮合版本號

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
        "orderbook.50.BTCUSDT"
        ],
        "req_id": "test" // optional
    }

    推送示例​

    {
        "topic": "orderbook.50.BTCUSDT",
        "type": "snapshot",
        "ts": 1671179923028,
        "data": {
            "s": "BTCUSDT",
            "b": [
                [
                    "17440.00",
                    "40.833"
                ],
                [
                    "17439.50",
                    "0.513"
                ],
                ...
                [
                    "17416.00",
                    "6.156"
                ],
                [
                    "17415.50",
                    "32.268"
                ]
        ],
        "a": [
            [
                "17440.50",
                "78.815"
            ],
            [
                "17441.00",
                "8.858"
            ],
            ...
            [
                "17464.50",
                "4.901"
            ],
            [
                "17465.00",
                "5.744"
            ]
        ],
        "u": 13079592,
        "seq": 22520573250
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-public/ticker.html b/zh-TW/derivatives/ws-public/ticker.html index 195c92a53d..64bec333a8 100644 --- a/zh-TW/derivatives/ws-public/ticker.html +++ b/zh-TW/derivatives/ws-public/ticker.html @@ -4,14 +4,14 @@ 行情 | Bybit API Documentation - +

    行情

    訂閱行情數據

    覆蓋範圍: 正向合約，反向合約，期權

    重要
    • 期貨，該topic推送delta數據和snapshot数据。如果delta數據為空，表明信息沒有發生變化。
    • 期權只推送snapshot類型數據

    推送頻率: 100ms

    Topic: tickers.{symbol}

    響應參數​

    參數類型說明
    topicstringTopic名稱
    typestring數據類型. `snapshot`,`delta`
    csinteger撮合版本號
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > symbolstring合約名稱
    > tickDirectionstring價格變化方向
    > price24hPcntstring市場價格相對24h前變化的百分比
    > lastPricestring最新市場成交價
    > prevPrice24hstring24小時前的整點市價
    > highPrice24hstring最近24小時的最高價
    > lowPrice24hstring最近24小時的最低價
    > prevPrice1hstring1小時前的整點市價
    > markPricestring標記價格
    > indexPricestring指數價格
    > openIntereststring未平倉合約的數量
    > openInterestValuestring未平倉合約的價值
    > turnover24hstring最近24小時成交額
    > volume24hstring最近24小時成交量
    > nextFundingTimestring下次結算資金費用的時間戳 (毫秒)
    > fundingRatestring資金費率
    > bid1Pricestring買1價
    > bid1Sizestring買1價的數量
    > ask1Pricestring賣1價
    > ask1Sizestring賣1價的數量

    推送示例​

    {
        "topic": "tickers.BTCUSDT",
        "type": "snapshot",
        "data": {
            "symbol": "BTCUSDT",
            "tickDirection": "MinusTick",
            "price24hPcnt": "0.017367",
            "lastPrice": "17222.00",
            "prevPrice24h": "16928.00",
            "highPrice24h": "17281.50",
            "lowPrice24h": "16915.00",
            "prevPrice1h": "17238.00",
            "markPrice": "17224.40",
            "indexPrice": "17234.84",
            "openInterest": "68795.534",
            "openInterestValue": "1184961795.83",
            "turnover24h": "1572429119.324499",
            "volume24h": "91823.449",
            "nextFundingTime": "1673280000000",
            "fundingRate": "-0.000211",
            "bid1Price": "17222.00",
            "bid1Size": "220.358",
            "ask1Price": "17222.50",
            "ask1Size": "3.902"
        },
        "cs": 24988405605,
        "ts": 1673273043686
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-public/trade.html b/zh-TW/derivatives/ws-public/trade.html index a2694cd2a2..445b0e40c4 100644 --- a/zh-TW/derivatives/ws-public/trade.html +++ b/zh-TW/derivatives/ws-public/trade.html @@ -4,14 +4,14 @@ 平台成交 | Bybit API Documentation - +

    平台成交

    訂閱Bybit平台上最近成交的推送. 從用戶訂閱開始, 實時推送增量交易歷史, 有成交數據就推送.

    覆蓋範圍: 正向合約，反向合約，期權

    推送頻率: 實時

    Topic: publicTrade.{symbol} 注意: 期權使用baseCoin, e.g., publicTrade.BTC

    響應參數​

    參數類型說明
    idstring消息 id. 期權沒有該字段
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject. 如有多條, 則數組中的元素按照匹配時間升序排序
    > Tnumber成交時間戳 (毫秒)
    > sarray合約名稱
    > Sstring吃單方向. Buy,Sell
    > vstring成交數量
    > pstring成交價格
    > Lstring價格變化的方向. 期權沒有該字段
    > istring成交Id
    > BTboolean成交類型是否為大宗交易
    > mPstring標記價格, 期權的特有字段
    > iPstring指數價格, 期權的特有字段
    > mIvstring標記iv, 期權的特有字段
    > ivstringiv, 期權的特有字段

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
        "publicTrade.BTCPERP"
        ],
        "req_id": "test" // optional
    }

    推送示例​

    {
        "topic": "publicTrade.BTCPERP",
        "type": "snapshot",
        "ts": 1671181689023,
        "data": [
            {
                "T": 1671181689021,
                "s": "BTCPERP",
                "S": "Buy",
                "v": "0.002",
                "p": "17032.50",
                "L": "MinusTick",
                "i": "d9cd8295-40dc-5dce-8deb-42882580a7ab",
                "BT": false
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-unified/execution.html b/zh-TW/derivatives/ws-unified/execution.html index 92e493d9df..35e2d7639e 100644 --- a/zh-TW/derivatives/ws-unified/execution.html +++ b/zh-TW/derivatives/ws-unified/execution.html @@ -4,14 +4,14 @@ 個人成交 | Bybit API Documentation - +

    個人成交

    訂閱個人成交的推送

    提示
    • 單筆訂單可能有多次成交
    • 僅USDT永續交易對推送資金費用類型的成交

    Topic:
    user.execution.unifiedAccount

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    typestring消息類型. snapshot
    tsnumber消息數據創建時間
    dataObject
    > versioninteger版本號
    > resultarrayObject
    >> symbolstring合約名稱
    >> orderIdstring訂單ID
    >> sidestring方向. Buy,Sell
    >> orderLinkIdstring用戶自定義訂單ID
    >> orderPricestring訂單價格
    >> orderQtystring訂單數量
    >> orderTypestring訂單類型. 市價單：Market,限價單：Limit
    >> execIdstring成交ID
    >> execPricestring成交價格
    >> execQtystring成交數量
    >> execValuestring成交價值
    >> feeRatestring手續費率
    >> execFeestring交易手續費
    >> execTimestring交易時間戳 (毫秒)
    >> execTypestring成交類型. TRADE, ADLTRADE, FUNDING, BUSTTRADE, SETTLE
    >> lastLiquidityIndstring流動性類型. TAKER: 吃單,MAKER: 掛單
    >> leavesQtystring剩餘委託未成交數量
    >> stopOrderTypestring条件单的订单类型。如果该订单不是条件单，则不会返回任何类型
    >> blockTradeIdstring大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID

    推送示例​

    {
        "id": "331355731ff43340-3504-4643-a953-87f275de985e",
        "topic": "user.execution.unifiedAccount",
        "ts": 1672833057231,
        "data": {
            "result": [
                {
                    "symbol": "ETHUSDT",
                    "execFee": "0.0075063",
                    "execId": "91704d47-4c11-5577-9be9-1beb35ae989d",
                    "execPrice": "1251.05",
                    "execQty": "0.01",
                    "execType": "TRADE",
                    "execValue": "12.5105",
                    "feeRate": "0.0006",
                    "lastLiquidityInd": "TAKER",
                    "leavesQty": "0",
                    "orderId": "9bb96006-711a-4235-9bc5-080302b4285c",
                    "orderLinkId": "",
                    "orderPrice": "1188.45",
                    "orderQty": "0.01",
                    "orderType": "Market",
                    "stopOrderType": "",
                    "side": "Sell",
                    "execTime": 1672833057221,
                    "blockTradeId": ""
                }
            ],
            "version": 3120492
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-unified/greek.html b/zh-TW/derivatives/ws-unified/greek.html index 081e58b84e..9bfec5f83f 100644 --- a/zh-TW/derivatives/ws-unified/greek.html +++ b/zh-TW/derivatives/ws-unified/greek.html @@ -4,14 +4,14 @@ 用戶希臘字母信息 (期權) | Bybit API Documentation - +

    用戶希臘字母信息 (期權)

    訂閱希臘字母信息，僅期權

    Topic:
    user.greeks.unifiedAccount

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    typestring消息類型. snapshot
    tsnumber消息數據創建時間
    dataObject
    > versioninteger版本號
    > resultObject
    >> baseCoinstring交易幣種
    >> totalDeltastringDelta值
    >> totalGammastringGamma值
    >> totalVegastringVega值
    >> totalThetastringTheta值

    推送示例​

    {
        "id": "53328593eddf20-ebe8-47d9-8a2b-62e4e2681eaa",
        "topic": "user.greeks.unifiedAccount",
        "ts": 1672107550646,
        "data": {
            "result": [
                {
                    "baseCoin": "BTC",
                    "totalDelta": "-0.02077347",
                    "totalGamma": "-0.00004675",
                    "totalVega": "-0.52558304",
                    "totalTheta": "3.48921259"
                },
                {
                    "baseCoin": "ETH",
                    "totalDelta": "0.05003533",
                    "totalGamma": "-0.00000063",
                    "totalVega": "-0.00014849",
                    "totalTheta": "0.0041225"
                }
            ],
            "version": 62056
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-unified/order.html b/zh-TW/derivatives/ws-unified/order.html index b00c98e729..1e286e16ab 100644 --- a/zh-TW/derivatives/ws-unified/order.html +++ b/zh-TW/derivatives/ws-unified/order.html @@ -4,14 +4,14 @@ 訂單 | Bybit API Documentation - +

    訂單

    訂閱訂單數據推送

    Topic:
    user.order.unifiedAccount

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    typestring消息類型. snapshot
    tsnumber消息數據創建時間
    dataObject
    > versioninteger版本號
    > resultarrayObject
    >> symbolstring合約名稱
    >> sidestring方向. Buy,Sell
    >> orderIdstring訂單ID
    >> orderLinkIdstring用戶自定義ID
    >> orderTypestring訂單類型. Market,Limit
    >> stopOrderTypestring條件單類型
    >> orderStatusstring訂單狀態
    >> pricestring訂單價格
    >> qtystring訂單數量
    >> timeInForcestring執行策略
    >> cumExecQtystring訂單累計成交數量
    >> cumExecValuestring訂單累計成交價值
    >> cumExecFeestring訂單累計成交的手續費
    >> leavesQtystring訂單剩餘未成交的數量
    >> triggerBystring觸發價格的觸發類型
    >> triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
    >> reduceOnlyboolean只減倉. true表明這是只減倉單
    >> closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?
    >> ivstring隱含波動率
    >> orderIMstring訂單初始保證金. 組合保證金模式下，該字段返回空字符串
    >> takeProfitstring止盈價格
    >> stopLossstring止損價格
    >> tpTriggerBystring觸發止盈的價格類型
    >> slTriggerBystring觸發止損的價格類型
    >> basePricestring當前市價
    >> blockTradeIdstring大宗交易訂單ID
    >> createdTimenumber創建訂單的時間戳 (毫秒)
    >> updatedTimenumber訂單更新的時間戳 (毫秒)

    推送示例​

    {
        "id": "533285293a44e9-7925-445c-a62c-01d7726c6543",
        "topic": "user.order.unifiedAccount",
        "ts": 1672063477614,
        "data": {
            "result": [
                {
                    "orderId": "38554b22-e4fa-4327-9250-3fc81aa4e30a",
                    "orderLinkId": "",
                    "symbol": "SCUSDT",
                    "side": "Sell",
                    "orderType": "Market",
                    "price": "0.00224",
                    "qty": "100",
                    "timeInForce": "ImmediateOrCancel",
                    "orderStatus": "Filled",
                    "cumExecQty": "100",
                    "cumExecValue": "0.234",
                    "cumExecFee": "0.0001404",
                    "stopOrderType": "UNKNOWN",
                    "triggerBy": "UNKNOWN",
                    "triggerPrice": "0",
                    "reduceOnly": true,
                    "closeOnTrigger": true,
                    "createdTime": 1672063477568,
                    "updatedTime": 1672063477578,
                    "iv": "",
                    "orderIM": "",
                    "takeProfit": "0",
                    "stopLoss": "0",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "basePrice": "0.00235",
                    "blockTradeId": "",
                    "leavesQty": "0"
                }
            ],
            "version": 17965
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-unified/position.html b/zh-TW/derivatives/ws-unified/position.html index 409cbb13e6..4ff228cdb3 100644 --- a/zh-TW/derivatives/ws-unified/position.html +++ b/zh-TW/derivatives/ws-unified/position.html @@ -4,14 +4,14 @@ 持倉 | Bybit API Documentation - +

    持倉

    訂閱持倉數據的推送。當倉位有變動時，即推送消息。

    Topic:
    user.position.unifiedAccount

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    typestring消息類型. snapshot
    tsnumber消息數據創建時間
    dataObject
    > versioninteger版本號
    > resultarrayObject
    >> symbolstring合約名稱
    >> sidestring持倉方向. Buy,Sell
    >> sizestring持倉大小
    >> positionIdxinteger倉位標識
    >> riskIdinteger風險限額ID. 注意: 組合保證金模式下，該字段返回0，風險限額規則失效
    >> leveragestring槓桿倍數. 注意: 組合保證金模式下，該字段返回""，槓桿規則失效
    >> entryPricestring平均入場價
    >> markPricestring標記價
    >> positionValuestring倉位價值
    >> positionIMstring倉位初始保證金. 注意: 組合保證金模式下，該字段返回""
    >> positionMMstring倉位維持保證金. 注意: 組合保證金模式下，該字段返回""
    >> tpslModestring止盈止損模式. Full,Partial
    >> takeProfitstring止盈價格
    >> stopLossstring止損價格
    >> trailingStopstring追蹤止損
    >> unrealisedPnlstring未結盈虧
    >> cumRealisedPnlstring累計盈虧
    >> sessionAvgPricestring結算價格. 期權沒有該字段
    >> createdTimenumber倉位創建時間戳 (毫秒)
    >> updatedTimenumber倉位創建時間戳 (毫秒)

    推送示例​

    {
        "id": "3313557309a19343-8362-4dde-9b5a-cef6823173f2",
        "topic": "user.position.unifiedAccount",
        "ts": 1673242361759,
        "data": {
            "result": [
                {
                    "positionIdx": 0,
                    "riskId": 1,
                    "symbol": "BTCUSDT",
                    "side": "Sell",
                    "size": "-0.003",
                    "entryPrice": "16790",
                    "leverage": "10.1",
                    "markPrice": "17225",
                    "positionIM": "5.02034365",
                    "positionMM": "0.28506449",
                    "takeProfit": "",
                    "stopLoss": "",
                    "trailingStop": "",
                    "positionValue": "50.37",
                    "unrealisedPnl": "-1.305",
                    "cumRealisedPnl": "-43.69152916",
                    "createdTime": 1661488246836,
                    "updatedTime": 1673242361755,
                    "tpslMode": "Full",
                    "sessionAvgPrice": "16790"
                }
            ],
            "version": 3342620
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws-unified/wallet.html b/zh-TW/derivatives/ws-unified/wallet.html index b9260e7ff2..1f226700d3 100644 --- a/zh-TW/derivatives/ws-unified/wallet.html +++ b/zh-TW/derivatives/ws-unified/wallet.html @@ -4,14 +4,14 @@ 錢包 | Bybit API Documentation - +

    錢包

    訂閱錢包數據推送

    Topic:
    user.wallet.unifiedAccount

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    typestring消息類型. snapshot
    tsnumber消息數據創建時間
    dataObject
    > versioninteger版本號
    > resultObject
    >> accountIMRatestring帳戶初始保證金率: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin
    >> accountMMRatestring帳戶維持保證金率: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin
    >> totalEquitystring賬戶維度換算成usd的資產淨值：Account Margin Balance Base Coin + Account Option Value Base Coin
    >> totalWalletBalancestring賬戶維度換算成usd的產錢包餘額：∑ Asset Wallet Balance Base Coin
    >> totalMarginBalancestring賬戶維度換算成usd的保證金餘額：Account Wallet Balance Base Coin + Account Perp UPL Base Coin
    >> totalAvailableBalancestring賬戶維度換算成usd的可用餘額：RM：Account Margin Balance Base Coin - Account Initial Margin Base Coin
    >> totalPerpUPLstring賬戶維度換算成usd的永續浮動盈虧：∑ Asset Perp UPL Base Coin
    >> totalInitialMarginstring賬戶維度換算成usd的總初始保證金：∑ Asset Total Initial Margin Base Coin
    >> totalMaintenanceMarginstring賬戶維度換算成usd的總維持保證金: ∑ Asset Total Maintenance Margin Base Coin
    >> coinarray幣種列表
    >>> currencyCoinstring錢包幣種的名稱，例如 BTC，ETH，USDT，USDC
    >>> equitystring用戶資產
    >>> usdValuestring折算成 usd 的價值
    >>> walletBalancestring錢包餘額
    >>> marginBalancestring保證金餘額（其餘資產的MB + 該幣種下實際的MB）
    >>> availableBalancestring可用餘額（其餘資產可用餘額 + 該幣種實際可用餘額）
    >>> marginBalanceWithoutConvertstring保證金餘額
    >>> availableBalanceWithoutConvertstring可用餘額. Margin Balance - Total Initial Margin
    >>> borrowSizestring已借數額. 只有 USDC，USDT 有。 BTC 和 ETH 則返回為 0
    >>> availableToBorrowstring由於母子共享借貸限額, 該字段已廢棄, 總是返回""
    >>> accruedIntereststring某資產應計利息
    >>> totalOrderIMstring訂單委託預佔用保證金. 組合保證金模式下，該字段返回空字符串
    >>> totalPositionIMstring所有倉位起始保證金求和 + 預佔用平倉手續費. 組合保證金模式下，該字段返回空字符串
    >>> totalPositionMMstring所有倉位維持保證金求和. 組合保證金模式下，該字段返回空字符串
    >>> unrealisedPnlstring未結盈虧
    >>> cumRealisedPnlstring累計已結盈虧

    推送示例​

    {
        "id": "5332858071ac1a-adcf-4c22-9967-4bdb763d993d",
        "topic": "user.wallet.unifiedAccount",
        "ts": 1673246212184,
        "data": {
            "result": {
                "accountIMRate": "0.1062",
                "accountMMRate": "0.0126",
                "totalEquity": "5306.99168766",
                "totalWalletBalance": "5015.81303189",
                "totalMarginBalance": "5315.50124767",
                "totalAvailableBalance": "4750.87543737",
                "totalPerpUPL": "299.68821577",
                "totalInitialMargin": "564.62581029",
                "totalMaintenanceMargin": "67.39562585",
                "coin": [
                    {
                        "currencyCoin": "USDC",
                        "equity": "696.90520008",
                        "usdValue": "696.90520008",
                        "walletBalance": "702.87476009",
                        "marginBalance": "5315.50124767",
                        "availableBalance": "4750.87543737",
                        "marginBalanceWithoutConvert": "705.41476009",
                        "availableBalanceWithoutConvert": "472.43375944",
                        "borrowSize": "0",
                        "availableToBorrow": "1500000",
                        "accruedInterest": "0",
                        "totalOrderIM": "172.47750096",
                        "totalPositionIM": "60.50349967",
                        "totalPositionMM": "16.09254346",
                        "unrealisedPnl": "-2.07956",
                        "cumRealisedPnl": "153.26214849"
                    },
                    {
                        "currencyCoin": "USDT",
                        "equity": "2989.97442076",
                        "usdValue": "2975.11272839",
                        "walletBalance": "2691.34184935",
                        "marginBalance": "5330.29357298",
                        "availableBalance": "4750.7346256",
                        "marginBalanceWithoutConvert": "2989.97442076",
                        "availableBalanceWithoutConvert": "2658.33944077",
                        "borrowSize": "0",
                        "availableToBorrow": "2500000",
                        "accruedInterest": "0",
                        "totalOrderIM": "0.9205456",
                        "totalPositionIM": "330.71443439",
                        "totalPositionMM": "51.24010721",
                        "unrealisedPnl": "298.63257142",
                        "cumRealisedPnl": "-3418.29414098"
                    }
                ]
            },
            "version": 177440
        },
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/derivatives/ws/connect.html b/zh-TW/derivatives/ws/connect.html index 412e8c8d21..838a74c367 100644 --- a/zh-TW/derivatives/ws/connect.html +++ b/zh-TW/derivatives/ws/connect.html @@ -4,7 +4,7 @@ 訂閱WebSocket | Bybit API Documentation - + @@ -21,7 +21,7 @@ 期權: wss://stream-testnet.bybit.com/option/usdc/public/v3

    WebSocket私有頻道:

    • 主網:
      合約: wss://stream.bybit.com/contract/private/v3

    • 測試網:
      合約: wss://stream-testnet.bybit.com/contract/private/v3

    鑒權/認證​

    信息

    公共頻道不需要鑒權，以下部分僅適用於私有頻道的訂閱。

    構建連接時，創建鑒權請求。

    注意: 如果您正在使用pybit, bybit-api或者其他第三方庫, 您可以忽略此項-因為鑒權已經內建。

    {
        "req_id": "10001", // 可選項
        "op": "auth",
        "args": [
            "api_key",
            1662350400000, //過期時間應當大於當前時間戳
            "singature"
        ]
    }
    # 基於: https://github.com/bybit-exchange/pybit/blob/master/pybit/_http_manager.py

    import hmac
    import json
    import time
    import websocket

    api_key = ""
    api_secret = ""

    # Generate expires.
    expires = int((time.time() + 1) * 1000)

    # Generate signature.
    signature = str(hmac.new(
        bytes(api_secret, "utf-8"),
        bytes(f"GET/realtime{expires}", "utf-8"), digestmod="sha256"
    ).hexdigest())

    ws = websocket.WebSocketApp(
        url=url,
        ...
    )

    # Authenticate with API.
    ws.send(
        json.dumps({
            "op": "auth",
            "args": [api_key, expires, signature]
        })
    )

    鑒權成功的響應示例

    {
        "success": true,
        "ret_msg": "",
        "op": "auth",
        "conn_id": "ced97gevha793pjs1t30-ob"
    }
    備註

    簽名生成的示例可以參考這裡。

    警告

    由於網絡的複雜性，您可能隨時遇到斷連。請參考以下建議確保您能即時接收到推送：

    1. 通過發送心跳
    2. 遇到斷連時，立即重新連接

    IP限頻​

    • 不要嘗試頻繁地構建連接與斷開連接
    • 不要在5分鐘內構建超過500個連接

    如何發送心跳​

    發送ping的示例

    // req_id是可選參數
    ws.send(JSON.stringify({"req_id": "100001", "op": "ping"}));

    接收到pong的響應示例

    {
        "req_id": "test",
        "op": "pong",
        "args": [
        "1671163042443"
        ],
        "conn_id": "ce3e06kfnonvuu2e3j4g-2t5w"
    }
    警告

    為了維持連接，我們推薦您每20秒發送一次心跳。

    如何訂閱topic​

    理解Websocket裡的args​

    通過傳入args來訂閱指定topic

    // 訂閱1檔深度推送
    {
        "req_id": "test", // 可選
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT"
        ]
    }

    通過逗號隔開，可以同時訂閱多個topic或者多個symbol

    {
        "req_id": "test", // 可選
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT",
            "publicTrade.BTCUSDT",
            "orderbook.1.ETHUSDT",
        ]
    }

    理解如何取消訂閱​

    您可以通過發送請求來動態地停止訂閱

    {
        "op": "unsubscribe",
        "args": [
            "publicTrade.ETHUSD"
        ],
        "req_id": "customised_id"
    }

    理解訂閱的響應​

    訂閱成功後的響應示例

    {
        "success": true,
        "ret_msg": "",
        "op": "subscribe",
        "conn_id": "ced97gevha793pjs1t30-ob"
    }

    訂閱成功後，您將收到結果信息。可以根據響應判斷訂閱是否成功。

    - + \ No newline at end of file diff --git a/zh-TW/faq.html b/zh-TW/faq.html index 2b393f64f0..67307e9ae4 100644 --- a/zh-TW/faq.html +++ b/zh-TW/faq.html @@ -4,7 +4,7 @@ 常見問題 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    常見問題

    Bybit的服務器在哪裡?​

    AWS 新加坡, 可用區域 ID apse1-az3.

    reduceOnly和closeOnTrigger - 區別是什麼?​

    • 要平倉，請提交訂單並將 reduceOnly 指定為 true。 closeOnTrigger 在這裡並不嚴格適用，但如果需要，您也可以將其設置為 true。
    • reduceOnly 是平倉時真正重要的一個，我們會在未來改進接口。
    • 將 closeOnTrigger 指定為 true 時要小心，因為當 reduceOnly 為 false 時可能會導致衝突。

    為什麼網站上沒有顯示我的所有訂單?​

    • 擁有下大量階梯訂單的機器人的用戶將受到前端界面的限制，該界面僅在屏幕上顯示最多 50 個訂單。
    • 不用擔心，您的訂單還在系統中，可以通過API查詢，但是前端顯示不會超過50個。

    根據可用錢包餘額計算訂單大小​

    • price * availableBalance * leverage * perc * (1 - (0.0006 * 2))
    • 不幸的是，這不是一個完全準確的公式。實際計算很複雜，可能會在以後發佈在文檔中。
      • price - 最新價格 (或您的入場價) - 可以從最新行情信息接口中獲取。
      • availableBalance - 可以從查詢持倉(實時)接口中獲取。
      • leverage - 最高為市場各自的最大槓桿和您的風險限額（例如 2、10、50）。
      • perc - 0.1 表示 10%，0.25 表示 25%，等等。
      • 1 - (0.0006 * 2) - 用於計算最大訂單成本（始終假設進入和退出訂單使用吃單費用，而不考慮實際費用）。

    我可以用 API 兌換資產嗎?​

    • 沒有接口可以交換資產。這只能在網站上完成。
    • 但是，可以使用 API 訪問您的資產交換記錄。

    我如何獲得測試網的資金?​

    要獲得測試網資金，只需到主賬戶資產頁面申請即可。

    為什麼我的平倉盈虧價格不准確?​

    • Closed PNL接口返回的entryPrice和exitPrice不是訂單的實際執行價格。
    • 它基於訂單的總成本 (頭寸是否僅由以一個價格執行的一個訂單開倉/平倉 - 如果多個訂單開倉/平倉則更加複雜。)
    • 例如，此接口報告的 entry_price 和 exit_price 受訂單支付/收到的費用的影響。

    如何確保我使用的是最新數據?​

    • REST API 或（甚至不太可能）websocket 有可能（儘管不太可能）返回/推送舊數據。
    • 為了獲得最大程度的數據彈性，我們建議客戶:
      • 首先，依賴於websocket，它不僅能保證你以最快的速度得到最新的數據，還能保證你得到完整的數據
      • 其次，查詢 REST API 以填充數據中的任何差異 - 或者 websocket 斷開連接時之間的差異。
    • 最佳做法是將所有這些數據本地保存在您自己的數據庫或緩存中。
    • 這釋放了您對其他請求的速率限制，並且還確保了在數據延遲的情況下針對交易所的冗餘級別。

    交易額和成交量有什麼區別?​

    • Turnover：與數量的貨幣相反的貨幣
    • Volume：與數量的貨幣使用相同的貨幣

    為什麼下市價單響應中返回的價格是錯誤的？​

    市場訂單（在後端）只是以更差的價格提交的限價訂單。這是為了減少閃電崩盤或類似事件發生的可能性，在這種情況下，交易者可能會提交以比他們預期的價格低得多 的價格執行的市價單。這裡返回的價格是內部限價單價格。返回此“不准確”的價格是因為下單接口是異步的，這意味著在實際執行訂單之前將響應返回給您。

    如果你想要真正的執行價格 (execPrice)，你應該訂閱 execution websocket。

    - + \ No newline at end of file diff --git a/zh-TW/index.html b/zh-TW/index.html index 6b7bb577dc..6bfdb7a7e5 100644 --- a/zh-TW/index.html +++ b/zh-TW/index.html @@ -4,13 +4,13 @@ Hello from Bybit API Documentation | Bybit API Documentation - +

    Bybit API Documentation

    Introduction to the Bybit V5 APIs – 5min ⏱️

    Unified APIs

    Bybit's latest v5 suite of APIs allow for a smooth and easy integration.

    Learn Exchange Mechanisms

    Learn the intricate details of Bybit's market rules to fully maximise your API usage.

    Historical Market Data

    Get comprehensive public market data in CSV format to speedily backtest and build strategies.

    - + \ No newline at end of file diff --git a/zh-TW/markdown-page.html b/zh-TW/markdown-page.html index 675410845d..0b564f02fd 100644 --- a/zh-TW/markdown-page.html +++ b/zh-TW/markdown-page.html @@ -4,13 +4,13 @@ Markdown page example | Bybit API Documentation - +

    Markdown page example

    You don't need React to write simple standalone pages.

    - + \ No newline at end of file diff --git a/zh-TW/pilot-feature.html b/zh-TW/pilot-feature.html index 8ca7a67b14..f28808ff2a 100644 --- a/zh-TW/pilot-feature.html +++ b/zh-TW/pilot-feature.html @@ -4,7 +4,7 @@ 試點功能 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    試點功能

    Open API支持模擬交易​

    • 可用日期: 測試網 - 已上線, 主網 - 2024年4月3日
    • 覆蓋範圍: 模擬交易賬戶
    • 詳細內容: 您可以參閱該頁面進行體驗

    websocket下改撤單功能​

    • 可用日期: 測試網 - 已上線, 主網 - 待定
    • 覆蓋範圍: 統一帳戶現貨/正向合約/期權交易
    • 詳細內容: 您可以使用websocket來下改撤單

    批量接口支持現貨交易​

    • 可用日期: 測試網 - 已上線, 主網 - 2024年3月5日
    • 覆蓋範圍: 統一帳戶現貨交易
    • 詳細內容: 您可以使用批量下改撤接口進行現貨交易

    現貨支持雙向止盈止損​

    • 可用日期: 測試網 - 已上線, 主網 - 2024年1月15日
    • 覆蓋範圍: 統一帳戶現貨交易
    • 詳細內容: 您可以在創建現貨訂單時通過takeProfit, stopLoss設置市價止盈止損

    現貨支持組合保證金對衝​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年11月16日
    • 覆蓋範圍: 統一帳戶的組合保證金模式
    • 詳細內容: 您可以通過這個設置現貨對衝接口啟用或關閉現貨對衝功能

    現貨支持改單​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年11月1日
    • 覆蓋範圍: 經典帳戶和統一帳戶現貨
    • 詳細內容: 您可以通過這個改單接口對現貨訂單進行改單

    統一帳戶現貨止盈止損單、條件單邏輯修改​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年10月26日 (按照uid尾號灰度期間, 全量預計11月2日)
    • 覆蓋範圍: 統一帳戶的現貨交易
    • 詳細內容: 當止盈止損單或者條件單觸發後, 訂單ID保持不變

    UTA Pro支持批量下單​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年8月31日
    • 覆蓋範圍: UTA Pro帳戶: USDT永續, USDC永續 & USDC交割 (正向合約linear)
    • 詳細內容: UTA Pro帳戶能夠進行正向合約的批量下改撤
    示例
    POST https://api-testnet.bybit.com/v5/order/create-batch

    > 請求體
    {
        "category": "linear",
        "request": [
            {

                "symbol": "BTCUSDT",
                "orderType": "Limit",
                "side": "Buy",
                "qty": "0.1",
                "price": "25500",
                "timeInForce": "GTC",
                "orderLinkId": "test-03",
                "reduceOnly": false,
                "tpslMode": "Full",
                "takeProfit": "26300",
                "stopLoss": "24800",
                "triggerDirection": null,
                "triggerPrice": null,
                "triggerBy": null,
                "positioIdx": 0,
                "smpType": null,
                "tpLimitPrice": null,
                "slLimitPrice": null,
                "slOrderType": null,
                "tpOrderType": null

            },
            {

                "symbol": "ETHUSDT",
                "orderType": "Limit",
                "side": "Buy",
                "qty": "0.1",
                "price": "1550",
                "timeInForce": "GTC",
                "orderLinkId": "test-04",
                "reduceOnly": false,
                "tpslMode": "Full",
                "takeProfit": "1680",
                "stopLoss": "1490",
                "triggerDirection": null,
                "triggerPrice": null,
                "triggerBy": null,
                "positioIdx": 0,
                "smpType": null,
                "tpLimitPrice": null,
                "slLimitPrice": null,
                "slOrderType": null,
                "tpOrderType": null
            }
        ]
    }
    > 響應
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "linear",
                    "symbol": "BTCUSDT",
                    "orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14",
                    "orderLinkId": "test-03",
                    "createAt": "1693212677410"
                },
                {
                    "category": "linear",
                    "symbol": "ETHUSDT",
                    "orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c",
                    "orderLinkId": "test-04",
                    "createAt": "1693212677410"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 0,
                    "msg": "OK"
                }
            ]
        },
        "time": 1693212677411
    }

    增加WS私有連接可配置斷線時間​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年8月16日
    • 覆蓋範圍: 構建v5私有連接時可用該配置參數
    • 詳細內容: 構建連接時, 設置/v5/private?max_active_time=, 值可以是從30s到600s之間。當服務端與客戶端之間無上下行數據時, 當達到這個配置的時間間隔時, 服務端則會斷開連接 (並不完全準確, 因為當前ticker的輪訓時間是30秒)

    調整錯誤碼​

    舊錯誤碼新錯誤碼消息
    34001283200320Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.
    1760363200320Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.

    UTA母子帳戶間共享借貸額度​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年8月11日
    • 覆蓋範圍: 統一帳戶
    • 詳細內容: 過去, 每個uta帳戶擁有獨自的借貸額度, 上線後, 該額度由母子之間共享

    UTA用戶可以選擇保證金幣種是否進行抵押​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年8月10日
    • 覆蓋範圍: 統一帳戶
    • 詳細內容: UTA用戶可以選擇保證金幣種是否進行抵押通過該接口

    用戶可以自主升級到UTA Pro​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年8月8日
    • 覆蓋範圍: 普通帳戶, 統一帳戶
    • 詳細內容: 用戶可以通過該接口升級至UTA Pro

    OpenAPI支持現貨條件單​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年8月7日
    • 覆蓋範圍: 普通帳戶, 統一帳戶
    • 詳細內容: 用戶可以通過openAPI創建現貨條件單

    UTA支持機構借貸​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年7月24日
    • 覆蓋範圍: 統一帳戶
    • 詳細內容: 統一帳戶支持機構借貸

    USDC永續支持獲得資金費的數據​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年7月3日
    • 覆蓋範圍: 統一帳戶 USDC永續合約
    • 詳細內容: 查詢成交紀錄接口之前是沒有execType=Funding的且websocket個人成交不推送該數據. 現在您將會查詢到和獲得推送.

    新版帶單交易​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年6月24日
    • 覆蓋範圍: 舊版帶單交易
    • 詳細內容: Bybit將會從6月24日開始陸續開放uid升級功能, 如果您選擇升級到新的帶單交易, 請注意老版本的Copy Trading V3接口將不可再用, 請直接使用合約 V3 或者 V5接口

    統一帳戶支持逐倉保證金模式和雙倉模式​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年6月1日
    • 覆蓋範圍: 僅統一帳戶生效
    • 詳細內容: 統一帳戶的逐倉保證金是帳戶維度. 雙向持倉僅支持USDT永續

    新版止盈止損​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年5月23日
    • 覆蓋範圍: V5 API 和 合約V3 API
    • 詳細內容: 統一帳戶(UTA): USDT 永續, USDC 永續 和 交割, 反向合約
      普通帳戶: USDT 永續, 反向合約

    查詢升級前紀錄​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年4月27日
    • 覆蓋範圍: 統一交易帳戶
    • 詳細內容: 升級後，可以通過該接口查詢到升級之前的一些交易紀錄.

    余幣寶 (廢棄)​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年4月22日
    • 覆蓋範圍: 所有用戶 (目前灰度階段)
    • 詳細內容: 您可以將閒置資金存入余幣寶來賺取收益

    自成交攔截​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年4月20日
    • 覆蓋範圍: 請查看這裡
    • 詳細內容: 支持現貨、期貨和期權

    支持持倉升級至UTA帳戶​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年4月4日
    • 覆蓋範圍: 普通帳戶升級至統一帳戶
    • 詳細內容: 升級時無需平倉. 更多細節，請查閱升級接口

    統一交易帳戶支持USDC交割產品交易​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年3月20日
    • 覆蓋範圍: 僅限升級到UTA的帳戶
    • 詳細內容: V5接口將適用於UTA帳戶交易USDC交割

    機構借貸V5接口​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年3月13日
    • 覆蓋範圍: 申請了場外借貸的機構用戶
    • 詳細內容: 可以查詢到帳戶的LTV, 借款及還款等信息

    普通帳戶支持使用V5接口進行現貨交易​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年3月10日
    • 覆蓋範圍: 普通帳戶
    • 詳細內容: 使用V5交易現貨

    統一交易對狀態枚舉​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年3月10日
    • 覆蓋範圍: /v5/market/instruments-info status字段
    • 詳細內容: 統一使用Trading, Closed, Settling, PreLaunch, Deliverying

    上線全倉槓桿(普通帳戶)V5版本​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年3月3日
    • 覆蓋範圍: 普通帳戶能夠使用V5接口操作全倉槓桿
    • 詳細內容: 借貸、還款、查詢操作

    UTA用戶支持交易反向合約​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年2月21日
    • 覆蓋範圍: UTA用戶能夠通過V5接口交易反向合約
    • 詳細內容: 請注意該反向合約交易是通過反向合約錢包(CONTRACT)完成

    將現貨帳戶併入統一帳戶(重要)​

    • 可用日期: 預計3月3日当天執行
    • 覆蓋範圍: 僅UTA用戶
    • 詳細內容: 您需要修改提現邏輯，先將資金轉入資金帳戶，然後調用提現接口

    使用RSA密鑰方式鑒權​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年2月21日
    • 覆蓋範圍: 所有V3、V5需要鑒權的接口
    • 詳細內容: 請參閱該引導完成快速上手

    execType增加新的枚舉值​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年2月20日
    • 覆蓋範圍: 合約 V3 - Websocket私有頻道 - 個人成交
    • 詳細內容: 新增資金費用結算的推送，其中execType=Funding

    V5接口支持普通帳戶​

    • 可用日期: 測試網 - 已上線, 主網 - 2023年2月9日
    • 覆蓋範圍: 普通帳戶支持交易 USDT永續 and 反向合約
    • 詳細內容: 此次發佈之後，如果您有以下行為，您可能會遭遇一些401錯誤或者404錯誤:

    401: 您仍然在使用v1/v2的鑒權方式訪問V5接口：

    GET https://api.bybit.com/v5/position/list?api_key=xxx&category=linear&recv_window=5000&symbol=ETHUSDT&timestamp=1675929695887&sign=xxx

    您應該將鑒權參數放在請求頭當中:

    Host: api-testnet.bybit.com
    -H 'X-BAPI-SIGN: XXXXXXXXXX' \
    -H 'X-BAPI-API-KEY: XXXXXXXXXX' \
    -H 'X-BAPI-TIMESTAMP: 1658384431891' \
    -H 'X-BAPI-RECV-WINDOW: 5000'

    404: 對於以下接口，如果您傳入不恰當的category值, 比如, 您是普通帳戶，但category傳入了option/spot

    調整錯誤碼​

    舊錯誤碼新錯誤碼消息
    3400045110073Set margin mode failed
    34009910016Server error

    增加500檔的推送​

    • 可用日期: 測試網 - 2023年1月13日, 主網 - 2023年1月16日
    • 覆蓋範圍: V5 深度 和 V3 深度
    • 詳細內容: 期貨的正反向合約將支持500檔深度的推送, 其中推送頻率為100ms.
    - + \ No newline at end of file diff --git a/zh-TW/search.html b/zh-TW/search.html index fd835f225d..2a15d9a54d 100644 --- a/zh-TW/search.html +++ b/zh-TW/search.html @@ -4,13 +4,13 @@ 在文件中搜尋 | Bybit API Documentation - +

    在文件中搜尋

    - + \ No newline at end of file diff --git a/zh-TW/spot/enum.html b/zh-TW/spot/enum.html index 714a09c13f..64f5fedb12 100644 --- a/zh-TW/spot/enum.html +++ b/zh-TW/spot/enum.html @@ -4,7 +4,7 @@ 枚舉定義 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    枚舉定義

    side​

    • BUY 買
    • SELL 賣

    timeInForce​

    • GTC Good Till Cancel，一直有效至取消
    • FOK Fill or Kill，完全成交或取消
    • IOC Immediate or Cancel，立即成交或取消

    symbol​

    orderType​

    • MARKET
    • LIMIT
    • LIMIT_MAKER 被動委託

    currency/coin​

    • BTC
    • ETH
    • USDT
    • ...

    以下幣種支持全倉槓桿:

    • BTC
    • ETH
    • XRP
    • SOL
    • LTC
    • EOS
    • LINK
    • XLM
    • USDC
    • USDT
      您可以通過這個網址獲得所有全倉槓桿支持的幣種.

    orderStatus​

    • NEW 普通單被下達
    • ORDER_NEW 止盈止損單被下達
    • PARTIALLY_FILLED
    • FILLED
    • ORDER_FILLED 止盈止損單成交
    • CANCELED 普通單被取消
    • ORDER_CANCELED 止盈止損單被取消
    • REJECTED
    • ORDER_REJECTED 止盈止損單被拒絕
    • PARTIALLY_FILLED_CANCELED
    • ORDER_FAILED 止盈止損單失敗

    interval​

    • 1m 1 分鐘
    • 3m 3 分鐘
    • 5m 5 分鐘
    • 15m 15 分鐘
    • 30m 30 分鐘
    • 1h 1 小時
    • 2h 2 小時
    • 4h 4 小時
    • 6h 6 小時
    • 12h 12 小時
    • 1d 1 天
    • 1w 1 周
    • 1M 1 月

    ltStatus​

    • 1 槓桿代幣支持申贖
    • 2 槓桿代幣支持申購，但無法贖回
    • 3 槓桿代幣支持贖回，但是無法申購
    • 4 槓桿代幣無法申贖

    ltOrderStatus​

    • 1 完成
    • 2 進行中
    • 3 失敗

    ltOrderType​

    • 1 申購
    • 2 贖回

    smpType​

    • 默認: None
    • CancelMaker
    • CancelTaker
    • CancelBoth
    - + \ No newline at end of file diff --git a/zh-TW/spot/error.html b/zh-TW/spot/error.html index 94b27215f3..9bb7e619f3 100644 --- a/zh-TW/spot/error.html +++ b/zh-TW/spot/error.html @@ -4,13 +4,13 @@ 錯誤碼 | Bybit API Documentation - +

    錯誤碼

    錯誤碼描述
    5019用戶服務錯誤
    5004上游服務超時
    7001Grpc請求提交錯誤
    10003無效的api_key
    10006訪問過於頻繁,
    10001參數錯誤
    10002無效請求，請檢查您的timestmap和recv_window參數
    10004簽名錯誤
    10005權限受限
    10008UTA帳戶無法訪問當前接口，請確認您的帳戶模式
    10024合規牆攔截
    10029請檢查請求的symbol是否在交易對白名單中
    33004api_key已過期
    12940鏈結拒絕
    12999系統錯誤
    12800非法請求
    12801非法JSON信息
    12802非法event
    12803event必需的
    12804非法topic
    12805Topic必需的
    12806Param必需的
    12807Period必需的
    12808非法時間
    12809非法幣對
    12810不支持該幣對
    12811非法broker
    12812DumpScale必需的
    12813非法exchangeId
    12814Param字段錯誤
    12815幣對必需的
    12816超時，請稍後重試
    12817機構沒有開展業務
    12818客戶端斷開鏈結
    12819orgId必需的
    12820orgId必需是數字類型
    12821精度錯誤
    12822Index名稱錯誤
    12823參數錯誤
    12824參數缺失
    12825單次請求symbol數量不能超過300
    12001參數錯誤
    12007等待後端服務器響應超時。發送狀態未知
    12014不支持的訂單組合
    12005新订新訂單太多。請減少你的請求頻率
    12016該服務不可用
    12032熔斷錯誤碼
    12114風控異常
    12015UID不存在
    12011INNOVATION_BUY_FAILED_BY_QUOTA
    12010ETP_BUY_FAILED_BY_QUOTA
    12012ETP_NAV_IS_ABNORMAL
    12017CROSS_MARGIN_PRE_BUY_QUOTA_FAILED
    10020CROSS_MARGIN_PRE_SELL_QUOTA_FAILED
    12019您的帳戶被限制交易。如有疑問，請聯繫support@bybit.com
    12124訂單金額過大
    12031交易对未开放
    12105参数为空
    12115无效timeInForce
    12116无效订单类型
    12117无效买卖方向
    12121无效符号
    12130发送的参数为无效数据
    12131余额不足
    12132订单价格过高
    12133订单价格过低，请查询Broker
    12134订单价格精度过长，请查询Broker
    12135订单quantity过大
    12136订单quantity小于最小值
    12137订单quantity精度过长
    12138订单价格超出允许范围
    12139订单已经被执行
    12140交易金额小于最小值
    12141clientOrderId重复
    12142订单已经被撤销
    12143订单当前不在订单簿上
    12144订单已被锁定
    12145该订单类型不支持撤销
    12146订单生成超时
    12147订单撤销超时
    12148市價單的訂單金額小數過多
    12149創建訂單失敗
    12150撤銷訂單失敗
    12151該交易對已下架
    12156訂單數量無效
    12157該交易對不支持API交易
    12158創建LIMIT_MAKER訂單失敗
    12159由於風險控制，新上線的交易對在市場開始前的%s分鐘內不支持市價單
    12190撤销订单已完成
    12191无法撤单,
    12192訂單價格不能高於%s
    12193買單價格不能高於%s
    12194賣單價格不能低於%s
    12195您的訂單可能沒有成交
    12196您的訂單可能沒有成交
    12197您的買單的數量過大。成交價格可能嚴重偏離當前市場價格，請重試.
    12198您的賣單的數量過大。成交價格可能嚴重偏離當前市場價格，請重試.
    12199您的買單的數量過大。成交價格可能嚴重偏離nav，請重試.
    12200您的賣單的數量過大。成交價格可能嚴重偏離nav，請重試.
    12201订单种类错误
    12202触发价格为空
    12203触发价大于110%
    12204触发价小于90%
    12205不允许杠杆用户交易止盈止损
    12206止盈止损开盘前5分钟不允许下单
    12210New order rejected 新增订单被拒绝
    12211Cancelation rejected 撤销订单被拒绝
    12212Cancel order request processing 正在處理撤單請求
    12213Order does not exist 订单不存在
    12214This trading pair currently does not support trading. 根據合規要求, 該交易對不支持交易
    12217該交易對僅支持LIMIT_MAKER訂單
    12218由於價格無效，該筆LIMIT_MAKER訂單被拒絕
    12219UID {{xxx}} is not available to this feature
    12221幣種不存在
    12222請求過快
    12223場外借貸帳戶觸發吿警或爆倉
    12224非創新區用戶
    12225查詢用戶是否開通槓桿代幣協議失敗
    12226全倉用戶帳戶爆倉中
    12227功能未開放
    12228買入額度超過預估最大買入額
    12229賣出數量超過預估最大賣出量
    12230全倉槓桿中, 預佔額度校驗ltv不通過
    12231不允許全倉槓桿用戶交易大宗交易
    12232不允許場外借貸用戶交易大宗交易
    12233不允許ETP幣對交易大宗交易
    12234系統錯誤
    12400serialNo已使用過
    12401今日申購限額不足,請稍候嘗試
    12402申購訂單積壓較多,請稍後重試
    12403餘額不足,請充值後重試
    12404今日贖回限額不足,請稍候重試
    12405贖回訂單積壓較多,請稍後重試
    12406餘額不足,請充值後重試
    12407此訂單不存在
    12408當前申購未開啟
    12409申購金額超出上限
    12410您還未通過風險測試無法參與槓桿代幣的申贖和交易,請先在網頁端完成練習
    12412當前贖回未開啟
    12413贖回數量超過上限
    12414申購入口暫時關閉
    12415贖回入口暫時關閉
    12416輸入值格式不符合要求：精度或長度超出
    12417下單失敗：超出槓桿代幣持倉最大限制當前限制是XXXX USDT
    12601獲取用戶還款紀錄失敗
    12602獲取用戶帳戶信息失敗
    12603獲取用戶借款紀錄失敗
    12604獲取歷史紀錄的startTime大於endTime
    12605借款失敗
    12606還款失敗
    12607未找到借貸帳戶
    12608借貸帳戶未開通全倉槓桿,請先在web端開啟
    12609借貸帳戶未開通全倉槓桿,請先在web端和APP端開啟
    12610未找到借貸幣種
    12611幣種未開啟借貸
    12612未找到交易幣對
    12613交易比對未開啟借貸
    12614還款請求重複
    12615還款帳戶餘額不足
    12616無欠款,無需還款
    12617還款金額超過欠款金額
    12618用戶幣種已在還款中
    12619用戶還款計息強平衝突
    12620查詢不到還款紀錄
    12621借貸請求重複
    12622借貸幣種全量未開放
    12623交易對全量未開放
    12624借貸用戶狀態非正常
    12625借貸數量不能小於單詞最小借貸量
    12626借貸數量不能大於單次最大借貸量
    12627借貸數量不能大於平臺允許的單用戶最大借貸量
    12628借貸申請數量超過平臺最大借貸量
    12629借款申請數量超過用戶預估最大可借貸量
    12630獲取用戶借貸信息失敗
    12631借貸精度超過設置精度
    12632還款精度過高
    - + \ No newline at end of file diff --git a/zh-TW/spot/etp/asset-info.html b/zh-TW/spot/etp/asset-info.html index d237a51a77..f530509cc1 100644 --- a/zh-TW/spot/etp/asset-info.html +++ b/zh-TW/spot/etp/asset-info.html @@ -4,13 +4,13 @@ LT 全量資產基礎信息查詢 | Bybit API Documentation - +

    LT 全量資產基礎信息查詢

    信息

    這是個公共接口，無需鑒權。

    HTTP 請求​

    GET /spot/v3/public/infos

    請求參數​

    參數是否必須類型說明
    ltCodefalsestring想要查詢的LT資產名稱，從資產列表中獲取.

    返回參數​

    參數類型說明
    listarrayObject
    > ltCodestringLT資產簡稱
    > ltNamestringLT資產全稱
    > maxPurchasestring單次最大申購金額
    > minPurchasestring單次最小申購金額
    > maxPurchaseDailystring單個自然日最大申購金額
    > maxRedeemstring單次最大贖回數量
    > minRedeemstring單次最小贖回數量
    > maxRedeemDailystring單個自然日最大贖回數量
    > purchaseFeeRatestring申購費率
    > redeemFeeRatestring贖回費率
    > statusstring目前LT資產是否可以進行申購和贖回
    > fundFeestring每天針對持有LT資產的用戶收取的資金費用
    > fundFeeTimenumber收取資金費用的時間
    > manageFeeRatestring管理費率
    > manageFeeTimenumber收取資金管理費的時間
    > valuestring平臺內部使用字段, 暫無實際意義, 可忽略
    > totalstring平臺申購總量上限
    > netValuestring當前淨值

    請求示例​

    https://api-testnet.bybit.com/spot/v3/public/infos?ltCode=EOS2LUSDT

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "fundFee": "21.79800315",
                    "fundFeeTime": 1673366400000,
                    "ltCode": "EOS2LUSDT",
                    "ltName": "Long EOS (2x Leverage)",
                    "manageFeeRate": "0.00005",
                    "manageFeeTime": 1673398800000,
                    "maxPurchase": "5000",
                    "maxPurchaseDaily": "200000",
                    "maxRedeem": "861",
                    "maxRedeemDaily": "20000",
                    "minPurchase": "100",
                    "minRedeem": "17",
                    "netValue": "3.781571076822412032",
                    "purchaseFeeRate": "0.0005",
                    "redeemFeeRate": "0.0005",
                    "status": "1",
                    "total": "5000000",
                    "value": "23624.848996419293002588635"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1673345413125
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/etp/market-info.html b/zh-TW/spot/etp/market-info.html index a15a5c0e68..4d51e94b8d 100644 --- a/zh-TW/spot/etp/market-info.html +++ b/zh-TW/spot/etp/market-info.html @@ -4,13 +4,13 @@ LT 行情查詢 | Bybit API Documentation - +

    LT 行情查詢

    HTTP 請求​

    GET /spot/v3/private/reference

    請求參數​

    參數是否必須類型說明
    ltCodetruestring想要查詢的LT資產名稱，從資產信息中獲取.

    返回參數​

    參數類型說明
    basketstring名義持倉（總籃子 = 籃子頭寸*發行量)
    circulationstring在二級市場流通的代幣數量
    leveragestring真實槓桿倍數
    ltCodestringLT資產簡稱
    navstring淨值
    navTimenumber淨值更新時間戳UTC毫秒

    請求示例​

    curl --location --request GET 'https://api.bybit.com/spot/v3/private/reference?ltCode=BTC3S' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662549197919' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "basket": "230666.700009559600667216",
            "circulation": "24999.840207851103706443",
            "leverage": "2.302545313639639446",
            "ltCode": "EOS2L",
            "nav": "3.790797803797135639",
            "navTime": 1673346095226
        },
        "retExtInfo": {},
        "time": 1673346095239
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/etp/order-history.html b/zh-TW/spot/etp/order-history.html index f65059bab6..09a39fc95f 100644 --- a/zh-TW/spot/etp/order-history.html +++ b/zh-TW/spot/etp/order-history.html @@ -4,13 +4,13 @@ 申贖記錄查詢 | Bybit API Documentation - +

    申贖記錄查詢

    HTTP 請求​

    GET /spot/v3/private/record

    請求參數​

    參數是否必須類型說明
    ltCodefalsestring槓桿代幣代碼
    orderIdfalsestring訂單ID
    startTimefalseinteger起始時間戳（毫秒）
    endTimefalseinteger結束時間戳（毫秒）
    limitfalseinteger返回數量限制. [1, 500]. 默認: 100
    orderTypefalseinteger訂單類型 1. 申購 2. 贖回
    serialNofalsestring序列號

    返回參數​

    參數類型說明
    amountstring實際成交的LT資產數量
    excTimenumber訂單狀態最後一次更新時間
    feestring交易手續費
    ltCodestringLT資產簡稱
    orderIdstring訂單ID
    orderStatusstring申購單狀態：1. 已完成 2. 等待中 3. 失敗
    orderTimenumber下單時間
    orderTypeinteger訂單類型 1. 申購 2. 贖回
    serialNostring序列號
    valuestring成交價值
    valueCoinstring計價幣種

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/record?ltCode=DOT3L&startTime=1662548400000&endTime=1662549840000' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662608374151' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "amount": "",
                    "excTime": 1662549752000,
                    "fee": "",
                    "ltCode": "DOT3L",
                    "orderId": "2083",
                    "orderStatus": "3",
                    "orderTime": 1662549752000,
                    "orderType": 1,
                    "serialNo": "x003",
                    "value": "",
                    "valueCoin": "USDT"
                },
                {
                    "amount": "",
                    "excTime": 1662549702000,
                    "fee": "",
                    "ltCode": "DOT3L",
                    "orderId": "2082",
                    "orderStatus": "3",
                    "orderTime": 1662549702000,
                    "orderType": 1,
                    "serialNo": "x002",
                    "value": "",
                    "valueCoin": "USDT"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1662608374640
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/etp/purchase.html b/zh-TW/spot/etp/purchase.html index 6767216671..9b8f495a71 100644 --- a/zh-TW/spot/etp/purchase.html +++ b/zh-TW/spot/etp/purchase.html @@ -4,13 +4,13 @@ 申購 | Bybit API Documentation - +

    申購

    HTTP 請求​

    POST /spot/v3/private/purchase

    請求參數​

    參數是否必須類型說明
    ltCodetruestring想要查詢的LT資產名稱，從資產列表中獲取.
    ltAmounttruestring下單金額
    serialNofalsestring序列號. 自定義ID

    返回參數​

    參數類型說明
    amountstring下單的LT資產金額
    idstring交易單號
    ltCodestringLT資產簡稱
    orderAmountstring實際成交金額
    orderQuantitystring實際成交的LT資產數量
    orderStatusstring申購單狀態：1. 已完成 2. 等待中 3. 失敗
    serialNostring序列號
    timestampnumber時間戳
    valueCoinstring計價幣種

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/purchase' \
    --header 'Content-Type: application/json' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662549845240' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --data-raw '{
        "ltCode": "DOT3LUSDT",
        "ltAmount": "100",
        "serialNo": "x005"
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "amount": "100",
            "id": "2085",
            "ltCode": "DOT3LUSDT",
            "orderAmount": "",
            "orderQuantity": "",
            "orderStatus": "2",
            "serialNo": "x005",
            "timestamp": 1662549845373,
            "valueCoin": "USDT"
        },
        "retExtInfo": {},
        "time": 1662549845453
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/etp/redeem.html b/zh-TW/spot/etp/redeem.html index 675ebba519..3bcc32a546 100644 --- a/zh-TW/spot/etp/redeem.html +++ b/zh-TW/spot/etp/redeem.html @@ -4,13 +4,13 @@ 贖回 | Bybit API Documentation - +

    贖回

    HTTP 請求​

    POST /spot/v3/private/redeem

    請求參數​

    參數是否必須類型說明
    ltCodetruestring想要查詢的LT資產名稱，從資產列表中獲取.
    ltQuantitytruestring贖回數量
    serialNofalsestring序列號, 自定義ID

    返回參數​

    參數類型說明
    idstring交易單號
    ltCodestringLT資產簡稱
    orderAmountstring實際成交的金額. 一般返回""
    orderQuantitystring實際成交的LT資產數量
    orderStatusstring申購單狀態：1. 已完成 2. 等待中 3. 失敗
    quantitystring下單的LT資產數量. 一般返回""
    serialNostring序列號
    timestampnumber時間戳
    valueCoinstring計價幣種

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/redeem' \
    --header 'Content-Type: application/json' \
    --header 'X-BAPI-API-KEY: XXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1662605726010' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --data-raw '{
        "ltCode": "DOT3LUSDT",
        "ltQuantity": "50",
        "serialNo": "r001"
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "id": "2087",
            "ltCode": "DOT3LUSDT",
            "orderAmount": "",
            "orderQuantity": "50",
            "orderStatus": "2",
            "quantity": "",
            "serialNo": "r001",
            "timestamp": 1662605726326,
            "valueCoin": "DOT3L"
        },
        "retExtInfo": {},
        "time": 1662605727987
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/account.html b/zh-TW/spot/margin/account.html index ad297ca294..ca4677e9d8 100644 --- a/zh-TW/spot/margin/account.html +++ b/zh-TW/spot/margin/account.html @@ -4,13 +4,13 @@ 查詢借貸帳戶信息 | Bybit API Documentation - +

    查詢借貸帳戶信息

    HTTP 請求​

    GET /spot/v3/private/cross-margin-account

    請求參數​

    無

    返回參數​

    參數類型說明
    acctBalanceSumstring總資產 (折算成BTC)
    debtBalanceSumstring總負債 (折算成BTC)
    loanAccountListarrayObject
    > freestring可用餘額
    > intereststring未還利息
    > loanstring未還本金
    > remainAmountstring總未還金額 = 未還利息 + 未還本金
    > lockedstring鎖定金額
    > tokenIdstring幣種
    > totalstring合計
    riskRatestring風險率
    statusinteger借貸帳戶狀態
    • 1: 正常
    • 2: 限制提幣/劃轉
    • 3: 預警
    • 4: 已爆倉
    switchStatusinteger全倉槓桿狀態 0: 關閉, 1: 開啟

    請求示例​

    GET /spot/v3/private/cross-margin-account HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751305868
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "acctBalanceSum": "0.455189592150138021",
            "debtBalanceSum": "0",
            "loanAccountList": [
                {
                    "free": "0.01444",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "BTC",
                    "total": "0.01444"
                },
                {
                    "free": "0.21147048",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "ETH",
                    "total": "0.21147048"
                },
                {
                    "free": "7963.58978991849",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "USDT",
                    "total": "7963.58978991849"
                },
                {
                    "free": "1380.28832",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "USDC",
                    "total": "1380.28832"
                }
            ],
            "riskRate": "0",
            "status": 1,
            "switchStatus": 1
        },
        "retExtInfo": {},
        "time": 1677751306287
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/borrow-history.html b/zh-TW/spot/margin/borrow-history.html index 285c6106ba..a9ce890b51 100644 --- a/zh-TW/spot/margin/borrow-history.html +++ b/zh-TW/spot/margin/borrow-history.html @@ -4,13 +4,13 @@ 查詢借貸訂單 | Bybit API Documentation - +

    查詢借貸訂單

    HTTP 請求​

    GET /spot/v3/private/cross-margin-orders

    請求參數​

    參數是否必需類型說明
    startTimefalselong開始時間戳 (毫秒)
    endTimefalselong結束時間戳 (毫秒)
    coinfalsestring幣種名稱
    statusfalseinteger訂單狀態
    • 0(默認)：查詢所有狀態
    • 1：查詢未還清
    • 2：查詢已還清
    limitfalseinteger每頁數量限制. [1, 500]. 默認: 500

    返回參數​

    參數類型說明
    listarrayObject
    > accountIdstring帳戶ID
    > coinstring幣種名稱
    > createdTimenumber借貸訂單創建時間戳 (毫秒)
    > idstring借貸交易ID
    > interestAmountstring總利息
    > interestBalancestring未還利息
    > loanAmountstring借貸金額
    > loanBalancestring未還本金
    > remainAmountstring未還金額總和=未還利息+未還本金
    > statusinteger訂單狀態 1：未還清, 2：已還清
    > typeinteger訂單類型 1: 手動借貸, 2: 自動借貸

    請求示例​

    GET /spot/v3/private/cross-margin-orders?coin=ETH&limit=1&status=2 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677754328650
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "accountId": "592335",
                    "coin": "ETH",
                    "createdTime": 1677751839000,
                    "id": "21005",
                    "interestAmount": "0.0001",
                    "interestBalance": "0",
                    "loanAmount": "10",
                    "loanBalance": "0",
                    "remainAmount": "0",
                    "status": 2,
                    "type": 1
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677754329096
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/borrow.html b/zh-TW/spot/margin/borrow.html index fd3c69efb7..48af9ced49 100644 --- a/zh-TW/spot/margin/borrow.html +++ b/zh-TW/spot/margin/borrow.html @@ -4,13 +4,13 @@ 借款 | Bybit API Documentation - +

    借款

    HTTP 請求​

    POST /spot/v3/private/cross-margin-loan

    請求參數​

    參數是否必需類型說明
    cointruestring幣種
    qtytruestring借幣數量

    返回參數​

    參數類型說明
    transactIdstring借款交易ID

    請求示例​

    POST /spot/v3/private/cross-margin-loan HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751838628
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 38

    {
        "coin": "ETH",
        "qty": "10"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transactId": "21005"
        },
        "retExtInfo": {},
        "time": 1677751839688
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/borrowable-coin.html b/zh-TW/spot/margin/borrowable-coin.html index db8bf11263..a3520bdddb 100644 --- a/zh-TW/spot/margin/borrowable-coin.html +++ b/zh-TW/spot/margin/borrowable-coin.html @@ -4,13 +4,13 @@ 查詢可借幣種精度 | Bybit API Documentation - +

    查詢可借幣種精度

    信息

    這是個公告接口，不需要鑒權

    HTTP 請求​

    GET /spot/v3/public/cross-margin-borrow-data

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種名稱

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring幣種名稱
    > borrowingPrecisioninteger借款精度
    > repaymentPrecisioninteger還款精度

    請求示例​

    GET /spot/v3/public/cross-margin-borrow-data?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677750684772
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "borrowingPrecision": 5,
                    "coin": "ETH",
                    "repaymentPrecision": 4
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677750685331
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/interest.html b/zh-TW/spot/margin/interest.html index 5e61c6685f..170e17eba9 100644 --- a/zh-TW/spot/margin/interest.html +++ b/zh-TW/spot/margin/interest.html @@ -4,13 +4,13 @@ 查詢利率及額度 | Bybit API Documentation - +

    查詢利率及額度

    HTTP 請求​

    GET /spot/v3/private/cross-margin-loan-info

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱

    返回參數​

    參數類型說明
    coinstring幣種名稱
    interestRatestring基礎日利率
    loanAbleAmountstring預估可借最大金額
    maxLoanAmountstring平台設置的用戶最大可借金額

    請求示例​

    GET /spot/v3/private/cross-margin-loan-info?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677750928871
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "ETH",
            "interestRate": "0.000054835",
            "loanAbleAmount": "19.220442066850037795",
            "maxLoanAmount": "300"
        },
        "retExtInfo": {},
        "time": 1677750929290
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/margin-data.html b/zh-TW/spot/margin/margin-data.html index 9f5a536ddb..e2a51e76c9 100644 --- a/zh-TW/spot/margin/margin-data.html +++ b/zh-TW/spot/margin/margin-data.html @@ -4,13 +4,13 @@ 查詢保證金幣種信息 | Bybit API Documentation - +

    查詢保證金幣種信息

    信息

    這是個公共接口，不需要鑒權

    HTTP 請求​

    GET /spot/v3/public/cross-margin-bond-data

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種名稱

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring幣種名稱
    > conversionRatestring折算率, 返回為實際數值
    > liquidationOrderinteger強平順序

    請求示例​

    GET /spot/v3/public/cross-margin-bond-data?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677750396890
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "coin": "ETH",
                    "conversionRate": "0.95",
                    "liquidationOrder": 2
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677750397414
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/repay-history.html b/zh-TW/spot/margin/repay-history.html index bc4389a8b3..3a77a419d7 100644 --- a/zh-TW/spot/margin/repay-history.html +++ b/zh-TW/spot/margin/repay-history.html @@ -4,13 +4,13 @@ 查詢還款訂單信息 | Bybit API Documentation - +

    查詢還款訂單信息

    HTTP 請求​

    GET /spot/v3/private/cross-margin-repay-history

    請求參數​

    參數是否必需類型說明
    startTimefalselong開始時間戳 (毫秒)
    endTimefalselong結束時間戳 (毫秒)
    coinfalsestring幣種信息
    limitfalseinteger每頁數量限制. [1, 500], 默認: 500

    返回參數​

    參數類型說明
    listarrayObject
    > accountIdstring帳戶ID
    > coinstring幣種信息
    > repaidAmountstring還款金額
    > repayIdstring還款交易ID
    > repayMarginOrderIdstring還款單號
    > repayTimestring還款交易時間戳 (毫秒)
    > transactIdsarrayObject
    >> repaidIntereststring該筆還款訂單的利息還款金額
    >> repaidPrincipalstring該筆還款訂單的本金還款金額
    >> repaidSerialNumberstring借貸訂單的還款單號
    >> transactIdstring原始借貸交易ID

    請求示例​

    GET /spot/v3/private/cross-margin-repay-history?coin=ETH&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1677755884678
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "accountId": "592335",
                    "coin": "ETH",
                    "repaidAmount": "10.0001",
                    "repayId": "19070",
                    "repayMarginOrderId": "1367476828218072576",
                    "repayTime": "1677751941000",
                    "transactIds": [
                        {
                            "repaidAmount": "10.0001",
                            "repaidInterest": "0.0001",
                            "repaidPrincipal": "10",
                            "repaidSerialNumber": "1367475973544746496",
                            "transactId": "21005"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677755885169
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/repay.html b/zh-TW/spot/margin/repay.html index 9070de9524..147649cdd7 100644 --- a/zh-TW/spot/margin/repay.html +++ b/zh-TW/spot/margin/repay.html @@ -4,13 +4,13 @@ 還款 | Bybit API Documentation - +

    還款

    HTTP 請求​

    POST /spot/v3/private/cross-margin-repay

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱
    qtyfalsestring還款金額
    • 當completeRepayment=0時, qty必傳
    • 當completeRepayment=1時, qty無效
    completeRepaymentfalseinteger是否一鍵全部還款. 0(默認): 否, 1: 是

    返回參數​

    參數類型說明
    repayIdstring還款交易ID

    請求示例​

    POST /spot/v3/private/cross-margin-repay HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751944347
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 66

    {
        "coin": "ETH",
        "qty": null,
        "completeRepayment": 1
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "repayId": "19070"
        },
        "retExtInfo": {},
        "time": 1677751941219
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/margin/toggle.html b/zh-TW/spot/margin/toggle.html index 270ab74f13..10212467ab 100644 --- a/zh-TW/spot/margin/toggle.html +++ b/zh-TW/spot/margin/toggle.html @@ -4,13 +4,13 @@ 全倉槓桿開關 | Bybit API Documentation - +

    全倉槓桿開關

    開啟或關閉全倉槓桿交易

    HTTP 請求​

    POST /spot/v3/private/cross-margin-switch

    請求參數​

    參數是否必需類型說明
    switchtrueinteger1: 開啟, 0: 關閉

    響應參數​

    參數類型說明
    switchStatusinteger槓桿交易狀態. 1: 開啟, 0: 關閉

    請求示例​

    POST /spot/v3/private/cross-margin-switch HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677747804512
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 19

    {
        "switch": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "switchStatus": 0
        },
        "retExtInfo": {},
        "time": 1677747804974
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/otc/coin-info.html b/zh-TW/spot/otc/coin-info.html index 647d07f502..288b943215 100644 --- a/zh-TW/spot/otc/coin-info.html +++ b/zh-TW/spot/otc/coin-info.html @@ -4,13 +4,13 @@ 查詢保證金幣種信息 | Bybit API Documentation - +

    查詢保證金幣種信息

    提示

    這是公共接口，無需鑒權。

    HTTP 請求​

    GET /spot/v3/public/margin-ensure-tokens

    請求參數​

    參數是否必須類型說明
    productIdfalsestring產品ID. 若不傳，則返回所有產品的保證金幣種信息. 現貨返回折算率大於0的幣種.

    返回參數​

    參數類型說明
    marginTokenarrayObject
    > productIdstring產品ID
    > spotTokenarray現貨保證金幣種信息
    >> tokenstring保證金幣種
    >> convertRatiostring保證金幣種折算率
    > contractTokenarray合約保證金幣種信息
    >> tokenstring保證金幣種
    >> convertRatiostring保證金幣種折算率

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/public/margin-ensure-tokens?productId=70'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "marginToken": [
                {
                    "productId": "70",
                    "spotToken": [
                        {
                            "token": "BTC",
                            "convertRatio": "1.00000000"
                        },
                        {
                            "token": "ETH",
                            "convertRatio": "1.00000000"
                        },
                        {
                            "token": "USDT",
                            "convertRatio": "1"
                        }
                    ],
                    "contractToken": [
                        {
                            "token": "USDT",
                            "convertRatio": "1"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669363954802
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/otc/loan-info.html b/zh-TW/spot/otc/loan-info.html index e5568e2c4b..1895aa71ee 100644 --- a/zh-TW/spot/otc/loan-info.html +++ b/zh-TW/spot/otc/loan-info.html @@ -4,13 +4,13 @@ 查詢借貸訂單信息 | Bybit API Documentation - +

    查詢借貸訂單信息

    查詢借貸訂單的詳情

    HTTP 請求​

    GET /spot/v3/private/margin-loan-infos

    請求參數​

    參數是否必須類型說明
    orderIdfalsestring借貸訂單ID. 若不傳，則返回全部. 按照loanTime降序排列
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger返回數量限制. [1, 100], 默認: 10

    返回參數​

    參數類型說明
    loanInfoarrayObject
    > orderIdstring借貸訂單ID
    > orderProductIdstring產品ID
    > parentUidstring用戶母帳號ID
    > loanTimestring放款時間（毫秒）
    > loanCoinstring借款幣種
    > loanAmountstring借款金額
    > unpaidAmountstring未還本金
    > unpaidIntereststring未還利息
    > repaidAmountstring已還本金
    > repaidIntereststring已還利息
    > interestRatestring日利率
    > statusinteger1：未還清; 2：已還清
    > leveragestring槓桿倍數
    > supportSpotinteger是否支持現貨. 0:否; 1:是
    > supportContractinteger是否支持合約 . 0: 否; 1: 是
    > withdrawLinestring限制提幣線
    > transferLinestring限制劃轉線
    > spotBuyLinestring限制現貨買入線
    > spotSellLinestring限制現貨賣出線
    > contractOpenLinestring限制合約開倉線
    > liquidationLinestring強平線
    > stopLiquidationLinestring停止強平線
    > contractLeveragestring允許合約開倉倍數
    > transferRatiostring借貸資金劃轉比例
    > spotSymbolsarray現貨交易對白名單
    > contractSymbolsarray合約交易對白名單

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/margin-loan-infos' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1669364798602' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXXX'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "loanInfo": [
                {
                    "orderId": "1244781478207029504",
                    "orderProductId": "34",
                    "parentUid": "999805",
                    "loanTime": "1663126149000",
                    "loanCoin": "USDT",
                    "loanAmount": "500000",
                    "unpaidAmount": "6351.49614274",
                    "unpaidInterest": "264.0137162",
                    "repaidAmount": "493648.50385726",
                    "repaidInterest": "0",
                    "interestRate": "0.00027397",
                    "status": 1,
                    "leverage": "20",
                    "supportSpot": 1,
                    "supportContract": 1,
                    "withdrawLine": "0.5",
                    "transferLine": "0.6",
                    "spotBuyLine": "0.7",
                    "spotSellLine": "0.8",
                    "contractOpenLine": "0.9",
                    "liquidationLine": "0.95",
                    "stopLiquidationLine": "0.20000000",
                    "contractLeverage": "3",
                    "transferRatio": "0.1",
                    "spotSymbols": [
                        "DYDXQQTEST001",
                        "DYDXNEO",
                        "PMTEST16USDT"
                    ],
                    "contractSymbols": [
                        "RAYUSDT",
                        "API3USDT",
                        "SUSHIUSDT"
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669364798924
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/otc/ltv.html b/zh-TW/spot/otc/ltv.html index 5deb7ed1c0..63d77f96a4 100644 --- a/zh-TW/spot/otc/ltv.html +++ b/zh-TW/spot/otc/ltv.html @@ -4,13 +4,13 @@ 查詢風險率 | Bybit API Documentation - +

    查詢風險率

    若該接口返回空數據，請前往該接口查詢LTV

    HTTP 請求​

    GET /spot/v3/private/margin-ltv

    請求參數​

    無

    返回參數​

    參數類型說明
    ltvInfoarrayObject
    > ltvstring風險率
    > parentUidstring用戶ID
    > subAccountUidsarray綁定的子UID
    > unpaidAmountstring總負債 (USDT)
    > unpaidInfoarray負債明細
    >> tokenstring幣種
    >> unpaidQtystring未還本金
    >> unpaidIntereststring未還利息
    > balancestring總資產(保證金幣種資產折算為USDT資產). 可以參考這裡了解詳細計算
    > spotBalanceInfoarray現貨資產明細
    >> tokenstring現貨保證金幣種
    >> pricestring現貨保證金幣種價格
    >> qtystring現貨保證金數量
    > contractInfoarray合約資產明細
    >> tokenstring合約保證金幣種
    >> pricestring合約保證金幣種指數價格
    >> qtystring合約保證金幣種數量 (合約可用餘額，不參與LTV計算)

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/margin-ltv' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1669367335035' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXXXXX'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "ltvInfo": [
                {
                    "ltv": "0.1147",
                    "parentUid": "999805",
                    "subAccountUids": [
                        "999805"
                    ],
                    "unpaidAmount": "",
                    "unpaidInfo": [
                        {
                            "token": "USDT",
                            "unpaidQty": "6351.49614274",
                            "unpaidInterest": "264.0137162"
                        }
                    ],
                    "balance": "57626.875915433333333332400000000",
                    "spotBalanceInfo": [
                        {
                            "token": "BTC",
                            "price": "16375.621333333333333332",
                            "qty": "0.2"
                        },
                        ....
                        {
                            "token": "XRP",
                            "price": "0.409517",
                            "qty": "10000"
                        }
                    ],
                    "contractInfo": [
                        {
                            "token": "USDT",
                            "price": "1",
                            "qty": "0"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669367335608
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/otc/product-info.html b/zh-TW/spot/otc/product-info.html index c48fb66925..e2c732e668 100644 --- a/zh-TW/spot/otc/product-info.html +++ b/zh-TW/spot/otc/product-info.html @@ -4,13 +4,13 @@ 查詢保證金產品信息 | Bybit API Documentation - +

    查詢保證金產品信息

    提示

    這是公共接口，無需鑒權。

    HTTP 請求​

    GET /spot/v3/public/margin-product-infos

    請求參數​

    參數是否必須類型說明
    productIdfalsestring產品ID. 若不傳，則返回所有產品數據

    返回參數​

    參數類型說明
    marginProductInfoarrayObject
    > productIdstring產品ID
    > leveragestring槓桿倍數
    > supportSpotinteger是否支持現貨. 0:否; 1:是
    > supportContractinteger是否支持合約 . 0: 否; 1: 是
    > withdrawLinestring限制提幣線
    > transferLinestring限制劃轉線
    > spotBuyLinestring限制現貨買入線
    > spotSellLinestring限制現貨賣出線
    > contractOpenLinestring限制合約開倉線
    > liquidationLinestring強平線
    > stopLiquidationLinestring停止強平線
    > contractLeveragestring允許合約開倉倍數
    > transferRatiostring借貸資金劃轉比例
    > spotSymbolsarray現貨交易對白名單
    > contractSymbolsarray合約交易對白名單

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/margin-product-infos?productId=70'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "marginProductInfo": [
                {
                    "productId": "70",
                    "leverage": "5.00000000",
                    "supportSpot": 1,
                    "supportContract": 1,
                    "withdrawLine": "0.5",
                    "transferLine": "0.6",
                    "spotBuyLine": "0.7",
                    "spotSellLine": "0.8",
                    "contractOpenLine": "0.9",
                    "liquidationLine": "0.95",
                    "stopLiquidationLine": "0.40000000",
                    "contractLeverage": "",
                    "transferRatio": "",
                    "spotSymbols": [
                        "DYDXQQTEST001"
                    ],
                    "contractSymbols": [
                        "RAYUSDT",
                        "API3USDT"
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669362961705
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/otc/repay-info.html b/zh-TW/spot/otc/repay-info.html index 1d6887d1c6..d745e0dc0a 100644 --- a/zh-TW/spot/otc/repay-info.html +++ b/zh-TW/spot/otc/repay-info.html @@ -4,13 +4,13 @@ 查詢還款信息 | Bybit API Documentation - +

    查詢還款信息

    HTTP 請求​

    GET /spot/v3/private/margin-repaid-infos

    請求參數​

    參數是否必須類型說明
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger返回數量限制. [1, 100]. 默認: 100

    返回參數​

    參數類型說明
    repayInfoarrayObject
    > repayOrderIdstring還款訂單號
    > repaidTimestring還款時間（毫秒）
    > tokenstring還款幣種
    > quantitystring還款本金
    > intereststring還款利息
    > businessTypestring還款類型. 1：正常還款; 2：系統強平還款
    > statusstring1：未還清; 2：已還清

    Request Example​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/margin-repaid-infos?startTime=1663126392000&endTime=1663126394000' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1669366647851' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXXX'

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "repayInfo": [
                {
                    "repayOrderId": "8189",
                    "repaidTime": "1663126393000",
                    "token": "USDT",
                    "quantity": "30000",
                    "interest": "0",
                    "businessType": "1",
                    "status": "1"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669366648366
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/public/bid-ask.html b/zh-TW/spot/public/bid-ask.html index 646f077fde..3699a16bab 100644 --- a/zh-TW/spot/public/bid-ask.html +++ b/zh-TW/spot/public/bid-ask.html @@ -4,13 +4,13 @@ 最佳買賣價 | Bybit API Documentation - +

    最佳買賣價

    信息

    如果symbol沒有被發送，所有symbol的最佳訂單簿價格都會被返回。

    HTTP 請求​

    GET /spot/v3/public/quote/ticker/bookTicker

    請求參數​

    參數是否必須類型說明
    symboltruestring幣對名稱

    返回參數​

    參數類型說明
    symbolstring幣對名稱
    bidPricestring最佳買價
    bidQtystring最佳買價數量
    askPricestring最佳賣價
    askQtystring最佳賣價數量
    timenumber毫秒時間戳

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/ticker/bookTicker?symbol=BTCUSDT'

    響應示例​

    {
      "retCode": 0,
      "retMsg": "OK",
      "result": {
        "symbol": "BTCUSDT",
        "bidPrice": "21170.14",
        "bidQty": "0.908276",
        "askPrice": "21250",
        "askQty": "0.009264",
        "time": 1659431461695
      },
      "retExtInfo": {},
      "time": 1659431462103
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/public/depth.html b/zh-TW/spot/public/depth.html index b7cc28cb00..c2cd9b1768 100644 --- a/zh-TW/spot/public/depth.html +++ b/zh-TW/spot/public/depth.html @@ -4,13 +4,13 @@ 訂單簿 | Bybit API Documentation - +

    訂單簿

    HTTP 請求​

    GET /spot/v3/public/quote/depth

    請求參數​

    參數是否必須類型說明
    symboltruestring幣對名稱
    limitfalseinteger返回數量限制。[1, 200], 默認為100

    返回參數​

    參數類型說明
    timenumber當前時間
    bidsarraybid的價格和數量信息，最優bid價格由上到下排列
    asksarrayask的價格和數量信息，最優ask價格由上到下排列

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/depth?symbol=BTCUSDT&limit=1'

    響應示例​

    {
      "retCode": 0,
      "retMsg": "OK",
      "result": {
        "time": 1659429083820,
        "bids": [
          [
            "21170.14",
            "0.050096"
          ]
        ],
        "asks": [
          [
            "21250",
            "0.00211"
          ]
        ]
      },
      "retExtInfo": {},
      "time": 1659429083979
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/public/instrument.html b/zh-TW/spot/public/instrument.html index 1eda924be9..4c74e6b843 100644 --- a/zh-TW/spot/public/instrument.html +++ b/zh-TW/spot/public/instrument.html @@ -4,13 +4,13 @@ 查詢所有交易對 | Bybit API Documentation - +

    查詢所有交易對

    獲取所有交易對

    HTTP 請求​

    GET /spot/v3/public/symbols

    請求參數​

    無

    返回參數​

    參數類型說明
    listarrayObject
    > namestring幣對名稱
    > aliasstring幣對別名
    > baseCoinstringbase幣種
    > quoteCoinstringquote幣種
    > basePrecisionstringbase幣種精度
    > quotePrecisionstringquote幣種精度
    > minTradeQtystring最小訂單數量 (對市價買單無效)
    > minTradeAmtstring最小訂單額 (只對市價買單有效)
    > minPricePrecisionstring最小價格精度
    > maxTradeQtystring最大成交量（當您下訂單類型為 LIMIT_MAKER 時將被忽略）
    > maxTradeAmtstring最大成交額（當您下訂單類型為 LIMIT_MAKER 時將被忽略）
    > categorystringsymbol 所在分區:1主類別
    > innovationstring1 表示創新區：這個幣種價格波動比較大
    > showStatusstring1 表示該現貨開放交易

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/symbols'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "name": "BTCUSDT",
                    "alias": "BTCUSDT",
                    "baseCoin": "BTC",
                    "quoteCoin": "USDT",
                    "basePrecision": "0.000001",
                    "quotePrecision": "0.00000001",
                    "minTradeQty": "0.000001",
                    "minTradeAmt": "10",
                    "maxTradeQty": "63.01197227",
                    "maxTradeAmt": "1000000",
                    "minPricePrecision": "0.01",
                    "category": "1",
                    "showStatus": "1",
                    "innovation": "0"
                },
                {
                    "name": "ETHUSDT",
                    "alias": "ETHUSDT",
                    "baseCoin": "ETH",
                    "quoteCoin": "USDT",
                    "basePrecision": "0.00001",
                    "quotePrecision": "0.0000001",
                    "minTradeQty": "0.00224",
                    "minTradeAmt": "10",
                    "maxTradeQty": "100000000",
                    "maxTradeAmt": "100000000",
                    "minPricePrecision": "0.01",
                    "category": "1",
                    "showStatus": "1",
                    "innovation": "0"
                }
            ]
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659067662931
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/public/kline.html b/zh-TW/spot/public/kline.html index 2ebd436bfe..820c091d99 100644 --- a/zh-TW/spot/public/kline.html +++ b/zh-TW/spot/public/kline.html @@ -4,13 +4,13 @@ 查詢K線數據 | Bybit API Documentation - +

    查詢K線數據

    信息

    返回指定的時間間隔最近1000根的K線結果

    信息

    如果startTime和endTime沒有發送，只有最新的K線會被返回

    HTTP 請求​

    GET /spot/v3/public/quote/kline

    請求參數​

    參數是否必須類型
    symboltruestring幣對名稱
    intervaltruestringK線圖區間。可識別發送的值為：1m, 5m, 15m, 30m, 1h, 1d, 1w, 1M (m=分鐘, h=小時, d=天, w=星期, M=月)
    limitfalseinteger返回數量限制. [1, 1000]. 默認: 1000
    startTimefalseinteger第一條返回的時間戳(毫秒)
    endTimefalseinteger最後一條返回的時間戳(毫秒)

    返回參數​

    參數類型說明
    listarrayObject
    > tnumber時間戳(毫秒)
    > sstring幣對名稱
    > snstring幣對別名
    > cstring收盤價
    > hstring最高價
    > lstring最低價
    > ostring開盤價
    > vstring交易金額

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/kline?symbol=BTCUSDT&interval=1m&limit=1'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "t": 1659430380000,
                    "s": "BTCUSDT",
                    "sn": "BTCUSDT",
                    "c": "21170.14",
                    "h": "21170.14",
                    "l": "21127.86",
                    "o": "21127.86",
                    "v": "0.907276"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1659430400353
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/public/last-price.html b/zh-TW/spot/public/last-price.html index 281c7e739d..a2f1539388 100644 --- a/zh-TW/spot/public/last-price.html +++ b/zh-TW/spot/public/last-price.html @@ -4,13 +4,13 @@ Symbol最新價 | Bybit API Documentation - +

    Symbol最新價

    信息

    如果symbol沒有被發送，所有symbol的價格都會被返回

    HTTP 請求​

    GET /spot/v3/public/quote/ticker/price

    請求參數​

    參數是否必須類型說明
    symbolfalsestring幣對名稱

    返回參數​

    參數類型說明
    symbolstring幣對名稱
    pricestring訂單價格，對於LIMIT 訂單必需發送

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/ticker/price?symbol=BTCUSDT'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "price": "21127.86"
        },
        "retExtInfo": {},
        "time": 1659431315936
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/public/merge-depth.html b/zh-TW/spot/public/merge-depth.html index 1991531f6a..9bdff238cd 100644 --- a/zh-TW/spot/public/merge-depth.html +++ b/zh-TW/spot/public/merge-depth.html @@ -4,13 +4,13 @@ 合並訂單簿 | Bybit API Documentation - +

    合並訂單簿

    HTTP 請求​

    GET /spot/v3/public/quote/depth/merged

    請求參數​

    參數是否必須類型說明
    symboltruestring幣對名稱
    scalefalseinteger合並深度的精度，1代表1位小數
    limitfalseinteger返回數量限制。[1, 200], 默認為100

    返回參數​

    參數類型說明
    timenumber當前時間
    bidsarraybid的價格和數量信息，最優bid價格由上到下排列
    asksarrayask的價格和數量信息，最優ask價格由上到下排列

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/depth/merged?symbol=BTCUSDT&scale=1&limit=1'

    響應示例​

    {
      "retCode": 0,
      "retMsg": "OK",
      "result": {
        "time": 1659429646349,
        "bids": [
          [
            "21170.1",
            "0.049096"
          ]
        ],
        "asks": [
          [
            "21250",
            "0.00211"
          ]
        ]
      },
      "retExtInfo": {},
      "time": 1659429646652
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/public/recent-trade.html b/zh-TW/spot/public/recent-trade.html index 0bb82d6047..612bf611ee 100644 --- a/zh-TW/spot/public/recent-trade.html +++ b/zh-TW/spot/public/recent-trade.html @@ -4,13 +4,13 @@ 平臺交易歷史數據 | Bybit API Documentation - +

    平臺交易歷史數據

    HTTP 請求​

    GET /spot/v3/public/quote/trades

    請求參數​

    參數是否必須類型說明
    symboltruestring幣對名稱
    limitfalseinteger返回數量限制. [1, 60]. 默認: 60

    返回參數​

    參數類型說明
    listarrayObject
    > pricestring價格
    > timenumber當前Unix時間戳(毫秒)
    > qtystring交易數量
    > isBuyerMakerinteger0：賣單或者taker單, 1：買方maker單
    > typestring0：普通交易, 1：Paradigm 大宗交易

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/trades?symbol=BTCUSDT&limit=1'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "price": "21170.14",
                    "time": 1659429793926,
                    "qty": "0.907276",
                    "isBuyerMaker": 0,
                    "type": "0"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1659429835311
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/public/tickers.html b/zh-TW/spot/public/tickers.html index a6eaef91ee..3c833eb845 100644 --- a/zh-TW/spot/public/tickers.html +++ b/zh-TW/spot/public/tickers.html @@ -4,13 +4,13 @@ 最新信息 | Bybit API Documentation - +

    最新信息

    HTTP 請求​

    GET /spot/v3/public/quote/ticker/24hr

    信息

    如果symbol不傳遞，所有symbol的數據都會被返回

    請求參數​

    參數是否必須類型說明
    symbolfalsestring幣對名稱

    返回參數​

    參數類型說明
    tnumber當前Unix時間戳 (毫秒)
    sstring幣對名稱
    lpstring最新成交價
    hstring最高價
    lstring最低價
    ostring開盤價
    bpstring最佳買價
    apstring最佳賣價
    vstring成交量
    qvstring成交金額

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/public/quote/ticker/24hr?symbol=BTCUSDT'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "t": 1659430933736,
            "s": "BTCUSDT",
            "lp": "21127.86",
            "h": "22000",
            "l": "19779.14",
            "o": "19935.19",
            "bp": "21170.14",
            "ap": "21250",
            "v": "211.378621",
            "qv": "4460854.96730398"
        },
        "retExtInfo": {},
        "time": 1659430975794
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/rate-limit.html b/zh-TW/spot/rate-limit.html index ddb6b5d401..8fa65862c6 100644 --- a/zh-TW/spot/rate-limit.html +++ b/zh-TW/spot/rate-limit.html @@ -4,14 +4,14 @@ 頻率限制 | Bybit API Documentation - +

    頻率限制

    IP限頻​

    警告

    如果您收到HTTP 403（拒絕訪問）響應, 您的 IP 已被暫時或永久禁止。 您應立即查看以下指南，以確保您的應用程序不會繼續違反限制。如果您在 30 分鐘後 仍被禁止，則您可能會被永久禁止。

    我們不建議您在這些限制的邊緣運行您的應用程序，以防異常的網絡活動導致意外違規。

    • GET/POST 請求 (共享):
      • 連續 5 秒內每秒不超過 120 個請求
    備註

    所有到api.bybit.com或api.bytick.com的流量共享此限制，無論是訪問現貨、期貨還是期權。

    違反限制後，您的 IP 將被禁止一段時間（通常為 30 分鐘）。 持續違反限制將導致永久禁止。 我們不能撤銷永久禁令或縮短臨時禁令。

    賬戶頻率限製​

    警告

    如果您收到這樣的響應"ret_msg": "Too many visits!", 則表示您觸發了帳戶頻率限制, 請等到頻率限制重置以後, 再繼續發送請求。

    Bybit基於每秒鍾的滾動時間窗口來做頻率限製，並且是按賬戶（uid）來做劃分限製，每次請求API響應頭(response header)中都會包含如下字段：

    • X-Bapi-Limit-Status - 該接口當前時間窗口剩余可用請求數
    • X-Bapi-Limit - 該接口當前頻率限製上限
    • X-Bapi-Limit-Reset-Timestamp - 如果您已超過該接口當前窗口頻率限製，該字段表示下個可用時間窗口的時間戳（毫秒），即什麽時候可以恢復訪問；如果您未超過該接口當前窗口頻率限製，該字段表示返回的是當前服務器時間（毫秒).

    Http 響應頭示例

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    接口頻率限制表​

    路徑頻率
    全倉槓桿5 req/s
    所有其他私有接口20 req/s

    如何提高頻率限製​

    請發送郵件到 api@bybit.com，我們會在 1-4 個工作日內答復。郵件內容必須包含以下內容：

    1. 您的姓名和公司名稱和簡介
    2. 您的bybit 賬號uid或註冊郵箱手機號,以及您要申請提頻的交易對
    3. 您上個月的交易量（吃單/掛單）並提供截圖
    4. 簡單介紹您的交易策略和為什麽需要更高限頻
    5. 如果可以，請提供您的成交記錄csv文檔
    - + \ No newline at end of file diff --git a/zh-TW/spot/trade/batch-cancel.html b/zh-TW/spot/trade/batch-cancel.html index e86271011f..556a2db965 100644 --- a/zh-TW/spot/trade/batch-cancel.html +++ b/zh-TW/spot/trade/batch-cancel.html @@ -4,13 +4,13 @@ 批量撤銷訂單 | Bybit API Documentation - +

    批量撤銷訂單

    HTTP 請求​

    POST /spot/v3/private/cancel-orders

    請求參數​

    參數是否必須類型說明
    symboltruestring幣對名稱
    sidefalsestring買賣方向. Buy, Sell
    orderTypesfalsestring訂單類型. 默認為LIMIT. 支持多個訂單類型取消, 用英文逗號分開, 例如：LIMIT,LIMIT_MAKER.
    orderCategoryfalseinteger訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳

    返回參數​

    參數類型說明
    successstring是否成功. 0：失敗, 1：成功

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/cancel-orders' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659078150737' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "symbol": "BTCUSDT",
        "side": "Buy",
        "orderTypes": "LIMIT,LIMIT_MAKER"
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "success": "1"
        },
        "retExtInfo": {},
        "time": 1659080154042
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/trade/cancel-by-id.html b/zh-TW/spot/trade/cancel-by-id.html index 8f5e176b28..568c5a1c80 100644 --- a/zh-TW/spot/trade/cancel-by-id.html +++ b/zh-TW/spot/trade/cancel-by-id.html @@ -4,13 +4,13 @@ 根據訂單號批量撤銷訂單 | Bybit API Documentation - +

    根據訂單號批量撤銷訂單

    HTTP 請求​

    POST /spot/v3/private/cancel-orders-by-ids

    請求參數​

    參數是否必須類型說明
    orderIdstruestring訂單號, 可用英文逗號拼接表示多個訂單, 不超過100個。
    orderCategoryfalseinteger訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳

    返回參數​

    參數類型說明
    listarrayObject. 若全部成功，則返回空數組[]
    > orderIdstring訂單ID
    > codestring錯誤碼

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/cancel-orders-by-ids' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659080877551' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "orderIds": "1210851823244553984,1210852013162639104"
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": []
        },
        "retExtInfo": {},
        "time": 1659080815222
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/trade/cancel.html b/zh-TW/spot/trade/cancel.html index ead419e76f..1b9742974c 100644 --- a/zh-TW/spot/trade/cancel.html +++ b/zh-TW/spot/trade/cancel.html @@ -4,13 +4,13 @@ 撤銷活動委托單 | Bybit API Documentation - +

    撤銷活動委托單

    HTTP 請求​

    POST /spot/v3/private/cancel-order

    請求參數​

    參數是否必須類型說明
    orderIdfalsestring訂單ID. 當orderLinkId為空時, 則必傳
    orderLinkIdfalsestring用戶自定義ID. 當orderId為空時, 則必傳
    orderCategoryfalseinteger訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳

    返回參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring自定義訂單ID，用戶自己生成
    symbolstring幣對名稱
    statusstring訂單狀態
    accountIdstring賬戶ID
    orderPricestring訂單價格
    createTimestring訂單創建時間
    orderQtystring訂單數量
    execQtystring成交數量
    timeInForcestring執行策略
    orderTypestring訂單類型, LIMIT/MARKET/LIMIT_MAKER
    sidestring買賣方向. BUY：買入, SELL：賣出.

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/cancel-order' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659078017415' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "orderId": "1210810256551063296",
        "orderLinkId": null
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1210810256551063296",
            "orderLinkId": "spotA0010",
            "symbol": "BTCUSDT",
            "status": "NEW",
            "accountId": "533287",
            "createTime": "1659075830464",
            "orderPrice": "23500",
            "orderQty": "0.01",
            "execQty": "0",
            "timeInForce": "GTC",
            "orderType": "LIMIT",
            "side": "SELL"
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659078151226
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/trade/get-order.html b/zh-TW/spot/trade/get-order.html index ba0821f562..a74d0378de 100644 --- a/zh-TW/spot/trade/get-order.html +++ b/zh-TW/spot/trade/get-order.html @@ -4,13 +4,13 @@ 查詢活動委托 | Bybit API Documentation - +

    查詢活動委托

    HTTP 請求​

    GET /spot/v3/private/order

    請求參數​

    參數是否必須類型說明
    orderIdfalsestring訂單ID. 當orderLinkId為空時, 則必傳
    orderLinkIdfalsestring用戶自定義ID. 當orderId為空時, 則必傳
    orderCategoryfalseinteger訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳

    返回參數​

    參數類型說明
    accountIdstring賬戶ID
    symbolstring幣對名稱
    orderLinkIdstring特殊訂單ID，用戶自己生成
    orderIdstring訂單ID
    orderPricestring訂單價格
    orderQtystring訂單數量
    execQtystring成交數量
    cummulativeQuoteQtystring鎖定數量（如果為0，則說明該筆訂單的資金已完成結算）
    avgPricestring訂單已成交的平均價格
    statusstring訂單狀態。可能出現的值為：NEW(新訂單，無成交)、PARTIALLY_FILLED（部分成交）、FILLED（全部成交）、CANCELED（已取消）和REJECTED（訂單被拒絕）.
    timeInForcestring執行策略
    orderTypestring訂單類型, LIMIT/MARKET/LIMIT_MAKER
    sidestring訂單方向, BUY(買入做多)/SELL(賣出做空)
    stopPricestring停止價
    icebergQtystring請忽略
    createTimestring撮合引擎中的創建時間
    updateTimestring訂單上次更新的時間戳
    isWorkingstring是否生效. 0：未生效, 1：已生效
    lockedstring鎖定數量（如果為0，則說明該筆訂單的資金已完成結算）
    blockTradeIdstringParadigm大宗交易ID
    cancelTypestringCancel type. CancelBySmp
    smpTypestringSMP執行類型
    smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    smpOrderIdstring觸發此SMP執行的交易對手的 orderID

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/order?orderLinkId=spotA0010' \
    --header 'X-BAPI-SIGN: 828571067751622ed4191e7e8ee913defccd1f099b9dfb8332a6a05edf799eaf' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659076396894' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "accountId": "533287",
            "symbol": "BTCUSDT",
            "orderLinkId": "spotA0010",
            "orderId": "1210810256551063296",
            "orderPrice": "23500",
            "orderQty": "0.01",
            "execQty": "0",
            "cummulativeQuoteQty": "0",
            "avgPrice": "0",
            "status": "NEW",
            "timeInForce": "GTC",
            "orderType": "LIMIT",
            "side": "SELL",
            "stopPrice": "0.0",
            "icebergQty": "0.0",
            "createTime": "1659075830464",
            "updateTime": "1659075830497",
            "isWorking": "1",
            "locked": "0.01",
            "blockTradeId": "",
            "cancelType": "UNKNOWN"
            "smpGroup": 0,
            "smpOrderId": "",
            "smpType": "None"
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659076397365
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/trade/my-trades.html b/zh-TW/spot/trade/my-trades.html index d5155d5b15..ca3d800d7e 100644 --- a/zh-TW/spot/trade/my-trades.html +++ b/zh-TW/spot/trade/my-trades.html @@ -4,14 +4,14 @@ 交易記錄 | Bybit API Documentation - +

    交易記錄

    信息
    • 如果不傳startTime，只能查詢最近7天的交易數據。如果要查詢一周之前的歷史交易數據，需要傳startTime
    • 僅當不傳入orderId, 不傳入toTicketId，但傳入fromTicketId時，返回的結果是以ticketId從小 到大排序；否則，返回的結果以ticketId從大到小排序
    • 支持查询过去180天的记录
    提示

    fromTradeId和toTradeId的規則：

    • orderId不傳時
    1. 僅fromTradeId傳入, fromTradeId不會被包含在響應中
    2. 僅toTradeId傳入, toTradeId不會被包含在響應中
    3. 當fromTradeId和toTradeId都傳入, fromTradeId不包含，但是toTradeId會在響應中，如果它的值是存在的tradeId
    • orderId不傳時: fromTradeId和toTradeid的值會總是被包含在響應中，如果它們的值是存在的tradeId。

    HTTP 請求​

    GET /spot/v3/private/my-trades

    請求參數​

    參數是否必須類型說明
    symbolfalsestring幣對名稱
    orderIdfalsestring訂單ID
    limitfalsestring返回數量限制. [1, 50]. 默认: 50
    startTimefalseinteger起始時間戳（毫秒）
    endTimefalseinteger結束時間戳（毫秒）
    fromTradeIdfalsestring從大於此trade ID 開始查詢
    toTradeIdfalsestring以小於此trade ID 為終點

    返回參數​

    參數類型說明
    symbolstring幣對名稱
    idstring與 API 使用無關。 該字段反映了網站交易歷史中“交易ID”的一部分
    orderIdstring訂單ID
    tradeIdstring交易ID
    orderPricestring訂單價格
    orderQtystring交易數量
    execFeestring手續費
    feeTokenIdstring手續費 Token ID
    creatTimestring撮合引擎中的創建時間
    isBuyerstring0：買方, 1：賣方
    isMakerstring0：掛單, 1：吃單
    matchOrderIdstring對手交易者的order_id
    makerRebatestringMaker折扣
    executionTimestring訂單完成時間
    blockTradeIdstringParadigm大宗交易ID

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/my-trades?symbol=BTCUSDT' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659084253772' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "id": "1210346127973428992",
                    "orderId": "1210073515485572864",
                    "tradeId": "2100000000001769786",
                    "orderPrice": "20500",
                    "orderQty": "0.02",
                    "execFee": "0.00002",
                    "feeTokenId": "BTC",
                    "creatTime": "1659020488738",
                    "isBuyer": "0",
                    "isMaker": "0",
                    "matchOrderId": "1210346015893229312",
                    "makerRebate": "0",
                    "executionTime": "1659020502026",
                    "blockTradeId": ""
                },
                {
                    "symbol": "BTCUSDT",
                    "id": "1208702504949264128",
                    "orderId": "1208702504731160320",
                    "tradeId": "2100000000001753197",
                    "orderPrice": "20240",
                    "orderQty": "0.009881",
                    "execFee": "0.000009881",
                    "feeTokenId": "BTC",
                    "creatTime": "1658824566874",
                    "isBuyer": "0",
                    "isMaker": "1",
                    "matchOrderId": "1208677465155702529",
                    "makerRebate": "0",
                    "executionTime": "1658824566893",
                    "blockTradeId": ""
                }
            ]
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659084254366
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/trade/open-order.html b/zh-TW/spot/trade/open-order.html index 83731f4194..855f0d0576 100644 --- a/zh-TW/spot/trade/open-order.html +++ b/zh-TW/spot/trade/open-order.html @@ -4,13 +4,13 @@ 訂單列表 | Bybit API Documentation - +

    訂單列表

    HTTP 請求​

    GET /spot/v3/private/open-orders

    請求參數​

    參數是否必須類型說明
    symbolfalsestring幣對名稱
    orderIdfalsestring通過指定訂單ID返回比這個orderId小的訂單,可以用來分頁
    limitfalsestring返回數量限制. [1, 500]. 默認: 500
    orderCategoryfalseinteger訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳

    返回參數​

    參數類型說明
    accountIdstring賬戶ID
    symbolstring幣對名稱
    orderLinkIdstring特殊訂單ID，用戶自己生成
    orderIdstring訂單ID
    orderPricestring訂單價格
    orderQtystring訂單數量
    execQtystring成交數量
    cummulativeQuoteQtystring鎖定數量（如果為0，則說明該筆訂單的資金已完成結算）
    avgPricestring訂單已成交的平均價格
    statusstring訂單狀態。可能出現的值為：NEW(新訂單，無成交)、PARTIALLY_FILLED（部分成交）、FILLED（全部成交）、CANCELED（已取消）和REJECTED（訂單被拒絕）.
    timeInForcestring執行策略
    orderTypestring訂單類型, LIMIT/MARKET/LIMIT_MAKER
    sidestring買賣方向. BUY：買入, SELL：賣出 ｜
    stopPricestring停止價
    icebergQtystring請忽略
    createTimenumber撮合引擎中的創建時間
    updateTimenumber訂單上次更新的時間戳
    isWorkingstring是否生效. 0：未生效, 1：已生效
    orderCategoryinteger訂單種類. 0：普通單; 1：止盈止損單. 止盈止損單有這個字段
    triggerPricestring觸發價格. 止盈止損單有這個字段
    blockTradeIdstringParadigm大宗交易ID
    cancelTypestringCancel type. CancelBySmp
    smpTypestringSMP執行類型
    smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    smpOrderIdstring觸發此SMP執行的交易對手的 orderID

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/open-orders?symbol=BTCUSDT' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659081676022' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "accountId": "533287",
                    "symbol": "BTCUSDT",
                    "orderLinkId": "spotx004",
                    "orderId": "1210858291884732160",
                    "orderPrice": "23500",
                    "orderQty": "0.02",
                    "execQty": "0",
                    "cummulativeQuoteQty": "0",
                    "avgPrice": "0",
                    "status": "NEW",
                    "timeInForce": "GTC",
                    "orderType": "LIMIT_MAKER",
                    "side": "SELL",
                    "stopPrice": "0.0",
                    "icebergQty": "0.0",
                    "createTime": 1659081556722,
                    "updateTime": 1659081556740,
                    "isWorking": "1"
                    "blockTradeId": "",
                    "cancelType": "UNKNOWN"
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "smpType": "None"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1659081570356
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/trade/order-history.html b/zh-TW/spot/trade/order-history.html index 73588324be..3388f4e22f 100644 --- a/zh-TW/spot/trade/order-history.html +++ b/zh-TW/spot/trade/order-history.html @@ -4,13 +4,13 @@ 歷史訂單 | Bybit API Documentation - +

    歷史訂單

    信息
    • 如果startTime和endTime都不傳，則默認查詢近7天的數據。
    • 單次查詢最長3個月，最長支持查詢最近6個月的歷史數據。
    • 市商總是只能查最近3天的數據
    • 取消單、拒絕單、未觸發取消單, 最多保留7天

    HTTP 請求​

    GET /spot/v3/private/history-orders

    請求參數​

    參數是否必須類型說明
    symbolfalsestring幣對名稱
    orderIdfalsestring通過指定訂單ID返回比這個orderId小的訂單,可以用來分頁
    limitfalseinteger返回數量限制. [1, 500]. 默認: 100
    startTimefalseinteger起始時間戳（毫秒）
    endTimefalseinteger結束時間戳（毫秒）
    orderCategoryfalseinteger訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳

    返回參數​

    參數類型說明
    accountIdstring賬戶ID
    symbolstring幣對名稱
    orderLinkIdstring特殊訂單ID，用戶自己生成
    orderIdstring訂單ID
    orderPricestring訂單價格，對於LIMIT 訂單必需發送
    orderQtystring訂單數量
    execQtystring成交數量
    cummulativeQuoteQtystring對於某些歷史數據 cummulativeQuoteQty 可能會 < 0, 這說明數據當前不可用。
    avgPricestring訂單已成交的平均價格
    statusstring訂單狀態
    timeInForcestring執行策略
    orderTypestring訂單類型, LIMIT/MARKET/LIMIT_MAKER
    sidestring買賣方向. BUY：買入, SELL：賣出
    stopPricestring停止價
    icebergQtystring請忽略
    createTimenumber撮合引擎中的創建時間
    updateTimenumber訂單上次更新的時間戳
    isWorkingstring是否生效. 0：未生效, 1：已生效
    orderCategoryinteger訂單種類. 0：普通單; 1：止盈止損單. 止盈止損單有這個字段
    triggerPricestring觸發價格. 止盈止損單有這個字段
    blockTradeIdstringParadigm大宗交易ID
    cancelTypestringCancel type. CancelBySmp
    smpTypestringSMP執行類型
    smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    smpOrderIdstring觸發此SMP執行的交易對手的 orderID

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/history-orders?symbol=BTCUSDT&limit=2&startTime=1658246400000&endTime=1659110400000' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659082629976' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "accountId": "533287",
                    "symbol": "BTCUSDT",
                    "orderLinkId": "spotx003",
                    "orderId": "1210856408331857664",
                    "orderPrice": "23800",
                    "orderQty": "0.02",
                    "execQty": "0",
                    "cummulativeQuoteQty": "0",
                    "avgPrice": "0",
                    "status": "REJECTED",
                    "timeInForce": "GTC",
                    "orderType": "LIMIT_MAKER",
                    "side": "BUY",
                    "stopPrice": "0.0",
                    "icebergQty": "0.0",
                    "createTime": 1659081332185,
                    "updateTime": 1659081332225,
                    "isWorking": "1",
                    "blockTradeId": "1",
                    "cancelType": "UNKNOWN"
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "smpType": "None"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1659082630638
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/trade/place-order.html b/zh-TW/spot/trade/place-order.html index f8fbfeae0e..0c88bc030e 100644 --- a/zh-TW/spot/trade/place-order.html +++ b/zh-TW/spot/trade/place-order.html @@ -4,13 +4,13 @@ 創建活動委托單 | Bybit API Documentation - +

    創建活動委托單

    信息

    普通單和止盈止損單的orderLinkId不能重複

    HTTP 請求​

    POST /spot/v3/private/order

    請求參數​

    參數是否必須類型說明
    symboltruestring幣對名稱
    orderQtytruestring交易數量(市價買單即type=MARKET且side=BUY currency；比如BTCUSDT的qty指的是USDT的qty, 而非市價買單時qty指向都是BTC)
    sidetruestring買賣方向. BUY：買入, SELL：賣出
    orderTypetruestring訂單類型, LIMIT/MARKET/LIMIT_MAKER
    timeInForcefalsestring執行策略
    orderPricefalsestring訂單價格。type字段為MARKET時，price字段為非必須。type字段為LIMIT或LIMIT_MAKER時，price字段為必須
    orderLinkIdfalsestring特殊訂單ID，用戶自己生成
    orderCategoryfalseinteger訂單類型. 默認為0：普通訂單; 1：止盈止損訂單, 下止盈止損單，該參數必傳
    triggerPricefalsestring觸發價格. 用於止盈止損單
    smpTypefalsestringSmp執行類型. 什麼是SMP?

    返回參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring特殊訂單ID，用戶自己生成
    symbolstring幣對名稱
    createTimestring訂單創建時間
    orderPricestring訂單價格，對於LIMIT 訂單必需發送
    orderQtystring訂單數量
    orderTypestring訂單類型, LIMIT/MARKET/LIMIT_MAKER
    sidestring買賣方向. BUY：買入, SELL：賣出
    statusstring訂單狀態
    timeInForcestring執行策略
    accountIdstring賬戶ID
    execQtystring請忽略
    orderCategoryinteger訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳
    triggerPricestring觸發價格
    smpTypestringSmp執行類型

    請求示例​

    curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/order' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659067662307' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "symbol": "BTCUSDT",
        "orderQty":"0.01",
        "side": "BUY",
        "orderType": "LIMIT",
        "timeInForce": "GTC",
        "orderPrice": "21300",
        "orderLinkId": "spotx006",
        "orderCategory": 1,
        "triggerPrice": "21700"
    }'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1230969397479298560",
            "orderLinkId": "spotx006",
            "symbol": "BTCUSDT",
            "createTime": "1661478987332",
            "orderPrice": "21300",
            "orderQty": "0.01",
            "orderType": "LIMIT",
            "side": "BUY",
            "status": "ORDER_NEW",
            "timeInForce": "GTC",
            "accountId": "554118",
            "orderCategory": 1,
            "triggerPrice": "21700",
            "smpType": "None"
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1661478987364
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/wallet.html b/zh-TW/spot/wallet.html index a3ed42c23f..1174db7eb1 100644 --- a/zh-TW/spot/wallet.html +++ b/zh-TW/spot/wallet.html @@ -4,13 +4,13 @@ 查詢錢包余額 | Bybit API Documentation - +

    查詢錢包余額

    HTTP 請求​

    GET /spot/v3/private/account

    請求參數​

    無

    返回參數​

    參數類型說明
    balancesarrayObject
    > coinstring幣種
    > coinIdstring幣種ID
    > totalstring總額
    > freestring可用余額
    > lockedstring凍結余額

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/account' \
    --header 'X-BAPI-SIGN: XXXXX' \
    --header 'X-BAPI-API-KEY: {api key}' \
    --header 'X-BAPI-TIMESTAMP: 1659346886605' \
    --header 'X-BAPI-RECV-WINDOW: 5000'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "balances": [
                {
                    "coin": "BTC",
                    "coinId": "BTC",
                    "total": "0.20378018343",
                    "free": "0.20378018343",
                    "locked": "0"
                },
                {
                    "coin": "BTC3L",
                    "coinId": "BTC3L",
                    "total": "743.03560386",
                    "free": "743.03560386",
                    "locked": "0"
                },
                {
                    "coin": "BTC3S",
                    "coinId": "BTC3S",
                    "total": "0.999",
                    "free": "0.999",
                    "locked": "0"
                }
            ]
        },
        "retExtMap": {},
        "retExtInfo": {},
        "time": 1659346887407
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-private/execution.html b/zh-TW/spot/ws-private/execution.html index 41c12c98b3..edf38616b3 100644 --- a/zh-TW/spot/ws-private/execution.html +++ b/zh-TW/spot/ws-private/execution.html @@ -4,13 +4,13 @@ 個人成交 | Bybit API Documentation - +

    個人成交

    該訂閱推送成交信息

    推送頻率: 實時

    Topic: ticketInfo

    響應參數​

    參數類型說明
    topicstringTopic名
    tsstring消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > estring事件類型
    > Estring事件時間戳
    > sstring交易對
    > qstring成交數量 (毫秒)
    > tstring成交時間戳 (毫秒)
    > pstring成交價格
    > Tstring成交ID
    > ostring訂單ID
    > cstring用戶自定義訂單ID
    > Ostring交易對手的訂單ID
    > astring帳戶ID
    > Astring撮合帳戶ID
    > mboolean是否為Maker. true: maker, false: taker
    > Sstring訂單方向. BUY, SELL
    > bstringParadigm大宗交易ID

    訂閱示例​

    {
        "req_id": "ticketInfo_1", //optional
        "op": "subscribe",
        "args": [
            "ticketInfo"
        ]
    }

    推送示例​

    {
        "type": "snapshot",
        "topic": "ticketInfo",
        "ts": "1662348310388",
        "data": [
            {
                "e": "ticketInfo",
                "E": "1662348310386",
                "s": "BTCUSDT",
                "q": "0.001007",
                "t": "1662348310373",
                "p": "19842.02",
                "T": "2100000000002220938",
                "o": "1238261807653647872",
                "c": "spotx008",
                "O": "1238225004531834368",
                "a": "533287",
                "A": "642908",
                "m": false,
                "S": "BUY",
                "b": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-private/order.html b/zh-TW/spot/ws-private/order.html index 880da2b4de..0d8315262e 100644 --- a/zh-TW/spot/ws-private/order.html +++ b/zh-TW/spot/ws-private/order.html @@ -4,13 +4,13 @@ 訂單 | Bybit API Documentation - +

    訂單

    該訂閱用於推送訂單信息，其中 成交均價 = Z / z

    推送頻率: 實時

    Topic: order

    響應參數​

    參數類型說明
    topicstringTopic名
    tsstring消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > estring事件類型
    > Estring事件時間戳
    > sstring交易對
    > cstringU用戶自定義訂單ID
    > Sstring訂單方向. BUY, SELL
    > ostring訂單類型. LIMIT, MARKET_OF_QUOTE(市價買), MARKET_OF_BASE(市價賣)
    > fstring執行策略
    > qstring訂單數量
    > pstring訂單價格
    > Xstring訂單狀態
    > istring訂單ID
    > Mstring交易對手的訂單ID
    > lstring最近成交數量
    > zstring累計成交數量
    > Lstring最近成交價格
    > nstring最近一次成交的手續費
  • 在升級到統一帳戶後, 您可以使用V5 成交頻道中的execFee字段來獲取每次成交的手續費
    • > Nstring手續費幣種
    > ubooleantrue: 普通單, false: 自成交
    > wboolean是否生效. false: 未生效, true: 已生效
    > mboolean是否是LIMIT_MAKER單
    > Ostring訂單創建時間 (毫秒)
    > Zstring累計成交數額
    > Astring撮合賬戶id
    > Cboolean是否關閉
    > vstring槓桿倍數
    > dstringNO_LIQ: 非強平單. IOC: 強平單
    > tstring成交ID
    > bstringParadigm大宗交易ID
    > ctstring取消類型. CancelBySmp
    > ststringSMP執行類型
    > sginteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    > sostring觸發此SMP執行的交易對手的 orderID

    訂閱示例​

    {
        "req_id": "order_1", //optional
        "op": "subscribe",
        "args": [
            "order"
        ]
    }

    推送示例​

    {
        "type": "snapshot",
        "topic": "order",
        "ts": "1662348310441",
        "data": [
            {
                "e": "order",
                "E": "1662348310441",
                "s": "BTCUSDT",
                "c": "spotx008",
                "S": "BUY",
                "o": "MARKET_OF_QUOTE",
                "f": "GTC",
                "q": "20",
                "p": "0",
                "X": "CANCELED",
                "i": "1238261807653647872",
                "M": "1238225004531834368",
                "l": "0.001007",
                "z": "0.001007",
                "L": "19842.02",
                "n": "0",
                "N": "BTC",
                "u": true,
                "w": true,
                "m": false,
                "O": "1662348310368",
                "Z": "19.98091414",
                "A": "0",
                "C": false,
                "v": "0",
                "d": "NO_LIQ",
                "t": "2100000000002220938",
                "sg": 1005,
                "st": "CancelTaker",
                "ct": "CancelBySmp",
                "so": "1400584538658193920",
                "b": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-private/stop-order.html b/zh-TW/spot/ws-private/stop-order.html index 47c1e01c7c..982f82db66 100644 --- a/zh-TW/spot/ws-private/stop-order.html +++ b/zh-TW/spot/ws-private/stop-order.html @@ -4,13 +4,13 @@ 止盈止損訂單 | Bybit API Documentation - +

    止盈止損訂單

    該訂閱推送web/app下的條件和止盈止損訂單信息, 或者是openAPI下的止盈止損訂單信息推送。只要訂單狀態發生改變，就會推送消息。

    推送頻率: 實時

    Topic: stopOrder

    響應參數​

    參數類型說明
    topicstringTopic名
    tsstring消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > estring事件類型
    > Estring事件時間戳
    > sstring交易對
    > cstringU用戶自定義訂單ID
    > Sstring訂單方向. BUY, SELL
    > ostring訂單類型. LIMIT, MARKET_OF_QUOTE(市價買), MARKET_OF_BASE(市價賣)
    > fstring執行策略
    > qstring訂單數量
    > pstring訂單價格
    > Xstring止盈止損單訂單狀態
    > istring訂單ID
    > Tstring訂單創建時間戳 (毫秒)
    > tstring訂單觸發時間戳 (毫秒). 僅訂單狀態是ORDER_FILLED或者ORDER_FAILED才有值
    > Cstring訂單更新時間戳 (毫秒). 每當訂單狀態發生變更時，會更新該時間
    > qpstring下單時的行情價格
    > eostring止盈止損訂單被觸發後轉化為普通訂單後的訂單ID
    > tistring與業務無關，請忽略
    > sistring與業務無關，請忽略
    > tpstring觸發價格

    訂閱示例​

    {
        "req_id": "stopOrder_1", //optional
        "op": "subscribe",
        "args": [
            "stopOrder"
        ]
    }

    推送示例​

    {
        "type": "snapshot",
        "topic": "stopOrder",
        "ts": "1678689442476",
        "data": [
            {
                "e": "stopOrder",
                "E": "1678689442476",
                "s": "XRPUSDT",
                "c": "1678689442086",
                "S": "BUY",
                "o": "LIMIT",
                "f": "GTC",
                "q": "100",
                "p": "0.335",
                "X": "ORDER_NEW",
                "i": "1375341158856660992",
                "T": "1678689442437",
                "t": "0",
                "C": "1678689442437",
                "qp": "0.3666",
                "eo": "1375341158856660993",
                "ti": "209a1cc923e1322315805fea6ed6fcbf",
                "si": "d980d5212ea83c87",
                "tp": "0.33"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-private/wallet.html b/zh-TW/spot/ws-private/wallet.html index 3e1189572a..5249110fe2 100644 --- a/zh-TW/spot/ws-private/wallet.html +++ b/zh-TW/spot/ws-private/wallet.html @@ -4,13 +4,13 @@ 錢包 | Bybit API Documentation - +

    錢包

    該訂閱用於推送現貨錢包信息

    推送頻率: 實時

    Topic: outboundAccountInfo

    響應參數​

    參數類型說明
    topicstringTopic名
    tsstring消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > estring事件類型
    > Estring時間戳 (毫秒)
    > Tboolean允許交易
    > Wboolean允許提現
    > Dboolean允許充值
    > Barray錢包資產變化數組
    >> astring幣種
    >> fstring可用餘額
    >> lstring委託單預佔用金額

    訂閱示例​

    {
        "req_id": "acctInfo_1", //optional
        "op": "subscribe",
        "args": [
            "outboundAccountInfo"
        ]
    }

    推送示例​

    {
        "type": "snapshot",
        "topic": "outboundAccountInfo",
        "ts": "1662107217641",
        "data": [
            {
                "e": "outboundAccountInfo",
                "E": "1662107217640",
                "T": true,
                "W": true,
                "D": true,
                "B": [
                    {
                        "a": "USDT",
                        "f": "176.81254174",
                        "l": "201.575"
                    }
                ]
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-public/bookticker.html b/zh-TW/spot/ws-public/bookticker.html index 0527477428..669bfb7612 100644 --- a/zh-TW/spot/ws-public/bookticker.html +++ b/zh-TW/spot/ws-public/bookticker.html @@ -4,13 +4,13 @@ 買一賣一 | Bybit API Documentation - +

    買一賣一

    最優買一賣一價

    推送频率: 100ms

    Topic: bookticker.{symbol}

    響應參數​

    參數類型說明
    topicstringTopic名
    tsnumber消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > sstring交易對
    > bpstring買一價
    > bqstring買一價數量
    > apstring賣一價
    > aqstring賣一價數量
    > tnumber系統生成該數據的時間戳 (毫秒)

    訂閱示例​

    {
        "req_id": "bookticker00001", //optional
        "op": "subscribe",
        "args": [
            "bookticker.BTCUSDT"
        ]
    }

    推送示例​

    {
        "topic": "bookticker.BTCUSDT",
        "ts": 1673437259336,
        "type": "snapshot",
        "data": {
            "s": "BTCUSDT",
            "bp": "17440",
            "bq": "0.0002",
            "ap": "17440.01",
            "aq": "0.21302",
            "t": 1673437259336
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-public/kline.html b/zh-TW/spot/ws-public/kline.html index dc9de7abef..efdf230ee8 100644 --- a/zh-TW/spot/ws-public/kline.html +++ b/zh-TW/spot/ws-public/kline.html @@ -4,13 +4,13 @@ K線 | Bybit API Documentation - +

    K線

    訂閱K線數據推送, 請在這裡查閱期望訂閱的粒度

    Topic: kline.{interval}.{symbol} e.g., kline.30m.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    tsnumber消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > tnumber蠟燭開始時間戳 (毫秒)
    > sstring交易對
    > cstring收盤價
    > hstring最高價格
    > lstring最低價格
    > ostring開盤價格
    > vstring交易量

    訂閱示例​

    {
        "req_id": "kline00001", //optional
        "op": "subscribe",
        "args": [
            "kline.30m.BTCUSDT"
        ]
    }

    推送示例​

    {
        "type": "snapshot",
        "topic": "kline.30m.BTCUSDT",
        "data": {
            "s": "BTCUSDT",
            "t": 1673436600000,
            "o": "17439.16",
            "c": "17437.82",
            "h": "17450.45",
            "l": "17433.5",
            "v": "34.059614"
        },
        "ts": 1673438143609
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-public/orderbook.html b/zh-TW/spot/ws-public/orderbook.html index cf2a76fbe0..381c586cf4 100644 --- a/zh-TW/spot/ws-public/orderbook.html +++ b/zh-TW/spot/ws-public/orderbook.html @@ -4,13 +4,13 @@ 深度 | Bybit API Documentation - +

    深度

    交易對的深度信息:

    • 訂單簿快照頻率深度: bids 和 asks 各40
    • 訂單簿版本變更觸發事件:
      • 訂單進入訂單簿
      • 訂單離開訂單簿
      • 訂單數量變更
      • 訂單已完成

    僅推送快照數據

    推送頻率: 100ms

    Topic: orderbook.40.{symbol}

    響應參數​

    參數類型說明
    topicstringTopic名
    tsnumber消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > tnumber系統生成該數據的時間戳 (毫秒)
    > sstring交易對
    > barrayBid, 買方. 按照價格從大到小
    >> b[0]string買方報價
    >> b[1]string買方數量
    > aarrayAsk, 賣方. 按照價格從小到大
    >> a[0]string賣方報價
    >> a[1]string賣方數量

    訂閱示例​

    {
        "req_id": "depth00001", //optional
        "op": "subscribe",
        "args": [
            "orderbook.40.BTCUSDT"
        ]
    }

    推送示例​

    {
        "topic": "orderbook.40.BTCUSDT",
        "ts": 1673439424737,
        "type": "snapshot",
        "data": {
            "s": "BTCUSDT",
            "t": 1673439424737,
            "b": [
                [
                    "17423",
                    "0.809534"
                ],
                [
                    "17422.86",
                    "0.043596"
                ],
                ...
            ],
            "a": [
                ...
                [
                    "17428.28",
                    "0.004811"
                ],
                [
                    "17428.62",
                    "0.23"
                ]
            ]
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-public/public-trade.html b/zh-TW/spot/ws-public/public-trade.html index 96189abddb..50bd4c2997 100644 --- a/zh-TW/spot/ws-public/public-trade.html +++ b/zh-TW/spot/ws-public/public-trade.html @@ -4,13 +4,13 @@ 平臺成交 | Bybit API Documentation - +

    平臺成交

    逐筆交易推送每一筆成交的信息。成交，或者說交易的定義是僅有一個吃單者與一個掛單者相互交易。

    變量「v」可以理解成一個交易ID。這個變量是全局遞增的並且獨特的。例如：假設過去5秒有3筆交易發生，分別是ETHUSDT、BTCUSDT、BHTBTC。它們的「v」會為連續的值（112，113，114）。

    推送頻率: 實時

    Topic: trade.{symbol}

    參數類型說明
    topicstringTopic名
    tsnumber消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > vstring成交ID
    > tnumber撮合引擎撮合时间戳 (毫秒)
    > pstring成交價格
    > qstring成交數量
    > mbooleantrue: 買方吃單, false: 賣方吃單
    > typestring交易類型標識. 0：幣幣成交. 1：Paradigm 大宗交易

    訂閱示例​

    {
        "req_id": "trade0001", //optional
        "op": "subscribe",
        "args": [
            "trade.BTCUSDT"
        ]
    }

    推送示例​

    {
        "topic": "trade.BTCUSDT",
        "ts": 1673437259397,
        "type": "snapshot",
        "data": {
            "v": "2290000000036455162",
            "t": 1673437259395,
            "p": "17440",
            "q": "0.0002",
            "m": false,
            "type": "0"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws-public/ticker.html b/zh-TW/spot/ws-public/ticker.html index c69057b9c8..52c37f1287 100644 --- a/zh-TW/spot/ws-public/ticker.html +++ b/zh-TW/spot/ws-public/ticker.html @@ -4,13 +4,13 @@ 行情 | Bybit API Documentation - +

    行情

    交易對的24小時統計數據

    推送頻率: 實時

    Topic: tickers.{symbol}

    響應參數​

    參數類型說明
    topicstringTopic名
    tsnumber消息被推送出來的時間戳 (毫秒)
    typestring數據類型. snapshot
    dataarrayObject
    > tnumber系統生成該數據的時間戳 (毫秒)
    > sstring交易對
    > ostring開盤價格
    > hstring最高價格
    > lstring最低價格
    > cstring收盤價格
    > vstring成交量
    > qvstring成交金額
    > mstring漲幅
    > xpstringUSD指數價格，可以為空

    訂閱示例​

    {
        "req_id": "ticker00001", //optional
        "op": "subscribe",
        "args": [
            "tickers.BTCUSDT"
        ]
    }

    推送示例​

    {
        "topic": "tickers.BTCUSDT",
        "ts": 1673853966002,
        "type": "snapshot",
        "data": {
            "t": 1673853957769,
            "s": "BTCUSDT",
            "c": "21097.53",
            "h": "21426.99",
            "l": "20575",
            "o": "20705.31",
            "v": "6786.96571",
            "qv": "142076886.7193882",
            "m": "0.0189",
            "xp": "21109.48012482"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/spot/ws/connect.html b/zh-TW/spot/ws/connect.html index 5dae4f09d0..c8bb22d632 100644 --- a/zh-TW/spot/ws/connect.html +++ b/zh-TW/spot/ws/connect.html @@ -4,14 +4,14 @@ 訂閱WebSocket | Bybit API Documentation - +

    訂閱WebSocket

    信息

    以下WSS地址僅適用現貨. 要想接收期貨的推送，請前往:

    訂閱地址:
    測試網:

    • 公有頻道: wss://stream-testnet.bybit.com/spot/public/v3
    • 私有頻道: wss://stream-testnet.bybit.com/spot/private/v3

    主網:

    • 公有頻道: wss://stream.bybit.com/spot/public/v3
    • 私有頻道: wss://stream.bybit.com/spot/private/v3
    信息

    公有頻道不需要鑒權. 以下內容僅適用於私有頻道的訂閱

    構建連接時，創建鑒權請求。

    注意: 如果您正在使用pybit, bybit-api或者其他第三方庫, 您可以忽略此項-因為鑒權已經內建。

    {
        "req_id": "10001", // 可選
        "op": "auth",
        "args": [
            "api_key",
            1662350400000, //過期時間應當大於當前時間戳
            "singature"
        ]
    }
    # 基於: https://github.com/bybit-exchange/pybit/blob/master/pybit/_http_manager.py

    import hmac
    import json
    import time
    import websocket

    api_key = ""
    api_secret = ""

    # 生成expires
    expires = int((time.time() + 1) * 1000)

    # 生成簽名
    signature = str(hmac.new(
        bytes(api_secret, "utf-8"),
        bytes(f"GET/realtime{expires}", "utf-8"), digestmod="sha256"
    ).hexdigest())

    ws = websocket.WebSocketApp(
        url=url,
        ...
    )

    # 發送鑒權請求
    ws.send(
        json.dumps({
            "op": "auth",
            "args": [api_key, expires, signature]
        })
    )

    鑒權成功的響應示例

    {
        "success": true,
        "ret_msg": "",
        "conn_id": "06a3cbfffe5df9cb-0000000e-00026965-fe306ee9ec20f544-4ab7116c",
        "req_id": "",
        "op": "auth"
    }
    信息

    簽名生成的示例可以參考這裡。

    警告

    由於網絡的複雜性，您可能隨時遇到斷連。請參考以下建議確保您能即時接收到推送：

    1. 通過發送心跳
    2. 遇到斷連時，立即重新連接

    IP限頻​

    • 不要嘗試頻繁地構建連接與斷開連接；
    • 不要在5分鐘內構建超過500個連接。

    如何發送心跳​

    發送ping的示例

    // req_id是可選參數
    ws.send(JSON.stringify({"req_id": "100001", "op": "ping"}));

    接收到pong的響應示例

    // 有req_id
    {
        "op": "pong",
        "args": [
            1661741630642
        ],
        "req_id": "100001",
        "conn_id": "706b870c"
    }

    // 沒有req_id
    {
        "op": "pong",
        "args": [
            1661741654529
        ],
        "conn_id": "706b870c"
    }
    警告

    為了維持連接，我們推薦您每20秒發送一次心跳。

    頻率限制​

    僅限私有頻道：

    • 每個api_key最多可以保持100個websocket私有連接，超過100個連接後的新連接會被服務器拒絕。
    • 單個IP同時最多50個websocket私有topic鏈接

    如何訂閱topic​

    理解Websocket裡的args​

    通過傳入args來訂閱指定topic

    // 訂閱trade下的BTCUSDT
    {
        "req_id": "10001", // 可選
        "op": "subscribe",
        "args": [
            "trade.BTCUSDT"
        ]
    }

    通過","來訂閱同一個topic下的多個交易對

    {
        "req_id": "10001", // 可選
        "op": "subscribe",
        "args": [
            "trade.BTCUSDT",
            "trade.ETHUSDT"
        ]
    }

    訂閱多個topic

    ws.send('{"req_id": "10001", "op": "subscribe", "args": ["trade.BTCUSDT", "trade.ETHUSDT", "tickers.BTCUSDT", "bookticker.BTCUSDT"]}')
    提示

    每次向單一連接僅能發送不超過10個參數的訂閱請求，但單個公有連接沒有args訂閱限制

    理解如何取消訂閱​

    您可以通過發送請求來動態地停止訂閱

    ws.send('{"req_id": "10002", "op": "unsubscribe", "args": ["trade.BTCUSDT"]}');
    // 示例: 取消訂閱BTCUSDT和ETHUSDT
    {
        "req_id": "10002", // 可選
        "op": "unsubscribe",
        "args": [
            "trade.BTCUSDT",
            "trade.ETHUSDT"
        ]
    }
    // 取消訂閱的響應
    {
        "op": "unsubscribe",
        "success": true,
        "req_id": "10002",
        "ret_msg": "unsubscribe",
        "conn_id": "46f097b7"
    }

    理解訂閱的響應​

    訂閱成功後的響應示例

    // 公共頻道的響應
    {
        "op": "subscribe",
        "success": true,
        "req_id": "10001",
        "ret_msg": "subscribe",
        "conn_id": "46f097b7"
    }
    // 私有頻道的響應
    {
        "success": true,
        "ret_msg": "",
        "conn_id": "06a3cbfffe5df9cb-0000000e-00026965-fe306ee9ec20f544-4ab7116c",
        "req_id": "private0001",
        "op": "subscribe"
    }

    訂閱成功後，您將收到結果信息。可以根據響應判斷訂閱是否成功。

    - + \ No newline at end of file diff --git a/zh-TW/tax/data-export.html b/zh-TW/tax/data-export.html index 73976971f9..74dca013fe 100644 --- a/zh-TW/tax/data-export.html +++ b/zh-TW/tax/data-export.html @@ -4,13 +4,13 @@ 數據導出 | Bybit API Documentation - +

    數據導出

    HTTP 請求​

    POST /fht/compliance/tax/v3/private/url

    請求參數​

    參數是否必需類型說明
    queryIdtruestring報告請求 ID

    響應參數​

    參數類型說明
    urlstring文件的URL網址 (Basepath+Files)。為了縮短生成報告所需的時間，它可以生成多個文件。請注意這一點，並在請求數據導出時使用相同的基本路徑組合多個文件
    信息

    使用python將S3文件轉換為 CSV的示例

    Python腳本​


    import pandas as pd
    import os

    class Bases(object):
        @staticmethod
        def path_list(path):
            """
            :param path:
            :return: list of file paths
            """
            file_list = []
            if os.path.isdir(path):
                print("it's a directory")
                for root, dirs, files in os.walk(path):
                    for f in files:
                        file = os.path.join(root, f)
                        file_list.append(file)
                return file_list
            elif os.path.isfile(path):
                print("it's a normal file")
                return [path]

    class pd_service(Bases):
        def get_data(self, file_path):
            """
            Read s3 files, merge forms
            :param file_path:
            :return:
            """
            df_all = pd.DataFrame()
            for paths in self.path_list(path=file_path):
                df_all = pd.concat([df_all, pd.read_orc(paths)], axis=0)
            print('Row number of tables：', df_all[df_all.columns[1]].count())
            print(df_all.columns.values)
            df_all.sort_values("TradeTime", inplace=True)
            df_all.to_csv("test_data_s3.csv", header=True, index=False)
            print(df_all)
            return df_all

    if __name__ == '__main__':
        # file path
        path = 'XXXX'
        test = pd_service()
        test.get_data(file_path=path)

    請求示例​

    POST /fht/compliance/tax/v3/private/url HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: xxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671184057480
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {"queryId":"12312312415325325"}

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "url": "{\"Files\":[\"20221216/adfsf34234-8e87-4c72-bc70-dsa234234daf/_SUCCESS\",\"20221216/dafasdf34243-8e87-4c72-bc70-dafsd34234/part-00000-adfsd34-00bd-4fe9-9591-adfasr343-c000\"],\"Basepath\":\"https://prod-bybit-tax-api-1705-rz.s3.ap-southeast-1.amazonaws.com/\"}"
        },
        "retExtInfo": {},
        "time": 1671184057646
    }
    - + \ No newline at end of file diff --git a/zh-TW/tax/enum.html b/zh-TW/tax/enum.html index 3a1433f2a1..e18f036870 100644 --- a/zh-TW/tax/enum.html +++ b/zh-TW/tax/enum.html @@ -4,13 +4,13 @@ 枚舉定義 | Bybit API Documentation - +

    枚舉定義

    ReportType​

    • TRADE - 交易歷史
    • P&L - 盈虧歷史
    • EARN - 賺取歷史
    • DEPOSIT&WITHDRAWAL - 充提歷史
    • BONUS - 體驗金歷史
    • AIRDROP - 空投歷史

    ReportNumber​

    ReportType = "TRADE"

    • 1 - 獲取現貨交易歷史
    • 2 - 獲取合約交易歷史
    • 3 - 獲取USDC交易歷史
    • 4 - 獲取NFT交易歷史

    ReportType = "P&L"

    • 1 - 獲取合約平倉盈虧歷史

    ReportType = "EARN"

    • 1 - 獲取Bybit儲蓄收益歷史
    • 2 - 獲取流動性挖礦流動性歷史
    • 3 - 獲取流動性挖礦收益歷史
    • 4 - 獲取流動性挖礦兌換歷史
    • 5 - 獲取雙幣資產兌換歷史
    • 6 - 獲取Defi挖礦收益歷史
    • 7 - 獲取Launchpool收益歷史
    • 8 - 獲取Sharkfin收益歷史

    ReportType = "DEPOSIT&WITHDRAWAL"

    • 1 - 獲取加密貨幣入金歷史
    • 2 - 獲取P2P充值歷史
    • 3 - 獲取法幣出入金歷史
    • 4 - 獲取快捷買幣交易歷史
    • 5 - 獲取第三方入金歷史
    • 6 - 獲取加密貨幣提幣歷史
    • 7 - 獲取NFT充提歷史

    ReportType = "BONUS"

    • 1 - 獲取優惠券歷史
    • 2 - 獲取贈金歷史

    ReportType = "AIRDROP"

    • 1 - 獲取空投歷史
    - + \ No newline at end of file diff --git a/zh-TW/tax/explain.html b/zh-TW/tax/explain.html index d58303db62..247f9be3b4 100644 --- a/zh-TW/tax/explain.html +++ b/zh-TW/tax/explain.html @@ -4,13 +4,13 @@ 數據說明 | Bybit API Documentation - +

    數據說明

    交易歷史​

    1. 現貨交易歷史​

    響應參數​

    參數類型說明
    OrderIDstring關閉訂單的訂單ID
    TradeIDstring平倉訂單的交易ID
    Symbolstring交易對名稱
    Sidestring買賣方向
    QuoteCoinstring報價幣種
    BaseCoinstring交易幣種
    ExecPricestring成交價格
    ExecValuestring成交價值
    TradingFeestring單次成交的手續費
    FeeTokenstring手續費幣種
    TradeTimestring成交時間戳 (毫秒)

    2. 合約交易歷史​

    響應參數​

    參數類型說明
    OrderIDstring關閉訂單的訂單ID
    TradeIDstring平倉訂單的交易ID
    ContractTypestring合約類型. 反向合約, 正向合約, 期貨
    Symbolstring交易對名稱
    Sidestring買賣方向
    QuoteCoinstring報價幣種
    BaseCoinstring交易幣種
    ExecPricestring成交價格
    ExecQtystring成交數量
    ExecTypestring成交類型. Trade, ADL, BustTrade
    ExecValuestring成交價值
    FeeRatestringMaker或Taker的手續費率
    FeeTokenstring手續費幣種
    TradingFeestring單次成交的手續費
    TradeTimestring成交時間戳 (毫秒)
    ClosedSizestring平倉數量
    OrderTypestring訂單類型

    3. 期權交易歷史​

    響應參數​

    參數類型說明
    OrderIDstring關閉訂單的訂單ID
    TradeIDstring平倉訂單的交易ID
    ContractTypestring合約類型
    Symbolstring交易對名稱
    Sidestring買賣方向
    QuoteCoinstring報價幣種
    BaseCoinstring交易幣種
    ExecPricestring成交價格
    ExecQtystring成交數量
    ExecTypestring成交類型
    ExecValuestring成交價值
    FeeRatestringMaker或Taker的手續費率
    FeeTokenstring手續費幣種
    TradingFeestring單次成交的手續費
    TradeTimestring成交時間戳 (毫秒)

    4. NFT交易歷史​

    響應參數​

    參數類型說明
    OrderIDstring關閉訂單的訂單ID
    Networkstring網絡名稱
    Sidestring買賣方向
    NftIdstringNFT集合ID
    ExecValuestring成交價值
    BaseCoinstring交易幣種
    PlatformFeestring平台費用，費用按照交易幣種計算
    ShareFeestring共享費用，費用按照交易幣種計算
    TradeTimestring成交時間戳 (毫秒)

    損益歷史​

    響應參數​

    參數類型說明
    OrderIDstring關閉訂單的訂單ID
    ContractTypestring合約類型. 反向合約, 正向合約, 期貨
    Symbolstring交易對名稱
    Sidestring買賣方向
    ClosedSizestring平倉大小
    CumEntryValuestring累計入場價值
    AvgEntryPricestring平均入場價格
    CumExitValuestring累計出場價值
    AvgExitPricestring平均出場價格
    SettleCoinstring結算幣種
    ClosedPNLstring平倉盈虧
    FillCountstring單筆訂單的成交次數
    TradeTimestring交易時間戳 (毫秒)

    賺取歷史​

    1. Bybit儲蓄收益歷史​

    響應參數​

    參數類型說明
    AssetStakedCoinstring用於抵押在Bybit儲蓄產品中的幣種
    StakingTypestring質押類型。靈活和固定期限
    AssetEarnedCoinstring發放利息的代幣
    EffectiveStakingAmountstring使用 Asset Staked 幣質押的總金額
    Yieldstring利息收入
    TradeTimestring交易時間戳 (毫秒)

    2. 流動性挖礦歷史​

    響應參數​

    參數類型說明
    OrderIDstring訂單ID
    Symbolstring交易對名稱
    OrderTypestring包括不同類型的流動性挖掘。添加、刪除、降低杠桿、再投資
    EntryPricestring入場價格
    Leveragestring槓桿倍數
    Slippagestring訂單價格與訂單實際執行時的價格差值
    Liquiditystring流動性=本金變化乘以槓桿
    TradeTimestring交易時間戳 (毫秒)

    3. 流動性挖礦收益歷史​

    響應參數​

    參數類型說明
    AssetEarnedCoinstring發放利息的代幣
    Yieldstring利息收入
    TradeTimestring交易時間戳 (毫秒)

    4. 流動性挖礦兌換歷史​

    響應參數​

    參數類型說明
    OrderIdstring訂單ID
    InitialCoinstring兌出幣種
    DepositAmountstring兌出金額
    SwapCoinstring兌入幣種
    SwapAmountstring兌入金額
    SwapFeeTokenstring兌換手續費幣種
    SwapFeestring兌換手續費
    Slippagestring訂單價格與訂單實際執行時的價格差值
    TradeTimestring交易時間戳 (毫秒)

    5. 雙幣投資兌換歷史​

    響應參數​

    參數類型說明
    OrderIdstring訂單ID
    InitialCoinstring兌出幣種
    DepositAmountstring兌出金額
    SwapCoinstring兌入幣種
    SwapAmountstring兌入金額
    OrderTimenumber訂單創建時間戳 (毫秒)
    TradeTimenumber交易時間戳 (毫秒)

    6. DeFi Mining收益歷史​

    響應參數​

    參數類型說明
    OrderIdstring訂單ID
    AssetStakedCoinstring用於抵押在Bybit儲蓄產品中的幣種
    Yieldstring利息收入
    OrderTimenumber訂單創建時間戳 (毫秒)
    TradeTimenumber交易時間戳 (毫秒)

    7. Launchpool收益歷史​

    響應參數​

    參數類型說明
    AssetEarnedCoinstring發放利息的代幣
    EffectiveStakingAmountstring使用 Asset Staked 幣質押的總金額
    Yieldstring利息收入
    TradeTimenumber交易時間戳 (毫秒)

    8. Sharkfin收益歷史​

    響應參數​

    參數類型說明
    AssetEarnedCoinstring發放利息的代幣
    Yieldstring利息收入
    TradeTimenumber交易時間戳 (毫秒)

    入金提幣歷史​

    1. 加密貨幣入金歷史​

    響應參數​

    參數類型說明
    Txidstring交易ID
    DepositTypestring入金類型. 鏈上入金
    ChainTypestring鏈名
    Symbolstring交易對名稱
    FinalAmountstring入金數量
    OrderTimenumber創建時間戳 (毫秒)
    CompletedTimenumber交易完成時間戳 (毫秒)

    2. P2P充值歷史​

    響應參數​

    參數類型說明
    OrderIDstringOrder ID
    OrderTypestring包括不同類型的流動性挖掘。添加、刪除、降低杠桿、再投資
    P2pSidestring對於 P2P 買家，這代表買家購買了相應的硬幣並使用法定貨幣。對於 P2P 賣家，這代表買家出售相應的硬幣並獲得法定貨幣作為回報
    Fiatstring法幣
    FiatAmountstring法幣金額
    Coinstring幣種
    CoinPricestring幣種價格
    CoinAmountstring幣種數量
    OrderTimenumber創建時間戳 (毫秒)
    CompletedTimenumber交易完成時間戳 (毫秒)

    3. 法幣出入金歷史​

    響應參數​

    參數類型說明
    OrderIDstring訂單ID
    Typestring類型. DEPOSIT, WITHDRAW
    Fiatstring法幣
    DepositAmountstring入金數量
    FinalAmountstring加密貨幣數量
    Feestring手續費
    PaymentMethodsstring支付方式
    OrderTimenumber創建時間戳 (毫秒)
    CompletedTimenumber交易完成時間戳 (毫秒)

    4. 快捷買幣交易歷史​

    響應參數​

    參數類型說明
    OrderIDstring訂單ID
    Sidestring交易方向
    Fiatstring法幣
    DepositAmountstring法幣入金數量
    DestinationCoinstring目標幣種
    CoinPricestring目標幣種價格
    FinalAmountstring獲得目標幣種數量
    Feestring手續費
    OrderTimenumber創建時間戳 (毫秒)
    CompletedTimenumber交易完成時間戳 (毫秒)

    5. 第三方入金歷史​

    響應參數​

    參數類型說明
    OrderIDstring訂單ID
    Txidstring交易ID
    Platformstring支付方式
    Fiatstring法幣
    DepositAmountstring法幣入金數量
    DestinationCoinstring目標幣種
    CoinPricestring目標幣種價格
    FinalAmountstring獲得目標幣種數量
    OrderTimenumber創建時間戳 (毫秒)
    CompletedTimenumber交易完成時間戳 (毫秒)

    6. 加密貨幣提幣歷史​

    響應參數​

    參數類型說明
    Txidstring交易ID
    ChainTypestring鏈名
    Coinstring幣種
    FinalAmountstring出金數量
    Feestring提幣手續費
    OrderTimenumber創建時間戳 (毫秒)
    CompletedTimenumber交易完成時間戳 (毫秒)

    7. NFT充提歷史​

    響應參數​

    參數類型說明
    OrderIdstring訂單ID
    TxHashstringNFT交易的哈希ID
    TokenIdstringNFT的tokenID
    TransferTypestring類型. 轉入或轉出
    Networkstring網絡
    FeeTokenstring手續費幣種
    Feestring手續費
    OrderTimenumber創建時間戳 (毫秒)
    CompletedTimenumber交易完成時間戳 (毫秒)

    贈金歷史​

    提示
  • 贈金 - 體驗贈金直接支付到用戶資產賬戶，可用於開倉抵扣手續費和資金費率費用。顯示的所有獎金都已被用戶應用。
  • 優惠券 - 優惠券可抵扣的款項將僅用於抵消手續費。不會添加到用戶的資產賬戶中。扣除後將返還至用戶資產賬戶。 顯示的所有優惠券都已被用戶應用。

    • 1. 優惠券歷史​

    響應參數​

    參數類型說明
    Coinstring優惠券的幣種
    FinalAmountstring代幣數量
    CompletedTimenumber交易完成時間戳 (毫秒)

    2. 贈金歷史​

    響應參數​

    參數類型說明
    Coinstring體驗金的幣種
    FinalAmountstring代幣數量
    CompletedTimenumber交易完成時間戳 (毫秒)

    空投歷史​

    響應參數​

    參數類型說明
    Coinstring空投幣種
    FinalAmountstring代幣數量
    TransferTypestring空投的類型. 空投充值、空投提現
    TransferDescriptionstring轉帳說明
    CompletedTimenumber交易完成時間戳 (毫秒)
    - + \ No newline at end of file diff --git a/zh-TW/tax/report.html b/zh-TW/tax/report.html index 38dfa60a13..d0345309fc 100644 --- a/zh-TW/tax/report.html +++ b/zh-TW/tax/report.html @@ -4,13 +4,13 @@ 創建導出報告請求 | Bybit API Documentation - +

    創建導出報告請求

    HTTP 請求​

    POST /fht/compliance/tax/v3/private/create

    請求參數​

    參數是否必需類型說明
    typetruestring報告類型
    numbertruestring不同類型下的類別號
    startTimetruestringUNIX 時間。這是以秒為單位。報告開始時間的時間戳。 StartTime 包含在數據導出的時間範圍內。
    endTimetruestringUNIX 時間。這是以秒為單位。報告結束時間的時間戳。 EndTime 不包含在數據導出的時間範圍內。請注意，對於每個請求，我們最多只允許從 StartTime 開始搜索 2 個月的時間範圍。

    響應參數​

    參數類型說明
    queryIdstring報告請求 ID

    請求示例​

    POST /fht/compliance/tax/v3/private/create HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: xxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671183681683
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {"startTime":"1667264621","endTime":"1669261057","type":"TRADE","number":"2"}

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "queryId": "12312312415325325"
        },
        "retExtInfo": {},
        "time": 1671183681990
    }
    - + \ No newline at end of file diff --git a/zh-TW/tax/status.html b/zh-TW/tax/status.html index 77b6d05b80..b1959116d2 100644 --- a/zh-TW/tax/status.html +++ b/zh-TW/tax/status.html @@ -4,13 +4,13 @@ 查詢報告導出狀態 | Bybit API Documentation - +

    查詢報告導出狀態

    HTTP 請求​

    POST /fht/compliance/tax/v3/private/status

    請求參數​

    參數是否必需類型說明
    queryIdtruestring報告請求 ID

    響應參數​

    參數類型說明
    statusstring
    • -1: 失敗
    • 0: 隊列中
    • 1: 處理中
    • 2: 處理完成
    • 3: 已過期

    請求示例​

    POST /fht/compliance/tax/v3/private/status HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: xxxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671183923110
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {"queryId":"12312312415325325"}

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "status": "2"
        },
        "retExtInfo": {},
        "time": 1671183923244
    }
    - + \ No newline at end of file diff --git a/zh-TW/tax/time.html b/zh-TW/tax/time.html index 498c4fe3e4..b920ec4b41 100644 --- a/zh-TW/tax/time.html +++ b/zh-TW/tax/time.html @@ -4,13 +4,13 @@ 查詢特定用戶在平台註冊日期 | Bybit API Documentation - +

    查詢特定用戶在平台註冊日期

    HTTP 請求​

    POST /fht/compliance/tax/v3/private/registertime

    請求參數​

    無

    響應參數​

    參數類型說明
    registerTimestring特定用戶在平台上註冊的日期 (秒級unix時間戳)

    請求示例​

    POST /fht/compliance/tax/v3/private/registertime HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: xxxxxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671183584043
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    {}

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "registerTime": "1634515200"
        },
        "retExtInfo": {},
        "time": 1671183584270
    }
    - + \ No newline at end of file diff --git a/zh-TW/v3/intro.html b/zh-TW/v3/intro.html index 8ab7dd46cc..f6decac9f6 100644 --- a/zh-TW/v3/intro.html +++ b/zh-TW/v3/intro.html @@ -4,7 +4,7 @@ 概覽 | Bybit API Documentation - + @@ -13,7 +13,7 @@ server_time - recv_window <= timestamp < server_time + 1000
    其中server_time是Bybit服務器時間，您可以通過Bybit服務器時間接口獲取.

    構建請求​

    提示

    為了幫助診斷高級網絡問題，您可以考慮將cdn-request-id添加到您的請求頭中。對於每個請求，它的值應該是唯一的。.

    信息
    簽名計算示例

    基本步驟:

    1. 時間戳 + api-key + [recv_window]+ [queryString(無需排序) | jsonBodyString]
    2. 使用HMAC_SHA256或者RSA_SHA256算法對第1步中拼接的string簽名，並轉換為16進製字符串(HMAC_SHA256) / Base64編碼 (RSA_SHA256)，得出sign參數。
    3. 添加生成的簽名到HTTP頭當中 注意: GET和POST請求的加密明文是不相同，請參考以下示例.

    對明文加密的示例

    # 拼接規則:
    timestamp+api_key+recv_window+queryString

    # 明文
    "1658384314791XXXXXXXXXX5000category=option&symbol=BTC-29JUL22-25000-C"

    # 解析
    timestamp = "1658384314791"
    api_key = "XXXXXXXXXX"
    recv_window = "5000"
    queryString = "category=option&symbol=BTC-29JUL22-25000-C"

    http請求示例

    GET /unified/v3/private/order/list?category=option&symbol=BTC-29JUL22-25000-C HTTP/1.1
    Host: api-testnet.bybit.com
    -H 'X-BAPI-SIGN: XXXXXXXXXX' \
    -H 'X-BAPI-API-KEY: XXXXXXXXXX' \
    -H 'X-BAPI-TIMESTAMP: 1658384431891' \
    -H 'X-BAPI-RECV-WINDOW: 5000'

    外層通用數據結構​

    衍生品​

    參數類型說明
    retCodenumber成功/錯誤碼
    retMsgstring成功/錯誤消息. 成功消息可以是OK,success,SUCCESS
    resultObject業務數據體
    retExtInfoObject額外信息. 大部分場景下都是{}
    timenumber當前時間戳 (毫秒)
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017382656
    }

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017473888
    }

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017572923
    }

    現貨​

    參數類型說明
    retCodenumber成功/錯誤碼
    retMsgstring成功/錯誤消息. 成功消息可以是OK,success,SUCCESS
    resultObject業務數據體
    retExtInfoObject額外信息. 大部分場景下都是{}
    timenumber當前時間戳 (毫秒)
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017382656
    }

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017473888
    }

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017572923
    }

    帳戶資產​

    參數類型說明
    retCodenumber成功/錯誤碼
    retMsgstring成功/錯誤消息. 成功消息可以是OK,success,SUCCESS
    resultObject業務數據體
    retExtInfoObject額外信息. 大部分場景下都是{}
    timenumber當前時間戳 (毫秒)
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017382656
    }

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017473888
    }

    {
        "retCode": 0,
        "retMsg": "Success",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017572923
    }
    - + \ No newline at end of file diff --git a/zh-TW/v3/server-time.html b/zh-TW/v3/server-time.html index 2c1ad3e3ed..d6b0681397 100644 --- a/zh-TW/v3/server-time.html +++ b/zh-TW/v3/server-time.html @@ -4,13 +4,13 @@ Bybit服務器時間 | Bybit API Documentation - +

    Bybit服務器時間

    獲取Bybit服務器時間

    HTTP 請求​

    GET /v3/public/time

    請求參數​

    無

    響應參數​

    參數類型說明
    timeSecondstringBybit服務器時間戳 (秒)
    timeNanostringBybit 服務器時間戳 (微秒)

    請求示例​

    curl https://api-testnet.bybit.com/v3/public/time

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "timeSecond": "1674026082",
            "timeNano": "1674026082947745743"
        },
        "retExtInfo": {},
        "time": 1674026082947
    }
    - + \ No newline at end of file diff --git a/zh-TW/v3/smp.html b/zh-TW/v3/smp.html index b2eaa762a4..6541b7623d 100644 --- a/zh-TW/v3/smp.html +++ b/zh-TW/v3/smp.html @@ -4,7 +4,7 @@ 自成交攔截 | Bybit API Documentation - + @@ -13,7 +13,7 @@ 基於這點，我們強烈建議在SMP交易群組發生變更時，最好取消所有現有訂單，以避免意外執行。

    1. SMP交易群組在SMP執行中具有較高優先級，當任何一方沒有群組時，UID才會生效。

    示例：
    1月1日：UID1加入SMP交易群組A，並下訂單1；
    1月2日：UID1被從SMP交易群組A中移除，但訂單1仍然處於活躍狀態且為“新”狀態。

    • 情況1：如果UID1加入了SMP交易群組B並下了訂單2，如果訂單2與訂單1相符，它將被執行，因為它們屬於兩個不同的群組。
    • 情況2：如果UID1在被從SMP交易群組A中移除後沒有加入任何其他群組並下了訂單2，如果訂單2與訂單1相符，SMP將被觸發，因為UID1在下訂單2時沒有群組，所以SMP在UID級別（同一個UID1）被觸發。

    如何管理我的UID及SMP交易群組?​

    您可以聯繫您的機構業務經理或通過電子郵件聯繫Bybit，電子郵件地址為: institutional_services@bybit.com

    支持的OpenAPI版本和產品線​

    產品線支持的OpenAPI版本說明
    現貨V3 (普通帳戶)
    V5 (統一帳戶&普通帳戶)
    合約合約V3 (普通帳戶): USDT永續 / 反向永續&交割
    V5 (統一帳戶): USDT永續 / 反向永續&交割 / USDC永續 & 交割
    V5 (普通帳戶): USDT永續 / 反向永續 & 交割
    期權V5 (統一帳戶)V1有基於UID維度的SMP功能
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/account-info.html b/zh-TW/v5/abandon/account-info.html index 191178c555..e10e4801aa 100644 --- a/zh-TW/v5/abandon/account-info.html +++ b/zh-TW/v5/abandon/account-info.html @@ -4,13 +4,13 @@ 查詢余幣寶帳戶信息 | Bybit API Documentation - +

    查詢余幣寶帳戶信息

    HTTP 請求​

    GET /v5/lending/account

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱

    響應參數​

    參數類型說明
    coinstring幣種名稱
    principalIntereststring可贖回收益
    principalQtystring可贖回本金金額, 計算公式: min(用戶剩餘本金, 用戶當日可贖回額度)
    principalTotalstring可贖回總計
    quantitystring當前存入本金

    請求示例​

    GET /v5/lending/account?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682049556563
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "coin": "BTC",
            "principalInterest": "0",
            "principalQty": "1",
            "principalTotal": "1",
            "quantity": "1"
        },
        "retExtInfo": {},
        "time": 1682049706988
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/cancel-redeem.html b/zh-TW/v5/abandon/cancel-redeem.html index 7cd6c97cdb..cb55d5b061 100644 --- a/zh-TW/v5/abandon/cancel-redeem.html +++ b/zh-TW/v5/abandon/cancel-redeem.html @@ -4,13 +4,13 @@ 撤銷贖回 | Bybit API Documentation - +

    撤銷贖回

    HTTP 請求​

    POST /v5/lending/redeem-cancel

    請求參數​

    參數是否必需類型說明
    coinfalsestringCoin name
    orderIdfalsestringThe order ID of redemption
    serialNofalsestringSerial no. The customised ID of redemption

    響應參數​

    參數類型說明
    orderIdstringOrder ID
    serialNostringSerial No
    updatedTimestringUpdated timestamp (ms)

    請求示例​

    POST /v5/lending/redeem-cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682048277724
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "coin": "BTC",
        "orderId": "1403517113428086272",
        "serialNo": null
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1403517113428086272",
            "serialNo": "linear004",
            "updatedTime": "1682048277963"
        },
        "retExtInfo": {},
        "time": 1682048278001
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/coin-info.html b/zh-TW/v5/abandon/coin-info.html index 648aa44fa1..1d475e35fc 100644 --- a/zh-TW/v5/abandon/coin-info.html +++ b/zh-TW/v5/abandon/coin-info.html @@ -4,13 +4,13 @@ 查詢可存入幣種信息 | Bybit API Documentation - +

    查詢可存入幣種信息

    查詢可存入幣種的基本信息

    信息

    所有v5/lending的接口都需要現貨權限

    HTTP 請求​

    GET /v5/lending/info

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種名稱

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring幣種名稱
    > maxRedeemQtystring單用戶每天最大可贖回數量 (0 - 24 UTC)
    > minPurchaseQtystring單筆最小存入數量
    > precisionstring精度
    > ratestring年化利率. 比如: 返回0.0002 表示 0.02%
    > loanToPoolRatiostring資金使用率. e.g. 0.0004 means 0.04%
    > actualApystring實際年化利率

    請求示例​

    GET /v5/lending/info?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682045949295
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "actualApy": "0.003688421873941958",
                    "coin": "ETH",
                    "loanToPoolRatio": "0.16855491872747133044",
                    "maxRedeemQty": "161",
                    "minPurchaseQty": "0.03",
                    "precision": "8",
                    "rate": "0.003411300771389848"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1682045942972
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/deposit.html b/zh-TW/v5/abandon/deposit.html index dfc1d6058a..2192d6ff62 100644 --- a/zh-TW/v5/abandon/deposit.html +++ b/zh-TW/v5/abandon/deposit.html @@ -4,13 +4,13 @@ 存入資金 | Bybit API Documentation - +

    存入資金

    信息
    • 經典帳戶&UMA帳戶: 資金是從現貨錢包扣除
    • UTA帳戶: 資金是從統一交易錢包扣除

    HTTP 請求​

    POST /v5/lending/purchase

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱
    quantitytruestring存入數量
    serialNofalsestring序列號，即自定義ID. 若不傳入，則系統自建

    響應參數​

    參數類型說明
    coinstring幣種名稱
    createdTimestring創建時間戳 (毫秒)
    orderIdstring訂單ID
    quantitystring存入數量
    serialNostring序列號
    statusstring訂單狀態. 0: 初始, 1: 處理中, 2: 成功, 10: 失敗
    updatedTimestring更新時間戳 (毫秒)

    請求示例​

    POST /v5/lending/purchase HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682046368938
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "coin": "USDC",
        "quantity": "20.00005",
        "serialNo": "test-00007"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "coin": "USDC",
            "createdTime": "1682046369112",
            "orderId": "1403501100816928256",
            "quantity": "20.00005",
            "serialNo": "test-00007",
            "status": "0",
            "updatedTime": "1682046369112"
        },
        "retExtInfo": {},
        "time": 1682046369120
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/earning.html b/zh-TW/v5/abandon/earning.html index ede6165241..b1765d05f7 100644 --- a/zh-TW/v5/abandon/earning.html +++ b/zh-TW/v5/abandon/earning.html @@ -4,13 +4,13 @@ 查詢經紀商返佣 | Bybit API Documentation - +

    查詢經紀商返佣

    危險

    該接口已經廢棄, 請使用查詢經紀商返佣信息

    信息
    • 使用經紀商的母帳戶進行查詢
    • 支持查詢過去6個月的數據
    • startTime & endTime兩個入参, 要麼同時輸入, 要麼都不輸入

    HTTP 請求​

    GET /v5/broker/earning-record

    請求參數​

    參數是否必需類型說明
    bizTypefalsestring業務類型. SPOT, DERIVATIVES, OPTIONS
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 1000
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > userIdstringuid
    > bizTypestring業務類型
    > symbolstring合約名稱
    > coinstring幣種名稱. 即earning的單位
    > earningstring佣金
    > orderIdstring訂單ID
    > execTimestring成交時間戳 (毫秒)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/broker/earning-record?bizType=SPOT&startTime=1686240000000&endTime=1686326400000&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686708862669
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "userId": "xxxx",
                    "bizType": "SPOT",
                    "symbol": "BTCUSDT",
                    "coin": "BTC",
                    "earning": "0.000015",
                    "orderId": "1531607271849858304",
                    "execTime": "1686306035957"
                }
            ],
            "nextPageCursor": "0%2C1"
        },
        "retExtInfo": {},
        "time": 1686708863283
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/enable-unitransfer-subuid.html b/zh-TW/v5/abandon/enable-unitransfer-subuid.html index 366446e584..b29bce2f86 100644 --- a/zh-TW/v5/abandon/enable-unitransfer-subuid.html +++ b/zh-TW/v5/abandon/enable-unitransfer-subuid.html @@ -4,13 +4,13 @@ 配置互相劃轉的子帳號 | Bybit API Documentation - +

    配置互相劃轉的子帳號

    信息

    無需再配置可劃轉的子帳號, 該限制已移除, 默認任意子帳號之間可以劃轉

    該接口用於配置開啟萬能劃轉的子帳號列表。沒有進行配置的子帳號是無法進行萬能劃轉的。

    提示

    萬能劃轉是允許您將資金直接從一個子帳號劃轉到另一個子帳號，同樣允許母子帳號間的劃轉。

    警告

    僅支持母帳號API key

    HTTP 請求​

    POST /v5/asset/transfer/save-transfer-sub-member

    請求參數​

    參數是否必需類型說明
    subMemberIdstruearray<string>子帳號. 支持輸入多個子帳號，用逗號隔開, 比如, "uid1,uid2,uid3"

    響應參數​

    無

    請求示例​

    POST /v5/asset/transfer/save-transfer-sub-member HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672147595971
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "subMemberIds": ["554117,592324,592334"]
    }

    Response Example​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {},
        "retExtInfo": {},
        "time": 1672147593188
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/ltv.html b/zh-TW/v5/abandon/ltv.html index 4ea23960aa..912ee1059c 100644 --- a/zh-TW/v5/abandon/ltv.html +++ b/zh-TW/v5/abandon/ltv.html @@ -4,13 +4,13 @@ 查詢風險率 | Bybit API Documentation - +

    查詢風險率

    HTTP 請求​

    GET /v5/ins-loan/ltv

    請求參數​

    無

    返回參數​

    參數類型說明
    ltvInfoarrayObject
    > ltvstring風險率
    > parentUidstring用戶ID
    > subAccountUidsarray綁定的子UID
    > unpaidAmountstring總負債 (USDT)
    > unpaidInfoarray負債明細
    >> tokenstring幣種
    >> unpaidQtystring未還本金
    >> unpaidIntereststring未還利息
    > balancestring總資產(保證金幣種資產折算為USDT資產). 可以參考這裡了解詳細計算
    > spotBalanceInfoarray現貨資產明細
    >> tokenstring現貨保證金幣種
    >> pricestring現貨保證金幣種價格
    >> qtystring現貨保證金數量
    > contractInfoarray合約資產明細
    >> tokenstring合約保證金幣種
    >> pricestring合約保證金幣種指數價格
    >> qtystring合約保證金幣種數量 (合約可用餘額，不參與LTV計算)

    請求示例​

    curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/margin-ltv' \
    --header 'X-BAPI-SIGN-TYPE: 2' \
    --header 'X-BAPI-API-KEY: XXXXXXXXXXX' \
    --header 'X-BAPI-TIMESTAMP: 1669367335035' \
    --header 'X-BAPI-RECV-WINDOW: 5000' \
    --header 'X-BAPI-SIGN: XXXXXXXX'

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "ltvInfo": [
                {
                    "ltv": "0.1147",
                    "parentUid": "999805",
                    "subAccountUids": [
                        "999805"
                    ],
                    "unpaidAmount": "",
                    "unpaidInfo": [
                        {
                            "token": "USDT",
                            "unpaidQty": "6351.49614274",
                            "unpaidInterest": "264.0137162"
                        }
                    ],
                    "balance": "57626.875915433333333332400000000",
                    "spotBalanceInfo": [
                        {
                            "token": "BTC",
                            "price": "16375.621333333333333332",
                            "qty": "0.2"
                        },
                        ....
                        {
                            "token": "XRP",
                            "price": "0.409517",
                            "qty": "10000"
                        }
                    ],
                    "contractInfo": [
                        {
                            "token": "USDT",
                            "price": "1",
                            "qty": "0"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669367335608
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/margin-coin-info.html b/zh-TW/v5/abandon/margin-coin-info.html index a3d357f692..08b6c714f5 100644 --- a/zh-TW/v5/abandon/margin-coin-info.html +++ b/zh-TW/v5/abandon/margin-coin-info.html @@ -4,13 +4,13 @@ 查詢保證金幣種信息 | Bybit API Documentation - +

    查詢保證金幣種信息

    提示

    這是公共接口，無需鑒權。

    HTTP 請求​

    GET /v5/ins-loan/ensure-tokens

    請求參數​

    參數是否必須類型說明
    productIdfalsestring產品ID. 若不傳，則返回所有產品的保證金幣種信息. 現貨返回折算率大於0的幣種.

    返回參數​

    參數類型說明
    marginTokenarrayObject
    > productIdstring產品ID
    > spotTokenarray現貨保證金幣種信息
    >> tokenstring保證金幣種
    >> convertRatiostring保證金幣種折算率
    > contractTokenarray合約保證金幣種信息
    >> tokenstring保證金幣種
    >> convertRatiostring保證金幣種折算率

    請求示例​

    GET /v5/ins-loan/ensure-tokens?productId=70 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "marginToken": [
                {
                    "productId": "70",
                    "spotToken": [
                        {
                            "token": "BTC",
                            "convertRatio": "1.00000000"
                        },
                        {
                            "token": "ETH",
                            "convertRatio": "1.00000000"
                        },
                        {
                            "token": "USDT",
                            "convertRatio": "1"
                        }
                    ],
                    "contractToken": [
                        {
                            "token": "USDT",
                            "convertRatio": "1"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669363954802
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/order-record.html b/zh-TW/v5/abandon/order-record.html index d47a467d2f..c333733f77 100644 --- a/zh-TW/v5/abandon/order-record.html +++ b/zh-TW/v5/abandon/order-record.html @@ -4,13 +4,13 @@ 查詢訂單歷史 | Bybit API Documentation - +

    查詢訂單歷史

    查詢存入/贖回/收益發放的訂單歷史

    HTTP 請求​

    GET /v5/lending/history-order

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種名稱
    orderIdfalsestring訂單ID
    startTimefalselong開始時間戳 (毫秒)
    endTimefalselong結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 500]. 默認: 50
    orderTypefalsestring訂單類型. 1: 存入, 2: 贖回, 3: 收益發放

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring幣種名稱
    > createdTimestring創建時間戳 (毫秒)
    > orderIdstring訂單ID
    > quantitystring數量
    > serialNostring序列號
    > statusstring訂單狀態. 0: 初始, 1: 處理中, 2: 成功, 10: 失敗, 11: 已撤銷
    updatedTimestring更新時間戳 (毫秒)

    請求示例​

    GET /v5/lending/history-order?orderNo=1403517113428086272 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: 9pXyrhxTlXXXXXaVQGSaP3n
    X-BAPI-TIMESTAMP: 1682049395799
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "coin": "BTC",
                    "createdTime": "1682048277963",
                    "orderId": "1403517113428086272",
                    "orderType": "2",
                    "quantity": "0.1",
                    "serialNo": "14035171132183710722373",
                    "status": "2",
                    "updatedTime": "1682048278245"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1682049395967
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/abandon/redeem.html b/zh-TW/v5/abandon/redeem.html index 9525c57b06..fd13bd43d6 100644 --- a/zh-TW/v5/abandon/redeem.html +++ b/zh-TW/v5/abandon/redeem.html @@ -4,13 +4,13 @@ 贖回資金 | Bybit API Documentation - +

    贖回資金

    提示

    在贖回本金時，系統還會自動贖回當前的收益。

    HTTP 請求​

    POST /v5/lending/redeem

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱
    quantityturestring贖回數量
    serialNofalsestring序列號，即自定義ID. 若不傳入，則系統自建

    響應參數​

    參數類型說明
    coinstring幣種名稱
    createdTimestring創建時間戳 (毫秒)
    orderIdstring訂單ID
    principalQtystring贖回數量
    serialNostring序列號
    statusstring訂單狀態. 0: 初始, 1: 處理中, 2: 成功, 10: 失敗
    updatedTimestring更新時間戳 (毫秒)

    請求示例​

    POST /v5/lending/redeem HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682048277724
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "coin": "BTC",
        "quantity": "0.1",
        "serialNo": null
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "coin": "BTC",
            "createdTime": "1682048277963",
            "orderId": "1403517113428086272",
            "principalQty": "0.1",
            "serialNo": "14035171132183710722373",
            "status": "0",
            "updatedTime": "1682048277963"
        },
        "retExtInfo": {},
        "time": 1682048278001
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/account-info.html b/zh-TW/v5/account/account-info.html index 59ff8c137f..399344e22d 100644 --- a/zh-TW/v5/account/account-info.html +++ b/zh-TW/v5/account/account-info.html @@ -4,13 +4,13 @@ 查詢賬戶配置 | Bybit API Documentation - +

    查詢賬戶配置

    該接口可以查詢賬戶下的配置

    HTTP 請求​

    GET /v5/account/info

    請求參數​

    無

    響應參數​

    參數類型說明
    unifiedMarginStatusinteger帳戶狀態類型
    marginModestringISOLATED_MARGIN(逐倉保證金), REGULAR_MARGIN（全倉保證金） PORTFOLIO_MARGIN（組合保證金）
    dcpStatusstring廢棄字段, 總是OFF. 請使用查詢DCP配置
    timeWindowinteger廢棄字段, 總是0. 請使用查詢DCP配置
    smpGroupinteger已廢棄, 總是0. 請調用查詢SMP組ID
    isMasterTraderboolean是否為帶單帳戶. true, false
    spotHedgingStatusstring是否開啟現貨對衝. ON, OFF
    updatedTimestring賬戶數據更新的時間，毫秒時間戳

    請求示例​

    GET /v5/account/info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672129307221
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "marginMode": "REGULAR_MARGIN",
            "updatedTime": "1697078946000",
            "unifiedMarginStatus": 4,
            "dcpStatus": "OFF",
            "timeWindow": 10,
            "smpGroup": 0,
            "isMasterTrader": false,
            "spotHedgingStatus": "OFF"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/batch-set-collateral.html b/zh-TW/v5/account/batch-set-collateral.html index df5bc2ec35..1bb5b3dbc2 100644 --- a/zh-TW/v5/account/batch-set-collateral.html +++ b/zh-TW/v5/account/batch-set-collateral.html @@ -4,13 +4,13 @@ 批量設置抵押品幣種 | Bybit API Documentation - +

    批量設置抵押品幣種

    用戶可以批量開啟或關閉統一帳戶中幣種抵押屬性，默認都是關閉的

    HTTP 請求​

    POST /v5/account/set-collateral-switch-batch

    請求參數​

    參數是否必需類型說明
    requesttruearrayObject
    > cointruestring幣種名稱
    • 您可以從這裡獲取抵押品幣種
    • USDT, USDC不支持設置
    > collateralSwitchtruestringON: 開啟抵押, OFF: 關閉抵押

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> coinstring幣種名稱
    >> collateralSwitchstringON: 開啟抵押, OFF: 關閉抵押

    請求示例​

    POST /v5/account/set-collateral-switch-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1704782042755
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 371

    {
        "request": [
            {
                "coin": "MATIC",
                "collateralSwitch": "OFF"
            },
            {
                "coin": "BTC",
                "collateralSwitch": "OFF"
            },
            {
                "coin": "ETH",
                "collateralSwitch": "OFF"
            },
            {
                "coin": "SOL",
                "collateralSwitch": "OFF"
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "result": {
            "list": [
                {
                    "coin": "MATIC",
                    "collateralSwitch": "OFF"
                },
                {
                    "coin": "BTC",
                    "collateralSwitch": "OFF"
                },
                {
                    "coin": "ETH",
                    "collateralSwitch": "OFF"
                },
                {
                    "coin": "SOL",
                    "collateralSwitch": "OFF"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1704782042913
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/borrow-history.html b/zh-TW/v5/account/borrow-history.html index 52fa84a7cb..0cd4dca803 100644 --- a/zh-TW/v5/account/borrow-history.html +++ b/zh-TW/v5/account/borrow-history.html @@ -4,13 +4,13 @@ 查詢利息記錄 | Bybit API Documentation - +

    查詢利息記錄

    獲取利息記錄，按照創建時間倒敘排列。

    HTTP 請求​

    GET /v5/account/borrow-history

    請求參數​

    參數是否必需類型說明
    currencyfalsestringUSDC、USDT、BTC、ETH
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近30天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 30天
    • 若只傳startTime，則查詢startTime和startTime+30天的數據
    • 若只傳endTime，則查詢endTime-30天和endTime的數據
    endTimefalseinteger結束時間 (毫秒)
    limitfalseinteger每頁數量, 最大50. 默認每頁20條
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > currencystringUSDC、USDT、BTC、ETH
    > createdTimeinteger時間戳（毫秒）
    > borrowCoststring利息
    > hourlyBorrowRatestring利率
    > InterestBearingBorrowSizestring豁免利息額度
    > costExemptionstring豁免計息成本
    > borrowAmountstring當前總借貸
    > unrealisedLossstring浮動虧損
    > freeBorrowedAmountstring借款中免息的數額
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/account/borrow-history?currency=BTC&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672277745427
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "2671153%3A1%2C2671153%3A1",
            "list": [
                {
                    "borrowAmount": "1.06333265702840778",
                    "costExemption": "0",
                    "freeBorrowedAmount": "0",
                    "createdTime": 1697439900204,
                    "InterestBearingBorrowSize": "1.06333265702840778",
                    "currency": "BTC",
                    "unrealisedLoss": "0",
                    "hourlyBorrowRate": "0.000001216904",
                    "borrowCost": "0.00000129"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1697442206478
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/coin-greeks.html b/zh-TW/v5/account/coin-greeks.html index 90217b873c..1240a580a2 100644 --- a/zh-TW/v5/account/coin-greeks.html +++ b/zh-TW/v5/account/coin-greeks.html @@ -4,13 +4,13 @@ 查詢Greeks信息 | Bybit API Documentation - +

    查詢Greeks信息

    獲取當前賬戶Greeks信息

    HTTP 請求​

    GET /v5/asset/coin-greeks

    請求參數​

    參數是否必需類型類型
    baseCoinfalsestringbaseCoin- 不傳入，默認返回全部baseCoin的greeks

    響應參數​

    參數類型類型
    listarrayObject
    > baseCoinstringbaseCoin，例如：BTC、ETH、SOL etc
    > totalDeltastringDelta值
    > totalGammastringGamma值
    > totalVegastringVega值
    > totalThetastringTheta值

    請求示例​

    GET /v5/asset/coin-greeks?baseCoin=BTC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672287887610
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "baseCoin": "BTC",
                    "totalDelta": "0.00004001",
                    "totalGamma": "-0.00000009",
                    "totalVega": "-0.00039689",
                    "totalTheta": "0.01243824"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672287887942
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/collateral-info.html b/zh-TW/v5/account/collateral-info.html index f8cd9c783a..20ab6f76ab 100644 --- a/zh-TW/v5/account/collateral-info.html +++ b/zh-TW/v5/account/collateral-info.html @@ -4,13 +4,13 @@ 查詢抵押品信息 | Bybit API Documentation - +

    查詢抵押品信息

    獲取當前統一保證金賬戶的抵押品信息，包括借貸利率，可藉貸金額以及抵押品折算率，是否可抵押作為保證金等信息。

    HTTP 請求​

    GET /v5/account/collateral-info

    請求參數​

    參數是否必需類型說明
    currencyfalsestring目前所有抵押品的資產幣種

    響應參數​

    參數類型說明
    listarrayObject
    > currencystring目前所有抵押品的資產幣種
    > hourlyBorrowRatestring每小時藉款利率
    > maxBorrowingAmountstring最大可藉貸額度. 該值由母子帳號共享
    > freeBorrowingLimitstring免息借款額上限
    • 僅合約浮虧時產生的借款擁有免息額度
    • 槓桿交易的借貸總是產生利息
    > freeBorrowAmountstring借款總額中免息部分的借款金額
    > borrowAmountstring已用借貸額度
    > availableToBorrowstring用戶剩餘可藉額度. 該值由母子帳號共享
    > borrowableboolean是否是可藉貸的幣種, true: 是. false: 否
    > freeBorrowingAmountstring廢棄字段, 總是返回空字符串, 請參考freeBorrowingLimit
    > borrowUsageRatestring借貸資金使用率: borrowAmount/maxBorrowingAmount. 這是一個真實值, 0.5则表示50%
    > marginCollateralboolean是否可作為保證金抵押幣種(平台維度), true: 是. false: 否
  • 當marginCollateral=false時, 則collateralSwitch無意義
    • > collateralSwitchboolean用戶是否開啟保證金幣種抵押(用戶維度), true: 是. false: 否
  • 僅當marginCollateral=true時, 才能主動選擇開關抵押
    • > collateralRatiostring抵押品幣種折算為保證金的折算率

    請求示例​

    GET /v5/account/collateral-info?currency=BTC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672127952719
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "availableToBorrow": "3",
                    "freeBorrowingAmount": "",
                    "freeBorrowAmount": "0",
                    "maxBorrowingAmount": "3",
                    "hourlyBorrowRate": "0.00000147",
                    "borrowUsageRate": "0",
                    "collateralSwitch": true,
                    "borrowAmount": "0",
                    "borrowable": true,
                    "currency": "BTC",
                    "marginCollateral": true,
                    "freeBorrowingLimit": "0",
                    "collateralRatio": "0.95"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1691565901952
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/contract-transaction-log.html b/zh-TW/v5/account/contract-transaction-log.html index 9266130e81..a5c976ff11 100644 --- a/zh-TW/v5/account/contract-transaction-log.html +++ b/zh-TW/v5/account/contract-transaction-log.html @@ -4,13 +4,13 @@ 交易日誌 | Bybit API Documentation - +

    交易日誌

    支持查詢經典帳戶下合約錢包, 以及統一帳戶下反向合約錢包裡的交易日誌

    API key權限: "合約 - 倉位"

    HTTP 請求​

    GET /v5/account/contract-transaction-log

    請求參數​

    參數是否必需類型說明
    currencyfalsestring貨幣
    baseCoinfalsestring交易幣種. 例如： BTCUSDT 的 baseCoin 是 BTC
    typefalsestring交易日誌的類型
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime ≤ 7天
    • 若只傳startTime，則查詢startTime和startTime+7天的數據
    • 若只傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量, 最大50. 默認每頁20條
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > idstring唯一id
    > symbolstring合約名稱
    > categorystring產品類型
    > sidestring方向. Buy,Sell,None
    > transactionTimestring交易時間戳（毫秒）
    > typestring類型
    > qtystring數量.
  • 期貨: 對於成交的流水來說, 這裡的qty表示每筆成交的數量, 不帶方向
    • > sizestring倉位. 特別地, 對於成交的流水來說, 這裡的size表示成交後的倉位大小, 帶有方向, 比如空倉, 則有"-"
    > currencystring幣種
    > tradePricestring交易價格
    > fundingstring資金費用. 正數表示用戶支出xx資金費，負數表示用戶收取xx資金費
    > feestring手續費，正數表示用戶付出xx手續費，負數表示返佣
    > cashFlowstring現金流, 比如平倉時的未平盈虧結算, 以及劃入劃出等. 該值不包含任何手續費或者資金費
    > changestring變更 = cashFlow + funding - fee
    > cashBalancestring餘額（當前幣種）, 資金流發生後的該幣種的錢包餘額
    > feeRatestring
    • 對於type=TRADE, 則表示交易手續費率
    • 對於type=SETTLEMENT, 則表示資金費率. 當side=Buy, feeRate=市場結算費率; 當side=Sell, feeRate=-市場結算費率
    > bonusChangestring體驗金的變化
    > tradeIdstring交易id
    > orderIdstring訂單id
    > orderLinkIdstring用戶自定義訂單id
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/account/contract-transaction-log?limit=1&symbol=BTCUSD HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1714035117255
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "id": "467153",
                    "symbol": "BTCUSD",
                    "category": "inverse",
                    "side": "Sell",
                    "transactionTime": "1714032000000",
                    "type": "SETTLEMENT",
                    "qty": "1000",
                    "size": "-1000",
                    "currency": "BTC",
                    "tradePrice": "63974.88",
                    "funding": "-0.00000156",
                    "fee": "",
                    "cashFlow": "0.00000000",
                    "change": "0.00000156",
                    "cashBalance": "1.1311",
                    "feeRate": "-0.00010000",
                    "bonusChange": "",
                    "tradeId": "423a565c-f1b6-4c81-bc62-760cd7dd89e7",
                    "orderId": "",
                    "orderLinkId": ""
                }
            ],
            "nextPageCursor": "cursor_id%3D467153%26"
        },
        "retExtInfo": {},
        "time": 1714035117258
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/dcp-info.html b/zh-TW/v5/account/dcp-info.html index cc515db343..6e36a4dda8 100644 --- a/zh-TW/v5/account/dcp-info.html +++ b/zh-TW/v5/account/dcp-info.html @@ -4,13 +4,13 @@ 查詢DCP配置 | Bybit API Documentation - +

    查詢DCP配置

    查詢帳戶的合約(USDT永續, USDC永續和USDC交割) / 現貨 / 期權的dcp配置. 在調用接口前, 請確保已經和客戶經理申請了帳戶DCP開通

    • 只有配置了的母子帳戶能夠從該接口查詢到信息, 沒有配置的母帳戶或者子帳戶調用該接口總是返回空

    • 在配置時, 若只申請部分業務線, 比如只申請開通期貨, 則現貨和期權是不會返回數據的

    • 只有統一帳戶能夠正常觸發DCP功能, 涉及的業務線有合約(USDT永續, USDC永續和USDC交割) / 現貨 / 期權

    HTTP 請求​

    GET /v5/account/query-dcp-info

    請求參數​

    無

    響應參數​

    參數類型說明
    dcpInfosarray<object>
    > productstringSPOT, DERIVATIVES, OPTIONS
    > dcpStatusstring設置斷線保護時間 開關狀態: ON
    > timeWindowstring設置的DCP觸發時間窗口. 範圍為[3, 300] 秒, 默認: 10 秒

    請求示例​

    GET /v5/account/query-dcp-info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1717065530867
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    // 下面這個實例意味著帳戶只配置了現貨和期貨的dcp功能
    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "dcpInfos": [
                {
                    "product": "SPOT",
                    "dcpStatus": "ON",
                    "timeWindow": "10"
                },
                {
                    "product": "DERIVATIVES",
                    "dcpStatus": "ON",
                    "timeWindow": "10"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1717065531697
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/fee-rate.html b/zh-TW/v5/account/fee-rate.html index 53abe59aa1..c726497bc3 100644 --- a/zh-TW/v5/account/fee-rate.html +++ b/zh-TW/v5/account/fee-rate.html @@ -4,13 +4,13 @@ 查詢手續費率 | Bybit API Documentation - +

    查詢手續費率

    查詢交易手續費率。

    覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向永續 / 反向交割 / 期權

    HTTP 請求​

    GET /v5/account/fee-rate

    參數是否必需類型說明
    categorytruestring產品類型. spot, linear, inverse, option
    symbolfalsestring合約名稱. 僅spot, linear, inverse有效
    baseCoinfalsestring交易幣種. SOL, BTC, ETH.僅option有效

    響應參數​

    參數類型說明
    categorystring產品類型. spot, option. 期貨不返回該字段
    listarrayObject
    > symbolstring合約名稱. 期權總是為""
    > baseCoinstring交易幣種. SOL, BTC, ETH
    • 期貨不返回該字段
    • 現貨總是返回""
    > takerFeeRatestring吃單手續費率
    > makerFeeRatestring掛單手續費率

    請求示例​

    GET /v5/account/fee-rate?symbol=ETHUSDT HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXXX
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1676360412362
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "ETHUSDT",
                    "takerFeeRate": "0.0006",
                    "makerFeeRate": "0.0001"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1676360412576
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/get-mmp-state.html b/zh-TW/v5/account/get-mmp-state.html index 0a7622ff09..b2ff403595 100644 --- a/zh-TW/v5/account/get-mmp-state.html +++ b/zh-TW/v5/account/get-mmp-state.html @@ -4,13 +4,13 @@ 查詢市商保護配置信息 | Bybit API Documentation - +

    查詢市商保護配置信息

    HTTP 請求​

    GET /v5/account/mmp-state

    請求參數​

    參數是否必需類型說明
    baseCointruestringBase coin

    響應參數​

    參數類型說明
    resultarrayObject
    > baseCoinstring交易幣種
    > mmpEnabledboolean帳戶是否開啟了mmp
    > windowstring時間窗口 (毫秒)
    > frozenPeriodstring凍結時間長度 (毫秒)
    > qtyLimitstring成交數量上限
    > deltaLimitstringDelta值上限
    > mmpFrozenUntilstring解凍時間戳 (毫秒)
    > mmpFrozenboolean當前是否觸發了mmp凍結.
    • true: mmpFrozenUntil的值有意義
    • false: 請忽略mmpFrozenUntil字段的值

    請求示例​

    POST /v5/account/mmp-reset HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675842997277
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "baseCoin": "ETH"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "result": [
                {
                    "baseCoin": "BTC",
                    "mmpEnabled": true,
                    "window": "5000",
                    "frozenPeriod": "100000",
                    "qtyLimit": "0.01",
                    "deltaLimit": "0.01",
                    "mmpFrozenUntil": "1675760625519",
                    "mmpFrozen": false
                }
            ]
        },
        "retExtInfo": {},
        "time": 1675843188984
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/repay-liability.html b/zh-TW/v5/account/repay-liability.html index b7edcb3996..7a2f00fc73 100644 --- a/zh-TW/v5/account/repay-liability.html +++ b/zh-TW/v5/account/repay-liability.html @@ -4,14 +4,14 @@ 一鍵還款 | Bybit API Documentation - +

    一鍵還款

    您可以通過該接口手動還清統一帳戶中的借款

    適用對象: 統一帳戶
    權限: USDC合約

    HTTP 請求​

    POST /v5/account/quick-repayment

    請求參數​

    參數是否必需類型說明
    coinfalsestring有負債的幣種
    • 指定幣種: 則僅還清指定幣種的負債
    • 不指定: 還清所有有負債的幣種

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring用於償還借款的兌出幣種
    • 用於還款的幣種是基於這個接口中的liquidationOrder字段
    > repaymentQtystring兌出幣種數量

    請求示例​

    POST /v5/account/quick-repayment HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1701848610019
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 22

    {
        "coin": "USDT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "result": {
            "list": [
                {
                    "coin": "BTC",
                    "repaymentQty": "0.10549670"
                },
                {
                    "coin": "ETH",
                    "repaymentQty": "2.27768114"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1701848610941
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/reset-mmp.html b/zh-TW/v5/account/reset-mmp.html index 9faf51ac2d..494e95219a 100644 --- a/zh-TW/v5/account/reset-mmp.html +++ b/zh-TW/v5/account/reset-mmp.html @@ -4,13 +4,13 @@ 重置市商保護凍結 | Bybit API Documentation - +

    重置市商保護凍結

    信息
    • 一旦mmp被觸發, 您的帳戶可以調用該接口進行主動解凍, 解凍後, qtyLimit和deltaLimit就重置為0.
    • 若帳戶沒有被凍結, 該重置接口能夠清除之前的交易, 即不計算重置前發生的總數量和淨交易delta, qtyLimit和deltaLimit就重置為0.

    HTTP 請求​

    POST /v5/account/mmp-reset

    請求參數​

    參數是否必需類型說明
    baseCointruestring交易幣種

    響應參數​

    無

    請求示例​

    POST /v5/account/mmp-reset HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675842997277
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "baseCoin": "ETH"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/set-collateral.html b/zh-TW/v5/account/set-collateral.html index db11c9de01..f6ed690252 100644 --- a/zh-TW/v5/account/set-collateral.html +++ b/zh-TW/v5/account/set-collateral.html @@ -4,13 +4,13 @@ 設置抵押品幣種 | Bybit API Documentation - +

    設置抵押品幣種

    用戶可以自行決定是否開啟統一帳戶中幣種是否進行抵押，默認都是關閉的

    HTTP 請求​

    POST /v5/account/set-collateral-switch

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱
    • 您可以從這裡獲取抵押品幣種
    • USDT, USDC不支持設置
    collateralSwitchtruestringON: 開啟抵押, OFF: 關閉抵押

    響應參數​

    無

    請求示例​

    POST /v5/account/set-collateral-switch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1690513916181
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 55

    {
        "coin": "BTC",
        "collateralSwitch": "ON"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "result": {},
        "retExtInfo": {},
        "time": 1690515818656
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/set-margin-mode.html b/zh-TW/v5/account/set-margin-mode.html index 78bea8f3e9..f4660a5d66 100644 --- a/zh-TW/v5/account/set-margin-mode.html +++ b/zh-TW/v5/account/set-margin-mode.html @@ -4,13 +4,13 @@ 設置保證金模式(帳戶) | Bybit API Documentation - +

    設置保證金模式(帳戶)

    用戶如果不設置，默認按全倉保證金

    信息
    • UTA帳戶支持切換三種帳戶維度的保證金模式, 對USDT永續, USDC永續, USDC交割以及期權有效 (其中, 期權不支持逐倉保證金模式)
    • 經典帳戶支持切換全倉保證金模式和組合保證金模式, 但僅作用於USDC永續和期權

    HTTP 請求​

    POST /v5/account/set-margin-mode

    請求參數​

    參數是否必需類型說明
    setMarginModetruestringISOLATED_MARGIN(逐倉保證金模式), REGULAR_MARGIN（全倉保證金模式）PORTFOLIO_MARGIN（組合保證金模式）默認常規，傳常規則返回設置成功

    響應參數​

    參數類型說明
    reasonsarrayObject. 若請求提交成功, 則返回空數組
    > reasonCodestring失敗錯誤碼
    > reasonMsgstring失敗錯誤消息

    請求示例​

    POST /v5/account/set-margin-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672134396332
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "setMarginMode": "PORTFOLIO_MARGIN"
    }

    響應示例​

    {
        "retCode": 3400045,
        "retMsg": "Set margin mode failed",
        "result": {
            "reasons": [
                {
                    "reasonCode": "3400000",
                    "reasonMsg": "Equity needs to be equal to or greater than 1000 USDC"
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/set-mmp.html b/zh-TW/v5/account/set-mmp.html index ad2abe1376..5ac2d6ffdc 100644 --- a/zh-TW/v5/account/set-mmp.html +++ b/zh-TW/v5/account/set-mmp.html @@ -4,7 +4,7 @@ 设置市商保護 | Bybit API Documentation - + @@ -13,7 +13,7 @@ 在短時間內的總交易額超過了配置的限額，該賬戶的做市商保護將被觸發。當做市商保護被觸發時，賬戶現有的做市商保護訂單（被標記為做市商保護的訂單）將被 交易引擎自動取消，而該賬戶新的做市商保護訂單將在未來一段時間（稱為凍結期）被拒絕（常規非MMP訂單不受影響）。用戶可以利用這段時間重新評估行情並修改報價。

    如何開通MMP​

    您可通過郵件Bybit【financial.inst@bybit.com】或聯繫對應的客戶經理申請開通。 開通後，MMP的默認配置為:

    參數類型說明默認值
    baseCoinstring交易幣種BTC
    windowstring時間窗口 (毫秒)5000
    frozenPeriodstring凍結時間段 (毫秒)100
    qtyLimitstring成交數量上限100
    deltaLimitstringDelta值上限100

    適用對象​

    僅適用於期權交易. 當創建期權訂單時, 設置參數mmp=true, 則表示將此訂單納入市商保護。

    一些注意事項​

    1. 只有掛單成交qty和delta會被計入qtyLimit和deltaLimit。
    2. qty_limit 是每筆交易執行數量的絕對值總和。 delta_limit 是 qty*delta 總和的絕對值。 如果其中任何一項達到或超過限額，該帳戶的做市商保護將會被觸發。

    HTTP 請求​

    POST /v5/account/mmp-modify

    請求參數​

    參數是否必需類型說明
    baseCointruestring交易幣種
    windowtruestring時間窗口 (毫秒)
    frozenPeriodtruestring凍結時間長度 (毫秒). 設置為"0"則表示帳戶會保持凍結狀態，除非手動重置
    qtyLimittruestring成交數量上限 (正數，至多2位小數)
    deltaLimittruestringDelta上限 (正數，至多2位小數)

    響應參數​

    無

    請求示例​

    POST /v5/account/mmp-modify HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675833524616
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
        "baseCoin": "ETH",
        "window": "5000",
        "frozenPeriod": "100000",
        "qtyLimit": "50",
        "deltaLimit": "20"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/set-spot-hedge.html b/zh-TW/v5/account/set-spot-hedge.html index 8d383c0aa1..22b7ccd75d 100644 --- a/zh-TW/v5/account/set-spot-hedge.html +++ b/zh-TW/v5/account/set-spot-hedge.html @@ -4,13 +4,13 @@ 設置現貨對衝 | Bybit API Documentation - +

    設置現貨對衝

    您可以開關現貨對從功能, 僅限統一帳戶組合保證金模式下

    信息
    • 僅限統一帳戶下組合保證金(Portfolio margin mode)有效

    HTTP 請求​

    POST /v5/account/set-hedging-mode

    請求參數​

    參數是否必需類型說明
    setHedgingModetruestringON, OFF

    響應參數​

    參數類型說明
    retCodeintegerResult code
    retMsgstringResult message

    請求示例​

    POST /v5/account/set-hedging-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1700117968580
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 31

    {
        "setHedgingMode": "OFF"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "SUCCESS"
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/smp-group.html b/zh-TW/v5/account/smp-group.html index 84b8ecea56..2c1297cb27 100644 --- a/zh-TW/v5/account/smp-group.html +++ b/zh-TW/v5/account/smp-group.html @@ -4,13 +4,13 @@ 查詢SMP組ID | Bybit API Documentation - +

    查詢SMP組ID

    查詢自成交攔截的SMP交易群組ID

    HTTP 請求​

    GET /v5/account/smp-group

    請求參數​

    無

    響應參數​

    參數類型說明
    smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0

    請求示例​

    GET /v5/account/smp-group HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1702363848192
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "smpGroup": 0
        },
        "retExtInfo": {},
        "time": 1702363848539
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/transaction-log.html b/zh-TW/v5/account/transaction-log.html index 94fab8a097..ef27b889e5 100644 --- a/zh-TW/v5/account/transaction-log.html +++ b/zh-TW/v5/account/transaction-log.html @@ -4,13 +4,13 @@ 交易日誌 | Bybit API Documentation - +

    交易日誌

    整個賬戶統一錢包裡的交易日誌, 支持最多查詢過去2年的數據

    HTTP 請求​

    GET /v5/account/transaction-log

    請求參數​

    參數是否必需類型說明
    accountTypefalsestring錢包類型. 目前僅支持UNIFIED
    categoryfalsestring交易產品類型. spot：現貨；linear：USDT永續, USDC永續, USDC交割；option：期權
    currencyfalsestring貨幣
    baseCoinfalsestring交易幣種. 例如： BTCUSDT 的 baseCoin 是 BTC
    typefalsestring交易日誌的類型
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime ≤ 7天
    • 若只傳startTime，則查詢startTime和startTime+7天的數據
    • 若只傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量, 最大50. 默認每頁20條
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > idstring唯一id
    > symbolstring合約名稱
    > categorystring產品類型
    > sidestring方向. Buy,Sell,None
    > transactionTimestring交易時間戳（毫秒）
    > typestring類型
    > qtystring數量.
  • 現貨: 正的qty表示該幣數量增加, 負的qty表示該幣數量減少
  • 期貨: 對於成交的流水來說, 這裡的qty表示每筆成交的數量, 不帶方向
    • > sizestring倉位. 特別地, 對於成交的流水來說, 這裡的size表示成交後的倉位大小, 帶有方向, 比如空倉, 則有"-"
    > currencystringUSDC、USDT、BTC、ETH
    > tradePricestring交易價格
    > fundingstring資金費用. 正數表示用戶收取xx資金費，負數表示用戶支出xx資金費
  • 對於USDC永續合約, 由於資金費結算週期和8小時結算的週期一致, 所以您會看到資金費和8小時結算的數據存在於同一條流水中(type=SETTLEMENT), 您可以通過funding來確定資金費用, 以及cashFlow來確定8小時平倉盈虧
    • > feestring手續費，正數表示用戶付出xx手續費，負數表示返佣
    > cashFlowstring現金流, 比如平倉時的未平盈虧結算, USDC永續和交割合約的8小時結算, 以及劃入劃出等. 該值不包含任何手續費或者資金費
    > changestring變更 = cashFlow + funding - fee
    > cashBalancestring餘額（當前幣種）, 資金流發生後的該幣種的錢包餘額
    > feeRatestring
    • 對於type=TRADE, 則表示交易手續費率
    • 對於type=SETTLEMENT, 則表示資金費率. 當side=Buy, feeRate=市場結算費率; 當side=Sell, feeRate=-市場結算費率
    > bonusChangestring體驗金的變化
    > tradeIdstring交易id
    > orderIdstring訂單id
    > orderLinkIdstring用戶自定義訂單id
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/account/transaction-log?accountType=UNIFIED&category=linear&currency=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672132480085
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "21963%3A1%2C14954%3A1",
            "list": [
                {
                    "id": "592324_XRPUSDT_161440249321",
                    "symbol": "XRPUSDT",
                    "side": "Buy",
                    "funding": "-0.003676",
                    "orderLinkId": "",
                    "orderId": "1672128000-8-592324-1-2",
                    "fee": "0.00000000",
                    "change": "-0.003676",
                    "cashFlow": "0",
                    "transactionTime": "1672128000000",
                    "type": "SETTLEMENT",
                    "feeRate": "0.0001",
                    "bonusChange": "",
                    "size": "100",
                    "qty": "100",
                    "cashBalance": "5086.55825002",
                    "currency": "USDT",
                    "category": "linear",
                    "tradePrice": "0.3676",
                    "tradeId": "534c0003-4bf7-486f-aa02-78cee36825e4"
                },
                {
                    "id": "592324_XRPUSDT_161440249321",
                    "symbol": "XRPUSDT",
                    "side": "Buy",
                    "funding": "",
                    "orderLinkId": "linear-order",
                    "orderId": "592b7e41-78fd-42e2-9aa3-91e1835ef3e1",
                    "fee": "0.01908720",
                    "change": "-0.0190872",
                    "cashFlow": "0",
                    "transactionTime": "1672121182224",
                    "type": "TRADE",
                    "feeRate": "0.0006",
                    "bonusChange": "-0.1430544",
                    "size": "100",
                    "qty": "88",
                    "cashBalance": "5086.56192602",
                    "currency": "USDT",
                    "category": "linear",
                    "tradePrice": "0.3615",
                    "tradeId": "5184f079-88ec-54c7-8774-5173cafd2b4e"
                },
                {
                    "id": "592324_XRPUSDT_161407743011",
                    "symbol": "XRPUSDT",
                    "side": "Buy",
                    "funding": "",
                    "orderLinkId": "linear-order",
                    "orderId": "592b7e41-78fd-42e2-9aa3-91e1835ef3e1",
                    "fee": "0.00260280",
                    "change": "-0.0026028",
                    "cashFlow": "0",
                    "transactionTime": "1672121182224",
                    "type": "TRADE",
                    "feeRate": "0.0006",
                    "bonusChange": "",
                    "size": "12",
                    "qty": "12",
                    "cashBalance": "5086.58101322",
                    "currency": "USDT",
                    "category": "linear",
                    "tradePrice": "0.3615",
                    "tradeId": "8569c10f-5061-5891-81c4-a54929847eb3"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672132481405
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/upgrade-unified-account.html b/zh-TW/v5/account/upgrade-unified-account.html index cb2ab3b0d4..93d1e78c18 100644 --- a/zh-TW/v5/account/upgrade-unified-account.html +++ b/zh-TW/v5/account/upgrade-unified-account.html @@ -4,7 +4,7 @@ 升級統一保證金賬戶 | Bybit API Documentation - + @@ -13,7 +13,7 @@ 如果unifiedMarginStatus=4, 則表示帳戶已經成功升級至UTA Pro.

  • 如果unifiedMarginStatus=3, 則表示當前帳戶是統一交易帳戶 (UTA), 您可以調用以下接口升級到UTA Pro. 等到調用升級接口後一段時間, 重新調用查詢賬戶配置接口, 如果unifiedMarginStatus=4, 則表示帳戶已經成功升級至UTA Pro.

    • important

    封禁 / 極簡鏈路用戶當前無法升級至統一帳戶.

    信息

    您現在可以持倉完成升級了，但請注意以下事項：

    1. 升級請避開以下時段:
    每個小時當前時間在小時整點的前10分鐘及後5分鐘內
    1. 為保證順利升級，請確保：
    • 當前現貨帳戶內無任何掛單或負債
    • 在合約帳戶內無任何掛單，並且確保所有USDT永續倉位要麼逐倉要麼全倉
    • 在USDC合約帳戶無任何掛單
    • 注意，倉位附帶的止盈止損單也屬於掛單

    1. 帳戶升級實時返回的unifiedUpgradeProcess為PROCESS時，代表需要系統異步校驗處理，無法實時返回升級結果，您可在3-5分鐘後通過查詢API Key相關信息 接口，根據返回中的"uta"字段確認是否升級成功

    2. 帳戶升級過程中，可能會由於帳戶相關資產數據處於處理狀態中導致查詢/推送的數據不準確，建議在完成升級後，再查詢和使用。

    HTTP 請求​

    POST /v5/account/upgrade-to-uta

    請求參數​

    無

    響應參數​

    ParameterTypeComments
    unifiedUpdateStatusstring用戶賬戶的升級狀態. PROCESS: 處理中, FAIL: 失敗, SUCCESS: 成功
    unifiedUpdateMsgObject若是PROCESS,SUCCESS，則返回null
    msgarray錯誤原因列表. 只有FAIL時，才會有msg這個字段

    請求示例​

    POST /v5/account/upgrade-to-uta HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672125123533
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {}

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "unifiedUpdateStatus": "FAIL",
            "unifiedUpdateMsg": {
                "msg": [
                    "Update account failed. You have outstanding liabilities in your Spot account.",
                    "Update account failed. Please close the usdc perpetual positions in USDC Account.",
                    "unable to upgrade, please cancel the usdt perpetual open orders in USDT account.",
                    "unable to upgrade, please close the usdt perpetual positions in USDT account."
                ]
            }
        },
        "retExtInfo": {},
        "time": 1672125124195
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/account/wallet-balance.html b/zh-TW/v5/account/wallet-balance.html index 99045f91ba..078b37a576 100644 --- a/zh-TW/v5/account/wallet-balance.html +++ b/zh-TW/v5/account/wallet-balance.html @@ -4,13 +4,13 @@ 查詢錢包餘額 | Bybit API Documentation - +

    查詢錢包餘額

    獲取統一帳戶和經典帳戶錢包餘額, 查詢各個幣種的資產信息，以及統一保證金模式下的帳戶風險率信息。默認不返回資產或負債為0的幣種信息。

    提示
    • UTA交易反向合約是通過該帳戶下的CONTRACT錢包進行
    • 請使用該接口查詢資金帳戶的餘額

    HTTP 請求​

    GET /v5/account/wallet-balance

    請求參數​

    參數是否必需類型說明
    accountTypetruestring帳戶類型.
    • 統一帳戶: UNIFIED(現貨/USDT和USDC永續/期權), CONTRACT(反向)
    • 經典帳戶: CONTRACT(期貨), SPOT(現貨)
    coinfalsestring幣種名稱
    • 不傳則返回非零資產信息
    • 可以傳多個幣進行查詢，以逗號分隔, USDT,USDC

    響應參數​

    參數類型說明
    listarrayObject
    > accountTypestring帳戶類型
    > accountLTVstring字段廢棄
    > accountIMRatestring帳戶初始保證金率: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin. 非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > accountMMRatestring帳戶維持保證金率: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalEquitystring總凈值為賬戶中每個幣種資產凈值的法幣估值之和。。非統一保證金模式以及統一帳戶(反向)下，該字段返回為空。
    > totalWalletBalancestring賬戶維度換算成usd的產錢包餘額：∑ Asset Wallet Balance By USD value of each asset。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalMarginBalancestring賬戶維度換算成usd的保證金餘額：totalWalletBalance + totalPerpUPL。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalAvailableBalancestring賬戶維度換算成usd的可用餘額：RM：totalMarginBalance - totalInitialMargin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalPerpUPLstring賬戶維度換算成usd的永續和USDC交割合約的浮動盈虧：∑ Each perp and USDC Futures upl by base coin。非統一保證金模式以及統一帳戶(反向)下，該字段返回為空。
    > totalInitialMarginstring賬戶維度換算成usd的總初始保證金：∑ Asset Total Initial Margin Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalMaintenanceMarginstring賬戶維度換算成usd的總維持保證金: ∑ Asset Total Maintenance Margin Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > coinarrays幣種列表
    >> coinstring幣種名稱，例如 BTC，ETH，USDT，USDC
    >> equitystring當前幣種的資產淨值
    >> usdValuestring當前幣種折算成 usd 的價值
    >> walletBalancestring當前幣種的錢包餘額
    >> freestring經典帳戶現貨錢包的可用餘額. 經典帳戶現貨錢包的獨有字段
    >> lockedstring現貨掛單凍結金額
    >> spotHedgingQtystring用於組合保證金(PM)現貨對衝的數量, 截斷至8為小數, 默認為0 統一帳戶的獨有字段
    >> borrowAmountstring當前幣種的已用借貸額度
    >> availableToBorrowstring由於母子共享借貸限額, 該字段已廢棄, 總是返回"". 請通過查詢抵押品信息接口查詢availableToBorrow
    >> availableToWithdrawstring當前幣種的可劃轉提現金額
    >> accruedIntereststring當前幣種的預計要在下一個利息週期收取的利息金額
    >> totalOrderIMstring以當前幣種結算的訂單委託預佔用保證金. 組合保證金模式下，該字段返回空字符串
    >> totalPositionIMstring以當前幣種結算的所有倉位起始保證金求和 + 所有倉位的預佔用平倉手續費. 組合保證金模式下，該字段返回空字符串
    >> totalPositionMMstring以當前幣種結算的所有倉位維持保證金求和. 組合保證金模式下，該字段返回空字符串
    >> unrealisedPnlstring以當前幣種結算的所有倉位的未結盈虧之和
    >> cumRealisedPnlstring以當前幣種結算的所有倉位的累計已結盈虧之和
    >> bonusstring體驗金. UNIFIED帳戶的獨有字段
    >> marginCollateralboolean是否可作為保證金抵押幣種(平台維度), true: 是. false: 否
    • 當marginCollateral=false時, 則collateralSwitch無意義
    • UNIFIED帳戶的獨有字段
    >> collateralSwitchboolean用戶是否開啟保證金幣種抵押(用戶維度), true: 是. false: 否
    • 僅當marginCollateral=true時, 才能主動選擇開關抵押
    • UNIFIED帳戶的獨有字段

    請求示例​

    GET /v5/account/wallet-balance?accountType=UNIFIED&coin=BTC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672125440406
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "totalEquity": "18070.32797922",
                    "accountIMRate": "0.0101",
                    "totalMarginBalance": "18070.32797922",
                    "totalInitialMargin": "182.60183684",
                    "accountType": "UNIFIED",
                    "totalAvailableBalance": "17887.72614237",
                    "accountMMRate": "0",
                    "totalPerpUPL": "-0.11001349",
                    "totalWalletBalance": "18070.43799271",
                    "accountLTV": "0.017",
                    "totalMaintenanceMargin": "0.38106773",
                    "coin": [
                        {
                            "availableToBorrow": "3",
                            "bonus": "0",
                            "accruedInterest": "0",
                            "availableToWithdraw": "0",
                            "totalOrderIM": "0",
                            "equity": "0",
                            "totalPositionMM": "0",
                            "usdValue": "0",
                            "spotHedgingQty": "0.01592413",
                            "unrealisedPnl": "0",
                            "collateralSwitch": true,
                            "borrowAmount": "0.0",
                            "totalPositionIM": "0",
                            "walletBalance": "0",
                            "cumRealisedPnl": "0",
                            "locked": "0",
                            "marginCollateral": true,
                            "coin": "BTC"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672125441042
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/announcement.html b/zh-TW/v5/announcement.html index d93303401c..9c95b2eb6a 100644 --- a/zh-TW/v5/announcement.html +++ b/zh-TW/v5/announcement.html @@ -4,13 +4,13 @@ 查詢公告 | Bybit API Documentation - +

    查詢公告

    HTTP 請求​

    GET /v5/announcements/index

    請求參數​

    參數是否必需類型說明
    localetruestring公告語言標識
    typefalsestring公告類型
    tagfalsestring公告標籤
    pagefalseinteger分頁頁碼. 默認: 1
    limitfalseinteger每頁數據限制. 默認: 20

    響應參數​

    參數類型說明
    totalinteger可查詢公告總署
    listarrayObject
    > titlestring公告標題
    > descriptionstring公告描述
    > typeObject
    >> titlestring公告類型名稱，多語言
    >> keystring公告類型唯一鍵
    > tagsarray<string>公告標籤
    > urlstring公告鏈結
    > dateTimestampnumber作者填寫的時間戳 (毫秒)
    > startDataTimestampnumber事件開始時間戳 (毫秒), 僅當list.type.key == "latest_activities"時有效
    > endDataTimestampnumber事件結束時間戳 (毫秒), 僅當list.type.key == "latest_activities"時有效
    > publishTimenumber公告發出時間戳 (毫秒)

    請求示例​

    GET /v5/announcements/index?locale=en-US&limit=1 HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "total": 569,
            "list": [
                {
                    "title": "Arbitrum(ARB) 即將上線：儲值 250 ARB 即賺 25 USDT，更可解鎖 150,000 USDT 獎池！",
                    "description": "好消息！ ARB 即將上線 Bybit 交易平台！",
                    "type": {
                        "title": "新幣上線",
                        "key": "new_crypto"
                    },
                    "tags": [
                        "Spot",
                        "Spot Listings"
                    ],
                    "url": "https://announcements.bybit.com/zh-TW/article/new-listing-arbitrum-arb-deposit-250-arb-to-earn-25-usdt-share-a-150-000-usdt-prize-pool--bltf662314c211a8616/",
                    "dateTimestamp": 1679045608000,
                    "startDateTimestamp": 1679564008000,
                    "endDateTimestamp": 1680255208000
                }
            ]
        },
        "retExtInfo": {},
        "time": 1679416172335
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/balance/account-coin-balance.html b/zh-TW/v5/asset/balance/account-coin-balance.html index 4421782b5c..7115ea3732 100644 --- a/zh-TW/v5/asset/balance/account-coin-balance.html +++ b/zh-TW/v5/asset/balance/account-coin-balance.html @@ -4,14 +4,14 @@ 查詢帳戶單個幣種餘額 | Bybit API Documentation - +

    查詢帳戶單個幣種餘額

    獲取某帳戶類型下某指定幣種的餘額。支持通過輸入子帳戶id來查詢子帳戶的某個帳戶類型下的某個幣種餘額 同時, 支持查詢母子帳戶、子子帳戶、子母帳戶之間的可劃轉金額，特別是針對於擁有機構借貸的用戶。

    警告
    • 無法通過子賬戶api key獲取主賬戶帳戶餘額
    • 子帳戶只能查詢本身的餘額
    • 母帳戶支持本身和它的子帳戶的餘額

    HTTP 請求​

    GET /v5/asset/transfer/query-account-coin-balance

    請求參數​

    參數是否必需類型說明
    memberIdfalsestring用戶Id. 當查詢子帳號的餘額時，該字段必傳
    toMemberIdfalsestring劃入帳戶UID. 當查詢不同uid間劃轉時, 該字段必傳
    accountTypetruestring帳戶類型
    toAccountTypefalsestring劃入帳戶類型. 當查詢不同帳戶類型間的劃轉時, 該字段必傳
    cointruestring幣種
    withBonusfalseinteger是否查詢體驗金. 0(默認): 不查詢,1: 查詢.
    withTransferSafeAmountfalseinteger是否查詢延遲提幣安全限額
    withLtvTransferSafeAmountfalseinteger特別用於機構借貸用戶, 可以查詢風險水平內的可劃轉餘額
    • 0(default)：false, 1：true
    • 此時toAccountType字段必傳

    響應參數​

    參數類型說明
    accountTypestring賬戶類型
    bizTypeinteger帳戶業務子類型
    accountIdstring賬戶ID
    memberIdstring用戶ID
    balanceObject
    > coinstring幣種類型
    > walletBalancestring錢包余額
    > transferBalancestring可划余額
    > bonusstring可用金額中包含的体验金
    > transferSafeAmountstring可劃轉的安全限額. 若不查詢，則返回""
    > ltvTransferSafeAmountstring機構借貸用戶的可劃轉餘額. 若不查詢，則返回""

    請求示例​

    GET /v5/asset/transfer/query-account-coin-balance?accountType=UNIFIED&coin=USDT&toAccountType=FUND&withLtvTransferSafeAmount=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxx
    X-BAPI-API-KEY: xxxxx
    X-BAPI-TIMESTAMP: 1690254520644
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "accountType": "UNIFIED",
            "bizType": 1,
            "accountId": "1631385",
            "memberId": "1631373",
            "balance": {
                "coin": "USDT",
                "walletBalance": "11999",
                "transferBalance": "11999",
                "bonus": "0",
                "transferSafeAmount": "",
                "ltvTransferSafeAmount": "7602.4861"
            }
        },
        "retExtInfo": {},
        "time": 1690254521256
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/balance/all-balance.html b/zh-TW/v5/asset/balance/all-balance.html index 85298da80d..e6efce759e 100644 --- a/zh-TW/v5/asset/balance/all-balance.html +++ b/zh-TW/v5/asset/balance/all-balance.html @@ -4,13 +4,13 @@ 查詢賬戶所有幣種余額 | Bybit API Documentation - +

    查詢賬戶所有幣種余額

    支持查詢母帳戶的各個帳戶類型的幣種餘額，以及母帳戶下各子帳戶的各個帳戶類型的幣種餘額。

    重要

    無法通過子賬戶api key獲取主賬戶的帳戶餘額

    HTTP 請求​

    GET /v5/asset/transfer/query-account-coins-balance

    請求參數​

    參數是否必須類型說明
    memberIdfalsestring用戶ID. 當使用母帳號api key查詢子帳戶的幣種餘額時，該字段必傳
    accountTypetruestring賬戶類型
    coinfalsestring幣種類型
    withBonusfalseinteger是否查詢體驗金. 0(默認)：不查詢; 1：查詢

    返回參數​

    參數類型說明
    accountTypestring賬戶類型
    memberIdstring用戶ID
    balanceObject
    > coinstring幣種類型
    > walletBalancestring錢包余額
    > transferBalancestring可划余額
    > bonusstring体验金

    請求示例​

    GET /v5/asset/transfer/query-account-coins-balance?accountType=FUND&coin=USDC HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675866354698
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "memberId": "533285",
            "accountType": "FUND",
            "balance": [
                {
                    "coin": "USDT",
                    "transferBalance": "1010",
                    "walletBalance": "1010",
                    "bonus": ""
                },
                {
                    "coin": "USDC",
                    "transferBalance": "0",
                    "walletBalance": "0",
                    "bonus": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1675865290069
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/balance/asset-info.html b/zh-TW/v5/asset/balance/asset-info.html index f52953be45..5d307202bb 100644 --- a/zh-TW/v5/asset/balance/asset-info.html +++ b/zh-TW/v5/asset/balance/asset-info.html @@ -4,13 +4,13 @@ 查詢資產信息 | Bybit API Documentation - +

    查詢資產信息

    信息

    當前只能查詢現貨帳戶中的資產

    HTTP 請求​

    GET /v5/asset/transfer/query-asset-info

    請求參數​

    參數是否必需類型說明
    accountTypetruestring賬戶類型. 僅SPOT
    coinfalsestring幣種

    響應參數​

    參數類型說明
    spotObject
    > statusstring賬戶狀態. ACCOUNT_STATUS_NORMAL: 正常, ACCOUNT_STATUS_UNSPECIFIED: 禁用
    > assetsarrayObject
    >> coinstring幣種
    >> frozenstring掛單凍結金額
    >> freestring可用余額
    >> withdrawstring提現中金額

    請求示例​

    GET /v5/asset/transfer/query-asset-info?accountType=SPOT&coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672136538042
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "spot": {
                "status": "ACCOUNT_STATUS_NORMAL",
                "assets": [
                    {
                        "coin": "ETH",
                        "frozen": "0",
                        "free": "11.53485",
                        "withdraw": ""
                    }
                ]
            }
    },
        "retExtInfo": {},
        "time": 1672136539127
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/balance/delay-amount.html b/zh-TW/v5/asset/balance/delay-amount.html index 6490bfece4..c8038f1a0d 100644 --- a/zh-TW/v5/asset/balance/delay-amount.html +++ b/zh-TW/v5/asset/balance/delay-amount.html @@ -4,13 +4,13 @@ 查詢延遲提幣凍結金額 | Bybit API Documentation - +

    查詢延遲提幣凍結金額

    信息

    如何會導致部分資金被要求延遲提幣？

    • 鏈上充值: 鏈上區塊確認數未達到風險可控程度, 部分資金被凍結一段時間, 直到解凍
    • 買幣: 若存在風險, 則一定時間內被凍結, 無法提幣

    HTTP 請求​

    GET /v5/asset/withdraw/withdrawable-amount

    請求參數​

    參數是否必需類型說明
    cointruestring幣種敏誠

    響應參數​

    參數類型說明
    limitAmountUsdstring延遲提幣凍結金額 (USD)
    withdrawableAmountObject
    > SPOTObject現貨錢包, 若該錢包被移除, 則不會返回該對象
    >> coinstring幣種名稱
    >> withdrawableAmountstring可提現金額
    >> availableBalancestring可用餘額
    > FUNDObject資金錢包
    >> coinstring幣種名稱
    >> withdrawableAmountstring可提現金額
    >> availableBalancestring可用餘額

    請求示例​

    GET /v5/asset/withdraw/withdrawable-amount?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677565621998
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "limitAmountUsd": "52853.5551",
            "withdrawableAmount": {
                "FUND": {
                    "coin": "USDT",
                    "withdrawableAmount": "11135.0596",
                    "availableBalance": "11135.0596"
                },
                "SPOT": {
                    "coin": "USDT",
                    "withdrawableAmount": "0",
                    "availableBalance": "0"
                }
            }
        },
        "retExtInfo": {},
        "time": 1677565632151
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/coin-info.html b/zh-TW/v5/asset/coin-info.html index 6e28ae72f4..a6a43279ac 100644 --- a/zh-TW/v5/asset/coin-info.html +++ b/zh-TW/v5/asset/coin-info.html @@ -4,13 +4,13 @@ 查詢幣種信息 | Bybit API Documentation - +

    查詢幣種信息

    獲取幣種信息，包括鏈信息，是否可充可提

    HTTP 請求​

    GET /v5/asset/coin/query-info

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種

    響應參數​

    參數類型說明
    rowsarrayObject
    > nameinteger幣種名稱
    > coinstring幣種
    > remainAmountstring當前最大可提現數量
    > chainsarrayObject
    >> chainstring鏈名
    >> chainTypestring鏈類型
    >> confirmationstring充值上賬確認數
    >> withdrawFeestring提現手續費. 如果提現費為空，則表示該幣不支持提現
    >> depositMinstring最小充值數量
    >> withdrawMinstring最小提現數量
    >> minAccuracystring充提幣的最小精度
    >> chainDepositstring幣鏈是否可充值. 0: 暫停. 1: 正常
    >> chainWithdrawstring幣鏈是否可提幣. 0: 暫停. 1: 正常
    >> withdrawPercentageFeestring提現手續費百分比. 該字段的值是實際數字，即0.022表示為2.2%

    請求示例​

    GET /v5/asset/coin/query-info?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672194580887
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "rows": [
                {
                    "name": "ETH",
                    "coin": "ETH",
                    "remainAmount": "1020000",
                    "chains": [
                        {
                            "chainType": "ETH",
                            "confirmation": "10000",
                            "withdrawFee": "0.005",
                            "depositMin": "0.01",
                            "withdrawMin": "0.02",
                            "chain": "ETH",
                            "chainDeposit": "1",
                            "chainWithdraw": "1",
                            "minAccuracy": "8",
                            "withdrawPercentageFee": "0.022"
                        },
                        {
                            "chainType": "Arbitrum One",
                            "confirmation": "10",
                            "withdrawFee": "0.01",
                            "depositMin": "0.001",
                            "withdrawMin": "0.1",
                            "chain": "ARBI",
                            "chainDeposit": "1",
                            "chainWithdraw": "1",
                            "minAccuracy": "8",
                            "withdrawPercentageFee": "0"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677478088215
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/convert/apply-quote.html b/zh-TW/v5/asset/convert/apply-quote.html index 99ed91e56c..7d133406d9 100644 --- a/zh-TW/v5/asset/convert/apply-quote.html +++ b/zh-TW/v5/asset/convert/apply-quote.html @@ -4,13 +4,13 @@ 申請報價 | Bybit API Documentation - +

    申請報價

    HTTP 請求​

    POST /v5/asset/exchange/quote-apply

    請求參數​

    參數是否必需類型說明
    fromCointruestring兌出幣種
    toCointruestring兌入幣種
    fromCoinTypefalsestringcrypto
    toCoinTypefalsestringcrypto
    requestCointruestring請求報價幣種, 和兌出幣種保持一致
  • 未來, 可能會支援requestCoin=兌入幣種
    • requestAmounttruestring請求報價幣種數量
    accountTypetruestring帳戶類型
    paramTypefalsestringopFrom, 主要用於API broker
    paramValuefalsestringBroker ID, 主要用於API broker
    requestIdfalsestring自定義的請求ID
  • 最長不超過36位的字符串
  • 一般來說該字段無用, 可用於內部追蹤這次報價請求

    • 響應參數​

    參數類型說明
    quoteTxIdstring報價單號. 由系統生成, 用於後面的確認報價和查詢
    exchangeRatestring兌換率
    fromCoinstring兌出幣種
    fromCoinTypestring兌出幣種類型. crypto
    toCoinstring兌入幣種
    toCoinTypestring兌入幣種類型. crypto
    fromAmountstring兌出幣種數量
    toAmountstring兌入幣種數量
    expiredTimestring報價單過期的時間戳(有效期為15秒)
    requestIdstring自定義請求ID

    請求示例​

    POST /v5/asset/exchange/quote-apply HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720071077014
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json
    Content-Length: 172

    {
        "requestId": "test-00002",
        "fromCoin": "ETH",
        "toCoin": "BTC",
        "accountType": "eb_convert_funding",
        "requestCoin": "ETH",
        "requestAmount": "0.1",
        "paramType": "opFrom",
        "paramValue": "broker-id-001"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "quoteTxId": "10100108106409340067234418688",
            "exchangeRate": "0.053517914861880000",
            "fromCoin": "ETH",
            "fromCoinType": "crypto",
            "toCoin": "BTC",
            "toCoinType": "crypto",
            "fromAmount": "0.1",
            "toAmount": "0.005351791486188000",
            "expiredTime": "1720071092225",
            "requestId": "test-00002"
        },
        "retExtInfo": {},
        "time": 1720071077265
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/convert/confirm-quote.html b/zh-TW/v5/asset/convert/confirm-quote.html index 0fb9c2e17b..0021275b55 100644 --- a/zh-TW/v5/asset/convert/confirm-quote.html +++ b/zh-TW/v5/asset/convert/confirm-quote.html @@ -4,13 +4,13 @@ 確認報價 | Bybit API Documentation - +

    確認報價

    信息
    1. 該接口是異步的, 請通過查詢請求確認最終兌換結果
    2. 確保您在報價單過期前確認該報價, 否則失效

    HTTP 請求​

    POST /v5/asset/exchange/convert-execute

    請求參數​

    參數是否必需類型說明
    quoteTxIdtruestring報價單ID, 來自於提交報價的響應

    響應參數​

    參數類型說明
    quoteTxIdstring報價單ID
    exchangeStatusstring兌換狀態
  • init
  • processing
  • success
  • failure

    • 請求示例​

    POST /v5/asset/exchange/convert-execute HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720071899789
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 52

    {
        "quoteTxId": "10100108106409343501030232064"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "exchangeStatus": "processing",
            "quoteTxId": "10100108106409343501030232064"
        },
        "retExtInfo": {},
        "time": 1720071900529
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/convert/convert-coin-list.html b/zh-TW/v5/asset/convert/convert-coin-list.html index 9af994522d..39514f7528 100644 --- a/zh-TW/v5/asset/convert/convert-coin-list.html +++ b/zh-TW/v5/asset/convert/convert-coin-list.html @@ -4,13 +4,13 @@ 查詢兌換幣種列表 | Bybit API Documentation - +

    查詢兌換幣種列表

    您可以通過該接口獲取到各個帳戶內的兌入兌出幣種列表

    HTTP 請求​

    GET /v5/asset/exchange/query-coin-list

    請求參數​

    參數是否必需類型說明
    coinfalsestring兌出幣種
  • 當side=0時, 該字段會被忽略
    • sidefalseinteger0: 查詢兌出幣種列表, 會返回幣種餘額
    1: 有傳coin的話, 會根據兌出幣種查詢支持的兌入幣種列表
    accountTypetruestring錢包類型
  • eb_convert_funding
  • eb_convert_uta
  • eb_convert_spot
  • eb_convert_contract
  • eb_convert_inverse

    • 響應參數​

    參數類型說明
    coinsarray<object>幣種信息
    > coinstring幣種
    > fullNamestring完整幣種名
    > iconstring幣種圖標url
    > iconNightstring幣種圖標url (夜間模式)
    > accuracyLengthinteger幣種精度
    > coinTypestring幣種類型. crypto(加密貨幣)
    > balancestring幣種餘額
  • 只有當side=0時, 會返回餘額, 否則, 返回""
    • > uBalancestring幣種折成USDT的價值
    > singleFromMinLimitstring單筆交易最小兌出幣種數量
    > singleFromMaxLimitstring單筆交易最大兌出幣種數量
    > disableFrombooleantrue: 該幣種禁止兌出, false: 該幣種允許兌出
    > disableTobooleantrue: 該幣入禁止兌出, false: 該幣種允許兌入
    > timePeriodinteger保留字段, 當前可忽略
    > singleToMinLimitstring保留字段, 當前可忽略
    > singleToMaxLimitstring保留字段, 當前可忽略
    > dailyFromMinLimitstring保留字段, 當前可忽略
    > dailyFromMaxLimitstring保留字段, 當前可忽略保留字段, 當前可忽略
    > dailyToMinLimitstring保留字段, 當前可忽略
    > dailyToMaxLimitstring保留字段, 當前可忽略

    請求示例​

    GET /v5/asset/exchange/query-coin-list?side=0&accountType=eb_convert_funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720064061248
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "coins": [
                {
                    "coin": "BTC",
                    "fullName": "BTC",
                    "icon": "https://t1.bycsi.com/app/assets/token/0717b8c28c2373bf714c964195411d0f.svg",
                    "iconNight": "https://t1.bycsi.com/app/assets/token/9504b4c841194cc38f04041003ffbfdb.svg",
                    "accuracyLength": 8,
                    "coinType": "crypto",
                    "balance": "0",
                    "uBalance": "0",
                    "timePeriod": 0,
                    "singleFromMinLimit": "0.001",
                    "singleFromMaxLimit": "1",
                    "singleToMinLimit": "0",
                    "singleToMaxLimit": "0",
                    "dailyFromMinLimit": "0",
                    "dailyFromMaxLimit": "0",
                    "dailyToMinLimit": "0",
                    "dailyToMaxLimit": "0",
                    "disableFrom": false,
                    "disableTo": false
                },
                ...
                {
                    "coin": "SOL",
                    "fullName": "SOL",
                    "icon": "https://s1.bycsi.com/app/assets/token/87ca5f1ca7229bdf0d9a16435653007c.svg",
                    "iconNight": "https://t1.bycsi.com/app/assets/token/383a834046655ffe5ef1be1a025791cc.svg",
                    "accuracyLength": 8,
                    "coinType": "crypto",
                    "balance": "18.05988133",
                    "uBalance": "2458.46990211775033220586588327",
                    "timePeriod": 0,
                    "singleFromMinLimit": "0.1",
                    "singleFromMaxLimit": "1250",
                    "singleToMinLimit": "0",
                    "singleToMaxLimit": "0",
                    "dailyFromMinLimit": "0",
                    "dailyFromMaxLimit": "0",
                    "dailyToMinLimit": "0",
                    "dailyToMaxLimit": "0",
                    "disableFrom": false,
                    "disableTo": false
                },
                ...
                {
                    "coin": "ETH",
                    "fullName": "ETH",
                    "icon": "https://s1.bycsi.com/app/assets/token/d6c17c9e767e1810875c702d86ac9f32.svg",
                    "iconNight": "https://t1.bycsi.com/app/assets/token/9613ac8e7d62081f4ca20488ae5b168d.svg",
                    "accuracyLength": 8,
                    "coinType": "crypto",
                    "balance": "0.80264489",
                    "uBalance": "2596.09751650032773106431534138",
                    "timePeriod": 0,
                    "singleFromMinLimit": "0.01",
                    "singleFromMaxLimit": "250",
                    "singleToMinLimit": "0",
                    "singleToMaxLimit": "0",
                    "dailyFromMinLimit": "0",
                    "dailyFromMaxLimit": "0",
                    "dailyToMinLimit": "0",
                    "dailyToMaxLimit": "0",
                    "disableFrom": false,
                    "disableTo": false
                }
            ]
        },
        "retExtInfo": {},
        "time": 1720064061736
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/convert/get-convert-history.html b/zh-TW/v5/asset/convert/get-convert-history.html index 8cafadea5b..21cf8ad587 100644 --- a/zh-TW/v5/asset/convert/get-convert-history.html +++ b/zh-TW/v5/asset/convert/get-convert-history.html @@ -4,13 +4,13 @@ 查詢兌換歷史 | Bybit API Documentation - +

    查詢兌換歷史

    那些被確認的報價單, 不管最終狀態如何, 該接口都會返回

    信息

    僅返回通過open api進行兌換的歷史紀錄

    HTTP 請求​

    GET /v5/asset/exchange/query-convert-history

    請求參數​

    參數是否必需類型說明
    accountTypefalsestring錢包類型
  • 支持傳遞多個, 用逗號分開 比如, eb_convert_funding,eb_convert_uta
  • 當不傳時, 默認返回所有錢包
    • indexfalseinteger頁碼
  • 從1開始
  • 不傳時, 默認返回第一頁
    • limitfalseinteger每頁數量
  • 默認20條
  • 最多支持100條, 大於100, 按照100返回

    • 響應參數​

    參數類型說明
    listarray<object>報價單列表
    > accountTypestring錢包類型
    > exchangeTxIdstring報價單ID, 和quoteTxId保持一致
    > userIdstring用戶ID
    > fromCoinstring兌出幣種
    > fromCoinTypestring兌出幣種類型. crypto
    > toCoinstring兌入幣種
    > toCoinTypestring兌入幣種類型. crypto
    > fromAmountstring兌出幣種數量
    > toAmountstring兌入幣種數量
    > exchangeStatusstring兌換狀態
  • init
  • processing
  • success
  • failure
    • > extInfoobject
    >> paramTypestring如果您在申請報價接口中中有發送該字段, 則這裡會釋出該字段
    >> paramValuestring如果您在申請報價接口中中有發送該字段, 則這裡會釋出該字段
    > convertRatestring兌換率
    > createdAtstring報價單創建時間

    請求示例​

    GET /v5/asset/exchange/query-convert-history?accountType=eb_convert_uta,eb_convert_funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720074159814
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "list": [
                {
                    "accountType": "eb_convert_funding",
                    "exchangeTxId": "10100108106409343501030232064",
                    "userId": "XXXXX",
                    "fromCoin": "ETH",
                    "fromCoinType": "crypto",
                    "fromAmount": "0.1",
                    "toCoin": "BTC",
                    "toCoinType": "crypto",
                    "toAmount": "0.00534882723991",
                    "exchangeStatus": "success",
                    "extInfo": {
                        "paramType": "opFrom",
                        "paramValue": "broker-id-001"
                    },
                    "convertRate": "0.0534882723991",
                    "createdAt": "1720071899995"
                },
                {
                    "accountType": "eb_convert_uta",
                    "exchangeTxId": "23070eb_convert_uta408933875189391360",
                    "userId": "XXXXX",
                    "fromCoin": "BTC",
                    "fromCoinType": "crypto",
                    "fromAmount": "0.1",
                    "toCoin": "ETH",
                    "toCoinType": "crypto",
                    "toAmount": "1.773938248611074",
                    "exchangeStatus": "success",
                    "extInfo": {},
                    "convertRate": "17.73938248611074",
                    "createdAt": "1719974243256"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1720074457715
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/convert/get-convert-result.html b/zh-TW/v5/asset/convert/get-convert-result.html index 0f4ff35463..34e9909320 100644 --- a/zh-TW/v5/asset/convert/get-convert-result.html +++ b/zh-TW/v5/asset/convert/get-convert-result.html @@ -4,13 +4,13 @@ 查詢報價單狀態 | Bybit API Documentation - +

    查詢報價單狀態

    信息
    • 您可以通過quoteTxId指定查詢某筆被確認的報價單
    • 確保傳入匹配的錢包類型和報價單號, 否則會查不到

    HTTP 請求​

    GET /v5/asset/exchange/convert-result-query

    請求參數​

    參數是否必需類型說明
    quoteTxIdtruestring報價單號
    accountTypetruestring錢包類型

    響應參數​

    參數類型說明
    resultobject
    > accountTypestring錢包類型
    > exchangeTxIdstring報價單ID, 和quoteTxId保持一致
    > userIdstring用戶ID
    > fromCoinstring兌出幣種
    > fromCoinTypestring兌出幣種類型. crypto
    > toCoinstring兌入幣種
    > toCoinTypestring兌入幣種類型. crypto
    > fromAmountstring兌出幣種數量
    > toAmountstring兌入幣種數量
    > exchangeStatusstring兌換狀態
  • init
  • processing
  • success
  • failure
    • > extInfoobject保留字段, 當前可忽略
    > convertRatestring兌換率
    > createdAtstring報價單創建時間

    請求示例​

    GET /v5/asset/exchange/convert-result-query?quoteTxId=10100108106409343501030232064&accountType=eb_convert_funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720073659847
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "ok",
        "result": {
            "result": {
                "accountType": "eb_convert_funding",
                "exchangeTxId": "10100108106409343501030232064",
                "userId": "XXXXX",
                "fromCoin": "ETH",
                "fromCoinType": "crypto",
                "fromAmount": "0.1",
                "toCoin": "BTC",
                "toCoinType": "crypto",
                "toAmount": "0.00534882723991",
                "exchangeStatus": "success",
                "extInfo": {},
                "convertRate": "0.0534882723991",
                "createdAt": "1720071899995"
            }
        },
        "retExtInfo": {},
        "time": 1720073660696
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/convert/guideline.html b/zh-TW/v5/asset/convert/guideline.html index 6c299a4e9c..0e6bbae63c 100644 --- a/zh-TW/v5/asset/convert/guideline.html +++ b/zh-TW/v5/asset/convert/guideline.html @@ -4,13 +4,13 @@ 閃兌接入指南 | Bybit API Documentation - +

    閃兌接入指南

    信息
    • 所有接口都需要進行鑒權
    • API key的權限要求: "兌換"

    流程​

    Step1 查詢兌換幣種列表​

    • 查詢不同錢包內的支持的兌入兌出幣種列表
    • 當查詢兌出幣種列表時, 會有幣種餘額返回

    Step2 申請報價​

    • 選擇兌出幣種, 兌入幣種, 錢包類型, 設定號兌出幣種的數量來獲取報價
    • 該階段會核驗餘額

    Step3 確認報價​

    • 在有效時間內確認報價 (15秒). 一旦確認, 系統會處理交易
    • 該操作環節是異步的, 所以當餘額被劃轉出去後, 最終兌換可能會失敗

    Step4 查詢報價單狀態​

    在確認報價後, 通過該接口查詢最終報價單的處理狀態

    錯誤碼​

    錯誤碼消息備註
    790000system error, please try again later系統繁忙
    700000parameter error參數錯誤
    700001quote fail: no deler can be used
    700002quote fial: not support quote type在提交報價時, requestCoin=兌入幣種, 會返回該錯誤
    700003order status not allowed
    700004order does not exit1. 檢查quoteTxId是否正確; 2. 檢查quoteTxId和accountType是否匹配
    700005Your available balance is insufficient or wallet does not exist
    700006Low amount limit請求的數量小於minFromCoinLimit
    700007Large amount limit請求的數量大於maxFromCoinLimit
    700008quote fail: price time out1. 報價單已經失效; 2.傳入quoteTxId不正確
    700009quoteTxId has already been used在報價單有效期內, 同一個quoteTxId多次請求確認接口
    700010INS loan user cannot perform conversion
    700011illegal operation當提交報價的是用戶A, 確認報價的是用戶B

    API頻率​

    方法路徑頻率是否可提升
    GET/v5/asset/exchange/query-coin-list100 req/sN
    POST/v5/asset/exchange/quote-apply50 req/sN
    POST/v5/asset/exchange/convert-execute50 req/sN
    GET/v5/asset/exchange/convert-result-query100 req/sN
    GET/v5/asset/exchange/query-convert-history100 req/sN
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/delivery.html b/zh-TW/v5/asset/delivery.html index a32f470dda..bbc9162f76 100644 --- a/zh-TW/v5/asset/delivery.html +++ b/zh-TW/v5/asset/delivery.html @@ -4,13 +4,13 @@ 查詢交割紀錄 | Bybit API Documentation - +

    查詢交割紀錄

    查詢USDC交割和期權的交割紀錄, 返回結果按照deliveryTime降序排列

    統一帳戶覆蓋範圍: USDC交割 / 期權

    HTTP 請求​

    GET /v5/asset/delivery-record

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option
    symbolfalsestring合約名稱
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近30天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 30天
    • 若只傳startTime，則查詢startTime和startTime+30天的數據
    • 若只傳endTime，則查詢endTime-30天和endTime的數據
    endTimefalseinteger結束時間 (毫秒)
    expDatefalsestring過期日. 格式示例: 25MAR22. 默認: 返回所有日期數據
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > deliveryTimenumber交割時間戳 (毫秒)
    > symbolstring合約名稱
    > sidestringBuy,Sell
    > positionstring交割數量
    > deliveryPricestring交割價格
    > strikestring行權價
    > feestring手續費，正數表支出，負數表收取
    > deliveryRplstring交割已實現盈虧
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/asset/delivery-record?expDate=29DEC22&category=option HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672362112944
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "132791%3A0%2C132791%3A0",
            "category": "option",
            "list": [
                {
                    "symbol": "BTC-29DEC22-16000-P",
                    "side": "Buy",
                    "deliveryTime": 1672300800860,
                    "strike": "16000",
                    "fee": "0.00000000",
                    "position": "0.01",
                    "deliveryPrice": "16541.86369547",
                    "deliveryRpl": "3.5"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672362116184
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/deposit/deposit-coin-spec.html b/zh-TW/v5/asset/deposit/deposit-coin-spec.html index ad6c798739..f97dd93e5f 100644 --- a/zh-TW/v5/asset/deposit/deposit-coin-spec.html +++ b/zh-TW/v5/asset/deposit/deposit-coin-spec.html @@ -4,13 +4,13 @@ 查詢支持的充值幣種信息 | Bybit API Documentation - +

    查詢支持的充值幣種信息

    通過幣種信息接口，獲取幣鏈組合

    提示

    該接口不需要做鑒權

    HTTP 請求​

    GET /v5/asset/deposit/query-allowed-list

    請求參數​

    參數是否必需類型說明
    coinfalsestring充值幣種. coin和chain必須配對傳遞，否則是無效查詢
    chainfalsestring充值鏈名. coin 和 chain必須配對傳遞，否則是無效查詢
    limitfalseinteger每頁數量限制. [1, 35]. 默認: 10
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    configListarrayObject
    > coinstring幣種
    > chainstring鏈名
    > coinShowNamestring幣種名稱
    > chainTypestring鏈的類型
    > blockConfirmNumberinteger充值上賬確認數
    > minDepositAmountstring最低充值金額
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/asset/deposit/query-allowed-list?coin=ETH&chain=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672191495968
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "configList": [
                {
                    "coin": "ETH",
                    "chain": "ETH",
                    "coinShowName": "ETH",
                    "chainType": "ETH",
                    "blockConfirmNumber": 10000,
                    "minDepositAmount": "0.01"
                }
            ],
            "nextPageCursor": "eyJwYWdlIjoyLCJsaW1pdCI6MTB9"
        },
        "retExtInfo": {},
        "time": 1672191496219
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/deposit/deposit-record.html b/zh-TW/v5/asset/deposit/deposit-record.html index 0cd70507aa..ff6a0d8ade 100644 --- a/zh-TW/v5/asset/deposit/deposit-record.html +++ b/zh-TW/v5/asset/deposit/deposit-record.html @@ -4,13 +4,13 @@ 查詢充值紀錄 (鏈上) | Bybit API Documentation - +

    查詢充值紀錄 (鏈上)

    提示
    • endTime - startTime需要小於等於30天，默認查詢最近30天的紀錄
    • 支持母子帳號的API key查詢各自的充值紀錄

    HTTP 請求​

    GET /v5/asset/deposit/query-record

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    rowsarrayObject
    > coinstring幣種
    > chainstring鏈名
    > amountstring充值金額
    > txIDstring交易Id. 充值失敗或取消充值時為空
    > statusinteger充值狀態
    > toAddressstring充值的目標地址
    > tagstring充值目標地址的tag
    > depositFeestring充值手續費
    > successAtstring最後更新時間
    > confirmationsstring确认区块的数量
    > txIndexstring交易序列号
    > blockHashstring鏈上的哈希數
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制
    > depositTypestring入金類型. 0: 正常充值, 10: 充值觸發每日限額, 20: 異常充值
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/asset/deposit/query-record?coin=USDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672191991544
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "10000",
                    "txID": "skip-notification-scene-test-amount-202212270944-533285-USDT",
                    "status": 3,
                    "toAddress": "test-amount-address",
                    "tag": "",
                    "depositFee": "",
                    "successAt": "1672134274000",
                    "confirmations": "10000",
                    "txIndex": "",
                    "blockHash": "",
                    "batchReleaseLimit": "-1",
                    "depositType": "0"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTA0NjA0MywibWF4SUQiOjEwNDYwNDN9"
        },
        "retExtInfo": {},
        "time": 1672191992512
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/deposit/internal-deposit-record.html b/zh-TW/v5/asset/deposit/internal-deposit-record.html index 23e0a102c9..6fb88025fd 100644 --- a/zh-TW/v5/asset/deposit/internal-deposit-record.html +++ b/zh-TW/v5/asset/deposit/internal-deposit-record.html @@ -4,13 +4,13 @@ 查詢充值記錄 (平台转账) | Bybit API Documentation - +

    查詢充值記錄 (平台转账)

    查詢Bybit平台內部充值紀錄

    規則
  • 開始時間和截止時間差最大限制為30天
  • 支持使用母、子帳戶的api key查詢各自的入金紀錄

    • HTTP 請求​

    GET /v5/asset/deposit/query-internal-record

    請求參數​

    參數是否必須類型說明
    txIDfalsestring內部轉帳交易ID
    startTimefalseinteger開始時間 (精確到毫秒)。 默認為當前時間之前30天
    endTimefalseinteger結束時間 (精確到毫秒)。 默認為當前時間
    coinfalsestring幣種名：舉例，BTC。默認全部
    cursorfalsestring游標信息：用來分頁。 默認空
    limitfalseinteger每頁條數, [1, 50] 默認為50

    返回參數​

    參數類型說明
    rowsarrayObject
    > idstringID
    > typeinteger1: 內部充值
    > coinstring充值的幣種
    > amountstring充值的數量
    > txIDstring交易ID。充值失敗/取消充值：為空
    > statusinteger
    • 1=處理中
    • 2=已完成
    • 3=充值失敗
    > addressstring郵箱地址或者手機號
    > createdTimestring充值創建時間戳
    txIDstring內部轉帳交易ID
    nextPageCursorstring游標信息：用來分頁

    請求示例​

    GET /v5/asset/deposit/query-internal-record HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682099024473
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "id": "1103",
                    "amount": "0.1",
                    "type": 1,
                    "coin": "ETH",
                    "address": "xxxx***@gmail.com",
                    "status": 2,
                    "createdTime": "1705393280",
                    "txID": "77c37e5c-d9fa-41e5-bd13-c9b59d95"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTEwMywibWF4SUQiOjExMDN9"
        },
        "retExtInfo": {},
        "time": 1705395632689
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/deposit/master-deposit-addr.html b/zh-TW/v5/asset/deposit/master-deposit-addr.html index 6d6c82a263..053676fc9e 100644 --- a/zh-TW/v5/asset/deposit/master-deposit-addr.html +++ b/zh-TW/v5/asset/deposit/master-deposit-addr.html @@ -4,13 +4,13 @@ 查詢主帳號充值地址 | Bybit API Documentation - +

    查詢主帳號充值地址

    警告

    僅支持母帳號API key

    HTTP 請求​

    GET /v5/asset/deposit/query-address

    請求參數​

    參數是否必需類型說明
    cointruestring幣種
    chainTypefalsestring請使用查詢幣種信息響應字段>> chain作為這個字段的輸入

    響應參數​

    參數類型說明
    coinstring幣種
    chainsarrayObject
    > chainTypestring鏈類型
    > addressDepositstring充值地址
    > tagDepositstring地址的tag
    > chainstring鏈名
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制

    請求示例​

    GET /v5/asset/deposit/query-address?coin=USDT&chainType=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672192792371
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "USDT",
            "chains": [
                {
                    "chainType": "ERC20",
                    "addressDeposit": "0xd9e1cd77afa0e50b452a62fbb68a3340602286c3",
                    "tagDeposit": "",
                    "chain": "ETH",
                    "batchReleaseLimit": "-1"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672192792860
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/deposit/set-deposit-acct.html b/zh-TW/v5/asset/deposit/set-deposit-acct.html index 46eab7ded9..030b696fca 100644 --- a/zh-TW/v5/asset/deposit/set-deposit-acct.html +++ b/zh-TW/v5/asset/deposit/set-deposit-acct.html @@ -4,13 +4,13 @@ 設置充值帳戶 | Bybit API Documentation - +

    設置充值帳戶

    設置充值後的自動轉入帳戶類型。該功能與網頁端-設置-充值保持一致。

    信息
    • 資金會默認充值至資金帳戶, 通過該接口設置自動劃轉帳戶後，系統將會自動劃轉至目標帳戶。
    • 僅支持主帳號調用。
    提示
    • 統一交易帳戶(UTA)擁有FUND, UNIFIED, CONTRACT(反向期貨錢包)
    • 經典帳戶擁有FUND, CONTRACT(期貨錢包), SPOT

    HTTP 請求​

    POST /v5/asset/deposit/deposit-to-account

    請求參數​

    參數是否必須類型說明
    accountTypetruestring帳戶類型
    • UNIFIED
    • SPOT
    • CONTRACT
    • FUND

    返回參數​

    參數類型說明
    statusinteger請求狀態:
    • 1: 修改成功
    • 0: 修改失敗

    請求示例​

    POST /v5/asset/deposit/deposit-to-account HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676887913670
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
        "accountType": "CONTRACT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "status": 1
        },
        "retExtInfo": {},
        "time": 1676887914363
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/deposit/sub-deposit-addr.html b/zh-TW/v5/asset/deposit/sub-deposit-addr.html index d27ae79ddd..695d8dc731 100644 --- a/zh-TW/v5/asset/deposit/sub-deposit-addr.html +++ b/zh-TW/v5/asset/deposit/sub-deposit-addr.html @@ -4,13 +4,13 @@ 查詢子帳號充值地址 | Bybit API Documentation - +

    查詢子帳號充值地址

    警告

    僅能使用該母帳號的API key

    HTTP 請求​

    GET /v5/asset/deposit/query-sub-member-address

    請求參數​

    參數是否必需類型說明
    cointruestring幣種
    chainTypetruestring請使用查詢幣種信息響應字段chain作為這個字段的輸入
    subMemberIdtruestring子帳號Id

    響應參數​

    參數類型說明
    coinstring幣種
    chainsarrayObject
    > chainTypestring鏈類型
    > addressDepositstring充值地址
    > tagDepositstring地址的tag
    > chainstring鏈名
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制

    請求示例​

    GET /v5/asset/deposit/query-sub-member-address?coin=USDT&chainType=TRX&subMemberId=592334 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672194349421
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "USDT",
            "chains": {
                    "chainType": "TRC20",
                    "addressDeposit": "TCB6NmwGXjn8eJYDuPxLvs4aM8Jn7gvJ1f",
                    "tagDeposit": "",
                    "chain": "TRX",
                    "batchReleaseLimit": "-1"
                }
            },
        "retExtInfo": {},
        "time": 1672194350819
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/deposit/sub-deposit-record.html b/zh-TW/v5/asset/deposit/sub-deposit-record.html index 7864058156..769b155b06 100644 --- a/zh-TW/v5/asset/deposit/sub-deposit-record.html +++ b/zh-TW/v5/asset/deposit/sub-deposit-record.html @@ -4,13 +4,13 @@ 查詢子帳號的充值紀錄 (鏈上) | Bybit API Documentation - +

    查詢子帳號的充值紀錄 (鏈上)

    僅能通過主帳號的API key來查詢子帳號的充值紀錄

    提示
    • endTime - startTime 需要小於等於30天. 默認查詢最近30天的紀錄

    HTTP 請求​

    GET /v5/asset/deposit/query-sub-member-record

    請求參數​

    參數是否必需類型說明
    subMemberIdtruestring子帳號
    coinfalsestring幣種
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    rowsarrayObject
    > coinstring幣種
    > chainstring鏈名
    > amountstring充值金額
    > txIDstring交易Id. 充值失敗或取消充值時為空
    > statusinteger充值狀態
    > toAddressstring充值的目標地址
    > tagstring充值目標地址的tag
    > depositFeestring充值手續費
    > successAtstring最後更新時間
    > confirmationsstring确认区块的数量
    > txIndexstring交易序列号
    > blockHashstring鏈上的哈希數
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制
    > depositTypestring入金類型. 0: 正常充值, 10: 充值觸發每日限額, 20: 異常充值
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/asset/deposit/query-sub-member-record?coin=USDT&limit=1&subMemberId=592334 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672192441294
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1672192441742
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/exchange.html b/zh-TW/v5/asset/exchange.html index 5513de36d3..9b25f3e6ab 100644 --- a/zh-TW/v5/asset/exchange.html +++ b/zh-TW/v5/asset/exchange.html @@ -4,13 +4,13 @@ 查詢兌換訂單紀錄 | Bybit API Documentation - +

    查詢兌換訂單紀錄

    警告

    您可能會遭遇較長的數據返回延遲

    HTTP 請求​

    GET /v5/asset/exchange/order-record

    請求參數​

    參數是否必需類型說明
    fromCoinfalsestring兌出幣種. e.g,BTC
    toCoinfalsestring兌入幣種. e.g,USDT
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 10
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    nextPageCursorstring游標，用於翻頁
    orderBodyarrayObject
    > fromCoinstring兌出幣種
    > fromAmountstring兌出金額
    > toCoinstring兌入幣種
    > toAmountstring兌入金額
    > exchangeRatestring兌換匯率
    > createdTimestring兌換創建時間戳 (秒)
    > exchangeTxIdstring兌換訂單號

    請求示例​

    GET /v5/asset/exchange/order-record?limit=10 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672990462492
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderBody": [
                {
                    "fromCoin": "BTC",
                    "fromAmount": "0.100000000000000000",
                    "toCoin": "ETH",
                    "toAmount": "1.385866230000000000",
                    "exchangeRate": "13.858662380000000000",
                    "createdTime": "1672197760",
                    "exchangeTxId": "145102533285208544812654440448"
                }
            ],
            "nextPageCursor": "173341:1672197760"
        },
        "retExtInfo": {},
        "time": 1672990464021
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/settlement.html b/zh-TW/v5/asset/settlement.html index 8813974b09..51123eb5a0 100644 --- a/zh-TW/v5/asset/settlement.html +++ b/zh-TW/v5/asset/settlement.html @@ -4,13 +4,13 @@ 查詢USDC結算紀錄 | Bybit API Documentation - +

    查詢USDC結算紀錄

    查詢USDC永續的結算紀錄

    統一帳戶覆蓋範圍: USDC永續 / USDC交割

    HTTP 請求​

    GET /v5/asset/settlement-record

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear
    symbolfalsestring合約名稱
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近30天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 30天
    • 若只傳startTime，則查詢startTime和startTime+30天的數據
    • 若只傳endTime，則查詢endTime-30天和endTime的數據
    endTimefalseinteger結束時間 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > sidestringBuy,Sell
    > sizestring倉位大小
    > sessionAvgPricestring結算價格
    > markPricestring標記價格
    > realisedPnlstring已實現盈虧
    > createdTimestring結算時間 (毫秒)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/asset/settlement-record?category=linear HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672284883483
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "116952%3A1%2C116952%3A1",
            "category": "linear",
            "list": [
                {
                    "realisedPnl": "-71.28",
                    "symbol": "BTCPERP",
                    "side": "Buy",
                    "markPrice": "16620",
                    "size": "1.5",
                    "createdTime": "1672214400000",
                    "sessionAvgPrice": "16620"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672284884285
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/sub-uid-list.html b/zh-TW/v5/asset/sub-uid-list.html index c30f6538ca..4f8e5f5c03 100644 --- a/zh-TW/v5/asset/sub-uid-list.html +++ b/zh-TW/v5/asset/sub-uid-list.html @@ -4,13 +4,13 @@ 查詢子帳號列表 | Bybit API Documentation - +

    查詢子帳號列表

    查詢某個母帳戶的子帳號列表, 返回至多2000個子帳戶, 如果您有更多, 可以調用這個接口.

    警告

    僅支持母帳號API key

    HTTP 請求​

    GET /v5/asset/transfer/query-sub-member-list

    請求參數​

    無

    響應參數​

    參數類型說明
    subMemberIdsarray<string>所有子帳號
    transferableSubMemberIdsarray<string>已經開啟了萬能劃轉的子帳號

    請求示例​

    GET /v5/asset/transfer/query-sub-member-list HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672147239931
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "subMemberIds": [
                "554117",
                "592324",
                "592334",
                "1055262",
                "1072055",
                "1119352"
            ],
            "transferableSubMemberIds": [
                "554117",
                "592324"
            ]
        },
        "retExtInfo": {},
        "time": 1672147241320
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/transfer/create-inter-transfer.html b/zh-TW/v5/asset/transfer/create-inter-transfer.html index 5187751027..a296d84e6d 100644 --- a/zh-TW/v5/asset/transfer/create-inter-transfer.html +++ b/zh-TW/v5/asset/transfer/create-inter-transfer.html @@ -4,13 +4,13 @@ 劃轉 (單帳號內) | Bybit API Documentation - +

    劃轉 (單帳號內)

    創建單帳號下帳戶類型間的劃轉操作

    提示
    • 每個帳戶類型有其可接受的幣種限制, 比如, 你無法將USDC從SPOT劃轉至CONTRACT。詳情請參考可劃轉幣種接口.
    • 資金賬戶轉出目前僅支持加密貨幣，不支持法定貨幣.

    HTTP 請求​

    POST /v5/asset/transfer/inter-transfer

    請求參數​

    參數是否必需類型說明
    transferIdtruestringUUID. 請自行手動生成UUID
    cointruestring幣種
    amounttruestring劃入數量
    fromAccountTypetruestring轉出賬戶類型
    toAccountTypetruestring轉入賬戶類型

    響應參數​

    參數類型說明
    transferIdstringUUID
    statusstring劃轉狀態
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

    • 請求示例​

    POST v5/asset/transfer/inter-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670986690556
    X-BAPI-RECV-WINDOW: 50000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json
    {
        "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb16",
        "coin": "BTC",
        "amount": "0.05",
        "fromAccountType": "UNIFIED",
        "toAccountType": "CONTRACT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbab16",
            "status": "SUCCESS"
        },
        "retExtInfo": {},
        "time": 1670986962783
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/transfer/inter-transfer-list.html b/zh-TW/v5/asset/transfer/inter-transfer-list.html index fd5b28bfdd..a40414d017 100644 --- a/zh-TW/v5/asset/transfer/inter-transfer-list.html +++ b/zh-TW/v5/asset/transfer/inter-transfer-list.html @@ -4,13 +4,13 @@ 查詢劃轉紀錄 (單帳號內) | Bybit API Documentation - +

    查詢劃轉紀錄 (單帳號內)

    獲取單帳號內的劃轉紀錄

    信息

    當startTime & endTime都不傳入時, API默認返回30天的數據

    HTTP 請求​

    GET /v5/asset/transfer/query-inter-transfer-list

    請求參數​

    參數是否必需類型說明
    transferIdfalsestringUUID. 使用創建劃轉時用的UUID
    coinfalsestring幣種
    statusfalsestring劃轉狀態
    startTimefalseinteger開始時間戳 (毫秒) 注意: 實際查詢時是秒級維度生效
    endTimefalseinteger結束時間戳 (毫秒) 注意: 實際查詢時是秒級維度生效
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > transferIdstring劃轉Id
    > coinstring劃轉幣種
    > amountstring劃轉金額
    > fromAccountTypestring劃出賬戶類型
    > toAccountTypestring劃入賬戶類型
    > timestampstring劃轉創建時間戳 (毫秒)
    > statusstring劃轉狀態
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/asset/transfer/inter-transfer-list-query?coin=USDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1670988271299
    X-BAPI-RECV-WINDOW: 50000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
        "list": [
            {
                "transferId": "selfTransfer_a1091cc7-9364-4b74-8de1-18f02c6f2d5c",
                "coin": "USDT",
                "amount": "5000",
                "fromAccountType": "SPOT",
                "toAccountType": "UNIFIED",
                "timestamp": "1667283263000",
                "status": "SUCCESS"
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MTM1ODQ2OCwibWF4SUQiOjEzNTg0Njh9"
    },
        "retExtInfo": {},
        "time": 1670988271677
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/transfer/transferable-coin.html b/zh-TW/v5/asset/transfer/transferable-coin.html index ab15d624e8..f09233c2e0 100644 --- a/zh-TW/v5/asset/transfer/transferable-coin.html +++ b/zh-TW/v5/asset/transfer/transferable-coin.html @@ -4,13 +4,13 @@ 帳戶類型間可劃轉的幣種 | Bybit API Documentation - +

    帳戶類型間可劃轉的幣種

    HTTP 請求​

    GET /v5/asset/transfer/query-transfer-coin-list

    HTTP 請求​

    參數是否必需類型說明
    fromAccountTypetruestring劃出帳戶類型
    toAccountTypetruestring劃入帳戶類型

    響應參數​

    參數類型說明
    listarray幣種數組

    請求示例​

    GET /v5/asset/transfer/query-transfer-coin-list?fromAccountType=UNIFIED&toAccountType=CONTRACT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672144322595
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                "BTC",
                "ETH"
            ]
        },
        "retExtInfo": {},
        "time": 1672144322954
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/transfer/unitransfer-list.html b/zh-TW/v5/asset/transfer/unitransfer-list.html index ab7cdd37c8..636db1993e 100644 --- a/zh-TW/v5/asset/transfer/unitransfer-list.html +++ b/zh-TW/v5/asset/transfer/unitransfer-list.html @@ -4,13 +4,13 @@ 查詢萬能劃轉紀錄 | Bybit API Documentation - +

    查詢萬能劃轉紀錄

    提示
    • 母子帳號的api key都支持調用
    • 母帳號的api key需擁有"母子帳戶劃轉"(SubMemberTransfer)權限
    • 子帳號的api key需擁有"母子帳戶劃轉"(SubMemberTransferList)權限
    信息

    當startTime & endTime都不傳入時, API默認返回30天的數據

    HTTP 請求​

    GET /v5/asset/transfer/query-universal-transfer-list

    請求參數​

    參數是否必需類型說明
    transferIdfalsestringUUID. 使用創建萬能劃轉時的UUID
    coinfalsestring幣種
    statusfalsestring劃轉狀態. SUCCESS,FAILED,PENDING
    startTimefalseinteger開始時間戳 (毫秒) 注意: 實際查詢時是秒級維度生效
    endTimefalseinteger結束時間戳 (毫秒) 注意: 實際查詢時是秒級維度生效
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > transferIdstring劃轉Id
    > coinstring劃轉幣種
    > amountstring劃轉金額
    > fromMemberIdstring劃出UID
    > toMemberIdstring劃入UID
    > fromAccountTypestring劃出賬戶類型
    > toAccountTypestring劃入賬戶類型
    > timestampstring劃轉創建時間戳 (毫秒)
    > statusstring劃轉狀態
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/asset/transfer/query-universal-transfer-list?limit=1&cursor=eyJtaW5JRCI6MTc5NjU3OCwibWF4SUQiOjE3OTY1Nzh9 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672190762800
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "transferId": "universalTransfer_4c3cfe2f-85cb-11ed-ac09-9e37823c81cd_533285",
                    "coin": "USDC",
                    "amount": "1000",
                    "timestamp": "1672134373000",
                    "status": "SUCCESS",
                    "fromAccountType": "UNIFIED",
                    "toAccountType": "UNIFIED",
                    "fromMemberId": "533285",
                    "toMemberId": "592324"
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6MTc4OTYwNSwibWF4SUQiOjE3ODk2MDV9"
        },
        "retExtInfo": {},
        "time": 1672190763079
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/transfer/unitransfer.html b/zh-TW/v5/asset/transfer/unitransfer.html index ce0f2457a3..e4d3d4de96 100644 --- a/zh-TW/v5/asset/transfer/unitransfer.html +++ b/zh-TW/v5/asset/transfer/unitransfer.html @@ -4,13 +4,13 @@ 創建萬能劃轉 | Bybit API Documentation - +

    創建萬能劃轉

    支持子子帳戶間劃轉或母子帳號間劃轉。

    警告
    • 支持使用母帳戶或者子帳號api key請求
      • 若要使用子帳號api key, 需要有"母子帳戶劃轉"(SubMemberTransferList)權限
      • 當使用子帳號api key劃轉時, 僅能劃轉到母帳號下
    • 如果您遇到錯誤碼是131228並且錯誤信息是your balance is not enough, 請前往查詢賬戶單個幣種余額接口確認安全限額.
    • 不支持同一個uid之間的劃轉.
    • 資金賬戶轉出目前僅支持加密貨幣轉賬，不支持法定貨幣劃轉.

    HTTP 請求​

    POST /v5/asset/transfer/universal-transfer

    請求參數​

    參數是否必需類型說明
    transferIdtruestringUUID. 請求手動生成UUID
    cointruestring幣種
    amounttruestring劃轉金額
    fromMemberIdtrueinteger轉出UID
    toMemberIdtrueinteger轉入UID
    fromAccountTypetruestring轉出帳戶類型
    toAccountTypetruestring轉入帳戶類型

    響應參數​

    參數類型說明
    transferIdstringUUID
    statusstring劃轉狀態
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

    • 請求示例​

    POST /v5/asset/transfer/universal-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672189449697
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    {
        "transferId": "be7a2462-1138-4e27-80b1-62653f24925e",
        "coin": "ETH",
        "amount": "0.5",
        "fromMemberId": 592334,
        "toMemberId": 691355,
        "fromAccountType": "CONTRACT",
        "toAccountType": "UNIFIED"

    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transferId": "be7a2462-1138-4e27-80b1-62653f24925e",
            "status": "SUCCESS"
        },
        "retExtInfo": {},
        "time": 1672189450195
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/withdraw.html b/zh-TW/v5/asset/withdraw.html index 2fb5fc3bed..d5f5a40fae 100644 --- a/zh-TW/v5/asset/withdraw.html +++ b/zh-TW/v5/asset/withdraw.html @@ -4,13 +4,13 @@ 提現 | Bybit API Documentation - +

    提現

    若目標地址是Bybit平台內部地址，您可以實現內部平台轉帳

    危險
    • UTA沒有現貨帳戶
    • 如何確定當前帳戶是否為UTA帳戶? 調用該接口, 若uta=1, 則表明該api key所屬的帳戶是UTA帳戶。
    警告
    • 確保您已經將提現地址加入到這裡
    • 僅支持母帳號的API key
    公式

    feeType=0:

    • 若百分比手續費 != 0: 手續費 = 輸入金額 / (1 - 百分比手續費) * 百分比手續費 + 固定手續費
    • 若百分比手續費 = 0: 手續費 = 固定手續費

    feeType=1:

    • 若百分比手續費 != 0: 手續費 = 固定手續費 + (輸入金額 - 固定手續費) * 百分比手續費
    • 若百分比手續費 = 0: 手續費 = 固定手續費

    HTTP 請求​

    POST /v5/asset/withdraw/create

    請求參數​

    參數是否必需類型說明
    cointruestring幣種
    chainfalsestring
    • 鏈名, 當forceChain=0 或者 1: 該字段必填
    • 當forceChain=2: 該字段可忽略
    addresstruestring錢包地址或者Bybit UID
    • 當forceChain=0 或者 1: 請填寫錢包地址, 確保將地址添加到了網頁地址簿中, 注意大小寫，請使用和提幣地址簿中完全一樣的地址
    • 當forceChain=2: 填寫目標Bybit母帳戶UID, 確保將目標UID添加到了網頁地址簿中
    tagfalsestring標籤
    • 若添加地址時有填寫tag，則該字段必傳.
    • 注意: 如果鏈不支持tag/memo，請移除地址簿中的tag/memo，然後調用接口時，也不要傳tag字段
    amounttruestring提現金額
    timestamptrueinteger當前時間戳 (毫秒). 用於防止請求重放
    forceChainfalseinteger是否強制走鏈
    • 0(默認): 若提現地址解析後發現是平台內部地址，則自動轉為走內部平台轉帳
    • 1: 強制走鏈
    • 2: 使用Bybit UID轉帳
    accountTypefalsestring設置出金帳戶.
    • SPOT：走現貨錢包出金 (默認)
    • FUND：走資金錢包出金
    feeTypefalseinteger手續費選項
    • 0(默認): 輸入金額即實際收到的金額, 所以您需要額外考慮手續費
    • 1: 輸入金額不是實際收到的金額, 系統將會自動計算所需的手續費
    requestIdfalsestring自定義ID, 全局唯一, 用於冪等校驗
  • 字母(區分大小寫)數字組合, 可以是純字母或者純數字, 長度在1-32字符之間
    • beneficiaryfalseObject提現目標方基本信息, 僅kyc=KOR(韓國個人用戶)必須傳遞此字段
    > vaspEntityIdtruestring接收方交易所id. 請調用該接口來查詢對應的id
    > beneficiaryNamefalsestring接收方交易所用戶kyc姓名, 比如John Wilson 或者 Wilson John
  • 請依據目標交易所kyc姓名
  • 僅當vaspEntityId="others"時, 該字段可不傳

    • 響應參數​

    參數類型說明
    idstring提現Id

    請求示例​

    POST /v5/asset/withdraw/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672196570254
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    {
        "coin": "USDT",
        "chain": "ETH",
        "address": "0x99ced129603abc771c0dabe935c326ff6c86645d",
        "tag": null,
        "amount": "24",
        "timestamp": 1672196561407,
        "forceChain": 0,
        "accountType": "FUND"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "id": "10195"
        },
        "retExtInfo": {},
        "time": 1672196571239
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/withdraw/cancel-withdraw.html b/zh-TW/v5/asset/withdraw/cancel-withdraw.html index 5110202b7a..bd766fa2a3 100644 --- a/zh-TW/v5/asset/withdraw/cancel-withdraw.html +++ b/zh-TW/v5/asset/withdraw/cancel-withdraw.html @@ -4,13 +4,13 @@ 撤銷提幣 | Bybit API Documentation - +

    撤銷提幣

    警告

    僅支持母帳號API key

    HTTP 請求​

    POST /v5/asset/withdraw/cancel

    請求參數​

    參數是否必需類型說明
    idtruestring提現Id

    響應參數​

    參數類型說明
    statusinteger0: 失敗. 1: 成功

    請求示例​

    POST /v5/asset/withdraw/cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672197227732
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    {
        "id": "10197"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "status": 1
        },
        "retExtInfo": {},
        "time": 1672197228408
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/withdraw/vasp-list.html b/zh-TW/v5/asset/withdraw/vasp-list.html index 11b09428b2..e681fad386 100644 --- a/zh-TW/v5/asset/withdraw/vasp-list.html +++ b/zh-TW/v5/asset/withdraw/vasp-list.html @@ -4,13 +4,13 @@ 查詢交易所列表 | Bybit API Documentation - +

    查詢交易所列表

    該接口主要用於kyc=KOR的韓國個人用戶, 在提現時需要填寫接收方交易所信息

    HTTP 請求​

    GET /v5/asset/withdraw/vasp/list

    請求參數​

    無

    響應參數​

    參數類型說明
    vasparray交易所實體信息
    > vaspEntityIdstring接收方平台id. 當提現至Upbit或者不在該列表內的平台時, 請使用vaspEntityId="others"
    > vaspNamestring接收方平台名稱

    請求示例​

    GET /v5/asset/withdraw/vasp/list HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1715067106163
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "vasp": [
                {
                    "vaspEntityId": "basic-finance",
                    "vaspName": "Basic-finance"
                },
                {
                    "vaspEntityId": "beeblock",
                    "vaspName": "Beeblock"
                },
                {
                    "vaspEntityId": "bithumb",
                    "vaspName": "bithumb"
                },
                {
                    "vaspEntityId": "cardo",
                    "vaspName": "cardo"
                },
                {
                    "vaspEntityId": "codevasp",
                    "vaspName": "codevasp"
                },
                {
                    "vaspEntityId": "codexchange-kor",
                    "vaspName": "CODExchange-kor"
                },
                {
                    "vaspEntityId": "coinone",
                    "vaspName": "coinone"
                },
                {
                    "vaspEntityId": "dummy",
                    "vaspName": "Dummy"
                },
                {
                    "vaspEntityId": "flata-exchange",
                    "vaspName": "flataexchange"
                },
                {
                    "vaspEntityId": "fobl",
                    "vaspName": "Foblgate"
                },
                {
                    "vaspEntityId": "hanbitco",
                    "vaspName": "hanbitco"
                },
                {
                    "vaspEntityId": "hexlant",
                    "vaspName": "hexlant"
                },
                {
                    "vaspEntityId": "inex",
                    "vaspName": "INEX"
                },
                {
                    "vaspEntityId": "infiniteblock-corp",
                    "vaspName": "InfiniteBlock Corp"
                },
                {
                    "vaspEntityId": "kdac",
                    "vaspName": "kdac"
                },
                {
                    "vaspEntityId": "korbit",
                    "vaspName": "korbit"
                },
                {
                    "vaspEntityId": "paycoin",
                    "vaspName": "Paycoin"
                },
                {
                    "vaspEntityId": "qbit",
                    "vaspName": "Qbit"
                },
                {
                    "vaspEntityId": "tennten",
                    "vaspName": "TENNTEN"
                },
                {
                    "vaspEntityId": "others",
                    "vaspName": "Others (including Upbit)"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1715067106537
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/asset/withdraw/withdraw-record.html b/zh-TW/v5/asset/withdraw/withdraw-record.html index 68a4d2f7c6..dc83342a3e 100644 --- a/zh-TW/v5/asset/withdraw/withdraw-record.html +++ b/zh-TW/v5/asset/withdraw/withdraw-record.html @@ -4,13 +4,13 @@ 查詢提現紀錄 | Bybit API Documentation - +

    查詢提現紀錄

    提示
    • endTime - startTime需要小於等於30天. 默認查詢最近30天的紀錄。
    • 僅支持母帳號的API key

    HTTP 請求​

    GET /v5/asset/withdraw/query-record

    請求參數​

    參數是否必需類型說明
    withdrawIDfalsestring提現Id
    txIDfalsestring交易哈希ID
    coinfalsestring幣種
    withdrawTypefalseinteger提現類型. 0(默認): 鏈上提幣. 1: 平台內部轉帳. 2: 所有方式
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    rowsarrayObject
    > withdrawIdstring提現Id
    > txIDstring交易Id，提現失敗/提現撤銷：為空
    > withdrawTypeinteger提現類型. 0: 鏈上提幣. 1: 內部轉帳
    > coinstring幣種
    > chainstring鏈名
    > amountstring提幣金額
    > withdrawFeestring提幣手續費
    > statusstring提幣狀態
    > toAddressstring提現目標地址. 內部轉帳：顯示Bybit UID
    > tagstring標籤
    > createTimestring提現創建時間戳 (毫秒)
    > updateTimestring提現更新時間戳 (毫秒)

    請求示例​

    GET /v5/asset/withdraw/query-record?coin=USDT&withdrawType=2&limit=2 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672194949557
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [
                {
                    "coin": "USDT",
                    "chain": "ETH",
                    "amount": "77",
                    "txID": "",
                    "status": "SecurityCheck",
                    "toAddress": "0x99ced129603abc771c0dabe935c326ff6c86645d",
                    "tag": "",
                    "withdrawFee": "10",
                    "createTime": "1670922217000",
                    "updateTime": "1670922217000",
                    "withdrawId": "9976",
                    "withdrawType": 0
                },
                {
                    "coin": "USDT",
                    "chain": "internalAddressChain",
                    "amount": "20.1234",
                    "txID": "",
                    "status": "success",
                    "toAddress": "999805",
                    "tag": "",
                    "withdrawFee": "0",
                    "createTime": "1698889833000",
                    "updateTime": "1698889846000",
                    "withdrawId": "13310",
                    "withdrawType": 1
                }
            ],
            "nextPageCursor": "eyJtaW5JRCI6OTgwMSwibWF4SUQiOjk5NzZ9"
        },
        "retExtInfo": {},
        "time": 1672194949928
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/backup/set-pledge-token.html b/zh-TW/v5/backup/set-pledge-token.html index d8b6d42fda..0f595cc5d0 100644 --- a/zh-TW/v5/backup/set-pledge-token.html +++ b/zh-TW/v5/backup/set-pledge-token.html @@ -4,13 +4,13 @@ Set Pledge Token | Bybit API Documentation - +

    Set Pledge Token

    Set Pledge Token in cross margin

    HTTP Request​

    POST /v5/spot-margin-trade/set-pledge-token

    Request Parameters​

    ParameterRequiredTypeComments
    cointruestringcoin
    pledgeStatustureintpledge status. 1: on, 0: off

    Response Parameters​

    ParameterTypeComments
    pledgeStatusstringpledge status：1: on,0: off
    - + \ No newline at end of file diff --git a/zh-TW/v5/broker/account-info.html b/zh-TW/v5/broker/account-info.html index d2f0039d59..bbb53d4660 100644 --- a/zh-TW/v5/broker/account-info.html +++ b/zh-TW/v5/broker/account-info.html @@ -4,13 +4,13 @@ 查詢經紀商帳戶信息 | Bybit API Documentation - +

    查詢經紀商帳戶信息

    信息
    • 使用經紀商的母帳戶進行查詢

    API頻率: 10次/秒

    HTTP 請求​

    GET /v5/broker/account-info

    請求參數​

    無

    響應參數​

    參數類型說明
    subAcctQtystring已創建的子帳戶數量
    maxSubAcctQtystring允許創建的子帳戶數量上限
    baseFeeRebateRateObject基礎費率返佣
    > spotstring現貨交易基礎費率返佣, 例如, 10.00%
    > derivativesstring期貨交易基礎費率返佣, 例如, 10.00%
    markupFeeRebateRateObject加點費率返佣
    > spotstring現貨交易加點費率返佣, 例如, 10.00%
    > derivativesstring期貨交易加點費率返佣, 例如, 10.00%
    > convertstring閃兌加點費率返佣, 例如, 10.00%
    tsstring系統時間戳 (毫秒)

    請求示例​

    GET /v5/broker/account-info HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1701399431920
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "subAcctQty": "2",
            "maxSubAcctQty": "20",
            "baseFeeRebateRate": {
                "spot": "10.0%",
                "derivatives": "10.0%"
            },
            "markupFeeRebateRate": {
                "spot": "6.00%",
                "derivatives": "9.00%",
                "convert": "3.00%"
            },
            "ts": "1701395633402"
        },
        "retExtInfo": {},
        "time": 1701395633403
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/broker/exchange-earning.html b/zh-TW/v5/broker/exchange-earning.html index c2b89f5a00..05f30ea81d 100644 --- a/zh-TW/v5/broker/exchange-earning.html +++ b/zh-TW/v5/broker/exchange-earning.html @@ -4,13 +4,13 @@ 查詢經紀商返佣信息 | Bybit API Documentation - +

    查詢經紀商返佣信息

    信息
    • 使用經紀商的母帳戶進行查詢
    • 支持查詢過去1個月的數據至T-1. 要取得1個月之前的數據, 請聯繫您的客戶經理
    • begin & end兩個入参, 要麼同時輸入, 要麼都不輸入. 当不输入时, 默认返回最近7天的数据

    API頻率: 10次/秒

    HTTP 請求​

    GET /v5/broker/earnings-info

    請求參數​

    參數是否必需類型說明
    bizTypefalsestring業務類型. SPOT, DERIVATIVES, OPTIONS, CONVERT
    beginfalsestring開始時間, 格式: YYYYMMDD, 比如, 20231201, 表示搜尋時間是從2023年12月1日 00:00:00 UTC (包含)
    endfalsestring結束時間, 格式: YYYYMMDD, 比如, 20231201, 表示搜尋時間是結束於2023年12月2日 00:00:00 UTC (不包含)
    uidfalsestring
    • 輸入子UID來查詢指定UID的具體數據
    • 要向獲得所有子UID的數據, 則不傳
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 1000
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    totalEarningCatObject按照業務類型統計的總的返佣數據
    > spotarrayObject. 現貨交易的返佣. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
    >> coinstring返佣幣種
    >> earningstring返佣金額
    > derivativesarrayObject. 期貨交易的返佣. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
    >> coinstring返佣幣種
    >> earningstring返佣金額
    > optionsarrayObject. 期權交易的返佣. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
    >> coinstring返佣幣種
    >> earningstring返佣金額
    > convertarrayObject. 閃兌交易的返佣. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
    >> coinstring返佣幣種
    >> earningstring返佣金額
    > totalarrayObject. 所有業務類型的返佣總和. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
    >> coinstring返佣幣種
    >> earningstring返佣金額
    detailsarrayObject. 每個子UID以及每個業務類型的交易細節
    > userIdstring子帳戶
    > bizTypestring業務類型. SPOT, DERIVATIVES, OPTIONS, CONVERT
    > symbolstring幣對名
    > coinstring返佣幣種
    > earningstring返佣金額
    > markupEarningstring加點佣金
    > baseFeeEarningstring基礎佣金
    > orderIdstring訂單ID
    > execTimestring訂單執行時間戳 (毫秒)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/broker/earnings-info?begin=20231129&end=20231129&uid=117894077 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1701399431920
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: 32d2aa1bc205ddfb89849b85e2a8b7e23b1f8f69fe95d6f2cb9c87562f9086a6
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "totalEarningCat": {
                "spot": [],
                "derivatives": [
                    {
                        "coin": "USDT",
                        "earning": "0.00027844"
                    }
                ],
                "options": [],
                "total": [
                    {
                        "coin": "USDT",
                        "earning": "0.00027844"
                    }
                ]
            },
            "details": [
                {
                    "userId": "117894077",
                    "bizType": "DERIVATIVES",
                    "symbol": "DOGEUSDT",
                    "coin": "USDT",
                    "earning": "0.00016166",
                    "markupEarning": "0.000032332",
                    "baseFeeEarning": "0.000129328",
                    "orderId": "ec2132f2-a7e0-4a0c-9219-9f3cbcd8e878",
                    "execTime": "1701275846033"
                },
                {
                    "userId": "117894077",
                    "bizType": "DERIVATIVES",
                    "symbol": "TRXUSDT",
                    "coin": "USDT",
                    "earning": "0.00011678",
                    "markupEarning": "0.000023356",
                    "baseFeeEarning": "0.000093424",
                    "orderId": "28b29c2b-ba14-450e-9ce7-3cee0c1fa6da",
                    "execTime": "1701245285017"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1701398193964
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/broker/sub-deposit-record.html b/zh-TW/v5/broker/sub-deposit-record.html index 7e928ac0e4..26b8f8e95f 100644 --- a/zh-TW/v5/broker/sub-deposit-record.html +++ b/zh-TW/v5/broker/sub-deposit-record.html @@ -4,13 +4,13 @@ 查詢經紀商的子帳號充值紀錄 | Bybit API Documentation - +

    查詢經紀商的子帳號充值紀錄

    經紀商僅能通過主帳號的API key來查詢子帳號的充值紀錄

    API頻率: 300次/分

    提示

    endTime - startTime 需要小於等於30天. 默認查詢最近30天的紀錄

    HTTP 請求​

    GET /v5/broker/asset/query-sub-member-deposit-record

    請求參數​

    參數是否必需類型說明
    subMemberIdfalsestring子帳號
    coinfalsestring幣種
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    rowsarrayObject
    > subMemberIdstring子帳戶UID
    > coinstring幣種
    > chainstring鏈名
    > amountstring充值金額
    > txIDstring交易Id. 充值失敗或取消充值時為空
    > statusinteger充值狀態
    > toAddressstring充值的目標地址
    > tagstring充值目標地址的tag
    > depositFeestring充值手續費
    > successAtstring最後更新時間
    > confirmationsstring确认区块的数量
    > txIndexstring交易序列号
    > blockHashstring鏈上的哈希數
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制
    > depositTypestring入金類型. 0: 正常充值, 10: 充值觸發每日限額, 20: 異常充值
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/broker/asset/query-sub-member-deposit-record?coin=USDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672192441294
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "rows": [],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1672192441742
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/copytrade.html b/zh-TW/v5/copytrade.html index 674090125b..d8cb281ee3 100644 --- a/zh-TW/v5/copytrade.html +++ b/zh-TW/v5/copytrade.html @@ -4,14 +4,14 @@ 如何使用API帶單 | Bybit API Documentation - +

    如何使用API帶單

    成為交易達人​

    請前往這裡申請成為交易達人

    創建API KEY​

    "合約 - 訂單 持倉"是跟單交易的必選權限項

    支持範圍​

    目前, 經典帳戶和統一帳戶都支持跟單交易, 但是只能交易部分USDT永續合約對. 請通過該查詢可交易產品的規格信息接口, 檢查其中的copyTrading字段, 來了解 支持的具體交易對

    下單示例​

    使用V5創建訂單接口來創建一個帶單

    POST /v5/order/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1698376189371
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 207

    {
        "symbol": "BTCUSDT",
        "side": "Buy",
        "orderType": "Limit",
        "category": "linear",
        "qty": "0.1",
        "price": "29000",
        "timeInForce": "GTC",
        "positionIdx": 1
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/demo.html b/zh-TW/v5/demo.html index fa99c96b66..e02d02dcd0 100644 --- a/zh-TW/v5/demo.html +++ b/zh-TW/v5/demo.html @@ -4,7 +4,7 @@ 模擬交易 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    模擬交易

    概覽​

    Bybit v5 Open API支持模擬交易帳戶, 但是由於模擬交易的主要目的是為了體驗基礎交易功能, 僅支持有限的功能, 所以部分接口不支持使用。

    創建API Key​

    1. 您需要登入到Bybit 主網帳戶;
    2. 切換到模擬交易, 注意: 模擬交易擁有自己獨立的帳戶ID;
    3. 懸停鼠標在用戶頭像上, 然後點擊"API" 來創建key和secret;

    使用規則​

    • 基礎交易規則和實盤保持一致
    • 模擬盤的訂單僅保留7天
    • 默認請求頻率, 無法提頻

    域名​

    主網模擬盤:
    Rest API: https://api-demo.bybit.com
    Websocket : wss://stream-demo.bybit.com

    小建議​

    • 請注意模擬交易是獨立模塊, 當創建了模擬交易的api key後, 請使用以上域名進行連接
    • 順便說下, 在測試網使用模擬交易服務是無意義的, 因為二者都是沙盒環境, 若要使用模擬交易, 請至主網生成模擬交易的api key

    可用接口列表​

    目錄接口名路由
    公有行情所有所有接口
    交易創建委託單/v5/order/create
    修改委託單/v5/order/amend
    撤銷委託單/v5/order/cancel
    查詢實時委託段/v5/order/realtime
    撤銷所有訂單/v5/order/cancel-all
    查詢歷史訂單/v5/order/history
    查詢成交紀錄/v5/execution/list
    批量創建委託單/v5/order/create-batch (期貨/期權)
    批量修改委託單/v5/order/amend-batch (期貨/期權)
    批量撤銷委託單/v5/order/cancel-batch (期貨/期權)
    持倉查詢持倉/v5/position/list
    設置槓桿/v5/position/set-leverage
    切換持倉模式/v5/position/switch-mode
    設置止盈止損/v5/position/trading-stop
    設置自動追加保證金/v5/position/set-auto-add-margin
    手動增加或減少保證金/v5/position/add-margin
    查詢平常盈虧/v5/position/closed-pnl
    帳戶查詢錢包餘額/v5/account/wallet-balance
    查詢利息紀錄/v5/account/borrow-history
    設置抵押品幣種/v5/account/set-collateral-switch
    查詢抵押品信息/v5/account/collateral-info
    查詢Greeks信息/v5/asset/coin-greeks
    查詢帳戶配置/v5/account/info
    查詢交易日誌/v5/account/transaction-log
    設置保證金模式/v5/account/set-margin-mode
    設置現貨對衝/v5/account/set-hedging-mode
    資產查詢交割紀錄/v5/asset/delivery-record
    查詢USDC結算紀錄/v5/asset/settlement-record
    全倉槓桿全倉槓桿開關/v5/spot-margin-trade/switch-mode
    全倉槓桿設置/v5/spot-margin-trade/set-leverage
    查詢開關狀態和倍數/v5/spot-margin-uta/status
    WS私有推送order,execution,position,wallet,greeks/v5/private

    獲取模擬資金接口​

    API頻率: 每分鐘1次

    HTTP請求​

    POST /v5/account/demo-apply-money

    請求參數​

    參數是否必需類型說明
    adjustTypefalseinteger0(默認): 增加模擬資金; 1: 減少模擬資金
    utaDemoApplyMoneyfalsearray
    > coinfalsestring申請的幣種, 支持 BTC, ETH, USDT, USDC
    > amountStrfalsestring申請的金額, 每次請求最多支持申請如下金額
  • BTC: "15"
  • ETH: "200"
  • USDT: "100000"
  • USDC: "100000"

    • 請求示例​

    POST /v5/account/demo-apply-money HTTP/1.1
    Host: api-demo.bybit.com
    X-BAPI-SIGN: XXXXXXX
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1711420489915
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "adjustType": 0,
        "utaDemoApplyMoney": [
            {
                "coin": "USDT",
                "amountStr": "109"
            },
            {
                "coin": "ETH",
                "amountStr": "1"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/enum.html b/zh-TW/v5/enum.html index 79d299d24f..c903361d52 100644 --- a/zh-TW/v5/enum.html +++ b/zh-TW/v5/enum.html @@ -4,13 +4,13 @@ 枚舉定義 | Bybit API Documentation - +

    枚舉定義

    locale​

    • de-DE
    • en-US
    • es-AR
    • es-ES
    • es-MX
    • fr-FR
    • kk-KZ
    • id-ID
    • uk-UA
    • ja-JP
    • ru-RU
    • th-TH
    • pt-BR
    • tr-TR
    • vi-VN
    • zh-TW
    • ar-SA
    • hi-IN
    • fil-PH

    announcementType​

    • new_crypto
    • latest_bybit_news
    • delistings
    • latest_activities
    • product_updates
    • maintenance_updates
    • new_fiat_listings
    • other

    announcementTag​

    • Spot
    • Derivatives
    • Spot Listings
    • BTC
    • ETH
    • Trading Bots
    • USDC
    • Leveraged Tokens
    • USDT
    • Margin Trading
    • Partnerships
    • Launchpad
    • Upgrades
    • ByVotes
    • Delistings
    • VIP
    • Futures
    • Institutions
    • Options
    • WEB3
    • Copy Trading
    • Earn
    • Bybit Savings
    • Dual Asset
    • Liquidity Mining
    • Shark Fin
    • Launchpool
    • NFT GrabPic
    • Buy Crypto
    • P2P Trading
    • Fiat Deposit
    • Crypto Deposit
    • Спот
    • Спот лістинги
    • Торгові боти
    • Токени з кредитним плечем
    • Маржинальна торгівля
    • Партнерство
    • Оновлення
    • Делістинги
    • Ф'ючерси
    • Опціони
    • Копітрейдинг
    • Bybit Накопичення
    • Бівалютні інвестиції
    • Майнінг ліквідності
    • Купівля криптовалюти
    • P2P торгівля
    • Фіатні депозити
    • Криптодепозити
    • Копитрейдинг
    • Торговые боты
    • Деривативы
    • P2P
    • Спот листинги
    • Деривативи
    • MT4
    • Lucky Draw
    • Unified Trading Account
    • Єдиний торговий акаунт
    • Единый торговый аккаунт
    • Институциональный трейдинг
    • Інституціональний трейдинг
    • Делистинг

    category​

    統一帳戶

    • spot 現貨
    • linear USDT永續, USDC永續, USDC交割
    • inverse 反向合約，包含反向永續, 反向交割
    • option 期權

    經典帳戶

    • linear USDT永續
    • inverse 反向合約，包含反向永續, 反向交割
    • spot 現貨
    • option 期權

    orderStatus​

    活動態

    • New 訂單成功下達
    • PartiallyFilled 部分成交
    • Untriggered 條件單未觸發

    終態

    • Rejected 訂單被拒絕
    • PartiallyFilledCanceled 僅現貨存在該枚舉值, 訂單部分成交且已取消
    • Filled 完全成交
    • Cancelled 期貨交易，當訂單是該狀態時，是可能存在部分成交的; 經典帳戶的現貨盈止損單、條件單、OCO訂單觸發前取消
    • Triggered 已觸發, 條件單從未觸發到變成New的一個中間態
    • Deactivated 統一帳戶下期貨、現貨的盈止損單、條件單、OCO訂單觸發前取消

    timeInForce​

    • GTC 一直有效至取消
    • IOC 立即成交或取消
    • FOK 完全成交或取消
    • PostOnly 被動委託

    createType​

    • CreateByUser
    • CreateByAdminClosing
    • CreateBySettle USDC期貨交割; 因合約下架導致的平倉
    • CreateByStopOrder 期貨條件單
    • CreateByTakeProfit 期貨止盈單
    • CreateByPartialTakeProfit 期貨部分止盈單
    • CreateByStopLoss 期貨止損單
    • CreateByPartialStopLoss 期貨部分止損單
    • CreateByTrailingStop 期貨追蹤出場單
    • CreateByLiq 階梯強平
    • CreateByTakeOver_PassThrough強平觸發倉位被系統接管
    • CreateByAdl_PassThrough 自動減倉
    • CreateByBlock_PassThrough 從Paradigm下的大宗交易
    • CreateByBlockTradeMovePosition_PassThrough 移倉觸發的訂單
    • CreateByClosing 在持倉區進行平倉 - web/app
    • CreateByFGridBot 網格機器人創建訂單 - web/app
    • CloseByFGridBot 網格機器人平倉 - web/app
    • CreateByTWAP TWAP創建訂單 - web/app
    • CreateByTVSignal TradingView webhook觸發訂單 - web/app
    • CreateByMmRateClose 通過設置mmrate觸發的訂單 - web/app
    • CreateByMartingaleBot 馬丁格爾訂單 - web/app
    • CloseByMartingaleBot 馬丁格爾平倉 - web/app
    • CreateByIceBerg 冰山策略訂單 - web/app
    • CreateByArbitrage 套利策略下單 - web/app
    • CreateByDdh 期權動態Delta對衝訂單 - web/app

    execType​

    • Trade
    • AdlTrade 自動減倉
    • Funding 資金費率
    • BustTrade 強平
    • Delivery USDC到期交割; 因合約下架導致的平倉
    • Settle 反向合約到期交割; 下架合約到期平倉
    • BlockTrade
    • MovePosition

    stopOrderType​

    • TakeProfit 止盈單
    • StopLoss 止損單
    • TrailingStop 追蹤止損單
    • Stop 條件單
    • PartialTakeProfit 部分止盈單
    • PartialStopLoss 部分止損單
    • tpslOrder 現貨止盈止損單
    • OcoOrder 現貨OCO訂單
    • MmRateClose 在web或者app端, 當倉位上設置了當達到某個MMR水平時, 自動平倉
    • BidirectionalTpslOrder 現貨雙向止盈止損單

    tickDirection​

    • PlusTick 價格上漲
    • ZeroPlusTick 交易的價格與前一筆交易的價格相同，前一筆交易的價格高於前一筆交易的價格
    • MinusTick 價格下跌
    • ZeroMinusTick 交易的價格與前一筆交易的價格相同，前一筆交易的價格低於前一筆交易的價格

    interval​

    • 1 3 5 15 30 60 120 240 360 720 分鐘
    • D 天
    • W 週
    • M 月

    intervalTime​

    • 5min 15min 30min 分鐘
    • 1h 4h 小時
    • 1d 天

    positionIdx​

    • 0 單向持倉
    • 1 買側的雙向持倉
    • 2 賣側的雙向持倉

    positionStatus​

    • Normal
    • Liq 強平中
    • Adl 自動減倉中

    rejectReason​

    • EC_NoError
    • EC_Others
    • EC_UnknownMessageType
    • EC_MissingClOrdID
    • EC_MissingOrigClOrdID
    • EC_ClOrdIDOrigClOrdIDAreTheSame
    • EC_DuplicatedClOrdID
    • EC_OrigClOrdIDDoesNotExist
    • EC_TooLateToCancel
    • EC_UnknownOrderType
    • EC_UnknownSide
    • EC_UnknownTimeInForce
    • EC_WronglyRouted
    • EC_MarketOrderPriceIsNotZero
    • EC_LimitOrderInvalidPrice
    • EC_NoEnoughQtyToFill
    • EC_NoImmediateQtyToFill
    • EC_PerCancelRequest
    • EC_MarketOrderCannotBePostOnly
    • EC_PostOnlyWillTakeLiquidity
    • EC_CancelReplaceOrder
    • EC_InvalidSymbolStatus
    • EC_CancelForNoFullFill
    • EC_BySelfMatch
    • EC_InCallAuctionStatus 用於市前訂單操作，例如集合競價第二階段不允許撤單，當交易服務沒有成功攔截撤單請求時，該請求最終會被撮合服務拒絕

    accountType​

    經典帳戶​

    • CONTRACT 合約帳戶
    • SPOT 現貨帳戶
    • FUND 資金帳戶

    統一帳戶​

    • CONTRACT 反向合約帳戶
    • UNIFIED 統一帳戶
    • FUND 資金帳戶

    transferStatus​

    • SUCCESS
    • PENDING
    • FAILED

    depositStatus​

    • 0 未知
    • 1 等待確認
    • 2 處理中
    • 3 成功 (這是一筆入金成功的終態)
    • 4 儲值失敗
    • 10011 等待加錢到資金池
    • 10012 成功加錢到資金池

    withdrawStatus​

    • SecurityCheck
    • Pending
    • success
    • CancelByUser
    • Reject
    • Fail
    • BlockchainConfirmed
    • MoreInformationRequired
    • Unknown 保底狀態, 一般不會出現

    triggerBy​

    • LastPrice
    • IndexPrice
    • MarkPrice

    cancelType​

    • CancelByUser
    • CancelByReduceOnly
    • CancelByPrepareLiq CancelAllBeforeLiq 由於強平而取消
    • CancelByPrepareAdl CancelAllBeforeAdl 由於自動減倉而取消
    • CancelByAdmin
    • CancelBySettle 由於合約下架而取消訂單
    • CancelByTpSlTsClear 止盈止損訂單因倉位被平而取消
    • CancelBySmp

    期權:

    • CancelByUser
    • CancelByReduceOnly
    • CancelAllBeforeLiq 由於強平而取消
    • CancelAllBeforeAdl 由於自動減倉而取消
    • CancelBySettle
    • CancelByCannotAffordOrderCost
    • CancelByPmTrialMmOverEquity
    • CancelByAccountBlocking
    • CancelByDelivery
    • CancelByMmpTriggered
    • CancelByCrossSelfMuch
    • CancelByCrossReachMaxTradeNum
    • CancelByDCP
    • CancelBySmp

    optionPeriod​

    • BTC: 7,14,21,30,60,90,180,270天
    • ETH: 7,14,21,30,60,90,180,270天
    • SOL: 7,14,21,30,60,90天

    dataRecordingPeriod​

    • 5min 15min 30min 分鐘
    • 1h 4h 小時
    • 4d 天

    contractType​

    • InversePerpetual 反向永續
    • LinearPerpetual 正向永續: USDT永續和USDC永續
    • LinearFutures USDC交割
    • InverseFutures 反向交割

    status​

    • PreLaunch 預上線
    • Trading 線上可交易
    • Delivering 交割中
    • Closed 已下架

    curAuctionPhase​

    • NotStarted 盤前交易未開始
    • Finished 盤前交易已結束
      • 當盤前合約最終無法轉為正式合約, 它將會被下架且phase="Finished"
    • CallAuction 集合競價第一階段
      • 僅支持timeInForce=GTC, orderType=Limit的訂單
      • 不支持設置止盈止損; 不支持掛條件單
      • 該階段不支持改單
      • 訂單價格區間: [preOpenPrice x 0.5, maxPrice]
    • CallAuctionNoCancel 集合競價第二階段
      • 僅支持timeInForce=GTC, orderType=Limit的訂單
      • 不支持設置止盈止損; 不支持掛條件單
      • 該階段不支持改單和撤單
      • 訂單價格區間: 買單 [lastPrice x 0.5, markPrice x 1.1], 賣單 [markPrice x 0.9, maxPrice]
    • CrossMatching 集合競價第三階段 - 撮合盤前交易
      • 該階段不支持掛單, 改單和撤單
      • 該階段會產生k線數據
    • ContinuousTrading 連續競價階段
      • 該階段對訂單行為沒有限制
      • 該階段會產生訂單簿、最近成交數據

    marginTrading​

    • none 不管是經典帳戶還是統一帳戶, 該交易對都不支持槓桿交易
    • both 對於經典帳戶和統一帳戶, 該交易對都支持槓桿交易
    • utaOnly 僅對於統一帳戶, 該交易對支持槓桿交易
    • normalSpotOnly 僅對於經典帳戶, 該交易對支持槓桿交易

    copyTrading​

    • none 不管是經典帳戶還是統一帳戶, 該交易對都不支持帶單交易
    • both 對於經典帳戶和統一帳戶, 該交易對都支持帶單交易
    • utaOnly 僅對於統一帳戶, 該交易對支持帶單交易
    • normalOnly 僅對於經典帳戶, 該交易對支持帶單交易

    type(uta-translog)​

    • TRANSFER_IN 從其他錢包轉入到統一錢包
    • TRANSFER_OUT 從統一錢包轉出到別的錢包
    • TRADE
    • SETTLEMENT USDT永續的資金費結算; USDC永續的資金費結算以及USDC合約的8小時倉位結算
    • DELIVERY USDC交割合約和期權到期交割
    • LIQUIDATION
    • ADL 自動減倉
    • AIRDROP
    • BONUS 體驗金發放
    • BONUS_RECOLLECT 體驗金過期
    • FEE_REFUND 手續費返還
    • INTEREST 借貸產生的利息
    • CURRENCY_BUY 閃兌, 以及系統對借款的清算(統一帳戶借貸)
    • CURRENCY_SELL 閃兌, 以及系統對借款的清算(統一帳戶借貸)
    • BORROWED_AMOUNT_INS_LOAN OTC放款
    • PRINCIPLE_REPAYMENT_INS_LOAN 主動償還本金
    • INTEREST_REPAYMENT_INS_LOAN 主動償還利息
    • AUTO_SOLD_COLLATERAL_INS_LOAN OTC強平賣出抵押品(機構借貸)
    • AUTO_BUY_LIABILITY_INS_LOAN OTC強平買入借款資產(機構借貸)
    • AUTO_PRINCIPLE_REPAYMENT_INS_LOAN 被動償還本金
    • AUTO_INTEREST_REPAYMENT_INS_LOAN 被動償還利息
    • TRANSFER_IN_INS_LOAN 機構借貸強平時自動劃入
    • TRANSFER_OUT_INS_LOAN 機構借貸強平時自動劃出
    • SPOT_REPAYMENT_SELL 一鍵還款時的賣出
    • SPOT_REPAYMENT_BUY 一鍵還款時的買入
    • TOKENS_SUBSCRIPTION 槓桿代幣申購
    • TOKENS_REDEMPTION 槓桿代幣贖回
    • AUTO_DEDUCTION 資金自動轉出 (鏈回滾)
    • FLEXIBLE_STAKING_SUBSCRIPTION Byfi靈活質押申購
    • FLEXIBLE_STAKING_REDEMPTION Byfi靈活質押贖回
    • FIXED_STAKING_SUBSCRIPTION Byfi固定質押申購
    • PREMARKET_TRANSFER_OUT 盤前交易質押金上帳
    • PREMARKET_DELIVERY_SELL_NEW_COIN 盤前交易交割新幣
    • PREMARKET_DELIVERY_BUY_NEW_COIN 盤前交易新幣種劃給買家
    • PREMARKET_DELIVERY_PLEDGE_PAY_SELLER 交割履約-質押款交付
    • PREMARKET_DELIVERY_PLEDGE_BACK 交割履約-退回賣家質押幣
    • PREMARKET_ROLLBACK_PLEDGE_BACK 交割違約-退還買家質押款
    • PREMARKET_ROLLBACK_PLEDGE_PENALTY_TO_BUYER 交割違約-違約金劃給買家
    • CUSTODY_NETWORK_FEE fireblocks業務
    • CUSTODY_SETTLE_FEE fireblocks業務
    • CUSTODY_LOCK fireblocks / copper 業務
    • CUSTODY_UNLOCK fireblocks / copper 業務
    • CUSTODY_UNLOCK_REFUND fireblocks / copper 業務
    • LOANS_BORROW_FUNDS 質押借貸放款
    • LOANS_PLEDGE_ASSET 質押借貸還款

    type(contract-translog)​

    • TRANSFER_IN 從其他錢包轉入到(反向)合約錢包
    • TRANSFER_OUT 從(反向)合約錢包轉出到別的錢包
    • TRADE
    • SETTLEMENT USDT永續/反向永續的資金費結算
    • DELIVERY 反向期貨合約的交割
    • LIQUIDATION
    • ADL 自動減倉
    • AIRDROP
    • BONUS 體驗金發放
    • BONUS_RECOLLECT 體驗金過期
    • FEE_REFUND 手續費返還
    • CURRENCY_BUY 閃兌
    • CURRENCY_SELL 閃兌
    • AUTO_DEDUCTION 資金自動轉出 (鏈回滾)
    • Others

    unifiedMarginStatus​

    • 1 經典帳戶
    • 2 已升級到了統一保證金帳戶，僅支持交易期貨和期權
    • 3 已升級到了統一帳戶，支持交易期貨、期權和現貨
    • 4 UTA Pro，統一帳戶的Pro版本

    ltStatus​

    • 1 槓桿代幣支持申贖
    • 2 槓桿代幣支持申購，但無法贖回
    • 3 槓桿代幣支持贖回，但是無法申購
    • 4 槓桿代幣無法申贖
    • 5 調倉中

    convertAccountType​

    統一帳戶 (UTA)​

    • eb_convert_inverse 反向合約錢包 (該錢包內沒有USDT))
    • eb_convert_uta 統一帳戶錢包
    • eb_convert_funding 資金錢包

    經典帳戶​

    • eb_convert_spot 現貨錢包
    • eb_convert_contract 合約錢包 (該錢包包含USDT)
    • eb_convert_funding 資金錢包

    symbol​

    USDT永續:

    • BTCUSDT
    • ETHUSDT

    USDC永續:

    • BTCPERP
    • ETHPERP

    USDC交割:

    • BTC-24MAR23

    反向永續:

    • BTCUSD
    • ETHUSD

    反向交割:

    • BTCUSDH23 H: 第一季度; 23: 2023
    • BTCUSDM23 M: 第二季度; 23: 2023
    • BTCUSDU23 U: 第三季度; 23: 2023
    • BTCUSDZ23 Z: 第四季度; 23: 2023

    現貨:

    • BTCUSDT
    • ETHUSDC

    adlRankIndicator​

    • 0 空倉時默認值
    • 1
    • 2
    • 3
    • 4
    • 5

    vipLevel​

    • No VIP
    • VIP-1
    • VIP-2
    • VIP-3
    • VIP-4
    • VIP-5
    • VIP-Supreme
    • PRO-1
    • PRO-2
    • PRO-3
    • PRO-4
    • PRO-5

    smpType​

    • 默認: None
    • CancelMaker
    • CancelTaker
    • CancelBoth

    現貨交易手續費幣種說明​

    以BTCUSDT為例:

    • maker費率是否為正?
      • TRUE
        • 方向 = Buy -> 交易幣種 (BTC)
        • 方向 = Sell -> 報價幣種 (USDT)
      • FALSE
        • 是否是maker單 = TRUE
          • 方向 = Buy -> 報價幣種 (USDT)
          • 方向 = Sell -> 交易幣種 (BTC)
        • 是否是maker單 = FALSE
          • 方向 = Buy -> 交易幣種 (BTC)
          • 方向 = Sell -> 報價幣種 (USDT)
    - + \ No newline at end of file diff --git a/zh-TW/v5/error.html b/zh-TW/v5/error.html index fa1ca77519..f559e59283 100644 --- a/zh-TW/v5/error.html +++ b/zh-TW/v5/error.html @@ -4,13 +4,13 @@ 錯誤碼 | Bybit API Documentation - +

    錯誤碼

    HTTP 響應碼​

    響應碼描述
    400Bad request. 請檢查您的請求方式是否為GET / POST (必需大寫)
    401無效請求. 1. 請檢查是否為正確的API密鑰; 2. 請檢查是否將鑒權參數放在了請求頭裡
    403Forbidden request. 可能原因: 1. 違反了IP請求速率; 2. 您的GET請求裡帶了空的json體; 3. 您的請求發送自美國IP
    404無法找到路由. 可能原因: 1. 請檢查您的路由; 2. 帳戶模式不支持請求的category值
    429觸發系統層面的頻率保護, 請嘗試重試

    WS下單通用錯誤碼​

    響應碼描述
    104041. op類型未找到; 2. category不支持/未找到
    10429觸發系統級別的頻率保護
    20006reqId重複
    100161.內部錯誤; 2. 服務重啟
    10019ws下單服務正在重啟, 拒絕新的請求, 正在處理中的請求不受影響. 您可以重新/新建連接, 會分配到正常的服務上
    10003同一個uid上構建了過多會話

    UTA和經典帳戶​

    錯誤碼描述
    0OK
    10000服務超時
    10001請求參數錯誤。
    10002請求時間超出了時間視窗範圍。
    10003API金鑰無效。檢查使用的key是否與域名匹配, 共有4類環境: 主網mainnet, 測試網testnet, 主網模擬盤, 測試網模擬盤
    33004Your api key has expired API key已經過期
    10004錯誤簽名，請檢查簽名生成算灋。
    10005許可權被拒絕，請檢查您的API金鑰許可權。
    10006訪問次數太多。 超過API速率限制。
    10007用戶身份驗證失敗。
    10008當前帳戶模式無法訪問，請檢查您的帳戶模式
    10009IP已被禁止。
    10010IP不匹配，請檢查API金鑰的綁定IP地址。
    10014無效的重複請求。
    10016系統錯誤。
    10017未找到路由。
    10018超過IP速率限制。
    10024合規牆攔截。
    10027禁止交易。
    10028API只能由統一帳戶用戶訪問。
    10029交易對白名單限制，請求的交易對無效。
    100028統一帳戶用戶無法訪問API。
    30133OTC loan: The symbol you select for USDT Perpetual is not allowed by Institutional Lending 下單交易對不在機構借貸白名單內
    30134OTC loan: The symbol you select for USDC Contract is not allowed by Institutional Lending 下單交易對不在機構借貸白名單內
    30135The leverage you select for USDT Perpetual trading cannot exceed the maximum leverage allowed by Institutional Lending. 可設置的槓桿倍數不能超過機構借貸的上限
    30136The leverage you select for USDC Perpetual or Futures trading cannot exceed the maximum leverage allowed by Institutional Lending. 可設置的槓桿倍數不能超過機構借貸的上限
    40004the order is modified during the process of replacing 訂單已經到達終態, 無法修改
    110001訂單不存在
    110003訂單價格超出允許範圍。
    110004錢包餘額不足
    110005倉位狀態
    110006估計資產無法彌補頭寸差額
    110007可用餘額不足
    110008訂單已完成或取消。
    110009停止訂單的數量超過了允許的最大限制。 您可以從我們的OpenAPI檔案中找到參攷。
    110010訂單已取消
    110011此調整將立即觸發清算
    110012可用餘額不足。
    110013由於風險限制級別，無法設定杠杆。
    110014可用餘額不足，無法添加額外保證金。
    110015該倉位處於全倉保證金模式。
    110016請求的合約數量超過了風險限額，請在重試之前調整風險限額級別
    110017不滿足ReduceOnly規則。
    110018用戶id非法。
    110019訂單id非法。
    110020不允許有超過500個活動訂單。
    110021由於未平倉，不允許超過持倉限額。
    110022數量已受到限制，無法修改訂單以新增數量。
    110023現時你只能减少你在這份合約上的頭寸。 請查看我們的公告或聯系客服瞭解詳情。
    110024您有一個持倉，因此無法切換位置模式。
    110025倉位模式尚未修改。
    110026全倉/逐倉模式尚未修改。
    110027保證金尚未修改。
    110028您已有未結訂單，因此無法切換倉位模式。
    110029此符號不支持對沖模式。
    110030訂單ID重複
    110031不存在風險限額資訊，請檢查風險限額規則。
    110032訂單不合法
    110033沒有未平倉頭寸，您無法設定保證金
    110034沒有淨頭寸
    110035清算前未完成訂單取消
    110036由於交叉保證金模式，您不允許更改杠杆。
    110037用戶設置清單沒有此交易對
    110038由於投資組合保證金模式，您不允許更改杠杆率。
    110039維護保證金率過高。 這可能引發清算。
    110040訂單將觸發強制清算，請重新提交訂單。
    110041當存在倉位或maker訂單時，不允許跳過清算
    110042現時，由於預交割狀態，您只能减少您在本合約中的頭寸。
    110043設定杠杆尚未修改。
    110044可用保證金不足。
    110045錢包餘額不足。
    110046此調整將立即觸發清算。
    110047由於可用保證金不足，無法調整風險限額。
    110048由於當前/預期頭寸值超過修訂後的風險限額，因此無法調整風險限額。
    110049tick note只能是數位
    110050無效的幣種
    110051用戶的可用餘額不能覆蓋當前市場的最低價格
    110052您的可用餘額不足以設定價格
    110053用戶可用餘額不能覆蓋當前市場價格和上限價格
    110054此倉位至少有一個獲利連結訂單，因此無法切換獲利和止損模式
    110055此倉位至少有一個止損連結訂單，因此無法切換獲利和止損模式
    110056此倉位至少有一個尾隨止損連結訂單，因此無法切換獲利和止損模式
    110057條件訂單或限制訂單包含TP/SL相關參數
    110058由於剩餘倉位大小不足，您無法設定獲利和止損。
    110059不允許修改部分填寫的未結訂單的TP/SL
    110060在完全TP/SL模式下，不允許修改TP/SL
    110061部分tpSlMode下不允許有超過20個TP/SL
    110062未找到該機构的MMP資訊。
    110063結算正在進行中！ ｛｛key0｝｝不可用於交易。
    110064修改後的契约數量不能小於或等於成交的數量。
    110065尚未為您的帳戶啟用MMP。 請聯系您的BD經理。
    110066現時不允許交易。
    110067不支持統一帳戶。
    110068不允許杠杆交易。
    110069機構借貸客戶不得交易。
    110070ETP合約不能交易。
    110071抱歉，我們正在修改統一保證金帳戶！ 現時，不支持新的升級。 如果您有任何問題，請聯繫我們的24/7客戶支援。
    110072OrderLinkedID 不能重複
    110073設置保證金模式失敗. 請檢查響應裡的具體原因內容
    110075RiskId沒有修改
    110075 182021逐倉保證金模式下無法啟用槓桿交易. 請切換至全倉保證金或者組合保證金後再使用
    110076僅逐倉保證金下支持自動添加保證金
    110077組合保證金模式不支持此操作
    110078無法減少過多的保證金
    110079訂單正在處理中, 請稍後再試
    110080Operations Restriction: The current LTV ratio of your Institutional Lending has hit the liquidation threshold. Assets in your account are being liquidated. 目前機構借貸帳戶的LTV達到強平閾值 (交易/杠杆/风险限额等操作)
    110082You cannot lift Reduce-Only restrictions, as no Reduce-Only restrictions are applied to your position 您的倉位沒有受到Reduce-Only限制, 無需解禁
    110083Reduce-Only restrictions must be lifted for both Long and Short positions at the same time 對於多空倉位, Reduce-Only 限制需要同時解除
    110085The risk limit and margin ratio for this contract has been updated, please select a supported risk limit and place your order again 該合約的風險限額和保證金率已經更新, 請使用支持的風險限額並重新下單
    110086Current order leverage exceeds the maximum available for your current Risk Limit tier. Please lower leverage before placing an order 當前槓桿超過您當前風險限額等級的最大槓桿. 請降低槓桿後再重新下單
    110087Leverage for Perpetual or Futures contracts cannot exceed the maximum allowed for your Institutional loan 期貨的槓桿不能超過場外借貸產品規定的最大槓桿倍數
    110088Please Upgrade to UTA to trade 請升級到UTA後再進行交易
    110089Exceeds the maximum risk limit level 超過了最大風險限額等級
    110090Exceeds the maximum leverage limit of the current risk limit level.超過了當前風險限額等級支持的最大槓桿
    110092expect Rising, but trigger_price[XXXXX] <= current[XXXXX]??laste 期望趨勢上行觸發, 但是觸發價格小於當前的市場價格
    110093expect Falling, but trigger_price[XXXXX] >= current[XXXXX]??last 期望趨勢下行觸發, 但是觸發價格大於當前的市場價格
    110094Order notional value below the lower limit 訂單最小下單金額小於名義價值金額
    110095You cannot create, modify or cancel Pre-Market Perpetual orders during the Call Auction. 集合競價每個階段都有不同訂單操作要求
    110096Pre-Market Perpetual Trading does not support Portfolio Margin mode. 組合保證金模式不支持盤前交易
    110097Non-UTA users cannot access Pre-Market Perpetual Trading. To place, modify or cancel Pre-Market Perpetual orders, please upgrade your Standard Account to UTA. 經典帳戶不支持盤前交易
    110098Only Good-Till-Canceled (GTC) orders are supported during Call Auction. 集合競價階段僅支持GTC訂單
    110099You cannot create TP/SL orders during the Call Auction for Pre-Market Perpetuals. 集合競價階段不支持止盈止損、條件單
    110100You cannot place, modify, or cancel Pre-Market Perpetual orders when you are in Demo Trading. 模擬交易不支持盤前交易
    3100181uid can not be null uid 不能為空
    3100197由於升級UTA中, 用戶暫時被封禁
    3200316USDC Options Trading Restriction: The current LTV ratio for your Institutional Lending has reached the maximum allowable amount for USDC Options trading. 目前機構借貸風險水平無法進行期權交易
    3200317USDC Options Open Position Restriction: The current LTV ratio for your Institutional Lending has reached the maximum allowable amount for opening USDC Options positions.目前機構借貸風險水平無法進行期權買入
    3100326BaseCoin is required baseCoin必須傳
    3200403逐倉保證金模式下無法進行此產品交易
    3200419Unable to switch to Portfolio margin due to active pre-market Perpetual orders and positions 在有盤前永續訂單和倉位的情況下, 無法切換到PM模式
    3200320Operations Restriction: The current LTV ratio of your Institutional Lending has hit the liquidation threshold. Assets in your account are being liquidated. 目前機構借貸帳戶的LTV達到強平閾值 (修改保证金模式或者现货杠杆时)
    3400208您有未關閉的雙向持倉或逐倉模式下的USDT永續倉位
    3400209有USDT永續倉位時，小時整點的前後10分鐘禁止升級
    3400210您合約帳戶當前風險率過高
    3400211升級後，帳戶風險率過高
    3400212有USDC永續倉位或者期權倉位時，小時整點的前後10分鐘禁止升級
    3400213您USDC合約帳戶當前風險率過高
    3400052您有未取消的USDC永續掛單
    3400053您有未取消的期權掛單
    3400054您有未取消的USDT永續掛單
    3400214系統處理異常，請稍候再試
    3400071您未達到帳戶升級的資產要求，無法完成升級
    3401010Cannot switch to PM mode 無法切換到PM模式(帶單帳戶嘗試切換到PM模式)
    3400139The total value of your positions and orders has exceeded the risk limit for a Perpetual or Futures contract 當前PM模式下的倉位超過了全倉或者逐倉的最大允許風險限額
    181017OrderStatus must be final status 僅支持查詢終態
    182100Compulsory closing of positions, no repayment allowed 強平清算中, 不支持還款
    182101Failed repayment, insufficient collateral balance 試算抵押品餘額不足, 還款失敗
    182102Failed repayment, there are no liabilities in the current currency 該幣種不存在任何負債
    182103Institutional lending users are not supported 機構借貸用戶不支持一鍵還款
    182108Switching failed, margin verification failed, please re-adjust the currency status 保證金校驗失敗, 請檢查對應幣種的狀態
    182110Failed to switch 無法切換
    182111The requested currency has a non guaranteed gold currency or does not support switching status currencies 請求的幣種是非保證金幣種
    182112Duplicate currency, please re-adjust 重複的幣種, 請調整後重試

    現貨交易​

    錯誤碼描述
    170001openapi內部异常、及調用下游异常會拋出次异常
    170005限頻報錯
    170007調用下游超時
    170010杠杆代幣申購：超出持倉限額
    170011下單失敗，當前下單金額已超過該幣種可用額度
    170019黑名單用戶
    170031該功能已暫停
    170032下游熔斷錯誤碼
    170033保證金可用額度不足
    170034超出限額
    170035已提交系統處理（服務超時）
    170036未開通全倉杠杆
    170037所選幣種未開啟借貸
    170105參數為空
    170115無效的timeInForce
    170116無效的訂單類型
    170117無效的買賣方向
    170121下游返回的無效幣對
    170124訂單金額太大
    170130無效入参
    170131餘額不足
    170132下單價格太高
    170133下單價格太小
    170134訂單價格精度太大
    170135下單數量太大
    170136下單數量太小
    170137下單數量精度太大
    170139訂單已經成交
    170140訂單金額太小
    170141重複的clientOrderId
    170142訂單已經取消
    170143訂單取消時撮合不存在
    170144訂單被鎖定
    170145訂單類型不能取消
    170146下單超時
    170147取消訂單超時
    170148下單金額精度太大
    170149創建訂單失敗（下游發生未知异常）
    170150取消訂單失敗（下游發生未知异常）
    170151幣對未開放交易
    170157幣對不允許openapi交易
    170159開盤前五分鐘不允許下普通市價單
    170190取消訂單時訂單已經完成
    170191取消訂單時訂單狀態
    170192盤面風控（開盤後30分鐘）
    170193盤面風控限價單買入風控（開盤後前30分鐘）
    170194盤面風控片價單賣出風控（開盤後前X分鐘）
    170195ETP限價單買入偏離值風控
    170196ETP限價單賣出偏離值風控
    170197市價單買入偏離值風控
    170198市價單賣出偏離值風控
    170199ETP市價單買入偏離值風控
    170200ETP市價單賣出偏離值風控
    170201訂單種類錯誤
    170202請輸入觸發價格
    170203觸發價格大於110%
    170204觸發價格小於90%
    170206開倉前5分鐘不允許下條件單
    170207平台借貸池額度不足
    170210下單被拒絕
    170212Cancel order request processing 正在處理撤單請求
    170213訂單不存在
    170215Spot Trading (Buy) Restriction: The current LTV ratio of your institutional lending has reached the maximum allowable amount for buy orders 限制現貨買入交易, 因您當前機構借貸的LTV已觸發限制現貨買入風控線
    170216The leverage you select for Spot Trading cannot exceed the maximum leverage allowed by Institutional Lending OTC現貨切換槓桿超過機構借貸允許的槓桿上線
    170217openapi禁止成交
    170218limit-maker訂單被拒
    170219UID {{xxx}} is not available to this feature
    170220Spot Trading Restriction: The current LTV ratio of your institutional lending has reached the maximum allowable amount for Spot trading 限制現貨交易, 因您當前機構借貸的LTV已觸發限制現貨交易風控線
    170221幣種不存在
    170222請求過快
    170223場外借貸帳戶觸發告警或爆倉
    170224非創新區用戶
    170226全倉用戶帳戶爆倉中
    170227功能未開放
    170228買入額度超過預估最大買入額
    170229賣出數量超過預估最大賣出量
    170230Operations Restriction: Due to the deactivation of Margin Trading for institutional loan 機構借貸產品不支持現貨槓桿交易, 因此無法調用開關接口
    170234系統錯誤
    170241To proceed with trading, users must read through and confirm that they fully understand the project's risk disclosure document. For App users, please update your Bybit App to version 4.16.0 to process. 請先去前端頁面完成協議簽署
    170310Order modification timeout 改單超時
    170311Order modification failed 改單失敗
    170312The current order does not support modification 該訂單類型不支持修改
    170313The modified contract quantity cannot be less than to the filled quantity 修改後訂單數量小於當前已成交數量
    170341Request order quantity exceeds maximum limit 單次請求的訂單數量超過上限
    170344symbol loanable limit 該交借貸易對不可做爲保證金交易
    170709OTC loan: The select trading pair is not in the whitelist pair 該交易對不在機構借貸現貨交易白名單內
    170810Cannot exceed maximum of 500 conditional, TP/SL and active orders. 現貨交易,單帳戶單交易對支持最多500個活動單

    現貨槓桿代幣​

    錯誤碼描述
    175000serialNo已使用過
    175001今日申購限額不足,請稍候嘗試
    175002申購訂單積壓較多,請稍後重試
    175003餘額不足,請充值後重試
    175004今日贖回限額不足,請稍候重試
    175005贖回訂單積壓較多,請稍後重試
    175006餘額不足,請充值後重試
    175007此訂單不存在
    175008當前申購未開啟
    175009申購金額超出上限
    175010您還未通過風險測試無法參與槓桿代幣的申贖和交易,請先在網頁端完成練習
    175012當前贖回未開啟
    175013贖回數量超過上限
    175014申購入口暫時關閉
    175015贖回入口暫時關閉
    175016輸入值格式不符合要求：精度或長度超出
    175017下單失敗：超出槓桿代幣持倉最大限制，當前限制是XXXX USDT
    175027用戶處於UTA升級中

    槓桿交易​

    錯誤碼描述
    176002獲取用戶帳戶信息失敗, 檢查是否已經在web端完成quiz
    176003獲取用戶借款紀錄失敗
    176004獲取歷史紀錄的startTime大於endTime
    176005借款失敗
    176006還款失敗
    176007未找到借貸帳戶
    176008借貸帳戶未開通全倉槓桿,請先在web端完成練習
    176009借貸帳戶未打开全倉槓桿, 請先開啟全倉槓桿
    176010未找到借貸幣種
    176011幣種未開啟借貸
    176012未找到交易幣對
    176013交易比對未開啟借貸
    176014還款請求重複
    176015還款帳戶餘額不足
    176016無欠款,無需還款
    176017還款金額超過欠款金額
    176018用戶幣種已在還款中
    176019用戶還款計息強平衝突
    176020查詢不到還款紀錄
    176021借貸請求重複
    176022借貸幣種全量未開放
    176023交易對全量未開放
    176024借貸用戶狀態非正常
    176025借貸數量不能小於單詞最小借貸量
    176026借貸數量不能大於單次最大借貸量
    176027借貸數量不能大於平臺允許的單用戶最大借貸量
    176028借貸申請數量超過平臺最大借貸量
    176029借款申請數量超過用戶預估最大可借貸量
    176030獲取用戶借貸信息失敗
    176031借貸精度超過設置精度
    176034杠杆倍數超出範圍
    176035清算中，關閉杠杆開關失敗
    176036强平中，調整杠杆開關失敗
    176037非統一交易用戶，操作失敗
    176038現貨杠杆為關閉狀態，不允許當前操作
    176039借貸中，不允許當前操作
    176040存在現貨杠杆訂單，調整杠杆開關失敗！
    176132還款精度過高
    176133可能觸發爆倉！ 請調整您的交易金額後重試
    176134帳戶已經陞級（upgrading）到UTA
    176135獲取保證金幣種失敗，請稍後重試
    176136獲取借貸幣種失敗，請稍後重試
    176137切換全倉狀態失敗，請稍後重試
    176138在關閉禁用的全倉保證金帳戶之前，您需要償還所有債務
    176139抱歉，您沒有資格啟用全倉保證金，因為您已經啟用了場外借貸
    176201Account exception. 確認是否是綁定了機構借貸的帳戶
    182104This action could not be completed as your Unified Margin Account's IM/MM utilization rate has exceeded the threshold
    182105Adjustment failed, user is upgrading
    182106Adjustment failed, user forced liquidation in progress.
    182107Adjustment failed, Maintenance Margin Rate too high

    資產服務​

    錯誤碼描述
    131001openapi svc error 內部服務錯誤
    131002參數錯誤
    131002Withdraw address chain or destination tag are not equal 需要檢查提幣地址是否添加到網頁端的地址簿中, 以及是否存在tag
    131003內部錯誤
    131004需要KYC認證
    131066This address does not support withdrawals for the time being. Please switch to another address for withdrawing 目標地址被列入黑名單, 請使用其他地址
    131067Travel rule verification failed, please contact the target exchange. Travel rule for KR user
    131068Travel rule information is insufficient, please provide additional details. Travel rule for KR user
    131069Unable to withdraw to the receipt, please contact the target the exchange. Travel rule for KR user
    131070The recipient's name is mismatched with the targeted exchange. Travel rule for KR user
    131071The recipient has not undergone KYC verification. Travel rule for KR user
    131072Your withdrawal currency is not supported by the target exchange. Travel rule for KR user
    131073Your withdrawal address has not been included in the target exchange. Travel rule for KR user
    131074Beneficiary info is required, please refer to the latest api document. Travel rule for KR user
    131075Internal address cannot be yourself 內部提現時目標UID不能是自身
    131076internal transfer not support sub-accounts 內部提現不支持提幣到子帳戶
    131077receive user not exist 接收方UID不再村
    131078receive user deposit has been banned 接收方被禁止入金
    131079receive user need kyc 接收方需要做KYC
    131080User left retry times is zero 所剩的重試次數為0
    131081Do not input memo/tag,please. 不要輸入memo/tag
    131082Do not repeat the request 不要重複發送請求
    131083Withdraw only allowed from address book 僅能提幣到地址簿中的地址
    131084uta upgrading, and withdraw is prohibited UTA升級中, 無法提現
    131085提幣金額大於可用餘額，觸發延遲提幣
    131086提幣金額超過風控限制，觸發全倉槓桿限制
    131087your current account spot risk level is too high, withdrawal is prohibited, please adjust and try again
    131088提幣金額超過當前KYC限額，您目前的可提限額是: %s
    131089用戶24小時內進行過銘感操作，提現被禁
    131090用戶提現封禁
    131091用戶登陸封禁，無法提幣
    131092用戶狀態異常
    131093提幣地址不在白名單內
    131094用戶ID不在白名單內
    131095提幣金額超過平台24小時限額
    131096檢查提幣金額是否滿足最小最大可提金額
    131097系統暫停提幣
    131098當前時間禁止從新地址提幣
    131099當前狀態不支持取消提幣請求
    131200服務不可用
    131201業務異常
    131202用戶ID無效
    131203請求參數錯誤
    131204帳戶異常
    131205查詢劃轉失敗
    131206劃轉失敗
    131207帳戶不存在
    131208劃轉封禁
    131209查詢子帳戶關係失敗
    131210金額精度錯誤
    131211轉入賬戶類型不能作為轉出賬戶類型
    131212可用餘額不足
    131213當前劃轉能力受到LTV風險率限制
    131214劃轉ID已存在
    131215金額錯誤
    131216查詢余額錯誤
    131217風險檢查失敗
    131227子帳戶未配置萬能劃轉能力
    131228可劃轉餘額不足. 請確認延遲提幣安全限額
    131229Due to compliance requirements, the current currency is not allowed to transfer 根據合規要求, 該資產不允許劃轉
    131230The system is busy, please try again later 系統繁忙, 請重試
    131231Transfers into this account are not supported 限制劃入這個帳戶
    131232Transfers out this account are not supported 限制劃出這個帳戶
    140001Switching the PM spot hedging switch is not allowed in non PM mode 僅支持在組合保證金模式下開啟現貨對衝
    140002Institutional lending users do not support PM spot hedging 機構借貸帳戶不支持現貨对冲
    140003You have position(s) being liquidated, please try again later. 您的倉位正在被清算, 請稍候再試
    140004Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.
    140005Risk level after switching modes exceeds threshold 在啟用或關閉現貨對衝後, 風險水位超出警戒線
    141004sub member is not normal 可能是帳戶的母子關係不正確
    141025This sub-account has assets and cannot be deleted 該子帳戶存在資產, 無法刪除
    181000category不能為空
    181001類別僅支持正向合約，期權或現貨
    181002symbol不能為空.
    181003side不能為空.
    181004side僅支持Buy或者Sell
    181005orderStatus所填的枚舉值不正確
    181006startTime所傳入的不是一個數字類型
    181007endTime所傳入的不是一個數字類型
    181008入參startTime和endTime都需要
    181009入參startTime應當小於結束時間
    181010startTime和endTime的間隔不能超過7天
    181011limit所傳入的不是一個數字類型
    181012該交易對名不存在
    181013結算幣種僅支持USDC
    181014Classic account is not supported 經典帳戶不支持
    181018Invalid expDate. 參數expDate輸入值無效
    181019Parameter expDate can't be earlier than 2 years 參數expDate不能早於2年
    182000交易品種相關報價不能為空
    182200Please upgrade UTA first 请升级到统一账户
    182201You must enter 2 time parameters 时间入参必须成对出现
    182202The start time must be less than the end time 开始时间必须小于结束时间
    182203Please enter valid characters
    182204Coin does not exist
    182205User level does not exist vip等级不存在
    700000accountType/quoteTxId cannot be null
    700001quote fail:no dealer can used報價失敗
    700004order does not exist訂單不存在
    700007Large Amount Limit大額限制

    機構借貸​

    錯誤碼描述
    3777002UID cannot be bound repeatedly. UID不能重複綁定
    3777003UID cannot be unbound because the UID has not been bound to a risk unit. 無法解綁, 因為UID還沒有在風險單元內
    3777004The main UID of the risk unit cannot be unbound. 風險單元主UID不允許解綁
    3777006UID cannot be bound, please try again with a different UID." 導致的原因: 1. 請求接口的UID不是風險單元內的UID; 2. 請求接口的UID與被操作的UID不存在母子或子子關係
    3777005You have unsettled lending or borrowing orders. Please try again later.存在未結算的借出或借入訂單，請稍後重試
    3777007UID cannot be bound, please upgrade to UTA Pro." UID無法綁定, 請先將該UID升級到統一帳戶
    3777027UID cannot be bound, leveraged trading closure failed. UID無法綁定, 因為無法自動關閉槓桿交易
    3777029You currently have orders for pre-market trading that can’t be bind UIDs 由於當前存在盤前交易訂單，所以無法綁定UID
    3777030This account has activated copyPro and cannot bind uid 該帳戶已經激活了copy pro, 無法綁定到機構借貸

    經紀商​

    錯誤碼描述
    3500402limit值校驗失敗. 請檢查是否在支持範圍內
    3500403僅適用於經紀商的主帳戶
    3500404無效的cursor
    3500405startTime和endTime必須同時傳入
    3500406Out of query time range. 超過了支持的時間範圍
    3500407Parameter begin and end need to be input in pairs.
    - + \ No newline at end of file diff --git a/zh-TW/v5/guide.html b/zh-TW/v5/guide.html index 6f953481f2..a4281b198c 100644 --- a/zh-TW/v5/guide.html +++ b/zh-TW/v5/guide.html @@ -4,7 +4,7 @@ 接入指南 | Bybit API Documentation - + @@ -14,7 +14,7 @@ server_time - recv_window <= timestamp < server_time + 1000
    其中server_time是Bybit服務器時間，您可以通過Bybit服務器時間接口獲取.

    構建請求​

    提示

    為了幫助診斷高級網絡問題，您可以考慮將cdn-request-id添加到您的請求頭中。對於每個請求，它的值應該是唯一的。.

    基本步驟:

    1. 時間戳 + API key + [recv_window]+ [queryString(無需排序) | jsonBodyString]
    2. 使用HMAC_SHA256或者RSA_SHA256算法對第1步中拼接的string簽名，並轉換為16進製字符串(HMAC_SHA256) / Base64編碼 (RSA_SHA256)，得出sign參數。
    3. 添加生成的簽名到HTTP頭當中 注意: GET和POST請求的加密明文是不相同，請參考以下示例.
    信息
    簽名計算示例

    對明文加密的示例

    # 拼接規則:
    timestamp+api_key+recv_window+queryString

    # 明文
    "1658384314791XXXXXXXXXX5000category=option&symbol=BTC-29JUL22-25000-C"

    # 解析
    timestamp = "1658384314791"
    api_key = "XXXXXXXXXX"
    recv_window = "5000"
    queryString = "category=option&symbol=BTC-29JUL22-25000-C"

    http請求示例

    GET /v5/order/realtime?category=option&symbol=BTC-29JUL22-25000-C HTTP/1.1
    Host: api-testnet.bybit.com
    -H 'X-BAPI-SIGN: XXXXXXXXXX' \
    -H 'X-BAPI-API-KEY: XXXXXXXXXX' \
    -H 'X-BAPI-TIMESTAMP: 1658384431891' \
    -H 'X-BAPI-RECV-WINDOW: 5000'

    外層通用數據結構​

    參數類型說明
    retCodenumber成功/錯誤碼
    retMsgstring成功/錯誤消息. 成功消息可以是OK,success,SUCCESS
    resultObject業務數據體
    retExtInfoObject額外信息. 大部分場景下都是{}
    timenumber當前時間戳 (毫秒)
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
        },
        "retExtInfo": {},
        "time": 1671017382656
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/intro.html b/zh-TW/v5/intro.html index e9dbad8500..8de3a30080 100644 --- a/zh-TW/v5/intro.html +++ b/zh-TW/v5/intro.html @@ -4,7 +4,7 @@ 概覽 | Bybit API Documentation - + @@ -23,7 +23,7 @@ 參考 websocket 接口文檔的描述。同時 orderbook 中增加可用於校驗數據連續性的 updateId 來判斷 orderbook 的數據是否丟失，用於您維護本地 正確的 orderbook。以及增加 seq（Sequence）字段用於您判斷不同檔位推送的數據先後對比，以更快的響應行情變化。

    業務線1檔25檔50檔100檔200檔500檔
    現貨10ms-20ms---
    期貨10ms-20ms-100ms100ms
    期權-20ms-100ms--

    提升 PostOnly 單筆下單數量​

    針對期貨業務，提交 Post Only 類型的訂單，可以獲得單筆下單更多的數量，通常是普通訂單數量的 5倍。可以通過衍生品交易規格接口獲取 單個 symbol 可以交易的最大下單數量。

    數據精度統一規範​

    在之前的 API 中，會返回 E2 ，E8 類型的數據。在 V3 和 V5 版本，返回的所有數值都是實際數值，您不需要做轉換調整。

    Open API 文檔可讀性提升​

    Open API 文檔梳理和校對，將大部分之前文檔描述不清晰的部分進行了改善，減少客戶對接的困惑。

    V5 和 V3 接口映射列表：​

    模塊V5接口V3接口
    公有行情/v5/market/kline/derivatives/v3/public/kline
    /spot/v3/public/quote/kline
    /v5/market/mark-price-kline/derivatives/v3/public/mark-price-kline
    /v5/market/index-price-kline/derivatives/v3/public/index-price-kline
    /v5/market/premium-index-price-kline/derivatives/v3/public/premium-index-price-kline
    /v5/market/orderbook/derivatives/v3/public/order-book/L2
    /spot/v3/public/quote/depth
    /v5/market/tickers/derivatives/v3/public/tickers
    /spot/v3/public/quote/ticker/24hr
    /spot/v3/public/quote/ticker/price
    /spot/v3/public/quote/ticker/bookTicker
    /v5/market/funding/history/derivatives/v3/public/funding/history-funding-rate
    /v5/market/recent-trade/derivatives/v3/public/recent-trade
    /spot/v3/public/quote/trades
    /v5/market/open-interest/derivatives/v3/public/open-interest
    /v5/market/historical-volatility/derivatives/v3/public/historical-volatility
    /v5/market/insurance/derivatives/v3/public/insurance
    /v5/market/instruments-info/derivatives/v3/public/instruments-info
    /spot/v3/public/infos
    /spot/v3/public/symbols
    /v5/market/risk-limit/derivatives/v3/public/risk-limit/list
    /v5/market/delivery-price/derivatives/v3/public/delivery-price
    交易/v5/order/create/unified/v3/private/order/create
    /contract/v3/private/order/create
    /v5/order/amend/unified/v3/private/order/replace
    /contract/v3/private/order/replace
    /v5/order/cancel/unified/v3/private/order/cancel
    /contract/v3/private/order/cancel
    /v5/order/realtime/unified/v3/private/order/unfilled-orders
    /contract/v3/private/order/unfilled-orders
    /v5/order/cancel-all/unified/v3/private/order/cancel-all
    /contract/v3/private/order/cancel-all
    /v5/order/history/unified/v3/private/order/list
    /contract/v3/private/order/list
    /v5/order/create-batch/unified/v3/private/order/create-batch
    /v5/order/amend-batch/unified/v3/private/order/replace-batch
    /v5/order/cancel-batch/unified/v3/private/order/cancel-batch
    /v5/order/spot-borrow-check無
    持倉/v5/position/list/unified/v3/private/position/list
    /contract/v3/private/position/list
    /v5/position/set-leverage/unified/v3/private/position/set-leverage
    /contract/v3/private/position/set-leverage
    /v5/position/set-risk-limit/unified/v3/private/position/set-risk-limit
    /contract/v3/private/position/set-risk-limit
    /v5/position/trading-stop/unified/v3/private/position/trading-stop
    /contract/v3/private/position/trading-stop
    /v5/position/switch-isolated/contract/v3/private/position/switch-isolated
    /v5/position/switch-mode/contract/v3/private/position/switch-mode
    /v5/position/set-auto-add-margin/contract/v3/private/position/set-auto-add-margin
    /v5/position/closed-pnl/contract/v3/position/closed-pnl
    /v5/execution/list/unified/v3/private/execution/list
    /contract/v3/private/execution/list
    帳戶/v5/account/wallet-balance/unified/v3/private/account/wallet/balance
    /contract/v3/private/account/wallet/balance
    /v5/account/upgrade-to-uta/unified/v3/private/account/upgrade-unified-account
    /v5/account/borrow-history/unified/v3/private/account/borrow-history
    /v5/account/collateral-info/unified/v3/private/account/borrow-rate
    /v5/asset/coin-greeks無
    /v5/account/info無
    /v5/account/transaction-log/unified/v3/private/account/transaction-log
    /v5/account/set-margin-mode/contract/v3/private/account/setMarginMode
    槓桿代幣/v5/spot-lever-token/info/spot/v3/public/infos
    /v5/spot-lever-token/reference/spot/v3/private/order/reference
    /v5/spot-lever-token/purchase/spot/v3/private/order/purchase
    /v5/spot-lever-token/redeem/spot/v3/private/order/redeem
    /v5/spot-lever-token/order-record/spot/v3/private/order/record
    全倉槓桿/v5/spot-margin-trade/switch-mode/spot/v3/private/cross-margin-switch
    /v5/spot-margin-trade/set-leverage無
    /v5/spot-margin-trade/set-pledge-token無
    資產/v5/asset/delivery-record/unified/v3/private/delivery-record
    /v5/asset/settlement-record/unified/v3/private/settlement-record
    /v5/asset/transfer/inter-transfer/asset/v3/private/transfer/inter-transfer
    v5/asset/transfer/query-inter-transfer-list/asset/v3/private/transfer/inter-transfer/list/query
    v5/asset/transfer/save-transfer-sub-member/asset/v3/private/transfer/transfer-sub-member-save
    /v5/asset/transfer/universal-transfer/asset/v3/private/transfer/universal-transfer
    /v5/asset/transfer/query-universal-transfer-list/asset/v3/private/transfer/universal-transfer/list/query
    /v5/asset/transfer/query-transfer-coin-list/asset/v3/private/transfer/transfer-coin/list/query
    /v5/asset/transfer/query-sub-member-list/asset/v3/private/transfer/sub-member/list/quer
    /v5/asset/transfer/query-account-coin-balance/asset/v3/private/transfer/account-coin/balance/query
    /v5/asset/transfer/query-asset-info/asset/v3/private/transfer/asset-info/query
    /v5/asset/deposit/query-allowed-list/asset/v3/public/deposit/allowed-deposit-list/query
    /v5/asset/deposit/query-record/asset/v3/private/deposit/record/query
    /v5/asset/deposit/query-sub-member-record/asset/v3/private/deposit/sub-member-record/query
    /v5/asset/withdraw/query-record/asset/v3/private/withdraw/record/query
    /v5/asset/coin/query-info/asset/v3/private/coin-info/query
    /v5/asset/withdraw/create/asset/v3/private/withdraw/create
    /v5/asset/withdraw/cancel/asset/v3/private/withdraw/cancel
    /v5/asset/deposit/query-address/asset/v3/private/deposit/address/query
    /v5/asset/deposit/query-sub-member-address/asset/v3/private/deposit/sub-member-address/query
    /v5/asset/exchange/order-record/asset/v2/private/exchange/query-exchange-order
    WebSocket公共頻道wss://stream.bybit.com/v5/public/spotwss://stream.bybit.com/spot/public/v3
    wss://stream.bybit.com/v5/public/linearwss://stream.bybit.com/contract/usdt/public/v3
    wss://stream.bybit.com/contract/usdc/public/v3
    wss://stream.bybit.com/v5/public/inversewss://stream.bybit.com/contract/inverse/public/v3
    wss://stream.bybit.com/v5/public/optionwss://stream.bybit.com/option/usdc/public/v3
    WebSocket私有頻道wss://stream.bybit.com/v5/privatewss://stream.bybit.com/spot/private/v3
    wss://stream.bybit.com/unified/private/v3
    wss://stream.bybit.com/contract/private/v3
    - + \ No newline at end of file diff --git a/zh-TW/v5/lt/leverage-token-info.html b/zh-TW/v5/lt/leverage-token-info.html index d5904cc14e..1e780b1900 100644 --- a/zh-TW/v5/lt/leverage-token-info.html +++ b/zh-TW/v5/lt/leverage-token-info.html @@ -4,13 +4,13 @@ LT全量資產查詢 | Bybit API Documentation - +

    LT全量資產查詢

    查詢槓桿代幣信息

    HTTP 請求​

    GET /v5/spot-lever-token/info

    請求參數​

    參數是否必需類型說明
    ltCoinfalsestringLT資產名稱，例如BTC3L

    響應參數​

    參數類型說明
    listarrayObject
    > ltCoinstring槓桿代幣資產簡稱
    > ltNamestring槓桿代幣資產全稱
    > maxPurchasestring單次最大申購金額
    > minPurchasestring單次最小申購金額
    > maxPurchaseDailystring單個自然日最大申購金額
    > maxRedeemstring單次最大贖回數量
    > minRedeemstring單次最小贖回數量
    > maxRedeemDailystring單個自然日最大贖回數量
    > purchaseFeeRatestring申購費率
    > redeemFeeRatestring贖回費率
    > ltStatusstring目前杠桿代幣資產是否可以進行申購贖回
    > fundFeestring每天針對持有槓桿代幣資產的用戶收取的資金費用
    > fundFeeTimenumber收取資金費用的時間
    > manageFeeRatestring管理費率
    > manageFeeTimenumber收取資金管理費的時間
    > valuestring名義資產規模
    > netValuestring當前淨值
    > totalstring平台申購總量上限

    請求示例​

    GET /v5/spot-lever-token/info?ltCoin=BTC3L HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "fundFee": "299.70622821",
                    "fundFeeTime": "1672992000000",
                    "ltCoin": "BTC3L",
                    "ltName": "3X Long",
                    "ltStatus": "1",
                    "manageFeeRate": "0.00005",
                    "manageFeeTime": "1673053200000",
                    "maxPurchase": "10000",
                    "maxPurchaseDaily": "200000",
                    "maxRedeem": "14434",
                    "maxRedeemDaily": "2100000",
                    "minPurchase": "100",
                    "minRedeem": "144",
                    "netValue": "0.376482201140738147",
                    "purchaseFeeRate": "0.0005",
                    "redeemFeeRate": "0.0005",
                    "total": "5000000",
                    "value": "49464463114.022994974075443169"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672991427073
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/lt/leverage-token-reference.html b/zh-TW/v5/lt/leverage-token-reference.html index 6ca3a6bccd..97a6f6c8e4 100644 --- a/zh-TW/v5/lt/leverage-token-reference.html +++ b/zh-TW/v5/lt/leverage-token-reference.html @@ -4,13 +4,13 @@ 查詢LT行情 | Bybit API Documentation - +

    查詢LT行情

    查詢LT行情

    HTTP 請求​

    GET /v5/spot-lever-token/reference

    請求參數​

    參數是否必需類型說明
    ltCointruestringLT資產名稱，例如BTC3L

    響應參數​

    參數類型說明
    ltCoinstring槓桿代幣資產簡稱
    navstring淨值
    navTimestring淨值更新時間戳UTC毫秒
    circulationstring在二級市場流通的代幣數量
    basketstring籃子
    leveragestring真實槓桿倍數

    請求示例​

    GET /v5/spot-lever-token/reference?ltCoin=BTC3S HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "basket": "-132.460000082171973364",
            "circulation": "30097.901900052619091704",
            "leverage": "-2.666924651755770729",
            "ltCoin": "BTC3S",
            "nav": "27.692082719770373048",
            "navTime": "1672991679858"
        },
        "retExtInfo": {},
        "time": 1672991679937
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/lt/order-record.html b/zh-TW/v5/lt/order-record.html index dbad04fe91..db7091db90 100644 --- a/zh-TW/v5/lt/order-record.html +++ b/zh-TW/v5/lt/order-record.html @@ -4,13 +4,13 @@ 申贖記錄查詢 | Bybit API Documentation - +

    申贖記錄查詢

    申贖記錄查詢

    HTTP 請求​

    GET /v5/spot-lever-token/order-record

    請求參數​

    參數是否必需類型說明
    ltCoinfalsestringLT資產名稱，例如BTC3L
    orderIdfalsestring訂單ID
    startTimefalselong起始時間
    endTimefalselong截止時間
    limitfalseint每頁數量限制。返回數據最大500條. 默認返回100條
    ltOrderTypefalseint訂單類型 1: 申購, 2: 贖回
    serialNofalsestring序列號

    響應參數​

    參數類型說明
    listarrayObject
    > ltCoinstring槓桿代幣資產簡稱
    > orderIdstring訂單ID
    > ltOrderTypestring訂單類型 1: 申購, 2: 贖回
    > orderTimenumber下單時間
    > updateTimenumber訂單狀態最後一次更新時間
    > ltOrderStatusstring訂單狀態：1: 已成交, 2: 等待中, 3`: 失敗
    > feestring交易手續費
    > amountstring下單的槓桿代幣資產數量
    > valuestring成交價值
    > valueCoinstring報價幣種
    > serialNostring序列號

    請求示例​

    GET /v5/spot-lever-token/order-record?orderId=2611 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672294422027
    X-BAPI-SIGN: XXXXX
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "amount": "222.90757477",
                    "fee": "0",
                    "ltCoin": "EOS3L",
                    "ltOrderStatus": "1",
                    "ltOrderType": "1",
                    "orderId": "3016",
                    "orderTime": "1672737465000",
                    "serialNo": "pruchase-002",
                    "updateTime": "1672737478000",
                    "value": "95.13860435",
                    "valueCoin": "USDT"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672294446137
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/lt/purchase.html b/zh-TW/v5/lt/purchase.html index cf94443fdf..9bd92390c5 100644 --- a/zh-TW/v5/lt/purchase.html +++ b/zh-TW/v5/lt/purchase.html @@ -4,13 +4,13 @@ 申購 | Bybit API Documentation - +

    申購

    申購

    HTTP 請求​

    POST /v5/spot-lever-token/purchase

    請求參數​

    參數是否必需類型說明
    ltCointruestringLT資產名稱，例如BTC3L
    ltAmounttruestring申購金額
    serialNofalsestring序列號，即自定義訂單號

    響應參數​

    參數類型說明
    ltCoinstring槓桿代幣資產簡稱
    ltOrderStatusstring申購單狀態：1: 已完成,2: 處理中 3: 失敗
    execQtystring實際成交的槓桿代幣資產數量
    execAmtstring實際成交金額
    amountstring下單的報價幣種金額
    purchaseIdstring訂單id
    serialNostring序列號
    valueCoinstring報價幣種

    請求示例​

    POST /v5/spot-lever-token/purchase HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672294730346
    X-BAPI-SIGN: XXXXX
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "ltCoin": "EOS3L",
        "amount": "200",
        "serialNo": "purchase-001"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "amount": "200",
            "execAmt": "",
            "execQty": "",
            "ltCoin": "EOS3L",
            "ltOrderStatus": "2",
            "purchaseId": "2611",
            "serialNo": "pruchase-001",
            "valueCoin": "USDT"
        },
        "retExtInfo": {},
        "time": 1672293867729
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/lt/redeem.html b/zh-TW/v5/lt/redeem.html index 1519ed506c..bdee4d3e8e 100644 --- a/zh-TW/v5/lt/redeem.html +++ b/zh-TW/v5/lt/redeem.html @@ -4,13 +4,13 @@ 贖回 | Bybit API Documentation - +

    贖回

    贖回

    HTTP 請求​

    POST /v5/spot-lever-token/redeem

    請求參數​

    參數是否必需類型說明
    ltCointruestringLT資產名稱，例如BTC3L
    quantityturestring贖回代幣數量
    serialNofalsestring序列號

    響應參數​

    參數類型說明
    ltCoinstring槓桿代幣資產簡稱
    ltOrderStatusstring申購單狀態. 1: 已完成, 2: 等待中, 3: 失敗
    quantitystring數量
    execQtystring訂單數量
    execAmtstring實際成交的金額
    redeemIdstring交易單號
    serialNostring序列號
    valueCoinstring報價幣種

    請求示例​

    POST /v5/spot-lever-token/redeem HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672296416024
    X-BAPI-SIGN: XXXXX
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "ltCoin": "EOS3L",
        "quantity": "150",
        "serialNo": "redeem-001"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "execAmt": "",
            "execQty": "150",
            "ltCoin": "EOS3L",
            "ltOrderStatus": "2",
            "quantity": "",
            "redeemId": "2619",
            "serialNo": "redeem-001",
            "valueCoin": "EOS3L"
        },
        "retExtInfo": {},
        "time": 1672296417363
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/delivery-price.html b/zh-TW/v5/market/delivery-price.html index 03652168a7..9f7a8f6c21 100644 --- a/zh-TW/v5/market/delivery-price.html +++ b/zh-TW/v5/market/delivery-price.html @@ -4,13 +4,13 @@ 查詢交割價格 | Bybit API Documentation - +

    查詢交割價格

    查詢平台交割產品的交割價格，支持反向交割, USDC交割和期權

    覆蓋範圍: USDC交割 / 反向交割 / 期權

    信息
    • 期權: 當不指定symbol時, 僅返回處於交割中狀態的(UTC8~UTC12)的數據

    HTTP請求​

    GET /v5/market/delivery-price

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, inverse, option
    symbolfalsestring合約名稱
    baseCoinfalsestring交易貨幣. 默認: BTC. 僅支持option
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 50
    cursorfalsestring游標，用於分頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > deliveryPricestring交割價格
    > deliveryTimestring交割時間戳 (毫秒)
    nextPageCursorstring游標，用於分頁

    請求示例​

    GET /v5/market/delivery-price?category=option&symbol=ETH-26DEC22-1400-C HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "category": "option",
            "nextPageCursor": "",
            "list": [
                {
                    "symbol": "ETH-26DEC22-1400-C",
                    "deliveryPrice": "1220.728594450",
                    "deliveryTime": "1672041600000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672055336993
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/history-fund-rate.html b/zh-TW/v5/market/history-fund-rate.html index f53f45478c..273807fb6e 100644 --- a/zh-TW/v5/market/history-fund-rate.html +++ b/zh-TW/v5/market/history-fund-rate.html @@ -4,13 +4,13 @@ 查詢歷史資金費率 | Bybit API Documentation - +

    查詢歷史資金費率

    查詢資金費率，每個symbol的資金費率產生週期不同。假設資金費率為8小時，當前時間是UTC12點，則返回的是上一個結算即UTC8點產生的資金費率。如要查詢symbol的資金費率時間間隔，請查詢可交易產品規格接口

    覆蓋範圍: USDT和USDC永續 / 反向永續

    時間入参規則
    • 只傳startTime會報錯
    • 只傳endTime，則返回endTime往前的200條數據
    • 都不傳，返回當前時間的往前200條數據

    HTTP請求​

    GET /v5/market/funding/history

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear,inverse
    symboltruestring合約名稱
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 200

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > fundingRatestring資金費率
    > fundingRateTimestampstring資金費率時間戳 (毫秒)

    請求示例​

    GET /v5/market/funding/history?category=linear&symbol=ETHPERP&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                    "symbol": "ETHPERP",
                    "fundingRate": "0.0001",
                    "fundingRateTimestamp": "1672041600000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672051897447
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/index-kline.html b/zh-TW/v5/market/index-kline.html index 5a2646e2ce..266ddcba21 100644 --- a/zh-TW/v5/market/index-kline.html +++ b/zh-TW/v5/market/index-kline.html @@ -4,13 +4,13 @@ 查詢指數價格K線數據 | Bybit API Documentation - +

    查詢指數價格K線數據

    查詢指數價格K線

    覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約

    HTTP請求​

    GET /v5/market/index-price-kline

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse
  • 當category不指定時, 默認是linear
    • symboltruestring合約名稱
    intervaltruestring時間粒度. 1,3,5,15,30,60,120,240,360,720,D,M,W
    startfalseinteger開始時間戳 (毫秒)
    endfalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 200

    響應參數​

    參數類型說明
    categorystring產品類型
    symbolstring合約名稱
    listarray
    • 一個字符串數組構成單個蠟燭
    • 按照startTime降序排列
    > list[0]: startTimestring蠟燭的開始時間戳 (毫秒)
    > list[1]: openPricestring開始價格
    > list[2]: highPricestring最高價格
    > list[3]: lowPricestring最低價格
    > list[4]: closePricestring結束價格. 如果蠟燭尚未結束，則表示為最新成交價格

    請求示例​

    GET /v5/market/index-price-kline?category=inverse&symbol=BTCUSDZ22&interval=1&start=1670601600000&end=1670608800000&limit=2 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDZ22",
            "category": "inverse",
            "list": [
                [
                    "1670608800000",
                    "17167.00",
                    "17167.00",
                    "17161.90",
                    "17163.07"
                ],
                [
                    "1670608740000",
                    "17166.54",
                    "17167.69",
                    "17165.42",
                    "17167.00"
                ]
            ]
        },
        "retExtInfo": {},
        "time": 1672026471128
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/instrument.html b/zh-TW/v5/market/instrument.html index c0a207dc13..44f5992e6d 100644 --- a/zh-TW/v5/market/instrument.html +++ b/zh-TW/v5/market/instrument.html @@ -4,13 +4,13 @@ 查詢可交易產品的規格信息 | Bybit API Documentation - +

    查詢可交易產品的規格信息

    查詢全站可交易產品的基礎配置規則信息

    覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權

    警告
    • 現貨不支持翻頁，因此limit, cusor無效.
    • 當通過baseCoin查詢時, 不管category=linear或inverse, 返回結果中都會包含USDT永續, USDC永續, USDC交割和反向合約的交易對.

    HTTP請求​

    GET /v5/market/instruments-info

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. spot,linear,inverse,option
    symbolfalsestring合約名稱
    statusfalsestring交易對狀態篩選
    • 現貨 僅有Trading狀態
    • status=PreLaunch&category=linear, 可以查詢到盤前交易的永續合約
    baseCoinfalsestring交易貨幣. 僅對期貨/期權有效
  • 對於期權, 默認返回baseCoin為BTC的
    • limitfalseinteger每頁數量限制. [1, 1000]. 默認: 500
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listarrayObject
    > symbolstring合約名稱
    > contractTypestring合約類型
    > statusstring合約狀態
    > baseCoinstring交易幣種
    > quoteCoinstring報價幣種
    > launchTimestring發佈時間 (ms)
    > deliveryTimestring交割時間 (ms). 僅對交割合約有效
    > deliveryFeeRatestring交割費率. 僅對交割合約有效
    > priceScalestring價格精度
    > leverageFilterObject槓桿屬性
    >> minLeveragestring最小槓桿
    >> maxLeveragestring最大槓桿
    >> leverageStepstring修改槓桿的步長
    > priceFilterObject價格屬性
    >> minPricestring訂單最小價格
    >> maxPricestring訂單最大價格
    >> tickSizestring修改價格的步長
    > lotSizeFilterObject訂單數量屬性
    >> maxOrderQtystring單筆限價或PostOnly單最大下單量
    >> maxMktOrderQtystring單筆市價單最大下單量
    >> minOrderQtystring單筆訂單最小下單量
    >> qtyStepstring修改下單量的步長
    >> postOnlyMaxOrderQtystring廢棄, 請參照maxOrderQty
    >> minNotionalValuestring訂單最小名義價值
    > unifiedMarginTradeboolean是否支持統一保證金交易
    > fundingIntervalinteger資金費率結算週期 (分鐘)
    > settleCoinstring結算幣種
    > copyTradingstring當前交易對是否支持帶單交易
    > upperFundingRatestring資金費率上限
    > lowerFundingRatestring資金費率下限
    > isPreListingboolean
  • 該合約是否為盤前合約
  • 當盤前合約轉為正式合約後, 值將變成false
    • > preListingInfoobject
  • 如果isPreListing=false, preListingInfo=null
  • 如果isPreListing=true, preListingInfo是object
    • >> curAuctionPhasestring當前的盤前階段
    >> phasesarray<object>每個階段的時間信息
    >>> phasestring盤前交易階段
    >>> startTimestring該階段的開始時間戳(毫秒)
    >>> endTimestring該階段的結束時間戳(毫秒)
    >> auctionFeeInfoobject盤前交易手續費率信息
    >>> auctionFeeRatestring集合競價期間的手續費率
  • 目前, 僅在連續競價期間才會產生手續費
    • >>> takerFeeRatestring連續競價期間的吃單成交手續費率
    >>> makerFeeRatestring連續競價期間的掛單成交手續費率

    請求示例​

    GET /v5/market/instruments-info?category=linear&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "contractType": "LinearPerpetual",
                    "status": "Trading",
                    "baseCoin": "BTC",
                    "quoteCoin": "USDT",
                    "launchTime": "1585526400000",
                    "deliveryTime": "0",
                    "deliveryFeeRate": "",
                    "priceScale": "2",
                    "leverageFilter": {
                        "minLeverage": "1",
                        "maxLeverage": "100.00",
                        "leverageStep": "0.01"
                    },
                    "priceFilter": {
                        "minPrice": "0.10",
                        "maxPrice": "199999.80",
                        "tickSize": "0.10"
                    },
                    "lotSizeFilter": {
                        "maxOrderQty": "100.000",
                        "maxMktOrderQty": "100.000",
                        "minOrderQty": "0.001",
                        "qtyStep": "0.001",
                        "postOnlyMaxOrderQty": "1000.000",
                        "minNotionalValue": "5"
                    },
                    "unifiedMarginTrade": true,
                    "fundingInterval": 480,
                    "settleCoin": "USDT",
                    "copyTrading": "both",
                    "upperFundingRate": "0.00375",
                    "lowerFundingRate": "-0.00375"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1707186451514
    }

    // 盤前永續合約的響應
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                    "symbol": "PRE02ZROUSDT",
                    "contractType": "LinearPerpetual",
                    "status": "PreLaunch",
                    "baseCoin": "PRE02ZRO",
                    "quoteCoin": "USDT",
                    "launchTime": "1718610229000",
                    "deliveryTime": "0",
                    "deliveryFeeRate": "",
                    "priceScale": "3",
                    "leverageFilter": {
                        "minLeverage": "1",
                        "maxLeverage": "5.00",
                        "leverageStep": "0.01"
                    },
                    "priceFilter": {
                        "minPrice": "0.001",
                        "maxPrice": "1999.998",
                        "tickSize": "0.001"
                    },
                    "lotSizeFilter": {
                        "maxOrderQty": "10000.0",
                        "minOrderQty": "0.1",
                        "qtyStep": "0.1",
                        "postOnlyMaxOrderQty": "10000.0",
                        "maxMktOrderQty": "2000.0",
                        "minNotionalValue": "5"
                    },
                    "unifiedMarginTrade": true,
                    "fundingInterval": 480,
                    "settleCoin": "USDT",
                    "copyTrading": "none",
                    "upperFundingRate": "0.03",
                    "lowerFundingRate": "-0.03",
                    "isPreListing": true,
                    "preListingInfo": {
                        "curAuctionPhase": "ContinuousTrading",
                        "phases": [
                            {
                                "phase": "CallAuction",
                                "startTime": "1718621400000",
                                "endTime": "1718707200000"
                            },
                            {
                                "phase": "CallAuctionNoCancel",
                                "startTime": "1718707200000",
                                "endTime": "1718707500000"
                            },
                            {
                                "phase": "CrossMatching",
                                "startTime": "1718707500000",
                                "endTime": "1718707800000"
                            },
                            {
                                "phase": "ContinuousTrading",
                                "startTime": "1718707800000",
                                "endTime": ""
                            }
                        ],
                        "auctionFeeInfo": {
                            "auctionFeeRate": "0",
                            "takerFeeRate": "0.001",
                            "makerFeeRate": "0.0004"
                        }
                    }
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1719455285151
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/insurance.html b/zh-TW/v5/market/insurance.html index 513f0c7f11..63da57fd26 100644 --- a/zh-TW/v5/market/insurance.html +++ b/zh-TW/v5/market/insurance.html @@ -4,13 +4,13 @@ 查詢保險基金 | Bybit API Documentation - +

    查詢保險基金

    查詢Bybit平台的保險基金的數據，包含所有保險池的數據，數據每24小時更新一次。

    信息

    由於數據24小時更新, 您可能在遭遇自動減倉時, 接口返回的數據還是舊的

    HTTP請求​

    GET /v5/market/insurance

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種名稱. 默認: 返回目前所有的保險池幣種

    響應參數​

    參數類型說明
    updateTimestring數據最近更新的時間戳 (ms)
    listarrayObject
    > coinstring保險池的幣種
    > symbolsstring
  • 對於獨立保險池, 返回的symbols裡可能有多個合約, 比如"BTCUSDT,ETHUSDT,SOLUSDT"
  • 對於非獨立保險池, 將會返回空字符串""
    • > balancestring保險基金的幣種數量
    > valuestring保險基金的幣種價值，折合成USD的價值

    請求示例​

    GET /v5/market/insurance?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "updatedTime": "1714003200000",
            "list": [
                {
                    "coin": "USDT",
                    "symbols": "MERLUSDT,10000000AIDOGEUSDT,ZEUSUSDT",
                    "balance": "902178.57602476",
                    "value": "901898.0963091522"
                },
                {
                    "coin": "USDT",
                    "symbols": "SOLUSDT,OMNIUSDT,ALGOUSDT",
                    "balance": "14454.51626125",
                    "value": "14449.515598975464"
                },
                {
                    "coin": "USDT",
                    "symbols": "XLMUSDT,WUSDT",
                    "balance": "23.45018235",
                    "value": "22.992864174376344"
                },
                {
                    "coin": "USDT",
                    "symbols": "AGIUSDT,WIFUSDT",
                    "balance": "10002",
                    "value": "9998.896846613574"
                },
                {
                    "coin": "USDT",
                    "symbols": "",
                    "balance": "10148045273.618073",
                    "value": "10144896808.587431"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1714028451228
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/iv.html b/zh-TW/v5/market/iv.html index 7f9faf34ea..0cd66bffee 100644 --- a/zh-TW/v5/market/iv.html +++ b/zh-TW/v5/market/iv.html @@ -4,13 +4,13 @@ 查詢期權波動率 | Bybit API Documentation - +

    查詢期權波動率

    獲取期權的歷史波動率數據

    覆蓋範圍: 期權

    信息
    • 數據為每小時數據.
    • 若沒有入参時間，則默認返回最近1小時的數據，即最近的一條數據.
    • starTime 和 endTime 要麼都傳，要麼都不傳
    • 接口支持查詢過去2年的數據, 但確保[endTime - startTime] 小於等於30天.

    HTTP請求​

    GET /v5/market/historical-volatility

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. option
    baseCoinfalsestring交易幣種. 不傳則默認返回BTC數據
    periodfalsestring週期. 不傳則默認返回7天加權的數據
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > periodstring週期
    > valuestring波動率
    > timestring數據生成時間戳 (毫秒)

    請求示例​

    GET /v5/market/historical-volatility?category=option&baseCoin=ETH&period=30 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "SUCCESS",
        "category": "option",
        "result": [
            {
                "period": 7,
                "value": "0.27545620",
                "time": "1672232400000"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/kline.html b/zh-TW/v5/market/kline.html index adaf3f6743..7df15cba0f 100644 --- a/zh-TW/v5/market/kline.html +++ b/zh-TW/v5/market/kline.html @@ -4,13 +4,13 @@ 查詢市場價格K線數據 | Bybit API Documentation - +

    查詢市場價格K線數據

    查詢市場價格K線數據

    覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約

    HTTP請求​

    GET /v5/market/kline

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. spot,linear,inverse
  • 當category不指定時, 默認是linear
    • symboltruestring合約名稱
    intervaltruestring時間粒度. 1,3,5,15,30,60,120,240,360,720,D,M,W
    startfalseinteger開始時間戳 (毫秒)
    endfalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 200

    響應參數​

    參數類型說明
    categorystring產品類型
    symbolstring合約名稱
    listarray
    • 一個字符串數組構成單個蠟燭
    • 按照startTime降序排列
    > list[0]: startTimestring蠟燭的開始時間戳 (毫秒)
    > list[1]: openPricestring開始價格
    > list[2]: highPricestring最高價格
    > list[3]: lowPricestring最低價格
    > list[4]: closePricestring結束價格. 如果蠟燭尚未結束，則表示為最新成交價格
    > list[5]: volumestring交易量. 合約單位: 合約的張數. 現貨單位: 幣種的數量
    > list[6]: turnoverstring交易額. 單位: 報價貨幣的數量

    請求示例​

    GET /v5/market/kline?category=inverse&symbol=BTCUSD&interval=60&start=1670601600000&end=1670608800000 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSD",
            "category": "inverse",
            "list": [
                [
                    "1670608800000",
                    "17071",
                    "17073",
                    "17027",
                    "17055.5",
                    "268611",
                    "15.74462667"
                ],
                [
                    "1670605200000",
                    "17071.5",
                    "17071.5",
                    "17061",
                    "17071",
                    "4177",
                    "0.24469757"
                ],
                [
                    "1670601600000",
                    "17086.5",
                    "17088",
                    "16978",
                    "17071.5",
                    "6356",
                    "0.37288112"
                ]
            ]
        },
        "retExtInfo": {},
        "time": 1672025956592
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/long-short-ratio.html b/zh-TW/v5/market/long-short-ratio.html index 2c3576cdcf..9c11f30512 100644 --- a/zh-TW/v5/market/long-short-ratio.html +++ b/zh-TW/v5/market/long-short-ratio.html @@ -4,13 +4,13 @@ 查詢多空比 | Bybit API Documentation - +

    查詢多空比

    HTTP請求​

    GET /v5/market/account-ratio

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear(僅USDT永續),inverse
    symboltruestring合約名稱
    periodtruestring數據週期. 5min, 15min, 30min, 1h, 4h, 1d
    limitfalseinteger每頁數量限制. [1, 500]. 默認: 50

    響應參數​

    參數類型說明
    listarrayObject
    > symbolstring合約名稱
    > buyRatiostring持多倉的用户比例
    > sellRatiostring持空倉的用户比例
    > timestampstring時間戳 (毫秒)

    請求示例​

    GET /v5/market/account-ratio?category=linear&symbol=BTCUSDT&period=1d&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "buyRatio": "0.5777",
                    "sellRatio": "0.4223",
                    "timestamp": "1695772800000"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1695785131028
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/mark-kline.html b/zh-TW/v5/market/mark-kline.html index 82e3252663..bd38e601c1 100644 --- a/zh-TW/v5/market/mark-kline.html +++ b/zh-TW/v5/market/mark-kline.html @@ -4,13 +4,13 @@ 查詢標記價格K線數據 | Bybit API Documentation - +

    查詢標記價格K線數據

    查詢標記價格K線

    覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約

    HTTP請求​

    GET /v5/market/mark-price-kline

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear,inverse
  • 當category不指定時, 默認是linear
    • symboltruestring合約名稱
    intervaltruestring時間粒度. 1,3,5,15,30,60,120,240,360,720,D,M,W
    startfalseinteger開始時間戳 (毫秒)
    endfalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 200

    響應參數​

    參數類型說明
    categorystring產品類型
    symbolstring合約名稱
    listarray
    • 一個字符串數組構成單個蠟燭
    • 按照startTime降序排列
    > list[0]: startTimestring蠟燭的開始時間戳 (毫秒)
    > list[1]: openPricestring開始價格
    > list[2]: highPricestring最高價格
    > list[3]: lowPricestring最低價格
    > list[4]: closePricestring結束價格. 如果蠟燭尚未結束，則表示為最新成交價格

    請求示例​

    GET /v5/market/mark-price-kline?category=linear&symbol=BTCUSDT&interval=15&start=1670601600000&end=1670608800000&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "category": "linear",
            "list": [
                [
                "1670608800000",
                "17164.16",
                "17164.16",
                "17121.5",
                "17131.64"
                ]
            ]
        },
        "retExtInfo": {},
        "time": 1672026361839
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/open-interest.html b/zh-TW/v5/market/open-interest.html index b942e8d68c..2b487c9915 100644 --- a/zh-TW/v5/market/open-interest.html +++ b/zh-TW/v5/market/open-interest.html @@ -4,13 +4,13 @@ 查詢未平倉合約持倉數量 | Bybit API Documentation - +

    查詢未平倉合約持倉數量

    查詢各個合約市場內所有未平倉的數量

    覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約

    信息
    • 最久可以查詢到自合約上線開始的數據

    HTTP請求​

    GET /v5/market/open-interest

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear,inverse
    symboltruestring合約名稱
    intervalTimetruestring時間粒度. 5min 15min 30min 1h 4h 1d
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    symbolstring合約名稱
    listarrayObject
    > openIntereststring未平倉合約數量, 數值為雙邊的和
    > timestampstring數據產生的時間戳（毫秒）
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/market/open-interest?category=inverse&symbol=BTCUSD&intervalTime=5min&startTime=1669571100000&endTime=1669571400000 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSD",
            "category": "inverse",
            "list": [
                {
                    "openInterest": "461134384.00000000",
                    "timestamp": "1669571400000"
                },
                {
                    "openInterest": "461134292.00000000",
                    "timestamp": "1669571100000"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1672053548579
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/orderbook.html b/zh-TW/v5/market/orderbook.html index 762035316b..a228ee617f 100644 --- a/zh-TW/v5/market/orderbook.html +++ b/zh-TW/v5/market/orderbook.html @@ -4,13 +4,13 @@ Order Book (深度) | Bybit API Documentation - +

    Order Book (深度)

    獲取深度數據

    覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權

    • 期貨: 最多返回500檔的數據.
    • 現貨: 最多返回200檔的數據.
    • 期權: 僅返回25檔的數據.
    提示

    響應是當前時間的切片數據

    HTTP請求​

    GET /v5/market/orderbook

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. spot, linear, inverse, option
    symboltruestring合約名稱
    limitfalseinteger深度限制.
    • spot: [1, 200], 默認: 1.
    • linear&inverse: [1, 500],默認: 25.
    • option: [1, 25],默認: 1.

    響應參數​

    參數類型說明
    sstring合約名稱
    barrayBid, 買方. 按照價格從大到小
    > b[0]string買方報價
    > b[1]string買方數量
    aarrayAsk, 賣方. 按照價格從小到大
    > a[0]string賣方報價
    > a[1]string賣方數量
    tsinteger行情服務生成數據時間戳（毫秒）
    uinteger表示數據連續性的id.
    • 對於期貨, 它和wss推送裡的500檔的u對齊
    • 對於現貨, 它和wss推送裡的200檔的u對齊
    seqinteger撮合版本號
  • 該字段可以用於關聯不同檔位的orderbook, 如果值越小, 則說明數據生成越早
  • 期權目前不存在此字段
    • ctsnumber產生此訂單簿數據時來自撮合引擎的時間戳. 可用於與平台成交頻道中的T進行關聯. linear, inverse, spot有這個字段

    請求示例​

    GET /v5/market/orderbook?category=spot&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "s": "BTCUSDT",
            "a": [
                [
                    "65557.7",
                    "16.606555"
                ]
            ],
            "b": [
                [
                    "65485.47",
                    "47.081829"
                ]
            ],
            "ts": 1716863719031,
            "u": 230704,
            "seq": 1432604333,
            "cts": 1716863718905
        },
        "retExtInfo": {},
        "time": 1716863719382
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/preimum-index-kline.html b/zh-TW/v5/market/preimum-index-kline.html index 60c6f356e6..1886d9b13f 100644 --- a/zh-TW/v5/market/preimum-index-kline.html +++ b/zh-TW/v5/market/preimum-index-kline.html @@ -4,13 +4,13 @@ 查詢溢價指數價格K線數據 | Bybit API Documentation - +

    查詢溢價指數價格K線數據

    查詢溢價指數價格K線數據

    覆蓋範圍: USDT和USDC永續

    HTTP請求​

    GET /v5/market/premium-index-price-kline

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear
  • 當category不指定時, 默認是linear
    • symboltruestring合約名稱
    intervaltruestring時間粒度. 1,3,5,15,30,60,120,240,360,720,D,M,W
    startfalseinteger開始時間戳 (毫秒)
    endfalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 1000]. 默認: 200

    響應參數​

    參數類型說明
    categorystring產品類型
    symbolstring合約名稱
    listarray
    • 一個字符串數組構成單個蠟燭
    • 按照startTime降序排列
    > list[0]string蠟燭的開始時間戳 (毫秒)
    > list[1]string開始價格
    > list[2]string最高價格
    > list[3]string最低價格
    > list[4]string結束價格. 如果蠟燭尚未結束，則表示為最新成交價格

    請求示例​

    GET /v5/market/premium-index-price-kline?category=linear&symbol=BTCUSDT&interval=D&start=1652112000000&end=1652544000000 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCPERP",
            "category": "linear",
            "list": [
                [
                    "1672026540000",
                    "0.000000",
                    "0.000000",
                    "0.000000",
                    "0.000000"
                ],
                [
                    "1672026480000",
                    "0.000000",
                    "0.000000",
                    "0.000000",
                    "0.000000"
                ]
                ]
        },
        "retExtInfo": {},
        "time": 1672026605042
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/recent-trade.html b/zh-TW/v5/market/recent-trade.html index 80d0114fec..f328dff65a 100644 --- a/zh-TW/v5/market/recent-trade.html +++ b/zh-TW/v5/market/recent-trade.html @@ -4,13 +4,13 @@ 查詢平台最近成交歷史 | Bybit API Documentation - +

    查詢平台最近成交歷史

    獲取平台最近成交數據

    覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權

    您可以從這個地址 下載到歸檔的更多的歷史成交數據:

    HTTP請求​

    GET /v5/market/recent-trade

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. spot,linear,inverse,option
    symbolfalsestring合約名稱
    • 現貨/期權必傳
    • 期權選傳
    baseCoinfalsestring交易幣種. 僅option, 若不傳, 則默認返回BTC數據
    optionTypefalsestring期權類型. Call 或 Put. 僅option
    limitfalseinteger每頁數量限制.
    • spot: [1,60], 默认: 60.
    • others: [1,1000], 默認: 500

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > execIdstring成交id
    > symbolstring合約名稱
    > pricestring成交價格
    > sizestring成交數量
    > sidestring吃單方向. Buy, Sell
    > timestring成交時間戳 (毫秒)
    > isBlockTradeboolean成交類型是否為大宗交易
    > mPstring標記價格, 期權的特有字段
    > iPstring指數價格, 期權的特有字段
    > mIvstring標記iv, 期權的特有字段
    > ivstringiv, 期權的特有字段

    請求示例​

    GET /v5/market/recent-trade?category=spot&symbol=BTCUSDT&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "spot",
            "list": [
                {
                    "execId": "2100000000007764263",
                    "symbol": "BTCUSDT",
                    "price": "16618.49",
                    "size": "0.00012",
                    "side": "Buy",
                    "time": "1672052955758",
                    "isBlockTrade": false
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672053054358
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/risk-limit.html b/zh-TW/v5/market/risk-limit.html index ce3429f6f9..4aef56d205 100644 --- a/zh-TW/v5/market/risk-limit.html +++ b/zh-TW/v5/market/risk-limit.html @@ -4,13 +4,13 @@ 查詢合約風險限額 | Bybit API Documentation - +

    查詢合約風險限額

    查詢期貨合約的風險限額表

    覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約

    提示

    什麼是風險限額？風險限額(USDT合約)

    信息

    當category=linear, 每次請求返回30個symbol的風險限額數據, 請通過cursor來實現翻頁查詢下一組30個symbol的數據

    HTTP請求​

    GET /v5/market/risk-limit

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear,inverse
    symbolfalsestring合約名稱
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > idinteger風險限額id
    > symbolstring合約名稱
    > riskLimitValuestring風險限制額度
    > maintenanceMarginnumber維持保證金率
    > initialMarginnumber初始保證金率
    > isLowestRiskinteger是否是最低風險限額. 1: true, 0: false
    > maxLeveragestring該風險限額允許的最大槓桿
    > mmDeductionstring維持保證金扣減額
    nextPageCursorstring下一頁游標, 配合cursor使用

    請求示例​

    GET /v5/market/risk-limit?category=inverse&symbol=BTCUSD HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "inverse",
            "list": [
                {
                    "id": 1,
                    "symbol": "BTCUSD",
                    "riskLimitValue": "150",
                    "maintenanceMargin": "0.5",
                    "initialMargin": "1",
                    "isLowestRisk": 1,
                    "maxLeverage": "100.00",
                    "mmDeduction": ""
                },
            ....
            ]
        },
        "retExtInfo": {},
        "time": 1672054488010
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/tickers.html b/zh-TW/v5/market/tickers.html index 49fa54e88b..cd7cee9c59 100644 --- a/zh-TW/v5/market/tickers.html +++ b/zh-TW/v5/market/tickers.html @@ -4,13 +4,13 @@ 查詢最新行情信息 | Bybit API Documentation - +

    查詢最新行情信息

    可獲取到快照的最新市場價格，最佳買賣價格，以及過去時間內的交易量等.

    覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權

    HTTP請求​

    GET /v5/market/tickers

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. spot,linear,inverse,option
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種. 僅option有效, baseCoin和symbol必傳其中一個
    expDatefalsestring到期日. 舉例, 25DEC22. 僅option有效

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > lastPricestring最新市場成交價
    > indexPricestring指數價格
    > markPricestring標記價格
    > prevPrice24hstring24小時前的整點市價
    > price24hPcntstring市場價格相對24h前變化的百分比
    > highPrice24hstring最近24小時的最高價
    > lowPrice24hstring最近24小時的最低價
    > prevPrice1hstring1小時前的整點市價
    > openIntereststring未平倉合約的數量
    > openInterestValuestring未平倉合約的價值
    > turnover24hstring最近24小時成交額
    > volume24hstring最近24小時成交量
    > fundingRatestring資金費率
    > nextFundingTimestring下次結算資金費用的時間 (毫秒)
    > predictedDeliveryPricestring預計交割價格. 交割前30分鐘有值
    > basisRatestring交割合約基差率
    > basisstring交割合約基差
    > deliveryFeeRatestring交割費率
    > deliveryTimestring交割時間戳 (毫秒)
    > ask1Sizestring買1價的數量
    > bid1Pricestring買1價
    > ask1Pricestring賣1價
    > bid1Sizestring買1價的數量
    > preOpenPricestring盤前合約預估開盤價格
  • 在進入連續競價後, 該值無意義
    • > preQtystring盤前合約預估開盤數量
  • 進入連續競價後, 該值無意義
    • > curPreListingPhasestring當前盤前交易階段

    請求示例​

    GET /v5/market/tickers?category=inverse&symbol=BTCUSD HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "inverse",
            "list": [
                {
                    "symbol": "BTCUSD",
                    "lastPrice": "16597.00",
                    "indexPrice": "16598.54",
                    "markPrice": "16596.00",
                    "prevPrice24h": "16464.50",
                    "price24hPcnt": "0.008047",
                    "highPrice24h": "30912.50",
                    "lowPrice24h": "15700.00",
                    "prevPrice1h": "16595.50",
                    "openInterest": "373504107",
                    "openInterestValue": "22505.67",
                    "turnover24h": "2352.94950046",
                    "volume24h": "49337318",
                    "fundingRate": "-0.001034",
                    "nextFundingTime": "1672387200000",
                    "predictedDeliveryPrice": "",
                    "basisRate": "",
                    "deliveryFeeRate": "",
                    "deliveryTime": "0",
                    "ask1Size": "1",
                    "bid1Price": "16596.00",
                    "ask1Price": "16597.50",
                    "bid1Size": "1",
                    "basis": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672376496682
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/market/time.html b/zh-TW/v5/market/time.html index 63b6260faf..bc8c424dc5 100644 --- a/zh-TW/v5/market/time.html +++ b/zh-TW/v5/market/time.html @@ -4,13 +4,13 @@ Bybit服務器時間 | Bybit API Documentation - +

    Bybit服務器時間

    獲取Bybit服務器時間

    HTTP 請求​

    GET /v5/market/time

    請求參數​

    無

    響應參數​

    參數類型說明
    timeSecondstringBybit服務器時間戳 (秒)
    timeNanostringBybit 服務器時間戳 (微秒)

    請求示例​

    GET /v5/market/time HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "timeSecond": "1688639403",
            "timeNano": "1688639403423213947"
        },
        "retExtInfo": {},
        "time": 1688639403423
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/amend-order.html b/zh-TW/v5/order/amend-order.html index 1fbf4e0bda..59f1fc3221 100644 --- a/zh-TW/v5/order/amend-order.html +++ b/zh-TW/v5/order/amend-order.html @@ -4,14 +4,14 @@ 修改委託單 | Bybit API Documentation - +
    -

    修改委託單

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    +

    修改委託單

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    經典帳戶覆蓋範圍: 現貨 / USDT永續 / 反向合約

    important

    您只能修改那些未成交或者部分成交的訂單。

    Websocket現貨推送邏輯

    經典帳戶: 如果原始訂單是PostOnly訂單, 在修改訂單後, 變成了taker訂單, 那麼您將先收到一條推送orderStatus="New"的消息, 然後是orderStatus="Rejected"的消息

    統一帳戶: 如果原始訂單是PostOnly訂單, 在修改訂單後, 變成了taker訂單, 那麼您將直接收到一條推送orderStatus="Rejected"的消息

    HTTP請求​

    POST /v5/order/amend

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear, inverse, spot, option
    • 經典帳戶: linear, inverse, spot
    symboltruestring合約名稱
    orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
    orderIvfalsestring隱含波動率. 僅option有效. 按照實際值傳入, e.g., 對於10%, 則傳入0.1
    triggerPricefalsestring
    • 對於期貨, 是條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保:
      triggerPrice > 市場價格
      否則, triggerPrice < 市場價格
    • 對於現貨, 這是下止盈止損單或者條件單的觸發價格參數
    qtyfalsestring修改後的訂單數量. 若不修改，請不要傳該字段
    pricefalsestring修改後的訂單價格. 若不修改，請不要傳該字段
    tpslModefalsestring止盈止損模式
    • Full: 全部倉位止盈止損. 此時, tpOrderType或者slOrderType必須傳Market
    • Partial: 部分倉位止盈止損. 支持創建限價止盈止損. 注意: 創建限價止盈止損時, tpslMode必傳且為Partial
    僅對linear和inverse有效
    takeProfitfalsestring修改後的止盈價格. 當傳"0"時, 表示取消當前訂單上設置的止盈. 若不修改，請不要傳該字段 適用於 spot(UTA), linear, inverse
    stopLossfalsestring修改後的止損價格. 當傳"0"時, 表示取消當前訂單上設置的止損. 若不修改，請不要傳該字段 適用於 spot(UTA), linear, inverse
    tpTriggerByfalsestring止盈價格觸發類型. 若下單時未設置該值，則調用該接口修改止盈價格時，該字段必傳
    slTriggerByfalsestring止損價格觸發類型. 若下單時未設置該值，則調用該接口修改止損價格時，該字段必傳
    triggerByfalsestring觸發價格的觸發類型
    tpLimitPricefalsestring*觸發止盈後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效 適用於 spot(UTA), linear, inverse
    slLimitPricefalsestring*觸發止損後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效 適用於 spot(UTA), linear, inverse
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    響應參數​

    參數類型說明
    orderIdstring訂單Id
    orderLinkIdstring用戶自定義訂單Id

    請求示例​

    POST /v5/order/amend HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672217108106
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "ETHPERP",
        "orderLinkId": "linear-004",
        "triggerPrice": "1145",
        "qty": "0.15",
        "price": "1050",
        "takeProfit": "0",
        "stopLoss": "0"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
            "orderLinkId": "linear-004"
        },
        "retExtInfo": {},
        "time": 1672217093461
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/batch-amend.html b/zh-TW/v5/order/batch-amend.html index 1fad8f276d..9238e77057 100644 --- a/zh-TW/v5/order/batch-amend.html +++ b/zh-TW/v5/order/batch-amend.html @@ -4,13 +4,13 @@ 批量修改委託單 | Bybit API Documentation - +
    -

    批量修改委託單

    覆蓋範圍: 現貨 (統一帳戶) / 期權 (統一帳戶) / USDT永續、USDC永續、USDC交割 (UTA Pro)

    提示

    該接口支持批量修改委託單

    • 您只能修改那些未成交或部分成交的訂單. 條件單不支持批量修改.
    • 最多支持單個請求中修改, 期權: 20個訂單, 期貨: 10个訂單, 現貨: 10個訂單.

    HTTP請求​

    POST /v5/order/amend-batch

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option, spot
    requesttruearrayObject
    > symboltruestring合約名稱
    > orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    > orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
    > orderIvfalsestring隱含波動率. 僅option有效. 按照實際值傳入, e.g., 對於10%, 則傳入0.1
    > triggerPricefalsestring
    • 對於期貨, 是條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保:
      triggerPrice > 市場價格
      否則, triggerPrice < 市場價格
    • 對於現貨, 這是下止盈止損單(tpslOrder)或者條件單(stopOrder)的觸發價格參數
    > qtyfalsestring修改後的訂單數量. 若不修改，請不要傳該字段
    > pricefalsestring修改後的訂單價格. 若不修改，請不要傳該字段
    > tpslModefalsestring止盈止損模式
    • Full: 全部倉位止盈止損. 此時, tpOrderType或者slOrderType必須傳Market
    • Partial: 部分倉位止盈止損. 支持創建限價止盈止損. 注意: 創建限價止盈止損時, tpslMode必傳且為Partial
    僅對linear有效
    > takeProfitfalsestring修改後的止盈價格. 當傳"0"時, 表示取消當前訂單上設置的止盈. 若不修改，請不要傳該字段 適用於 spot, linear
    > stopLossfalsestring修改後的止損價格. 當傳"0"時, 表示取消當前訂單上設置的止損. 若不修改，請不要傳該字段 適用於 spot, linear
    > tpTriggerByfalsestring止盈價格觸發類型. 若下單時未設置該值，則調用該接口修改止盈價格時，該字段必傳
    > slTriggerByfalsestring止損價格觸發類型. 若下單時未設置該值，則調用該接口修改止損價格時，該字段必傳
    > triggerByfalsestring觸發價格的觸發類型
    > tpLimitPricefalsestring*觸發止盈後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效 適用於 spot, linear
    > slLimitPricefalsestring*觸發止損後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效 適用於 spot, linear

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> categorystring產品類型
    >> symbolstring合約名稱
    >> orderIdstring訂單Id
    >> orderLinkIdstring用戶自定義訂單Id
    retExtInfoObject
    > listarrayObject
    >> codenumber成功/錯誤碼
    >> msgstring成功/錯誤信息
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    請求示例​

    POST /v5/order/amend-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672222935987
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "option",
        "request": [
            {
                "symbol": "ETH-30DEC22-500-C",
                "qty": null,
                "price": null,
                "orderIv": "6.8",
                "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2"
            },
            {
                "symbol": "ETH-30DEC22-700-C",
                "qty": null,
                "price": "650",
                "orderIv": null,
                "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52"
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "option",
                    "symbol": "ETH-30DEC22-500-C",
                    "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2",
                    "orderLinkId": ""
                },
                {
                    "category": "option",
                    "symbol": "ETH-30DEC22-700-C",
                    "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52",
                    "orderLinkId": ""
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 0,
                    "msg": "OK"
                }
            ]
        },
        "time": 1672222808060
    }
    - +

    批量修改委託單

    覆蓋範圍: 現貨 (統一帳戶) / 期權 (統一帳戶) / USDT永續、USDC永續、USDC交割 (UTA Pro)

    提示

    該接口支持批量修改委託單

    • 您只能修改那些未成交或部分成交的訂單. 條件單不支持批量修改.
    • 最多支持單個請求中修改, 期權: 20個訂單, 期貨: 10个訂單, 現貨: 10個訂單.

    HTTP請求​

    POST /v5/order/amend-batch

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option, spot
    requesttruearrayObject
    > symboltruestring合約名稱
    > orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    > orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
    > orderIvfalsestring隱含波動率. 僅option有效. 按照實際值傳入, e.g., 對於10%, 則傳入0.1
    > triggerPricefalsestring
    • 對於期貨, 是條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保:
      triggerPrice > 市場價格
      否則, triggerPrice < 市場價格
    • 對於現貨, 這是下止盈止損單(tpslOrder)或者條件單(stopOrder)的觸發價格參數
    > qtyfalsestring修改後的訂單數量. 若不修改，請不要傳該字段
    > pricefalsestring修改後的訂單價格. 若不修改，請不要傳該字段
    > tpslModefalsestring止盈止損模式
    • Full: 全部倉位止盈止損. 此時, tpOrderType或者slOrderType必須傳Market
    • Partial: 部分倉位止盈止損. 支持創建限價止盈止損. 注意: 創建限價止盈止損時, tpslMode必傳且為Partial
    僅對linear有效
    > takeProfitfalsestring修改後的止盈價格. 當傳"0"時, 表示取消當前訂單上設置的止盈. 若不修改，請不要傳該字段 適用於 spot, linear
    > stopLossfalsestring修改後的止損價格. 當傳"0"時, 表示取消當前訂單上設置的止損. 若不修改，請不要傳該字段 適用於 spot, linear
    > tpTriggerByfalsestring止盈價格觸發類型. 若下單時未設置該值，則調用該接口修改止盈價格時，該字段必傳
    > slTriggerByfalsestring止損價格觸發類型. 若下單時未設置該值，則調用該接口修改止損價格時，該字段必傳
    > triggerByfalsestring觸發價格的觸發類型
    > tpLimitPricefalsestring*觸發止盈後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效 適用於 spot, linear
    > slLimitPricefalsestring*觸發止損後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效 適用於 spot, linear

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> categorystring產品類型
    >> symbolstring合約名稱
    >> orderIdstring訂單Id
    >> orderLinkIdstring用戶自定義訂單Id
    retExtInfoObject
    > listarrayObject
    >> codenumber成功/錯誤碼
    >> msgstring成功/錯誤信息
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    請求示例​

    POST /v5/order/amend-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672222935987
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "option",
        "request": [
            {
                "symbol": "ETH-30DEC22-500-C",
                "qty": null,
                "price": null,
                "orderIv": "6.8",
                "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2"
            },
            {
                "symbol": "ETH-30DEC22-700-C",
                "qty": null,
                "price": "650",
                "orderIv": null,
                "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52"
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "option",
                    "symbol": "ETH-30DEC22-500-C",
                    "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2",
                    "orderLinkId": ""
                },
                {
                    "category": "option",
                    "symbol": "ETH-30DEC22-700-C",
                    "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52",
                    "orderLinkId": ""
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 0,
                    "msg": "OK"
                }
            ]
        },
        "time": 1672222808060
    }
    + \ No newline at end of file diff --git a/zh-TW/v5/order/batch-cancel.html b/zh-TW/v5/order/batch-cancel.html index f1ac730cc7..2952404417 100644 --- a/zh-TW/v5/order/batch-cancel.html +++ b/zh-TW/v5/order/batch-cancel.html @@ -4,13 +4,13 @@ 批量撤銷委託單 | Bybit API Documentation - +
    -

    批量撤銷委託單

    該接口可以批量撤銷多筆訂單

    覆蓋範圍: 現貨 (統一帳戶) / 期權 (統一帳戶) / USDT永續、USDC永續、USDC交割 (UTA Pro)

    重要
    • 您必須指定orderId或者orderLinkId.
    • 若orderId和orderLinkId之間不匹配, 系統將會優先處理orderId.
    • 您只能撤銷未成交和部分成交的訂單.
    • 單個請求最多支持撤銷, 期權: 20個訂單, 期貨: 10个訂單, 現貨: 10個訂單.

    HTTP請求​

    POST /v5/order/cancel-batch

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option, spot
    requesttruearrayObject
    > symboltruestring合約名稱
    > orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    > orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> categorystring產品類型
    >> symbolstring合約名稱
    >> orderIdstring訂單Id
    >> orderLinkIdstring用戶自定義訂單Id
    retExtInfoObject
    > listarrayObject
    >> codenumber成功/錯誤碼
    >> msgstring成功/錯誤信息
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    請求示例​

    POST /v5/order/cancel-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672223356634
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "spot",
        "request": [
            {
                "symbol": "BTCUSDT",
                "orderId": "1666800494330512128"
            },
            {
                "symbol": "ATOMUSDT",
                "orderLinkId": "1666800494330512129"
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "spot",
                    "symbol": "BTCUSDT",
                    "orderId": "1666800494330512128",
                    "orderLinkId": "spot-btc-03"
                },
                {
                    "category": "spot",
                    "symbol": "ATOMUSDT",
                    "orderId": "",
                    "orderLinkId": "1666800494330512129"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 170213,
                    "msg": "Order does not exist."
                }
            ]
        },
        "time": 1713434299047
    }
    - +

    批量撤銷委託單

    該接口可以批量撤銷多筆訂單

    覆蓋範圍: 現貨 (統一帳戶) / 期權 (統一帳戶) / USDT永續、USDC永續、USDC交割 (UTA Pro)

    重要
    • 您必須指定orderId或者orderLinkId.
    • 若orderId和orderLinkId之間不匹配, 系統將會優先處理orderId.
    • 您只能撤銷未成交和部分成交的訂單.
    • 單個請求最多支持撤銷, 期權: 20個訂單, 期貨: 10个訂單, 現貨: 10個訂單.

    HTTP請求​

    POST /v5/order/cancel-batch

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, option, spot
    requesttruearrayObject
    > symboltruestring合約名稱
    > orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    > orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個

    響應參數​

    參數類型說明
    resultObject
    > listarrayObject
    >> categorystring產品類型
    >> symbolstring合約名稱
    >> orderIdstring訂單Id
    >> orderLinkIdstring用戶自定義訂單Id
    retExtInfoObject
    > listarrayObject
    >> codenumber成功/錯誤碼
    >> msgstring成功/錯誤信息
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    請求示例​

    POST /v5/order/cancel-batch HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672223356634
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "spot",
        "request": [
            {
                "symbol": "BTCUSDT",
                "orderId": "1666800494330512128"
            },
            {
                "symbol": "ATOMUSDT",
                "orderLinkId": "1666800494330512129"
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "category": "spot",
                    "symbol": "BTCUSDT",
                    "orderId": "1666800494330512128",
                    "orderLinkId": "spot-btc-03"
                },
                {
                    "category": "spot",
                    "symbol": "ATOMUSDT",
                    "orderId": "",
                    "orderLinkId": "1666800494330512129"
                }
            ]
        },
        "retExtInfo": {
            "list": [
                {
                    "code": 0,
                    "msg": "OK"
                },
                {
                    "code": 170213,
                    "msg": "Order does not exist."
                }
            ]
        },
        "time": 1713434299047
    }
    + \ No newline at end of file diff --git a/zh-TW/v5/order/batch-place.html b/zh-TW/v5/order/batch-place.html index 1b0a2e4ec8..3d44275ac8 100644 --- a/zh-TW/v5/order/batch-place.html +++ b/zh-TW/v5/order/batch-place.html @@ -4,15 +4,15 @@ 批量創建委託單 | Bybit API Documentation - +
    -

    批量創建委託單

    覆蓋範圍: 現貨 (統一帳戶) / 期權 (統一帳戶) / USDT永續、USDC永續、USDC交割 (UTA Pro)

    提示

    該接口支持批量創建委託單

    • 下單時需確保帳戶內有足夠的資金。一旦下單，根據訂單所需資金，您的帳戶資金將在訂單生命週期內凍結相應額度，被凍結的資金額度取決於訂單屬性。
    • 每個請求包含的訂單數最大是: 20筆(期权), 10筆(期貨), 10筆(現貨)，返回的數據列表中分成兩個list，訂單創建的列表和創建結果的信息返回，兩個list的訂單的序列是完全保持一致的。
    信息

    • 當category=linear 或者 spot時, 請從這裡查閱其API限頻說明

    • 風控限制提示:
      +

      批量創建委託單

      覆蓋範圍: 現貨 (統一帳戶) / 期權 (統一帳戶) / USDT永續、USDC永續、USDC交割 (UTA Pro)

      提示

      該接口支持批量創建委託單

      • 下單時需確保帳戶內有足夠的資金。一旦下單，根據訂單所需資金，您的帳戶資金將在訂單生命週期內凍結相應額度，被凍結的資金額度取決於訂單屬性。
      • 每個請求包含的訂單數最大是: 20筆(期权), 10筆(期貨), 10筆(現貨)，返回的數據列表中分成兩個list，訂單創建的列表和創建結果的信息返回，兩個list的訂單的序列是完全保持一致的。
      信息

      • 當category=linear 或者 spot時, 請從這裡查閱其API限頻說明

      • 風控限制提示:
        Bybit 將針對您的 API 請求進行統計監控，當單日 (UTC 0点 - UTC 24点) 單帳號（母帳號和子帳號整體運算）訂單總数超過一定上限，平台將保留提醒、警告，以及進行必要性限制的權利。 使用API的客戶預設接受本條款並負有配合調整的義務。

      HTTP請求​

      POST /v5/order/create-batch

      請求參數​

      參數是否必需類型說明
      categorytruestring產品類型. linear, option, spot
      requesttruearrayObject
      > symboltruestring合約名稱
      > isLeveragefalseinteger是否借貸. 僅統一帳戶的現貨交易有效. 0(default): 否，則是幣幣訂單, 1: 是，則是槓桿訂單
      > sidetruestring方向. Buy, Sell
      > orderTypetruestring訂單類型. Market, Limit
      > qtytruestring訂單數量 訂單數量
      • 統一帳戶
        • 現貨: 可以通過設置marketUnit來表示市價單qty的單位, 市價買單默認是quoteCoin, 市價賣單默認是baseCoin
        • 期貨和期權: 總是以base coin作為qty的單位
      • 期貨: 如果傳入qty="0"以及reduceOnly="true", 則可以平掉對應合約可達單個訂單允許的最大qty的倉位, 參照查詢可交易產品的規格信息接口裡的字段maxMktOrderQty或者maxOrderQty
      > pricefalsestring訂單價格
      • 市價單將會忽視該字段
      • 請通過該接口確認最低價格和精度要求
      • 如果有持倉, 確保價格優於強平價格
      > marketUnitfalsestring統一帳戶現貨交易創建市價單時給入參qty指定的單位, 支持orderFilter=Order, tpslOrder 和 StopOrder
    • baseCoin: 比如, 買BTCUSDT, 則"qty"的單位是BTC
    • quoteCoin: 比如, 賣BTCUSDT, 則"qty"的單位是USDT
      • > triggerDirectionfalseinteger條件單參數. 用於辨別期望的方向.
      • 1: 當市場價上漲到了triggerPrice時觸發條件單
      • 2: 當市場價下跌到了triggerPrice時觸發條件單
      僅linear有效
      > orderFilterfalsestring指定訂單品種. Order: 普通單,tpslOrder: 止盈止損單,StopOrder: 條件單. 若不傳, 默認Order
      僅對現貨有效
      > triggerPricefalsestring
      • 對於期貨, 是條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保:
        triggerPrice > 市場價格
        否則, triggerPrice < 市場價格
      • 對於現貨, 這是下止盈止損單(orderFilter=tpslOrder)或者條件單(orderFilter=stopOrder)的觸發價格參數
      > triggerByfalsestring條件單參數. 觸發價格類型. LastPrice, IndexPrice, MarkPrice
      僅linear有效
      > orderIvfalsestring隱含波動率. 僅option有效. 按照實際值傳入, e.g., 對於10%, 則傳入0.1. orderIv比price有更高的優先級
      > timeInForcefalsestring訂單執行策略
      • 市價單，系統直接使用IOC
      • 若不傳，默認使用GTC
      > positionIdxfalseinteger倉位標識, 用戶不同倉位模式. 該字段對於雙向持倉模式(USDT永續支持雙向模式)是必傳:
      • 0: 單向持倉
      • 1: 買側雙向持倉
      • 2: 賣側雙向持倉
      僅linear有效
      > orderLinkIdfalsestring用戶自定義訂單Id. category=option時，該參數必傳
      > takeProfitfalsestring止盈價格, 对linear和spot有效
      > stopLossfalsestring止損價格, 对linear和spot有效
      > tpTriggerByfalsestring觸發止盈的價格類型. MarkPrice, IndexPrice, 默認:LastPrice
      僅linear有效
      > slTriggerByfalsestring觸發止損的價格類型. MarkPrice, IndexPrice, 默認:LastPrice
      僅linear有效
      > reduceOnlyfalseboolean什麼是只減倉? true 將這筆訂單設為只減倉
      • 當減倉時, reduceOnly=true必傳
      • 只減倉單的止盈止損不生效
      > closeOnTriggerfalseboolean什麼是觸發後平倉委託?此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行.
      僅linear有效
      > smpTypefalsestringSmp執行類型. 什麼是SMP?
      > mmpfalseboolean做市商保護. 僅option有效. true 表示該訂單是做市商保護訂單. 什麼是做市商保護?
      > tpslModefalsestring止盈止損模式
      • Full: 全部倉位止盈止損. 此時, tpOrderType或者slOrderType必須傳Market
      • Partial: 部分倉位止盈止損(下單時沒有size選項, 實際上創建tpsl訂單時, 是按照實際成交的數量來生成止盈止損). 注意: 創建限價止盈止損時, tpslMode必傳且為Partial
      僅linear有效
      > tpLimitPricefalsestring觸發止盈後轉換為限價單的價格
      • linear: 僅作用於當tpslMode=Partial以及tpOrderType=Limit時
      • spot(UTA): 參數必傳當創建訂單時帶了takeProfit 和 tpOrderType=Limit
      > slLimitPricefalsestring觸發止損後轉換為限價單的價格
      • linear: 僅作用於當tpslMode=Partial以及slOrderType=Limit時
      • spot(UTA): 參數必傳當創建訂單時帶了stopLoss 和 slOrderType=Limit
      > tpOrderTypefalsestring止盈觸發後的訂單類型
      • linear: Market(默認), Limit. 對於tpslMode=Full, 僅支持tpOrderType=Market
      • spot(UTA):
        Market: 當帶了參數"takeProfit", Limit: 當帶了參數"takeProfit" 和 "tpLimitPrice"
      > slOrderTypefalsestring止損觸發後的訂單類型
      • linear: Market(默認), Limit. 對於tpslMode=Full, 僅支持slOrderType=Market
      • spot(UTA):
        Market: 當帶了參數"stopLoss", Limit: 當帶了參數"stopLoss" 和 "slLimitPrice"

      響應參數​

      參數類型說明
      resultObject
      > listarrayObject
      >> categorystring產品類型
      >> symbolstring合約名稱
      >> orderIdstring訂單Id
      >> orderLinkIdstring用戶自定義訂單Id
      >> createAtstring訂單創建時間 (毫秒)
      retExtInfoObject
      > listarrayObject
      >> codenumber成功/錯誤碼
      >> msgstring成功/錯誤消息
      信息

      ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

      請求示例​

      POST /v5/order/create-batch HTTP/1.1
      Host: api-testnet.bybit.com
      X-BAPI-SIGN: XXXXX
      X-BAPI-API-KEY: XXXXX
      X-BAPI-TIMESTAMP: 1672222064519
      X-BAPI-RECV-WINDOW: 5000
      Content-Type: application/json

      {
          "category": "spot",
          "request": [
              {
                  "symbol": "BTCUSDT",
                  "side": "Buy",
                  "orderType": "Limit",
                  "isLeverage": 0,
                  "qty": "0.05",
                  "price": "30000",
                  "timeInForce": "GTC",
                  "orderLinkId": "spot-btc-03"
              },
              {
                  "symbol": "ATOMUSDT",
                  "side": "Sell",
                  "orderType": "Limit",
                  "isLeverage": 0,
                  "qty": "2",
                  "price": "12",
                  "timeInForce": "GTC",
                  "orderLinkId": "spot-atom-03"
              }
          ]
      }

      響應示例​

      {
          "retCode": 0,
          "retMsg": "OK",
          "result": {
              "list": [
                  {
                      "category": "spot",
                      "symbol": "BTCUSDT",
                      "orderId": "1666800494330512128",
                      "orderLinkId": "spot-btc-03",
                      "createAt": "1713434102752"
                  },
                  {
                      "category": "spot",
                      "symbol": "ATOMUSDT",
                      "orderId": "1666800494330512129",
                      "orderLinkId": "spot-atom-03",
                      "createAt": "1713434102752"
                  }
              ]
          },
          "retExtInfo": {
              "list": [
                  {
                      "code": 0,
                      "msg": "OK"
                  },
                  {
                      "code": 0,
                      "msg": "OK"
                  }
              ]
          },
          "time": 1713434102753
      }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/cancel-all.html b/zh-TW/v5/order/cancel-all.html index 95fcf3b87f..018d487730 100644 --- a/zh-TW/v5/order/cancel-all.html +++ b/zh-TW/v5/order/cancel-all.html @@ -4,16 +4,16 @@ 撤銷所有訂單 | Bybit API Documentation - +
    -

    撤銷所有訂單

    撤銷全部委託單

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    +

    撤銷所有訂單

    撤銷全部委託單

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    經典帳戶覆蓋範圍: USDT永續 / 反向合約

    信息
    • 支持按照symbol/baseCoin/settleCoin撤銷訂單，若您傳入了多個參數組合, 系統僅會處理其中一個參數，其中優先級為symbol > baseCoin > settleCoin.
    • 注意: 當category=option, 您可以不傳人三個參數中的任何一個，就能取消所有期權的委託單。但是, 對於linear和inverse, 您必需指定三個參數的其中一個。
    • 注意: 當category=spot, 您可以不傳人任何參數，就能取消所有現貨的委託單 (默認普通單)。
    信息

    現貨: 經典帳戶 - 最多取消500單; 統一帳戶 - 無限制
    期貨: 經典帳戶 - 最多取消500單; 統一帳戶 - 最多取消500單
    期權: 統一帳戶 - 無限制

    HTTP請求​

    POST /v5/order/cancel-all

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: spot, linear, inverse, option
    • 經典帳戶: spot, linear, inverse
    symbolfalsestring合約名稱. 對於linear & inverse: 若不傳baseCoin和settleCoin, 該字段必傳
    baseCoinfalsestring交易幣種
    • 對於經典帳戶下的linear & inverse: 當通過baseCoin來全部撤單時，會將linear和inverse訂單全部撤掉。若不傳symbol和baseCoin, 則該字段必傳
    • 對於統一帳戶下的linear & inverse: 當通過baseCoin來全部撤單時，會將對應category的訂單全部撤掉。若不傳symbol和baseCoin, 則該字段必傳
    • 對於經典帳戶的現貨: 該字段無效
    settleCoinfalsestring結算幣種
    • 對於linear & inverse: 該字段必傳, 若不傳symbol和baseCoin
    • 該字段不支持spot
    orderFilterfalsestring
    • 當category=spot, 該字段可以傳Order(普通單), tpslOrder(止盈止損單), StopOrder(條件單), OcoOrder, BidirectionalTpslOrder(現貨雙向止盈止損訂單). 若不傳, 則默認是撤掉Order單
    • 當category=linear 或者 inverse, 該字段可以傳Order(普通單), StopOrder(條件單, 包括止盈止損單和追蹤出場單). 若不傳, 則所有類型的訂單都會被撤掉
    • 當category=option, 該字段可以傳Order, 不管傳與不傳, 都是撤掉所有訂單
    stopOrderTypefalsestring條件單類型, Stop
  • 僅用於當category=linear 或者 inverse以及orderFilter=StopOrder時, 若想僅取消條件單 (不包括止盈止損單和追蹤出場單), 則可以傳入該字段

    • 響應參數​

    參數類型說明
    listarrayObject
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義的訂單ID
    successstring"1": 成功, "0": 失敗
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    請求示例​

    POST /v5/order/cancel-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672219779140
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
      "category": "linear",
      "symbol": null,
      "settleCoin": "USDT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "1616024329462743808",
                    "orderLinkId": "1616024329462743809"
                },
                {
                    "orderId": "1616024287544869632",
                    "orderLinkId": "1616024287544869633"
                }
            ],
            "success": "1"
        },
        "retExtInfo": {},
        "time": 1707381118116
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/cancel-order.html b/zh-TW/v5/order/cancel-order.html index 3061373c97..92cad1c7e1 100644 --- a/zh-TW/v5/order/cancel-order.html +++ b/zh-TW/v5/order/cancel-order.html @@ -4,14 +4,14 @@ 撤銷委託單 | Bybit API Documentation - +
    -

    撤銷委託單

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 期權
    +

    撤銷委託單

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 期權
    經典帳戶覆蓋範圍: 現貨 / USDT永續 / 反向合約

    重要
    • 您必須指定orderId或者orderLinkId.
    • 若orderId和orderLinkId之間不匹配, 系統將會優先處理orderId.
    • 您只能撤銷未成交和部分成交的訂單.

    HTTP請求​

    POST /v5/order/cancel

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: spot, linear, option
    • 經典帳戶: spot, linear, inverse
    symboltruestring合約名稱
    orderIdfalsestring訂單Id. orderId和orderLinkId必傳其中一個
    orderLinkIdfalsestring用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
    orderFilterfalsestring僅spot有效. Order: 普通單,tpslOrder: 止盈止損單,StopOrder: 條件單. 若不傳, 默認是Order

    響應參數​

    參數類型說明
    orderIdstring訂單Id
    orderLinkIdstring用戶自定義訂單Id
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    請求示例​

    POST /v5/order/cancel HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672217376681
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
      "category": "linear",
      "symbol": "BTCPERP",
      "orderLinkId": null,
      "orderId":"c6f055d9-7f21-4079-913d-e6523a9cfffa"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
            "orderLinkId": "linear-004"
        },
        "retExtInfo": {},
        "time": 1672217377164
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/create-order.html b/zh-TW/v5/order/create-order.html index cee2f5bb9a..949c4d6579 100644 --- a/zh-TW/v5/order/create-order.html +++ b/zh-TW/v5/order/create-order.html @@ -4,12 +4,12 @@ 創建委託單 | Bybit API Documentation - +
    -

    創建委託單

    本接口提供幣幣交易，現貨槓桿交易，合約以及期權的訂單創建。

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    +

    創建委託單

    本接口提供幣幣交易，現貨槓桿交易，合約以及期權的訂單創建。

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    經典帳戶覆蓋範圍: 現貨 / USDT永續 / 反向合約

    信息

    • 支持的訂單類型 (orderType):
      限價單: orderType=Limit, 需要指定訂單數量和價格.

      市價單: orderType=Market, 以Bybit市場內最優的價格一直執行到成交. 選擇市價單時，price 參數為空。在期貨交易系統，為了保護市價單產生嚴重的滑點，Bybit 交易系統會將市價單轉為限價單進行撮合，如果市場價格轉限價時，超過滑點設置的閾值，該筆市場價格訂單將會被取消。滑點閾值是指訂單價格偏離最新成交價格的百分比，目前閾值設置為：BTC 合約3%，其他合約5%。

    • 支持的timeInForce策略:
      GTC 一直有效至取消
      @@ -25,7 +25,7 @@ 使用API的客戶預設接受本條款並負有配合調整的義務。

    提示

    對於經典帳戶進行全倉槓桿交易時，您需要先去這裡進行借貸

    現貨條件單規則

    現貨支持止盈止損單, 條件單, 但是背後的處理邏輯略有不同
    經典帳戶: 當止盈止損或者條件單創建後, 您將會得到一個訂單ID. 當它被觸發後, 您將獲取到一個全新的訂單ID
    統一帳戶: 當止盈止損或者條件單創建後, 您將會得到一個訂單ID. 當它被觸發後, 訂單ID將會保持不變

    HTTP請求​

    POST /v5/order/create

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: spot, linear, inverse, option
    • 經典帳戶: spot, linear, inverse
    symboltruestring合約名稱
    isLeveragefalseinteger是否借貸. 僅統一帳戶的現貨交易有效. 0(default): 否，則是幣幣訂單, 1: 是，則是槓桿訂單
    sidetruestringBuy, Sell
    orderTypetruestring訂單類型. Market, Limit
    qtytruestring訂單數量
    • 統一帳戶
      • 現貨: 可以通過設置marketUnit來表示市價單qty的單位, 市價買單默認是quoteCoin, 市價賣單默認是baseCoin
      • 期貨和期權: 總是以base coin作為qty的單位
    • 經典帳戶
      • 現貨: 市價買單的qty總是以quote coin為單位, 其他情況下, qty都是以base coin為單位
      • 期貨: qty總是以base coin為單位
    • 期貨: 如果傳入qty="0"以及reduceOnly="true", 則可以平掉對應合約可達單個訂單允許的最大qty的倉位, 參照查詢可交易產品的規格信息接口裡的字段maxMktOrderQty或者maxOrderQty
    marketUnitfalsestring統一帳戶現貨交易創建市價單時給入參qty指定的單位, 支持orderFilter=Order, tpslOrder 和 StopOrder
  • baseCoin: 比如, 買BTCUSDT, 則"qty"的單位是BTC
  • quoteCoin: 比如, 賣BTCUSDT, 則"qty"的單位是USDT
    • pricefalsestring訂單價格.
    • 市價單將會忽視該字段
    • 請通過該接口確認最低價格和精度要求
    • 如果有持倉, 確保價格優於強平價格
    triggerDirectionfalseinteger條件單參數. 用於辨別期望的方向.
    • 1: 當市場價上漲到了triggerPrice時觸發條件單
    • 2: 當市場價下跌到了triggerPrice時觸發條件單
    對linear和inverse有效
    orderFilterfalsestring指定訂單品種. Order: 普通單,tpslOrder: 止盈止損單,StopOrder: 條件單. 若不傳, 默認Order
    僅對現貨有效
    triggerPricefalsestring
    • 對於期貨, 是條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保:
      triggerPrice > 市場價格
      否則, triggerPrice < 市場價格
    • 對於現貨, 這是下止盈止損單或者條件單的觸發價格參數
    triggerByfalsestring條件單參數. 觸發價格類型. LastPrice, IndexPrice, MarkPrice
    僅對linear和inverse有效
    orderIvfalsestring隱含波動率. 僅option有效. 按照實際值傳入, e.g., 對於10%, 則傳入0.1. orderIv比price有更高的優先級
    timeInForcefalsestring訂單執行策略
    • 市價單，系統直接使用IOC
    • 若不傳，默認使用GTC
    positionIdxfalseinteger倉位標識, 用戶不同倉位模式. 該字段對於雙向持倉模式(僅USDT永續和反向期貨有雙向模式)是必傳:
    • 0: 單向持倉
    • 1: 買側雙向持倉
    • 2: 賣側雙向持倉
    僅對linear和inverse有效
    orderLinkIdfalsestring用戶自定義訂單Id. category=option時，該參數必傳
    takeProfitfalsestring止盈價格
  • linear & inverse: 支援統一帳戶和經典帳戶
  • spot: 僅支持統一帳戶, 創建限價單時, 可以附帶市價止盈止損和限價止盈止損
    • stopLossfalsestring止損價格
  • linear & inverse: 支援統一帳戶和經典帳戶
  • spot: 僅支持統一帳戶, 創建限價單時, 可以附帶市價止盈止損和限價止盈止損
    • tpTriggerByfalsestring觸發止盈的價格類型. MarkPrice, IndexPrice, 默認:LastPrice
    僅對linear和inverse有效
    slTriggerByfalsestring觸發止損的價格類型. MarkPrice, IndexPrice, 默認:LastPrice
    僅對linear和inverse有效
    reduceOnlyfalseboolean什麼是只減倉? true 將這筆訂單設為只減倉
    • 當減倉時, reduceOnly=true必傳
    • 只減倉單的止盈止損不生效
    對linear, inverse和option有效
    closeOnTriggerfalseboolean什麼是觸發後平倉委託?此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行.
    僅對linear和inverse有效
    smpTypefalsestringSmp執行類型. 什麼是SMP?
    mmpfalseboolean做市商保護. 僅option有效. true 表示該訂單是做市商保護訂單. 什麼是做市商保護?
    tpslModefalsestring止盈止損模式
    • Full: 全部倉位止盈止損. 此時, tpOrderType或者slOrderType必須傳Market
    • Partial: 部分倉位止盈止損(下單時沒有size選項, 實際上創建tpsl訂單時, 是按照實際成交的數量來生成止盈止損). 支持創建限價止盈止損. 注意: 創建限價止盈止損時, tpslMode必傳且為Partial
    僅對linear和inverse有效
    tpLimitPricefalsestring觸發止盈後轉換為限價單的價格
    • linear & inverse: 僅作用於當tpslMode=Partial以及tpOrderType=Limit時
    • spot(UTA): 參數必傳當創建訂單時帶了takeProfit 和 tpOrderType=Limit
    slLimitPricefalsestring觸發止損後轉換為限價單的價格
    • linear & inverse: 僅作用於當tpslMode=Partial以及slOrderType=Limit時
    • spot(UTA): 參數必傳當創建訂單時帶了stopLoss 和 slOrderType=Limit
    tpOrderTypefalsestring止盈觸發後的訂單類型
    • linear & inverse: Market(默認), Limit. 對於tpslMode=Full, 僅支持tpOrderType=Market
    • spot(UTA):
      Market: 當帶了參數"takeProfit",
      Limit: 當帶了參數"takeProfit" 和 "tpLimitPrice"
    slOrderTypefalsestring止損觸發後的訂單類型
    • linear & inverse: Market(默認), Limit. 對於tpslMode=Full, 僅支持slOrderType=Market
    • spot(UTA):
      Market: 當帶了參數"stopLoss",
      Limit: 當帶了參數"stopLoss" 和 "slLimitPrice"

    響應參數​

    參數類型說明
    orderIdstring訂單ID
    orderLinkIdstring用戶自定義訂單ID
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    請求示例​

    POST /v5/order/create HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672211928338
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    // 現貨下僅maker單
    {"category":"spot","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"0.1","price":"15600","timeInForce":"PostOnly","orderLinkId":"spot-test-01","isLeverage":0,"orderFilter":"Order"}

    // 現貨止盈止損單
    {"category":"spot","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"0.1","price":"15600","triggerPrice": "15000", "timeInForce":"Limit","orderLinkId":"spot-test-02","isLeverage":0,"orderFilter":"tpslOrder"}

    // 槓桿交易單 (統一帳戶)
    {"category":"spot","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"0.1","price":"15600","timeInForce":"Limit","orderLinkId":"spot-test-limit","isLeverage":1,"orderFilter":"Order"}

    // 現貨市價單, qty為報價幣種金額
    {"category":"spot","symbol":"BTCUSDT","side":"Buy","orderType":"Market","qty":"200","timeInForce":"IOC","orderLinkId":"spot-test-04","isLeverage":0,"orderFilter":"Order"}


    // USDT永續開多倉訂單 (單向持倉)
    {"category":"linear","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"1","price":"25000","timeInForce":"GTC","positionIdx":0,"orderLinkId":"usdt-test-01","reduceOnly":false,"takeProfit":"28000","stopLoss":"20000","tpslMode":"Partial","tpOrderType":"Limit","slOrderType":"Limit","tpLimitPrice":"27500","slLimitPrice":"20500"}

    // USDT永續平多倉訂單 (單向持倉)
    {"category": "linear", "symbol": "BTCUSDT", "side": "Sell", "orderType": "Limit", "qty": "1", "price": "30000", "timeInForce": "GTC", "positionIdx": 0, "orderLinkId": "usdt-test-02", "reduceOnly": true}

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "orderId": "1321003749386327552",
            "orderLinkId": "spot-test-postonly"
        },
        "retExtInfo": {},
        "time": 1672211918471
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/dcp.html b/zh-TW/v5/order/dcp.html index 86d57f7254..7a148004e6 100644 --- a/zh-TW/v5/order/dcp.html +++ b/zh-TW/v5/order/dcp.html @@ -4,15 +4,15 @@ 設置斷線保護時間 | Bybit API Documentation - +
    -

    設置斷線保護時間

    覆蓋範圍: 合約 / 現貨 / 期權 (統一帳戶)

    信息

    什麼是斷線保護 (Disconnection Protect)?​

    Bybit基於websocket私有連接和心跳機制，提供斷線保護功能。這計時從第一次斷開開始。如果Bybit服務器在一段時間內沒有收到客戶端的重連超過10秒（默認）並 +

    設置斷線保護時間

    覆蓋範圍: 合約 / 現貨 / 期權 (統一帳戶)

    信息

    什麼是斷線保護 (Disconnection Protect)?​

    Bybit基於websocket私有連接和心跳機制，提供斷線保護功能。這計時從第一次斷開開始。如果Bybit服務器在一段時間內沒有收到客戶端的重連超過10秒（默認）並 恢復心跳“ping”，則客戶端處於“斷線保護”狀態，客戶所有活躍的合約 / 現貨 / 期權訂單將自動取消。如果在 10 秒內，客戶端重新連接並恢復心跳“ping”，計時會在下次斷線 時重置並重新開始。

    如何啟用斷線保護​

    若您需要開啟/關閉斷線保護功能, 您可以諮詢客戶經理. 開啟後，默認的斷線保護時間為10秒。

    適用對象​

    僅適用於USDT永續 / USDC永續 / USDC交割 / 現貨 / 期權交易。

    提示

    API請求發送成功後，系統需要一定的時間才能生效。建議10秒後再查詢或設置。

    • 您可以使用該接口來查詢當前DCP配置
    • 您的私有連接必須訂閱斷線保護, 才能確保DCP功能被觸發

    HTTP請求​

    POST /v5/order/disconnected-cancel-all

    請求參數​

    參數是否必需類型說明
    productfalsestringOPTIONS(默認), DERIVATIVES, SPOT
    timeWindowtrueinteger斷線保護時間窗口. [3, 300], 單位: 秒

    響應參數​

    無

    請求示例​

    POST v5/order/disconnected-cancel-all HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675852742375
    X-BAPI-RECV-WINDOW: 50000
    Content-Type: application/json

    {
      "timeWindow": 40
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success"
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/execution.html b/zh-TW/v5/order/execution.html index 8bae1c877c..a98f0b81fe 100644 --- a/zh-TW/v5/order/execution.html +++ b/zh-TW/v5/order/execution.html @@ -4,14 +4,14 @@ 查詢成交紀錄 | Bybit API Documentation - +
    -

    查詢成交紀錄

    獲取用戶成交紀錄，返回結果按execTime降序排列。但是，對於經典帳戶現貨交易，返回結果按execId降序排列

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    +

    查詢成交紀錄

    獲取用戶成交紀錄，返回結果按execTime降序排列。但是，對於經典帳戶現貨交易，返回結果按execId降序排列

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    經典帳戶覆蓋範圍: 現貨 / USDT永續 / 反向合約

    提示
    • 儅execTime相同時,返回會有排序問題，此問題已在優化中, 目前建議依照execId+OrderId+leavesQty進行排序, 如果您想獲取實時成交信息建議使用websocket stream.
    • 單筆訂單可能會有多次成交.
    • 您可以通過指定symbol, baseCoin, orderId 和 orderLinkId字段來查詢。如果您使用多字段組合，系統的查詢優先級如下: orderId > orderLinkId > symbol > baseCoin.
    信息
    • 經典帳戶現貨支持查詢過去180天的成交紀錄
    • 統一帳戶(linear, spot, option)支持查詢過去730天的歷史成交紀錄

    HTTP 請求​

    GET /v5/execution/list

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: spot, linear, inverse, option
    • 經典帳戶: spot, linear, inverse
    symbolfalsestring合約名稱
    orderIdfalsestring訂單Id
    orderLinkIdfalsestring用戶自定義訂單id. 經典帳戶不支持該字段查詢
    baseCoinfalsestring交易幣種. 統一帳戶(反向)和經典帳戶不支持該字段查詢
    startTimefalseinteger開始時間戳 (毫秒)
    • 經典帳戶的現貨: 支持時間範圍是180天
    • 其他:
      startTime 和 endTime都不傳入, 則默認返回最近7天的數據;
      startTime 和 endTime都傳入的話, 則確保endTime - startTime ≤ 7天;
      若只傳startTime，則查詢startTime和startTime+7天的數據;
      若只傳endTime，則查詢endTime-7天和endTime的數據;
    endTimefalseinteger結束時間戳 (毫秒)
    execTypefalsestring執行類型. 經典帳戶現貨交易無效
    limitfalseinteger每頁數量限制. [1, 100]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > orderIdstring訂單Id
    > orderLinkIdstring用戶自定義訂單id. 經典帳戶現貨交易不支持
    > sidestring訂單方向.買： Buy,賣：Sell
    > orderPricestring訂單價格
    > orderQtystring訂單數量
    > leavesQtystring剩餘委託未成交數量. 經典帳戶現貨交易不支持
    > createTypestring訂單創建類型
  • 統一帳戶: 僅作用於category=linear
  • 經典帳戶: 總是返回""
  • 現貨、期權不返回該字段
    • > orderTypestring訂單類型. 市價單：Market,限價單：Limit
    > stopOrderTypestring条件单的订单类型。如果该订单不是条件单，则可能返回""或者UNKNOWN. 經典帳戶現貨交易不支持
    > execFeestring交易手續費. 您可以從這裡了解現貨手續費幣種信息
    > execIdstring成交Id
    > execPricestring成交價格
    > execQtystring成交數量
    > execTypestring交易類型. 經典帳戶現貨交易不支持
    > execValuestring成交價值. 經典帳戶現貨交易不支持
    > execTimestring成交時間（毫秒）
    > feeCurrencystring現貨手續費幣種 經典帳戶現貨交易不支持
    > isMakerBool是否是 Maker 訂單,true 為 maker 訂單，false 為 taker 訂單
    > feeRatestring手續費率. 經典帳戶現貨交易不支持
    > tradeIvstring隱含波動率，僅期權有效
    > markIvstring標記價格的隱含波動率，僅期權有效
    > markPricestring成交執行時，該 symbol 當時的標記價格. 經典帳戶現貨交易不支持
    > indexPricestring成交執行時，該 symbol 當時的指數價格，目前僅對期權業務有效
    > underlyingPricestring成交執行時，該 symbol 當時的底層資產價格，僅期權有效
    > blockTradeIdstring大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID
    > closedSizestring平倉數量
    > seqlong序列號, 用於關聯成交和倉位的更新
    • 同一時間有多筆成交, seq相同
    • 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別
    • 經典帳戶下現貨交易沒有該字段
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/execution/list?category=linear&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672283754132
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "132766%3A2%2C132766%3A2",
            "category": "linear",
            "list": [
                {
                    "symbol": "ETHPERP",
                    "orderType": "Market",
                    "underlyingPrice": "",
                    "orderLinkId": "",
                    "side": "Buy",
                    "indexPrice": "",
                    "orderId": "8c065341-7b52-4ca9-ac2c-37e31ac55c94",
                    "stopOrderType": "UNKNOWN",
                    "leavesQty": "0",
                    "execTime": "1672282722429",
                    "feeCurrency": "",
                    "isMaker": false,
                    "execFee": "0.071409",
                    "feeRate": "0.0006",
                    "execId": "e0cbe81d-0f18-5866-9415-cf319b5dab3b",
                    "tradeIv": "",
                    "blockTradeId": "",
                    "markPrice": "1183.54",
                    "execPrice": "1190.15",
                    "markIv": "",
                    "orderQty": "0.1",
                    "orderPrice": "1236.9",
                    "execValue": "119.015",
                    "execType": "Trade",
                    "execQty": "0.1",
                    "closedSize": "0.1",
                    "seq": 4688002127
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672283754510
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/open-order.html b/zh-TW/v5/order/open-order.html index 47ba49aa16..ec3ed6984a 100644 --- a/zh-TW/v5/order/open-order.html +++ b/zh-TW/v5/order/open-order.html @@ -4,14 +4,14 @@ 查詢實時和終態委託單 | Bybit API Documentation - +
    -

    查詢實時和終態委託單

    主要用於實時查詢未成交或部分成交的訂單信息, 但結合入参openOnly能夠查詢到最近500條到達終態的訂單. 若需要查詢更久的訂單紀錄，請使用查詢歷史訂單接口.

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    +

    查詢實時和終態委託單

    主要用於實時查詢未成交或部分成交的訂單信息, 但結合入参openOnly能夠查詢到最近500條到達終態的訂單. 若需要查詢更久的訂單紀錄，請使用查詢歷史訂單接口.

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    經典帳戶覆蓋範圍: 現貨 / USDT永續 / 反向合約

    提示
    • 此接口也支持查詢已成交，取消和拒絕類型的最近500條訂單信息對於spot，linear和option類別. inverse類別則無此限制.
    • 您可以通過指定symbol, baseCoin, orderId 和 orderLinkId字段來查詢. 如果您使用多字段組合，系統的查詢優先級如下: orderId > orderLinkId > symbol > baseCoin.
    • 返回的結果將以createdTime從新到舊排序.
    信息
    • 經典帳戶現貨交易僅能查詢活動狀態的委託單
    • 針對統一帳戶, 服務器重啓或發佈後請使用查詢歷史訂單接口去查詢已成交，取消和拒絕類型的訂單信息

    HTTP請求​

    GET /v5/order/realtime

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: spot, linear, inverse, option
    • 經典帳戶: spot, linear, inverse
    symbolfalsestring合約名稱. 對於linear, symbol, baseCoin 和 settleCoin必傳其中一個
    baseCoinfalsestring交易幣種. 支持linear, inverse和option. 對於若不傳，則返回期權下所有活動委託單
    settleCoinfalsestring結算幣種
    • linear: symbol 和 settleCoin必傳其中一個
    • spot: 該字段無效
    orderIdfalsestring訂單Id
    orderLinkIdfalsestring用戶自定義訂單Id
    openOnlyfalseinteger
    • 統一帳戶 & 經典帳戶0(默認): 僅查詢活動委託訂單, 比如New, PartiallyFilled訂單
    • 統一帳戶(linear, spot, option): 1, 統一帳戶(inverse)和經典帳戶: 2
      返回僅終態（已取消/拒絕/完全成交）的訂單數據, 每個帳戶下最多保留500條紀錄，如果因Bybit服務更新重啟則該部分數據會情況並重新累計, 但是訂單紀錄仍然可以從歷史訂單中查詢到
    • 當查詢是按照orderId 或者 orderLinkId時, openOnly入参將會被忽略
    • 經典帳戶現貨: 該字段無效, 僅返回活動委託單
    orderFilterfalsestringOrder: 活動單, StopOrder: 條件單, 支持現貨和期貨, tpslOrder: 止盈止損單, 僅現貨有效, OcoOrder: OCO訂單, BidirectionalTpslOrder: 現貨(UTA)雙向止盈止損訂單
    • 經典帳戶現貨: 默認是Order活動單
    • 其他: 默認是全部類型訂單
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listarrayObject
    > orderIdstring訂單Id
    > orderLinkIdstring用戶自定義Id
    > blockTradeIdstringParadigm大宗交易Id
    > symbolstring合約名稱
    > pricestring訂單價格
    > qtystring訂單數量
    > sidestring方向. Buy,Sell
    > isLeveragestring是否借貸. 僅統一帳戶spot有效. 0: 否, 1: 是. 經典帳戶現貨交易不支持, 總是0
    > positionIdxinteger倉位標識。用戶不同倉位模式
    > orderStatusstring訂單狀態
    > createTypestring訂單創建類型
  • 僅作用於category=linear 或 inverse
  • 現貨、期權不返回該字段
    • > cancelTypestring訂單被取消類型
    > rejectReasonstring拒絕原因. 經典帳戶現貨交易不支持
    > avgPricestring訂單平均成交價格
  • 統一帳戶: 不存在avg price場景的訂單返回""
  • 經典帳戶: 不存在avg price場景的訂單返回"0", 以及部分成交但最終被手動取消的訂單
    • > leavesQtystring訂單剩餘未成交的數量. 經典帳戶現貨交易不支持
    > leavesValuestring訂單剩餘未成交的價值. 經典帳戶現貨交易不支持
    > cumExecQtystring訂單累計成交數量
    > cumExecValuestring訂單累計成交價值. 經典帳戶現貨交易不支持
    > cumExecFeestring訂單累計成交的手續費. 經典帳戶現貨交易不支持
    > timeInForcestring執行策略
    > orderTypestring訂單類型. Market,Limit. 對於止盈止損單, 則表示為觸發後的訂單類型
    > stopOrderTypestring條件單類型
    > orderIvstring隱含波動率
    > marketUnitstring統一帳戶現貨交易時給入參qty選擇的單位. baseCoin, quoteCoin
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > tpslModestring止盈止損模式 Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損. 現貨不返回該字段, 期權總是返回""
    > ocoTriggerBystring現貨OCO訂單的觸發類型.OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl. 經典帳戶現貨不支持該字段
    > tpLimitPricestring觸發止盈後轉換為限價單的價格
    > slLimitPricestring觸發止損後轉換為限價單的價格
    > tpTriggerBystring觸發止盈的價格類型
    > slTriggerBystring觸發止損的價格類型
    > triggerDirectioninteger觸發方向. 1: 上漲, 2: 下跌
    > triggerBystring觸發價格的觸發類型
    > lastPriceOnCreatedstring下單時的市場價格
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?
    > placeTypestring下單類型, 僅期權使用. iv, price
    > smpTypestringSMP執行類型
    > smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    > smpOrderIdstring觸發此SMP執行的交易對手的 orderID
    > createdTimestring創建訂單的時間戳 (毫秒)
    > updatedTimestring訂單更新的時間戳 (毫秒)

    請求示例​

    GET /v5/order/realtime?symbol=ETHUSDT&category=linear&openOnly=0&limit=1  HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672219525810
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "fd4300ae-7847-404e-b947-b46980a4d140",
                    "orderLinkId": "test-000005",
                    "blockTradeId": "",
                    "symbol": "ETHUSDT",
                    "price": "1600.00",
                    "qty": "0.10",
                    "side": "Buy",
                    "isLeverage": "",
                    "positionIdx": 1,
                    "orderStatus": "New",
                    "cancelType": "UNKNOWN",
                    "rejectReason": "EC_NoError",
                    "avgPrice": "0",
                    "leavesQty": "0.10",
                    "leavesValue": "160",
                    "cumExecQty": "0.00",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "timeInForce": "GTC",
                    "orderType": "Limit",
                    "stopOrderType": "UNKNOWN",
                    "orderIv": "",
                    "triggerPrice": "0.00",
                    "takeProfit": "2500.00",
                    "stopLoss": "1500.00",
                    "tpTriggerBy": "LastPrice",
                    "slTriggerBy": "LastPrice",
                    "triggerDirection": 0,
                    "triggerBy": "UNKNOWN",
                    "lastPriceOnCreated": "",
                    "reduceOnly": false,
                    "closeOnTrigger": false,
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "tpslMode": "Full",
                    "tpLimitPrice": "",
                    "slLimitPrice": "",
                    "placeType": "",
                    "createdTime": "1684738540559",
                    "updatedTime": "1684738540561"
                }
            ],
            "nextPageCursor": "page_args%3Dfd4300ae-7847-404e-b947-b46980a4d140%26symbol%3D6%26",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1684765770483
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/order-list.html b/zh-TW/v5/order/order-list.html index 37d1420099..fca27fc410 100644 --- a/zh-TW/v5/order/order-list.html +++ b/zh-TW/v5/order/order-list.html @@ -4,14 +4,14 @@ 查詢歷史訂單 | Bybit API Documentation - +
    -

    查詢歷史訂單

    獲取歷史訂單紀錄. 由於訂單創建/撤銷是異步的, 該接口返回數據可能會有延遲. 若您想實時獲取訂單信息, 您可以查詢該接口或者通過websocket推送(推薦)

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    +

    查詢歷史訂單

    獲取歷史訂單紀錄. 由於訂單創建/撤銷是異步的, 該接口返回數據可能會有延遲. 若您想實時獲取訂單信息, 您可以查詢該接口或者通過websocket推送(推薦)

    統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    經典帳戶覆蓋範圍: USDT永續 / 反向合約 / 現貨

    提示
    • 7天內的訂單: UTA(spot,linear,option)支持查詢除了"Cancelled"(完全取消), "Rejected", "Deactivated"以外的終態訂單, UTA(inverse)和經典帳戶支持查詢活動態+終態的訂單
    • 24小時: UTA(spot,linear,option): 對於完全取消(Cancelled),以及"Rejected", "Deactivated"的訂單僅支持查詢過去24小時的訂單記錄
    • 7天外的訂單: 只能查詢到有過成交的訂單, 即完全成交, 部分成交但最終取消的訂單
    • 您可以通過指定symbol, baseCoin, orderId 和 orderLinkId字段來查詢。如果您使用多字段組合，系統的查詢優先級如下: orderId > orderLinkId > symbol > baseCoin.
    信息
    • 經典帳戶現貨僅能查詢終態訂單
    • 經典帳戶現貨: 市商帳戶只能獲取到最近3天訂單歷史, 可以前往網頁端導出更多歷史數據; 散客用戶支持查詢到最近180天的數據
    • 經典帳戶現貨: 取消單、拒絕單、未觸發取消單, 最多保留7天
    • 統一帳戶 (linear, spot, option) 支持查詢最近730天的歷史訂單紀錄

    HTTP請求​

    GET /v5/order/history

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: spot, linear, inverse, option
    • 經典帳戶: spot, linear, inverse
    symbolfalsestring合約名稱
    baseCoinfalsestring交易幣種. 統一帳戶（反向）以及經典帳戶不支持該字段的查詢
    settleCoinfalsestring結算幣種. 統一帳戶（反向）以及經典帳戶不支持該字段的查詢
    orderIdfalsestring訂單ID
    orderLinkIdfalsestring用戶自定義訂單ID
    orderFilterfalsestringOrder: 普通單, StopOrder: 條件單, 支持現貨和期貨, tpslOrder: 現貨止盈止損單, OcoOrder: OCO訂單, BidirectionalTpslOrder: 現貨(UTA)雙向止盈止損訂單
    • 經典帳戶現貨: 默認是Order活動單
    • 其他: 默認是全部類型訂單
    orderStatusfalsestring訂單狀態
    • 經典帳戶spot: 該字段無效
    • UTA(spot, linear, option): 不傳則默認查詢所有終態訂單
    • UTA(inverse)和經典帳戶: 不傳則默認查詢活動態+終態的訂單
    startTimefalseinteger開始時間戳 (毫秒). 經典帳戶現貨不支持使用startTime和endTime
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    • 若只傳startTime，則查詢startTime和startTime+7天的數據
    • 若只傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > orderIdstring訂單Id
    > orderLinkIdstring用戶自定義Id
    > blockTradeIdstring大宗交易訂單Id
    > symbolstring合約名稱
    > pricestring訂單價格
    > qtystring訂單數量
    > sidestring方向. Buy,Sell
    > isLeveragestring是否借貸. 僅統一帳戶spot有效. 0: 否, 1: 是. 經典帳戶現貨交易不支持, 總是0
    > positionIdxinteger倉位標識。用戶不同倉位模式
    > orderStatusstring訂單狀態
    > createTypestring訂單創建類型
  • 僅作用於category=linear 或 inverse
  • 現貨、期權不返回該字段
    • > cancelTypestring訂單被取消類型
    > rejectReasonstring拒絕原因. 經典帳戶現貨交易不支持
    > avgPricestring訂單平均成交價格
  • 統一帳戶: 不存在avg price場景的訂單返回""
  • 經典帳戶: 不存在avg price場景的訂單返回"0", 以及部分成交但最終被手動取消的訂單
    • > leavesQtystring訂單剩餘未成交的數量. 經典帳戶現貨交易不支持
    > leavesValuestring訂單剩餘未成交的價值. 經典帳戶現貨交易不支持
    > cumExecQtystring訂單累計成交數量
    > cumExecValuestring訂單累計成交價值. 經典帳戶現貨交易不支持
    > cumExecFeestring訂單累計成交的手續費. 經典帳戶現貨交易不支持
    > timeInForcestring執行策略
    > orderTypestring訂單類型. Market,Limit. 對於止盈止損單, 則表示為觸發後的訂單類型
  • Block trade Roll Back, Block trade-Limit: 統一帳戶大宗交易獨有的兩個枚舉值
    • > stopOrderTypestring條件單類型
    > orderIvstring隱含波動率
    > marketUnitstring統一帳戶現貨交易時給入參qty選擇的單位. baseCoin, quoteCoin
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > tpslModestring止盈止損模式 Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損. 現貨不返回該字段, 期權總是返回""
    > ocoTriggerBystring現貨OCO訂單的觸發類型.OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl. 經典帳戶現貨不支持該字段
    > tpLimitPricestring觸發止盈後轉換為限價單的價格
    > slLimitPricestring觸發止損後轉換為限價單的價格
    > tpTriggerBystring觸發止盈的價格類型
    > slTriggerBystring觸發止損的價格類型
    > triggerDirectioninteger觸發方向. 1: 上漲, 2: 下跌
    > triggerBystring觸發價格的觸發類型
    > lastPriceOnCreatedstring下單時的市場價格
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?
    > placeTypestring下單類型, 僅期權使用. iv, price
    > smpTypestringSMP執行類型
    > smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    > smpOrderIdstring觸發此SMP執行的交易對手的 orderID
    > createdTimestring創建訂單的時間戳 (毫秒)
    > updatedTimestring訂單更新的時間戳 (毫秒)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/order/history?category=linear&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672221263407
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "14bad3a1-6454-43d8-bcf2-5345896cf74d",
                    "orderLinkId": "YLxaWKMiHU",
                    "blockTradeId": "",
                    "symbol": "BTCUSDT",
                    "price": "26864.40",
                    "qty": "0.003",
                    "side": "Buy",
                    "isLeverage": "",
                    "positionIdx": 1,
                    "orderStatus": "Cancelled",
                    "cancelType": "UNKNOWN",
                    "rejectReason": "EC_PostOnlyWillTakeLiquidity",
                    "avgPrice": "0",
                    "leavesQty": "0.000",
                    "leavesValue": "0",
                    "cumExecQty": "0.000",
                    "cumExecValue": "0",
                    "cumExecFee": "0",
                    "timeInForce": "PostOnly",
                    "orderType": "Limit",
                    "stopOrderType": "UNKNOWN",
                    "orderIv": "",
                    "triggerPrice": "0.00",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "triggerDirection": 0,
                    "triggerBy": "UNKNOWN",
                    "lastPriceOnCreated": "0.00",
                    "reduceOnly": false,
                    "closeOnTrigger": false,
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "tpslMode": "",
                    "tpLimitPrice": "",
                    "slLimitPrice": "",
                    "placeType": "",
                    "createdTime": "1684476068369",
                    "updatedTime": "1684476068372"
                }
            ],
            "nextPageCursor": "page_token%3D39380%26",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1684766282976
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/order/spot-borrow-quota.html b/zh-TW/v5/order/spot-borrow-quota.html index 32d2ffc92d..f702bc899e 100644 --- a/zh-TW/v5/order/spot-borrow-quota.html +++ b/zh-TW/v5/order/spot-borrow-quota.html @@ -4,13 +4,13 @@ 查詢用戶可用額度 (現貨) | Bybit API Documentation - +
    -

    查詢用戶可用額度 (現貨)

    可以查詢現貨幣幣交易以及槓桿交易時, 可用對應幣種的實時餘額

    覆蓋範圍: 現貨 (統一帳戶)

    HTTP請求​

    GET /v5/order/spot-borrow-check

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. spot
    symboltruestring交易對名稱
    sidetruestring交易方向. Buy,Sell

    響應參數​

    參數類型說明
    symbolstring交易對名稱
    sidestring方向
    maxTradeQtystring最大可用於交易的交易幣種數量
    • 若啟用了全倉槓桿且是槓桿幣對, 則返回現貨可用+最大可借貸數量 = min(平台單一用戶可借貸上限，UTA帳戶IMR MMR反推出來的最大可借，平台資金池可用額度)
    • 否則, 僅代表現貨可用
    • 最多支持4位小數
    maxTradeAmountstring最大可用於交易的報價幣種金額
    • 若啟用了全倉槓桿且是槓桿幣對, 則返回現貨可用+最大可借貸數量 = min(平台單一用戶可借貸上限，UTA帳戶IMR MMR反推出來的最大可借，平台資金池可用額度)
    • 否則, 僅代表現貨可用
    • 最多支持8位小數
    spotMaxTradeQtystring無論是否開啟了槓桿, 這個字段表示交易幣種在幣幣交易下的可交易數量或者餘額 (不包含可借貸數量), 最多支持4位小數
    spotMaxTradeAmountstring無論是否開啟了槓桿, 這個字段表示報價幣種在幣幣交易下的可交易數量或者餘額 (不包含可借貸數量), 最多支持8位小數
    borrowCoinstring借貸幣種

    請求示例​

    GET /v5/order/spot-borrow-check?category=spot&symbol=BTCUSDT&side=Buy HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672228522214
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "maxTradeQty": "6.6065",
            "side": "Buy",
            "spotMaxTradeAmount": "9004.75628594",
            "maxTradeAmount": "218014.01330797",
            "borrowCoin": "USDT",
            "spotMaxTradeQty": "0.2728"
        },
        "retExtInfo": {},
        "time": 1698895841534
    }
    - +

    查詢用戶可用額度 (現貨)

    可以查詢現貨幣幣交易以及槓桿交易時, 可用對應幣種的實時餘額

    覆蓋範圍: 現貨 (統一帳戶)

    HTTP請求​

    GET /v5/order/spot-borrow-check

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. spot
    symboltruestring交易對名稱
    sidetruestring交易方向. Buy,Sell

    響應參數​

    參數類型說明
    symbolstring交易對名稱
    sidestring方向
    maxTradeQtystring最大可用於交易的交易幣種數量
    • 若啟用了全倉槓桿且是槓桿幣對, 則返回現貨可用+最大可借貸數量 = min(平台單一用戶可借貸上限，UTA帳戶IMR MMR反推出來的最大可借，平台資金池可用額度)
    • 否則, 僅代表現貨可用
    • 最多支持4位小數
    maxTradeAmountstring最大可用於交易的報價幣種金額
    • 若啟用了全倉槓桿且是槓桿幣對, 則返回現貨可用+最大可借貸數量 = min(平台單一用戶可借貸上限，UTA帳戶IMR MMR反推出來的最大可借，平台資金池可用額度)
    • 否則, 僅代表現貨可用
    • 最多支持8位小數
    spotMaxTradeQtystring無論是否開啟了槓桿, 這個字段表示交易幣種在幣幣交易下的可交易數量或者餘額 (不包含可借貸數量), 最多支持4位小數
    spotMaxTradeAmountstring無論是否開啟了槓桿, 這個字段表示報價幣種在幣幣交易下的可交易數量或者餘額 (不包含可借貸數量), 最多支持8位小數
    borrowCoinstring借貸幣種

    請求示例​

    GET /v5/order/spot-borrow-check?category=spot&symbol=BTCUSDT&side=Buy HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672228522214
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "symbol": "BTCUSDT",
            "maxTradeQty": "6.6065",
            "side": "Buy",
            "spotMaxTradeAmount": "9004.75628594",
            "maxTradeAmount": "218014.01330797",
            "borrowCoin": "USDT",
            "spotMaxTradeQty": "0.2728"
        },
        "retExtInfo": {},
        "time": 1698895841534
    }
    + \ No newline at end of file diff --git a/zh-TW/v5/otc/bind-uid.html b/zh-TW/v5/otc/bind-uid.html index 110204e978..a4556adcc1 100644 --- a/zh-TW/v5/otc/bind-uid.html +++ b/zh-TW/v5/otc/bind-uid.html @@ -4,13 +4,13 @@ 綁定/解綁UID | Bybit API Documentation - +

    綁定/解綁UID

    對於場外借貸產品, 您可以自行綁定新的UID到風險單元內或者解綁某個UID

    信息
    • 風險單元的主UID不能解綁
    • 該接口只能由在風險單元內的UID來請求
    • 綁定的UID必須升級到了UTA Pro
    • 通過風險單元內任一UID的的API Key操作該接口時, 則是在該風險單元內綁定或解綁UID

    HTTP 請求​

    POST /v5/ins-loan/association-uid

    請求參數​

    參數是否必需類型說明
    uidtruestringUID
    operatetruestring0: 綁定, 1: 解綁

    響應參數​

    參數類型說明
    uidstringUID
    operatestring0: 綁定, 1: 解綁

    請求示例​

    POST /v5/ins-loan/association-uid HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1699257853101
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json
    Content-Length: 43

    {
        "uid": "592324",
        "operate": "0"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "uid": "592324",
            "operate": "0"
        },
        "retExtInfo": {},
        "time": 1699257746135
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/otc/loan-info.html b/zh-TW/v5/otc/loan-info.html index 0d41154a55..e9a18c4dee 100644 --- a/zh-TW/v5/otc/loan-info.html +++ b/zh-TW/v5/otc/loan-info.html @@ -4,13 +4,13 @@ 查詢借貸訂單信息 | Bybit API Documentation - +

    查詢借貸訂單信息

    查詢借貸訂單的詳情

    提示
    • 默認查詢過去2年的數據
    • 最多支持查詢過去2年的數據

    HTTP 請求​

    GET /v5/ins-loan/loan-order

    請求參數​

    參數是否必須類型說明
    orderIdfalsestring借貸訂單ID. 若不傳，則返回全部. 按照loanTime降序排列
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger返回數量限制. [1, 100], 默認: 10

    返回參數​

    參數類型說明
    loanInfoarrayObject
    > orderIdstring借貸訂單ID
    > orderProductIdstring產品ID
    > parentUidstring綁定場外借貸產品的UID
    > loanTimestring放款時間（毫秒）
    > loanCoinstring借款幣種
    > loanAmountstring借款金額
    > unpaidAmountstring未還本金
    > unpaidIntereststring未還利息
    > repaidAmountstring已還本金
    > repaidIntereststring已還利息
    > interestRatestring日利率
    > statusstring1：未還清; 2：已還清
    > leveragestring該借貸產品的最大槓桿倍數
    > supportSpotstring是否支持現貨. 0:否; 1:是
    > supportContractstring是否支持合約 . 0: 否; 1: 是
    > supportMarginTradingstring是否支持現貨槓桿交易. 0: 否; 1: 是
    > withdrawLinestring限制提幣線
    > transferLinestring限制劃轉線
    > spotBuyLinestring限制現貨買入線
    > spotSellLinestring限制現貨交易線
    > contractOpenLinestring限制USDT永續合約開倉線
    > deferredLiquidationLinestring延期清算線
    > deferredLiquidationTimestring延期清算時間
    > reserveTokenstring備付金幣種
    > reserveQuantitystring備付金幣種數量
    > liquidationLinestring強平線
    > stopLiquidationLinestring停止強平線
    > contractLeveragestring允許USDT永續默認開倉倍數
    > transferRatiostring現貨帳戶到合約帳戶的借貸資金劃轉比例
    > spotSymbolsarray現貨交易對白名單. 若沒有配置白名單, 則返回[]
    > contractSymbolsarrayUSDT永續合約交易對白名單
    • 若沒有配置白名單, 則返回[]
    • 若supportContract="0", 則也是[]
    > supportUSDCContractstring是否支持USDC合約交易. '0':否; '1':是
    > supportUSDCOptionsstring是否支持期權交易. '0':false; '1':true
    > USDTPerpetualOpenLinestring限制USDT永續的開倉線
    > USDCContractOpenLinestring限制USDC合約的開倉線
    > USDCOptionsOpenLinestring限制期權的開倉線
    > USDTPerpetualCloseLinestring限制USDT永續的交易線
    > USDCContractCloseLinestring限制USDC合約的交易線
    > USDCOptionsCloseLinestring限制期權的交易線
    > USDCContractSymbolsarrayUSDC合約的白名單交易對
    • 若沒有配置白名單, 則是空數組[], 可以交易任何合約
    • 如果 supportUSDCContract="0", 則也是空數組[]
    > USDCOptionsSymbolsarray期權的白名單交易對
    • 若沒有配置白名單, 則是空數組[], 可以交易任何合約
    • 如果 supportUSDCOptions="0", 則也是空數組[]
    > marginLeveragestring全倉槓桿允許可開的最高槓桿
    > USDTPerpetualLeveragearrayObject
    • 如果 supportContract="0", 則返回空數組[]
    • 如果沒有配置USDT永續交易對白名單, 則返回所有的合約和槓桿
    • 如果有白名單配置, 則只返回白名單列表的合約和槓桿
    >> symbolstring合約名
    >> leveragestring最高可開槓桿
    > USDCContractLeveragearrayObject
    • 如果 supportUSDCContract="0", 則返回空數組[]
    • 如果沒有配置USDC合約交易對白名單, 則返回所有的合約和槓桿
    • 如果有白名單配置, 則只返回白名單列表的合約和槓桿
    >> symbolstring合約名
    >> leveragestring最高可開槓桿

    請求示例​

    GET /v5/ins-loan/loan-order HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1678687874060
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "loanInfo": [
                {
                    "orderId": "1468005106166530304",
                    "orderProductId": "96",
                    "parentUid": "1631521",
                    "loanTime": "1689735916000",
                    "loanCoin": "USDT",
                    "loanAmount": "204",
                    "unpaidAmount": "52.07924201",
                    "unpaidInterest": "0",
                    "repaidAmount": "151.92075799",
                    "repaidInterest": "0",
                    "interestRate": "0.00019178",
                    "status": "1",
                    "leverage": "4",
                    "supportSpot": "1",
                    "supportContract": "1",
                    "withdrawLine": "",
                    "transferLine": "",
                    "spotBuyLine": "0.71",
                    "spotSellLine": "0.71",
                    "contractOpenLine": "0.71",
                    "liquidationLine": "0.75",
                    "stopLiquidationLine": "0.35000000",
                    "contractLeverage": "7",
                    "transferRatio": "1",
                    "spotSymbols": [],
                    "contractSymbols": [],
                    "supportUSDCContract": "1",
                    "supportUSDCOptions": "1",
                    "USDTPerpetualOpenLine": "0.71",
                    "USDCContractOpenLine": "0.71",
                    "USDCOptionsOpenLine": "0.71",
                    "USDTPerpetualCloseLine": "0.71",
                    "USDCContractCloseLine": "0.71",
                    "USDCOptionsCloseLine": "0.71",
                    "USDCContractSymbols": [],
                    "USDCOptionsSymbols": [],
                    "deferredLiquidationLine":"",
                    "deferredLiquidationTime":"",
                    "marginLeverage": "4",
                    "USDTPerpetualLeverage": [
                        {
                            "symbol": "SUSHIUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "INJUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "RDNTUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "ZRXUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "HIGHUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "WAVESUSDT",
                            "leverage": "7"
                        },
                        ...
                        {
                            "symbol": "ACHUSDT",
                            "leverage": "7"
                        },
                        {
                            "symbol": "SUNUSDT",
                            "leverage": "7"
                        }
                    ],
                    "USDCContractLeverage": [
                        {
                            "symbol": "BTCPERP",
                            "leverage": "8"
                        },
                        {
                            "symbol": "BTC-Futures",
                            "leverage": "8"
                        },
                        ...
                        {
                            "symbol": "ETH-Futures",
                            "leverage": "8"
                        },
                        {
                            "symbol": "SOLPERP",
                            "leverage": "8"
                        },
                        {
                            "symbol": "ETHPERP",
                            "leverage": "8"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1689745773187
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/otc/ltv-convert.html b/zh-TW/v5/otc/ltv-convert.html index 485ab470d1..84c966d9a8 100644 --- a/zh-TW/v5/otc/ltv-convert.html +++ b/zh-TW/v5/otc/ltv-convert.html @@ -4,13 +4,13 @@ 查詢風險率 | Bybit API Documentation - +

    查詢風險率

    HTTP 請求​

    GET /v5/ins-loan/ltv-convert

    請求參數​

    無

    返回參數​

    參數類型說明
    ltvInfoarrayObject
    > ltvstring風險率
  • 該數據是實時計算
  • 如果持有機構借貸, 強烈建議每秒查詢一次ltv。當達到0.9 (90%)時即觸發強平
    • > rststring剩餘清算時間（UTC 時間，以秒為單位）。 未觸發時顯示為空字串。
    > parentUidstring被指定綁定為機構借貸產品的主UID
    > subAccountUidsarray綁定場外借貸產品的UID
    > unpaidAmountstring總負債 (USDT)
    > unpaidInfoarray負債明細
    >> tokenstring幣種
    >> unpaidQtystring未還本金
    >> unpaidIntereststring該字段無效, 暫時請忽略
    > balancestring總資產(保證金幣種資產折算為USDT資產). 可以參考這裡了解詳細計算
    > balanceInfoarray資產明細
    >> tokenstring保證金幣種
    >> pricestring保證金幣種價格
    >> qtystring保證金數量
    >> convertedAmountstring保證金折算金額

    請求示例​

    GET /v5/ins-loan/ltv-convert HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686638165351
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "ltvInfo": [
                {
                    "ltv": "0.75",
                    "rst": "",
                    "parentUid": "xxxxx",
                    "subAccountUids": [
                        "60568258"
                    ],
                    "unpaidAmount": "30",
                    "unpaidInfo": [
                        {
                            "token": "USDT",
                            "unpaidQty": "30",
                            "unpaidInterest": "0"
                        }
                    ],
                    "balance": "40",
                    "balanceInfo": [
                        {
                            "token": "USDT",
                            "price": "1",
                            "qty": "40",
                            "convertedAmount": "40"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686638166323
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/otc/margin-coin-convert-info.html b/zh-TW/v5/otc/margin-coin-convert-info.html index b621ec7fad..58e5e0a548 100644 --- a/zh-TW/v5/otc/margin-coin-convert-info.html +++ b/zh-TW/v5/otc/margin-coin-convert-info.html @@ -4,13 +4,13 @@ 查詢保證金幣種信息 | Bybit API Documentation - +

    查詢保證金幣種信息

    提示
    • 該接口在不傳入api key和secret進行鑒權時, 則返回公共數據
    • 該接口在傳入api key和secret進行鑒權時且uid綁定了場外借貸產品, 則返回特定的保證金幣種數據

    HTTP 請求​

    GET /v5/ins-loan/ensure-tokens-convert

    請求參數​

    參數是否必須類型說明
    productIdfalsestring產品ID. 若不傳，則返回所有產品的保證金幣種信息. 現貨返回折算率大於0的幣種.

    返回參數​

    參數類型說明
    marginTokenarrayObject
    > productIdstring產品ID
    > tokenInfoarray現貨保證金幣種信息
    >> tokenstring保證金幣種
    >> convertRatioListarray保證金幣種折算率列
    >>> ladderstring階梯
    >>> convertRatiostring折算率

    請求示例​

    GET /v5/ins-loan/ensure-tokens HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "marginToken": [
                {
                    "productId": "81",
                    "tokenInfo": [
                        {
                            "token": "USDT",
                            "convertRatioList": [
                                {
                                    "ladder": "0-500",
                                    "convertRatio": "0.95"
                                },
                                {
                                    "ladder": "500-1000",
                                    "convertRatio": "0.9"
                                },
                                {
                                    "ladder": "1000-2000",
                                    "convertRatio": "0.8"
                                },
                                {
                                    "ladder": "2000-4000",
                                    "convertRatio": "0.7"
                                },
                                {
                                    "ladder": "4000-99999999999",
                                    "convertRatio": "0.6"
                                }
                            ]
                        }
                      ...
                    ]
                },
                {
                    "productId": "82",
                    "tokenInfo": [
                        ...
                        {
                            "token": "USDT",
                            "convertRatioList": [
                                {
                                    "ladder": "0-1000",
                                    "convertRatio": "0.7"
                                },
                                {
                                    "ladder": "1000-2000",
                                    "convertRatio": "0.65"
                                },
                                {
                                    "ladder": "2000-99999999999",
                                    "convertRatio": "0.6"
                                }
                            ]
                        }
                    ]
                },
                {
                    "productId": "84",
                    "tokenInfo": [
                        ...
                        {
                            "token": "BTC",
                            "convertRatioList": [
                                {
                                    "ladder": "0-1000",
                                    "convertRatio": "1"
                                },
                                {
                                    "ladder": "1000-5000",
                                    "convertRatio": "0.9"
                                },
                                {
                                    "ladder": "5000-99999999999",
                                    "convertRatio": "0.55"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1683276016497
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/otc/margin-product-info.html b/zh-TW/v5/otc/margin-product-info.html index ccb44b4930..cbc7f98ff3 100644 --- a/zh-TW/v5/otc/margin-product-info.html +++ b/zh-TW/v5/otc/margin-product-info.html @@ -4,13 +4,13 @@ 查詢產品信息 | Bybit API Documentation - +

    查詢產品信息

    提示
    • 該接口在不傳入api key和secret進行鑒權時, 則返回公共產品數據
    • 該接口在傳入api key和secret進行鑒權時且uid綁定了場外借貸產品, 則返回特定的產品數據

    HTTP 請求​

    GET /v5/ins-loan/product-infos

    請求參數​

    參數是否必須類型說明
    productIdfalsestring產品ID. 若不傳，則返回所有產品數據

    返回參數​

    參數類型說明
    marginProductInfoarrayObject
    > productIdstring產品ID
    > leveragestring該借貸產品的最大槓桿倍數
    > supportSpotinteger是否支持現貨. 0:否; 1:是
    > supportContractinteger是否支持合約 . 0: 否; 1: 是
    > withdrawLinestring限制提幣線
    > transferLinestring限制劃轉線
    > spotBuyLinestring限制現貨買入線
    > spotSellLinestring限制現貨交易線
    > contractOpenLinestring限制合約開倉線
    > liquidationLinestring強平線
    > stopLiquidationLinestring停止強平線
    > contractLeveragestring允許USDT永續默認開倉倍數
    > transferRatiostring現貨帳戶到合約帳戶的借貸資金劃轉比例
    > spotSymbolsarray現貨交易對白名單. 若沒有配置白名單, 則返回[]
    > contractSymbolsarrayUSDT永續合約交易對白名單
    • 若沒有配置白名單, 則返回[]
    • 若supportContract="0", 則也是[]
    > supportUSDCContractinteger是否支持USDC合約交易. '0':否; '1':是
    > supportUSDCOptionsinteger是否支持期權交易. '0':false; '1':true
    > supportMarginTradinginteger是否支持現貨槓桿交易. 0: 否; 1: 是
    > deferredLiquidationLinestring延期清算線
    > deferredLiquidationTimestring延期清算時間
    > USDTPerpetualOpenLinestring限制USDT永續的開倉線
    > USDCContractOpenLinestring限制USDC合約的開倉線
    > USDCOptionsOpenLinestring限制期權的開倉線
    > USDTPerpetualCloseLinestring限制USDT永續的交易線
    > USDCContractCloseLinestring限制USDC合約的交易線
    > USDCOptionsCloseLinestring限制期權的交易線
    > USDCContractSymbolsarrayUSDC合約的白名單交易對
    • 若沒有配置白名單, 則是空數組[], 可以交易任何合約
    • 如果 supportUSDCContract="0", 則也是空數組[]
    > USDCOptionsSymbolsarray期權的白名單交易對
    • 若沒有配置白名單, 則是空數組[], 可以交易任何合約
    • 如果 supportUSDCOptions="0", 則也是空數組[]
    > marginLeveragestring全倉槓桿允許可開的最高槓桿
    > USDTPerpetualLeveragearrayObject
    • 如果 supportContract="0", 則返回空數組[]
    • 如果沒有配置USDT永續交易對白名單, 則返回所有的合約和槓桿
    • 如果有白名單配置, 則只返回白名單列表的合約和槓桿
    >> symbolstring合約名
    >> leveragestring最高可開槓桿
    > USDCContractLeveragearrayObject
    • 如果 supportUSDCContract="0", 則返回空數組[]
    • 如果沒有配置USDC合約交易對白名單, 則返回所有的合約和槓桿
    • 如果有白名單配置, 則只返回白名單列表的合約和槓桿
    >> symbolstring合約名
    >> leveragestring最高可開槓桿

    請求示例​

    GET /v5/ins-loan/product-infos?productId=91 HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "marginProductInfo": [
                {
                    "productId": "91",
                    "leverage": "4.00000000",
                    "supportSpot": 1,
                    "supportContract": 0,
                    "withdrawLine": "",
                    "transferLine": "",
                    "spotBuyLine": "",
                    "spotSellLine": "",
                    "contractOpenLine": "",
                    "liquidationLine": "0.75",
                    "stopLiquidationLine": "0.35000000",
                    "contractLeverage": "0",
                    "transferRatio": "0",
                    "spotSymbols": [],
                    "contractSymbols": [],
                    "supportUSDCContract": 0,
                    "supportUSDCOptions": 0,
                    "USDTPerpetualOpenLine": "",
                    "USDCContractOpenLine": "",
                    "USDCOptionsOpenLine": "",
                    "USDTPerpetualCloseLine": "",
                    "USDCContractCloseLine": "",
                    "USDCOptionsCloseLine": "",
                    "USDCContractSymbols": [],
                    "USDCOptionsSymbols": [],
                    "marginLeverage": "0",
                    "USDTPerpetualLeverage": [],
                    "USDCContractLeverage": [],
                    "deferredLiquidationLine":"",
                    "deferredLiquidationTime":"",
                }
            ]
        },
        "retExtInfo": {},
        "time": 1689747746332
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/otc/repay-info.html b/zh-TW/v5/otc/repay-info.html index 6585af8dd8..17a291a49a 100644 --- a/zh-TW/v5/otc/repay-info.html +++ b/zh-TW/v5/otc/repay-info.html @@ -4,13 +4,13 @@ 查詢還款信息 | Bybit API Documentation - +

    查詢還款信息

    提示
    • 默認查詢過去2年的數據
    • 最多支持查詢過去2年的數據

    HTTP 請求​

    GET /v5/ins-loan/repaid-history

    請求參數​

    參數是否必須類型說明
    startTimefalseinteger開始時間戳 (毫秒)
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger返回數量限制. [1, 100]. 默認: 100

    返回參數​

    參數類型說明
    repayInfoarrayObject
    > repayOrderIdstring還款訂單號
    > repaidTimestring還款時間（毫秒）
    > tokenstring還款幣種
    > quantitystring還款本金
    > intereststring還款利息
    > businessTypestring還款類型. 1：正常還款; 2：系統強平還款
    > statusstring1：還款成功; 2：還款失敗

    Request Example​

    GET /v5/ins-loan/repaid-history HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1678687944725
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX

    Response Example​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "repayInfo": [
                {
                    "repayOrderId": "8189",
                    "repaidTime": "1663126393000",
                    "token": "USDT",
                    "quantity": "30000",
                    "interest": "0",
                    "businessType": "1",
                    "status": "1"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1669366648366
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position.html b/zh-TW/v5/position.html index aceae5fa8c..9bc66b1dcf 100644 --- a/zh-TW/v5/position.html +++ b/zh-TW/v5/position.html @@ -4,14 +4,14 @@ 查詢持倉 (實時) | Bybit API Documentation - +

    查詢持倉 (實時)

    該接口可以獲取用戶的持倉信息，比如持倉數量，累計盈虧等

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
    -經典帳戶覆蓋範圍: USDT永續 / 反向合約

    信息

    關於反向合約的額外查詢規則,

    1. 通過這樣子查詢"/v5/position/list?category=inverse", 您可以查詢到所有當前持有的反向合約倉位;
    2. symbol字段支持傳入最多10個反向合約;

    HTTP 請求​

    GET /v5/position/list

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear,inverse, option
    • 經典帳戶: linear, inverse
    symbolfalsestring合約名稱
    • 若傳了symbol, 則不管是否有倉位都返回該symbol數據
    • 若symbol不傳但傳了settleCoin, 則僅返回有實際倉位的數據
    baseCoinfalsestring交易幣種. 僅option. 若不傳，則返回期權下所有持倉
    settleCoinfalsestring結算幣種. 對於USDT和USDC期貨而言，symbol和settleCon必傳其中一個, 若都傳，則symbol有更高的優先級
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > positionIdxinteger倉位標識符, 用于在不同仓位模式下标识仓位
    > riskIdinteger风险限额ID，參見風險限額接口. 注意：若賬戶為組合保證金模式(PM)，該字段返回0，風險限額規則失效
    > riskLimitValuestring當前風險限額ID對應的持倉限制量. 注意：若賬戶為組合保證金模式(PM)，該字段返回""，風險限額規則失效
    > symbolstring合約名称
    > sidestring持倉方向，Buy：多头；Sell：空头.
    • 經典帳戶的單向模式下和統一帳戶的反向合約: 空倉時返回None.
    • 統一帳戶(正向合約): 單向或對沖模式空的仓位返回空字符串
    > sizestring當前倉位的合约數量
    > avgPricestring當前倉位的平均入場價格
  • 對於8小時結算的USDC合約倉位, 該字段表示的是平均開倉價格, 不隨著結算而改變
    • > positionValuestring仓位的價值
    > tradeModeinteger交易模式。
    • 統一帳戶 (反向合約) & 經典帳戶: 0: 全倉, 1: 逐倉
    • 統一帳戶: 廢棄, 總是 0
    > autoAddMargininteger是否自動追加保證金. 0: 否, 1: 是. 僅當統一帳戶(除反向合約)開啟了帳戶維度的逐倉保證金模式, 該字段才有意義
    > positionStatusString倉位状态. Normal,Liq, Adl
    > leveragestring當前倉位的槓桿，仅适用于合约. 注意：若賬戶為組合保證金模式(PM)，該字段返回空字符串，槓桿規則失效
    > markPricestringsymbol 的最新標記價格
    > liqPricestring倉位強平價格，
    • UTA(反向合約) & 普通账户 & UTA(開啟逐倉保證金模式)：是逐倉和全倉持仓的真實價格, 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""。
    • 統一帳戶(全倉保證金)：是全倉持仓的预估价格（因为统一帳戶模式是按照帳戶維度控制风险率), 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""
    但是對於組合保證金模式，此字段為空，不會提供強平價格
    > bustPricestring倉位破產價格. 統一保證金模式返回"", 無倉位破產價格 (不包括統一帳戶下的反向交易)
    > positionIMstring倉位起始保證金. 組合保證金模式(PM)下, 該字段返回為空字符串
    > positionMMstring倉位維持保證金. 組合保證金模式(PM)下, 該字段返回為空字符串
    > tpslModestring該字段廢棄, 無意義, 總是返回"Full". 期權總是返回""
    > positionBalancestring倉位保證金
  • 統一帳戶(linear): 僅在逐倉保證金模式下有意義
    • > takeProfitstring止盈價格
    > stopLossstring止損價格
    > trailingStopstring追蹤止損（與當前價格的距離）
    > sessionAvgPricestringUSDC合約平均持倉價格, 會隨著8小時結算而變動
    > deltastringDelta, 期權的獨有字段
    > gammastringGamma, 期權的獨有字段
    > vegastringVega, 期權的獨有字段
    > thetastringTheta, 期權的獨有字段
    > unrealisedPnlstring未结盈亏
    > curRealisedPnlstring當前持倉的已結盈虧
    > cumRealisedPnlstring累计已结盈亏
    • 期貨: 是從第一次開始有持倉加總的已結盈虧
    • 期權: 總是"", 無意義
    > adlRankIndicatorinteger自動減倉燈. 什麼是自動減倉機制?
    > isReduceOnlyboolean僅當Bybit需要降低某個Symbol的風險限額時有用
    • true: 僅允許減倉操作. 您可以考慮一系列的方式, 比如, 降低risk limit檔位, 或者同檔位修改槓桿或減少倉位, 或者增加保證金, 或者撤單, 這些操作做完後, 可以主動調用確認新的風險限額接口
    • false(默認): 沒有交易限制, 表示您的倉位在系統調整時處於風險水平之下
    • 僅對逐倉和全倉的期貨倉位有意義
    > mmrSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改MMR的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了MMR調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > leverageSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改槓桿的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了槓桿調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > createdTimestring倉位創建時間
    > updatedTimestring倉位數據更新時間
    > seqlong序列號, 用於關聯成交和倉位的更新
    • 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別
    • 如果該幣對從未被交易過, 查詢時則會返回"-1"
    • 對於更新槓桿、更新風險限額等非交易行為, 將會返回上一次成交時更新的seq
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/position/list?category=linear&symbol=XRPUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672280218882
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "positionIdx": 0,
                    "riskId": 1,
                    "riskLimitValue": "150",
                    "symbol": "BTCUSD",
                    "side": "Sell",
                    "size": "300",
                    "avgPrice": "27464.50441675",
                    "positionValue": "0.01092319",
                    "tradeMode": 0,
                    "positionStatus": "Normal",
                    "autoAddMargin": 1,
                    "adlRankIndicator": 2,
                    "leverage": "10",
                    "positionBalance": "0.00139186",
                    "markPrice": "28224.50",
                    "liqPrice": "",
                    "bustPrice": "999999.00",
                    "positionMM": "0.0000015",
                    "positionIM": "0.00010923",
                    "tpslMode": "Full",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "trailingStop": "0.00",
                    "unrealisedPnl": "-0.00029413",
                    "sessionAvgPrice": "",
                    "curRealisedPnl": "0.00013123",
                    "cumRealisedPnl": "-0.00096902",
                    "seq": 5723621632,
                    "isReduceOnly": false,
                    "mmrSysUpdateTime": "",
                    "leverageSysUpdatedTime": "",
                    "createdTime": "1676538056258",
                    "updatedTime": "1697673600012"
                }
            ],
            "nextPageCursor": "",
            "category": "inverse"
        },
        "retExtInfo": {},
        "time": 1697684980172
    }
    - +經典帳戶覆蓋範圍: USDT永續 / 反向合約

    信息

    關於反向合約的額外查詢規則,

    1. 通過這樣子查詢"/v5/position/list?category=inverse", 您可以查詢到所有當前持有的反向合約倉位;
    2. symbol字段支持傳入最多10個反向合約;

    HTTP 請求​

    GET /v5/position/list

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear,inverse, option
    • 經典帳戶: linear, inverse
    symbolfalsestring合約名稱
    • 若傳了symbol, 則不管是否有倉位都返回該symbol數據
    • 若symbol不傳但傳了settleCoin, 則僅返回有實際倉位的數據
    baseCoinfalsestring交易幣種. 僅option. 若不傳，則返回期權下所有持倉
    settleCoinfalsestring結算幣種. 對於USDT和USDC期貨而言，symbol和settleCon必傳其中一個, 若都傳，則symbol有更高的優先級
    limitfalseinteger每頁數量限制. [1, 200]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > positionIdxinteger倉位標識符, 用于在不同仓位模式下标识仓位
    > riskIdinteger风险限额ID，參見風險限額接口. 注意：若賬戶為組合保證金模式(PM)，該字段返回0，風險限額規則失效
    > riskLimitValuestring當前風險限額ID對應的持倉限制量. 注意：若賬戶為組合保證金模式(PM)，該字段返回""，風險限額規則失效
    > symbolstring合約名称
    > sidestring持倉方向，Buy：多头；Sell：空头.
    • 經典帳戶的單向模式下和統一帳戶的反向合約: 空倉時返回None.
    • 統一帳戶(正向合約): 單向或對沖模式空的仓位返回空字符串
    > sizestring當前倉位的合约數量
    > avgPricestring當前倉位的平均入場價格
  • 對於8小時結算的USDC合約倉位, 該字段表示的是平均開倉價格, 不隨著結算而改變
    • > positionValuestring仓位的價值
    > tradeModeinteger交易模式。
    • 統一帳戶 (反向合約) & 經典帳戶: 0: 全倉, 1: 逐倉
    • 統一帳戶: 廢棄, 總是 0
    > autoAddMargininteger是否自動追加保證金. 0: 否, 1: 是. 僅當統一帳戶(除反向合約)開啟了帳戶維度的逐倉保證金模式, 該字段才有意義
    > positionStatusString倉位状态. Normal,Liq, Adl
    > leveragestring當前倉位的槓桿，仅适用于合约. 注意：若賬戶為組合保證金模式(PM)，該字段返回空字符串，槓桿規則失效
    > markPricestringsymbol 的最新標記價格
    > liqPricestring倉位強平價格，
    • UTA(反向合約) & 普通账户 & UTA(開啟逐倉保證金模式)：是逐倉和全倉持仓的真實價格, 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""。
    • 統一帳戶(全倉保證金)：是全倉持仓的预估价格（因为统一帳戶模式是按照帳戶維度控制风险率), 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""
    但是對於組合保證金模式，此字段為空，不會提供強平價格
    > bustPricestring倉位破產價格. 統一保證金模式返回"", 無倉位破產價格 (不包括統一帳戶下的反向交易)
    > positionIMstring倉位起始保證金. 組合保證金模式(PM)下, 該字段返回為空字符串
    > positionMMstring倉位維持保證金. 組合保證金模式(PM)下, 該字段返回為空字符串
    > tpslModestring該字段廢棄, 無意義, 總是返回"Full". 期權總是返回""
    > positionBalancestring倉位保證金
  • 統一帳戶(linear): 僅在逐倉保證金模式下有意義
    • > takeProfitstring止盈價格
    > stopLossstring止損價格
    > trailingStopstring追蹤止損（與當前價格的距離）
    > sessionAvgPricestringUSDC合約平均持倉價格, 會隨著8小時結算而變動
    > deltastringDelta, 期權的獨有字段
    > gammastringGamma, 期權的獨有字段
    > vegastringVega, 期權的獨有字段
    > thetastringTheta, 期權的獨有字段
    > unrealisedPnlstring未结盈亏
    > curRealisedPnlstring當前持倉的已結盈虧
    > cumRealisedPnlstring累计已结盈亏
    • 期貨: 是從第一次開始有持倉加總的已結盈虧
    • 期權: 總是"", 無意義
    > adlRankIndicatorinteger自動減倉燈. 什麼是自動減倉機制?
    > isReduceOnlyboolean僅當Bybit需要降低某個Symbol的風險限額時有用
    • true: 僅允許減倉操作. 您可以考慮一系列的方式, 比如, 降低risk limit檔位, 或者同檔位修改槓桿或減少倉位, 或者增加保證金, 或者撤單, 這些操作做完後, 可以主動調用確認新的風險限額接口
    • false(默認): 沒有交易限制, 表示您的倉位在系統調整時處於風險水平之下
    • 僅對逐倉和全倉的期貨倉位有意義
    > mmrSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改MMR的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了MMR調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > leverageSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改槓桿的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了槓桿調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > createdTimestring倉位創建時間
    > updatedTimestring倉位數據更新時間
    > seqlong序列號, 用於關聯成交和倉位的更新
    • 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別
    • 如果該幣對從未被交易過, 查詢時則會返回"-1"
    • 對於更新槓桿、更新風險限額等非交易行為, 將會返回上一次成交時更新的seq
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/position/list?category=linear&symbol=XRPUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672280218882
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "positionIdx": 0,
                    "riskId": 1,
                    "riskLimitValue": "150",
                    "symbol": "BTCUSD",
                    "side": "Sell",
                    "size": "300",
                    "avgPrice": "27464.50441675",
                    "positionValue": "0.01092319",
                    "tradeMode": 0,
                    "positionStatus": "Normal",
                    "autoAddMargin": 1,
                    "adlRankIndicator": 2,
                    "leverage": "10",
                    "positionBalance": "0.00139186",
                    "markPrice": "28224.50",
                    "liqPrice": "",
                    "bustPrice": "999999.00",
                    "positionMM": "0.0000015",
                    "positionIM": "0.00010923",
                    "tpslMode": "Full",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "trailingStop": "0.00",
                    "unrealisedPnl": "-0.00029413",
                    "sessionAvgPrice": "",
                    "curRealisedPnl": "0.00013123",
                    "cumRealisedPnl": "-0.00096902",
                    "seq": 5723621632,
                    "isReduceOnly": false,
                    "mmrSysUpdateTime": "",
                    "leverageSysUpdatedTime": "",
                    "createdTime": "1676538056258",
                    "updatedTime": "1697673600012"
                }
            ],
            "nextPageCursor": "",
            "category": "inverse"
        },
        "retExtInfo": {},
        "time": 1697684980172
    }
    + \ No newline at end of file diff --git a/zh-TW/v5/position/auto-add-margin.html b/zh-TW/v5/position/auto-add-margin.html index fd180512f5..9db847fd62 100644 --- a/zh-TW/v5/position/auto-add-margin.html +++ b/zh-TW/v5/position/auto-add-margin.html @@ -4,14 +4,14 @@ 設置自動追加保證金 | Bybit API Documentation - +

    設置自動追加保證金

    開關自動追加保證金，僅適用於逐倉保證金模式

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割
    經典帳戶覆蓋範圍: USDT永續

    HTTP 請求​

    POST /v5/position/set-auto-add-margin

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear
    • 經典帳戶: linear
    symboltruestring合約名稱
    autoAddMargintrueinteger是否自動追加保證金. 0: 關閉. 1: 開啟
    positionIdxfalseinteger倉位標識，用於標識不同倉位, 雙向持倉模式下，該字段必傳
    • 0: 單向持倉模式
    • 1: 買側雙向持倉模式
    • 2: 賣側雙向持倉模式

    響應參數​

    無

    請求示例​

    POST /v5/position/set-auto-add-margin HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675255134857
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "BTCUSDT",
        "autoAddmargin": 1,
        "positionIdx": null
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1675255135069
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/close-pnl.html b/zh-TW/v5/position/close-pnl.html index a066a4b33b..57829fe0b6 100644 --- a/zh-TW/v5/position/close-pnl.html +++ b/zh-TW/v5/position/close-pnl.html @@ -4,14 +4,14 @@ 查詢平倉盈虧 | Bybit API Documentation - +

    查詢平倉盈虧

    獲取當前用戶的所有平倉盈虧數據，返回結果按照createdTime降序排列.

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約
    經典帳戶覆蓋範圍: USDT永續 / 反向合約

    信息
    • 經典帳戶: 返回結果按照updatedTime降序排列.
    • 統一帳戶 (反向合約除外): 結果依createdTime降序排列，之後與經典帳戶一致
    • 統一帳戶 (linear, spot, option) 支持查詢過去730天的平倉盈虧紀錄

    HTTP 請求​

    GET /v5/position/closed-pnl

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear, inverse
    • 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
    symbolfalsestring合約名稱
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    • 若只傳startTime，則查詢startTime和startTime+7天的數據
    • 若只傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 100]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > orderIdstring訂單Id
    > sidestring買賣方向 Buy, Side
    > qtystring訂單數量
    > orderPricestring訂單價格
    > orderTypestring訂單類型. Market,Limit
    > execTypestring執行類型. Trade, BustTrade, SessionSettlePnL, Settle, MovePosition
    > closedSizestring平倉數量
    > cumEntryValuestring被平倉位的累計入場價值
    > avgEntryPricestring平均入場價格
    > cumExitValuestring被平倉位的累計出場價值
    > avgExitPricestring平均出場價格
    > closedPnlstring被平倉位的盈虧
    > fillCountstring成交筆數
    > leveragestring持倉槓桿
    > createdTimestring創建時間 (毫秒)
    > updatedTimestring更新時間 (毫秒)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/position/closed-pnl?category=linear&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672284128523
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "5a373bfe-188d-4913-9c81-d57ab5be8068%3A1672214887231423699%2C5a373bfe-188d-4913-9c81-d57ab5be8068%3A1672214887231423699",
            "category": "linear",
            "list": [
                {
                    "symbol": "ETHPERP",
                    "orderType": "Market",
                    "leverage": "3",
                    "updatedTime": "1672214887236",
                    "side": "Sell",
                    "orderId": "5a373bfe-188d-4913-9c81-d57ab5be8068",
                    "closedPnl": "-47.4065323",
                    "avgEntryPrice": "1194.97516667",
                    "qty": "3",
                    "cumEntryValue": "3584.9255",
                    "createdTime": "1672214887231423699",
                    "orderPrice": "1122.95",
                    "closedSize": "3",
                    "avgExitPrice": "1180.59833333",
                    "execType": "Trade",
                    "fillCount": "4",
                    "cumExitValue": "3541.795"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672284129153
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/confirm-mmr.html b/zh-TW/v5/position/confirm-mmr.html index 0392a8fb56..7b051d595f 100644 --- a/zh-TW/v5/position/confirm-mmr.html +++ b/zh-TW/v5/position/confirm-mmr.html @@ -4,7 +4,7 @@ 確認新的風險限額 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    確認新的風險限額

    僅適用於當用戶被標記為僅減倉 (請看持倉接口中的isReduceOnly字段) 時, 在用戶主動調整風險水位後, 調用該接口來試算調整後的風 險水平, 若通過(retCode=0), 則系統會移除僅減倉標記, 推薦自行再調用下倉位接口確認isReduceOnly字段是否變成false

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約
    經典帳戶覆蓋範圍: USDT永續 / 反向合約

    HTTP 請求​

    POST /v5/position/confirm-pending-mmr

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear, inverse
    • 經典帳戶: linear, inverse
    symboltruestring合約名稱

    響應參數​

    無

    請求示例​

    POST /v5/position/confirm-pending-mmr HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1698051123673
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 53

    {
        "category": "linear",
        "symbol": "BTCUSDT"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1698051124588
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/cross-isolate.html b/zh-TW/v5/position/cross-isolate.html index 326f1c028f..745e75882c 100644 --- a/zh-TW/v5/position/cross-isolate.html +++ b/zh-TW/v5/position/cross-isolate.html @@ -4,14 +4,14 @@ 切換全倉/逐倉保證金(交易對) | Bybit API Documentation - +

    切換全倉/逐倉保證金(交易對)

    選擇全倉保證金或者是逐倉保證金，請參閱這裡了解關於全倉/逐倉保證金模式。

    統一帳戶覆蓋範圍: 反向合約
    經典帳戶覆蓋範圍: USDT永續 / 反向合約

    HTTP 請求​

    POST /v5/position/switch-isolated

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: inverse
    • 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
    symboltruestring合約名稱
    tradeModetrueinteger0: 全倉. 1: 逐倉
    buyLeveragetruestring買側槓桿倍數. 必須與sellLeverage的值保持相同
    sellLeveragetruestring賣側槓桿倍數. 必須與buyLeverage的值保持相同

    響應參數​

    無

    請求示例​

    POST /v5/position/switch-isolated HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN-TYPE: 2
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675248447965
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 121

    {
        "category": "linear",
        "symbol": "ETHUSDT",
        "tradeMode": 1,
        "buyLeverage": "10",
        "sellLeverage": "10"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1675248433635
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/leverage.html b/zh-TW/v5/position/leverage.html index df8c3a045b..e92b9db67d 100644 --- a/zh-TW/v5/position/leverage.html +++ b/zh-TW/v5/position/leverage.html @@ -4,14 +4,14 @@ 設置槓桿 | Bybit API Documentation - +

    設置槓桿

    設置槓桿

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約
    經典帳戶覆蓋範圍: USDT永續 / 反向合約

    HTTP 請求​

    POST /v5/position/set-leverage

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear, inverse
    • 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
    symboltruestring合約名稱
    buyLeveragetruestring[1, 風險限額允許的最大槓桿數]
    • 單倉模式: 經典帳戶和統一帳戶的buyLeverage 必須等於sellLeverage
    • 雙倉模式:
      經典帳戶和統一帳戶(逐倉模式)buyLeverage可以與sellLeverage不想等;
      統一帳戶(全倉模式)的buyLeverage 必須等於sellLeverage
    sellLeveragetruestring[1, 風險限額允許的最大槓桿數]

    響應參數​

    無

    請求示例​

    POST /v5/position/set-leverage HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672281605082
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "BTCUSDT",
        "buyLeverage": "6",
        "sellLeverage": "6"

    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1672281607343
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/manual-add-margin.html b/zh-TW/v5/position/manual-add-margin.html index a40c551a59..65b5f50777 100644 --- a/zh-TW/v5/position/manual-add-margin.html +++ b/zh-TW/v5/position/manual-add-margin.html @@ -4,14 +4,14 @@ 手動增加或減少保證金 | Bybit API Documentation - +

    手動增加或減少保證金

    手動增加或減少保證金，僅適用於逐倉保證金模式

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約
    經典帳戶覆蓋範圍: USDT永續 / 反向合約

    HTTP 請求​

    POST /v5/position/add-margin

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear, inverse
    • 經典帳戶: linear, inverse
    symboltruestring合約名稱
    margintruestring增加或減少的保證金金額. 增加, 則為正數, 比如10; 減少, 則為負數, 比如-10. 最多支持4位小數
    positionIdxfalseinteger倉位標識，用於標識不同倉位, 雙向持倉模式下，該字段必傳
    • 0: 單向持倉模式
    • 1: 買側雙向持倉模式
    • 2: 賣側雙向持倉模式

    響應參數​

    參數類型說明
    categorystring產品類型
    symbolstring合約名称
    positionIdxinteger倉位標識符, 用于在不同仓位模式下标识仓位
    riskIdinteger风险限额ID，參見風險限額接口
    riskLimitValuestring當前風險限額ID對應的持倉限制量
    sizestring當前倉位的合约數量
    avgPricestring當前倉位的平均入場價格
    liqPricestring倉位強平價格
    bustPricestring倉位破產價格
    markPricestring最新標記價格
    positionValuestring仓位的價值
    leveragestring當前倉位的槓桿
    autoAddMargininteger是否自動追加保證金. 0: 否, 1: 是
    positionStatusString倉位状态. Normal, Liq, Adl
    positionIMstring倉位起始保證金
    positionMMstring倉位維持保證金
    takeProfitstring止盈價格
    stopLossstring止損價格
    trailingStopstring追蹤止損（與當前價格的距離）
    unrealisedPnlstring未结盈亏
    cumRealisedPnlstring累计已结盈亏
    createdTimestring倉位創建時間
    updatedTimestring倉位數據更新時間

    請求示例​

    POST /v5/position/add-margin HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1684234363665
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 97

    {
        "category": "inverse",
        "symbol": "ETHUSD",
        "margin": "0.01",
        "positionIdx": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "inverse",
            "symbol": "ETHUSD",
            "positionIdx": 0,
            "riskId": 11,
            "riskLimitValue": "500",
            "size": "200",
            "positionValue": "0.11033265",
            "avgPrice": "1812.70004844",
            "liqPrice": "1550.80",
            "bustPrice": "1544.20",
            "markPrice": "1812.90",
            "leverage": "12",
            "autoAddMargin": 0,
            "positionStatus": "Normal",
            "positionIM": "0.01926611",
            "positionMM": "0",
            "unrealisedPnl": "0.00001217",
            "cumRealisedPnl": "-0.04618929",
            "stopLoss": "0.00",
            "takeProfit": "0.00",
            "trailingStop": "0.00",
            "createdTime": "1672737740039",
            "updatedTime": "1684234363788"
        },
        "retExtInfo": {},
        "time": 1684234363789
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/move-position-history.html b/zh-TW/v5/position/move-position-history.html index df0897a029..d864cbecda 100644 --- a/zh-TW/v5/position/move-position-history.html +++ b/zh-TW/v5/position/move-position-history.html @@ -4,13 +4,13 @@ 查詢移倉歷史 | Bybit API Documentation - +

    查詢移倉歷史

    您可以通過使用母帳戶的api key查詢過去的移倉歷史紀錄

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 現貨 / 期權

    HTTP 請求​

    GET /v5/position/move-history

    請求參數​

    參數是否必需類型說明
    categoryfalsestring產品類型. linear, spot, option
    symbolfalsestring合約名稱/幣對名
    startTimefalsenumber創建訂單的開始時間戳 (毫秒), startTime和endTime的時間範圍是7天
    endTimefalsenumber創建訂單的結束時間戳 (毫秒), startTime和endTime的時間範圍是7天
    statusfalsestringOrder status. Processing, Filled, Rejected
    blockTradeIdfalsestring大宗交易訂單ID
    limitfalsestring每頁數量限制. [1, 200]. 默認: 20
    cursorfalsestring游標，用於翻頁. 請使用響應中的nextPageCursor的獲得下一頁

    響應參數​

    參數類型說明
    listarrayObject
    > blockTradeIdstring大宗交易ID
    > categorystring產品類型. linear, spot, option
    > orderIdstringBybit側的訂單ID
    > userIdinteger用戶ID
    > symbolstring合約名稱
    > sidestring從taker角度看的訂單方向. Buy, Sell
    > pricestring訂單價格
    > qtystring訂單數量
    > execFeestring成交費用
    > statusstring大宗交易訂單狀態. Processing, Filled, Rejected
    > execIdstring交易所側的成交ID
    > resultCodeinteger錯誤碼. 0表示成功
    > resultMessagestring錯誤信息. 當resultCode=0時, 則返回""
    > createdAtnumber訂單創建時間戳 (毫秒)
    > updatedAtnumber訂單更新時間戳 (毫秒)
    > rejectPartystring
    • ""表示初始校驗通過, 需要進一步通過查詢移倉歷史接口來確認最終狀態
    • Taker, Maker: 當status=Rejected返回
    • bybit表示處理過程中的錯誤發生在Bybit側
    nextPageCursorstring游標, 用於翻下一頁

    請求示例​

    GET /v5/position/move-history?limit=1&status=Filled HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1697523024244
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "blockTradeId": "1a82e5801af74b67b7ad71ba00a7391a",
                    "category": "option",
                    "orderId": "8e09c5b8-f651-4cec-968d-52764cac11ec",
                    "userId": 592324,
                    "symbol": "BTC-14OCT23-27000-C",
                    "side": "Buy",
                    "price": "6",
                    "qty": "0.99",
                    "execFee": "0",
                    "status": "Filled",
                    "execId": "677ad344-6bb4-4ace-baca-128fcffcaca7",
                    "resultCode": 0,
                    "resultMessage": "",
                    "createdAt": 1697186522865,
                    "updatedAt": 1697186523289,
                    "rejectParty": ""
                }
            ],
            "nextPageCursor": "page_token%3D1241742%26"
        },
        "retExtInfo": {},
        "time": 1697523024386
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/move-position.html b/zh-TW/v5/position/move-position.html index 9005a2a858..8522e87b0b 100644 --- a/zh-TW/v5/position/move-position.html +++ b/zh-TW/v5/position/move-position.html @@ -4,13 +4,13 @@ 移倉 | Bybit API Documentation - +

    移倉

    您可以在同一個母子帳戶體系下移動期貨、期權的倉位, 以及現貨的幣幣交易

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 現貨 / 期權

    信息
    • 該接口僅支持母帳戶的api key訪問
    • 移倉間的UID和調用者的UID必須是同一個母子帳戶體系
    • 該移倉生成的交易將不會出現在公有行情的成交中(包括Rest API和Websocket)
    • 該操作不會產生手續費
    • fromUid 和 toUid都必須是統一交易帳戶, 並且對於期貨而言, 倉位需要處於單向模式下
    • 請注意一旦成交, 查詢成交紀錄, 查詢平倉盈虧, 以及私有推送成交會返回execType=MovePosition的數據

    HTTP 請求​

    POST /v5/position/move-positions

    請求參數​

    參數是否必需類型說明
    fromUidtruestring原UID
    • 必須是統一交易帳戶
    • 期貨倉位必須有處於單向持倉模式
    toUidtruestring目標UID
    • 必須是統一交易帳戶
    • 期貨倉位必須有處於單向持倉模式
    listtruearrayObject. 單次請求最多支持25腿
    > categorytruestring產品類型. linear, spot, option
    > symboltruestring合約名稱/幣對名
    > pricetruestring訂單價格
    > sidetruestring是fromUid的交易方向
    • 例如, fromUid持有多倉, 如果選擇side=Sell, 則執行後, fromUid的多倉會被減倉或者開了空倉取決於qty的大小
    > qtytruestring交易數量

    響應參數​

    參數類型說明
    retCodeinteger響應碼. 0表示請求被成功接受
    retMsgstring響應信息
    resultmapObject
    > blockTradeIdstring大宗交易訂單ID
    > statusstring訂單狀態. Processing, Rejected
    > rejectPartystring
    • ""表示初始校驗通過, 需要進一步通過查詢移倉歷史接口來確認最終狀態
    • Taker, Maker: 當status=Rejected返回
    • bybit表示處理過程中的錯誤發生在Bybit側

    請求示例​

    POST /v5/position/move-positions HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1697447928051
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "fromUid": "100307601",
        "toUid": "592324",
        "list": [
            {
                "category": "spot",
                "symbol": "BTCUSDT",
                "price": "100",
                "side": "Sell",
                "qty": "0.01"
            }
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "blockTradeId": "e9bb926c95f54cf1ba3e315a58b8597b",
            "status": "Processing",
            "rejectParty": ""
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/position-mode.html b/zh-TW/v5/position/position-mode.html index 1b97819a3a..4b586c8873 100644 --- a/zh-TW/v5/position/position-mode.html +++ b/zh-TW/v5/position/position-mode.html @@ -4,14 +4,14 @@ 切換持倉模式 | Bybit API Documentation - +

    切換持倉模式

    該接口支持切換USDT永續和反向交割的持倉模式。如果處於單向持倉模式下，您只能要麼持有多頭要麼空頭倉位；如果處於雙向持倉模式下，您可以同時持倉多頭和空頭的倉位。

    統一帳戶覆蓋範圍: USDT永續 / 反向交割
    經典帳戶覆蓋範圍: USDT永續 / 反向交割

    提示
    • 配置生效優先級: symbol > coin > 系統默認
    • 系統默認: 單向持倉
    • 如果請求是按幣種（settleCoin），則所有基於該settleCoin的交易品種沒有持倉和活動單的將被批量切換，並且基於該settleCoin的新上市交易品種將與您設置的模式相同。

    示例​

    系統默認coinsymbol
    初始配置單向持倉未設置過未設置過
    生效結果所有USDT正向交易對都是單向持倉
    變更 1--BTCUSDT 設置為雙向持倉模式
    生效結果當前交易對BTCUSDT為雙向持倉，其他交易對都是單向持倉（繼承系統默認規則
    新上線交易對 ETHUSDT新上線的ETHUSDT為單向持倉 （繼承系統默認規則）
    變更 2-USDT 設置為雙向持倉-
    生效結果當前所有未持倉未有訂單的交易對都是雙向持倉，有持倉和有委託單的交易對不做調整
    新上線交易對 SOLUSDT新上線的SOLUSDT為雙向持倉 (繼承coin規則)
    變更 3--ASXUSDT 設置為單向持倉模式
    生效結果AXSUSDT為單向持倉模式，其餘交易對不做任何變更（繼承coin規則）
    新上線交易對 BITUSDT新上線的BITUSDT為雙向持倉 (繼承coin規則)

    當前合約單雙向持倉切換能力​

    經典帳戶統一帳戶
    USDT 永續支持單雙向持倉支持單雙向持倉
    USDC 永續僅支持單向持倉僅支持單向持倉
    反向永續僅支持單向持倉僅支持單向持倉
    反向交割支持單雙向持倉支持單雙向持倉

    HTTP 请求​

    POST /v5/position/switch-mode

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear: USDT永續; inverse: 反向交割
    • 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
    symbolfalsestring合約名稱. symbol和coin必須傳其中一個. symbol有更高優先級
    coinfalsestring結算幣種
    modetrueinteger倉位模式. 0: 單向持倉. 3: 雙向持倉

    響應參數​

    無

    請求示例​

    POST /v5/position/switch-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1675249072041
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 87

    {
        "category":"inverse",
        "symbol":"BTCUSDH23",
        "coin": null,
        "mode": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1675249072814
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/set-risk-limit.html b/zh-TW/v5/position/set-risk-limit.html index ea9815704b..0c24825d9c 100644 --- a/zh-TW/v5/position/set-risk-limit.html +++ b/zh-TW/v5/position/set-risk-limit.html @@ -4,13 +4,13 @@ 設置風險限額 | Bybit API Documentation - +

    設置風險限額

    由於Bybit在2024年3月12日上線了自動調整risk limit功能, 詳情請見這裡, 因此儘管接口能調通, 但是沒有任何意義

    HTTP 請求​

    POST /v5/position/set-risk-limit

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear, inverse
    • 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
    symboltruestring合約名稱
    riskIdtrueinteger風險限額Id
    positionIdxfalseinteger倉位標識，用於標識不同倉位, 雙向持倉模式下，該字段必傳
    • 0: 單向持倉模式
    • 1: 買側雙向持倉模式
    • 2: 賣側雙向持倉模式

    響應參數​

    參數類型說明
    categorystring產品類型
    riskIdinteger風險限額Id
    riskLimitValuestring風險限額Id對應的風險限額

    請求示例​

    POST /v5/position/set-risk-limit HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672282269774
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category": "linear",
        "symbol": "BTCUSDT",
        "riskId": 4,
        "positionIdx": null
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "riskId": 4,
            "riskLimitValue": "8000000",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1672282270571
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/tpsl-mode.html b/zh-TW/v5/position/tpsl-mode.html index e3710ffe48..6223a17fa6 100644 --- a/zh-TW/v5/position/tpsl-mode.html +++ b/zh-TW/v5/position/tpsl-mode.html @@ -4,7 +4,7 @@ 設置止盈止損模式 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    設置止盈止損模式

    提示

    某種程度上來說，該接口已經廢棄, 原因在於新版的止盈止損機制是基於訂單維度. 這個接口當初主要是用於倉位維度的止盈止損

    但是, 您仍然可以使用該接口, 為某個合約設置一個隱式的止盈止損模式, 因為當您在下單接口或者設置止盈止損接口時, 不傳入字段"tpslMode"時, 系統將會獲取一個默認值, 該 默認值實際上是源於是否調用過該接口做過修改, 不曾修改過的symbol, 都是默認Full

    可以將止盈止損模式設置為部分止盈止損或者全部止盈止損

    統一帳戶覆蓋範圍: USDT永續 / 反向合約
    經典帳戶覆蓋範圍: USDT永續 / 反向合約

    信息

    在部分止盈止損下，您可以設置小於倉位大小的止盈止損數量

    HTTP 請求​

    POST /v5/position/set-tpsl-mode

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear, inverse
    • 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
    symboltruestring合約名稱
    tpSlModetruestringTP/SL模式. Full,Partial

    響應參數​

    參數類型說明
    tpSlModestringFull,Partial

    請求示例​

    POST /v5/position/set-tpsl-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672279325035
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "symbol": "XRPUSDT",
        "category": "linear",
        "tpSlMode": "Full"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "tpSlMode": "Full"
        },
        "retExtInfo": {},
        "time": 1672279322666
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/position/trading-stop.html b/zh-TW/v5/position/trading-stop.html index f0e7c2bac8..3506780341 100644 --- a/zh-TW/v5/position/trading-stop.html +++ b/zh-TW/v5/position/trading-stop.html @@ -4,7 +4,7 @@ 設置止盈止損 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    設置止盈止損

    該接口可以設置止盈、止損和追蹤止損

    統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約
    經典帳戶覆蓋範圍: USDT永續 / 反向合約

    提示

    在提交請求後，系統內部將會自動創建對應類型的條件單。若倉位被平，系統將會調整相關條件訂單數量或者取消這些條件單。

    信息

    新版止盈止損, 支持既持有全部止盈止損單, 也可以持有部分止盈止損單

    • 全部倉位止盈止損單: 該接口可用於修改該類型的止盈止損單的參數
    • 部分倉位止盈止損單: 該接口僅能新增部分倉位止盈止損單
    備註

    新版止盈止損下, 調用該接口對持倉上的已有的止盈止損進行單邊止盈或者止損修改時, 會導致成對的tp/sl訂單失去綁定關係, 這意味著當通過tp/sl訂單ID調用 取消接口時, 只會取消對應訂單ID的單邊止盈或止損.

    HTTP 請求​

    POST /v5/position/trading-stop

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型
    • 統一帳戶: linear, inverse
    • 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
    symboltruestring合約名稱
    takeProfitfalsestring止盈價格. 等於0表示取消止盈，若不修改，則不要傳遞該參數
    stopLossfalsestring止損價格. 等於0表示取消止損，若不修改，則不要傳遞該參數
    trailingStopfalsestring追蹤止損, 僅支持按價差設置. 等於0表示取消追蹤止損，若不修改，則不要傳遞該參數
    tpTriggerByfalsestring止盈價格類型
    slTriggerByfalsestring止損價格類型
    activePricefalsestring追蹤止損激活價格. 追蹤止損會在到達該價格時觸發
    tpslModetruestring止盈止損模式. Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損
    tpSizefalsestring止盈倉位數量. 僅部分止盈止損時有效. 注意: tpSize和slSize的數值必須相等
    slSizefalsestring止損倉位數量. 僅部分止盈止損時有效. 注意: tpSize和slSize的數值必須相等
    tpLimitPricefalsestring觸發止盈後轉換為限價單的價格. 僅tpslMode=Partial且tpOrderType=Limit時有效
    slLimitPricefalsestring觸發止損後轉換為限價單的價格. 僅tpslMode=Partial且slOrderType=Limit時有效
    tpOrderTypefalsestring止盈觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持tpOrderType=Market
    slOrderTypefalsestring止損觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持slOrderType=Market
    positionIdxtrueinteger倉位標識，用戶識別倉位.
    • 0: 單向持倉
    • 1: 買側雙向持倉
    • 2: 賣側雙向持倉

    響應參數​

    無

    請求示例​

    POST /v5/position/trading-stop HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672283124270
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "category":"linear",
        "symbol": "XRPUSDT",
        "takeProfit": "0.6",
        "stopLoss": "0.2",
        "tpTriggerBy": "MarkPrice",
        "slTriggerBy": "IndexPrice",
        "tpslMode": "Partial",
        "tpOrderType": "Limit",
        "slOrderType": "Limit",
        "tpSize": "50",
        "tpLimitPrice": "0.57",
        "slLimitPrice": "0.21",
        "positionIdx": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1672283125359
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/pre-upgrade/close-pnl.html b/zh-TW/v5/pre-upgrade/close-pnl.html index 484095a376..b0f0e5a145 100644 --- a/zh-TW/v5/pre-upgrade/close-pnl.html +++ b/zh-TW/v5/pre-upgrade/close-pnl.html @@ -4,13 +4,13 @@ 查詢升級前平倉盈虧 | Bybit API Documentation - +

    查詢升級前平倉盈虧

    僅支持查詢升級到統一帳戶之前發生的USDT永續 / 反向合約, 返回結果按照updatedTime降序排列

    HTTP 請求​

    GET /v5/pre-upgrade/position/closed-pnl

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型 linear, inverse
    symboltruestring合約名稱
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    • 若只傳startTime，則查詢startTime和startTime+7天的數據
    • 若只傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 100]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > orderIdstring訂單Id
    > sidestring買賣方向 Buy, Side
    > qtystring訂單數量
    > orderPricestring訂單價格
    > orderTypestring訂單類型. Market,Limit
    > execTypestring執行類型. Trade, BustTrade, SessionSettlePnL, Settle
    > closedSizestring平倉數量
    > cumEntryValuestring被平倉位的累計入場價值
    > avgEntryPricestring平均入場價格
    > cumExitValuestring被平倉位的累計出場價值
    > avgExitPricestring平均出場價格
    > closedPnlstring被平倉位的盈虧
    > fillCountstring成交筆數
    > leveragestring持倉槓桿
    > createdTimestring創建時間 (毫秒)
    > updatedTimestring更新時間 (毫秒)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/pre-upgrade/position/closed-pnl?category=linear&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682580911998
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "orderId": "67836246-460e-4c52-a009-af0c3e1d12bc",
                    "side": "Sell",
                    "qty": "0.200",
                    "orderPrice": "27203.40",
                    "orderType": "Market",
                    "execType": "Trade",
                    "closedSize": "0.200",
                    "cumEntryValue": "5588.88",
                    "avgEntryPrice": "27944.40",
                    "cumExitValue": "5726.4252",
                    "avgExitPrice": "28632.13",
                    "closedPnl": "204.25510011",
                    "fillCount": "22",
                    "leverage": "10",
                    "createdTime": "1682487465732",
                    "updatedTime": "1682487465732"
                }
            ],
            "category": "linear",
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1682580912259
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/pre-upgrade/delivery.html b/zh-TW/v5/pre-upgrade/delivery.html index a1e975848f..cf1ab1257d 100644 --- a/zh-TW/v5/pre-upgrade/delivery.html +++ b/zh-TW/v5/pre-upgrade/delivery.html @@ -4,13 +4,13 @@ 查詢升級前期權交割紀錄 | Bybit API Documentation - +

    查詢升級前期權交割紀錄

    查詢升級到統一帳戶之前發生的期權的交割紀錄, 返回結果按照deliveryTime降序排列

    信息

    僅支持查詢最近6個月的數據, 對於更老的數據, 請前往網頁端下載

    HTTP 請求​

    GET /v5/pre-upgrade/asset/delivery-record

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. option
    symbolfalsestring合約名稱
    expDatefalsestring過期日. 格式示例: 25MAR22. 默認: 返回所有日期數據
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > deliveryTimenumber交割時間戳 (毫秒)
    > symbolstring合約名稱
    > sidestringBuy,Sell
    > positionstring交割數量
    > deliveryPricestring交割價格
    > strikestring行權價
    > feestring手續費，正數表支出，負數表收取
    > deliveryRplstring交割已實現盈虧
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/pre-upgrade/asset/delivery-record?category=option HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686809005774
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "21%3A0%2C21%3A0",
            "category": "option",
            "list": [
                {
                    "symbol": "ETH-14JUN23-1750-C",
                    "side": "Buy",
                    "deliveryTime": 1686729604507,
                    "strike": "1750",
                    "fee": "0",
                    "position": "0.5",
                    "deliveryPrice": "1740.25036667",
                    "deliveryRpl": "0.175"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686796328492
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/pre-upgrade/execution.html b/zh-TW/v5/pre-upgrade/execution.html index 01c4cd8a3f..fc34cd094a 100644 --- a/zh-TW/v5/pre-upgrade/execution.html +++ b/zh-TW/v5/pre-upgrade/execution.html @@ -4,13 +4,13 @@ 查詢升級前成交紀錄 | Bybit API Documentation - +

    查詢升級前成交紀錄

    目前，僅支持查詢升級到統一帳戶之前發生的USDT永續, USDC永續, 反向合約和期權, 返回結果按execTime降序排列

    提示
    • 儅execTime相同時,返回會有排序問題，此問題已在優化中, 目前建議依照execId+OrderId+leavesQty進行排序, 如果您想獲取實時成交信息建議使用websocket stream.
    • 單筆訂單可能會有多次成交.
    • 您可以通過指定symbol, baseCoin, orderId 和 orderLinkId字段來查詢。如果您使用多字段組合，系統的查詢優先級如下: orderId > orderLinkId > symbol > baseCoin.
    信息

    USDC永續和期權僅支持查詢最近6個月的數據, 對於更老的數據, 請前往網頁端下載

    HTTP 請求​

    GET v5/pre-upgrade/execution/list

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型 linear, inverse, option
    symbolfalsestring合約名稱
    orderIdfalsestring訂單ID
    orderLinkIdfalsestring用戶自定義訂單ID
    baseCoinfalsestring交易幣種. 僅期權使用
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    • 若只傳startTime，則查詢startTime和startTime+7天的數據
    • 若只傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    execTypefalsestring執行類型
    limitfalseinteger每頁數量限制. [1, 100]. 默認: 50
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > orderIdstring訂單Id
    > orderLinkIdstring用戶自定義訂單id
    > sidestring訂單方向.買： Buy,賣：Sell
    > orderPricestring訂單價格
    > orderQtystring訂單數量
    > leavesQtystring剩餘委託未成交數量
    > orderTypestring訂單類型. 市價單：Market,限價單：Limit
    > stopOrderTypestring条件单的订单类型。如果该订单不是条件单，则不会返回任何类型
    > execFeestring交易手續費
    > execIdstring成交Id
    > execPricestring成交價格
    > execQtystring成交數量
    > execTypestring交易類型
    > execValuestring成交價值
    > execTimestring成交時間（毫秒）
    > isMakerBool是否是 Maker 訂單,true 為 maker 訂單，false 為 taker 訂單
    > feeRatestring手續費率
    > tradeIvstring隱含波動率，僅期權有效
    > markIvstring標記價格的隱含波動率，僅期權有效
    > markPricestring成交執行時，該 symbol 當時的標記價格
    > indexPricestring成交執行時，該 symbol 當時的指數價格，目前僅對期權業務有效
    > underlyingPricestring成交執行時，該 symbol 當時的底層資產價格，僅期權有效
    > blockTradeIdstring大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID
    > closedSizestring平倉數量
    nextPageCursorstring游標，用於翻頁

    Request Example​

    GET /v5/pre-upgrade/execution/list?category=linear&limit=1&execType=Funding&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682580752432
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "symbol": "BTCUSDT",
                    "orderId": "1682553600-BTCUSDT-592334-Sell",
                    "orderLinkId": "",
                    "side": "Sell",
                    "orderPrice": "0.00",
                    "orderQty": "0.000",
                    "leavesQty": "0.000",
                    "orderType": "UNKNOWN",
                    "stopOrderType": "UNKNOWN",
                    "execFee": "0.6364003",
                    "execId": "11f1c4ed-ff20-4d73-acb7-96e43a917f25",
                    "execPrice": "28399.90",
                    "execQty": "0.011",
                    "execType": "Funding",
                    "execValue": "312.3989",
                    "execTime": "1682553600000",
                    "isMaker": false,
                    "feeRate": "0.00203714",
                    "tradeIv": "",
                    "markIv": "",
                    "markPrice": "28399.90",
                    "indexPrice": "",
                    "underlyingPrice": "",
                    "blockTradeId": "",
                    "closedSize": "0.000"
                }
            ],
            "nextPageCursor": "page_token%3D96184191%26",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1682580752717
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/pre-upgrade/order-list.html b/zh-TW/v5/pre-upgrade/order-list.html index e35fd09d89..8deaab7525 100644 --- a/zh-TW/v5/pre-upgrade/order-list.html +++ b/zh-TW/v5/pre-upgrade/order-list.html @@ -4,13 +4,13 @@ 查詢升級前訂單紀錄 | Bybit API Documentation - +

    查詢升級前訂單紀錄

    支持查詢升級到統一帳戶之前發生的USDT永續, USDC永續, 反向合約和期權

    信息
    • 7天內，可以查詢到全狀態的紀錄
    • 7天外，僅能查詢到已成交的紀錄
    • USDC永續和期權僅支持查詢最近6個月的數據, 對於更老的數據, 請前往網頁端下載

    HTTP 請求​

    GET /v5/pre-upgrade/order/history

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear, inverse, option
    symbolfalsestring合約名稱.
    • 對於linear, 如果不傳symbol, 默認返回數據是結算幣種=USDT
    • 要查詢USDC永續, 請傳遞對應的合約名稱
    baseCoinfalsestring交易幣種. 期權的預留字段
    orderIdfalsestring訂單ID
    orderLinkIdfalsestring用戶自定義訂單ID
    orderFilterfalsestringOrder: 普通單, StopOrder: 條件單
    orderStatusfalsestring訂單狀態. 不支持現貨
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > orderIdstring訂單Id
    > orderLinkIdstring用戶自定義Id
    > blockTradeIdstring大宗交易訂單Id
    > symbolstring合約名稱
    > pricestring訂單價格
    > qtystring訂單數量
    > sidestring方向. Buy,Sell
    > isLeveragestring該字段對升級前的帳戶訂單無意義
    > positionIdxinteger倉位標識。用戶不同倉位模式
    > orderStatusstring訂單狀態
    > cancelTypestring訂單被取消類型
    > rejectReasonstring拒絕原因
    > avgPricestring訂單平均成交價格. 若沒有成交，則返回"", 以及部分成交但最終被手動取消的訂單
    > leavesQtystring訂單剩餘未成交的數量
    > leavesValuestring訂單剩餘未成交的價值
    > cumExecQtystring訂單累計成交數量
    > cumExecValuestring訂單累計成交價值
    > cumExecFeestring訂單累計成交的手續費
    > timeInForcestring執行策略
    > orderTypestring訂單類型. Market,Limit
    > stopOrderTypestring條件單類型
    > orderIvstring隱含波動率
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > tpTriggerBystring觸發止盈的價格類型
    > slTriggerBystring觸發止損的價格類型
    > triggerDirectioninteger觸發方向. 1: 上漲, 2: 下跌
    > triggerBystring觸發價格的觸發類型
    > lastPriceOnCreatedstring下單時的市場價格
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?
    > placeTypestring下單類型, 僅期權使用. iv, price
    > smpTypestringSMP執行類型
    > smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    > smpOrderIdstring觸發此SMP執行的交易對手的 orderID
    > createdTimestring創建訂單的時間戳 (毫秒)
    > updatedTimestring訂單更新的時間戳 (毫秒)
    nextPageCursorstring游標，用於翻頁

    Request Example​

    GET /v5/pre-upgrade/order/history?category=linear&limit=1&orderStatus=Filled HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682576940304
    X-BAPI-RECV-WINDOW: 5000

    Response Example​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "orderId": "67836246-460e-4c52-a009-af0c3e1d12bc",
                    "orderLinkId": "",
                    "blockTradeId": "",
                    "symbol": "BTCUSDT",
                    "price": "27203.40",
                    "qty": "0.200",
                    "side": "Sell",
                    "isLeverage": "",
                    "positionIdx": 0,
                    "orderStatus": "Filled",
                    "cancelType": "UNKNOWN",
                    "rejectReason": "EC_NoError",
                    "avgPrice": "28632.126000",
                    "leavesQty": "0.000",
                    "leavesValue": "0",
                    "cumExecQty": "0.200",
                    "cumExecValue": "5726.4252",
                    "cumExecFee": "3.43585512",
                    "timeInForce": "IOC",
                    "orderType": "Market",
                    "stopOrderType": "UNKNOWN",
                    "orderIv": "",
                    "triggerPrice": "0.00",
                    "takeProfit": "0.00",
                    "stopLoss": "0.00",
                    "tpTriggerBy": "UNKNOWN",
                    "slTriggerBy": "UNKNOWN",
                    "triggerDirection": 0,
                    "triggerBy": "UNKNOWN",
                    "lastPriceOnCreated": "0.00",
                    "reduceOnly": true,
                    "closeOnTrigger": true,
                    "smpType": "None",
                    "smpGroup": 0,
                    "smpOrderId": "",
                    "createdTime": "1682487465732",
                    "updatedTime": "1682487465735",
                    "placeType": ""
                }
            ],
            "nextPageCursor": "page_token%3D69406%26",
            "category": "linear"
        },
        "retExtInfo": {},
        "time": 1682576940540
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/pre-upgrade/settlement.html b/zh-TW/v5/pre-upgrade/settlement.html index 3bdee857c1..e068a14bf6 100644 --- a/zh-TW/v5/pre-upgrade/settlement.html +++ b/zh-TW/v5/pre-upgrade/settlement.html @@ -4,13 +4,13 @@ 查詢升級前USDC結算紀錄 | Bybit API Documentation - +

    查詢升級前USDC結算紀錄

    查詢升級到統一帳戶之前發生的USDC永續的結算紀錄

    信息

    僅支持查詢最近6個月的數據, 對於更老的數據, 請前往網頁端下載

    HTTP 請求​

    GET /v5/pre-upgrade/asset/settlement-record

    請求參數​

    參數是否必需類型說明
    categorytruestring產品類型. linear
    symbolfalsestring合約名稱
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > sidestringBuy,Sell
    > sizestring倉位大小
    > sessionAvgPricestring結算價格
    > markPricestring標記價格
    > realisedPnlstring已實現盈虧
    > createdTimestring結算時間 (毫秒)
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/pre-upgrade/asset/settlement-record?category=linear&symbol=ETHPERP&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686809850982
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "25%3A0%2C25%3A0",
            "category": "linear",
            "list": [
                {
                    "realisedPnl": "45.76",
                    "symbol": "ETHPERP",
                    "side": "Sell",
                    "markPrice": "1668.44",
                    "size": "-0.5",
                    "createdTime": "1686787200000",
                    "sessionAvgPrice": "1668.41"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686809851749
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/pre-upgrade/transaction-log.html b/zh-TW/v5/pre-upgrade/transaction-log.html index 97ad5a9345..b071248ea0 100644 --- a/zh-TW/v5/pre-upgrade/transaction-log.html +++ b/zh-TW/v5/pre-upgrade/transaction-log.html @@ -4,13 +4,13 @@ 查詢升級前交易日誌 | Bybit API Documentation - +

    查詢升級前交易日誌

    查詢升級到統一帳戶之前USDC合約帳戶裡的交易日誌

    信息

    USDC永續和期權僅支持查詢最近6個月的數據, 對於更老的數據, 請前往網頁端下載

    HTTP 請求​

    GET /v5/pre-upgrade/account/transaction-log

    請求參數​

    參數是否必需類型說明
    categorytruestring交易產品類型. linear：USDC永續, option：期權
    baseCoinfalsestring交易幣種. 例如： BTCUSDT 的 baseCoin 是 BTC
    typefalsestring交易日誌的類型
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    • 若只傳startTime，則查詢startTime和startTime+7天的數據
    • 若只傳endTime，則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量, 最大50. 默認每頁20條
    cursorfalsestring游標，用於翻頁

    響應參數​

    參數類型說明
    listarrayObject
    > symbolstring合約名稱
    > categorystring產品類型
    > sidestring方向. Buy,Sell,None
    > transactionTimestring交易時間戳（毫秒）
    > typestring類型
    > qtystring數量
    > sizestring倉位
    > currencystringUSDC、USDT、BTC、ETH
    > tradePricestring交易價格
    > fundingstring資金費用. 正數表示用戶收取xx資金費，負數表示用戶支出xx資金費
    > feestring手續費，正數表示用戶付出xx手續費，負數表示返佣
    > cashFlowstring現金流
    > changestring變更
    > cashBalancestring餘額（當前幣種）
    > feeRatestring
    • 對於type=TRADE, 則表示交易手續費率
    • 對於type=SETTLEMENT, 則表示資金費率. 當side=Buy, feeRate=市場結算費率; 當side=Sell, feeRate=-市場結算費率
    > bonusChangestring體驗金的變化
    > tradeIdstring交易id
    > orderIdstring訂單id
    > orderLinkIdstring用戶自定義訂單id
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/pre-upgrade/account/transaction-log?category=option HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686808288265
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "21%3A0%2C21%3A0",
            "list": [
                {
                    "symbol": "ETH-14JUN23-1750-C",
                    "side": "Buy",
                    "funding": "",
                    "orderLinkId": "",
                    "orderId": "",
                    "fee": "0",
                    "change": "0",
                    "cashFlow": "0",
                    "transactionTime": "1686729604507",
                    "type": "DELIVERY",
                    "feeRate": "0",
                    "bonusChange": "",
                    "size": "0",
                    "qty": "0.5",
                    "cashBalance": "1001.1438885",
                    "currency": "USDC",
                    "category": "option",
                    "tradePrice": "1740.25036667",
                    "tradeId": ""
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686809006792
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/rate-limit.html b/zh-TW/v5/rate-limit.html index ff897ec539..e20605a9b6 100644 --- a/zh-TW/v5/rate-limit.html +++ b/zh-TW/v5/rate-limit.html @@ -4,7 +4,7 @@ 頻率限制 | Bybit API Documentation - + @@ -12,8 +12,8 @@

    頻率限制

    IP限頻​

    警告

    如果您收到HTTP 403（拒絕訪問）響應, 您的 IP 已被暫時或永久禁止。 您應立即查看以下指南，以確保您的應用程序不會繼續違反限制。如果您在 30 分鐘後 仍被禁止，則您可能會被永久禁止。

    我們不建議您在這些限制的邊緣運行您的應用程序，以防異常的網絡活動導致意外違規。

    • GET/POST 請求 (共享):
      • 連續 5 秒內每秒不超過 600 個請求
    備註

    所有到api.bybit.com或api.bytick.com的流量共享此限制，無論是訪問現貨、期貨還是期權。

    違反限制後，您的 IP 將被禁止一段時間（通常為 30 分鐘）。 持續違反限制將導致永久禁止。 我們不能撤銷永久禁令或縮短臨時禁令。

    賬戶頻率限製​

    警告

    如果您收到這樣的響應"ret_msg": "Too many visits!", 則表示您觸發了帳戶頻率限制, 請等到頻率限制重置以後, 再繼續發送請求。

    Bybit基於每秒鍾的滾動時間窗口來做頻率限製，並且是按賬戶（uid）來做劃分限製，每次請求API響應頭(response header)中都會包含如下字段：

    • X-Bapi-Limit-Status - 該接口當前時間窗口剩余可用請求數
    • X-Bapi-Limit - 該接口當前頻率限製上限
    • X-Bapi-Limit-Reset-Timestamp - 如果您已超過該接口當前窗口頻率限製，該字段表示下個可用時間窗口的時間戳（毫秒），即什麽時候可以恢復訪問；如果您未超過該接口當前窗口頻率限製，該字段表示返回的是當前服務器時間（毫秒).

    Http 響應頭示例

    ▶Response Headers
    Content-Type: application/json; charset=utf-8
    Content-Length: 141
    X-Bapi-Limit: 100
    X-Bapi-Limit-Status: 99
    X-Bapi-Limit-Reset-Timestamp: 1672738134824

    接口頻率限制表​

    交易​

    請求方式路徑經典帳戶是否可提頻
    inverselinearspot
    POST/v5/order/create10/s20/sY
    /v5/order/amend10/s10/sY
    /v5/order/cancel10/s20/sY
    /v5/order/cancel-all10/s20/sN
    GET/v5/order/realtime10/s20/sN
    /v5/order/history10/s20/sN
    /v5/execution/list10/s20/sN

    持倉​

    請求方式路徑經典帳戶是否可提頻
    inverselinearspot
    GET/v5/position/list10/s-N
    /v5/position/closed-pnl10/s-N
    POST/v5/position/set-leverage10/s-N

    帳戶​

    請求方式路徑頻率是否可提頻
    GET/v5/account/contract-transaction-log10/sN
    /v5/account/wallet-balanceaccountType=SPOT20/sN
    accountType=CONTRACT10/sN
    /v5/account/fee-ratecategory=linear10/sN
    category=spot5/sN
    category=option5/sN

    資產​

    請求方式路徑頻率是否可提頻
    GET/v5/asset/transfer/query-asset-info60 req/minN
    /v5/asset/transfer/query-transfer-coin-list60 req/minN
    /v5/asset/transfer/query-inter-transfer-list60 req/minN
    /v5/asset/transfer/query-sub-member-list60 req/minN
    /v5/asset/transfer/query-universal-transfer-list5 req/sN
    /v5/asset/transfer/query-account-coins-balance5 req/sN
    /v5/asset/deposit/query-record100 req/sN
    /v5/asset/deposit/query-sub-member-record300 req/sN
    /v5/asset/deposit/query-address300 req/sN
    /v5/asset/deposit/query-sub-member-address300 req/sN
    /v5/asset/withdraw/query-record300 req/minN
    /v5/asset/coin/query-info5 req/sN
    /v5/asset/exchange/order-record600 req/minN
    POST/v5/asset/transfer/inter-transfer60 req/minN
    /v5/asset/transfer/save-transfer-sub-member20 req/sN
    /v5/asset/transfer/universal-transfer5 req/sN
    /v5/asset/withdraw/create1 req/sN
    /v5/asset/withdraw/cancel60 req/minN

    用戶​

    請求方式路徑頻率是否可提頻
    POSTv5/user/create-sub-member5 req/sN
    /v5/user/create-sub-api5 req/sN
    /v5/user/frozen-sub-member5 req/sN
    /v5/user/update-api5 req/sN
    /v5/user/update-sub-api5 req/sN
    /v5/user/delete-api5 req/sN
    /v5/user/delete-sub-api5 req/sN
    GET/v5/user/query-sub-members10 req/sN
    /v5/user/query-api10 req/sN
    /v5/user/aff-customer-info10 req/sN

    槓桿代幣​

    請求方式路徑頻率是否可提頻
    GET/v5/spot-lever-token/order-record50 req/sN
    POST/v5/spot-lever-token/purchase20 req/sN
    POST/v5/spot-lever-token/redeem20 req/sN

    全倉槓桿 (統一帳戶)​

    目前，該目錄下的接口沒有頻率限制

    全倉槓桿 (經典帳戶)​

    請求方式路徑頻率是否可提頻
    GET/v5/spot-cross-margin-trade/loan-info50 req/sN
    GET/v5/spot-cross-margin-trade/account50 req/sN
    GET/v5/spot-cross-margin-trade/orders50 req/sN
    GET/v5/spot-cross-margin-trade/repay-history50 req/sN
    POST/v5/spot-cross-margin-trade/loan20 req/sN
    POST/v5/spot-cross-margin-trade/repay20 req/sN
    POST/v5/spot-cross-margin-trade/switch20 req/sN

    不同VIP/PRO等級的接口限頻規則​

    信息
    • 表格中的數值，代表對應等級的可申請上限，並不代表處於該等級的用戶實際默認自動享有對應的API Rate Limit
    • 經典帳戶不支持交易USDC衍生品
    批量接口特別說明

    批次訂單接口（包括創建、修改和取消）的速率限制不會與單一的下改撤請求共享。例如，單一下單接口頻率是100/秒, 批量下單接口是100/秒,，那麼當結合兩個接口一起下單時， 就擁有200單每秒的能力。

    僅category=linear或spot時​

    • 批量下單的接口，api rate limit：接口的頻次，還是統一沿用當前配置，但是計數消耗會根據實際的訂單數來消耗。（消耗數 = 請求數 * 請求中包含的訂單數），業務線配置相互獨立。

    • 批量接口允許1-10orders/request，例如，批量下單請求一次，包含5個orders，則本次請求limit數量消耗5。

    • 若1s內的最後一次請求的批量訂單，部分超限，則超過的部分會失敗（報錯超過上限），未超過的部分會成功。例如，這1s中，limit還剩5，但是此時下了一個包含8個orders的批量請求， -那麼前5個orders會下單成功，第6-8的orders，會報錯超過上限，下單失敗。

    經典帳戶UTA Pro
    等級\產品期貨期權現貨期貨期權現貨
    默認10/s10/s20/s10/s10/s20/s
    VIP 120/s20/s25/s20/s20/s25/s
    VIP 240/s40/s30/s40/s40/s30/s
    VIP 360/s60/s40/s60/s60/s40/s
    VIP 460/s60/s40/s60/s60/s40/s
    VIP 560/s60/s40/s60/s60/s40/s
    至尊VIP60/s60/s40/s60/s60/s40/s
    PRO1100/s100/s50/s150/s150/s150/s
    PRO2150/s150/s75/s200/s200/s200/s
    PRO3200/s200/s100/s250/s250/s250/s
    PRO4200/s200/s100/s300/s300/s300/s
    PRO5200/s200/s100/s300/s300/s300/s

    如何提高頻率限製​

    請聯繫您的客戶經理或者發送郵件到 institutional_services@bybit.com，我們會在 1-4 個工作日內答復。郵件內容必須包含以下內容：

    1. 您的姓名和公司名稱和簡介
    2. 您的bybit 賬號uid或註冊郵箱手機號,以及您要申請提頻的交易對
    3. 您上個月的交易量（吃單/掛單）並提供截圖
    4. 簡單介紹您的交易策略和為什麽需要更高限頻
    5. 如果可以，請提供您的成交記錄csv文檔
    - +那麼前5個orders會下單成功，第6-8的orders，會報錯超過上限，下單失敗。

    經典帳戶UTA Pro
    等級\產品期貨期權現貨期貨期權現貨
    默認10/s10/s20/s10/s10/s20/s
    VIP 120/s20/s25/s20/s20/s25/s
    VIP 240/s40/s30/s40/s40/s30/s
    VIP 360/s60/s40/s60/s60/s40/s
    VIP 460/s60/s40/s60/s60/s40/s
    VIP 560/s60/s40/s60/s60/s40/s
    至尊VIP60/s60/s40/s60/s60/s40/s
    PRO1100/s100/s50/s150/s150/s150/s
    PRO2150/s150/s75/s200/s200/s200/s
    PRO3200/s200/s100/s250/s250/s250/s
    PRO4200/s200/s100/s300/s300/s300/s
    PRO5200/s200/s100/s300/s300/s300/s
    PRO6200/s200/s100/s300/s300/s300/s

    如何提高頻率限製​

    請聯繫您的客戶經理或者發送郵件到 institutional_services@bybit.com，我們會在 1-4 個工作日內答復。郵件內容必須包含以下內容：

    1. 您的姓名和公司名稱和簡介
    2. 您的bybit 賬號uid或註冊郵箱手機號,以及您要申請提頻的交易對
    3. 您上個月的交易量（吃單/掛單）並提供截圖
    4. 簡單介紹您的交易策略和為什麽需要更高限頻
    5. 如果可以，請提供您的成交記錄csv文檔
    + \ No newline at end of file diff --git a/zh-TW/v5/smp.html b/zh-TW/v5/smp.html index 7f37b85546..33ae8aaab3 100644 --- a/zh-TW/v5/smp.html +++ b/zh-TW/v5/smp.html @@ -4,7 +4,7 @@ 自成交攔截 | Bybit API Documentation - + @@ -13,7 +13,7 @@ 基於這點，我們強烈建議在SMP交易群組發生變更時，最好取消所有現有訂單，以避免意外執行。

    1. SMP交易群組在SMP執行中具有較高優先級，當任何一方沒有群組時，UID才會生效。

    2. 一旦訂單進入訂單簿，其 smp 標誌就不再重要。系統始終遵循後一個訂單的smp標籤。

    示例：
    1月1日：UID1加入SMP交易群組A，並下訂單1；
    1月2日：UID1被從SMP交易群組A中移除，但訂單1仍然處於活躍狀態且為“新”狀態。

    • 情況1：如果UID1加入了SMP交易群組B並下了訂單2，如果訂單2與訂單1相符，它將被執行，因為它們屬於兩個不同的群組。
    • 情況2：如果UID1在被從SMP交易群組A中移除後沒有加入任何其他群組並下了訂單2，如果訂單2與訂單1相符，SMP將被觸發，因為UID1在下訂單2時沒有群組，所以SMP在UID級別（同一個UID1）被觸發。

    如何管理我的UID及SMP交易群組?​

    您可以聯繫您的機構業務經理或通過電子郵件聯繫Bybit，電子郵件地址為: institutional_services@bybit.com

    支持的OpenAPI版本和產品線​

    產品線支持的OpenAPI版本說明
    現貨V3 (經典帳戶)
    V5 (統一帳戶&經典帳戶)
    合約合約V3 (經典帳戶): USDT永續 / 反向永續&交割
    V5 (統一帳戶): USDT永續 / 反向永續&交割 / USDC永續 & 交割
    V5 (經典帳戶): USDT永續 / 反向永續 & 交割
    期權V5 (統一帳戶)V1有基於UID維度的SMP功能
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/account-info.html b/zh-TW/v5/spot-margin-normal/account-info.html index 4320f11dc8..c689199b94 100644 --- a/zh-TW/v5/spot-margin-normal/account-info.html +++ b/zh-TW/v5/spot-margin-normal/account-info.html @@ -4,13 +4,13 @@ 查詢借貸帳戶信息 | Bybit API Documentation - +

    查詢借貸帳戶信息

    覆蓋範圍: 全倉槓桿 (經典帳戶)

    HTTP 請求​

    GET /v5/spot-cross-margin-trade/account

    請求參數​

    無

    響應參數​

    參數類型說明
    acctBalanceSumstring總資產 (折算成BTC)
    debtBalanceSumstring總負債 (折算成BTC)
    loanAccountListarrayObject
    > freestring可用餘額
    > intereststring未還利息
    > loanstring未還本金
    > remainAmountstring總未還金額 = 未還利息 + 未還本金
    > lockedstring鎖定金額
    > tokenIdstring幣種
    > totalstring合計
    riskRatestring風險率
    statusinteger借貸帳戶狀態
    • 1: 正常
    • 2: 限制提幣/劃轉
    • 3: 預警
    • 4: 已爆倉
    switchStatusinteger全倉槓桿狀態 0: 關閉, 1: 開啟

    請求示例​

    GET /v5/spot-cross-margin-trade/account HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751305868
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "acctBalanceSum": "0.455189592150138021",
            "debtBalanceSum": "0",
            "loanAccountList": [
                {
                    "free": "0.01444",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "BTC",
                    "total": "0.01444"
                },
                {
                    "free": "0.21147048",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "ETH",
                    "total": "0.21147048"
                },
                {
                    "free": "7963.58978991849",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "USDT",
                    "total": "7963.58978991849"
                },
                {
                    "free": "1380.28832",
                    "interest": "0",
                    "loan": "0",
                    "locked": "0",
                    "remainAmount": "0",
                    "tokenId": "USDC",
                    "total": "1380.28832"
                }
            ],
            "riskRate": "0",
            "status": 1,
            "switchStatus": 1
        },
        "retExtInfo": {},
        "time": 1677751306287
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/borrow-order.html b/zh-TW/v5/spot-margin-normal/borrow-order.html index e4133d4737..31c4f2ce51 100644 --- a/zh-TW/v5/spot-margin-normal/borrow-order.html +++ b/zh-TW/v5/spot-margin-normal/borrow-order.html @@ -4,13 +4,13 @@ 查詢借貸訂單 | Bybit API Documentation - +

    查詢借貸訂單

    覆蓋範圍: 全倉槓桿 (經典帳戶)

    HTTP 請求​

    GET /v5/spot-cross-margin-trade/orders

    請求參數​

    參數是否必需類型說明
    startTimefalselong開始時間戳 (毫秒)
    endTimefalselong結束時間戳 (毫秒)
    coinfalsestring幣種名稱
    statusfalseinteger訂單狀態
    • 0(默認)：查詢所有狀態
    • 1：查詢未還清
    • 2：查詢已還清
    limitfalseinteger每頁數量限制. [1, 500]. 默認: 500

    響應參數​

    參數類型說明
    listarrayObject
    > accountIdstring帳戶ID
    > coinstring幣種名稱
    > createdTimenumber借貸訂單創建時間戳 (毫秒)
    > idstring借貸交易ID
    > interestAmountstring總利息
    > interestBalancestring未還利息
    > loanAmountstring借貸金額
    > loanBalancestring未還本金
    > remainAmountstring未還金額總和=未還利息+未還本金
    > statusinteger訂單狀態 1：未還清, 2：已還清
    > typeinteger訂單類型 1: 手動借貸, 2: 自動借貸

    請求示例​

    GET /v5/spot-cross-margin-trade/orders?coin=ETH&limit=1&status=2 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677754328650
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "accountId": "592335",
                    "coin": "ETH",
                    "createdTime": 1677751839000,
                    "id": "21005",
                    "interestAmount": "0.0001",
                    "interestBalance": "0",
                    "loanAmount": "10",
                    "loanBalance": "0",
                    "remainAmount": "0",
                    "status": 2,
                    "type": 1
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677754329096
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/borrow.html b/zh-TW/v5/spot-margin-normal/borrow.html index 31cd62f74b..bbd7bf81a5 100644 --- a/zh-TW/v5/spot-margin-normal/borrow.html +++ b/zh-TW/v5/spot-margin-normal/borrow.html @@ -4,13 +4,13 @@ 借款 | Bybit API Documentation - +

    借款

    覆蓋範圍: 全倉槓桿 (經典帳戶)

    HTTP 請求​

    POST /v5/spot-cross-margin-trade/loan

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱
    qtytruestring借貸金額

    響應參數​

    參數類型說明
    transactIdstring借款交易ID

    請求示例​

    POST /v5/spot-cross-margin-trade/loan HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751838628
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 38

    {
        "coin": "ETH",
        "qty": "10"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "transactId": "21005"
        },
        "retExtInfo": {},
        "time": 1677751839688
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/borrowable-data.html b/zh-TW/v5/spot-margin-normal/borrowable-data.html index a642722caa..e604740741 100644 --- a/zh-TW/v5/spot-margin-normal/borrowable-data.html +++ b/zh-TW/v5/spot-margin-normal/borrowable-data.html @@ -4,13 +4,13 @@ 查詢可借幣種精度 | Bybit API Documentation - +

    查詢可借幣種精度

    信息

    不需要鑒權

    HTTP 請求​

    GET /v5/spot-cross-margin-trade/borrow-token

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種名稱

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring幣種名稱
    > borrowingPrecisioninteger借款精度
    > repaymentPrecisioninteger還款精度

    請求示例​

    GET /v5/spot-cross-margin-trade/borrow-token?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "borrowingPrecision": 5,
                    "coin": "ETH",
                    "repaymentPrecision": 4
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677750685331
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/interest-quota.html b/zh-TW/v5/spot-margin-normal/interest-quota.html index 3348247ac9..24ac738d16 100644 --- a/zh-TW/v5/spot-margin-normal/interest-quota.html +++ b/zh-TW/v5/spot-margin-normal/interest-quota.html @@ -4,13 +4,13 @@ 查詢利率及額度 | Bybit API Documentation - +

    查詢利率及額度

    覆蓋範圍: 全倉槓桿 (經典帳戶)

    HTTP 請求​

    GET /v5/spot-cross-margin-trade/loan-info

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱

    響應參數​

    參數類型說明
    coinstring幣種名稱
    interestRatestring基礎日利率
    loanAbleAmountstring預估可借最大金額
    maxLoanAmountstring平台設置的用戶最大可借金額

    請求示例​

    GET /v5/spot-cross-margin-trade/loan-info?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677750928871
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "coin": "ETH",
            "interestRate": "0.000054835",
            "loanAbleAmount": "19.220442066850037795",
            "maxLoanAmount": "300"
        },
        "retExtInfo": {},
        "time": 1677750929290
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/margin-data.html b/zh-TW/v5/spot-margin-normal/margin-data.html index 423253e429..f2194e3712 100644 --- a/zh-TW/v5/spot-margin-normal/margin-data.html +++ b/zh-TW/v5/spot-margin-normal/margin-data.html @@ -4,13 +4,13 @@ 查詢保證金幣種信息 | Bybit API Documentation - +

    查詢保證金幣種信息

    信息

    不需要鑒權

    HTTP 請求​

    GET /v5/spot-cross-margin-trade/pledge-token

    請求參數​

    參數是否必需類型說明
    coinfalsestring幣種名稱

    響應參數​

    參數類型說明
    listarrayObject
    > coinstring幣種名稱
    > conversionRatestring折算率, 返回為實際數值
    > liquidationOrderinteger強平順序

    請求示例​

    GET /v5/spot-cross-margin-trade/pledge-token?coin=ETH HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "coin": "ETH",
                    "conversionRate": "0.95",
                    "liquidationOrder": 2
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677750397414
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/repay-order.html b/zh-TW/v5/spot-margin-normal/repay-order.html index e5ff0a51a3..43c2877224 100644 --- a/zh-TW/v5/spot-margin-normal/repay-order.html +++ b/zh-TW/v5/spot-margin-normal/repay-order.html @@ -4,13 +4,13 @@ 查詢還款訂單信息 | Bybit API Documentation - +

    查詢還款訂單信息

    覆蓋範圍: 全倉槓桿 (經典帳戶)

    HTTP 請求​

    GET /v5/spot-cross-margin-trade/repay-history

    請求參數​

    參數是否必需類型說明
    startTimefalselong開始時間戳 (毫秒)
    endTimefalselong結束時間戳 (毫秒)
    coinfalsestring幣種信息
    limitfalseinteger每頁數量限制. [1, 500], 默認: 500

    響應參數​

    參數類型說明
    listarrayObject
    > accountIdstring帳戶ID
    > coinstring幣種信息
    > repaidAmountstring還款金額
    > repayIdstring還款交易ID
    > repayMarginOrderIdstring還款單號
    > repayTimestring還款交易時間戳 (毫秒)
    > transactIdsarrayObject
    >> repaidIntereststring該筆還款訂單的利息還款金額
    >> repaidPrincipalstring該筆還款訂單的本金還款金額
    >> repaidSerialNumberstring借貸訂單的還款單號
    >> transactIdstring原始借貸交易ID

    請求示例​

    GET /v5/spot-cross-margin-trade/repay-history?coin=ETH&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1677755884678
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "list": [
                {
                    "accountId": "592335",
                    "coin": "ETH",
                    "repaidAmount": "10.0001",
                    "repayId": "19070",
                    "repayMarginOrderId": "1367476828218072576",
                    "repayTime": "1677751941000",
                    "transactIds": [
                        {
                            "repaidAmount": "10.0001",
                            "repaidInterest": "0.0001",
                            "repaidPrincipal": "10",
                            "repaidSerialNumber": "1367475973544746496",
                            "transactId": "21005"
                        }
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1677755885169
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/repay.html b/zh-TW/v5/spot-margin-normal/repay.html index 3d343b102e..b7dd20e0a6 100644 --- a/zh-TW/v5/spot-margin-normal/repay.html +++ b/zh-TW/v5/spot-margin-normal/repay.html @@ -4,13 +4,13 @@ 還款 | Bybit API Documentation - +

    還款

    覆蓋範圍: 全倉槓桿 (經典帳戶)

    HTTP 請求​

    POST /v5/spot-cross-margin-trade/repay

    請求參數​

    參數是否必需類型說明
    cointruestring幣種名稱
    qtyfalsestring還款金額
    • 當completeRepayment=0時, qty必傳
    • 當completeRepayment=1時, qty無效
    completeRepaymentfalseinteger是否一鍵全部還款. 0(默認): 否, 1: 是

    響應參數​

    參數類型說明
    repayIdstring還款交易ID

    請求示例​

    POST /v5/spot-cross-margin-trade/repay HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677751944347
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 66

    {
        "coin": "ETH",
        "qty": null,
        "completeRepayment": 1
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "repayId": "19070"
        },
        "retExtInfo": {},
        "time": 1677751941219
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/switch-mode.html b/zh-TW/v5/spot-margin-normal/switch-mode.html index 8e3a50b118..6f4219b407 100644 --- a/zh-TW/v5/spot-margin-normal/switch-mode.html +++ b/zh-TW/v5/spot-margin-normal/switch-mode.html @@ -4,13 +4,13 @@ 全倉槓桿開關 | Bybit API Documentation - +

    全倉槓桿開關

    開啟或關閉全倉槓桿交易

    覆蓋範圍: 全倉槓桿 (經典帳戶)

    HTTP 請求​

    POST /v5/spot-cross-margin-trade/switch

    請求參數​

    參數是否必需類型說明
    switchtrueinteger1: 開啟, 0: 關閉

    響應參數​

    參數類型說明
    switchStatusinteger槓桿交易狀態. 1: 開啟, 0: 關閉

    請求示例​

    POST /v5/spot-cross-margin-trade/switch HTTP/1.1
    Host: api-testnet.bybit.com
    Content-Type: application/json
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1677747804512
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Length: 19

    {
        "switch": 0
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "switchStatus": 0
        },
        "retExtInfo": {},
        "time": 1677747804974
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-normal/vip-margin.html b/zh-TW/v5/spot-margin-normal/vip-margin.html index b91df55250..3db45ec182 100644 --- a/zh-TW/v5/spot-margin-normal/vip-margin.html +++ b/zh-TW/v5/spot-margin-normal/vip-margin.html @@ -4,13 +4,13 @@ 查詢不同VIP的槓桿數據 | Bybit API Documentation - +

    查詢不同VIP的槓桿數據

    查詢經典帳戶下不同VIP等級的槓桿數據

    信息

    不需要鑒權

    HTTP 請求​

    GET /v5/spot-cross-margin-trade/data

    請求參數​

    參數是否必需類型說明
    vipLevelfalsestringVIP 等級
    currencyfalsestring幣種名稱

    響應參數​

    參數類型說明
    vipCoinListarrayObject
    > listarrayObject
    >> borrowableboolean幣種是否支持借貸
    >> collateralRatiostring抵押率
    >> currencystring幣種名稱
    >> hourlyBorrowRatestring每小時借貸利率
    >> liquidationOrderstring強平順序
    >> marginCollateralboolean幣種是否支持作為保證金
    >> maxBorrowingAmountstring最大借貸額度
    > vipLevelstringVIP 等級

    請求示例​

    GET /v5/spot-cross-margin-trade/data?vipLevel=No VIP&currency=BTC HTTP/1.1
    Host: api.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "vipCoinList": [
                {
                    "list": [
                        {
                            "borrowable": true,
                            "collateralRatio": "0.95",
                            "currency": "BTC",
                            "hourlyBorrowRate": "0.000003964522",
                            "liquidationOrder": "2",
                            "marginCollateral": true,
                            "maxBorrowingAmount": "5"
                        }
                    ],
                    "vipLevel": "No VIP"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1692071381663
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-uta/historical-interest.html b/zh-TW/v5/spot-margin-uta/historical-interest.html index b20bdcbb47..b887c0edc8 100644 --- a/zh-TW/v5/spot-margin-uta/historical-interest.html +++ b/zh-TW/v5/spot-margin-uta/historical-interest.html @@ -4,13 +4,13 @@ 查詢借貸歷史利率 | Bybit API Documentation - +

    查詢借貸歷史利率

    您可以查詢最多過去6個月的借貸利率數據

    信息
    • 需要鑒權, API密鑰需要有"現貨"權限
    • 僅支持統一帳戶訪問
    • 返回的是公共數據, i.e., 不同用戶在查詢相同的vip等級時, 拿到的是相同的歷史利率

    HTTP 請求​

    GET /v5/spot-margin-trade/interest-rate-history

    請求參數​

    參數是否必需類型說明
    currencytruestring幣種名稱, 必須大寫
    vipLevelfalsestringVIP等級
  • 請注意對於"No VIP", 需要傳入"No%20VIP"
  • 若不傳, 則返回匹配您帳戶等級的數據
    • startTimefalseinteger開始時間戳 (毫秒)
  • 兩個時間參數要麼都傳要麼都不傳
  • 當都不傳時, 默認返回過去7天的數據
  • 當都傳時, 最多支持30天的時間跨度
    • endTimefalseinteger結束時間戳 (毫秒)

    響應參數​

    參數類型說明
    listarray<object>
    > timestamplong時間
    > currencystring幣種名稱
    > hourlyBorrowRatestring每小時利率
    > vipLevelstringVIP等級

    請求示例​

    GET /v5/spot-margin-trade/interest-rate-history?currency=USDC&vipLevel=No%20VIP&startTime=1721458800000&endTime=1721469600000 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1721891663064
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "list": [
                {
                    "timestamp": 1721469600000,
                    "currency": "USDC",
                    "hourlyBorrowRate": "0.000014621596",
                    "vipLevel": "No VIP"
                },
                {
                    "timestamp": 1721466000000,
                    "currency": "USDC",
                    "hourlyBorrowRate": "0.000014621596",
                    "vipLevel": "No VIP"
                },
                {
                    "timestamp": 1721462400000,
                    "currency": "USDC",
                    "hourlyBorrowRate": "0.000014621596",
                    "vipLevel": "No VIP"
                },
                {
                    "timestamp": 1721458800000,
                    "currency": "USDC",
                    "hourlyBorrowRate": "0.000014621596",
                    "vipLevel": "No VIP"
                }
            ]
        },
        "retExtInfo": "{}",
        "time": 1721899048991
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-uta/set-leverage.html b/zh-TW/v5/spot-margin-uta/set-leverage.html index add6bfc8c0..9bebffea10 100644 --- a/zh-TW/v5/spot-margin-uta/set-leverage.html +++ b/zh-TW/v5/spot-margin-uta/set-leverage.html @@ -4,13 +4,13 @@ 全倉槓桿設置 | Bybit API Documentation - +

    全倉槓桿設置

    全倉槓桿設置用戶最大槓桿倍數

    覆蓋範圍: 全倉槓桿 (統一帳戶)

    警告

    需要先開啟全倉槓桿，才能調整槓桿。

    HTTP 請求​

    POST /v5/spot-margin-trade/set-leverage

    請求參數​

    參數是否必需類型說明
    leveragetruestring槓桿倍數 (整數), 支持區間 [2, 10]

    響應參數​

    無

    請求示例​

    POST /v5/spot-margin-trade/set-leverage HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672299806626
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "leverage": "4"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1672710944282
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-uta/status.html b/zh-TW/v5/spot-margin-uta/status.html index fbd09d1211..7f49fc12ad 100644 --- a/zh-TW/v5/spot-margin-uta/status.html +++ b/zh-TW/v5/spot-margin-uta/status.html @@ -4,13 +4,13 @@ 查詢開關狀態和倍數 | Bybit API Documentation - +

    查詢開關狀態和倍數

    查詢統一帳戶下槓桿交易的開關狀態和槓桿倍數

    覆蓋範圍: 全倉槓桿 (統一帳戶)

    HTTP 請求​

    GET /v5/spot-margin-trade/state

    請求參數​

    無

    響應參數​

    參數類型說明
    spotLeveragestring槓桿倍數. 如果處於關閉狀態的話, 則返回 ""
    spotMarginModestring開關狀態. 1: 開啟, 0: 關閉
    effectiveLeveragestring實際借貸槓桿倍數。 精度保留2位小數，向下截取

    請求示例​

    GET /v5/spot-margin-trade/state HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1692696840996
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "spotLeverage": "10",
            "spotMarginMode": "1",
            "effectiveLeverage": "1"
        },
        "retExtInfo": {},
        "time": 1692696841231
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-uta/switch-mode.html b/zh-TW/v5/spot-margin-uta/switch-mode.html index 109ff60e5c..e1ada31150 100644 --- a/zh-TW/v5/spot-margin-uta/switch-mode.html +++ b/zh-TW/v5/spot-margin-uta/switch-mode.html @@ -4,13 +4,13 @@ 全倉槓桿開關 | Bybit API Documentation - +

    全倉槓桿開關

    全倉槓桿開關

    覆蓋範圍: 全倉槓桿 (統一帳戶)

    警告

    您的帳戶需要先開啟全倉槓桿

    HTTP 請求​

    POST /v5/spot-margin-trade/switch-mode

    請求參數​

    參數是否必需類型說明
    spotMarginModetruestring1: 開啟，0: 關閉

    響應參數​

    參數類型說明
    spotMarginModestring全倉槓桿狀態（1: 開啟，0: 關閉）

    請求示例​

    POST /v5/spot-margin-trade/switch-mode HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672297794480
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "spotMarginMode": "0"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "spotMarginMode": "0"
        },
        "retExtInfo": {},
        "time": 1672297795542
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/spot-margin-uta/vip-margin.html b/zh-TW/v5/spot-margin-uta/vip-margin.html index 3ebbf43e01..933bb9a5e9 100644 --- a/zh-TW/v5/spot-margin-uta/vip-margin.html +++ b/zh-TW/v5/spot-margin-uta/vip-margin.html @@ -4,13 +4,13 @@ 查詢不同VIP的槓桿數據 | Bybit API Documentation - +

    查詢不同VIP的槓桿數據

    查詢統一帳戶下不同VIP等級的槓桿數據

    信息

    不需要鑒權

    HTTP 請求​

    GET /v5/spot-margin-trade/data

    請求參數​

    參數是否必需類型說明
    vipLevelfalsestringVIP 等級
    currencyfalsestring幣種名稱

    響應參數​

    參數類型說明
    vipCoinListarrayObject
    > listarrayObject
    >> borrowableboolean幣種是否支持借貸
    >> collateralRatiostring抵押率
    >> currencystring幣種名稱
    >> hourlyBorrowRatestring每小時借貸利率
    >> liquidationOrderstring強平順序
    >> marginCollateralboolean幣種是否支持作為保證金
    >> maxBorrowingAmountstring最大借貸額度
    > vipLevelstringVIP 等級

    請求示例​

    GET /v5/spot-margin-trade/data?vipLevel=No VIP&currency=BTC HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    {
        "retCode": 0,
        "retMsg": "success",
        "result": {
            "vipCoinList": [
                {
                    "list": [
                        {
                            "borrowable": true,
                            "collateralRatio": "0.95",
                            "currency": "BTC",
                            "hourlyBorrowRate": "0.0000015020640000",
                            "liquidationOrder": "11",
                            "marginCollateral": true,
                            "maxBorrowingAmount": "3"
                        }
                    ],
                    "vipLevel": "No VIP"
                }
            ]
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/affiliate-info.html b/zh-TW/v5/user/affiliate-info.html index ae762e7135..0bc7185506 100644 --- a/zh-TW/v5/user/affiliate-info.html +++ b/zh-TW/v5/user/affiliate-info.html @@ -4,14 +4,14 @@ 查詢代理用戶信息 | Bybit API Documentation - +

    查詢代理用戶信息

    要使用此接口，您应该有一个代理商账户，并且在创建 API 密钥时仅勾选“代理商”权限。
    代理商网站: https://affiliates.bybit.com

    提示
    • 僅支持使用母帳戶uid
    • 若要查詢該接口, api key僅能擁有代理商權限, 若擁有任何其他權限想, 請移除
    • 交易量和入金金額為用戶在Bybit上的總量，與結傭無關，任何結傭相關的交易量數據，以Affiliate Portal為準。

    HTTP 請求​

    GET /v5/user/aff-customer-info

    請求參數​

    參數是否必須類型說明
    uidtruestring被代理用戶的母帳戶uid

    返回參數​

    參數類型說明
    uidstring帳戶uid
    vipLevelstringVIP等級
    takerVol30Daystring過去30天的吃單交易量. 單位: USDT. 所有下方交易量相關的字段, 包含了期貨、期權和現貨的交易量
    makerVol30Daystring過去30天的掛單交易量. 單位: USDT
    tradeVol30Daystring過去30天的總交易量. 單位: USDT
    depositAmount30Daystring過去30天的入金金額. 單位: USDT
    takerVol365Daystring過去一年的吃單交易量. 單位: USDT
    makerVol365Daystring過去一年的掛單交易量. 單位: USDT
    tradeVol365Daystring過去一年的總交易量. 單位: USDT
    depositAmount365Daystring過去一年的總入金金額. 單位: USDT
    totalWalletBalancestring資產餘額區間
    • 1: 少於100 USDT的價值
    • 2: 100(含) ~ 250 USDT的價值
    • 3: 250(含) ~ 500 USDT的價值
    • 4: 大於 500USDT的價值
    depositUpdateTimestring入金數據更新時間. UTC時間
    volUpdateTimestring交易量數據更新時間. UTC時間
    KycLevelintegerKYC等級. 0, 1, 2

    請求示例​

    GET /v5/user/aff-customer-info?uid=1513500 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: uQ61dcX0lSe7ygD2EA
    X-BAPI-TIMESTAMP: 1685596324209
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: xxxxxx
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "uid": "1513500",
            "takerVol30Day": "10",
            "makerVol30Day": "20",
            "tradeVol30Day": "30",
            "depositAmount30Day": "90",
            "takerVol365Day": "100",
            "makerVol365Day": "500",
            "tradeVol365Day": "600",
            "depositAmount365Day": "1300",
            "totalWalletBalance": "4",
            "depositUpdateTime": "2023-06-01 05:12:04",
            "vipLevel": "99",
            "volUpdateTime": "2023-06-02 00:00:00",
            "KycLevel": 1
        },
        "retExtInfo": {},
        "time": 1685596324508
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/apikey-info.html b/zh-TW/v5/user/apikey-info.html index 09a4a5884d..fe4c954537 100644 --- a/zh-TW/v5/user/apikey-info.html +++ b/zh-TW/v5/user/apikey-info.html @@ -4,13 +4,13 @@ 查詢API Key相關信息 | Bybit API Documentation - +

    查詢API Key相關信息

    獲取API key的相關信息。使用待查詢的api key調用接口。適用於母、子帳戶的api key。

    提示

    任意權限可以訪問該接口

    HTTP 請求​

    GET /v5/user/query-api

    請求參數​

    無

    返回參數​

    參數類型說明
    idstring唯一id. 內部使用
    notestring備註
    apiKeystringApi key
    readOnlyinteger0：可讀可寫. 1：只讀
    secretstring總是""
    permissionsObject權限類型
    > ContractTradearray合約交易的權限 Order, Position
    > Spotarray現貨交易的權限 SpotTrade
    > Walletarray錢包的權限 AccountTransfer, SubMemberTransfer(母帳戶), SubMemberTransferList(子帳戶), Withdraw(母帳戶)
    > OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易 OptionsTrade
    > Derivativesarray
  • 統一交易帳戶的默認勾選權限
  • 經典帳戶總是[]
    • > CopyTradingarray總是[], 因為帶單帳戶現在只需要通過ContractTrade權限項來進行API帶單
    > BlockTradearray大宗交易的權限. 子帳戶暫不支持，總是[]
    > Exchangearray兌換的權限 ExchangeHistory
    > NFTarrayNFT的權限 NFTQueryProductList. 子帳戶暫不支持, 總是[]
    > Affiliatearray代理商權限. 僅代理商可以擁有此權限, 否則總是[]
    ipsarray綁定的IP
    typeintegerApi key類型. 1：個人使用, 2：綁定到第三方應用
    deadlineDayintegerAPI key失效的倒數日. 針對那些未綁定IP的api key或者修改過密碼的帳戶
    expiredAtdatetimeAPI key的過期日. 針對那些未綁定IP的api key或者修改過密碼的帳戶
    createdAtdatetimeAPI key的創建日
    unifiedinteger該字段已廢棄
    utaintegerAPI Key所屬的帳戶是否為統一交易帳戶. 0：經典帳戶; 1：統一交易账户
    userIDinteger用戶 ID
    inviterIDinteger邀請人 ID（邀請該賬號加入平台的賬號的UID）
    vipLevelstringVIP用戶等級
    mktMakerLevelstringmarket maker等級
    affiliateIDinteger代理商Id. 0: 表示無任何代理綁定關係
    rsaPublicKeystringRSA公鑰
    isMasterboolean是否為主帳戶下的api key
    parentUidstring主帳戶uid. 如果是主帳戶本身調用, 則返回"0"
    kycLevelstring個人帳戶的kyc等級. LEVEL_DEFAULT, LEVEL_1， LEVEL_2
    kycRegionstring個人帳戶的kyc地區

    請求示例​

    GET /v5/user/query-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676430842094
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "id": "13770661",
            "note": "readwrite api key",
            "apiKey": "XXXXXX",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [],
                "NFT": [],
                "Affiliate": []
            },
            "ips": [
                "*"
            ],
            "type": 1,
            "deadlineDay": 66,
            "expiredAt": "2023-12-22T07:20:25Z",
            "createdAt": "2022-10-16T02:24:40Z",
            "unified": 0,
            "uta": 0,
            "userID": 24617703,
            "inviterID": 0,
            "vipLevel": "No VIP",
            "mktMakerLevel": "0",
            "affiliateID": 0,
            "rsaPublicKey": "",
            "isMaster": true,
            "parentUid": "0",
            "kycLevel": "LEVEL_DEFAULT",
            "kycRegion": ""
        },
        "retExtInfo": {},
        "time": 1697525990798
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/create-subuid-apikey.html b/zh-TW/v5/user/create-subuid-apikey.html index ad5611fa57..72e17773ee 100644 --- a/zh-TW/v5/user/create-subuid-apikey.html +++ b/zh-TW/v5/user/create-subuid-apikey.html @@ -4,13 +4,13 @@ 新建子帳戶的API Key | Bybit API Documentation - +

    新建子帳戶的API Key

    給新建好的子帳戶創建新的API key。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /v5/user/create-sub-api

    請求參數​

    參數是否必須類型說明
    subuidtrueinteger子帳戶userId
    notefalsestring設置備註
    readOnlytrueinteger0：可讀可寫. 1：只讀
    ipsfalsestring綁定IP. 比如: "192.168.0.1,192.168.0.2"注意:
    • 不傳參數ips 或者入参值為"*"意味著不綁定
    • 不綁定IP的api key將有90天的有效期限
    • 一旦帳戶密碼做了修改，帳戶下的非永久api key將在7天後失效
    permissionstrueObject勾選api key權限.
    • 注意: 必須傳入以下權限類型的任意一種, 否則報錯
    > ContractTradefalsearray合約. ["Order","Position"]
    > Spotfalsearray現貨. ["SpotTrade"]
    > Walletfalsearray錢包. ["AccountTransfer","SubMemberTransferList"]
    > OptionsfalsearrayUSDC合約. ["OptionsTrade"]
    > Derivativesfalsearray統一帳戶權限. 該字段失效, 因為系統將會自動根據您的帳戶類型(經典帳戶和統一帳戶)來決定是否增加該權限
    > Exchangefalsearray兌換. ["ExchangeHistory"]
    > CopyTradingfalsearray跟單交易. ["CopyTrading"]

    返回參數​

    參數類型說明
    idstring唯一id. 內部使用
    notestring備註
    apiKeystringApi key
    readOnlyinteger0：可讀可寫. 1：只讀
    secretstringApi密鑰密碼.
    • 注意: Api密鑰密碼只會在這裡出現一次，除此之外沒有任何地方還可以獲取到密碼。請妥善保存。
    permissionsObject權限類型
    > ContractTradearray合約交易的權限
    > Spotarray現貨交易的權限
    > Walletarray錢包的權限
    > OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易
    > Derivativesarray統一帳戶權限
    > CopyTradingarray跟單交易的權限
    > BlockTradearray大宗交易的權限. 子帳戶暫不支持，總是[]
    > Exchangearray兌換的權限
    > NFTarrayNFT的權限. 子帳戶暫不支持, 總是[]

    請求示例​

    POST /v5/user/create-sub-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430005459
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "subuid": 53888000,
        "note": "testxxx",
        "readOnly": 0,
        "permissions": {
            "Wallet": [
                "AccountTransfer"
            ]
        }
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "id": "16651283",
            "note": "testxxx",
            "apiKey": "xxxxx",
            "readOnly": 0,
            "secret": "xxxxxxxx",
            "permissions": {
                "ContractTrade": [],
                "Spot": [],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [],
                "Derivatives": [],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [],
                "NFT": []
            }
        },
        "retExtInfo": {},
        "time": 1676430007643
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/create-subuid.html b/zh-TW/v5/user/create-subuid.html index ae8ff61f14..4fde29578d 100644 --- a/zh-TW/v5/user/create-subuid.html +++ b/zh-TW/v5/user/create-subuid.html @@ -4,13 +4,13 @@ 新建子帳戶 | Bybit API Documentation - +

    新建子帳戶

    創建新的子帳戶。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /v5/user/create-sub-member

    請求參數​

    參數是否必須類型說明
    usernametruestring給新的子帳戶創建一個用戶名。
    • 6-16位字符，須同時含有數字和字母。
    • 不能與已存在或已刪除的帳戶用戶名重複。
    passwordfalsestring給新的子帳戶設置一個密碼。
    • 8-30位字符，須同時含有數字和大小寫字母。
    memberTypetrueinteger1: 普通子帳戶, 6: 託管子帳戶
    switchfalseinteger
    • 0: 關閉快捷登陸 (默認關閉)
    • 1: 打開快捷登陸.
    isUtafalseboolean
    • true: 創建統一帳戶
    • false(默認): 創建經典帳戶
    notefalsestring設置備註

    返回參數​

    參數類型說明
    uidstring子帳戶userId
    usernamestring給新的子帳戶創建一個用戶名
    • 6-16位字符，須同時含有數字和字母。
    • 不能與已存在或已刪除的帳戶用戶名重複。
    memberTypeinteger1: 普通子帳戶, 6: 託管子帳戶
    statusinteger帳戶狀態
    • 1: 正常
    • 2: 登陸封禁
    • 4: 凍結
    remarkstring設置的備註

    請求示例​

    POST /v5/user/create-sub-member HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXXX
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1676429344202
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "username": "xxxxx",
        "memberType": 1,
        "switch": 1,
        "note": "test"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "uid": "53888000",
            "username": "xxxxx",
            "memberType": 1,
            "status": 1,
            "remark": "test"
        },
        "retExtInfo": {},
        "time": 1676429344734
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/froze-subuid.html b/zh-TW/v5/user/froze-subuid.html index d82c12a0f2..3e4aa77448 100644 --- a/zh-TW/v5/user/froze-subuid.html +++ b/zh-TW/v5/user/froze-subuid.html @@ -4,13 +4,13 @@ 凍結/解凍子帳戶 | Bybit API Documentation - +

    凍結/解凍子帳戶

    凍結或解凍子帳戶。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /v5/user/frozen-sub-member

    請求參數​

    參數是否必須類型說明
    subuidtrueinteger子帳戶userId
    frozentrueinteger0：解凍, 1：凍結

    返回參數​

    無

    請求示例​

    POST /v5/user/frozen-sub-member HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430842094
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "subuid": 53888001,
        "frozen": 1
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1676430697553
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/list-sub-apikeys.html b/zh-TW/v5/user/list-sub-apikeys.html index c399f233b2..3b59d7c6d7 100644 --- a/zh-TW/v5/user/list-sub-apikeys.html +++ b/zh-TW/v5/user/list-sub-apikeys.html @@ -4,13 +4,13 @@ 查詢子帳戶的所有API Key信息 | Bybit API Documentation - +

    查詢子帳戶的所有API Key信息

    查詢某個子帳戶下所有的api key

    提示
    • 任意權限可以訪問該接口
    • 僅支持母帳戶調用

    HTTP 請求​

    GET /v5/user/sub-apikeys

    請求參數​

    參數是否必須類型說明
    subMemberIdtruestring子帳戶UID
    limitfalseinteger每頁數量限制. [1, 20]. 默認: 20
    cursorfalsestring游標，用於翻頁

    返回參數​

    參數類型說明
    resultarrayObject
    > idstring唯一id. 內部使用
    > ipsarray<string>綁定的IP, 未綁定IP則是*
    > apiKeystringApi key
    > notestring備註
    > statusinteger當前狀態 1: 永久, 2: 已過期, 3: 仍在有效期內, 4: 即將過期 (少於7天)
    > expiredAtdatetimeAPI key的過期日. 針對那些未綁定IP的api key或者修改過密碼的帳戶
    > createdAtdatetimeAPI key的創建日
    > typeintegerApi key類型. 1：個人使用, 2：綁定到第三方應用
    > permissionsObject權限類型
    >> ContractTradearray合約交易的權限 Order, Position
    >> Spotarray現貨交易的權限 SpotTrade
    >> Walletarray錢包的權限 AccountTransfer, SubMemberTransferList
    >> OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易 OptionsTrade
    >> Derivativesarray統一交易帳戶默認賦予的權限
    >> CopyTradingarray總是[], 因為帶單帳戶只需要使用ContractTrade權限來進行API帶單
    >> BlockTradearray大宗交易的權限. 子帳戶暫不支持，總是[]
    >> Exchangearray兌換的權限 ExchangeHistory
    >> NFTarrayNFT的權限. 子帳戶暫不支持, 總是[]
    >> Affiliatearray代理商權限. 子帳戶暫不支持, 總是 []
    > secretstring總是"******"
    > readOnlybooleantrue：可讀可寫. false：只讀
    > deadlineDayintegerAPI key失效的倒數日. 針對那些未綁定IP的api key或者修改過密碼的帳戶
    > flagstringAPI Key的類型
    nextPageCursorstring游標，用於翻頁

    請求示例​

    GET /v5/user/sub-apikeys?subMemberId=100400345 HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1699515251088
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "result": [
                {
                    "id": "24828209",
                    "ips": [
                        "*"
                    ],
                    "apiKey": "XXXXXX",
                    "note": "UTA",
                    "status": 3,
                    "expiredAt": "2023-12-01T02:36:06Z",
                    "createdAt": "2023-08-25T06:42:39Z",
                    "type": 1,
                    "permissions": {
                        "ContractTrade": [
                            "Order",
                            "Position"
                        ],
                        "Spot": [
                            "SpotTrade"
                        ],
                        "Wallet": [
                            "AccountTransfer",
                            "SubMemberTransferList"
                        ],
                        "Options": [
                            "OptionsTrade"
                        ],
                        "Derivatives": [
                            "DerivativesTrade"
                        ],
                        "CopyTrading": [],
                        "BlockTrade": [],
                        "Exchange": [
                            "ExchangeHistory"
                        ],
                        "NFT": [],
                        "Affiliate": []
                    },
                    "secret": "******",
                    "readOnly": false,
                    "deadlineDay": 21,
                    "flag": "hmac"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1699515251698
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/modify-master-apikey.html b/zh-TW/v5/user/modify-master-apikey.html index ff4784b801..facceaa893 100644 --- a/zh-TW/v5/user/modify-master-apikey.html +++ b/zh-TW/v5/user/modify-master-apikey.html @@ -4,13 +4,13 @@ 修改母帳戶的API Key設置 | Bybit API Documentation - +

    修改母帳戶的API Key設置

    修改母帳戶API key的設置。使用待修改的api key調用接口。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"
    信息

    只能修改調用該接口的api key

    HTTP 請求​

    POST /v5/user/update-api

    請求參數​

    參數是否必須類型說明
    readOnlyfalseinteger0 (默認)：可讀可寫. 1：只讀
    ipsfalsestring綁定IP. 比如: "192.168.0.1,192.168.0.2"注意:
    • 不傳參數ips 或者入参值為"*"意味著不綁定
    • 不綁定IP的api key將有90天的有效期限
    • 一旦帳戶密碼做了修改，帳戶下的非永久api key將在7天後失效
    permissionsfalseObject勾選api key權限. 如果不修改權限, 則不要傳入該參數
    > ContractTradefalsearray合約. ["Order","Position"]
    > Spotfalsearray現貨. ["SpotTrade"]
    > Walletfalsearray錢包. ["AccountTransfer","SubMemberTransfer"]
    > OptionsfalsearrayUSDC合約. ["OptionsTrade"]
    > Derivativesfalsearray統一帳戶權限. 該字段失效, 因為系統將會自動根據您的帳戶類型(經典帳戶和統一帳戶)來決定是否增加該權限
    > CopyTradingfalsearray跟單交易. ["CopyTrading"]
    > BlockTradefalsearray大宗商品交易. ["BlockTrade"]
    > Exchangefalsearray兌換. ["ExchangeHistory"]
    > NFTfalsearrayNFT. ["NFTQueryProductList"]
    > Affiliatefalsearray代理商查詢權限. ["Affiliate"]
    • 該權限僅作用於代理商
    • 如果您需要該權限, 請確保移除所有其他權限項

    返回參數​

    參數類型說明
    idstring唯一id. 內部使用
    notestring備註
    apiKeystringApi key
    readOnlyinteger0：可讀可寫. 1：只讀
    secretstring總是 ""
    permissionsObject權限類型
    > ContractTradearray合約交易的權限
    > Spotarray現貨交易的權限
    > Walletarray錢包的權限
    > OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易
    > Derivativesarray統一帳戶權限
    > CopyTradingarray跟單交易的權限
    > BlockTradearray大宗交易的權限
    > Exchangearray兌換的權限
    > NFTarrayNFT的權限
    ipsarray綁定的IP

    請求示例​

    POST /v5/user/update-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676431264739
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json

    {
        "readOnly": null,
        "ips": "*",
        "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": [],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": [
                    "NFTQueryProductList"
                ]
            }
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "id": "13770661",
            "note": "xxxxx",
            "apiKey": "xxxxx",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [
                    "Order",
                    "Position"
                ],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer",
                    "SubMemberTransfer"
                ],
                "Options": [
                    "OptionsTrade"
                ],
                "Derivatives": [
                    "DerivativesTrade"
                ],
                "CopyTrading": [
                    "CopyTrading"
                ],
                "BlockTrade": [],
                "Exchange": [
                    "ExchangeHistory"
                ],
                "NFT": [
                    "NFTQueryProductList"
                ]
            },
            "ips": [
                "*"
            ]
        },
        "retExtInfo": {},
        "time": 1676431265427
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/modify-sub-apikey.html b/zh-TW/v5/user/modify-sub-apikey.html index f52304e5e5..29e2f7a16c 100644 --- a/zh-TW/v5/user/modify-sub-apikey.html +++ b/zh-TW/v5/user/modify-sub-apikey.html @@ -4,13 +4,13 @@ 修改子帳戶的API Key設置 | Bybit API Documentation - +

    修改子帳戶的API Key設置

    修改子帳戶API key的設置, 支持母帳戶管理子帳戶key的設置, 或者子帳戶key直接修改本身。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 子API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）"
    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /v5/user/update-sub-api

    請求參數​

    參數是否必須類型說明
    apikeyfalsestring子帳戶的api key
    • 當您要使用母帳戶來管理子帳戶的key時, 該字段必傳
    • 如果您是用對應的子帳戶api key修改本身, 該字段請不要傳入, 否則報錯
    readOnlyfalseinteger0 (默認)：可讀可寫. 1：只讀
    ipsfalsestring綁定IP. 比如: "192.168.0.1,192.168.0.2"注意:
    • 不傳參數ips 或者入参值為"*"意味著不綁定
    • 不綁定IP的api key將有90天的有效期限
    • 一旦帳戶密碼做了修改，帳戶下的非永久api key將在7天後失效
    permissionsfalseObject勾選api key權限. 如果不修改權限, 則不要傳入該參數
    > ContractTradefalsearray合約. ["Order","Position"]
    > Spotfalsearray現貨. ["SpotTrade"]
    > Walletfalsearray錢包. ["AccountTransfer","SubMemberTransferList"]
    > OptionsfalsearrayUSDC合約. ["OptionsTrade"]
    > Derivativesfalsearray統一帳戶權限. 該字段失效, 因為系統將會自動根據您的帳戶類型(經典帳戶和統一帳戶)來決定是否增加該權限
    > Exchangefalsearray兌換. ["ExchangeHistory"]
    > CopyTradingfalsearray跟單交易. ["CopyTrading"]

    返回參數​

    參數類型說明
    idstring唯一id. 內部使用
    notestring備註
    apiKeystringapi key
    readOnlyinteger0：可讀可寫. 1：只讀
    secretstring總是 ""
    permissionsObject權限類型
    > ContractTradearray合約交易的權限e
    > Spotarray現貨交易的權限
    > Walletarray錢包的權限
    > OptionsarrayUSDC合約的權限. 該權限支持USDC合約下的期權和永續交易
    > Derivativesarray統一帳戶權限
    > CopyTradingarray跟單交易的權限
    > BlockTradearray大宗交易的權限. 子帳戶暫不支持，總是[]
    > Exchangearray兌換的權限
    > NFTarrayNFT的權限. 子帳戶暫不支持, 總是[]
    ipsarrayIP綁定

    請求示例​

    POST /v5/user/update-sub-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676431795752
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "readOnly": 0,
        "ips": "*",
        "permissions": {
                "ContractTrade": [],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [],
                "NFT": []
            }
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "id": "16651472",
            "note": "testxxx",
            "apiKey": "xxxxxx",
            "readOnly": 0,
            "secret": "",
            "permissions": {
                "ContractTrade": [],
                "Spot": [
                    "SpotTrade"
                ],
                "Wallet": [
                    "AccountTransfer"
                ],
                "Options": [],
                "Derivatives": [],
                "CopyTrading": [],
                "BlockTrade": [],
                "Exchange": [],
                "NFT": []
            },
            "ips": [
                "*"
            ]
        },
        "retExtInfo": {},
        "time": 1676431796263
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/page-subuid.html b/zh-TW/v5/user/page-subuid.html index 7c489b1c6c..97a04d81b5 100644 --- a/zh-TW/v5/user/page-subuid.html +++ b/zh-TW/v5/user/page-subuid.html @@ -4,13 +4,13 @@ 查詢子帳戶UID列表 (無限制) | Bybit API Documentation - +

    查詢子帳戶UID列表 (無限制)

    通過翻頁獲取當前母帳戶下所有的子帳戶列表，適合超過擁有1萬個子帳戶的母帳戶進行調用。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    GET /v5/user/submembers

    請求參數​

    參數是否必須類型說明
    pageSizefalsestring數據頁大小. 每次至多返回100條
    nextCursorfalsestring游標. 傳入響應中的nextCursor來獲取下一頁的數據

    返回參數​

    參數類型說明
    subMembersarrayObject
    > uidstring子帳戶userId
    > usernamestring用戶名
    > memberTypeinteger1: 普通子帳戶, 6: 託管子帳戶
    > statusinteger帳戶狀態.
    • 1: 正常
    • 2: 登陸封禁
    • 4: 凍結
    > accountModeinteger帳戶模式.
    • 1: 經典帳戶
    • 3: UTA帳戶
    > remarkstring備註
    nextCursorstring下一頁數據的游標. 返回"0"表示沒有更多的數據了

    請求示例​

    GET /v5/user/submembers?pageSize=1 HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430318405
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "subMembers": [
                {
                    "uid": "100475023",
                    "username": "BybitmcYERjAPmMU",
                    "memberType": 1,
                    "status": 1,
                    "remark": "",
                    "accountMode": 1
                }
            ],
            "nextCursor": "126671"
        },
        "retExtInfo": {},
        "time": 1711695552772
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/rm-master-apikey.html b/zh-TW/v5/user/rm-master-apikey.html index 1f0c069c5a..996b30ebf4 100644 --- a/zh-TW/v5/user/rm-master-apikey.html +++ b/zh-TW/v5/user/rm-master-apikey.html @@ -4,13 +4,13 @@ 刪除母帳戶的API Key | Bybit API Documentation - +

    刪除母帳戶的API Key

    刪除母帳戶下的api key。使用待刪除的api key調用接口。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"
    危險

    當心! 用於調用本接口的API KEY將會立馬失效。

    HTTP 請求​

    POST /v5/user/delete-api

    請求參數​

    無

    返回參數​

    無

    請求示例​

    POST /v5/user/delete-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676431576621
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json

    {

    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1676431577675
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/rm-sub-apikey.html b/zh-TW/v5/user/rm-sub-apikey.html index 230076b65b..db854e1fd9 100644 --- a/zh-TW/v5/user/rm-sub-apikey.html +++ b/zh-TW/v5/user/rm-sub-apikey.html @@ -4,13 +4,13 @@ 刪除子帳戶下的API Key | Bybit API Documentation - +

    刪除子帳戶下的API Key

    刪除子帳戶下的api key。使用待刪除的子帳戶api key調用接口或者使用母帳戶調用刪除指定api key

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 子API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）"
    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"
    危險

    當心! 用於調用本接口後, 對應的子帳戶api key會立馬失效。

    HTTP 請求​

    POST /v5/user/delete-sub-api

    請求參數​

    參數是否必須類型說明
    apikeyfalsestring子帳戶的api key
    • 當您要使用母帳戶來管理子帳戶的key時, 該字段必傳
    • 如果您是用對應的子帳戶api key修改本身, 該字段請不要傳入, 否則報錯

    返回參數​

    無

    請求示例​

    POST /v5/user/delete-sub-api HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1676431922953
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json

    {

    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {},
        "retExtInfo": {},
        "time": 1676431924719
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/rm-subuid.html b/zh-TW/v5/user/rm-subuid.html index 74b11fc330..feae775379 100644 --- a/zh-TW/v5/user/rm-subuid.html +++ b/zh-TW/v5/user/rm-subuid.html @@ -4,14 +4,14 @@ 刪除子帳戶 | Bybit API Documentation - +

    刪除子帳戶

    刪除子帳戶. 在刪除前, 確保該帳戶已經沒有資產了
    僅可使用母帳戶api key調用.

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    POST /v5/user/del-submember

    請求參數​

    參數是否必須類型說明
    subMemberIdtruestringSub UID

    返回參數​

    無

    請求示例​

    POST /v5/user/del-submember HTTP/1.1
    Host: api.bybit.com
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1698907012755
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX
    Content-Type: application/json
    Content-Length: 34

    {
        "subMemberId": "112725187"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {},
        "retExtInfo": {},
        "time": 1698907012962
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/subuid-list.html b/zh-TW/v5/user/subuid-list.html index 6f8f67e9b4..f10e7506c1 100644 --- a/zh-TW/v5/user/subuid-list.html +++ b/zh-TW/v5/user/subuid-list.html @@ -4,13 +4,13 @@ 查詢子帳戶UID列表 (限制) | Bybit API Documentation - +

    查詢子帳戶UID列表 (限制)

    最多返回10000個子帳戶, 適合少於1萬個子帳戶的母帳戶調用。需使用母帳戶的API key。

    提示

    在調用接口時，使用的API key至少需要擁有以下其中一種權限

    • 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

    HTTP 請求​

    GET /v5/user/query-sub-members

    請求參數​

    無

    返回參數​

    參數類型說明
    subMembersarrayObject
    > uidstring子帳戶userId
    > usernamestring用戶名
    > memberTypeinteger1: 普通子帳戶, 6: 託管子帳戶
    > statusinteger帳戶狀態.
    • 1: 正常
    • 2: 登陸封禁
    • 4: 凍結
    > accountModeinteger帳戶模式.
    • 1: 經典帳戶
    • 2: UMA帳戶
    • 3: UTA帳戶
    > remarkstring備註

    請求示例​

    GET /v5/user/query-sub-members HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1676430318405
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "subMembers": [
                {
                    "uid": "53888001",
                    "username": "xxx001",
                    "memberType": 1,
                    "status": 1,
                    "remark": "test",
                    "accountMode": 1
                },
                {
                    "uid": "53888002",
                    "username": "xxx002",
                    "memberType": 6,
                    "status": 1,
                    "remark": "",
                    "accountMode": 3
                }
            ]
        },
        "retExtInfo": {},
        "time": 1676430319452
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/user/wallet-type.html b/zh-TW/v5/user/wallet-type.html index e1fb028bd1..f3e5d48c6b 100644 --- a/zh-TW/v5/user/wallet-type.html +++ b/zh-TW/v5/user/wallet-type.html @@ -4,13 +4,13 @@ 查詢帳戶支持的錢包類型 | Bybit API Documentation - +

    查詢帳戶支持的錢包類型

    查詢母帳戶或者子帳戶下支持的錢包類型

    提示
    • 使用母帳戶api key: 您可以查詢到母帳戶以及指定的子帳戶的錢包類型, 子帳戶的uid最多單次可查詢200個.
    • 使用子帳戶api key: 僅能查詢自身的錢包類型
    最佳實踐

    "FUND" - 這個資金錢包, 如果您從未存入或者轉入過資金, 該接口返回的數組裡將不會呈現該枚舉值, 但實際上您的帳戶總是擁有該錢包.

    • ["SPOT","OPTION","FUND","CONTRACT"] : 經典帳戶並且資金錢包曾經操作過
    • ["SPOT","OPTION","CONTRACT"] : 經典帳戶並且資金錢包不曾操作過
    • ["SPOT","UNIFIED","FUND","CONTRACT"] : UMA帳戶並且資金錢包曾經操作過. (等強制或主動升級到UTA後, 就沒有UMA帳戶的概念了)
    • ["SPOT","UNIFIED","CONTRACT"] : UMA帳戶並且資金錢包不曾操作過. (等強制或主動升級到UTA後, 就沒有UMA帳戶的概念了)
    • ["UNIFIED""FUND","CONTRACT"] : UTA帳戶並且資金錢包曾經操作過
    • ["UNIFIED","CONTRACT"] : UTA帳戶並且資金錢包不曾操作過

    HTTP 請求​

    GET /v5/user/get-member-type

    請求參數​

    參數是否必須類型說明
    memberIdsfalsestring
    • 不入参時, 僅查詢自身
    • 當使用母帳戶api key查詢子uid時, 母帳戶的數據總是返回且在數組的第一個
    • 支持輸入多個子uid, 用逗號隔開, 單次查詢最多支持200個
    • 子帳戶api key查詢時, 該入参將會被忽略

    返回參數​

    參數類型說明
    accountsarrayObject
    > uidstring母/子 uid
    > accountTypearraySPOT, CONTRACT, FUND, OPTION, UNIFIED. 請查閱上面的最佳實踐來理解返回的值

    請求示例​

    GET /v5/user/get-member-type HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1686884973961
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    響應示例​

    {
        "retCode": 0,
        "retMsg": "",
        "result": {
            "accounts": [
                {
                    "uid": "24617703",
                    "accountType": [
                        "SPOT",
                        "OPTION",
                        "FUND",
                        "CONTRACT"
                    ]
                }
            ]
        },
        "retExtInfo": {},
        "time": 1686895670002
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/private/dcp.html b/zh-TW/v5/websocket/private/dcp.html index b4ac20d57c..142912a39e 100644 --- a/zh-TW/v5/websocket/private/dcp.html +++ b/zh-TW/v5/websocket/private/dcp.html @@ -4,13 +4,13 @@ 斷線保護 (期權) | Bybit API Documentation - +

    斷線保護 (期權)

    通過訂閱DCP流來觸發功能

    舉例: 私有連接A訂閱了"dcp.xxx", 私有連接B沒有訂閱"dcp.xxx", 私有連接C訂閱了"dcp.xxx".

    1. 如果連接A在線, 連接B斷線, 連接C在線, 那麼這種情況下不會觸發DCP功能.
    2. 如果連接A在線, 連接B斷線, 連接C斷線, 那麼這種情況下不會觸發DCP功能.
    3. 如果連接A斷線, 連接B在線, 連接C斷線, 那麼這種情況下就會當達到時間窗口的閾值後觸發斷線保護機制.

    綜上, 只有當所有訂閱了"dcp.xxx"的私有連接斷線後, 斷線保護機制才會被觸發.

    Topic: dcp.future, dcp.spot, dcp.option

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
            "dcp.future"
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/private/execution.html b/zh-TW/v5/websocket/private/execution.html index 560fdc679a..a4ab72c53e 100644 --- a/zh-TW/v5/websocket/private/execution.html +++ b/zh-TW/v5/websocket/private/execution.html @@ -4,14 +4,14 @@ 個人成交 | Bybit API Documentation - +

    個人成交

    訂閱個人成交的推送

    提示

    單筆訂單可能有多次成交

    All-In-One Topic: execution
    Categorised Topic: execution.spot, execution.linear, execution.inverse, execution.option

    信息
    • All-In-One topic 和 Categorised topic 不能放在同一個訂閱請求裡
    • All-In-One topic: 允許您監聽所有業務線的websocket更新(現貨, 正向合約, 反向合約, 期權)
    • Categorised Topic: 您只能監聽您指定的那個業務的websocket更新

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    creationTimenumber消息數據創建時間
    dataarrayObject
    > categorystring產品類型
    • 統一帳戶: spot, linear, iverse, option
    • 經典帳戶: spot, linear, inverse.
    > symbolstring合約名稱
    > isLeveragestring是否借貸. 僅統一帳戶spot有效. 0: 否, 1: 是. 經典帳戶現貨交易不支持, 總是0
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義訂單ID
    > sidestring訂單方向.買：Buy,賣：Sell
    > orderPricestring訂單價格. 經典帳戶現貨交易不支持
    > orderQtystring訂單數量. 經典帳戶現貨交易不支持
    > leavesQtystring剩餘委託未成交數量. 經典帳戶現貨交易不支持
    > createTypestring訂單創建類型
  • 統一帳戶: 僅作用於category=linear 或 inverse
  • 經典帳戶: 總是返回""
  • 現貨、期權不返回該字段
    • > orderTypestring訂單類型. 市價單：Market,限價單：Limit
    > stopOrderTypestring条件单的订单类型。如果该订单不是条件单，则不会返回任何类型. 經典帳戶現貨交易不支持
    > execFeestring交易手續費. 您可以從這裡了解現貨手續費幣種信息. 經典帳戶現貨交易不支持
    > execIdstring成交Id
    > execPricestring成交價格
    > execQtystring成交數量
    > execTypestring成交類型. 經典帳戶現貨交易不支持
    > execValuestring成交價值. 經典帳戶現貨交易不支持
    > execTimestring成交時間（毫秒）
    > isMakerBool是否是 Maker 訂單,true 為 maker 訂單，false 為 taker 訂單
    > feeRatestring手續費率. 經典帳戶現貨交易不支持
    > tradeIvstring隱含波動率，僅期權有效
    > markIvstring標記價格的隱含波動率，僅期權有效
    > markPricestring成交執行時，該 symbol 當時的標記價格. 目前僅對期權業務有效
    > indexPricestring成交執行時，該 symbol 當時的指數價格，目前僅對期權業務有效
    > underlyingPricestring成交執行時，該 symbol 當時的底層資產價格，僅期權有效
    > blockTradeIdstring大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID
    > closedSizestring平倉數量
    > seqlong序列號, 用於關聯成交和倉位的更新
    • 同一時間有多筆成交, seq相同
    • 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
            "execution"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.execution_stream(callback=handle_message)
    while True:
        sleep(1)

    推送示例​

    {
        "id": "592324803b2785-26fa-4214-9963-bdd4727f07be",
        "topic": "execution",
        "creationTime": 1672364174455,
        "data": [
            {
                "category": "linear",
                "symbol": "XRPUSDT",
                "execFee": "0.005061",
                "execId": "7e2ae69c-4edf-5800-a352-893d52b446aa",
                "execPrice": "0.3374",
                "execQty": "25",
                "execType": "Trade",
                "execValue": "8.435",
                "isMaker": false,
                "feeRate": "0.0006",
                "tradeIv": "",
                "markIv": "",
                "blockTradeId": "",
                "markPrice": "0.3391",
                "indexPrice": "",
                "underlyingPrice": "",
                "leavesQty": "0",
                "orderId": "f6e324ff-99c2-4e89-9739-3086e47f9381",
                "orderLinkId": "",
                "orderPrice": "0.3207",
                "orderQty": "25",
                "orderType": "Market",
                "stopOrderType": "UNKNOWN",
                "side": "Sell",
                "execTime": "1672364174443",
                "isLeverage": "0",
                "closedSize": "25",
                "seq": 4688002127
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/private/fast-execution.html b/zh-TW/v5/websocket/private/fast-execution.html index 52eb873af4..0dda4f9e96 100644 --- a/zh-TW/v5/websocket/private/fast-execution.html +++ b/zh-TW/v5/websocket/private/fast-execution.html @@ -4,14 +4,14 @@ 個人成交 (Fast) | Bybit API Documentation - +

    個人成交 (Fast)

    精簡版本的個人成交推送, 相比原始的快速成交流, 延遲更加低

    提示
    • 目前支持USDT永續, USDC永續, USDC交割, 反向永續, 反向交割和現貨的成交推送, 不支持期權
    • 僅推送execType=Trade的消息

    All-In-One Topic: execution.fast
    Categorised Topic: execution.fast.linear, execution.fast.inverse, execution.fast.spot

    響應參數​

    參數類型說明
    topicstringTopic名
    creationTimenumber消息數據創建時間
    dataarrayObject
    > categorystring產品類型
    • 統一帳戶: linear, iverse, spot
    • 經典帳戶: linear, inverse, spot
    > symbolstring合約名稱
    > orderIdstring訂單ID
    > isMakerbooleantrue: maker成交, false: taker成交
    > orderLinkIdstring用戶自定義訂單ID
  • maker成交總是返回""
  • 當maker訂單在訂單簿中轉化成了taker單(比如修改了價格), 這種情況orderLinkId也是""
    • > sidestring訂單方向.買：Buy,賣：Sell
    > execIdstring成交Id
    > execPricestring成交價格
    > execQtystring成交數量
    > execTimestring成交時間（毫秒）
    > seqlong序列號, 用於關聯成交和倉位的更新
    • 同一時間有多筆成交, seq相同
    • 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
            "execution.fast"
        ]
    }

    推送示例​

    {
        "topic": "execution.fast",
        "creationTime": 1716800399338,
        "data": [
            {
                "category": "linear",
                "symbol": "ICPUSDT",
                "execId": "3510f361-0add-5c7b-a2e7-9679810944fc",
                "execPrice": "12.015",
                "execQty": "3000",
                "orderId": "443d63fa-b4c3-4297-b7b1-23bca88b04dc",
                "isMaker": false,
                "orderLinkId": "test-00001",
                "side": "Sell",
                "execTime": "1716800399334",
                "seq": 34771365464
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/private/greek.html b/zh-TW/v5/websocket/private/greek.html index f2e8a962ec..654fad6dfa 100644 --- a/zh-TW/v5/websocket/private/greek.html +++ b/zh-TW/v5/websocket/private/greek.html @@ -4,13 +4,13 @@ 用戶希臘字母信息 (期權) | Bybit API Documentation - +

    用戶希臘字母信息 (期權)

    訂閱用戶希臘字母數據推送

    Topic: greeks

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    creationTimenumber消息數據創建時間
    dataarrayObject
    > baseCoinstring交易幣種
    > totalDeltastringDelta值
    > totalGammastringGamma值
    > totalVegastringVega值
    > totalThetastringTheta值

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
            "greeks"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.greek_stream(callback=handle_message)
    while True:
        sleep(1)

    推送示例​

    {
        "id": "592324fa945a30-2603-49a5-b865-21668c29f2a6",
        "topic": "greeks",
        "creationTime": 1672364262482,
        "data": [
            {
                "baseCoin": "ETH",
                "totalDelta": "0.06999986",
                "totalGamma": "-0.00000001",
                "totalVega": "-0.00000024",
                "totalTheta": "0.00001314"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/private/order.html b/zh-TW/v5/websocket/private/order.html index 095a2b4449..a33805c7ec 100644 --- a/zh-TW/v5/websocket/private/order.html +++ b/zh-TW/v5/websocket/private/order.html @@ -4,14 +4,14 @@ 訂單 | Bybit API Documentation - +

    訂單

    訂閱訂單數據推送

    All-In-One Topic: order
    Categorised Topic: order.spot, order.linear, order.inverse, order.option

    信息
    • All-In-One topic 和 Categorised topic 不能放在同一個訂閱請求裡
    • All-In-One topic: 允許您監聽所有業務線的websocket更新(現貨, 正向合約, 反向合約, 期權)
    • Categorised Topic: 您只能監聽您指定的那個業務的websocket更新

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    creationTimenumber消息數據創建時間
    dataarrayObject
    > categorystring產品類型
    • 統一帳戶: spot, linear, inverse, option
    • 經典帳戶: spot, linear, inverse.
    > orderIdstring訂單ID
    > orderLinkIdstring用戶自定義ID
    > isLeveragestring是否借貸. 僅統一帳戶spot有效. 0: 否, 1: 是. 經典帳戶現貨交易不支持, 總是0
    > blockTradeIdstring大宗交易訂單Id
    > symbolstring合約名稱
    > pricestring訂單價格
    > qtystring訂單數量
    > sidestring方向. Buy,Sell
    > positionIdxinteger倉位標識。用戶不同倉位模式
    > orderStatusstring訂單狀態
    > createTypestring訂單創建類型
  • 僅作用於category=linear 或 inverse
  • 現貨、期權不返回該字段
    • > cancelTypestring訂單被取消類型. 經典帳戶現貨交易不支持
    > rejectReasonstring拒絕原因. 經典帳戶現貨交易不支持
    > avgPricestring訂單平均成交價格
  • 不存在avg price場景的訂單返回"", 以及經典帳戶下部分成交但最終被手動取消的訂單
  • 經典帳戶現貨交易: 該字段不支持, 總是""
    • > leavesQtystring訂單剩餘未成交的數量. 經典帳戶現貨交易不支持
    > leavesValuestring訂單剩餘未成交的價值. 經典帳戶現貨交易不支持
    > cumExecQtystring訂單累計成交數量
    > cumExecValuestring訂單累計成交價值
    > cumExecFeestring訂單累計成交的手續費
    • 經典帳戶spot: 表示的是最近一次成交的手續費.
    • 升級到統一帳戶後, 您可以使用成交頻道中的execFee字段來獲取每次成交的手續費
    > feeCurrencystring現貨交易的手續費幣種. 可以從這裡了解現貨交易的手續費幣種規則
    > timeInForcestring執行策略
    > orderTypestring訂單類型. Market,Limit. 對於止盈止損單, 則表示為觸發後的訂單類型
    > stopOrderTypestring條件單類型
    > ocoTriggerBystring現貨OCO訂單的觸發類型.OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl. 經典帳戶現貨不支持該字段
    > orderIvstring隱含波動率
    > marketUnitstring統一帳戶現貨交易時給入參qty選擇的單位. baseCoin, quoteCoin
    > triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > tpslModestring止盈止損模式 Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損. 現貨不返回該字段, 期權總是返回""
    > tpLimitPricestring觸發止盈後轉換為限價單的價格
    > slLimitPricestring觸發止損後轉換為限價單的價格
    > tpTriggerBystring觸發止盈的價格類型
    > slTriggerBystring觸發止損的價格類型
    > triggerDirectioninteger觸發方向. 1: 上漲, 2: 下跌
    > triggerBystring觸發價格的觸發類型
    > lastPriceOnCreatedstring下單時的市場價格
    > reduceOnlyboolean只減倉. true表明這是只減倉單
    > closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?
    > placeTypestringPlace type, option used. iv, price
    > smpTypestringSMP執行類型
    > smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
    > smpOrderIdstring觸發此SMP執行的交易對手的 orderID
    > createdTimestring創建訂單的時間戳 (毫秒)
    > updatedTimestring訂單更新的時間戳 (毫秒)

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
            "order"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.order_stream(callback=handle_message)
    while True:
        sleep(1)

    推送示例​

    {
        "id": "5923240c6880ab-c59f-420b-9adb-3639adc9dd90",
        "topic": "order",
        "creationTime": 1672364262474,
        "data": [
            {
                "symbol": "ETH-30DEC22-1400-C",
                "orderId": "5cf98598-39a7-459e-97bf-76ca765ee020",
                "side": "Sell",
                "orderType": "Market",
                "cancelType": "UNKNOWN",
                "price": "72.5",
                "qty": "1",
                "orderIv": "",
                "timeInForce": "IOC",
                "orderStatus": "Filled",
                "orderLinkId": "",
                "lastPriceOnCreated": "",
                "reduceOnly": false,
                "leavesQty": "",
                "leavesValue": "",
                "cumExecQty": "1",
                "cumExecValue": "75",
                "avgPrice": "75",
                "blockTradeId": "",
                "positionIdx": 0,
                "cumExecFee": "0.358635",
                "createdTime": "1672364262444",
                "updatedTime": "1672364262457",
                "rejectReason": "EC_NoError",
                "stopOrderType": "",
                "tpslMode": "",
                "triggerPrice": "",
                "takeProfit": "",
                "stopLoss": "",
                "tpTriggerBy": "",
                "slTriggerBy": "",
                "tpLimitPrice": "",
                "slLimitPrice": "",
                "triggerDirection": 0,
                "triggerBy": "",
                "closeOnTrigger": false,
                "category": "option",
                "placeType": "price",
                "smpType": "None",
                "smpGroup": 0,
                "smpOrderId": "",
                "feeCurrency": ""
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/private/position.html b/zh-TW/v5/websocket/private/position.html index 5fcb4a8c09..2b434f45a6 100644 --- a/zh-TW/v5/websocket/private/position.html +++ b/zh-TW/v5/websocket/private/position.html @@ -4,14 +4,14 @@ 持倉 | Bybit API Documentation - +

    持倉

    訂閱持倉數據的推送

    All-In-One Topic: position
    Categorised Topic: position.linear, position.inverse, position.option

    信息
    • All-In-One topic 和 Categorised topic 不能放在同一個訂閱請求裡
    • All-In-One topic: 允許您監聽所有業務線的websocket倉位更新(正向合約, 反向合約, 期權)
    • Categorised Topic: 您只能監聽您指定的那個業務的websocket更新

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    creationTimenumber消息數據創建時間
    dataarrayObject
    > categorystring產品類型
    > symbolstring合約名稱
    > sidestring持倉方向. Buy,Sell
    > sizestring持倉大小
    > positionIdxinteger倉位標識
    > tradeModeinteger交易模式。
    • 統一帳戶 (反向合約) & 經典帳戶: 0: 全倉, 1: 逐倉
    • 統一帳戶: 廢棄, 總是 0
    > positionValuestring倉位價值
    > riskIdinteger風險限額id. 注意: 組合保證金模式下，該字段返回0，風險限額規則失效
    > riskLimitValuestring風險限額id對應的風險限額度. 注意: 組合保證金模式下，該字段返回空字符串，風險限額規則失效
    > entryPricestring入場價
    > markPricestring標記價
    > leveragestring槓桿. 注意: 組合保證金模式下，該字段返回""，槓桿規則失效
    > positionBalancestring倉位保證金. 組合保證金模式(PM)下, 該字段返回為空字符串
    > autoAddMargininteger是否自動追加保證金. 0: 否, 1: 是. 僅當統一帳戶(除反向合約)開啟了帳戶維度的逐倉保證金模式, 該字段才有意義
    > positionMMstring倉位維持保證金. 注意: 組合保證金模式下，該字段返回空字符串
    > positionIMstring倉位初始保證金. 注意: 組合保證金模式下，該字段返回空字符串
    > liqPricestring倉位強平價格，
    • UTA(反向合約) & 普通账户 & UTA(開啟逐倉保證金模式)：是逐倉和全倉持仓的真實價格, 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""。
    • 統一帳戶(全倉保證金)：是全倉持仓的预估价格（因为统一帳戶模式是按照帳戶維度控制风险率), 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""
    但是對於組合保證金模式，此字段為空，不會提供強平價格
    > bustPricestring預估破產價. 統一帳戶(現貨/USDT和USDC永續/期權)為空
    > tpslModestring該字段廢棄, 無意義, 總是返回"Full". 期權總是返回""
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > trailingStopstring追蹤止損
    > unrealisedPnlstring未結盈虧
    > sessionAvgPricestringUSDC合約平均持倉價格, 會隨著8小時結算而變動
    > deltastringDelta, 期權的獨有字段
    > gammastringGamma, 期權的獨有字段
    > vegastringVega, 期權的獨有字段
    > thetastringTheta, 期權的獨有字段
    > curRealisedPnlstring當前持倉的已結盈虧
    > cumRealisedPnlstring累计已结盈亏
    • 期貨: 是從第一次開始有持倉加總的已結盈虧
    • 期權: 它是本次持倉的加總已結盈虧
    > positionStatusstring倉位狀態. Normal,Liq, Adl
    > adlRankIndicatorinteger自動減倉燈. 什麼是自動減倉機制?
    > isReduceOnlyboolean僅當Bybit需要降低某個Symbol的風險限額時有用
    • true: 僅允許減倉操作. 您可以考慮一系列的方式, 比如, 降低risk limit檔位, 或者同檔位修改槓桿或減少倉位, 或者增加保證金, 或者撤單, 這些操作做完後, 可以主動調用確認新的風險限額接口
    • false(默認): 沒有交易限制, 表示您的倉位在系統調整時處於風險水平之下
    • 僅對逐倉和全倉的期貨倉位有意義
    > mmrSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改MMR的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了MMR調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > leverageSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
    • 當isReduceOnly=true: 這個時間戳表示系統強制修改槓桿的時間
      • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了槓桿調整的時間
    • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
    • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > createdTimestring倉位創建時間戳 (毫秒)
    > updatedTimestring倉位數據更新時間戳 (毫秒)
    > seqlong序列號, 用於關聯成交和倉位的更新
    • 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別
    • 如果該幣對從未被交易過, 查詢時則會返回"-1"
    • 對於更新槓桿、更新風險限額等非交易行為, 將會返回上一次成交時更新的seq

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
            "position"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.position_stream(callback=handle_message)
    while True:
        sleep(1)

    推送示例​

    {
        "id": "1003076014fb7eedb-c7e6-45d6-a8c1-270f0169171a",
        "topic": "position",
        "creationTime": 1697682317044,
        "data": [
            {
                "positionIdx": 2,
                "tradeMode": 0,
                "riskId": 1,
                "riskLimitValue": "2000000",
                "symbol": "BTCUSDT",
                "side": "",
                "size": "0",
                "entryPrice": "0",
                "leverage": "10",
                "positionValue": "0",
                "positionBalance": "0",
                "markPrice": "28184.5",
                "positionIM": "0",
                "positionMM": "0",
                "takeProfit": "0",
                "stopLoss": "0",
                "trailingStop": "0",
                "sessionAvgPrice": "0",
                "unrealisedPnl": "0",
                "curRealisedPnl": "-2.06",
                "cumRealisedPnl": "-25.06579337",
                "createdTime": "1694402496913",
                "updatedTime": "1697682317038",
                "tpslMode": "Full",
                "liqPrice": "0",
                "bustPrice": "",
                "category": "linear",
                "positionStatus": "Normal",
                "adlRankIndicator": 0,
                "autoAddMargin": 0,
                "leverageSysUpdatedTime": "",
                "mmrSysUpdatedTime": "",
                "seq": 8327597863,
                "isReduceOnly": false
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/private/wallet.html b/zh-TW/v5/websocket/private/wallet.html index 06eda1e177..6923932ad6 100644 --- a/zh-TW/v5/websocket/private/wallet.html +++ b/zh-TW/v5/websocket/private/wallet.html @@ -4,13 +4,13 @@ 錢包 | Bybit API Documentation - +

    錢包

    訂閱錢包數據推送

    Topic: wallet

    響應參數​

    參數類型說明
    idstring消息id
    topicstringTopic名
    creationTimenumber消息數據創建時間
    dataarrayObject
    > accountTypestring帳戶類型.
    • 統一帳戶: UNIFIED(現貨/USDT和USDC永續/期權), CONTRACT(反向合約)
    • 經典帳戶: CONTRACT, SPOT
    > accountLTVstring帳戶LTV: account total borrowed size / (account total equity + account total borrowed size). 非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > accountIMRatestring帳戶初始保證金率: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin. 非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > accountMMRatestring帳戶維持保證金率: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalEquitystring賬戶維度換算成usd的資產淨值：Account Margin Balance Base Coin + Account Option Value Base Coin。非統一保證金模式和統一帳戶(反向)下，該字段返回為空。
    > totalWalletBalancestring賬戶維度換算成usd的產錢包餘額：∑ Asset Wallet Balance By USD value of each asset。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalMarginBalancestring賬戶維度換算成usd的保證金餘額：totalWalletBalance + totalPerpUPL。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalAvailableBalancestring賬戶維度換算成usd的可用餘額：RM：totalMarginBalance - totalInitialMargin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalPerpUPLstring賬戶維度換算成usd的永續和USDC交割合約的浮動盈虧：∑ Each perp and USDC Futures upl by base coin。非統一保證金模式以及統一帳戶(反向)下，該字段返回為空。
    > totalInitialMarginstring賬戶維度換算成usd的總初始保證金：∑ Asset Total Initial Margin Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > totalMaintenanceMarginstring賬戶維度換算成usd的總維持保證金: ∑ Asset Total Maintenance Margin Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
    > coinarrayObject. 幣種列表
    >> coinstring幣種名稱，例如 BTC，ETH，USDT，USDC
    >> equitystring當前幣種的資產淨值
    >> usdValuestring當前幣種折算成 usd 的價值，如果該幣種不能作為保證金的抵押品，則該數值為0
    >> walletBalancestring當前幣種的錢包餘額
    >> freestring經典帳戶現貨錢包的可用餘額. 經典帳戶現貨錢包的獨有字段
    >> lockedstring現貨掛單凍結金額
    >> spotHedgingQtystring用於組合保證金(PM)現貨對衝的數量, 截斷至8為小數, 默認為0 統一帳戶的獨有字段
    >> borrowAmountstring當前幣種的已用借貸額度
    >> availableToBorrowstring由於母子共享借貸限額, 該字段已廢棄, 總是返回"". 請通過查詢抵押品信息接口查詢availableToBorrow
    >> availableToWithdrawstring當前幣種的可劃轉提現金額
    >> accruedIntereststring當前幣種的預計要在下一個利息週期收取的利息金額
    >> totalOrderIMstring以當前幣種結算的訂單委託預佔用保證金. 組合保證金模式下，該字段返回空字符串
    >> totalPositionIMstring以當前幣種結算的所有倉位起始保證金求和 + 所有倉位的預佔用平倉手續費. 組合保證金模式下，該字段返回空字符串
    >> totalPositionMMstring以當前幣種結算的所有倉位維持保證金求和. 組合保證金模式下，該字段返回空字符串
    >> unrealisedPnlstring以當前幣種結算的所有倉位的未結盈虧之和
    >> cumRealisedPnlstring以當前幣種結算的所有倉位的累計已結盈虧之和
    >> bonusstring體驗金. UNIFIED帳戶的獨有字段
    >> marginCollateralboolean是否可作為保證金抵押幣種(平台維度), true: 是. false: 否
    • 當marginCollateral=false時, 則collateralSwitch無意義
    • UNIFIED帳戶的獨有字段
    >> collateralSwitchboolean用戶是否開啟保證金幣種抵押(用戶維度), true: 是. false: 否
    • 僅當marginCollateral=true時, 才能主動選擇開關抵押
    • UNIFIED帳戶的獨有字段

    訂閱示例​

    {
        "op": "subscribe",
        "args": [
            "wallet"
        ]
    }
    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="private",
        api_key="XXXXX",
        api_secret="XXXXX",
    )
    def handle_message(message):
        print(message)
    ws.wallet_stream(callback=handle_message)
    while True:
        sleep(1)

    推送示例​

    {
        "id": "592324d2bce751-ad38-48eb-8f42-4671d1fb4d4e",
        "topic": "wallet",
        "creationTime": 1700034722104,
        "data": [
            {
                "accountIMRate": "0",
                "accountMMRate": "0",
                "totalEquity": "10262.91335023",
                "totalWalletBalance": "9684.46297164",
                "totalMarginBalance": "9684.46297164",
                "totalAvailableBalance": "9556.6056555",
                "totalPerpUPL": "0",
                "totalInitialMargin": "0",
                "totalMaintenanceMargin": "0",
                "coin": [
                    {
                        "coin": "BTC",
                        "equity": "0.00102964",
                        "usdValue": "36.70759517",
                        "walletBalance": "0.00102964",
                        "availableToWithdraw": "0.00102964",
                        "availableToBorrow": "",
                        "borrowAmount": "0",
                        "accruedInterest": "0",
                        "totalOrderIM": "",
                        "totalPositionIM": "",
                        "totalPositionMM": "",
                        "unrealisedPnl": "0",
                        "cumRealisedPnl": "-0.00000973",
                        "bonus": "0",
                        "collateralSwitch": true,
                        "marginCollateral": true,
                        "locked": "0",
                        "spotHedgingQty": "0.01592413"
                    }
                ],
                "accountLTV": "0",
                "accountType": "UNIFIED"
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/public/etp-kline.html b/zh-TW/v5/websocket/public/etp-kline.html index 3c8e9bc95c..fd7dcd4d0a 100644 --- a/zh-TW/v5/websocket/public/etp-kline.html +++ b/zh-TW/v5/websocket/public/etp-kline.html @@ -4,14 +4,14 @@ ETP淨值K線 | Bybit API Documentation - +

    ETP淨值K線

    訂閱槓桿代幣的淨值K線行情推送服務

    提示

    若confirm=true, 則表示這根蠟燭是最後一根K線, 否則，這是切片數據

    可用的時間粒度:

    • 1 3 5 15 30 (分鐘)
    • 60 120 240 360 720 (分鐘)
    • D (天)
    • W (週)
    • M (月)

    推送頻率: 1-60秒

    Topic:
    kline_lt.{interval}.{symbol} e.g., kline_lt.30.BTC3SUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > startnumber開始時間戳 (毫秒)
    > endnumber結束時間戳 (毫秒). 若時間還未到時間跨度的最後時間，則表示當前時間
    > intervalstringK線粒度
    > openstring開盤價
    > closestring收盤價
    > highstring最高價
    > lowstring最低價
    > confirmboolean是否確認
    > timestampnumber蠟燭中最後一筆淨值時間戳 (毫秒)

    訂閱示例​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="spot",
    )
    def handle_message(message):
        print(message)
    ws.lt_kline_stream(
        interval=30,
        symbol="EOS3LUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    響應示例​

    {
        "type": "snapshot",
        "topic": "kline_lt.5.EOS3LUSDT",
        "data": [
            {
                "start": 1672325100000,
                "end": 1672325399999,
                "interval": "5",
                "open": "0.416039541212402799",
                "close": "0.41477848043290448",
                "high": "0.416039541212402799",
                "low": "0.409734237314911206",
                "confirm": false,
                "timestamp": 1672325322393
            }
        ],
        "ts": 1672325322393
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/public/etp-nav.html b/zh-TW/v5/websocket/public/etp-nav.html index 4de0c893f0..a5675aa3a8 100644 --- a/zh-TW/v5/websocket/public/etp-nav.html +++ b/zh-TW/v5/websocket/public/etp-nav.html @@ -4,14 +4,14 @@ ETP最新淨值推送 | Bybit API Documentation - +

    ETP最新淨值推送

    訂閱槓桿代幣的最新淨值行情數據

    推送頻率: 300ms

    Topic:
    lt.{symbol} e.g.,lt.BTC3SUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > timenumber淨值生成時間戳 (毫秒)
    > symbolstring合約名稱
    > navstring淨值
    > basketPositionstring籃子頭寸
    > leveragestring槓桿倍數
    > basketLoanstring籃子借貸
    > circulationstring發行量
    > basketstring籃子

    訂閱示例​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="spot",
    )
    def handle_message(message):
        print(message)
    ws.lt_nav_stream(
        symbol="EOS3LUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    響應示例​

    {
        "topic": "lt.EOS3LUSDT",
        "ts": 1672325564669,
        "type": "snapshot",
        "data": {
            "symbol": "EOS3LUSDT",
            "time": 1672325564554,
            "nav": "0.413517419653406162",
            "basketPosition": "1.261060779498318641",
            "leverage": "2.656197506416192150",
            "basketLoan": "-0.684866519289629374",
            "circulation": "72767.309468460367138199",
            "basket": "91764.000000292013277472"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/public/etp-ticker.html b/zh-TW/v5/websocket/public/etp-ticker.html index f154c75fe9..2af0d992f0 100644 --- a/zh-TW/v5/websocket/public/etp-ticker.html +++ b/zh-TW/v5/websocket/public/etp-ticker.html @@ -4,14 +4,14 @@ ETP淨值行情推送 | Bybit API Documentation - +

    ETP淨值行情推送

    訂閱槓桿代幣淨值行情數據

    推送頻率: 300ms

    Topic:
    tickers_lt.{symbol} e.g.,tickers_lt.BTC3SUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > symbolstring合約名稱
    > price24hPcntstring市價相對24h變化百分比
    > lastPricestring最新淨值
    > prevPrice24hstring24小時前的整點市價
    > highPrice24hstring最近24小時的最高價
    > lowPrice24hstring最近24小時的最低價

    訂閱示例​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="spot",
    )
    def handle_message(message):
        print(message)
    ws.lt_ticker_stream(
        symbol="EOS3LUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    Response Example​

    {
        "topic": "tickers_lt.EOS3LUSDT",
        "ts": 1672325446847,
        "type": "snapshot",
        "data": {
            "symbol": "EOS3LUSDT",
            "lastPrice": "0.41477848043290448",
            "highPrice24h": "0.435285472510871305",
            "lowPrice24h": "0.394601507960931382",
            "prevPrice24h": "0.431502290172376349",
            "price24hPcnt": "-0.0388"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/public/kline.html b/zh-TW/v5/websocket/public/kline.html index aab03c822a..6fa004f1d9 100644 --- a/zh-TW/v5/websocket/public/kline.html +++ b/zh-TW/v5/websocket/public/kline.html @@ -4,14 +4,14 @@ K線 | Bybit API Documentation - +

    K線

    訂閱K線推送

    提示

    註意如果字段confirm為true, 則表明這是這根K線的最後一個tick；否則，這只是一個快照數據，即中間價格

    可用時間粒度:

    • 1 3 5 15 30 (分鐘)
    • 60 120 240 360 720 (分鐘)
    • D (天)
    • W (週)
    • M (月)

    推送頻率: 1-60s

    Topic:
    kline.{interval}.{symbol} e.g., kline.30.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > startnumber開始時間戳 (毫秒)
    > endnumber結束時間戳 (毫秒)
    > intervalstringK線粒度
    > openstring開盤價
    > closestring收盤價
    > highstring最高價
    > lowstring最低價
    > volumestring交易量
    > turnoverstring交易額
    > confirmboolean是否確認
    > timestampnumber蠟燭中最後一筆淨值時間戳 (毫秒)

    訂閱示例​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.kline_stream(
        interval=5,
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    響應示例​

    {
        "topic": "kline.5.BTCUSDT",
        "data": [
            {
                "start": 1672324800000,
                "end": 1672325099999,
                "interval": "5",
                "open": "16649.5",
                "close": "16677",
                "high": "16677",
                "low": "16608",
                "volume": "2.081",
                "turnover": "34666.4005",
                "confirm": false,
                "timestamp": 1672324988882
            }
        ],
        "ts": 1672324988882,
        "type": "snapshot"
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/public/liquidation.html b/zh-TW/v5/websocket/public/liquidation.html index 25d18659b8..df67ad4177 100644 --- a/zh-TW/v5/websocket/public/liquidation.html +++ b/zh-TW/v5/websocket/public/liquidation.html @@ -4,14 +4,14 @@ 強平推送 | Bybit API Documentation - +

    強平推送

    訂閱Bybit平台上的強平推送, symbol维度最多1秒推一条爆仓数据

    推送頻率: 1秒

    Topic:
    liquidation.{symbol} e.g., liquidation.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataObject
    > updatedTimenumber數據更新時間戳 (毫秒)
    > symbolstring合約名稱
    > sidestring被平的倉位方向. Buy,Sell
  • 如果您收到一條Buy的推送更新, 則表面有一個多倉被強平了
    • > sizestring成交數量
    > pricestring破產價格

    訂閱示例​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.liquidation_stream(
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    響應示例​

    {
        "topic": "liquidation.BTCUSDT",
        "type": "snapshot",
        "ts": 1703485237953,
        "data": {
            "updatedTime": 1703485237953,
            "symbol": "BTCUSDT",
            "side": "Sell",
            "size": "0.003",
            "price": "43511.70"
        }
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/public/orderbook.html b/zh-TW/v5/websocket/public/orderbook.html index 7c7428bd45..59eef04a1a 100644 --- a/zh-TW/v5/websocket/public/orderbook.html +++ b/zh-TW/v5/websocket/public/orderbook.html @@ -4,7 +4,7 @@ 深度 | Bybit API Documentation - + @@ -20,7 +20,7 @@ 25 檔數據, 推送頻率: 20ms
    100 檔數據, 推送頻率: 100ms

    Topic:
    orderbook.{depth}.{symbol} e.g., orderbook.1.BTCUSDT

    響應參數​

    參數類型說明
    topicstringTopic名
    typestring數據類型. snapshot,delta
    tsnumber行情服務生成數據的時間戳 (毫秒)
    datamapObject
    > sstring合約名稱
    > barrayBid, 買方. snapshot數據，是按照價格從大到小
    >> b[0]string買方報價
    >> b[1]string買方數量
  • 增量數據的推送當出現size=0時，這意味著該價位的報價單全部成交或者全部撤銷
    • > aarrayAsk, 賣方. snapshot數據，是按照價格從小到大
    >> a[0]string賣方報價
    >> a[1]string賣方數量
  • 增量數據的推送當出現size=0時，這意味著該價位的報價單全部成交或者全部撤銷
    • > uinteger更新id, 一般情況下該id是連續的。偶爾會因後台的重啟而發送"u"=1的全量數據，接收到後請覆蓋本地保存的orderbook
    > seqinteger撮合版本號
  • 該字段可以用於關聯不同檔位的orderbook, 如果值越小, 則說明數據生成越早
    • ctsnumber產生此訂單簿數據時來自撮合引擎的時間戳. 可用於與平台成交頻道中的T進行關聯

    訂閱示例​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.orderbook_stream(
        depth=50,
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    響應示例​

    {
        "topic": "orderbook.50.BTCUSDT",
        "type": "snapshot",
        "ts": 1672304484978,
        "data": {
            "s": "BTCUSDT",
            "b": [
                ...,
                [
                    "16493.50",
                    "0.006"
                ],
                [
                    "16493.00",
                    "0.100"
                ]
            ],
            "a": [
                [
                    "16611.00",
                    "0.029"
                ],
                [
                    "16612.00",
                    "0.213"
                ],
                ...,
            ],
        "u": 18521288,
        "seq": 7961638724
        }
        "cts": 1672304484976
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/public/ticker.html b/zh-TW/v5/websocket/public/ticker.html index 6e00130085..1ccf381904 100644 --- a/zh-TW/v5/websocket/public/ticker.html +++ b/zh-TW/v5/websocket/public/ticker.html @@ -4,14 +4,14 @@ 行情 | Bybit API Documentation - +

    行情

    訂閱行情數據推送.

    警告
    • 注意，該topic推送delta數據和snapshot数据。如果delta數據中缺失一些字段，表明該字段自上次推送以來沒有發生變化。
    • 現貨和期權只推送snapshot類型數據

    推送頻率: 期貨和期權 - 100ms, 現貨 - 實時

    Topic:
    tickers.{symbol}

    響應參數​

    參數類型說明
    topicstringTopic名稱
    typestring數據類型. `snapshot`,`delta`
    csinteger撮合版本號
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject
    > symbolstring合約名稱
    > tickDirectionstring價格變化方向
    > price24hPcntstring市場價格相對24h前變化的百分比
    > lastPricestring最新市場成交價
    > prevPrice24hstring24小時前的整點市價
    > highPrice24hstring最近24小時的最高價
    > lowPrice24hstring最近24小時的最低價
    > prevPrice1hstring1小時前的整點市價
    > markPricestring標記價格
    > indexPricestring指數價格
    > openIntereststring未平倉合約的數量
    > openInterestValuestring未平倉合約的價值
    > turnover24hstring最近24小時成交額
    > volume24hstring最近24小時成交量
    > nextFundingTimestring下次結算資金費用的時間戳 (毫秒)
    > fundingRatestring資金費率
    > bid1Pricestring買1價
    > bid1Sizestring買1價的數量
    > ask1Pricestring賣1價
    > ask1Sizestring賣1價的數量
    > deliveryTimedatetime交割日期時間 (UTC+0). 反向交割和USDC交割獨有字段
    > basisRatestring基差率. 反向交割和USDC交割獨有字段
    > deliveryFeeRatestring交割費率. 反向交割和USDC交割獨有字段
    > predictedDeliveryPricestring預估交割價格. 反向交割和USDC交割獨有字段
    > preOpenPricestring盤前合約預估開盤價格
  • 在進入連續競價後, 該值無意義
  • USDC交割合約, 反向交割合約不輸出該字段
    • > preQtystring盤前合約預估開盤數量
  • 進入連續競價後, 該值無意義
  • USDC交割合約, 反向交割合約不輸出該字段
    • > curPreListingPhasestring當前盤前交易階段
  • USDC交割合約, 反向交割合約不輸出該字段

    • 訂閱示例​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.ticker_stream(
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    響應示例​

    {
        "topic": "tickers.BTCUSDT",
        "type": "snapshot",
        "data": {
            "symbol": "BTCUSDT",
            "tickDirection": "PlusTick",
            "price24hPcnt": "0.017103",
            "lastPrice": "17216.00",
            "prevPrice24h": "16926.50",
            "highPrice24h": "17281.50",
            "lowPrice24h": "16915.00",
            "prevPrice1h": "17238.00",
            "markPrice": "17217.33",
            "indexPrice": "17227.36",
            "openInterest": "68744.761",
            "openInterestValue": "1183601235.91",
            "turnover24h": "1570383121.943499",
            "volume24h": "91705.276",
            "nextFundingTime": "1673280000000",
            "fundingRate": "-0.000212",
            "bid1Price": "17215.50",
            "bid1Size": "84.489",
            "ask1Price": "17216.00",
            "ask1Size": "83.020"
        },
        "cs": 24987956059,
        "ts": 1673272861686
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/public/trade.html b/zh-TW/v5/websocket/public/trade.html index e48acf773e..e88e31e794 100644 --- a/zh-TW/v5/websocket/public/trade.html +++ b/zh-TW/v5/websocket/public/trade.html @@ -4,7 +4,7 @@ 平台成交 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    平台成交

    訂閱Bybit平台上最近成交的推送.
    從用戶訂閱開始, 實時推送增量交易歷史, 有成交數據就推送.

    推送頻率: 實時

    Topic:
    publicTrade.{symbol} 注意: 期權使用baseCoin, e.g., publicTrade.BTC

    響應參數​

    參數類型說明
    idstring消息 id. 期權沒有該字段
    topicstringTopic名
    typestring數據類型. snapshot
    tsnumber行情服務生成數據的時間戳 (毫秒)
    dataarrayObject. 如有多條, 則數組中的元素按照匹配時間升序排序
    > Tnumber成交時間戳 (毫秒)
    > sarray合約名稱
    > Sstring吃單方向. Buy,Sell
    > vstring成交數量
    > pstring成交價格
    > Lstring價格變化的方向. 期權沒有該字段
    > istring成交Id
    > BTboolean成交類型是否為大宗交易
    > mPstring標記價格, 期權的特有字段
    > iPstring指數價格, 期權的特有字段
    > mIvstring標記iv, 期權的特有字段
    > ivstringiv, 期權的特有字段

    訂閱示例​

    from pybit.unified_trading import WebSocket
    from time import sleep
    ws = WebSocket(
        testnet=True,
        channel_type="linear",
    )
    def handle_message(message):
        print(message)
    ws.trade_stream(
        symbol="BTCUSDT",
        callback=handle_message
    )
    while True:
        sleep(1)

    響應示例​

    {
        "topic": "publicTrade.BTCUSDT",
        "type": "snapshot",
        "ts": 1672304486868,
        "data": [
            {
                "T": 1672304486865,
                "s": "BTCUSDT",
                "S": "Buy",
                "v": "0.001",
                "p": "16578.50",
                "L": "PlusTick",
                "i": "20f43950-d8dd-5b31-9112-a178eb6023af",
                "BT": false
            }
        ]
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/websocket/trade/guideline.html b/zh-TW/v5/websocket/trade/guideline.html index e128076951..e563b76899 100644 --- a/zh-TW/v5/websocket/trade/guideline.html +++ b/zh-TW/v5/websocket/trade/guideline.html @@ -4,7 +4,7 @@ Websocket下單指南 | Bybit API Documentation - + @@ -12,7 +12,7 @@

    Websocket下單指南

    路徑​

    • 主網:
      wss://stream.bybit.com/v5/trade

    • 測試網:
      wss://stream-testnet.bybit.com/v5/trade

    支持範圍​

    統一帳戶

    category=linear, spot, option

    鑒權請求​

    請求參數​

    參數是否必需類型說明
    reqIdfalsestring可選參數, 可用於匹配響應。長度不能超過36個字串。
  • 若不傳, 該字段不會從響應種返回
    • optruestringOp類型 auth
    argsfalsestring["api密鑰", 過期時間, "簽名"]. 請參閱這裡來生成簽名

    響應參數​

    參數類型說明
    reqIdstring
  • 若請求有傳, 則響應存在該字段
  • 若請求不傳, 則響應沒有該字段
    • retCodeinteger
  • 0: 鑒權成功
  • 20001: 重複請求
  • 10004: 無效簽名
  • 10001: 參數錯誤
    • retMsgstring
  • OK
  • 報錯信息
    • opstringOp類型
    connIdstring連接的唯一id

    請求示例​

    {
        "op": "auth",
        "args": [
            "XXXXXX",
            1711010121452,
            "ec71040eff72b163a36153d770b69d6637bcb29348fbfbb16c269a76595ececf"
        ]
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "op": "auth",
        "connId": "cnt5leec0hvan15eukcg-2t"
    }

    下單/改單/撤單​

    請求參數​

    參數是否必需類型說明
    reqIdfalsestring請求reqId, 可作為請求的唯一標識, 若有傳, 則響應會返回該字段
  • 當傳, 需保證唯一, 否則將會拿到錯誤 "20006"
    • headertrueobject請求頭
    > X-BAPI-TIMESTAMPtruestring當前時間戳
    > X-BAPI-RECV-WINDOWfalsestring默認5000(毫秒). 請求的時間需要滿足該公式: Bybit服務器時間 - X-BAPI-RECV-WINDOW <= X-BAPI-TIMESTAMP < Bybit服務器時間 + 1000
    > RefererfalsestringAPI broker用戶返佣標識
    optruestringOp類型
  • order.create: 創建訂單
  • order.amend: 修改訂單
  • order.cancel: 撤銷訂單
    • argsfalsearray<object>參數數組, 目前僅支持一個元素
  • order.create: 請參閱創建訂單請求參數
  • order.amend: 請參閱修改訂單參數
  • order.cancel: 請參閱撤銷訂單參數

    • 響應參數​

    參數類型說明
    reqIdstring
  • 若請求有傳, 則響應存在該字段
  • 若請求不傳, 則響應沒有該字段
    • retCodeinteger
  • 0: 成功
  • 10404: 1. op類型未找到; 2. category不支持/未找到
  • 10429: 觸發系統級別的頻率保護
  • 20006: reqId重複
  • 10016: 1.內部錯誤; 2. 服務重啟
  • 10019: ws下單服務正在重啟, 拒絕新的請求, 正在處理中的請求不受影響. 您可以重新/新建連接, 會分配到正常的服務上
    • retMsgstring
  • OK
  • ""
  • 報錯信息
    • opstringOp類型
    dataobject業務數據, 和rest api響應的result字段業務數據一致
  • order.create: 請參閱創建訂單響應參數
  • order.amend: 請參閱修改訂單響應參數
  • order.cancel: 請參閱取消訂單響應參數
    • headerobject響應頭信息
    > TraceIdstringTrace ID, 用於追蹤請求鏈路 (內部使用)
    > Timenowstring當前時間戳
    > X-Bapi-Limitstring該類型請求的帳戶總頻率
    > X-Bapi-Limit-Statusstring該類型請求的帳戶剩餘可用頻率
    > X-Bapi-Limit-Reset-Timestampstring如果您已超過該接口當前窗口頻率限製，該字段表示下個可用時間窗口的時間戳（毫秒）即什麽時候可以恢復訪問；如果您未超過該接口當前窗口頻率限製，該字段表示返回的是當前服務器時間（毫秒).
    connIdstring連接的唯一id
    信息

    ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

    請求示例​

    {
        "reqId": "test-005",
        "header": {
            "X-BAPI-TIMESTAMP": "1711001595207",
            "X-BAPI-RECV-WINDOW": "8000",
            "Referer": "bot-001" // for api broker
        },
        "op": "order.create",
        "args": [
            {
                "symbol": "ETHUSDT",
                "side": "Buy",
                "orderType": "Limit",
                "qty": "0.2",
                "price": "2800",
                "category": "linear",
                "timeInForce": "PostOnly"
            }
        ]
    }

    響應示例​

    {
        "reqId": "test-005",
        "retCode": 0,
        "retMsg": "OK",
        "op": "order.create",
        "data": {
            "orderId": "a4c1718e-fe53-4659-a118-1f6ecce04ad9",
            "orderLinkId": ""
        },
        "header": {
            "X-Bapi-Limit": "10",
            "X-Bapi-Limit-Status": "9",
            "X-Bapi-Limit-Reset-Timestamp": "1711001595208",
            "Traceid": "38b7977b430f9bd228f4b19724794dfd",
            "Timenow": "1711001595209"
        },
        "connId": "cnt5leec0hvan15eukcg-2v"
    }

    Ping​

    請求參數​

    參數是否必需類型說明
    optruestringOp類型. ping

    響應參數​

    參數類型說明
    retCodeinteger響應碼
    retMsgstring響應信息
    opstringOp類型 pong
    dataarray數組會有有一個元素, 當前時間戳 (字符串類型)
    connIdstring連接的唯一id

    請求示例​

    {
        "op": "ping"
    }

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "op": "pong",
        "data": [
            "1711002002529"
        ],
        "connId": "cnt5leec0hvan15eukcg-2v"
    }
    - + \ No newline at end of file diff --git a/zh-TW/v5/ws/connect.html b/zh-TW/v5/ws/connect.html index 669717aee6..6d8c12313f 100644 --- a/zh-TW/v5/ws/connect.html +++ b/zh-TW/v5/ws/connect.html @@ -4,7 +4,7 @@ 訂閱WebSocket | Bybit API Documentation - + @@ -22,7 +22,7 @@ wss://stream-testnet.bybit.com/v5/private

    WebSocket交易:

    • 主網:
      wss://stream.bybit.com/v5/trade

    • 測試網:
      wss://stream-testnet.bybit.com/v5/trade

    自定義私有連接存活時長

    針對私有頻道和交易, 您可以自定義連接存活時長, 通過增加參數max_active_time, 最小支持30s (30秒), 最大支持600s (10分鐘). 如果您需要按分鐘級別配置, 您也可以傳遞1m, 2m等. 例如, wss://stream-testnet.bybit.com/v5/private?max_active_time=1m.

    一般來說, 當客戶端與服務端沒有上下行數據, 包括心跳和交易數據下發, 那麼該連接會在最後一條交互後維持10分鐘, 由服務端斷開. 當您由特別的需求時, 可以通過該字段max_active_time自行控制存活時間.

    由於系統每30秒掃描一次, 因此配置的時長可能無法非常精確, 換句話說, 如果您配置了45秒, 然後最後一條數據下發或者心跳發生在2023-08-15 17:27:23, 您的私有連接可能在2023-08-15 17:28:15發生斷連.

    鑒權​

    信息
    公共頻道不需要鑒權，以下部分僅適用於私有頻道的訂閱。

    構建連接時，創建鑒權請求。

    注意: 如果您正在使用pybit, bybit-api或者其他第三方庫, 您可以忽略此項-因為鑒權已經內建。

    {
        "req_id": "10001", // 可選項
        "op": "auth",
        "args": [
            "api_key",
            1662350400000, //過期時間應當大於當前時間戳
            "singature"
        ]
    }
    # based on: https://github.com/bybit-exchange/pybit/blob/master/pybit/_http_manager.py

    import hmac
    import json
    import time
    import websocket

    api_key = ""
    api_secret = ""

    # Generate expires.
    expires = int((time.time() + 1) * 1000)

    # Generate signature.
    signature = str(hmac.new(
        bytes(api_secret, "utf-8"),
        bytes(f"GET/realtime{expires}", "utf-8"), digestmod="sha256"
    ).hexdigest())

    ws = websocket.WebSocketApp(
        url=url,
        ...
    )

    # Authenticate with API.
    ws.send(
        json.dumps({
            "op": "auth",
            "args": [api_key, expires, signature]
        })
    )

    鑒權成功的響應示例

    {
        "success": true,
        "ret_msg": "",
        "op": "auth",
        "conn_id": "cejreaspqfh3sjdnldmg-p"
    }
    備註

    簽名生成的示例可以參考這裡。

    警告

    由於網絡的複雜性，您可能隨時遇到斷連。請參考以下建議確保您能即時接收到推送：

    1. 通過發送心跳來維持連接;
    2. 遇到斷連時，立即重新連接。

    IP限頻​

    • 不要嘗試頻繁地構建連接與斷開連接；
    • 不要在5分鐘內構建超過500個連接。

    公有頻道訂閱參數限制​

    不管是期貨、現貨、期權, 對於單個連接, args裡的數組元素長度總和不能超過21,000個字符

    • 現貨每次向單一連接僅能發送不超過10個參數的訂閱請求，但單個連接沒有args訂閱限制
    • 期權單個連接，至多訂閱2000個args
    • 期貨單個連接沒有args限制

    如何發送心跳​

    // req_id is a customised id, which is optional
    ws.send(JSON.stringify({"req_id": "100001", "op": "ping"}));

    公共頻道接收到pong的響應示例

    {
        "success": true,
        "ret_msg": "pong",
        "conn_id": "0970e817-426e-429a-a679-ff7f55e0b16a",
        "op": "ping"
    }

    私有頻道接收到pong的響應示例

    {
        "req_id": "test",
        "op": "pong",
        "args": [
            "1675418560633"
        ],
        "conn_id": "cfcb4ocsvfriu23r3er0-1b"
    }
    警告

    為了維持連接，我們推薦您每20秒發送一次心跳。

    如何訂閱topic​

    理解Websocket裡的args​

    通過傳入args來訂閱指定topic

    // 訂閱1檔的orderbook
    {
        "req_id": "test", // 可選
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT"
        ]
    }

    通過逗號隔開，可以同時訂閱多個topic或者多個symbol

    {
        "req_id": "test", // 可選
        "op": "subscribe",
        "args": [
            "orderbook.1.BTCUSDT",
            "publicTrade.BTCUSDT",
            "orderbook.1.ETHUSDT"
        ]
    }

    理解如何取消訂閱​

    您可以通過發送請求來動態地停止訂閱:

    {
        "op": "unsubscribe",
        "args": [
            "publicTrade.ETHUSD"
        ],
        "req_id": "customised_id"
    }

    理解訂閱的響應​

    訂閱成功後的響應示例

    {
        "success": true,
        "ret_msg": "",
        "op": "subscribe",
        "conn_id": "cejreassvfrsfvb9v1a0-2m"
    }
    - + \ No newline at end of file