# Orders

## Get Orders

<mark style="color:blue;">`GET`</mark> `https://api.vaultoro.com/v1/public/orders`

This endpoint returns all the orders.

#### Query Parameters

| Name          | Type   | Description                                                            |
| ------------- | ------ | ---------------------------------------------------------------------- |
| until         | string | Unix timestamp to filter the results until.                            |
| since         | string | Unix timestamp to filter the results since.                            |
| sortDirection | string | Sort direction for the results. 1 for ascending and -1 for descending. |
| sort          | string | Sort the results by timestamp. Should be createdAt or updatedAt.       |
| limit         | number | Limit the number of results.                                           |
| page          | number | Return a specific page.                                                |
| type          | string | The type of order. Should be BUY or SELL.                              |
| status        | string | The status of the order. Can only be OPEN for the public endpoint.     |
| pair          | string | Filter by available pairs.                                             |
| matchType     | string | Filter the type of order. Currently only LIMIT.                        |

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

```
{
    "data": [
        {
            "createdAt": 1595357756,
            "initialQuantity": 1223,
            "matchType": "LIMIT",
            "pair": "GOLDBTC",
            "quantity": "1198.0000",
            "status": "OPEN",
            "type": "BUY",
            "updatedAt": 1595427428,
            "value": "0.00615450"
        }
    ],
    "pagination": {
        "count": 1
    }
}
```

{% endtab %}
{% endtabs %}

## Get Liquidity

<mark style="color:blue;">`GET`</mark> `https://api.vaultoro.com/v1/public/orders/liquidity`

Returns the current liquidity for a market. Will return FX data if you send in a currency handle.

#### Query Parameters

| Name      | Type   | Description                                                                    |
| --------- | ------ | ------------------------------------------------------------------------------ |
| until     | string | Unix timestamp to filter the results until.                                    |
| since     | string | Unix timestamp to filter the results since.                                    |
| type      | string | The type of order. Should be BUY or SELL.                                      |
| matchType | string | Filter the type of order. Currently only LIMIT.                                |
| fx        | string | Returns the FX data with the request. Must be EURCENT or CENT.                 |
| pair      | string | Enter the pair to filter by. Currently available: DASHBTC, GOLDBTC or GOLDDASH |

{% tabs %}
{% tab title="200 " %}

```
{
    "data": [
        {
            "count": 1,
            "currencyHandle": "EURCENT",
            "currencyValue": "6122",
            "matchType": "LIMIT",
            "pair": "GOLDBTC",
            "price": "0.00061545",
            "quantity": "12.0000",
            "sum": "12.0000",
            "total": "0.0074",
            "type": "BUY"
        },
        {
            "count": 1,
            "currencyHandle": "EURCENT",
            "currencyValue": "5127",
            "matchType": "LIMIT",
            "pair": "GOLDBTC",
            "price": "0.00051545",
            "quantity": "12.0000",
            "sum": "24.0000",
            "total": "0.0062",
            "type": "BUY"
        },
        {
            "count": 1,
            "currencyHandle": "EURCENT",
            "currencyValue": "52370",
            "matchType": "LIMIT",
            "pair": "GOLDBTC",
            "price": "0.00050545",
            "quantity": "125.0000",
            "sum": "149.0000",
            "total": "0.0632",
            "type": "BUY"
        },
        {
            "count": 1,
            "currencyHandle": "EURCENT",
            "currencyValue": "52267",
            "matchType": "LIMIT",
            "pair": "GOLDBTC",
            "price": "0.00050445",
            "quantity": "125.0000",
            "sum": "274.0000",
            "total": "0.0631",
            "type": "BUY"
        },
        {
            "count": 1,
            "currencyHandle": "EURCENT",
            "currencyValue": "5029",
            "matchType": "LIMIT",
            "pair": "GOLDBTC",
            "price": "0.00040445",
            "quantity": "15.0000",
            "sum": "289.0000",
            "total": "0.0061",
            "type": "BUY"
        }
    ]
}

```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.vaultoro.com/public/orders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.