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

# Get NFT tokens by address

> Lists non-fungible tokens for a particular contract address.



## OpenAPI

````yaml get /apechain/v1/nft/collections/{address}/tokens
openapi: 3.0.3
info:
  description: ''
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  title: Data API
  version: 1.0.0
servers:
  - description: The DEV base URL for the API
    url: https://data-api.cloud.ormi.dev
security: []
paths:
  /apechain/v1/nft/collections/{address}/tokens:
    get:
      tags:
        - NFTs
      summary: Get NFT tokens by address
      description: Lists non-fungible tokens for a particular contract address.
      operationId: getNFTTokenListForAddress
      parameters:
        - description: Contract address.
          in: path
          name: address
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/cursor'
        - $ref: '#/components/parameters/limit'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NFTTokenListForAddressResponse'
              examples:
                example1:
                  value:
                    cursor: null
                    resultCount: 2
                    tokens:
                      - address: '0xcf9a9600d50874244ed6085773379a75cd60d72c'
                        ercType: ERC-721
                        metadata:
                          attributes: >-
                            [{"trait_type":"Background","value":"1"},{"trait_type":"Fur","value":"10"},{"trait_type":"Earring","value":"0"},{"trait_type":"Hat","value":"0"},{"trait_type":"Eyes","value":"0"},{"trait_type":"Clothes","value":"33"},{"trait_type":"Mouth","value":"0"}]
                          imageUri: >-
                            data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy...C9zdmc+
                          mintedBlockNumber: 915726
                          mintedTimestamp: '2024-10-22T22:58:26Z'
                          name: 'OnChain Monkey #1'
                          symbol: OCAPE
                        tokenId: '1'
                        tokenUri: >-
                          data:application/json;base64,eyJuYW1lIjogIk9uQ2h...EM5emRtYysifQ==
                      - address: '0xcf9a9600d50874244ed6085773379a75cd60d72c'
                        ercType: ERC-721
                        metadata:
                          attributes: >-
                            [{"trait_type":"Background","value":"7"},{"trait_type":"Fur","value":"12"},{"trait_type":"Earring","value":"0"},{"trait_type":"Hat","value":"12"},{"trait_type":"Eyes","value":"6"},{"trait_type":"Clothes","value":"24"},{"trait_type":"Mouth","value":"21"}]
                          imageUri: >-
                            data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy...IjQzMCIgc3R5bGU9ImZpbGw6IzkwZiIvPjwvc3ZnPg==
                          mintedBlockNumber: 915988
                          mintedTimestamp: '2024-10-22T22:59:38Z'
                          name: 'OnChain Monkey #2'
                          symbol: OCAPE
                        tokenId: '2'
                        tokenUri: >-
                          data:application/json;base64,eyJuYW1lIjogIk9uQ2h...Ul2UGp3dmMzWm5QZz09In0=
                      - ...
          description: A list of NFT tokens for an address.
components:
  parameters:
    cursor:
      description: The cursor returned in previous response (for getting the next page).
      in: query
      name: cursor
      required: false
      schema:
        type: string
    limit:
      description: Number of records to fetch
      in: query
      name: limit
      required: false
      schema:
        default: 100
        maximum: 100
        minimum: 1
        nullable: true
        type: integer
  schemas:
    NFTTokenListForAddressResponse:
      properties:
        cursor:
          nullable: true
          type: string
        resultCount:
          description: amount of nfts equal to page size.
          type: integer
        tokens:
          items:
            $ref: '#/components/schemas/NFTTokenBalance'
          type: array
      required:
        - resultCount
        - tokens
      type: object
    NFTTokenBalance:
      properties:
        address:
          description: Contract address of the NFT token.
          type: string
        balance:
          description: balance of NFT
          type: string
          x-omitempty: true
        ercType:
          description: ERC standard type.
          type: string
        metadata:
          $ref: '#/components/schemas/Metadata'
        tokenId:
          description: Unique identifier of the token.
          type: string
        tokenUri:
          description: URI pointing to the token metadata.
          type: string
      required:
        - address
        - ercType
        - tokenId
        - tokenUri
        - metadata
        - name
        - symbol
      type: object
    Metadata:
      properties:
        attributes:
          description: Additional attributes of the token.
          type: string
          x-omitempty: true
        decimals:
          description: Decimals of the token.
          format: int64
          type: integer
          x-nullable: true
        description:
          description: Description of the token.
          type: string
          x-omitempty: true
        externalUrl:
          description: External URL related to the token.
          type: string
          x-omitempty: true
        imageUri:
          description: URI for the token image.
          type: string
          x-omitempty: true
        mintedBlockNumber:
          description: Minted block number of the token.
          format: int64
          type: integer
          x-omitempty: true
        mintedTimestamp:
          description: Minted timestamp of the token.
          format: date-time
          type: string
          x-omitempty: true
        name:
          description: Name of the token.
          type: string
          x-omitempty: true
        symbol:
          description: Symbol of the token.
          type: string
          x-omitempty: true
      required:
        - mintedBlockNumber
        - name
        - symbol
        - imageUri
        - description
        - externalUrl
        - attributes
      type: object

````