Reservoir Owners API

openapi: 3.2.0
info:
  title: Reservoir Owners API
  version: 5.296.1
  description: You are viewing the reference docs for the Reservoir API. For a more complete overview with guides and examples, check out the Reservoir Protocol Docs.
servers:
- url: https://api.reservoir.tools
  description: Ethereum
- url: https://api-polygon.reservoir.tools
  description: Polygon
- url: https://api-base.reservoir.tools
  description: Base
- url: https://api-abstract.reservoir.tools
  description: Abstract
- url: https://api-abstract-testnet.reservoir.tools
  description: Abstract Testnet
- url: https://api-ancient8.reservoir.tools
  description: Ancient8
- url: https://api-ancient8-testnet.reservoir.tools
  description: Ancient8 Testnet
- url: https://api-anime-testnet.reservoir.tools
  description: Anime Testnet
- url: https://api-apechain.reservoir.tools
  description: Apechain
- url: https://api-apex.reservoir.tools
  description: Apex
- url: https://api-apex-testnet.reservoir.tools
  description: Apex Testnet
- url: https://api-arbitrum.reservoir.tools
  description: Arbitrum
- url: https://api-arbitrum-nova.reservoir.tools
  description: Arbitrum Nova
- url: https://api-astar-zkevm.reservoir.tools
  description: Astar zkEVM
- url: https://api-avalanche.reservoir.tools
  description: Avalanche
- url: https://api-amoy.reservoir.tools
  description: Amoy
- url: https://api-base-sepolia.reservoir.tools
  description: Base Sepolia
- url: https://api-berachain.reservoir.tools
  description: Berachain
- url: https://api-berachain-testnet.reservoir.tools
  description: Berachain Testnet
- url: https://api-b3.reservoir.tools
  description: B3
- url: https://api-b3-testnet.reservoir.tools
  description: B3 Testnet
- url: https://api-bitlayer.reservoir.tools
  description: Bitlayer
- url: https://api-blast.reservoir.tools
  description: Blast
- url: https://api-blast-sepolia.reservoir.tools
  description: Blast Sepolia
- url: https://api-boss.reservoir.tools
  description: Boss
- url: https://api-bsc.reservoir.tools
  description: Binance Smart Chain
- url: https://api-cloud.reservoir.tools
  description: Cloud
- url: https://api-creator-testnet.reservoir.tools
  description: Creator Testnet
- url: https://api-curtis.reservoir.tools
  description: Curtis
- url: https://api-cyber.reservoir.tools
  description: Cyber
- url: https://api-degen.reservoir.tools
  description: Degen
- url: https://api-flow.reservoir.tools
  description: Flow
- url: https://api-forma.reservoir.tools
  description: Forma
- url: https://api-forma-sketchpad.reservoir.tools
  description: Forma Sketchpad
- url: https://api-frame-testnet.reservoir.tools
  description: Frame Testnet
- url: https://api-game7.reservoir.tools
  description: Game7
- url: https://api-game7-testnet.reservoir.tools
  description: Game7 Testnet
- url: https://api-hychain.reservoir.tools
  description: Hychain
- url: https://api-hychain-testnet.reservoir.tools
  description: Hychain Testnet
- url: https://api-ink.reservoir.tools
  description: Ink
- url: https://api-linea.reservoir.tools
  description: Linea
- url: https://api-minato.reservoir.tools
  description: Minato
- url: https://api-monad-testnet.reservoir.tools
  description: Monad Testnet
- url: https://api-nebula.reservoir.tools
  description: Nebula
- url: https://api-opbnb.reservoir.tools
  description: OPBNB
- url: https://api-optimism.reservoir.tools
  description: Optimism
- url: https://api-polygon-zkevm.reservoir.tools
  description: Polygon zkEVM
- url: https://api-redstone.reservoir.tools
  description: Redstone
- url: https://api-scroll.reservoir.tools
  description: Scroll
- url: https://api-sei.reservoir.tools
  description: Sei
- url: https://api-sei-testnet.reservoir.tools
  description: Sei Testnet
- url: https://api-sepolia.reservoir.tools
  description: Sepolia
