# POST

## Post Order

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

This endpoint allows you to request the detailed state and parameters for a given order.\
\
Returns the order's parameters as well as current order state and initial timestamp.

#### Request Body

| Name                                    | Type   | Description                                                                                                                                                                                                                                             |
| --------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Order<mark style="color:red;">\*</mark> | object | <p>Order object containing:<br>signature: string<br>key: string<br>maker: string<br>underlying: string<br>vault: boolean</p><p>exit: boolean <br>principal: string<br>premium: string<br>maturity: string<br>expiry: string</p><p>protocol: integer</p> |

{% tabs %}
{% tab title="200 Order successfully posted." %}

{% endtab %}

{% tab title="400 E.g. Invalid order principal" %}

```
{
    "error": {
        "message": "order principal"
    }
}
```

{% endtab %}

{% tab title="404 Unable to place order in the provided market." %}

```
{    "message": "Unable to place order in specified market."}
```

{% endtab %}
{% endtabs %}
