Reservoir · Schema

getUserCollectionsV4Response

NFTBlockchainMarketplaceEthereumEVMLiquidityOrder BookWeb3DeFiTradingData API

Properties

Name	Type	Description
collections	object

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/reservoir/json-schema/reservoir-get-user-collections-v4-response-schema.json",
  "title": "getUserCollectionsV4Response",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/reservoir-accounts-api-openapi.yml#/components/schemas/getUserCollectionsV4Response",
  "type": "object",
  "properties": {
    "collections": {
      "$ref": "#/$defs/Model381"
    }
  },
  "$defs": {
    "Model21": {
      "type": "object",
      "description": "Current rank based from overall volume",
      "properties": {
        "1day": {
          "type": "number"
        },
        "7day": {
          "type": "number"
        },
        "30day": {
          "type": "number"
        },
        "allTime": {
          "type": "number"
        }
      }
    },
    "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"
        }
      }
    },
    "Model376": {
      "type": "object",
      "description": "Current floor ask price",
      "properties": {
        "currency": {
          "$ref": "#/$defs/currency"
        },
        "amount": {
          "$ref": "#/$defs/amount"
        },
        "netAmount": {
          "$ref": "#/$defs/netAmount"
        }
      }
    },
    "Model377": {
      "type": "object",
      "description": "Top bid offer currently if offer is valid",
      "properties": {
        "currency": {
          "$ref": "#/$defs/currency"
        },
        "amount": {
          "$ref": "#/$defs/amount"
        },
        "netAmount": {
          "$ref": "#/$defs/netAmount"
        }
      }
    },
    "Model378": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Collection Id"
        },
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "isSpam": {
          "type": "boolean",
          "default": false
        },
        "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
        },
        "sampleImages": {
          "$ref": "#/$defs/sampleImages"
        },
        "tokenCount": {
          "type": "string",
          "description": "Total token count"
        },
        "tokenSetId": {
          "type": "string"
        },
        "primaryContract": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "floorAskPrice": {
          "$ref": "#/$defs/Model376"
        },
        "topBidValue": {
          "$ref": "#/$defs/Model377"
        },
        "topBidMaker": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "topBidSourceDomain": {
          "type": "string"
        },
        "rank": {
          "$ref": "#/$defs/Model21"
        },
        "volume": {
          "$ref": "#/$defs/volume"
        },
        "volumeChange": {
          "$ref": "#/$defs/Model28"
        },
        "floorSale": {
          "$ref": "#/$defs/floorSale"
        },
        "contractKind": {
          "type": "string",
          "description": "Returns `erc721`, `erc1155`, etc."
        }
      }
    },
    "Model379": {
      "type": "object",
      "properties": {
        "tokenCount": {
          "type": "string"
        },
        "onSaleCount": {
          "type": "string"
        },
        "liquidCount": {
          "type": "string"
        },
        "totalValue": {
          "type": "number"
        }
      }
    },
    "Model380": {
      "type": "object",
      "properties": {
        "collection": {
          "$ref": "#/$defs/Model378"
        },
        "ownership": {
          "$ref": "#/$defs/Model379"
        }
      }
    },
    "Model381": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Model380"
      }
    },
    "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"
        }
      }
    },
    "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"
        }
      }
    },
    "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"
        }
      }
    },
    "sampleImages": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "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-user-collections-v4-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.

GitHub Google LinkedIn

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