- url: https://api-shape.reservoir.tools
  description: Shape
- url: https://api-shape-sepolia.reservoir.tools
  description: Shape Sepolia
- url: https://api-soneium.reservoir.tools
  description: Soneium
- url: https://api-story-odyssey.reservoir.tools
  description: Story Odyssey
- url: https://api-xai.reservoir.tools
  description: Xai
- url: https://api-zero.reservoir.tools
  description: Zero
- url: https://api-zero-testnet.reservoir.tools
  description: Zero Testnet
- url: https://api-zksync.reservoir.tools
  description: zkSync
- url: https://api-zora.reservoir.tools
  description: Zora
security:
- API_KEY: []
tags:
- name: Owners
paths:
  /collections-sets/{collectionsSetId}/owners-distribution/v1:
    get:
      summary: Owners Collection Set Distribution
      operationId: getCollectionssetsCollectionssetidOwnersdistributionV1
      description: This API can be used to show what the distribution of owners in a collections set id looks like.
      parameters:
      - description: 'Filter to a particular collections set. Example: `8daa732ebe5db23f267e58d52f1c9b1879279bcdf4f78b8fb563390e6946ea65`'
        x-convert:
          case: lower
        name: collectionsSetId
        in: path
        required: true
        schema:
          type: string
      tags:
      - Owners
      responses:
        '200':
          description: Successful
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/getCollectionsSetOwnersDistributionV1Response'
      x-order: 6
  /collections/{collection}/owners-distribution/v1:
    get:
      summary: Owners Collection Distribution
      operationId: getCollectionsCollectionOwnersdistributionV1
      description: This API can be used to show what the distribution of owners in a collection looks like.
      parameters:
      - description: 'Filter to a particular collection with collection-id. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
        x-convert:
          case: lower
        name: collection
        in: path
        required: true
        schema:
          type: string
      tags:
      - Owners
      responses:
        '200':
          description: Successful
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/getCollectionOwnersDistributionV1Response'
      x-order: 6
  /owners/common-collections/v1:
    get:
      summary: Common Collections
      operationId: getOwnersCommoncollectionsV1
      description: This API can be used to find top common collections from an array of owners.
      parameters:
      - description: 'Array of owner addresses. Max limit is 50. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
        x-alternatives:
        - type: array
          description: 'Array of owner addresses. Max limit is 50. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
          minItems: 1
          maxItems: 50
          items:
            type: string
            pattern: ^0x[a-fA-F0-9]{40}$
            x-convert:
              case: lower
          collectionFormat: multi
          name: owners
        - type: string
          description: 'Array of owner addresses. Max limit is 50. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
          pattern: ^0x[a-fA-F0-9]{40}$
          x-convert:
            case: lower
        name: owners
        in: query
        required: true
        explode: true
        schema:
          type: array
          items:
            type: string
            pattern: ^0x[a-fA-F0-9]{40}$
            x-convert:
              case: lower
          minItems: 1
          maxItems: 50
      - description: Amount of collections returned in response. Max limit is 100. defaults to **20**
        name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
      tags:
      - Owners
      responses:
        '200':
          description: Successful
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/getCommonCollectionsOwnersV1Response'
      x-order: 6
  /owners/cross-collections/v1:
    get:
      summary: Owners intersection
      operationId: getOwnersCrosscollectionsV1
      description: Find which addresses own the most of a group of collections.
      parameters:
      - description: 'Filter to one or more collections. Max limit is 5. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
        x-alternatives:
        - type: array
          description: 'Filter to one or more collections. Max limit is 5. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
          minItems: 1
          maxItems: 5
          items:
            type: string
            pattern: ^0x[a-fA-F0-9]{40}$
            x-convert:
              case: lower
          collectionFormat: multi
          name: collections
        - type: string
          description: 'Filter to one or more collections. Max limit is 5. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
          pattern: ^0x[a-fA-F0-9]{40}$
          x-convert:
            case: lower
        name: collections
        in: query
        required: true
        explode: true
        schema:
          type: array
          items:
            type: string
            pattern: ^0x[a-fA-F0-9]{40}$
            x-convert:
              case: lower
          minItems: 1
          maxItems: 5
      - description: Amount of owners returned in response. Max limit is 50. defaults to **20**
        name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 50
      tags:
      - Owners
      responses:
        '200':
          description: Successful
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/getCrossCollectionsOwnersV1Response'
      x-order: 6
  /owners/v2:
    get:
      summary: Owners
      operationId: getOwnersV2
      description: Get owners with various filters applied, and a summary of their ownership. Useful for exploring top owners in a collection or attribute.
      parameters:
      - description: 'Filter to a particular collection set id. Example: `8daa732ebe5db23f267e58d52f1c9b1879279bcdf4f78b8fb563390e6946ea65`'
        x-convert:
          case: lower
        name: collectionsSetId
        in: query
        schema:
          type: string
      - description: 'Filter to a particular collection with collection-id. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
        x-convert:
          case: lower
        name: collection
        in: query
        schema:
          type: string
      - description: 'Filter to a particular contract. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
        x-convert:
          case: lower
        name: contract
        in: query
        schema:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}$
      - description: 'Filter to a particular token. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:123`'
        x-convert:
          case: lower
        name: token
        in: query
        schema:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}:[0-9]+$
      - description: 'Filter to a particular attribute. Attributes are case sensitive. Note: Our docs do not support this parameter correctly. To test, you can use the following URL in your browser. Example: `https://api.reservoir.tools/owners/v1?collection=0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63&attribute[Type]=Original` or `https://api.reservoir.tools/owners/v1?collection=0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63&attribute[Type]=Original&attribute[Type]=Sibling`'
        name: attributes
        in: query
        x-type: object
        schema:
          type: string
      - description: Use offset to request the next batch of items. defaults to **0**
        name: offset
        in: query
        schema:
          type: integer
          minimum: 0
      - description: Amount of items returned in response. Max limit is 500. defaults to **20**
        name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 500
      - description: Input any ERC20 address to return result in given currency
        x-convert:
          case: lower
        name: displayCurrency
        in: query
        schema:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}$
      tags:
      - Owners
      responses:
        '200':
          description: Successful
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/getOwnersV2Response'
      x-order: 6
