EVM API — NFT

naftiko: 1.0.0-alpha2
info:
  label: EVM API — NFT
  description: 'EVM API — NFT. 28 operations. Lead operation: Get Metadata for NFTs. Self-contained Naftiko capability covering
    one Moralis business surface.'
  tags:
  - Moralis
  - NFT
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MORALIS_API_KEY: MORALIS_API_KEY
capability:
  consumes:
  - type: http
    namespace: evm-nft
    baseUri: https://deep-index.moralis.io/api/v2.2
    description: EVM API — NFT business capability. Self-contained, no shared references.
    resources:
    - name: nft-getMultipleNFTs
      path: /nft/getMultipleNFTs
      operations:
      - name: getmultiplenfts
        method: POST
        description: Get Metadata for NFTs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: nft-metadata
      path: /nft/metadata
      operations:
      - name: getnftbulkcontractmetadata
        method: POST
        description: Get metadata for multiple NFT contracts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: nft-address
      path: /nft/{address}
      operations:
      - name: getcontractnfts
        method: GET
        description: Get NFTs by contract address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: totalRanges
          in: query
          type: integer
          description: The number of subranges to split the results into
        - name: range
          in: query
          type: integer
          description: The desired subrange to query
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: normalizeMetadata
          in: query
          type: boolean
          description: Should normalized metadata be returned?
        - name: media_items
          in: query
          type: boolean
          description: Should preview media data be returned?
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
    - name: nft-address-floor-price
      path: /nft/{address}/floor-price
      operations:
      - name: getnftfloorpricebycontract
        method: GET
        description: Get NFT floor price by contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
    - name: nft-address-floor-price-historical
      path: /nft/{address}/floor-price/historical
      operations:
      - name: getnfthistoricalfloorpricebycontract
        method: GET
        description: Get historical NFT floor price by contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: interval
          in: query
          type: string
          description: The duration to query
          required: true
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
    - name: nft-address-metadata
      path: /nft/{address}/metadata
      operations:
      - name: getnftcontractmetadata
        method: GET
        description: Get NFT collection metadata
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
    - name: nft-address-nfts-by-traits
      path: /nft/{address}/nfts-by-traits
      operations:
      - name: getnftbycontracttraits
        method: POST
        description: Get NFTs by traits
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: normalizeMetadata
          in: query
          type: boolean
          description: Should normalized metadata be returned?
        - name: media_items
          in: query
          type: boolean
          description: Should preview media data be returned?
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: nft-address-owners
      path: /nft/{address}/owners
      operations:
      - name: getnftowners
        method: GET
        description: Get NFT owners by contract address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: normalizeMetadata
          in: query
          type: boolean
          description: Should normalized metadata be returned?
        - name: media_items
          in: query
          type: boolean
          description: Should preview media data be returned?
    - name: nft-address-price
      path: /nft/{address}/price
      operations:
      - name: getnftcontractsaleprices
        method: GET
        description: Get NFT sale prices by collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: days
          in: query
          type: integer
          description: The number of days to look back to find the lowest price
        - name: address
          in: path
          type: string
          description: The address of the NFT collection
          required: true
    - name: nft-address-stats
      path: /nft/{address}/stats
      operations:
      - name: getnftcollectionstats
        method: GET
        description: Get summary stats by NFT collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT collection
          required: true
    - name: nft-address-sync
      path: /nft/{address}/sync
      operations:
      - name: syncnftcontract
        method: PUT
        description: Resync NFT Contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
    - name: nft-address-trades
      path: /nft/{address}/trades
      operations:
      - name: getnfttrades
        method: GET
        description: Get NFT trades by collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: from_block
          in: query
          type: integer
          description: The minimum block number from which to get the transfers
        - name: to_block
          in: query
          type: string
          description: The block number to get the trades from
        - name: from_date
          in: query
          type: string
          description: The start date from which to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: to_date
          in: query
          type: string
          description: The end date from which to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: marketplace
          in: query
          type: string
          description: Marketplace from which to get the trades. See [supported Marketplaces](https://docs.moralis.io/web3-data-api/evm/nft-marketplaces).
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: nft_metadata
          in: query
          type: boolean
          description: Include the NFT Metadata of the NFT Token
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
    - name: nft-address-traits
      path: /nft/{address}/traits
      operations:
      - name: getnfttraitsbycollection
        method: GET
        description: Get NFT traits by collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
    - name: nft-address-traits-paginate
      path: /nft/{address}/traits/paginate
      operations:
      - name: getnfttraitsbycollectionpaginate
        method: GET
        description: Get NFT traits by collection paginate
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: order
          in: query
          type: string
          description: The order of the result, in ascending (ASC) or descending (DESC)
    - name: nft-address-traits-resync
      path: /nft/{address}/traits/resync
      operations:
      - name: resyncnftrarity
        method: GET
        description: Resync NFT Trait
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
    - name: nft-address-transfers
      path: /nft/{address}/transfers
      operations:
      - name: getnftcontracttransfers
        method: GET
        description: Get NFT transfers by contract address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: from_block
          in: query
          type: integer
          description: The minimum block number from where to get the transfers
        - name: to_block
          in: query
          type: integer
          description: The maximum block number from where to get the transfers.
        - name: from_date
          in: query
          type: string
          description: The date from where to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: to_date
          in: query
          type: string
          description: Get transfers up until this date (format in seconds or datestring accepted by momentjs)
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: order
          in: query
          type: string
          description: The order of the result, in ascending (ASC) or descending (DESC)
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
    - name: nft-address-unique-owners
      path: /nft/{address}/unique-owners
      operations:
      - name: getuniqueownersbycollection
        method: GET
        description: Get unique wallet addresses owning NFTs from a contract.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
    - name: nft-address-token_id
      path: /nft/{address}/{token_id}
      operations:
      - name: getnftmetadata
        method: GET
        description: Get NFT metadata
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: token_id
          in: path
          type: string
          description: The ID of the token
          required: true
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: normalizeMetadata
          in: query
          type: boolean
          description: Should normalized metadata be returned?
        - name: media_items
          in: query
          type: boolean
          description: Should preview media data be returned?
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
    - name: nft-address-token_id-floor-price
      path: /nft/{address}/{token_id}/floor-price
      operations:
      - name: getnftfloorpricebytoken
        method: GET
        description: Get NFT floor price by token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: token_id
          in: path
          type: string
          description: The token ID of the NFT
          required: true
    - name: nft-address-token_id-metadata-resync
      path: /nft/{address}/{token_id}/metadata/resync
      operations:
      - name: resyncmetadata
        method: GET
        description: Resync NFT metadata
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: token_id
          in: path
          type: string
          description: The ID of the token
          required: true
        - name: flag
          in: query
          type: string
          description: The type of resync to operate
        - name: mode
          in: query
          type: string
          description: To define the behaviour of the endpoint
    - name: nft-address-token_id-owners
      path: /nft/{address}/{token_id}/owners
      operations:
      - name: getnfttokenidowners
        method: GET
        description: Get NFT owners by token ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: token_id
          in: path
          type: string
          description: The ID of the token
          required: true
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: normalizeMetadata
          in: query
          type: boolean
          description: Should normalized metadata be returned?
        - name: media_items
          in: query
          type: boolean
          description: Should preview media data be returned?
    - name: nft-address-token_id-price
      path: /nft/{address}/{token_id}/price
      operations:
      - name: getnftsaleprices
        method: GET
        description: Get NFT sale prices by token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: days
          in: query
          type: integer
          description: The number of days to look back to find the lowest price
        - name: address
          in: path
          type: string
          description: The address of the NFT collection
          required: true
        - name: token_id
          in: path
          type: string
          description: The token id of the NFT collection
          required: true
    - name: nft-address-token_id-trades
      path: /nft/{address}/{token_id}/trades
      operations:
      - name: getnfttradesbytoken
        method: GET
        description: Get NFT trades by token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: from_block
          in: query
          type: integer
          description: The minimum block number from which to get the transfers
        - name: to_block
          in: query
          type: string
          description: The block number to get the trades from
        - name: from_date
          in: query
          type: string
          description: The start date from which to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: to_date
          in: query
          type: string
          description: The end date from which to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: nft_metadata
          in: query
          type: boolean
          description: Include the NFT Metadata of the NFT Token
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: token_id
          in: path
          type: string
          description: The token ID of the NFT contract
          required: true
    - name: nft-address-token_id-transfers
      path: /nft/{address}/{token_id}/transfers
      operations:
      - name: getnfttransfers
        method: GET
        description: Get NFT transfers by token ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the NFT contract
          required: true
        - name: token_id
          in: path
          type: string
          description: The ID of the token
          required: true
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: order
          in: query
          type: string
          description: The order of the result, in ascending (ASC) or descending (DESC)
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
    - name: wallets-address-nfts-trades
      path: /wallets/{address}/nfts/trades
      operations:
      - name: getnfttradesbywallet
        method: GET
        description: Get NFT trades by wallet address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: from_block
          in: query
          type: integer
          description: The minimum block number from which to get the transfers
        - name: to_block
          in: query
          type: string
          description: The block number to get the trades from
        - name: from_date
          in: query
          type: string
          description: The start date from which to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: to_date
          in: query
          type: string
          description: The end date from which to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: nft_metadata
          in: query
          type: boolean
          description: Include the NFT Metadata of the NFT Token
        - name: address
          in: path
          type: string
          description: The owner wallet address
          required: true
    - name: address-nft
      path: /{address}/nft
      operations:
      - name: getwalletnfts
        method: GET
        description: Get NFTs by wallet address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the wallet
          required: true
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: exclude_spam
          in: query
          type: boolean
          description: Should spam NFTs be excluded from the result?
        - name: token_addresses
          in: query
          type: array
          description: The addresses to get balances for (optional)
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: normalizeMetadata
          in: query
          type: boolean
          description: Should normalized metadata be returned?
        - name: media_items
          in: query
          type: boolean
          description: Should preview media data be returned?
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
    - name: address-nft-collections
      path: /{address}/nft/collections
      operations:
      - name: getwalletnftcollections
        method: GET
        description: Get NFT collections by wallet address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The wallet address of the owner of NFTs in the collections
          required: true
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: exclude_spam
          in: query
          type: boolean
          description: Should spam NFTs be excluded from the result?
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: token_counts
          in: query
          type: boolean
          description: Should token counts per collection be included in the response?
    - name: address-nft-transfers
      path: /{address}/nft/transfers
      operations:
      - name: getwalletnfttransfers
        method: GET
        description: Get NFT Transfers by wallet address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The wallet address of the sender or recipient of the transfers
          required: true
        - name: contract_addresses
          in: query
          type: array
          description: List of contract addresses of transfers
        - name: format
          in: query
          type: string
          description: The format of the token ID
        - name: from_block
          in: query
          type: integer
          description: The minimum block number from which to get the transfers
        - name: to_block
          in: query
          type: string
          description: To get the reserves at this block number
        - name: from_date
          in: query
          type: string
          description: The date from where to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: to_date
          in: query
          type: string
          description: Get transfers up until this date (format in seconds or datestring accepted by momentjs)
        - name: include_prices
          in: query
          type: boolean
          description: Should NFT last sale prices be included in the result?
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: or

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/moralis/refs/heads/main/capabilities/evm-nft.yaml