> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Asset

> One row per crypto asset, keyed by assetID and also found by slug or ticker: name, symbol, logo, sector taxonomy, stablecoin and wrapped-asset flags, the primary project, onchain contracts, and circulating market cap with its rank. The assetID is the series key of the per-asset timeseries models.



## OpenAPI

````yaml api-reference/data-api/openapi.json GET /query/tabular/assets/{assetID}
openapi: 3.0.0
info:
  description: >-
    The Blockworks Data API is a unified, read-only REST interface to
    Blockworks' warehouse-modeled crypto dataset, powered by Messari's research
    and data infrastructure. It serves two kinds of models: tabular models,
    which return current, filterable, sortable rows for entities such as assets,
    networks, protocols, exchanges, stablecoins, and ETFs; and timeseries
    models, which return historical metric series at a chosen granularity for
    one or many entities. Every endpoint shares the same query grammar (column
    projection, per-column filters, sorting, and pagination) and returns the
    standard `{ "error": ..., "data": ... }` envelope. Authenticate by sending
    your API key in the `X-Blockworks-API-Key` header.
  title: Blockworks Data API
  version: 0.1.0
servers:
  - description: Blockworks API
    url: https://api.blockworks.com
security:
  - apiKey: []
tags:
  - description: 'Models documented under Acquisitions: Acquisition Deals (table).'
    name: Acquisitions
  - description: >-
      Models documented under Assets: Assets (table), Asset Marketcap
      (timeseries), Asset Price (timeseries), Asset Sharpe (timeseries), Asset
      Supply (timeseries), Asset Volatility (timeseries).
    name: Assets
  - description: >-
      Models documented under Blockchains: Blockchains (table), Blockchains
      (timeseries).
    name: Blockchains
  - description: >-
      Models documented under Derivatives: Perpetual Markets (table), Perpetual
      Markets (timeseries).
    name: Derivatives
  - description: >-
      Models documented under Digital Asset Treasuries: DAT Companies (table),
      DAT Company Assets (table), DAT Companies (timeseries), DAT Companies by
      Asset (timeseries).
    name: Digital Asset Treasuries
  - description: >-
      Models documented under ETFs: ETF Assets (table), ETF Providers (table),
      ETF Assets (timeseries), ETF Providers (timeseries).
    name: ETFs
  - description: >-
      Models documented under Exchanges: Exchange Country (timeseries), Exchange
      Region (timeseries), Exchange Type (timeseries), Exchanges (timeseries).
    name: Exchanges
  - description: >-
      Models documented under Funding Rounds: Funding Round Investors (table),
      Funding Rounds (table), Sector Fundraising (timeseries).
    name: Funding Rounds
  - description: >-
      Models documented under Funds & Investors: Fund Managers (table), Funds
      (table).
    name: Funds & Investors
  - description: >-
      Models documented under Launchpads: Launchpad Chains (table), Launchpads
      (table), Launchpads (timeseries), Launchpads by Chain (timeseries).
    name: Launchpads
  - description: >-
      Models documented under Lending Protocols: Lending Protocol Product
      Markets (table), Lending Protocol Products (table), Lending Protocols
      (table), Lending Protocols (timeseries), Lending Protocols by Product
      (timeseries), Lending Protocols by Product Market (timeseries).
    name: Lending Protocols
  - description: >-
      Models documented under Market Overview: Sector Marketdata (timeseries),
      Sub-Sector Marketdata (timeseries).
    name: Market Overview
  - description: 'Models documented under Markets: Market (BQEN) (timeseries).'
    name: Markets
  - description: >-
      Models documented under News & Research: News Feed (table), Research
      Reports (table), Topics (timeseries).
    name: News & Research
  - description: >-
      Models documented under Perp DEXes: Perp DEX Protocols (table), Perp DEX
      Protocols (timeseries).
    name: Perp DEXes
  - description: 'Models documented under Projects & Entities: Projects (timeseries).'
    name: Projects & Entities
  - description: >-
      Models documented under Protocol Revenue: Protocol Revenue (timeseries),
      Protocol Revenue by Product (timeseries).
    name: Protocol Revenue
  - description: >-
      Models documented under Social & Mindshare: Asset Group Sentiment
      (timeseries), Asset Investor Mentions (timeseries), Asset Mindshare
      (timeseries), Asset Sentiment (timeseries), Project Mindshare
      (timeseries), Sector Asset Mindshare (timeseries), Sector Asset Sentiment
      (timeseries), Sector Investor Mentions (timeseries), Sub-Sector Asset
      Mindshare (timeseries), Sub-Sector Asset Sentiment (timeseries).
    name: Social & Mindshare
  - description: >-
      Models documented under Spot DEXes: Spot DEX Protocol Chains (table), Spot
      DEX Protocols (table), Spot DEX Protocols (timeseries), Spot DEX Protocols
      by Chain (timeseries).
    name: Spot DEXes
  - description: >-
      Models documented under Stablecoins: Stablecoin Chains (table), Stablecoin
      Currencies (table), Stablecoin FX Pairs (table), Stablecoin Issuers
      (table), Stablecoin Products (table), Stablecoin Reserve Entities (table),
      Stablecoin FX (timeseries), Stablecoin Reserves (timeseries), Stablecoins
      by Chain (timeseries), Stablecoins by Currency (timeseries), Stablecoins
      by Issuer (timeseries), Stablecoins by Product (timeseries).
    name: Stablecoins
  - description: >-
      Models documented under TCG Platforms: TCG Platform Chains (table), TCG
      Platforms by Chain (timeseries).
    name: TCG Platforms
  - description: >-
      Discovery of the tabular models: one row per entity, with per-column
      filters, sorting and pagination.
    name: Tabular
  - description: >-
      Discovery of the timeseries models: one series per entity, as points at
      the granularities each model declares.
    name: Timeseries
  - description: >-
      Models documented under Token Transparency Framework: Token Transparency
      Filing Questions (table), Token Transparency Filing Schemas (table), Token
      Transparency Filings (table), Token Transparency Projects (table).
    name: Token Transparency Framework
  - description: >-
      Models documented under Tokenized Commodities: Tokenized Commodities
      (table), Tokenized Commodity Chains (table), Tokenized Commodity Issuers
      (table), Tokenized Commodity Products (table), Tokenized Commodities by
      Chain (timeseries), Tokenized Commodities by Commodity (timeseries),
      Tokenized Commodities by Issuer (timeseries), Tokenized Commodities by
      Product (timeseries).
    name: Tokenized Commodities
  - description: >-
      Models documented under Tokenized Equities: Tokenized Equities (table),
      Tokenized Equity Chains (table), Tokenized Equity Issuers (table),
      Tokenized Equity Products (table), Tokenized Equities by Chain
      (timeseries), Tokenized Equities by Equity (timeseries), Tokenized
      Equities by Issuer (timeseries), Tokenized Equities by Product
      (timeseries).
    name: Tokenized Equities
  - description: >-
      Models documented under Vaults: Vault Chains (table), Vault Curators
      (table), Vault Protocols (table), Vault Curators (timeseries), Vault
      Protocols (timeseries), Vaults by Chain (timeseries).
    name: Vaults
