Trade API


The Trade api collection has public as well as private api's. The pubic api doesn't require authentication but the private api require Authentication. Please refer authentication section.The standard ratelimit applied for all the market API's.

Order Book


Returns the order book data based on the side(buy/sell) and pair

HTTP Request

POST /api/v1/order/book

Sample Request

POST /api/v1/order/book

Request Payload:

{ 
    "market":"BDXBTC",
    "side":2,
    "offset":0,
    "limit":2
}
Rquest Parameters
Parameters Parameter Type Description
market String Market pair name e.g. BDXBTC
side Integer Side id (1: sell, 2: buy) e.g. 1
offset Integer offset value
limit Integer No of records to be returned
Example Response
{
  "result": {
    "offset": 0,
    "limit": 2,
    "total": 2,
    "orders": [
      {
        "id": 46,
        "market": "BDXBTC",
        "side": 2,
        "deal_stock": "950",
        "source": "Beldex source 1579779060219",
        "price": "0.00001451",
        "type": 1,
        "ctime": 1579779060.253455,
        "mtime": 1579790168.27083,
        "deal_money": "0.01273431",
        "amount": "1000",
        "taker_fee": "0.001",
        "maker_fee": "0.001",
        "left": "50",
        "deal_fee": "0.95"
      },
      {
        "id": 30,
        "market": "BDXBTC",
        "side": 2,
        "deal_stock": "0",
        "source": "Beldex source 1579589867085",
        "price": "0.0000089",
        "type": 1,
        "ctime": 1579589868.432862,
        "mtime": 1579589868.432862,
        "deal_money": "0",
        "amount": "212",
        "taker_fee": "0.001",
        "maker_fee": "0.001",
        "left": "212",
        "deal_fee": "0"
      }
    ]
  }
}

Order Depth


Returns buy and sell records for the given pair

HTTP Request

POST /api/v1/order/depth

Sample Request

POST /api/v1/order/depth

Request Payload:

{ 
    "market":"BDXBTC",
    "limit":10,
    "interval":"1"        
}
Rquest Parameters
Parameters Parameter Type Description
market String Market pair name e.g. BDXBTC
limit Integer Count limit
interval String e.g. "1" for 1 unit interval, "0" for no interval
Example Response
"result": {
    "timestamp":"1579779323527",
    "asks": [
        [
            "8000.00",
            "9.6250"
        ]
    ],
    "bids": [
        [
            "7000.00",
            "0.1000"
        ]
    ]
}

Place Limit Order


Places a limit order for a market pair

This endpoint requires Autentication

HTTP Request

POST /api/v1/order/put-limit

Require Authentication: Yes

Sample Request

POST /api/v1/order/put-limit

Request Payloads:

{
       "market":"BDXBTC",
       "side":1,
       "amount":"200",
       "price":"0.0005",
       "source": "beldex exchange"         
}
Request Parameters
Parameters Parameter Type Description
market String Market pair name e.g. BDXBTC
side Integer Side id (1: sell, 2: buy) e.g. 1
amount String no of asset to be placed
Example Response
{
    "result": {
        "id": 55,
        "market": "BDXBTC",
        "side": 1,
        "deal_stock": "0",
        "source": "Beldex source 1579779222279",
        "price": "0.01",
        "type": 1,
        "ctime": 1579796156.966855,
        "mtime": 1579796156.966855,
        "deal_money": "0",
        "amount": "122",
        "taker_fee": "0.01",
        "maker_fee": "0.0005",
        "left": "122",
        "deal_fee": "0"
    }
}

Place Market Order


Places market order for a market pair.

This endpoint requires Autentication

HTTP Request

POST /api/v1/order/put-market

Require Authentication: Yes

Sample Request

POST /api/v1/order/put-market

Request Payloads:

{  
    "market":"BDXBTC",
    "side":1,
    "amount":"10",
    "source": "source added"               
}
Example Response
{
    "result": "Your order was placed"
}

Order Cancel


Cancels an order for the given order id

This endpoint requires Autentication

HTTP Request

POST /api/v1/order/cancel

Require Authentication: Yes

Sample Request

POST /api/v1/order/cancel

Request Payloads:

{  
    "market":"BDXBTC",
    "order_id":2,       
}
Request Parameters
Parameters Parameter Type Description
market String Market pair name e.g. BDXBTC
order_id Integer Id of an order
Example Response
{
    "result": {
        "id": 2,
        "market": "BDXBTC",
        "side": 1,
        "deal_stock": "0",
        "source": "Beldex source 1579779323527",
        "price": "0.00001452",
        "type": 1,
        "ctime": 1579779323.555277,
        "mtime": 1579779323.555277,
        "deal_money": "0",
        "amount": "100",
        "taker_fee": "0.001",
        "maker_fee": "0.001",
        "left": "100",
        "deal_fee": "0"
    }
}

Pending Order


Returns pending orders for a market pair.

This endpoint requires Autentication

HTTP Request

POST /api/v1/order/pending

Require Authentication: Yes

Sample Request

POST /api/v1/order/pending

Request Payloads:

