How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

OpenSea Tool Endpoints [Beta] API

[Beta] Tool endpoints for discovering and inspecting registered onchain tools. This API is under active development and may change without notice.

OpenSea Tool Endpoints [Beta] API is one of 17 APIs that OpenSea publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Tool Endpoints [Beta]. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 4 operations across 4 paths, and defines 15 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://api.opensea.io.

4 operations 4 paths 15 schemas 3 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://api.opensea.io/api/v2
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

OpenSea Tool Endpoints [Beta] API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key required for authentication

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 3 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Tool Endpoints [Beta] 4

[Beta] Tool endpoints for discovering and inspecting registered onchain tools. This API is under active development and may change without notice.

POST
/api/v2/tools/usage
[Beta] Report tool usage (metrics only)
report_tool_usage body → 200400500
GET
/api/v2/tools
[Beta] List registered tools
list_tools 4 params → 200400500
GET
/api/v2/tools/{registry_chain}/{registry_addr}/{tool_id}
[Beta] Get a registered tool
get_tool 3 params → 200400404500
GET
/api/v2/tools/search
[Beta] Search registered tools
search_tools 9 params → 200400500

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are RegisteredToolResponse (21 properties), ToolSearchResultResponse (14 properties), ToolListItemResponse (12 properties), ToolRequirementResponse (11 properties). Each schema is shown below with its type and property counts.

ToolSearchPaginatedResponse
object
2 properties 1 required
ToolPricingRecipientResponse
object
6 properties 6 required
ToolSearchResultResponse
object
14 properties 11 required
ToolPaymentStatsResponse
object
5 properties 5 required
ToolUsageResponse
object
3 properties 3 required
X402SettlementFields
object
3 properties
Eip3009Fields
object
9 properties
ToolListPaginatedResponse
object
2 properties 1 required
ToolListItemResponse
object
12 properties 10 required
RegisteredToolResponse
object
21 properties 11 required
ToolRequirementResponse
object
11 properties 2 required
ToolAccessResponse
object
3 properties 3 required
ToolUsageRequest
object
7 properties
ToolCollectionResponse
object
5 properties 4 required
Contract
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

opensea-tool-endpoints-beta-api-openapi.yml Raw ↑

Other APIs OpenSea publishes across the network.

OpenSea Stream API
OpenSea Account Endpoints API
OpenSea Analytics Endpoints API
OpenSea Auth Endpoints API
OpenSea Chain Endpoints API
OpenSea Collection Endpoints API
OpenSea Contract Endpoints API
OpenSea Drops Endpoints API
OpenSea Listing Endpoints API
OpenSea NFT Endpoints API
OpenSea Offer Endpoints API
OpenSea Order Endpoints API
Where this information came from

This is an independent, third-party profile of OpenSea Tool Endpoints [Beta] API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.