paths:
  /query/tabular/assets/{assetID}:
    get:
      tags:
        - Assets
      summary: Get Asset
      description: >-
        One row per crypto asset, keyed by assetID and also found by slug or
        ticker: name, symbol, logo, sector taxonomy, stablecoin and
        wrapped-asset flags, the primary project, onchain contracts, and
        circulating market cap with its rank. The assetID is the series key of
        the per-asset timeseries models.
      operationId: getTabularRow_assets
      parameters:
        - description: >-
            The Asset ID identifying the row. Falls back to the alternative
            identifier fields (slug, prioritySymbol, tried in that order) when
            no Asset ID matches; metadata.matchedField says which one matched.
          in: path
          name: assetID
          required: true
          schema:
            type: string
        - description: Comma-separated fields to return; defaults to all fields.
          in: query
          name: selections
          schema:
            items:
              enum:
                - assetID
                - assetSerialID
                - name
                - slug
                - symbol
                - prioritySymbol
                - logoURL
                - sector
                - sectorsV2
                - subSectorsV2
                - isStablecoin
                - isWrappedAsset
                - coveredByIntel
                - primaryProjectID
                - primaryProjectSlug
                - primaryProjectName
                - primaryProjectTagline
                - primaryProjectOverview
                - primaryProjectLogoURL
                - primaryProjectLinks
                - platformContracts
                - circulatingMarketcap
                - circulatingMarketcapRank
              type: string
            type: array
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  assetID: <assetID>
                  assetSerialID: 123
                  circulatingMarketcap: 123.45
                  circulatingMarketcapRank: 123
                  coveredByIntel: true
                  isStablecoin: true
                  isWrappedAsset: true
                  logoURL: <logoURL>
                  name: <name>
                  platformContracts:
                    - {}
                  primaryProjectID: <primaryProjectID>
                  primaryProjectLinks:
                    - {}
                  primaryProjectLogoURL: <primaryProjectLogoURL>
                  primaryProjectName: <primaryProjectName>
                  primaryProjectOverview: <primaryProjectOverview>
                  primaryProjectSlug: <primaryProjectSlug>
                  primaryProjectTagline: <primaryProjectTagline>
                  prioritySymbol: <prioritySymbol>
                  sector: <sector>
                  sectorsV2:
                    - <sectorsV2>
                  slug: <slug>
                  subSectorsV2:
                    - <subSectorsV2>
                  symbol: <symbol>
                error: null
                metadata:
                  matchedField: assetID
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/AssetsRow'
                  error:
                    nullable: true
                    type: string
                  metadata:
                    description: >-
                      The public field the lookup value matched on: the primary
                      key or an alternative identifier.
                    properties:
                      matchedField:
                        type: string
                    required:
                      - matchedField
                    type: object
                required:
                  - data
                  - metadata
                type: object
          description: The matching row, and which field it matched on.
        '400':
          content:
            application/json:
              example:
                data: null
                error: unknown selection field "nope"
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            The request is malformed: an unknown query parameter, or a
            selections field the model does not have.
        '401':
          content:
            application/json:
              example:
                data: null
                error: this model requires authentication
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No API key was sent and the model requires one.
        '403':
          content:
            application/json:
              example:
                data: null
                error: >-
                  this model requires a paid subscription or the
                  "market_data_unified" permission
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            The API key is not valid, or its subscription does not include this
            model (it needs a Lite, Pro or Enterprise plan), and it does not
            hold the "market_data_unified" permission.
        '404':
          content:
            application/json:
              example:
                data: null
                error: no row found matching "unknown"
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            No row's Asset ID or slug, prioritySymbol equals the path value, or
            the path names a model that does not exist.