{  
    "market":"BDXBTC",
    "offset":0,
    "limit":2       
}
Request Parameters
Parameters Parameter Type Description
market String Market pair name e.g. BDXBTC
offset Integer offset value
limit Integer No of records to be returned
Example Response
{
    "result": {
        "limit": 2,
        "offset": 0,
        "total": 2,
        "records": [
            {
                "id": 48,
                "market": "BDXBTC",
                "side": 2,
                "deal_stock": "0",
                "source": "Beldex source 1579779146282",
                "price": "0.00000812",
                "type": 1,
                "ctime": 1579779146.309214,
                "mtime": 1579779146.309214,
                "deal_money": "0",
                "amount": "198",
                "taker_fee": "0.001",
                "maker_fee": "0.001",
                "left": "198",
                "deal_fee": "0"
            },
            {
                "id": 46,
                "market": "BDXBTC",
                "side": 2,
                "deal_stock": "950",
                "source": "Beldex source 1579779060219",
                "price": "0.00001451",
                "type": 1,
                "ctime": 1579779060.253455,
                "mtime": 1579790168.27083,
                "deal_money": "0.01273431",
                "amount": "1000",
                "taker_fee": "0.001",
                "maker_fee": "0.001",
                "left": "50",
                "deal_fee": "0.95"
            }
        ]
    }
}

Pending Order Details


Returns the pending order detail for the given order id and the market pair

HTTP Request

POST /api/v1/order/pending-details

Require Authentication: Yes

Sample Request

POST /api/v1/order/pending-details

Request Payloads:

{  
    "market":"BDXBTC",
    "order_id":1  
}
Request Parameters
Parameters Parameter Type Description
market String Market pair name e.g. BDXBTC
order_id Integer Id of an order
Example Response
{
    "result": {
        "id": 1,
        "market": "BDXBTC",
        "side": 2,
        "deal_stock": "0",
        "source": "Beldex source 1579779146282",
        "price": "0.00000812",
        "type": 1,
        "ctime": 1579779146.309214,
        "mtime": 1579779146.309214,
        "deal_money": "0",
        "amount": "198",
        "taker_fee": "0.001",
        "maker_fee": "0.001",
        "left": "198",
        "deal_fee": "0"
    }
}

Order Deals


Returns the deals for a given order id

HTTP Request

POST /api/v1/order/deals

Require Authentication: Yes

Sample Request

POST /api/v1/order/deals

Request Payloads:

{
    "order_id":1,
    "offset":0,
    "limit":3
}
Request Parameters
Parameters Parameter Type Description
order_id Integer Id of an order
offset Integer offset value
limit Integer No of records to be returned
Example Response
{
    "result": {
        "offset": 0,
        "limit": 3,
        "records": [
            {
                "deal_order_id": 54,
                "time": 1579790168.27083,
                "deal": "0.002902",
                "id": 1,
                "amount": "200",
                "role": 1,
                "fee": "0.2",
                "price": "0.00001451"
            },
            {
                "deal_order_id": 53,
                "time": 1579779382.685042,
                "deal": "0.001451",
                "id": 1,
                "amount": "100",
                "role": 1,
                "fee": "0.1",
                "price": "0.00001451"
            },
            {
                "deal_order_id": 51,
                "time": 1579779222.308005,
                "deal": "0.001451",
                "id": 1,
                "amount": "100",
                "role": 1,
                "fee": "0.1",
                "price": "0.00001451"
            }
        ]
    }
}

Finished Order


Returns the finished order

This endpoint requires Autentication

HTTP Request

POST /api/v1/order/finished

Require Authentication: Yes

Sample Request

POST /api/v1/order/finished

Request Payloads:

{
    "market": "BDXBTC",
    "start_time": 0,
    "end_time": 0,
    "side":1,
    "offset": 0,
    "limit": 1 
}
Request Parameters
Parameters Parameter Type Description
market String Market pair name e.g. BDXBTC
start_time Integer Start time, 0 for unlimited. e.g. 1576750273 (unix format)
end_time Integer End time, 0 for unlimited. e.g. 1577095873 (unix format)
side Integer Side id (1: sell, 2: buy) e.g. 1
offset Integer offset value
limit Integer No of records to be returned
Example Response
{
    "result": {
        "offset": 0,
        "limit": 1,
        "records": [
            {
                "id": 1,
                "ctime": 1579779222.307994,
                "source": "Beldex source 1579779222279",
                "ftime": 1579779222.308005,
                "type": 1,
                "price": "0.00000811",
                "market": "BDXBTC",
                "side": 1,
                "deal_money": "0.001451",
                "amount": "100",
                "taker_fee": "0.001",
                "maker_fee": "0.001",
                "deal_stock": "100",
                "deal_fee": "0.000001451"
            }
        ]
    }
}

Finished Order Details


Returns order details of a finished order

HTTP Request

POST /api/v1/order/finished-details

Require Authentication: Yes

Sample Request

POST /api/v1/order/finished-details

Request Payloads:

{
    "order_id": 1
}
Request Parameters
Parameters Parameter Type Description
order_id Integer Id of an order
Example Response
{
    "result": {
        "id": 1,
        "ctime": 1579779382.685035,
        "source": "Beldex source 1579779382658",
        "ftime": 1579779382.685042,
        "type": 2,
        "price": "0",
        "market": "BDXBTC",
        "side": 1,
        "deal_money": "0.001451",
        "amount": "100",
        "taker_fee": "0.001",
        "maker_fee": "0",
        "deal_stock": "100",
        "deal_fee": "0.000001451"
    }
}

results matching ""

    No results matching ""