> For the complete documentation index, see [llms.txt](https://docs.aquanow.io/aquanow/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aquanow.io/aquanow/api-endpoints-or-v2.0/executions-api/symbols/get-symbols.md).

# Get Symbols

Retrieves the trading symbols (pairs) that your client profile is enabled to trade, along with the trading rules needed to construct and validate orders: price and quantity precision, their increments, and minimum order sizes.

<mark style="color:blue;">`GET`</mark> `https://api.aquanow.io/users/v2/symbols`&#x20;

See response example for the information expected to be retrieved.

### Query parameters

<table><thead><tr><th>Name</th><th width="209">Type</th><th>Description</th></tr></thead><tbody><tr><td>baseAsset</td><td>String</td><td>Optional: base asset filter, such as BTC, ETH</td></tr><tr><td>quoteAsset</td><td>String</td><td>Optional: quote asset filter, such as USD, CAD</td></tr><tr><td>limit</td><td>Number</td><td>Pagination limit</td></tr><tr><td>startsAfter</td><td>String</td><td>Fetch the next set of results after a specific record</td></tr></tbody></table>

#### Headers

| Name                                          | Type   | Description                                                                                                                                                        |
| --------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| x-api-key<mark style="color:red;">\*</mark>   | String | <p><code>{{x-api-key}}</code></p><p>API Auth Key</p>                                                                                                               |
| x-signature<mark style="color:red;">\*</mark> | String | <p><code>49c6260c194f4d7ed5cb917dc70b9821673246b2abc1cf28f05df6a75fd24181e00f8e57b321d15ae45db58b3bffe27a</code></p><p>Signature created using your API secret</p> |
| x-nonce<mark style="color:red;">\*</mark>     | Number | <p><code>1657731573930</code></p><p>Timestamp in millisecond</p>                                                                                                   |

#### Response parameters

<table data-search="false"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>pagination</td><td>String</td><td>Pagination metadata for the response</td></tr><tr><td>pagination.startsAfter</td><td>Object</td><td>Cursor for the next page of results</td></tr><tr><td>pagination.limit</td><td>Number</td><td>Maximum number of records returned</td></tr><tr><td>data</td><td>Array</td><td>List of symbol objects</td></tr><tr><td>data[].symbol</td><td>String</td><td>Trading pair identifier (e.g. <code>BTC-USD</code>)</td></tr><tr><td>data[].baseAsset</td><td>String</td><td>Base asset of the trading pair (e.g. <code>BTC</code>)</td></tr><tr><td>data[].quoteAsset</td><td>String</td><td>Quote asset of the trading pair (e.g. <code>USD</code>)</td></tr><tr><td>data[].pricePrecision</td><td>String</td><td>Number of decimal places for price</td></tr><tr><td>data[].priceIncrement</td><td>String</td><td>Minimum price movement</td></tr><tr><td>data[].baseQuantityPrecision</td><td>String</td><td>Number of decimal places for base quantity</td></tr><tr><td>data[].baseQuantityIncrement</td><td>String</td><td>Minimum base quantity movement</td></tr><tr><td>data[].quoteQuantityPrecision</td><td>String</td><td>Number of decimal places for quote quantity</td></tr><tr><td>data[].quoteQuantityIncrement</td><td>String</td><td>Minimum quote quantity movement</td></tr><tr><td>data[].baseMinSize</td><td>String</td><td>Minimum order size in base asset</td></tr><tr><td>data[].quoteMinSize</td><td>String</td><td>Minimum order size in quote asset</td></tr></tbody></table>

#### Response Examples

{% tabs %}
{% tab title="200: OK Symbols" %}
Returns an array of Assets

```json
{
    "pagination": {
        "startsAfter": "",
        "limit": 1000
    },
    "data": [
        {
            "symbol": "BTC-USD",
            "baseAsset": "BTC",
            "quoteAsset": "USD",
            "pricePrecision": "2",
            "priceIncrement": "0.01",
            "baseQuantityPrecision": "8",
            "baseQuantityIncrement": "0.00000001",
            "quoteQuantityPrecision": "2",
            "quoteQuantityIncrement": "0.01",
            "baseMinSize": "0.000007",
            "quoteMinSize": "1"
        },
         {
            "symbol": "ETH-USD",
            "baseAsset": "ETH",
            "quoteAsset": "USD",
            "pricePrecision": "4",
            "priceIncrement": "0.0001",
            "baseQuantityPrecision": "4",
            "baseQuantityIncrement": "0.0001",
            "quoteQuantityPrecision": "2",
            "quoteQuantityIncrement": "0.01",
            "baseMinSize": "0.000007",
            "quoteMinSize": "1"
        }
    ]
}
```

{% endtab %}

{% tab title="404: Not Found" %}

```json
{
    "errors": [
        {
            "id": "d37dc0fe-3b2a-44e0-b9ff-97873120458a",
            "message": "Symbol \"UKNOWN-USD\" was not found or is not enabled for this client."
        }
    ]
}
```

{% endtab %}

{% tab title="400: Bad Request" %}

```json
{
    "errors": [
        {
            "id": "7232215f-6c81-4d6d-a718-5dc7bebe6ece",
            "message": "Invalid request parameter(s). Supported parameters are baseAsset, quoteAsset, limit and startsAfter."
        }
    ]
}
```

{% endtab %}
{% endtabs %}