components:
  schemas:
    AssetsRow:
      properties:
        assetID:
          description: The unique identifier of the asset.
          nullable: true
          type: string
        assetSerialID:
          description: >-
            The numeric serial identifier of the asset, used by market data
            services.
          format: int64
          nullable: true
          type: integer
        circulatingMarketcap:
          description: >-
            The circulating marketcap of the asset. Carried so search and filter
            results can be ranked by size.
          nullable: true
          type: number
        circulatingMarketcapRank:
          description: >-
            The rank of the asset by circulating marketcap. Shares its
            definition with the assets-ranking model.
          format: int32
          nullable: true
          type: integer
        coveredByIntel:
          description: If true, the asset is covered by Messari Intel.
          nullable: true
          type: boolean
        isStablecoin:
          description: If true, the asset is tagged as a stablecoin.
          nullable: true
          type: boolean
        isWrappedAsset:
          description: If true, the asset is tagged as a wrapped or synthetic asset.
          nullable: true
          type: boolean
        logoURL:
          description: The URL of the asset's logo.
          nullable: true
          type: string
        name:
          description: The name of the asset.
          nullable: true
          type: string
        platformContracts:
          description: >-
            The asset's onchain contracts, each with platform, contractAddress,
            and the network's id, name, slug, and logo URL.
          items:
            type: object
          nullable: true
          type: array
        primaryProjectID:
          description: The unique identifier of the asset's primary project.
          nullable: true
          type: string
        primaryProjectLinks:
          description: >-
            The primary project's external links, each with link, name, and
            type.
          items:
            type: object
          nullable: true
          type: array
        primaryProjectLogoURL:
          description: The URL of the primary project's logo.
          nullable: true
          type: string
        primaryProjectName:
          description: The name of the asset's primary project.
          nullable: true
          type: string
        primaryProjectOverview:
          description: The markdown overview of the asset's primary project.
          nullable: true
          type: string
        primaryProjectSlug:
          description: >-
            The URL slug of the asset's primary project. Resolves an asset URL
            to its canonical project URL.
          nullable: true
          type: string
        primaryProjectTagline:
          description: The one-line tagline of the asset's primary project.
          nullable: true
          type: string
        prioritySymbol:
          description: >-
            The canonical asset for a ticker, set only on the asset that owns
            it. Unique where present, so it is a safe single-row lookup key.
          nullable: true
          type: string
        sector:
          description: The sector the asset belongs to.
          nullable: true
          type: string
        sectorsV2:
          description: The v2-taxonomy sectors the asset belongs to.
          items:
            type: string
          nullable: true
          type: array
        slug:
          description: The URL slug of the asset.
          nullable: true
          type: string
        subSectorsV2:
          description: The v2-taxonomy sub-sectors the asset belongs to.
          items:
            type: string
          nullable: true
          type: array
        symbol:
          description: >-
            The ticker symbol of the asset. Not unique: several assets may share
            a ticker.
          nullable: true
          type: string
      type: object
    ErrorResponse:
      properties:
        data:
          description: Always null on an error.
          nullable: true
          type: object
        error:
          description: What went wrong, in one sentence.
          type: string
      required:
        - error
        - data
      type: object
  securitySchemes:
    apiKey:
      description: >-
        API key sent in the `X-Blockworks-API-Key` header; `x-messari-api-key`
        is accepted for existing integrations. The catalog endpoints and models
        on the public access tier need no key.
      in: header
      name: X-Blockworks-API-Key
      type: apiKey

````