> ## 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 Project Token

> One row per token contract per chain with daily token metrics: chain and contract address, symbol, category, sector, subsector and issuer. The id is the series key of the project-tokens timeseries model and matches the id in tokens.



## OpenAPI

````yaml api-reference/data-api/openapi.json GET /query/tabular/project-tokens/{id}
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 Assets: Assets (table), Tokens (table), Asset
      Marketcap (timeseries), Asset Price (timeseries), Asset Sharpe
      (timeseries), Asset Supply (timeseries), Asset Volatility (timeseries),
      Project Tokens (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 Treasury Companies: DAT Companies
      (table), DAT Company Assets (table), DAT Companies (timeseries), DAT
      Companies by Asset (timeseries).
    name: Digital Asset Treasury Companies
  - 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 Fundraising: Acquisition Deals (table), Fund
      Managers (table), Funding Round Investors (table), Funding Rounds (table),
      Funds (table), Sector Fundraising (timeseries).
    name: Fundraising
  - 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 Market Balances
      (table), Lending Market Financials (table), Lending Market Flows (table),
      Lending Market Interest Rates (table), Lending Market Liquidations
      (table), Lending Protocol Product Markets (table), Lending Protocol
      Products (table), Lending Protocols (table), Lending Market Balances
      (timeseries), Lending Market Financials (timeseries), Lending Market Flows
      (timeseries), Lending Market Interest Rates (timeseries), Lending Market
      Liquidations (timeseries), Lending Protocols (timeseries), Lending
      Protocols by Product (timeseries), Lending Protocols by Product Market
      (timeseries).
    name: Lending Protocols
  - description: >-
      Models documented under Markets: Markets (table), Market (BQEN)
      (timeseries).
    name: Markets
  - description: >-
      Models documented under Mindshare & Sentiment: 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: Mindshare & Sentiment
  - description: 'Models documented under News: News Feed (table), Topics (timeseries).'
    name: News
  - description: >-
      Models documented under Perp DEX Protocols: Perp DEX Protocols (table),
      Perp DEX Protocols (timeseries).
    name: Perp DEX Protocols
  - description: >-
      Models documented under Projects: Project Tokens (table), Projects
      (timeseries).
    name: Projects
  - description: >-
      Models documented under Protocol Revenue: Protocol Revenue (timeseries),
      Protocol Revenue by Product (timeseries).
    name: Protocol Revenue
  - description: >-
      Models documented under Real World Assets: RWA Spot DEX Segments (table),
      RWA Spot DEX Activity (timeseries).
    name: Real World Assets
  - description: >-
      Models documented under Research Reports (Tabular): Research Reports
      (table).
    name: Research Reports (Tabular)
  - description: >-
      Models documented under Sector Market Data: Sector Marketdata
      (timeseries), Sub-Sector Marketdata (timeseries).
    name: Sector Market Data
  - description: >-
      Models documented under Spot DEX Protocols: Spot DEX Protocol Chains
      (table), Spot DEX Protocols (table), Spot DEX Protocols (timeseries), Spot
      DEX Protocols by Chain (timeseries).
    name: Spot DEX Protocols
  - 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: Token Transparency Filing
      Questions (table), Token Transparency Filing Schemas (table), Token
      Transparency Filings (table), Token Transparency Projects (table).
    name: Token Transparency
  - description: 'Models documented under Token Unlocks: Token Unlocks (timeseries).'
    name: Token Unlocks
  - 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/project-tokens/{id}:
    get:
      tags:
        - Projects
      summary: Get Project Token
      description: >-
        One row per token contract per chain with daily token metrics: chain and
        contract address, symbol, category, sector, subsector and issuer. The id
        is the series key of the project-tokens timeseries model and matches the
        id in tokens.
      operationId: getTabularRow_project_tokens
      parameters:
        - description: The Token ID identifying the row.
          in: path
          name: id
          required: true
          schema:
            type: string
        - description: Comma-separated fields to return; defaults to all fields.
          in: query
          name: selections
          schema:
            items:
              enum:
                - id
                - name
                - slug
                - chain
                - tokenAddress
                - symbol
                - category
                - sector
                - subsector
                - issuerID
                - networkID
              type: string
            type: array
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  category: <category>
                  chain: <chain>
                  id: <id>
                  issuerID: <issuerID>
                  name: <name>
                  networkID: <networkID>
                  sector: <sector>
                  slug: <slug>
                  subsector: <subsector>
                  symbol: <symbol>
                  tokenAddress: <tokenAddress>
                error: null
                metadata:
                  matchedField: id
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/ProjectTokensRow'
                  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 the "assets-dataset" permission; see
                  https://app.blockworks.com/account/api for the public API
                  permissions you hold
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            The API key is not valid, or does not hold the "assets-dataset"
            permission.
        '404':
          content:
            application/json:
              example:
                data: null
                error: no row found matching "unknown"
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            No row's Token ID equals the path value, or the path names a model
            that does not exist.
components:
  schemas:
    ProjectTokensRow:
      properties:
        category:
          description: The token's category (for example stablecoins or blockchains).
          nullable: true
          type: string
        chain:
          description: >-
            The short name of the chain the token is deployed on (ethereum,
            base, solana).
          nullable: true
          type: string
        id:
          description: >-
            The series key of the project-tokens timeseries model, the token's
            chain and contract address joined with an underscore; the same id as
            in tokens.
          nullable: true
          type: string
        issuerID:
          description: >-
            The identifier of the token's issuer (for example circle or tether);
            null when unclassified.
          nullable: true
          type: string
        name:
          description: The token's display name, its symbol, falling back to its slug.
          nullable: true
          type: string
        networkID:
          description: The chain's networkID in the blockchains model; null when unmapped.
          nullable: true
          type: string
        sector:
          description: The token's sector within its category (for example usd or l1).
          nullable: true
          type: string
        slug:
          description: >-
            The token's identifier, shared by every chain's deployment of the
            same token (circle-usdc); null when unclassified, and not unique
            across chains.
          nullable: true
          type: string
        subsector:
          description: >-
            The token's subsector within its sector (for example fiat or
            bitcoin).
          nullable: true
          type: string
        symbol:
          description: The token's ticker symbol.
          nullable: true
          type: string
        tokenAddress:
          description: The token contract address (the mint address on Solana).
          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
        open to everyone need no key.
      in: header
      name: X-Blockworks-API-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.