submit spot order

API details

This API enables placing orders in the spot market, supporting both limit orders and swap orders.

Submit a spot order

post

Body

application/jsontext/jsonapplication/*+json

typestringoptional

userIdstringoptional

noncestringoptional

messagestringoptional

hashstringoptional

signaturestringoptional

Responses

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://testnetopenapi.hibit.app/v1/tx/submit-spot-order' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "text",
    "userId": "text",
    "nonce": "text",
    "message": "text",
    "hash": "text",
    "signature": "text"
  }'

application/jsontext/jsonapplication/*+json

200

400

401

403

404

500

501

200

text/plain

application/json

text/json

text/plain

{
  "code": 1,
  "message": "text",
  "data": {}
}

OK

Code example

Limit order

import { hibitClient } from '@delandlabs/hibit-client';

const options = {
  network: HibitNetwork.Testnet,
  hin: 10000n,
  proxyKey:"your proxy key in hexadecimal (hex) format"
};
hibitClient.setOptions(options);

// get base and quote asset of the market
const baseAsset = ...;
const quoteAsset = ...;

const decimalOptions: DecimalOptions = {
  baseAssetDecimals: Number(baseAsset.decimalPlaces),
  quoteAssetDecimals: Number(quoteAsset.quoteAssetDecimals)
};

const submitLimitOrderReq: SubmitSpotOrderInput = {
  marketId: BigInt(10006n),
  orderCategory: OrderCategory.LimitOrder,
  limitOrderDetails: {
    orderSide: OrderSide.Ask,
    price: 17.32,
    volume: 100.8
  }
};

await client.submitSpotOrder(submitLimitOrderReq, decimalOptions);

Swap order

import { hibitClient } from '@delandlabs/hibit-client';

const options = {
  baseUrl: 'https://testnetopenapi.hibit.app',
  hin: 10000n，
  proxyKey:"your proxy key in hexadecimal (hex) format"
};
hibitClient.setOptions(options);

// get base and quote asset of the market
const baseAsset = ...;
const quoteAsset = ...;

const decimalOptions: DecimalOptions = {
  baseAssetDecimals: Number(baseAsset.decimalPlaces),
  quoteAssetDecimals: Number(quoteAsset.quoteAssetDecimals)
};

const submitSwapOrderReq: SubmitSpotOrderInput = {
  marketId: BigInt(10006n),
  orderCategory: OrderCategory.SwapOrder,
  swapV2OrderDetails: {
    orderSide: OrderSide.Ask,
    exactTokensType: SwapV2ExactTokensType.Source,
    exactTokens: 1000.12,
    minOut: 1000.00
  }
};

await client.submitSpotOrder(submitSwapOrderReq, decimalOptions);

SDK

Source code https://github.com/Deland-Labs/hibit-sdk

References

What is HIN?

How to Obtain your HIN and Proxy Key?