Reservoir · Schema

getBidEventsV3Response

NFTBlockchainMarketplaceEthereumEVMLiquidityOrder BookWeb3DeFiTradingData API

Properties

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

JSON Schema

reservoir-get-bid-events-v3-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/reservoir/json-schema/reservoir-get-bid-events-v3-response-schema.json",
  "title": "getBidEventsV3Response",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/reservoir-x-deprecated-api-openapi.yml#/components/schemas/getBidEventsV3Response",
  "type": "object",
  "properties": {
    "events": {
      "$ref": "#/$defs/Model168"
    },
    "continuation": {
      "type": "string",
      "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
    }
  },
  "$defs": {
    "Model121": {
      "type": "object",
      "properties": {
        "tokenId": {
          "type": "string",
          "pattern": "^-?[0-9]+$"
        },
        "name": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "isSpam": {
          "type": "boolean"
        },
        "isNsfw": {
          "type": "boolean"
        }
      }
    },
    "Model122": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "isSpam": {
          "type": "boolean"
        },
        "isNsfw": {
          "type": "boolean"
        }
      }
    },
    "Model123": {
      "type": "object",
      "properties": {
        "token": {
          "$ref": "#/$defs/Model121"
        },
        "collection": {
          "$ref": "#/$defs/Model122"
        }
      }
    },
    "Model124": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "token"
          ]
        },
        "data": {
          "$ref": "#/$defs/Model123"
        }
      }
    },
    "Model158": {
      "type": "object",
      "properties": {
        "id": {
          "type": "number"
        },
        "kind": {
          "type": "string",
          "enum": [
            "new-order",
            "expiry",
            "sale",
            "cancel",
            "balance-change",
            "approval-change",
            "bootstrap",
            "revalidation",
            "reprice"
          ]
        },
        "txHash": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{64}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "txTimestamp": {
          "type": "number",
          "description": "Time when added on the blockchain."
        },
        "createdAt": {
          "type": "string",
          "description": "Time when added to indexer"
        }
      }
    },
    "Model166": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Order Id"
        },
        "status": {
          "type": "string",
          "description": "Can return `active`,  inactive`, `expired`, `canceled`, or `filled`."
        },
        "contract": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "maker": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "x-convert": {
            "case": "lower"
          }
        },
        "price": {
          "$ref": "#/$defs/price"
        },
        "quantityRemaining": {
          "type": "number",
          "description": "With ERC1155s, quantity can be higher than 1"
        },
        "nonce": {
          "type": "string",
          "pattern": "^-?[0-9]+$"
        },
        "validFrom": {
          "type": "number"
        },
        "validUntil": {
          "type": "number"
        },
        "rawData": {
          "$ref": "#/$defs/metadata"
        },
        "kind": {
          "type": "string"
        },
        "source": {
          "type": "string"
        },
        "criteria": {
          "$ref": "#/$defs/Model124"
        }
      }
    },
    "Model167": {
      "type": "object",
      "properties": {
        "bid": {
          "$ref": "#/$defs/Model166"
        },
        "event": {
          "$ref": "#/$defs/Model158"
        }
      }
    },
    "Model168": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Model167"
      }
    },
    "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"
        }
      }
    },
    "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"
        }
      }
    },
    "price": {
      "type": "object",
      "properties": {
        "currency": {
          "$ref": "#/$defs/currency"
        },
        "amount": {
          "$ref": "#/$defs/amount"
        },
        "netAmount": {
          "$ref": "#/$defs/netAmount"
        }
      }
    }
  }
}

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-bid-events-v3-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.