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

# Get Token Metadata

> Retrieve metadata for a specific ERC-1155 token, including its name, description, image, and associated market information.



## OpenAPI

````yaml openapi.json get /v1/tokens/{id}
openapi: 3.0.0
info:
  title: Swaps API
  description: The Swaps API documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://swap-api.flux.fun
    description: Production
  - url: http://localhost:3000
    description: Development
security: []
tags: []
paths:
  /v1/tokens/{id}:
    get:
      tags:
        - Prediction Markets & Portfolio
      summary: Get Token Metadata
      description: >-
        Retrieve metadata for a specific ERC-1155 token, including its name,
        description, image, and associated market information.
      operationId: TokensController_getTokenMetadata
      parameters:
        - name: id
          required: true
          in: path
          description: The ERC-1155 token ID
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenMetadataResponseDto'
components:
  schemas:
    TokenMetadataResponseDto:
      type: object
      properties:
        name:
          type: string
          example: Bitcoin $100K by Dec 31 - YES
          description: Token name
        description:
          type: string
          example: Prediction market token for Bitcoin reaching $100,000
          description: Token description
        properties:
          description: Extended token properties
          allOf:
            - $ref: '#/components/schemas/TokenPropertiesDto'
      required:
        - name
        - description
        - properties
    TokenPropertiesDto:
      type: object
      properties:
        decimals:
          type: number
          example: 0
          description: Token decimals
        marketId:
          type: string
          example: KXBTC-24DEC31-T100K
          description: Market identifier
        outcome:
          type: string
          example: 'yes'
          description: Market outcome (yes/no)
        tokenId:
          type: string
          example: 0x123...
          description: On-chain token ID
      required:
        - decimals
        - marketId
        - outcome
        - tokenId

````