Reservoir · Schema

getCollectionsV7Response

NFTBlockchainMarketplaceEthereumEVMLiquidityOrder BookWeb3DeFiTradingData API

Properties

Name Type Description
continuation string
collections object
View JSON Schema on GitHub

JSON Schema

reservoir-get-collections-v7-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/reservoir/json-schema/reservoir-get-collections-v7-response-schema.json",
  "title": "getCollectionsV7Response",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/reservoir-collections-api-openapi.yml#/components/schemas/getCollectionsV7Response",
  "type": "object",
  "properties": {
    "continuation": {
      "type": "string"
    },
    "collections": {
      "$ref": "#/$defs/Model38"
    }
  },
  "$defs": {
    "Model16": {
      "type": "object",
      "properties": {
        "recipient": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$"
        },
        "bps": {
          "type": "number"
        }
      }
    },
    "Model17": {
      "type": "object",
      "properties": {
        "recipient": {
          "type": "string"
        },
        "breakdown": {
          "$ref": "#/$defs/breakdown"
        },
        "bps": {
          "type": "number"
        }
      }
    },
    "Model18": {
      "type": "object",
      "description": "Lowest Ask Price.",
      "properties": {
        "contract": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "tokenId": {
          "type": "string",
          "pattern": "^-?[0-9]+$"
        },
        "name": {
          "type": "string"
        },
        "image": {
          "type": "string"
        }
      }
    },
    "Model19": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "sourceDomain": {
          "type": "string"
        },
        "price": {
          "$ref": "#/$defs/price"
        },
        "maker": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "validFrom": {
          "type": "number"
        },
        "validUntil": {
          "type": "number"
        },
        "token": {
          "$ref": "#/$defs/Model18"
        }
      }
    },
    "Model20": {
      "type": "object",
      "description": "Highest current offer",
      "properties": {
        "id": {
          "type": "string"
        },
        "sourceDomain": {
          "type": "string"
        },
        "price": {
          "$ref": "#/$defs/price"
        },
        "maker": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "validFrom": {
          "type": "number"
        },
        "validUntil": {
          "type": "number"
        }
      }
    },
    "Model21": {
      "type": "object",
      "description": "Current rank based from overall volume",
      "properties": {
        "1day": {
          "type": "number"
        },
        "7day": {
          "type": "number"
        },
        "30day": {
          "type": "number"
        },
        "allTime": {
          "type": "number"
        }
      }
    },
    "Model23": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string",
          "description": "Case sensitive"
        },
        "kind": {
          "type": "string",
          "description": "`string`, `number`, `date`, or `range`"
        },
        "count": {
          "type": "number"
        }
      }
    },
    "Model24": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Model23"
      }
    },
    "Model28": {
      "type": "object",
      "description": "Total volume change X-days vs previous X-days. (e.g. 7day [days 1-7] vs 7day prior [days 8-14]). A value over 1 is a positive gain, under 1 is a negative loss. e.g. 1 means no change; 1.1 means 10% increase; 0.9 means 10% decrease.",
      "properties": {
        "1day": {
          "type": "number"
        },
        "7day": {
          "type": "number"
        },
        "30day": {
          "type": "number"
        }
      }
    },
    "Model29": {
      "type": "object",
      "description": "Floor sale change from X-days vs X-days ago. (e.g. 7day floor sale vs floor sale 14 days ago). A value over 1 is a positive gain, under 1 is a negative loss. e.g. 1 means no change; 1.1 means 10% increase; 0.9 means 10% decrease.",
      "properties": {
        "1day": {
          "type": "number"
        },
        "7day": {
          "type": "number"
        },
        "30day": {
          "type": "number"
        }
      }
    },
    "Model30": {
      "type": "object",
      "properties": {
        "price": {
          "$ref": "#/$defs/price"
        },
        "quantity": {
          "type": "number"
        }
      },
      "required": [
        "price"
      ]
    },
    "Model35": {
      "type": "object",
      "properties": {
        "stage": {
          "type": "string"
        },
        "tokenId": {
          "type": "string",
          "pattern": "^-?[0-9]+$"
        },
        "kind": {
          "type": "string"
        },
        "standard": {
          "type": "string"
        },
        "price": {
          "$ref": "#/$defs/price"
        },
        "pricePerQuantity": {
          "$ref": "#/$defs/pricePerQuantity"
        },
        "startTime": {
          "type": "number"
        },
        "endTime": {
          "type": "number"
        },
        "maxMints": {
          "type": "number"
        },
        "maxMintsPerWallet": {
          "type": "number"
        }
      },
      "required": [
        "stage",
        "kind"
      ]
    },
    "Model36": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Model35"
      }
    },
    "Model37": {
      "type": "object",
      "properties": {
        "chainId": {
          "type": "number"
        },
        "id": {
          "type": "string",
          "description": "Collection id"
        },
        "slug": {
          "type": "string",
          "description": "Open Sea slug"
        },
        "createdAt": {
          "type": "string",
          "description": "Time when added to indexer"
        },
        "updatedAt": {
          "type": "string",
          "description": "Time when updated in indexer"
        },
        "name": {
          "type": "string"
        },
        "symbol": {
          "type": "string"
        },
        "contractDeployedAt": {
          "type": "string",
          "description": "Time when contract was deployed"
        },
        "image": {
          "type": "string"
        },
        "banner": {
          "type": "string"
        },
        "discordUrl": {
          "type": "string"
        },
        "externalUrl": {
          "type": "string"
        },
        "twitterUsername": {
          "type": "string"
        },
        "twitterUrl": {
          "type": "string"
        },
        "openseaVerificationStatus": {
          "type": "string"
        },
        "magicedenVerificationStatus": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "metadataDisabled": {
          "type": "boolean",
          "default": false
        },
        "isSpam": {
          "type": "boolean",
          "default": false
        },
        "isNsfw": {
          "type": "boolean",
          "default": false
        },
        "isMinting": {
          "type": "boolean",
          "default": false
        },
        "sampleImages": {
          "$ref": "#/$defs/sampleImages"
        },
        "tokenCount": {
          "type": "string",
          "description": "Total tokens within the collection."
        },
        "onSaleCount": {
          "type": "string",
          "description": "Total tokens currently on sale."
        },
        "primaryContract": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "tokenSetId": {
          "type": "string"
        },
        "creator": {
          "type": "string"
        },
        "isSharedContract": {
          "type": "boolean",
          "default": false
        },
        "royalties": {
          "$ref": "#/$defs/Model17"
        },
        "allRoyalties": {
          "$ref": "#/$defs/metadata"
        },
        "floorAsk": {
          "$ref": "#/$defs/Model19"
        },
        "topBid": {
          "$ref": "#/$defs/Model20"
        },
        "rank": {
          "$ref": "#/$defs/Model21"
        },
        "volume": {
          "$ref": "#/$defs/volume"
        },
        "volumeChange": {
          "$ref": "#/$defs/Model28"
        },
        "floorSale": {
          "$ref": "#/$defs/floorSale"
        },
        "floorSaleChange": {
          "$ref": "#/$defs/Model29"
        },
        "salesCount": {
          "$ref": "#/$defs/salesCount"
        },
        "collectionBidSupported": {
          "type": "boolean",
          "description": "true or false"
        },
        "ownerCount": {
          "type": "number",
          "description": "Unique number of owners."
        },
        "attributes": {
          "$ref": "#/$defs/Model24"
        },
        "contractKind": {
          "type": "string",
          "description": "Returns `erc721`, `erc1155`, etc."
        },
        "mintedTimestamp": {
          "type": "number"
        },
        "lastMintTimestamp": {
          "type": "number"
        },
        "mintStages": {
          "$ref": "#/$defs/Model36"
        },
        "securityConfig": {
          "$ref": "#/$defs/securityConfig"
        },
        "supply": {
          "type": "number"
        },
        "remainingSupply": {
          "type": "number"
        }
      },
      "required": [
        "chainId"
      ]
    },
    "Model38": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Model37"
      }
    },
    "amount": {
      "type": "object",
      "description": "Amount with fees & royalties included.",
      "properties": {
        "raw": {
          "type": "string",
          "pattern": "^-?[0-9]+$"
        },
        "decimal": {
          "type": "number"
        },
        "usd": {
          "type": "number"
        },
        "native": {
          "type": "number"
        }
      }
    },
    "breakdown": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Model16"
      }
    },
    "currency": {
      "type": "object",
      "properties": {
        "contract": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$"
        },
        "name": {
          "type": "string"
        },
        "symbol": {
          "type": "string"
        },
        "decimals": {
          "type": "number"
        },
        "chainId": {
          "type": "number"
        }
      }
    },
    "floorSale": {
      "type": "object",
      "description": "The floor sale from X-days ago.",
      "properties": {
        "1day": {
          "type": "number"
        },
        "7day": {
          "type": "number"
        },
        "30day": {
          "type": "number"
        }
      }
    },
    "metadata": {
      "type": "object"
    },
    "netAmount": {
      "type": "object",
      "description": "Amount with fees & royalties removed.",
      "properties": {
        "raw": {
          "type": "string",
          "pattern": "^-?[0-9]+$"
        },
        "decimal": {
          "type": "number"
        },
        "usd": {
          "type": "number"
        },
        "native": {
          "type": "number"
        }
      }
    },
    "operatorWhitelist": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^0x[a-fA-F0-9]{40}$",
        "x-convert": {
          "case": "lower"
        }
      }
    },
    "price": {
      "type": "object",
      "properties": {
        "currency": {
          "$ref": "#/$defs/currency"
        },
        "amount": {
          "$ref": "#/$defs/amount"
        },
        "netAmount": {
          "$ref": "#/$defs/netAmount"
        }
      }
    },
    "pricePerQuantity": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Model30"
      }
    },
    "salesCount": {
      "type": "object",
      "description": "Number of sales of X-days period",
      "properties": {
        "1day": {
          "type": "number"
        },
        "7day": {
          "type": "number"
        },
        "30day": {
          "type": "number"
        },
        "allTime": {
          "type": "number"
        }
      }
    },
    "sampleImages": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "securityConfig": {
      "type": "object",
      "properties": {
        "operatorWhitelist": {
          "$ref": "#/$defs/operatorWhitelist"
        },
        "operatorBlacklist": {
          "$ref": "#/$defs/operatorWhitelist"
        },
        "receiverAllowList": {
          "$ref": "#/$defs/operatorWhitelist"
        },
        "authorizers": {
          "$ref": "#/$defs/operatorWhitelist"
        },
        "transferSecurityLevel": {
          "type": "number"
        },
        "transferValidator": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        }
      }
    },
    "volume": {
      "type": "object",
      "description": "Total volume in given time period.",
      "properties": {
        "1day": {
          "type": "number"
        },
        "7day": {
          "type": "number"
        },
        "30day": {
          "type": "number"
        },
        "allTime": {
          "type": "number"
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/reservoir-get-collections-v7-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.