# Get Price

Returns the latest market quote for an asset, including price, volume, market cap and supply.

_Source: https://beta.taostats.io/docs/api-reference/price/get-price-latest_

_Last reviewed: 2026-09-18_

```http
GET https://api.taostats.io/api/price/latest/v1
```

Requires an API key in the `Authorization` header.

Returns the latest market quote for an asset, including price, volume, market cap and supply. Use the `asset` parameter to select the token symbol.

## Try it

Try this request in the browser on the HTML version of this page, or use the code samples below.

### Examples

Get the current TAO price

```text
https://api.taostats.io/api/price/latest/v1?asset=tao
```

### Code samples

**cURL**

```bash
curl -H "Authorization: <YOUR_API_KEY>" \
  "https://api.taostats.io/api/price/latest/v1?asset=tao"
```

**JavaScript**

```js
const response = await fetch('https://api.taostats.io/api/price/latest/v1?asset=tao', {
  headers: {
    Authorization: '<YOUR_API_KEY>',
  },
});
const data = await response.json();
```

**Python**

```python
import requests

response = requests.get(
    "https://api.taostats.io/api/price/latest/v1?asset=tao",
    headers={"Authorization": "<YOUR_API_KEY>"},
)
data = response.json()
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `asset` | query | `string` | Yes | The asset to be queried. Only 'tao' is supported. |

## Responses

### `200` — Price retrieved successfully

| Field | Type | Required |
| --- | --- | --- |
| `data` | `array` | Yes |
| `data[].circulating_supply` | `string` | Yes |
| `data[].created_at` | `string (date-time)` | Yes |
| `data[].fully_diluted_market_cap` | `string` | Yes |
| `data[].last_updated` | `string (date-time)` | Yes |
| `data[].market_cap` | `string` | Yes |
| `data[].market_cap_dominance` | `string` | Yes |
| `data[].max_supply` | `string` | Yes |
| `data[].name` | `string` | Yes |
| `data[].percent_change_1h` | `string` | Yes |
| `data[].percent_change_24h` | `string` | Yes |
| `data[].percent_change_30d` | `string` | Yes |
| `data[].percent_change_60d` | `string` | Yes |
| `data[].percent_change_7d` | `string` | Yes |
| `data[].percent_change_90d` | `string` | Yes |
| `data[].price` | `string` | Yes |
| `data[].slug` | `string` | Yes |
| `data[].symbol` | `string` | Yes |
| `data[].total_supply` | `string` | Yes |
| `data[].updated_at` | `string (date-time)` | Yes |
| `data[].volume_24h` | `string` | Yes |
| `pagination` | `object` | Yes |
| `pagination.current_page` | `integer (int32)` | Yes |
| `pagination.next_page` | `integer (int32), nullable` |  |
| `pagination.per_page` | `integer (int32)` | Yes |
| `pagination.prev_page` | `integer (int32), nullable` |  |
| `pagination.total_items` | `integer (int32)` | Yes |
| `pagination.total_pages` | `integer (int32)` | Yes |

**Example response**

```json
{
  "data": [
    {
      "circulating_supply": "8398025",
      "created_at": "2025-02-26T13:45:02Z",
      "fully_diluted_market_cap": "7696492573.17",
      "last_updated": "2025-02-26T13:44:00Z",
      "market_cap": "3077873192.46484",
      "market_cap_dominance": "0.1074",
      "max_supply": "21000000",
      "name": "Bittensor",
      "percent_change_1h": "-0.88079436",
      "percent_change_24h": "-0.250314",
      "percent_change_30d": "-14.498297",
      "percent_change_60d": "-21.61015966",
      "percent_change_7d": "-11.00275914",
      "percent_change_90d": "-34.25472829",
      "price": "366.499646341234",
      "slug": "bittensor",
      "symbol": "TAO",
      "total_supply": "8398025",
      "updated_at": "2025-02-26T13:45:02Z",
      "volume_24h": "263821126.141511"
    }
  ],
  "pagination": {
    "current_page": 1,
    "next_page": null,
    "per_page": 1,
    "prev_page": null,
    "total_items": 1,
    "total_pages": 1
  }
}
```

**Response details**

```text
  "created_at": record creation time
  "updated_at": record updated time
  "name": "Bittensor",
  "symbol": "TAO",
  "slug": "bittensor",
  "circulating_supply": tokens in supply,
  "max_supply": max supply,
  "total_supply": total supply,
  "last_updated": "2025-04-28T00:59:00Z",
  "price": price in USD,
  "volume_24h": 24h volumne in USD,
  "market_cap": USD,
  "percent_change_1h": 1 hour change,
  "percent_change_24h": 1 day change,
  "percent_change_7d": 1 week change,
  "percent_change_30d": 1 month change,
  "percent_change_60d": "0.86471986",
  "percent_change_90d": "-18.23971581",
  "market_cap_dominance": ,
  "fully_diluted_market_cap":
```

### Other responses

| Status | Meaning |
| --- | --- |
| `400` | Bad request |
| `404` | Price not found |
| `500` | Internal server error |

Every request needs an `Authorization` header holding your API key — see [Getting started with the Taostats API](https://beta.taostats.io/docs/start-here/getting-started-with-taostats-api).