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

# Batch get token metadata

> Fetch metadata for multiple tokens in a single request. Provide comma-separated networks and addresses in the same order. Maximum 100 tokens per request.

## Node.js SDK

🔗 **SDK Method:** [batchGetTokenMetadata](/nodejs-sdk/onchain-apis/batchGetTokenMetadata)

Use this API endpoint with the Neynar Node.js SDK for typed responses and better developer experience.


## OpenAPI

````yaml get /v2/onchain/token/metadata/batch
openapi: 3.0.4
info:
  contact:
    email: team@neynar.com
    name: Neynar
    url: https://neynar.com/
  description: >-
    The Neynar API allows you to interact with the Farcaster protocol among
    other things. See the [Neynar docs](https://docs.neynar.com/reference) for
    more details.
  title: Neynar API
  version: 3.173.0
servers:
  - url: https://api.neynar.com
security:
  - ApiKeyAuth: []
tags:
  - description: Operations related to user
    externalDocs:
      description: More info about user
      url: https://docs.neynar.com/reference/user-operations
    name: User
  - description: Operations related to signer
    externalDocs:
      description: More info about signer
      url: https://docs.neynar.com/reference/signer-operations
    name: Signer
  - description: Operations related to cast
    externalDocs:
      description: More info about cast
      url: https://docs.neynar.com/reference/cast-operations
    name: Cast
  - description: Operations related to feed
    externalDocs:
      description: More info about feed
      url: https://docs.neynar.com/reference/feed-operations
    name: Feed
  - description: Operations related to reaction
    externalDocs:
      description: More info about reaction
      url: https://docs.neynar.com/reference/reaction-operations
    name: Reaction
  - description: Operations related to notifications
    externalDocs:
      description: More info about notifications
      url: https://docs.neynar.com/reference/notifications-operations
    name: Notifications
  - description: Operations related to channels
    externalDocs:
      description: More info about channels
      url: https://docs.neynar.com/reference/channel-operations
    name: Channel
  - description: Operations related to follows
    externalDocs:
      description: More info about follows
      url: https://docs.neynar.com/reference/follows-operations
    name: Follows
  - description: Operations related to storage
    externalDocs:
      description: More info about storage
      url: https://docs.neynar.com/reference/storage-operations
    name: Storage
  - description: Operations related to mini apps
    name: Frame
  - description: Operations for building AI agents
    name: Agents
  - description: Operations related to fname
    name: fname
  - description: Operations related to a webhook
    name: Webhook
  - description: >-
      Securely communicate and perform actions on behalf of users across
      different apps
    externalDocs:
      description: More info about farcaster actions
      url: https://docs.neynar.com/docs/farcaster-actions-spec
    name: Action
  - description: Operations related to a subscriptions
    name: Subscribers
  - description: Operations related to a mute
    name: Mute
  - description: Operations related to a block
    name: Block
  - description: Operations related to a ban
    name: Ban
  - description: Operations related to onchain data
    name: Onchain
  - description: Operations related to login
    name: Login
  - description: Operations related to retrieving metrics
    name: Metrics
  - description: Operations related to mini app host notifications
    externalDocs:
      description: More info about mini app host notifications
      url: https://docs.neynar.com/docs/app-host-notifications
    name: App Host
paths:
  /v2/onchain/token/metadata/batch:
    get:
      tags:
        - Onchain
      summary: Batch get token metadata
      description: >-
        Fetch metadata for multiple tokens in a single request. Provide
        comma-separated networks and addresses in the same order. Maximum 100
        tokens per request.
      operationId: batch-get-token-metadata
      parameters:
        - description: >-
            Comma-separated list of blockchain networks. Each value must be a
            valid network (ethereum, optimism, base, arbitrum).
          in: query
          name: networks
          required: true
          schema:
            example: base
            type: string
            x-comma-separated: true
        - description: >-
            Comma-separated list of token contract addresses corresponding to
            each network
          in: query
          name: addresses
          required: true
          schema:
            example: >-
              0x833589fcd6edb6e08f4c7c32d4f71b54bda02913,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
            type: string
            x-comma-separated: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  tokens:
                    items:
                      nullable: true
                      properties:
                        address:
                          description: Token contract address
                          example: '0x5a927ac639636e534b678e81768ca19e2c6280b7'
                          pattern: ^0x[a-fA-F0-9]{40}$
                          type: string
                        decimals:
                          description: Token decimals
                          example: 6
                          type: integer
                        description:
                          description: Token description
                          example: USDC is a fully collateralized US dollar stablecoin
                          nullable: true
                          type: string
                        fdv:
                          description: Fully diluted valuation in USD
                          example: '25000000000'
                          nullable: true
                          type: string
                        holder_count:
                          description: Number of token holders
                          example: 1500000
                          nullable: true
                          type: integer
                        image_url:
                          description: Token logo URL
                          example: https://example.com/token.png
                          nullable: true
                          type: string
                        liquidity:
                          description: Total liquidity in USD
                          example: '500000000'
                          nullable: true
                          type: string
                        market_cap:
                          description: Market capitalization in USD
                          example: '25000000000'
                          nullable: true
                          type: string
                        name:
                          description: Token name
                          example: USD Coin
                          type: string
                        network:
                          $ref: '#/components/schemas/Network'
                        price_change_24h_pct:
                          description: 24-hour price change percentage
                          example: -1.2
                          nullable: true
                          type: number
                        price_change_6h_pct:
                          description: 6-hour price change percentage
                          example: 0.5
                          nullable: true
                          type: number
                        price_source:
                          description: Source of price data
                          enum:
                            - onchain
                            - coingecko
                          example: onchain
                          nullable: true
                          type: string
                        price_updated_at:
                          description: >-
                            Timestamp when price data was last updated
                            (milliseconds)
                          example: 1707177600000
                          nullable: true
                          type: integer
                        price_usd:
                          description: Token price in USD
                          example: '1.00'
                          nullable: true
                          type: string
                        symbol:
                          description: Token symbol
                          example: USDC
                          type: string
                        total_supply:
                          description: Total token supply
                          example: '1000000000000'
                          nullable: true
                          type: string
                        volume_24h:
                          description: 24-hour trading volume in USD
                          example: '150000000'
                          nullable: true
                          type: string
                        volume_6h:
                          description: 6-hour trading volume in USD
                          example: '50000000'
                          nullable: true
                          type: string
                      required:
                        - network
                        - address
                        - name
                        - symbol
                        - decimals
                        - total_supply
                        - image_url
                        - price_usd
                        - market_cap
                        - fdv
                        - liquidity
                        - volume_6h
                        - volume_24h
                        - price_change_6h_pct
                        - price_change_24h_pct
                        - holder_count
                        - description
                        - price_updated_at
                        - price_source
                      type: object
                    type: array
                required:
                  - tokens
                type: object
          description: Success
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorRes'
          description: Bad Request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorRes'
          description: Server Error
      externalDocs:
        url: https://docs.neynar.com/reference/batch-get-token-metadata
components:
  schemas:
    Network:
      description: A blockchain network e.g. "ethereum", "optimism", "base", "arbitrum"
      enum:
        - ethereum
        - optimism
        - base
        - arbitrum
      title: Network
      type: string
    ErrorRes:
      description: Details for the error response
      properties:
        code:
          type: string
        message:
          type: string
        property:
          type: string
        status:
          format: int32
          type: integer
      required:
        - message
      title: ErrorRes
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: API key to authorize requests
      in: header
      name: x-api-key
      type: apiKey
      x-default: NEYNAR_API_DOCS

````