> For the complete documentation index, see [llms.txt](https://abcc-docs.gitbook.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://abcc-docs.gitbook.io/api/spot-trade/new-order.md).

# New Order

## Place Order

<mark style="color:green;">`POST`</mark> `https://api.abcc.com/api/v1/exchange/orders`

#### Request Body

| Name         | Type   | Description                                                |
| ------------ | ------ | ---------------------------------------------------------- |
| volume       | string | Entrusted amount                                           |
| price        | string | ONLY limit order                                           |
| ord\_type    | string | limit (Limit order) market (Market order)                  |
| side         | string | buy/sell                                                   |
| market\_code | string |                                                            |
| signature    | string |                                                            |
| tonce        | number | Timestamp of the current time in milliseconds (Unix epoch) |
| access\_key  | string |                                                            |

{% tabs %}
{% tab title="200 Data successfully retrieved." %}

```
{
	"order": {
		"id": 4936600,
		"created_at": "2021-08-12T08:09:44Z",
		"market_code": "btcusdt",
		"side": "buy",
		"state": "wait",
		"ord_type": "market",
		"price": null,
		"avg_price": "0.0",
		"volume": "1.816298",
		"remaining_volume": "1.816298",
		"executed_volume": "0.0",
		"trades_count": 0
	}
}
```

{% endtab %}
{% endtabs %}

**OUTPUT EXPLANATION**

| Parameter         | Type    | Explanation                            |
| ----------------- | ------- | -------------------------------------- |
| id                | Integer | ID                                     |
| created\_at       | String  | order time                             |
| market\_code      | String  | The only code for the market           |
| side              | String  | Buy and sell type                      |
| state             | String  | status                                 |
| ord\_type         | String  | Order type                             |
| price             | String  | Order price                            |
| avg\_price        | String  | The average price of transactions      |
| volume            | String  | initial pending order volume           |
| remaining\_volume | String  | The remaining amount of pending orders |
| executed\_volume  | String  | Executed pending order volume          |
| trades\_count     | Integer | Number of transactions                 |

HTTP ERROR

| HTTP Code | Code  | Message                                  | Reason | Explanation            |
| --------- | ----- | ---------------------------------------- | ------ | ---------------------- |
| 404       | 12001 | market not found: params\[:market\_code] | empty  | Market pair not found  |
| 400       | 12002 | Failed to create order                   | reason | Failed to create order |