bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 42쪽 중 35쪽
d:**
```
{
"e":"ORDER_TRADE_UPDATE", // Event Type
"E":1568879465651, // Event Time
"T":1568879465650, // Transaction Time
"o":{
"s":"BTCUSDT", // Symbol
"c":"TEST", // Client Order Id
// special client order id:
// starts with "autoclose-": liquidation order
// "adl_autoclose": ADL auto close order
"S":"SELL", // Side
"o":"TRAILING_STOP_MARKET", // Order Type
"f":"GTC", // Time in Force
"q":"0.001", // Original Quantity
"p":"0", // Original Price
"ap":"0", // Average Price
"sp":"7103.04", // Stop Price. Please ignore with TRAILING_STOP_MARKET order
"x":"NEW", // Execution Type
"X":"NEW", // Order Status
"i":8886774, // Order Id
"l":"0", // Order Last Filled Quantity
"z":"0", // Order Filled Accumulated Quantity
"L":"0", // Last Filled Price
"N":"USDT", // Commission Asset, will not push if no commission
"n":"0", // Commission, will not push if no commission
"T":1568879465651, // Order Trade Time
"t":0, // Trade Id
"b":"0", // Bids Notional
"a":"9.91", // Ask Notional
"m":false, // Is this trade the maker side?
"R":false, // Is this reduce only
"wt":"CONTRACT_PRICE", // Stop Price Working Type
"ot":"TRAILING_STOP_MARKET", // Original Order Type
"ps":"LONG", // Position Side
"cp":false, // If Close-All, pushed with conditional order
"AP":"7476.89", // Activation Price, only puhed with TRAILING_STOP_MARKET order
"cr":"5.0", // Callback Rate, only puhed with TRAILING_STOP_MARKET order
"rp":"0" // Realized Profit of the trade
}
}
```
When new order created, order status changed will push such event. event type is `ORDER_TRADE_UPDATE`.
**Side**
* BUY
* SELL
**Order Type**
* MARKET
* LIMIT
* STOP
* TAKE\_PROFIT
* LIQUIDATION
**Execution Type**
* NEW
* CANCELED
* CALCULATED - Liquidation Execution
* EXPIRED
* TRADE
**Order Status**
* NEW
* PARTIALLY\_FILLED
* FILLED
* CANCELED
* EXPIRED
* NEW\_INSURANCE - Liquidation with Insurance Fund
* NEW\_ADL - Counterparty Liquidation\`
**Time in force**
* GTC
* IOC
* FOK
* GTX
**Working Type**
* MARK\_PRICE
* CONTRACT\_PRICE
### Event: Account Configuration Update previous Leverage Update
> **Payload:**
```
{
"e":"ACCOUNT_CONFIG_UPDATE", // Event Type
"E":1611646737479, // Event Time
"T":1611646737476, // Transaction Time
"ac":{
"s":"BTCUSDT", // symbol
"l":25 // leverage
}
}
```
> **Or**
```
{
"e":"ACCOUNT_CONFIG_UPDATE", // Event Type
"E":1611646737479, // Event Time
"T":1611646737476, // Transaction Time
"ai":{ // User's Account Configuration
"j":true // Multi-Assets Mode
}
}
```
When the account configuration is changed, the event type will be pushed as `ACCOUNT_CONFIG_UPDATE`
When the leverage of a trade pair changes, the payload will contain the object `ac` to represent the account configuration of the trade pair, where `s` represents the specific trade pair and `l` represents the leverage
When the user Multi-Assets margin mode changes the payload will contain the object `ai` representing the user account configuration, where `j` represents the user Multi-Assets margin mode
## Error Codes
> Here is the error JSON payload:
```
{
"code":-1121,
"msg":"Invalid symbol."
}
```
Errors consist of two parts: an error code and a message.\
Codes are universal,but messages can vary.
### 10xx - General Server or Network issues
> -1000 UNKNOWN
* An unknown error occured while processing the request.
> -1001 DISCONNECTED
* Internal error; unable to process your request. Please try again.
> -1002 UNAUTHORIZED
* You are not authorized to execute this request.
> -1003 TOO\_MANY\_REQUESTS
* Too many requests queued.
* Too many requests; please use the websocket for live updates.
* Too many requests; current limit is %s requests per minute. Please use the websocket for live updates to avoid polling the API.
* Way too many requests; IP banned until %s. Please use the websocket for live updates to avoid bans.
> -1004 DUPLICATE\_IP
* This IP is already on the white list
> -1005 NO\_SUCH\_IP
* No such IP has been white listed
> -1006 UNEXPECTED\_RESP
* An unexpected response was received from the message bus. Execution status unknown.
> -1007 TIMEOUT
* Timeout waiting for response from backend server. Send status unknown; execution status unknown.
> -1010 ERROR\_MSG\_RECEIVED
* ERROR\_MSG\_RECEIVED.
> -1011 NON\_WHITE\_LIST
* This IP cannot access this route.
> -1013 INVALID\_MESSAGE
* INVALID\_MESSAGE.
> -1014 UNKNOWN\_ORDER\_COMPOSITION
* Unsupported order combination.
> -1015 TOO\_MANY\_ORDERS
* Too many new orders.
* Too many new orders; current limit is %s orders per %s.
> -1016 SERVICE\_SHUTTING\_DOWN
* This service is no longer available.
> -1020 UNSUPPORTED\_OPERATION
* This operation is not supported.
> -1021 INVALID\_TIMESTAMP
* Timestamp for this request is outside of the recvWindow.
* Timestamp for this request was 1000ms ahead of the server's time.
> -1022 INVALID\_SIGNATURE
* Signature for this request is not valid.
> -1023 START\_TIME\_GREATER\_THAN\_END\_TIME
* Start time is greater than end time.
### 11xx - Request issues
> -1100 ILLEGAL\_CHARS
* Illegal characters found in a parameter.
* Illegal characters found in parameter '%s'; legal range is '%s'.
> -1101 TOO\_MANY\_PARAMETERS
* Too many parameters sent for this endpoint.
* Too many parameters; expected '%s' and received '%s'.
* Duplicate values for a parameter detected.
> -1102 MANDATORY\_PARAM\_EMPTY\_OR\_MALFORMED
* A mandatory parameter was not sent, was empty/null, or malformed.
* Mandatory parameter '%s' was not sent, was empty/null, or malformed.
* Param '%s' or '%s' must be sent, but both were empty/null!
> -1103 UNKNOWN\_PARAM
* An unknown parameter was sent.
> -1104 UNREAD\_PARAMETERS
* Not all sent parameters were read.
* Not all sent parameters were read; read '%s' parameter(s) but was sent '%s'.
> -1105 PARAM\_EMPTY
* A parameter was empty.
* Parameter '%s' was empty.
> -1106 PARAM\_NOT\_REQUIRED
* A parameter was sent when not required.
* Parameter '%s' sent when not required.
> -1108 BAD\_ASSET
* Invalid asset.
> -1109 BAD\_ACCOUNT
* Invalid account.
> -1110 BAD\_INSTRUMENT\_TYPE
* Invalid symbolType.
> -1111 BAD\_PRECISION
* Precision is over the maximum defined for this asset.
> -1112 NO\_DEPTH
* No orders on book for symbol.
> -1113 WITHDRAW\_NOT\_NEGATIVE
* Withdrawal amount must be negative.
> -1114 TIF\_NOT\_REQUIRED
* TimeInForce parameter sent when not required.
> -1115 INVALID\_TIF
* Invalid timeInForce.
> -1116 INVALID\_ORDER\_TYPE
* Invalid orderType.
> -1117 INVALID\_SIDE
* Invalid side.
> -1118 EMPTY\_NEW\_CL\_ORD\_ID
* New client order ID was empty.
> -1119 EMPTY\_ORG\_CL\_ORD\_ID
* Original client order ID was empty.
> -1120 BAD\_INTERVAL
* Invalid interval.
> -1121 BAD\_SYMBOL
* Invalid symbol.
> -1125 INVALID\_LISTEN\_KEY
* This listenKey does not exist.
> -1127 MORE\_THAN\_XX\_HOURS
* Lookup interval is too big.
* More than %s hours between startTime and endTime.
> -1128 OPTIONAL\_PARAMS\_BAD\_COMBO
* Combination of optional parameters invalid.
> -1130 INVALID\_PARAMETER
* Invalid data sent for a parameter.
* Data sent for parameter '%s' is not valid.
> -1136 INVALID\_NEW\_ORDER\_RESP\_TYPE
* Invalid newOrderRespType.
### 20xx - Processing Issues
> -2010 NEW\_ORDER\_REJECTED
* NEW\_ORDER\_REJECTED
> -2011 CANCEL\_REJECTED
* CANCEL\_REJECTED
> -2013 NO\_SUCH\_ORDER
* Order does not exist.
> -2014 BAD\_API\_KEY\_FMT
* API-key format invalid.
> -2015 REJECTED\_MBX\_KEY
* Invalid API-key, IP, or permissions for action.
> -2016 NO\_TRADING\_WINDOW
* No trading window could be found for the symbol. Try ticker/24hrs instead.
> -2018 BALANCE\_NOT\_SUFFICIENT
* Balance is insufficient.
> -2019 MARGIN\_NOT\_SUFFICIEN
* Margin is insufficient.
> -2020 UNABLE\_TO\_FILL
* Unable to fill.
> -2021 ORDER\_WOULD\_IMMEDIATELY\_TRIGGER
* Order would immediately trigger.
> -2022 REDUCE\_ONLY\_REJECT
* ReduceOnly Order is rejected.
> -2023 USER\_IN\_LIQUIDATION
* User in liquidation mode now.
> -2024 POSITION\_NOT\_SUFFICIENT
* Position is not sufficient.
> -2025 MAX\_OPEN\_ORDER\_EXCEEDED
* Reach max open order limit.
> -2026 REDUCE\_ONLY\_ORDER\_TYPE\_NOT\_SUPPORTED
* This OrderType is not supported when reduceOnly.
> -2027 MAX\_LEVERAGE\_RATIO
* Exceeded the maximum allowable position at current leverage.
> -2028 MIN\_LEVERAGE\_RATIO
* Leverage is smaller than permitted: insufficient margin balance.
### 40xx - Filters and other Issues
> -4000 INVALID\_ORDER\_STATUS
* Invalid order status.
> -4001 PRICE\_LESS\_THAN\_ZERO
* Price less than 0.
> -4002 PRICE\_GREATER\_THAN\_MAX\_PRICE
* Price greater than max price.
> -4003 QTY\_LESS\_THAN\_ZERO
* Quantity less than zero.
> -4004 QTY\_LESS\_THAN\_MIN\_QTY
* Quantity less than min quantity.
> -4005 QTY\_GREATER\_THAN\_MAX\_QTY
* Quantity greater than max quantity.
> -4006 STOP\_PRICE\_LESS\_THAN\_ZERO
* Stop price less than zero.
> -4007 STOP\_PRICE\_GREATER\_THAN\_MAX\_PRICE
* Stop price greater than max price.
> -4008 TICK\_SIZE\_LESS\_THAN\_ZERO
* Tick size less than zero.
> -4009 MAX\_PRICE\_LESS\_THAN\_MIN\_PRICE
* Max price less than min price.
> -4010 MAX\_QTY\_LESS\_THAN\_MIN\_QTY
* Max qty less than min qty.
> -4011 STEP\_SIZE\_LESS\_THAN\_ZERO
* Step size less than zero.
> -4012 MAX\_NUM\_ORDERS\_LESS\_THAN\_ZERO
* Max mum orders less than zero.
> -4013 PRICE\_LESS\_THAN\_MIN\_PRICE
* Price less than min price.
> -4014 PRICE\_NOT\_INCREASED\_BY\_TICK\_SIZE
* Price not increased by tick size.
> -4015 INVALID\_CL\_ORD\_ID\_LEN
* Client order id is not valid.
* Client order id length should not be more than 36 chars
> -4016 PRICE\_HIGHTER\_THAN\_MULTIPLIER\_UP
* Price is higher than mark price multiplier cap.
> -4017 MULTIPLIER\_UP\_LESS\_THAN\_ZERO
* Multiplier up less than zero.
> -4018 MULTIPLIER\_DOWN\_LESS\_THAN\_ZERO
* Multiplier down less than zero.
> -4019 COMPOSITE\_SCALE\_OVERFLOW
* Composite scale too large.
> -4020 TARGET\_STRATEGY\_INVALID
* Target strategy invalid for orderType '%s',reduceOnly '%b'.
> -4021 INVALID\_DEPTH\_LIMIT
* Invalid depth limit.
* '%s' is not valid depth limit.
> -4022 WRONG\_MARKET\_STATUS
* market status sent is not valid.
> -4023 QTY\_NOT\_INCREASED\_BY\_STEP\_SIZE
* Qty not increased by step size.
> -4024 PRICE\_LOWER\_THAN\_MULTIPLIER\_DOWN
* Price is lower than mark price multiplier floor.
> -4025 MULTIPLIER\_DECIMAL\_LESS\_THAN\_ZERO
* Multiplier decimal less than zero.
> -4026 COMMISSION\_INVALID
* Commission invalid.
* `%s` less than zero.
* `%s` absolute value greater than `%s`
> -4027 INVALID\_ACCOUNT\_TYPE
* Invalid account type.
> -4028 INVALID\_LEVERAGE
* Invalid leverage
* Leverage `%s` is not valid
* Leverage `%s` already exist with `%s`
> -4029 INVALID\_TICK\_SIZE\_PRECISION
* Tick size precision is invalid.
> -4030 INVALID\_STEP\_SIZE\_PRECISION
* Step size precision is invalid.
> -4031 INVALID\_WORKING\_TYPE
* Invalid parameter working type
* Invalid parameter working type: `%s`
> -4032 EXCEED\_MAX\_CANCEL\_ORDER\_SIZE
* Exceed maximum cancel order size.
* Invalid parameter working type: `%s`
> -4033 INSURANCE\_ACCOUNT\_NOT\_FOUND
* Insurance account not found.
> -4044 INVALID\_BALANCE\_TYPE
* Balance Type is invalid.
> -4045 MAX\_STOP\_ORDER\_EXCEEDED
* Reach max stop order limit.
> -4046 NO\_NEED\_TO\_CHANGE\_MARGIN\_TYPE
* No need to change margin type.
> -4047 THERE\_EXISTS\_OPEN\_ORDERS
* Margin type cannot be changed if there exists open orders.
> -4048 THERE\_EXISTS\_QUANTITY
* Margin type cannot be changed if there exists position.
> -4049 ADD\_ISOLATED\_MARGIN\_REJECT
* Add margin only support for isolated position.
> -4050 CROSS\_BALANCE\_INSUFFICIENT
* Cross balance insufficient.
> -4051 ISOLATED\_BALANCE\_INSUFFICIENT
* Isolated balance insufficient.
> -4052 NO\_NEED\_TO\_CHANGE\_AUTO\_ADD\_MARGIN
* No need to change auto add margin.
> -4053 AUTO\_ADD\_CROSSED\_MARGIN\_REJECT
* Auto add margin only support for isolated position.
> -4054 ADD\_ISOLATED\_MARGIN\_NO\_POSITION\_REJECT
* Cannot add position margin: position is 0.
> -4055 AMOUNT\_MUST\_BE\_POSITIVE
* Amount must be positive.
> -4056 INVALID\_API\_KEY\_TYPE
* Invalid api key type.
> -4057 INVALID\_RSA\_PUBLIC\_KEY
* Invalid api public key
> -4058 MAX\_PRICE\_TOO\_LARGE
* maxPrice and priceDecimal too large,please check.
> -4059 NO\_NEED\_TO\_CHANGE\_POSITION\_SIDE
* No need to change position side.
> -4060 INVALID\_POSITION\_SIDE
* Invalid position side.
> -4061 POSITION\_SIDE\_NOT\_MATCH
* Order's position side does not match user's setting.
> -4062 REDUCE\_ONLY\_CONFLICT
* Invalid or improper reduceOnly value.
> -4063 INVALID\_OPTIONS\_REQUEST\_TYPE
* Invalid options request type
> -4064 INVALID\_OPTIONS\_TIME\_FRAME
* Invalid options time frame
> -4065 INVALID\_OPTIONS\_AMOUNT
* Invalid options amount
> -4066 INVALID\_OPTIONS\_EVENT\_TYPE
* Invalid options event type
> -4067 POSITION\_SIDE\_CHANGE\_EXISTS\_OPEN\_ORDERS
* Position side cannot be changed if there exists open orders.
> -4068 POSITION\_SIDE\_CHANGE\_EXISTS\_QUANTITY
* Position side cannot be changed if there exists position.
> -4069 INVALID\_OPTIONS\_PREMIUM\_FEE
* Invalid options premium fee
> -4070 INVALID\_CL\_OPTIONS\_ID\_LEN
* Client options id is not valid.
* Client options id length should be less than 32 chars
> -4071 INVALID\_OPTIONS\_DIRECTION
* Invalid options direction
> -4072 OPTIONS\_PREMIUM\_NOT\_UPDATE
* premium fee is not updated, reject order
> -4073 OPTIONS\_PREMIUM\_INPUT\_LESS\_THAN\_ZERO
* input premium fee is less than 0, reject order
> -4074 OPTIONS\_AMOUNT\_BIGGER\_THAN\_UPPER
* Order amount is bigger than upper boundary or less than 0, reject order
> -4075 OPTIONS\_PREMIUM\_OUTPUT\_ZERO
* output premium fee is less than 0, reject order
> -4076 OPTIONS\_PREMIUM\_TOO\_DIFF
* original fee is too much higher than last fee
> -4077 OPTIONS\_PREMIUM\_REACH\_LIMIT
* place order amount has reached to limit, reject order
> -4078 OPTIONS\_COMMON\_ERROR
* options internal error
> -4079 INVALID\_OPTIONS\_ID
* invalid options id
* invalid options id: %s
* duplicate options id %d for user %d
> -4080 OPTIONS\_USER\_NOT\_FOUND
* user not found
* user not found with id: %s
> -4081 OPTIONS\_NOT\_FOUND
* options not found
* options not found with id: %s
> -4082 INVALID\_BATCH\_PLACE\_ORDER\_SIZE
* Invalid number of batch place orders.
* Invalid number of batch place orders: %s
> -4083 PLACE\_BATCH\_ORDERS\_FAIL
* Fail to place batch orders.
> -4084 UPCOMING\_METHOD
* Method is not allowed currently. Upcoming soon.
> -4085 INVALID\_NOTIONAL\_LIMIT\_COEF
* Invalid notional limit coefficient
> -4086 INVALID\_PRICE\_SPREAD\_THRESHOLD
* Invalid price spread threshold
> -4087 REDUCE\_ONLY\_ORDER\_PERMISSION
* User can only place reduce only order
> -4088 NO\_PLACE\_ORDER\_PERMISSION
* User can not place order currently
> -4104 INVALID\_CONTRACT\_TYPE
* Invalid contract type
> -4114 INVALID\_CLIENT\_TRAN\_ID\_LEN
* clientTranId is not valid
* Client tran id length should be less than 64 chars
> -4115 DUPLICATED\_CLIENT\_TRAN\_ID
* clientTranId is duplicated
* Client tran id should be unique within 7 days
> -4118 REDUCE\_ONLY\_MARGIN\_CHECK\_FAILED
* ReduceOnly Order Failed. Please check your existing position and open orders
> -4131 MARKET\_ORDER\_REJECT
* The counterparty's best price does not meet the PERCENT\_PRICE filter limit
> -4135 INVALID\_ACTIVATION\_PRICE
* Invalid activation price
> -4137 QUANTITY\_EXISTS\_WITH\_CLOSE\_POSITION
* Quantity must be zero with closePosition equals true
> -4138 REDUCE\_ONLY\_MUST\_BE\_TRUE
* Reduce only must be true with closePosition equals true
> -4139 ORDER\_TYPE\_CANNOT\_BE\_MKT
* Order type can not be market if it's unable to cancel
> -4140 INVALID\_OPENING\_POSITION\_STATUS
* Invalid symbol status for opening position
> -4141 SYMBOL\_ALREADY\_CLOSED
* Symbol is closed
> -4142 STRATEGY\_INVALID\_TRIGGER\_PRICE
* REJECT: take profit or stop order will be triggered immediately
> -4144 INVALID\_PAIR
* Invalid pair
> -4161 ISOLATED\_LEVERAGE\_REJECT\_WITH\_POSITION
* Leverage reduction is not supported in Isolated Margin Mode with open positions
> -4164 MIN\_NOTIONAL
* Order's notional must be no smaller than 5.0 (unless you choose reduce only)
* Order's notional must be no smaller than %s (unless you choose reduce only)
> -4165 INVALID\_TIME\_INTERVAL
* Invalid time interval
* Maximum time interval is %s days
> -4183 PRICE\_HIGHTER\_THAN\_STOP\_MULTIPLIER\_UP
* Price is higher than stop price multiplier cap.
* Limit price can't be higher than %s.
> -4184 PRICE\_LOWER\_THAN\_STOP\_MULTIPLIER\_DOWN
* Price is lower than stop price multiplier floor.
* Limit price can't be lower than %s.
# Official Links
* **Official website** – [asterdex.com](https://www.asterdex.com)
* **Twitter (X)** – [@Aster\_DEX](https://x.com/Aster_DEX)
* **Telegram** – [t.me/AsterDex](https://t.me/AsterDEX)
* **Discord** – <http://discord.gg/invite/asterdefi>
* **Medium blog** – [medium.com/asterdex](https://medium.com/asterdex)
# Media Kit
### **About Aster**
#### **Short Description**
Aster is a privacy-first perpetual futures exchange where your positions, orders and trading activity stay hidden from other market participants.
#### **Longer Description**
Aster is a privacy-first perpetual futures exchange backed by YZi Labs, featuring innovations like Hidden Orders to shield user trading activity. It offers perpetual contracts across crypto, stocks and commodities, as well as crypto spot trading, and is powered by Aster Chain, a Layer 1 blockchain built to power the future of decentralized finance.
### **Brand Assets**
Logos, wordmarks, and other brand assets are available for download below. Please review the usage guidelines before using them.
#### **Usage Guidelines**
All Aster brand assets are copyrighted. Please get approval from Aster before using them in any materials.
Where possible, link brand assets back to Aster's [official website](https://www.asterdex.com/en) and [X/Twitter](https://x.com/Aster_DEX) account.
Use our brand assets when announcing official partnerships.
**Please don't:**
* Use Aster brand assets to promote your own project without our consent
* Repurpose Aster brand elements (logos, visuals, colours, etc.) for other uses
* Alter, distort, or recolour any Aster logos or brand marks
### **Get in Touch**
For press inquiries, partnership proposals, collaborations, or referral opportunities, contact <marketing@asterdex.com>.
### **Brand Color Codes**
<figure><img src="https://4068247257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWhSHuKmgnGREbVb12PK2%2Fuploads%2FuQ9DziKA4FqGcWot9r23%2F%E6%88%AA%E5%B1%8F2025-04-01%2009.58.32.png?alt=media&token=08ef247a-5e28-43e1-a74f-dd73097fed46" alt=""><figcaption></figcaption></figure>
### **Aster Logo**
<figure><img src="https://4068247257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWhSHuKmgnGREbVb12PK2%2Fuploads%2FYxAQbkeW7cvE0z2CjZze%2Fblack-color.svg?alt=media&token=ef42ae55-e0cb-47eb-9080-021f20133df7" alt="" width="375"><figcaption></figcaption></figure>
<figure><img src="https://4068247257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWhSHuKmgnGREbVb12PK2%2Fuploads%2FFT1OAw7JoGSqJEyRVFW3%2Fblack.svg?alt=media&token=cc4d0031-e6bf-4ec9-9018-75ff950b2106" alt="" width="375"><figcaption></figcaption></figure>
### **Aster Roundel**
<figure><img src="https://4068247257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWhSHuKmgnGREbVb12PK2%2Fuploads%2F4xf1upOftUlLKs8XIGFI%2FAST%20token%20logo.png?alt=media&token=5280536a-3523-4d70-a9eb-c3906fffa1f1" alt=""><figcaption></figcaption></figure>
### **Download Aster Logos (all versions)**
{% file src="/files/wOxUvo2YqMC4NZc프로젝트로 돌아가기