components:
  schemas:
    Model304:
      type: object
      properties:
        tokenCount:
          type: number
        ownerCount:
          type: number
          description: The amount of owners with the same `tokenCount`.
    Model209:
      type: array
      items:
        $ref: '#/components/schemas/Model208'
    topBidValue:
      type: object
      description: Can return `null` if there are no bids
      properties:
        currency:
          $ref: '#/components/schemas/currency'
        amount:
          $ref: '#/components/schemas/amount'
        netAmount:
          $ref: '#/components/schemas/netAmount'
    getCommonCollectionsOwnersV1Response:
      type: object
      properties:
        collections:
          $ref: '#/components/schemas/Model207'
    Model206:
      type: object
      properties:
        address:
          type: string
          description: Contract address
        count:
          type: number
          description: Token count
        owners:
          $ref: '#/components/schemas/sampleImages'
    Model51:
      type: array
      items:
        $ref: '#/components/schemas/Model50'
    getCrossCollectionsOwnersV1Response:
      type: object
      properties:
        owners:
          $ref: '#/components/schemas/Model209'
    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
    Model207:
      type: array
      items:
        $ref: '#/components/schemas/Model206'
    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
    Model49:
      type: object
      properties:
        tokenCount:
          type: string
        onSaleCount:
          type: string
        floorAskPrice:
          $ref: '#/components/schemas/floorAskPrice'
        topBidValue:
          $ref: '#/components/schemas/topBidValue'
        totalBidValue:
          $ref: '#/components/schemas/topBidValue'
    getCollectionsSetOwnersDistributionV1Response:
      type: object
      properties:
        ownersDistribution:
          $ref: '#/components/schemas/Model305'
    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
    Model50:
      type: object
      properties:
        address:
          type: string
        ownership:
          $ref: '#/components/schemas/Model49'
    ownersDistribution:
      type: array
      items:
        $ref: '#/components/schemas/Model289'
    Model289:
      type: object
      properties:
        tokenCount:
          type: number
        ownerCount:
          type: number
          description: The amount of owners that have the same `tokenCount`.
    sampleImages:
      type: array
      items:
        type: string
    getOwnersV2Response:
      type: object
      properties:
        owners:
          $ref: '#/components/schemas/Model51'
    Model208:
      type: object
      properties:
        address:
          type: string
          description: Wallet Address
        count:
          type: number
          description: Token Count
        collections:
          $ref: '#/components/schemas/sampleImages'
    getCollectionOwnersDistributionV1Response:
      type: object
      properties:
        ownersDistribution:
          $ref: '#/components/schemas/ownersDistribution'
    Model305:
      type: array
      items:
        $ref: '#/components/schemas/Model304'
    floorAskPrice:
      type: object
      description: Can return `null` if there is no Floor Ask
      properties:
        currency:
          $ref: '#/components/schemas/currency'
        amount:
          $ref: '#/components/schemas/amount'
        netAmount:
          $ref: '#/components/schemas/netAmount'
  securitySchemes:
    API_KEY:
      type: apiKey
      name: x-api-key
      in: header
      x-default: demo-api-key
