Filter NSFW NFTs

Introducing the NSFW filtering feature for NFTs! With this new functionality, you can easily filter out Not Safe For Work (NSFW) NFTs.

Filter out your NFTs that are marked as NSFW using the includeNsfw boolean query param that applies only to the following three endpoints:

1. Get NFTs by walletId: reference

2. Get NFTs by Chain: reference

3. Get NFTs by Chain and Wallet Address: reference

You will receive a contract.isNsfw boolean in the response body for all of the above endpoints and the following endpoints:

1. Get NFTs by Chain and Contract Address: reference

2. Get NFTs by Chain, Contract Address, and tokenId: reference

📘

includeNsfw query boolean param explained:

• The includeNsfw query param is set to false by default.

• If the includeNsfw query param is set to false, the response body will only return the non-NSFW results.

• If the includeNsfw query param is set to true, the response body will return all the results (NSFW + non-NSFW).

Example Request: reference

The following endpoint retrieves NFTs by chain and wallet address:

HTTP

GET /api/wallets/MATIC/0x7312750DF4d2057b758a61C7017729c6Ec9bB3E9/nonfungibles?includeNsfw=true

Parameter	Param Type	Description	Data Type	Value	Mandatory
includeNsfw	Query	Indication to include possible NSFW NFTs in the response body or not.	Boolean	true	❌

Response Body

📘

Look for the result.contract.isNsfw parameter:

• If the contract.isNsfw is true, it indicates that your NFT collection is possibly NSFW.

• If the contract.isNsfw is false, it indicates that your NFT collection is possibly non-NSFW.

• If the contract.isNsfw param is not returned in the response body, this means the data was not returned by the blockchain provider. You can try again later.

JSON

{
    "success": true,
    "result": [
        {
            "id": "0",
            "name": "$1000 USDC",
            "description": "Owning this badge indicates that the user has received $1000 USDC Airdrop.",
            "imageUrl": "https://cdn.simplehash.com/assets/594f84cd22e8882adac0eee49f44fa0916f67f9c25a408b80220ced34f39ea9d.jpg",
            "imagePreviewUrl": "https://lh3.googleusercontent.com/5ooylv-qDiIq03F6tbNY71Gr8dW5uKT4b6TEq6bq8XVlvltEWtbAva_jVuQ3PXR-2GitF4bWAUlyb0ydWBX5Bl71pOBr5x7qlg",
            "imageThumbnailUrl": "https://lh3.googleusercontent.com/5ooylv-qDiIq03F6tbNY71Gr8dW5uKT4b6TEq6bq8XVlvltEWtbAva_jVuQ3PXR-2GitF4bWAUlyb0ydWBX5Bl71pOBr5x7qlg=s250",
            "animationUrls": [],
            "fungible": true,
            "contract": {
                "name": "$1000 USDC",
                "address": "0x43d5ebed23900fd83c5d5327ba1e86afbe1d84a9",
                "symbol": "$1000 USDC",
                "media": [
                    {
                        "type": "image",
                        "value": "https://lh3.googleusercontent.com/tagPtZl7s_SdQ0hAR0PtSTGlUEJnGjV3TV2VCdYZEFPevsSTrDCtuDjIxDwHDBGZDr0kmhv2egD_8nouWGBRy3iuG7zMLmRSX_U"
                    }
                ],
                "type": "ERC_1155",
                "verified": false,
                "premium": false,
                "isNsfw": false,
                "categories": [],
                "imageUrl": "https://lh3.googleusercontent.com/tagPtZl7s_SdQ0hAR0PtSTGlUEJnGjV3TV2VCdYZEFPevsSTrDCtuDjIxDwHDBGZDr0kmhv2egD_8nouWGBRy3iuG7zMLmRSX_U"
            },
            "attributes": [],
            "balance": 1,
            "finalBalance": 1,
            "transferFees": false
        },