Create Limit Order

This method is used to create a Limit Order with the specified parameters. If successful, returns information about the placed order.

Details

POST https://api.earnbit.com/api/v1/order/new

Headers

Name

Type

Description

X-TXC-APIKEY*

STRING

Public API key

X-TXC-PAYLOAD*

STRING

Сonverted Base64 string containing body JSON

X-TXC-SIGNATURE*

STRING

Encrypted HmacSHA512 string containing body JSON with a API secret key

Request Body

Name

Type

Description

Example

market*

STRING

Any public pair

BTC_USDT

price*

STRING

Order price (in 2nd ticker of pair)

60000

amount*

STRING

Order amount (in 1st ticker of pair)

0.1

side*

STRING

sell or buy

buy

request*

STRING

A request path without the domain name

/api/v1/order/new

nonce*

NUMERIC

A 13-character number that must always be greater than the nonce of the previous completed request (we suggest generating a nonce as the UNIX timestamp in milliseconds)

1704070810000

CURL Example

curl --location --request POST 'https://api.earnbit.com/api/v1/order/new' \
--header 'Content-Type: application/json' \
--header 'X-TXC-APIKEY: 0000000000XXXXXXXXXXXXXXXXX' \
--header 'X-TXC-PAYLOAD: 0000000000XXXXXXXXXXXXXXXXX=' \
--header 'X-TXC-SIGNATURE: 0000000000XXXXXXXXXXXXXXXXX' \
--data-raw '{"request":"/api/v1/order/new","market":"BTC_USDT","price":"60000","amount":"0.1","side":"buy","nonce":1704070810000}'

Response parameters:

Name

Type

Description

orderId

NUMERIC

Order ID

market

STRING

Order pair

side

STRING

Order side (buy / sell)

type

STRING

Order type

timestamp

NUMERIC

Order creation time

price

STRING

Order price

dealMoney

STRING

Executed order amount (in 2nd ticker of pair)

dealStock

STRING

Executed order amount (in 1st ticker of pair)

amount

STRING

Order amount (in 1st ticker of pair)

takerFee

STRING

Order taker fee

makerFee

STRING

Order maker fee

left

STRING

Available order amount (if = 0 means finished order)

Response example:

{
    "code": 200,
    "success": true,
    "message": "",
    "result": {
        "orderId": 1040149431,
        "market": "BTC_USDT",
        "side": "buy",
        "type": "limit",
        "timestamp": 1727085860.026000,
        "price": "60000",
        "dealMoney": "0",
        "dealStock": "0",
        "amount": "0.1",
        "takerFee": "0.000425",
        "makerFee": "0.000425",
        "left": "0.1"
    }
}

Response example 1:

{
    "code": 400,
    "success": false,
    "message": "authentication failure",
    "result": []
}

This error occurs in the following cases:

The request was signed incorrectly.
Some of the provided parameters are incorrect.
Provided nonce is incorrect or less than on previous completed request
The base URL or path is incorrect.
The API keys are not activated.

Response example 2:

{
   "code":400,
   "success":false,
   "message":"operation blocked",
   "result":[]
}

This error occurs in the following cases:

Order creation is not available currently for the requested pair.

Response example 3:

{
    "code": 400,
    "success": false,
    "message": "invalid input",
    "result": []
}

This error occurs in the following cases:

One or more body params provided incorrectly
Required body params are not provided

Response example:

{    
    "timestamp": 1704070810000,
    "status": 404,
    "error": "Not Found",
    "message": "",
    "path": "/api/v1/order/test"
}

This error occurs in the following cases:

The request was made with undefined data and the service cannot find the data for response.

PreviousAuthentication and API Keys NextCancel Order

Last updated 9 months ago

hashtagDetails

hashtagHeaders

hashtagRequest Body

Details

Headers

Request Body