x-alt-definitions:
  data:
    type: object
    properties:
      collectionId:
        type: string
      collectionName:
        type: string
      tokenName:
        type: string
      image:
        type: string
  metadata:
    type: object
    properties:
      kind:
        type: string
        enum:
        - token
      data:
        $ref: '#/x-alt-definitions/data'
  Model1:
    type: object
    properties:
      collectionId:
        type: string
      collectionName:
        type: string
      image:
        type: string
  Model2:
    type: object
    properties:
      kind:
        type: string
        enum:
        - collection
      data:
        $ref: '#/x-alt-definitions/Model1'
  Model3:
    type: object
    properties:
      key:
        type: string
      value:
        type: string
    required:
    - value
  attributes:
    type: array
    items:
      $ref: '#/x-alt-definitions/Model3'
  Model4:
    type: object
    properties:
      collectionId:
        type: string
      collectionName:
        type: string
      attributes:
        $ref: '#/x-alt-definitions/attributes'
      image:
        type: string
  Model5:
    type: object
    properties:
      kind:
        type: string
        enum:
        - attribute
      data:
        $ref: '#/x-alt-definitions/Model4'
  token:
    type: object
    properties:
      tokenId:
        type: string
        pattern: ^-?[0-9]+$
      name:
        type: string
      image:
        type: string
      isSpam:
        type: boolean
      isNsfw:
        type: boolean
  collection:
    type: object
    properties:
      id:
        type: string
      name:
        type: string
      image:
        type: string
      isSpam:
        type: boolean
      isNsfw:
        type: boolean
  Model6:
    type: object
    properties:
      token:
        $ref: '#/x-alt-definitions/token'
      collection:
        $ref: '#/x-alt-definitions/collection'
  criteria:
    type: object
    properties:
      kind:
        type: string
        enum:
        - token
      data:
        $ref: '#/x-alt-definitions/Model6'
  Model7:
    type: object
    properties:
      collection:
        $ref: '#/x-alt-definitions/collection'
  Model8:
    type: object
    properties:
      kind:
        type: string
        enum:
        - collection
      data:
        $ref: '#/x-alt-definitions/Model7'
  Model9:
    type: object
    properties:
      collection:
        $ref: '#/x-alt-definitions/collection'
      attribute:
        $ref: '#/x-alt-definitions/Model3'
  Model10:
    type: object
    properties:
      kind:
        type: string
        enum:
        - attribute
      data:
        $ref: '#/x-alt-definitions/Model9'
  Model11:
    type: object
    properties:
      tokenSetId:
        type: string
  Model12:
    type: object
    properties:
      kind:
        type: string
        enum:
        - custom
      data:
        $ref: '#/x-alt-definitions/Model11'
  Model13:
    type: object
    properties:
      collectionName:
        type: string
      tokenName:
        type: string
      image:
        type: string
  Model14:
    type: object
    properties:
      kind:
        type: string
        enum:
        - token
      data:
        $ref: '#/x-alt-definitions/Model13'
  Model15:
    type: object
    properties:
      collectionName:
        type: string
      image:
        type: string
  Model16:
    type: object
    properties:
      kind:
        type: string
        enum:
        - collection
      data:
        $ref: '#/x-alt-definitions/Model15'
  Model17:
    type: object
    properties:
      collectionName:
        type: string
      attributes:
        $ref: '#/x-alt-definitions/attributes'
      image:
        type: string
  Model18:
    type: object
    properties:
      kind:
        type: string
        enum:
        - attribute
      data:
        $ref: '#/x-alt-definitions/Model17'
  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
  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
  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
  start:
    type: object
    properties:
      currency:
        $ref: '#/x-alt-definitions/currency'
      amount:
        $ref: '#/x-alt-definitions/amount'
      netAmount:
        $ref: '#/x-alt-definitions/netAmount'
  price:
    type: object
    properties:
      start:
        $ref: '#/x-alt-definitions/start'
      end:
        $ref: '#/x-alt-definitions/start'
  time:
    type: object
    properties:
      start:
        type: number
      end:
        type: number
  Model19:
    type: object
    properties:
      price:
        $ref: '#/x-alt-definitions/price'
      time:
        $ref: '#/x-alt-definitions/time'
  dynamicPricing:
    type: object
    properties:
      kind:
        type: string
        enum:
        - dutch
      data:
        $ref: '#/x-alt-definitions/Model19'
  prices:
    type: array
    items:
      $ref: '#/x-alt-definitions/start'
  Model20:
    type: object
    properties:
      pool:
        type: string
      prices:
        $ref: '#/x-alt-definitions/prices'
  Model21:
    type: object
    properties:
      kind:
        type: string
        enum:
        - pool
      data:
        $ref: '#/x-alt-definitions/Model20'
  Model22:
    type: object
    properties:
      fromBlock:
        type: number
      toBlock:
        type: number
      blockRange:
        type: number
    required:
    - fromBlock
    - toBlock
  Model23:
    type: object
    properties:
      kind:
        type: string
        enum:
        - all
      data:
        $ref: '#/x-alt-definitions/Model22'
  Model24:
    type: object
    properties:
      contract:
        type: string
        pattern: ^0x[a-fA-F0-9]{40}$
      fromTimestamp:
        type: number
      toTimestamp:
        type: number
      timestampRange:
        type: number
    required:
    - contract
    - fromTimestamp
    - toTimestamp
  Model25:
    type: object
    properties:
      kind:
        type: string
        enum:
        - contract
      data:
        $ref: '#/x-alt-definitions/Model24'
  Model26:
    type: object
    properties:
      txHash:
        type: string
        pattern: ^0x[a-fA-F0-9]{64}$
    required:
    - txHash
  Model27:
    type: object
    properties:
      kind:
        type: string
        enum:
        - transaction
      data:
        $ref: '#/x-alt-definitions/Model26'
  events:
    type: array
    items:
      type: string
  eventsType:
    type: array
    items:
      type: string
      enum:
      - ftTransferEvents
  syncDetails:
    type: object
    properties:
      method:
        type: string
        enum:
        - events
      events:
        $ref: '#/x-alt-definitions/events'
      eventsType:
        $ref: '#/x-alt-definitions/eventsType'
  Model28:
    type: object
    properties:
      method:
        type: string
        enum:
        - address
      address:
        type: string
        pattern: ^0x[a-fA-F0-9]{40}$
  collections:
    type: array
    description: 'Array of collection ids to disable metadata for. Max limit is 50. Example: `collections[0]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63 collections[1]: 0x521f9c7505005cfa19a8e5786a9c3c9c9f5e6f42`'
    maxItems: 50
    items:
      type: string
      x-convert:
        case: lower
  Model29:
    type: array
    description: 'Update to one or more collections. Max limit is 50. Example: `0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63`'
    minItems: 1
    maxItems: 50
    items:
      type: string
      x-convert:
        case: lower
  exactOrderSource:
    type: array
    maxItems: 2
    items:
      type: string
      pattern: ^[a-zA-Z0-9.-]+\.[a-zA-Z0-9]{2,}$|localhost
      x-convert:
        case: lower
  ids:
    type: array
    description: 'Array of order ids to invalidate. Max limit is 50. Example: `ids[0]: 0x505b35e849bccbd787bf670b3e85577fa5c2814cfa0ecab50867e4dc5b5362d4 ids[1]: 0xd0e83bdeb5b79352d4a3657387d1e438e9df68d773bb3b3c88da41948ef48188`'
    maxItems: 50
    items:
      type: string
  tokens:
    type: array
    description: 'Array of tokens to disable or reenable metadata for. Max limit is 50. Example: `tokens[0]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:704 tokens[1]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:979`'
    maxItems: 50
    items:
      type: string
      pattern: ^0x[a-fA-F0-9]{40}:[0-9]+$
      x-convert:
        case: lower
  Model30:
    type: array
    description: 'Array of tokens. Max limit is 50. Example: `tokens[0]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:704 tokens[1]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:979`'
    maxItems: 50
    items:
      type: string
      pattern: ^0x[a-fA-F0-9]{40}:[0-9]+$
      x-convert:
        case: lower
  Model31:
    type: array
    description: 'Array of tokens to refresh. Max limit is 50. Example: `tokens[0]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:704 tokens[1]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:979`'
    maxItems: 50
    items:
      type: string
      pattern: ^0x[a-fA-F0-9]{40}:[0-9]+$
      x-convert:
        case: lower
