Skip to main content
POST
/
api
/
v1
/
spotorder
cURL
curl --request POST \
  --url https://apiserver.beratrade.io/api/v1/spotorder \
  --header 'Bliq-Key: <bliq-key>' \
  --header 'Bliq-Secret: <bliq-secret>' \
  --header 'Bliq-Signature: <bliq-signature>' \
  --header 'Bliq-Signer-Address: <bliq-signer-address>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "marketId": 123,
  "isBuy": true,
  "orderType": "LIMIT",
  "amount": "<string>",
  "price": "<string>",
  "expiryTs": 123
}
'
[
  {
    "body": {
      "amount": "<string>",
      "createdAt": "<string>",
      "expiryTs": 123,
      "id": 123,
      "marketSymbol": "<string>",
      "marketType": "<string>",
      "pricex18": "<string>",
      "side": "BUY",
      "status": "CANCELLED",
      "subaccountId": "<string>",
      "totalFilledx18": "<string>",
      "type": "MARKET",
      "updatedAt": "<string>"
    },
    "message": "<string>",
    "status": 123
  }
]

Headers

​
Bliq-Signature
string
required

Signature generated by signing the payload with signingKey

​
Bliq-Signer-Address
string
required

signingKey used to generate the signature

​
Bliq-Key
string
required

bliq_key obtained during authentication

​
Bliq-Secret
string
required

bliq_secret obtained during authentication

Body

application/json
​
marketId
integer<int64>
required

ID of the market you want to trade on. Each Market on beliquid has a unique ID. Users can get the list of active markets and their properties here.

​
isBuy
boolean<boolean>
required

true if user wants to buy the asset and vice versa

​
orderType
enum<string>
required

beliquid currently supports LIMIT and MARKET orders

Available options:
LIMIT,
MARKET
​
amount
string<string>
required

amount of token user wants to trade

​
price
string<string>
required

price at which the order has to be executed. that this value should be 0 for MARKET orders

​
expiryTs
integer<int64>
required

timestamp (in milliseconds) at which the order will expire

Response

Auth Response

​
body
object
required
​
message
string<string>
required
​
status
integer<int64>
required