Skip to content
Taostats Docs

Get Price

Endpoint

Section titled “Endpoint”
GET /api/price/latest/v1

Try it

Section titled “Try it”
Fills the fields below — runs automatically if your API key is saved.
Get a free API key →
curl

Parameters

Section titled “Parameters”
NameInTypeRequiredDescription
assetquerystring✅The asset to be queried. Only ‘tao’ is supported.

Responses

Section titled “Responses”

200 — Price retrieved successfully

Section titled “200 — Price retrieved successfully”

Media: application/json

Schema
{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "created_at",
          "updated_at",
          "name",
          "symbol",
          "slug",
          "circulating_supply",
          "max_supply",
          "total_supply",
          "last_updated",
          "price",
          "volume_24h",
          "market_cap",
          "percent_change_1h",
          "percent_change_24h",
          "percent_change_7d",
          "percent_change_30d",
          "percent_change_60d",
          "percent_change_90d",
          "market_cap_dominance",
          "fully_diluted_market_cap"
        ],
        "properties": {
          "circulating_supply": {
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "fully_diluted_market_cap": {
            "type": "string"
          },
          "last_updated": {
            "type": "string",
            "format": "date-time"
          },
          "market_cap": {
            "type": "string"
          },
          "market_cap_dominance": {
            "type": "string"
          },
          "max_supply": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "percent_change_1h": {
            "type": "string"
          },
          "percent_change_24h": {
            "type": "string"
          },
          "percent_change_30d": {
            "type": "string"
          },
          "percent_change_60d": {
            "type": "string"
          },
          "percent_change_7d": {
            "type": "string"
          },
          "percent_change_90d": {
            "type": "string"
          },
          "price": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "total_supply": {
            "type": "string"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "volume_24h": {
            "type": "string"
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "current_page",
        "per_page",
        "total_items",
        "total_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "format": "int32"
        },
        "next_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "per_page": {
          "type": "integer",
          "format": "int32"
        },
        "prev_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "total_items": {
          "type": "integer",
          "format": "int32"
        },
        "total_pages": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}
Examples
{
  "Result": {
    "value": "{\n  \"pagination\": {\n    \"current_page\": 1,\n    \"per_page\": 1,\n    \"total_items\": 1,\n    \"total_pages\": 1,\n    \"next_page\": null,\n    \"prev_page\": null\n  },\n  \"data\": [\n    {\n      \"created_at\": \"2025-02-26T13:45:02Z\",\n      \"updated_at\": \"2025-02-26T13:45:02Z\",\n      \"name\": \"Bittensor\",\n      \"symbol\": \"TAO\",\n      \"slug\": \"bittensor\",\n      \"circulating_supply\": \"8398025\",\n      \"max_supply\": \"21000000\",\n      \"total_supply\": \"8398025\",\n      \"last_updated\": \"2025-02-26T13:44:00Z\",\n      \"price\": \"366.499646341234\",\n      \"volume_24h\": \"263821126.141511\",\n      \"market_cap\": \"3077873192.46484\",\n      \"percent_change_1h\": \"-0.88079436\",\n      \"percent_change_24h\": \"-0.250314\",\n      \"percent_change_7d\": \"-11.00275914\",\n      \"percent_change_30d\": \"-14.498297\",\n      \"percent_change_60d\": \"-21.61015966\",\n      \"percent_change_90d\": \"-34.25472829\",\n      \"market_cap_dominance\": \"0.1074\",\n      \"fully_diluted_market_cap\": \"7696492573.17\"\n    }\n  ]\n}"
  }
}

400 — Bad request

Section titled “400 — Bad request”

404 — Price not found

Section titled “404 — Price not found”

500 — Internal server error

Section titled “500 — Internal server error”

Authentication

Section titled “Authentication”

All Taostats API requests require an Authorization header containing your API key. See Getting Started.