x-provenance:
  method: searched
  source: https://nft.reservoir.tools/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://nft.reservoir.tools/reference/getapikeyskeyratelimits.md
  - https://nft.reservoir.tools/reference/getchainstatsv1.md
  - https://nft.reservoir.tools/reference/getcollectionsactivityv6.md
  - https://nft.reservoir.tools/reference/getcollectionscollectionattributesallv4.md
  - https://nft.reservoir.tools/reference/getcollectionscollectionattributesexplorev6.md
  - https://nft.reservoir.tools/reference/getcollectionscollectionidbidsv1.md
  - https://nft.reservoir.tools/reference/getcollectionscollectionmarketplaceconfigurationsv2.md
  - https://nft.reservoir.tools/reference/getcollectionscollectionownersdistributionv1.md
  - https://nft.reservoir.tools/reference/getcollectionscollectiontoptradersv1.md
  - https://nft.reservoir.tools/reference/getcollectionsdailyvolumesv1.md
  - https://nft.reservoir.tools/reference/getcollectionssearchv1.md
  - https://nft.reservoir.tools/reference/getcollectionssetscollectionssetidownersdistributionv1.md
  - https://nft.reservoir.tools/reference/getcollectionstrendingmintsv1.md
  - https://nft.reservoir.tools/reference/getcollectionstrendingmintsv2.md
  - https://nft.reservoir.tools/reference/getcollectionstrendingv1.md
  - https://nft.reservoir.tools/reference/getcollectionsv7.md
  - https://nft.reservoir.tools/reference/getcrosspostingordersv1.md
  - https://nft.reservoir.tools/reference/geteventsasksv3.md
  - https://nft.reservoir.tools/reference/geteventsbidsv3.md
  - https://nft.reservoir.tools/reference/geteventscollectionsflooraskv2.md
  - https://nft.reservoir.tools/reference/geteventscollectionstopbidv2.md
  - https://nft.reservoir.tools/reference/geteventstokensflooraskv4.md
  - https://nft.reservoir.tools/reference/getordersasksv5.md
  - https://nft.reservoir.tools/reference/getordersbidsv6.md
  - https://nft.reservoir.tools/reference/getordersdepthv1.md
  - https://nft.reservoir.tools/reference/getordersusersusertopbidsv4.md
  - https://nft.reservoir.tools/reference/getownerscommoncollectionsv1.md
  - https://nft.reservoir.tools/reference/getownerscrosscollectionsv1.md
  - https://nft.reservoir.tools/reference/getownersv2.md
  - https://nft.reservoir.tools/reference/getredirectcollectionscollectionimagev1.md
  - https://nft.reservoir.tools/reference/getredirectcurrencyaddressiconv1.md
  - https://nft.reservoir.tools/reference/getredirectsourcessourcelogov2.md
  - https://nft.reservoir.tools/reference/getredirectsourcessourcetokenstokenlinkv2.md
  - https://nft.reservoir.tools/reference/getredirecttokenstokenimagev1.md
  - https://nft.reservoir.tools/reference/getsalesv6.md
  - https://nft.reservoir.tools/reference/getsearchcollectionsv2.md
  - https://nft.reservoir.tools/reference/getsourcesv1.md
  - https://nft.reservoir.tools/reference/getstatsv2.md
  - https://nft.reservoir.tools/reference/gettokensbootstrapv1.md
  - https://nft.reservoir.tools/reference/gettokensflagchangesv1.md
  - https://nft.reservoir.tools/reference/gettokensfloorv1.md
  - https://nft.reservoir.tools/reference/gettokensidsv1.md
  - https://nft.reservoir.tools/reference/gettokenstokenactivityv5.md
  - https://nft.reservoir.tools/reference/gettokenstokenasksv1.md
  - https://nft.reservoir.tools/reference/gettokenstokenbidsv1.md
  - https://nft.reservoir.tools/reference/gettokensv7.md
  - https://nft.reservoir.tools/reference/gettransactionssyncedv2.md
  - https://nft.reservoir.tools/reference/gettransactionstxhashsyncedv1.md
  - https://nft.reservoir.tools/reference/gettransfersbulkv2.md
  - https://nft.reservoir.tools/reference/gettransfersv4.md
  - https://nft.reservoir.tools/reference/getusersactivityv6.md
  - https://nft.reservoir.tools/reference/getusersuserasksv1.md
  - https://nft.reservoir.tools/reference/getusersuserbidsv1.md
  - https://nft.reservoir.tools/reference/getusersusercollectionsv4.md
  - https://nft.reservoir.tools/reference/getusersusertokensv10.md
  - https://nft.reservoir.tools/reference/postcollectionscollectionoverridev1.md
  - https://nft.reservoir.tools/reference/postcollectionscollectionoverridev2.md
  - https://nft.reservoir.tools/reference/postcollectionsdisablemetadatav1.md
  - https://nft.reservoir.tools/reference/postcollectionsnsfwstatusv1.md
  - https://nft.reservoir.tools/reference/postcollectionsrefreshv2.md
  - https://nft.reservoir.tools/reference/postcollectionssetsv1.md
  - https://nft.reservoir.tools/reference/postcollectionsspamstatusv1.md
  - https://nft.reservoir.tools/reference/postcontractssetsv1.md
  - https://nft.reservoir.tools/reference/postexecuteauthsignaturev1.md
  - https://nft.reservoir.tools/reference/postexecutebidv5.md
  - https://nft.reservoir.tools/reference/postexecutebuyv7.md
  - https://nft.reservoir.tools/reference/postexecutecallv1.md
  - https://nft.reservoir.tools/reference/postexecutecancelsignaturev1.md
  - https://nft.reservoir.tools/reference/postexecutecancelv3.md
  - https://nft.reservoir.tools/reference/postexecutedepositv1.md
  - https://nft.reservoir.tools/reference/postexecutelistv5.md
  - https://nft.reservoir.tools/reference/postexecutemintv1.md
  - https://nft.reservoir.tools/reference/postexecutepermitsignaturev1.md
  - https://nft.reservoir.tools/reference/postexecutepresignaturev1.md
  - https://nft.reservoir.tools/reference/postexecuteresultsv1.md
  - https://nft.reservoir.tools/reference/postexecutesellv7.md
  - https://nft.reservoir.tools/reference/postexecutesolvecapacityv1.md
  - https://nft.reservoir.tools/reference/postexecutesolvecapacityv2.md
  - https://nft.reservoir.tools/reference/postexecutesolvev1.md
  - https://nft.reservoir.tools/reference/postexecutestatusv1.md
  - https://nft.reservoir.tools/reference/postexecutetransferv1.md
  - https://nft.reservoir.tools/reference/postmanagementcosignersv1.md


# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/reservoir/refs/heads/main/openapi/reservoir-owners-api-openapi.yml