7mtmajty.nx.link

{
  "parameters": [
    {
      "description": "A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).",
      "in": "path",
      "name": "address",
      "required": true,
      "schema": {
        "description": "A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).",
        "type": "string"
      }
    },
    {
      "description": "Chain ID(s) to request NFT data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137",
      "in": "query",
      "name": "chainId",
      "required": true,
      "schema": {
        "description": "Chain ID(s) to request NFT data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137",
        "items": {
          "type": "integer"
        },
        "maxItems": 50,
        "minItems": 1,
        "type": "array"
      }
    },
    {
      "description": "NFT contract addresses to filter by. If provided, only NFTs with these addresses will be returned.",
      "in": "query",
      "name": "contractAddresses",
      "required": false,
      "schema": {
        "description": "NFT contract addresses to filter by. If provided, only NFTs with these addresses will be returned.",
        "items": {
          "type": "string"
        },
        "maxItems": 50,
        "minItems": 1,
        "type": "array"
      }
    },
    {
      "description": "The number of NFTs to return per chain (default: 20, max: 500).",
      "in": "query",
      "name": "limit",
      "required": false,
      "schema": {
        "default": 20,
        "description": "The number of NFTs to return per chain (default: 20, max: 500).",
        "maximum": 500,
        "minimum": 1,
        "type": "integer"
      }
    },
    {
      "description": "The page number for pagination (default: 1, max: 20).",
      "in": "query",
      "name": "page",
      "required": false,
      "schema": {
        "default": 1,
        "description": "The page number for pagination (default: 1, max: 20).",
        "maximum": 20,
        "minimum": 1,
        "type": "integer"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "result": {
                "properties": {
                  "nfts": {
                    "description": "Array of wallet NFTs.",
                    "items": {
                      "properties": {
                        "animation_url": {
                          "description": "The animation URL of the NFT",
                          "type": "string"
                        },
                        "attributes": {
                          "description": "The attributes/traits of the NFT",
                          "items": {
                            "properties": {
                              "display_type": {
                                "description": "The display type",
                                "type": "string"
                              },
                              "trait_type": {
                                "description": "The trait type",
                                "type": "string"
                              },
                              "value": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "number"
                                  }
                                ],
                                "description": "The trait value"
                              }
                            },
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "chain_id": {
                          "description": "The chain ID of the NFT",
                          "type": "number"
                        },
                        "collection": {
                          "description": "Collection information",
                          "properties": {
                            "description": {
                              "description": "The collection description",
                              "type": "string"
                            },
                            "external_url": {
                              "description": "The collection external URL",
                              "type": "string"
                            },
                            "image": {
                              "description": "The collection image URL",
                              "type": "string"
                            },
                            "name": {
                              "description": "The collection name",
                              "type": "string"
                            }
                          },
                          "type": "object"
                        },
                        "description": {
                          "description": "The description of the NFT",
                          "type": "string"
                        },
                        "external_url": {
                          "description": "The external URL of the NFT",
                          "type": "string"
                        },
                        "image_url": {
                          "description": "The image URL of the NFT",
                          "type": "string"
                        },
                        "metadata": {
                          "additionalProperties": {},
                          "description": "Additional metadata for the NFT",
                          "type": "object"
                        },
                        "name": {
                          "description": "The name of the NFT",
                          "type": "string"
                        },
                        "token_address": {
                          "description": "The contract address of the NFT collection",
                          "type": "string"
                        },
                        "token_id": {
                          "description": "The token ID of the NFT",
                          "type": "string"
                        }
                      },
                      "required": [
                        "chain_id",
                        "token_address",
                        "token_id"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "pagination": {
                    "properties": {
                      "hasMore": {
                        "description": "Whether there are more items available",
                        "type": "boolean"
                      },
                      "limit": {
                        "default": 20,
                        "description": "Number of items per page",
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "page": {
                        "default": 1,
                        "description": "Current page number",
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "totalCount": {
                        "description": "Total number of items available",
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    },
                    "type": "object"
                  }
                },
                "required": [
                  "nfts",
                  "pagination"
                ],
                "type": "object"
              }
            },
            "required": [
              "result"
            ],
            "type": "object"
          }
        }
      },
      "description": "Wallet NFTs retrieved successfully. Returns NFT data with metadata including pagination information and chain details. Includes NFT metadata, attributes, and collection information when available."
    },
    "400": {
      "description": "Invalid request parameters. This occurs when the wallet address format is invalid, chainId array is empty or exceeds the maximum limit of 50, or pagination parameters are out of range."
    },
    "401": {
      "description": "Authentication required. The request must include a valid `x-client-id` header for frontend usage or `x-secret-key` for backend usage."
    },
    "404": {
      "description": "Wallet not found or no NFTs available for the specified wallet address on the given blockchain networks."
    },
    "500": {
      "description": "Internal server error. This may occur due to network connectivity issues, external service unavailability, or unexpected server errors."
    }
  }
}