> 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-a-single-symbol.md).

# Get a Single Symbol

Returns a single symbol by its pair id. Returns `404` if the symbol does not exist or your client profile is not enabled to trade it.

<mark style="color:blue;">`GET`</mark> `https://api.aquanow.io/users/v2/symbols/{symbol}`

See response example for the information expected to be retrieved.

#### Path Parameters

<table><thead><tr><th>Name</th><th width="209">Type</th><th>Description</th></tr></thead><tbody><tr><td>symbol</td><td>String</td><td>The symbol (trading pair) such as BTC-USDT, ETH-USD. If not provided, fetches all assets matching the filter. </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>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 Single Symbol" %}

```json
{
    "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"
        }
    ]
}
```

{% 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 %}