Filter Parallel Assets

Returns a list of Parallel assets based on a variety of filters.

Endpoint: filterNftParallelAssets

Method: POST

Arguments

NameTypeDescription
filtersParallelAssetFiltersA set of filters to apply.
limitIntThe maximum number of Parallel assets to return.
matchParallelAssetMatchersA set of parameters to match.
offsetIntWhere in the list the server should start when returning items. Use count+offset from the previous query to request the next page of results.
phraseStringA phrase to search for. Can match a Parallel asset ID (address:tokenId) or partially match a name.
rankings[ParallelAssetRanking]A list of ranking attributes to apply.

Response

NameTypeDescription
countInt

The number of Parallel assets returned.

offsetInt

Where in the list the server started when returning items.

results[ParallelAssetFilterResult]

The list of Parallel assets matching the filter parameters.

NameTypeDescription
addressString!

The contract address of the NFT collection.

descriptionString

The description of the NFT asset.

gameDataParallelAssetGameData

The game data for the NFT asset.

idString!

The ID of the NFT asset (address:tokenId).

lastPriceNetworkBaseTokenString

The last sale price in the network's base token.

lastPriceUsdString

The last sale price in USD.

mediaNftAssetMedia

The NFT asset media.

metadataParallelAssetMetadata

Metadata for the NFT asset.

nameString

The name of the NFT asset.

networkIdInt!

The network ID the NFT collection is deployed on.

originalImageString

The source image URI linked by smart contract metadata.

timestampInt

The unix timestamp for the last trade.

tokenIdString!

The token ID of the NFT asset.

uriString

The URI provided by the smart contract. Typically JSON that contains metadata.

Example

Filter SE Cards with Specified Game Data

Use this query to filter for SE Parallel cards with attack >= 5, health <= 3 and cost >=3.

{
  filterNftParallelAssets(
    filters: { attack: { gte: 5 }, health: { lte: 3 }, cost: { gte: 3 } }
    match: { class: SE }
  ) {
    count
    results {
      id
      address
      tokenId
      networkId
      name
      description
      originalImage
      uri
      lastPriceUsd
      lastPriceNetworkBaseToken
      timestamp
      media {
        image
        thumbSm
        thumbLg
      }
      gameData {
        rarity
        parallel
        cost
        attack
        health
        cardType
        subtype
        functionText
        passiveAbility
      }
      metadata {
        class
        supply
        flavourText
        expansion
        paraset
        artist
      }
    }
  }
}
{
  "data": {
    "filterNftParallelAssets": {
      "count": 1,
      "results": [
        {
          "id": "0x76be3b62873462d2142405439777e971754e8e77:10551",
          "address": "0x76be3b62873462d2142405439777e971754e8e77",
          "tokenId": "10551",
          "networkId": 1,
          "name": "DS-1 Prototype Frigate [SE]",
          "description": "β€œCommander, it just came up on the star chart, it must have slipped in from an undesignated jump point - it looks like its an Echelon ship but it's not responding.”",
          "originalImage": "ipfs://ipfs/QmNqCTMpQVSQ1LE4LTipwp8p68S4WYP4snFbdJCWfZxFBT/image.png",
          "uri": "https://nftdata.parallelnft.com/api/parallel-alpha/ipfs/QmWX4XdpA24dS9t5ajAvYj1QwSP7CAay624RNueX11xALo",
          "lastPriceUsd": "28.434054078660564",
          "lastPriceNetworkBaseToken": "0.018",
          "timestamp": 1676593269,
          "media": {
            "image": "https://nft-media.staging.defined.fi/image/0x76be3b62873462d2142405439777e971754e8e77:10551:1.webp",
            "thumbSm": "https://nft-media.staging.defined.fi/thumbSm/0x76be3b62873462d2142405439777e971754e8e77:10551:1.webp",
            "thumbLg": "https://nft-media.staging.defined.fi/thumbLg/0x76be3b62873462d2142405439777e971754e8e77:10551:1.webp"
          },
          "gameData": {
            "rarity": "Uncommon",
            "parallel": "Universal",
            "cost": "7",
            "attack": "10",
            "health": "3",
            "cardType": "Unit",
            "subtype": "Vehicle",
            "functionText": "When this Unit survives damage in combat, draw a card.",
            "passiveAbility": null
          },
          "metadata": {
            "class": "SE",
            "supply": "1000",
            "flavourText": "β€œCommander, it just came up on the star chart, it must have slipped in via an undesignated jump point - it looks like its an Ecehlon ship but it's not responding when hailed.”",
            "expansion": "Base Set",
            "paraset": "Pack Drop 3 [SE]",
            "artist": "Oscar Cafaro"
          }
        }
      ]
    }
  }
}

Explore

πŸ‘‹

Join our Discord

Ask questions, share what you're working on and request new features πŸ‘¬πŸ‘­