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

# Dataset Metadata

> Get Solana dataset metadata from the SQD Portal API.



## OpenAPI

````yaml /en/api/catalog/solana/openapi.yaml get /metadata
openapi: 3.1.0
info:
  title: SQD Portal API - Solana Dataset Endpoints
  description: >-
    API endpoints for interacting with Solana datasets under the SQD Portal,
    specifically for the solana-mainnet dataset.
  version: 1.0.0
servers:
  - url: https://portal.sqd.dev/datasets/solana-mainnet
security: []
paths:
  /metadata:
    get:
      summary: Dataset Metadata
      description: >-
        Retrieves metadata describing the dataset, including its name, aliases,
        start block, and real-time status.
      responses:
        '200':
          description: Dataset metadata response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetMetadata'
              examples:
                solana-mainnet:
                  summary: Solana Mainnet metadata
                  value:
                    dataset: solana-mainnet
                    aliases:
                      - solana
                      - sol
                    real_time: true
                    start_block: 0
        '404':
          description: Dataset not found (`error.code` is `unknown_dataset`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  type: invalid_request_error
                  code: unknown_dataset
                  message: 'Unknown dataset: no-such-chain'
      x-codeSamples:
        - lang: shell
          label: Get Solana Mainnet Metadata
          source: >
            curl --compressed
            'https://portal.sqd.dev/datasets/solana-mainnet/metadata'
        - lang: python
          label: Get Solana Mainnet Metadata
          source: |
            import requests

            response = requests.get(
                "https://portal.sqd.dev/datasets/solana-mainnet/metadata"
            )
            data = response.json()
        - lang: javascript
          label: Get Solana Mainnet Metadata
          source: >
            const response = await
            fetch("https://portal.sqd.dev/datasets/solana-mainnet/metadata");

            const data = await response.json();
components:
  schemas:
    DatasetMetadata:
      type: object
      properties:
        dataset:
          type: string
          description: The default name used to reference this dataset
          example: solana-mainnet
        aliases:
          type: array
          items:
            type: string
          description: Alternative names for the dataset
          example:
            - solana
            - sol
        real_time:
          type: boolean
          description: Indicates if the dataset has real-time data
          example: true
        start_block:
          type: integer
          format: int64
          description: The slot number of the first known block
          example: 0
      required:
        - dataset
        - aliases
        - real_time
    ErrorResponse:
      type: object
      description: Error body shared by every failing response.
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      required:
        - error
      example:
        error:
          type: invalid_request_error
          code: unknown_dataset
          message: 'Unknown dataset: no-such-chain'
    ErrorDetail:
      type: object
      description: >-
        Machine-readable error detail. Branch on `type`; match on `code` for one
        specific case.
      properties:
        type:
          type: string
          description: >-
            Coarse category to branch on. One of `invalid_request_error`,
            `rate_limit_error`, `availability_error`, or `api_error`. Treat an
            unknown `code` according to its `type`.
          example: invalid_request_error
        code:
          type: string
          description: >-
            Specific cause, stable across releases. Match on this rather than on
            `message`.
          example: base_block_mismatch
        message:
          type: string
          description: >-
            Human-readable detail. Prose, not stable; do not parse or match on
            it.
        param:
          type: string
          description: The request parameter at fault, when the error is about one.
        request_id:
          type: string
          description: >-
            Echo of the `x-request-id` response header, included in the body on
            5xx errors. Quote it when reporting a problem.
      required:
        - type
        - code
        - message

````

## Related topics

- [Dataset Metadata](/en/api/tron/metadata.md)
- [Available Datasets](/en/ai/available-datasets.md)
- [Transformer](/en/sdk/pipes-sdk/solana/reference/basic-components/transformer.md)