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.
Work with this as data
Every API 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 apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/opensea-tool-endpoints-beta-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
OpenAPI Specification
openapi: 3.2.0
info:
title: OpenSea Account Endpoints Tool Endpoints [Beta] Tool Endpoints [Beta] API
description: The API for OpenSea
contact:
name: OpenSea
url: https://www.opensea.io
email: contact@opensea.io
version: 2.0.0
servers:
- url: https://api.opensea.io
description: Production server
security:
- ApiKeyAuth: []
tags:
- name: Tool Endpoints [Beta]
description: '[Beta] Tool endpoints for discovering and inspecting registered onchain tools. This API is under active development and may change without notice.'
paths:
/api/v2/tools/usage:
post:
tags:
- Tool Endpoints [Beta]
summary: '[Beta] Report tool usage (metrics only)'
description: '[Beta] Report verified tool usage for metrics and analytics purposes only. Supports verification_type: eip3009_authorization (free tools, identity proof) or x402_settlement (paid tools, onchain USDC payment verification). This endpoint does NOT trigger any onchain transactions. This endpoint is under active development and may change without notice.'
operationId: report_tool_usage
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ToolUsageRequest'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ToolUsageResponse'
'400':
$ref: '#/components/responses/BadRequest'
'500':
$ref: '#/components/responses/InternalError'
/api/v2/tools:
get:
tags:
- Tool Endpoints [Beta]
summary: '[Beta] List registered tools'
description: '[Beta] List verified registered tools with optional sorting and filtering. This endpoint is under active development and may change without notice.'
operationId: list_tools
parameters:
- name: sort_by
in: query
description: 'Sort by: newest, oldest'
required: false
schema:
type: string
default: newest
- name: type
in: query
description: 'Filter by access type: open, nft_gated, token_gated, subscription, gated'
required: false
schema:
type: string
- name: limit
in: query
description: Number of items to return per page
required: false
schema:
type: integer
format: int32
description: Number of items to return per page
example: 20
maximum: 200
minimum: 1
example: 20
- name: cursor.value
in: query
required: false
schema:
type: string
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ToolListPaginatedResponse'
'400':
$ref: '#/components/responses/BadRequest'
'500':
$ref: '#/components/responses/InternalError'
/api/v2/tools/{registry_chain}/{registry_addr}/{tool_id}:
get:
tags:
- Tool Endpoints [Beta]
summary: '[Beta] Get a registered tool'
description: '[Beta] Get a registered tool by its composite key: registry chain, registry address, and tool ID. Includes pricing recipients and NFT collection info for gated tools. This endpoint is under active development and may change without notice.'
operationId: get_tool
parameters:
- name: registry_chain
in: path
description: Registry chain ID (e.g. 1, 8453)
required: true
schema:
type: string
- name: registry_addr
in: path
description: Registry contract address
required: true
schema:
type: string
- name: tool_id
in: path
description: Numeric tool ID
required: true
schema:
type: string
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/RegisteredToolResponse'
'400':
$ref: '#/components/responses/BadRequest'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
/api/v2/tools/search:
get:
tags:
- Tool Endpoints [Beta]
summary: '[Beta] Search registered tools'
description: '[Beta] Search for verified registered tools by name, tags, creator, or other criteria. This endpoint is under active development and may change without notice.'
operationId: search_tools
parameters:
- name: query
in: query
description: Search query text
required: false
schema:
type: string
- name: registry_chain
in: query
description: Filter by registry chain ID
required: false
schema:
type: string
- name: tags
in: query
description: Filter by tags
required: false
schema:
type: array
items:
type: string
- name: access_type
in: query
description: 'Filter by access type: open, nft_gated, subscription'
required: false
schema:
type: string
- name: creator
in: query
description: Filter by creator address
required: false
schema:
type: string
- name: sort_by
in: query
description: 'Sort by: relevance, newest, most_used'
required: false
schema:
type: string
default: relevance
- name: include_details
in: query
description: Include pricing recipients and access requirements per result. Defaults to true; set false for a lighter list response.
required: false
schema:
type: boolean
default: true
- name: limit
in: query
description: Number of items to return per page
required: false
schema:
type: integer
format: int32
description: Number of items to return per page
example: 20
maximum: 200
minimum: 1
example: 20
- name: cursor.value
in: query
required: false
schema:
type: string
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ToolSearchPaginatedResponse'
'400':
$ref: '#/components/responses/BadRequest'
'500':
$ref: '#/components/responses/InternalError'
components:
schemas:
ToolAccessResponse:
type: object
properties:
open_access:
type: boolean
logic:
type: string
requirements:
type: array
items:
$ref: '#/components/schemas/ToolRequirementResponse'
required:
- logic
- open_access
- requirements
ToolSearchResultResponse:
type: object
properties:
tool_id:
type: string
registry_chain:
type: string
registry_addr:
type: string
name:
type: string
description:
type: string
tags:
type: array
items:
type: string
creator:
type: string
creator_display_name:
type: string
endpoint_domain:
type: string
access_type:
type: string
payment_stats:
$ref: '#/components/schemas/ToolPaymentStatsResponse'
created_at:
type: string
pricing_recipients:
type: array
items:
$ref: '#/components/schemas/ToolPricingRecipientResponse'
access:
$ref: '#/components/schemas/ToolAccessResponse'
required:
- access_type
- created_at
- creator
- creator_display_name
- description
- endpoint_domain
- name
- registry_addr
- registry_chain
- tags
- tool_id
ToolListPaginatedResponse:
type: object
properties:
tools:
type: array
items:
$ref: '#/components/schemas/ToolListItemResponse'
next:
type: string
required:
- tools
ToolListItemResponse:
type: object
properties:
tool_id:
type: string
registry_chain:
type: string
registry_addr:
type: string
creator:
type: string
metadata_uri:
type: string
manifest_hash:
type: string
endpoint_url:
type: string
endpoint_domain:
type: string
manifest_hash_verified:
type: boolean
is_active:
type: boolean
created_at:
type: string
updated_at:
type: string
required:
- created_at
- creator
- is_active
- manifest_hash
- manifest_hash_verified
- metadata_uri
- registry_addr
- registry_chain
- tool_id
- updated_at
ToolUsageRequest:
type: object
properties:
verification_type:
type: string
tool_chain_id:
type: integer
format: int64
tool_registry_address:
type: string
tool_onchain_id:
type: integer
format: int64
latency_ms:
type: integer
format: int64
eip3009:
$ref: '#/components/schemas/Eip3009Fields'
x402:
$ref: '#/components/schemas/X402SettlementFields'
ToolPricingRecipientResponse:
type: object
properties:
recipient:
type: string
payment_chain:
type: string
asset:
type: string
protocol:
type: string
amount_per_call:
type: string
created_at:
type: string
required:
- amount_per_call
- asset
- created_at
- payment_chain
- protocol
- recipient
Contract:
type: object
properties:
address:
type: string
chain:
type: string
required:
- address
- chain
ToolRequirementResponse:
type: object
properties:
kind:
type: string
type:
type: string
collection_address:
type: string
token_id:
type: string
min_tier:
type: integer
format: int32
token_address:
type: string
min_balance:
type: string
data:
type: string
label:
type: string
links:
type: object
additionalProperties:
type: string
collection:
$ref: '#/components/schemas/ToolCollectionResponse'
required:
- kind
- type
RegisteredToolResponse:
type: object
properties:
tool_id:
type: string
registry_chain:
type: string
registry_addr:
type: string
creator:
type: string
metadata_uri:
type: string
manifest_hash:
type: string
endpoint_url:
type: string
endpoint_domain:
type: string
manifest_hash_verified:
type: boolean
is_active:
type: boolean
created_at:
type: string
updated_at:
type: string
name:
type: string
description:
type: string
tags:
type: array
items:
type: string
inputs: {}
outputs: {}
creator_address:
type: string
endpoint:
type: string
access:
$ref: '#/components/schemas/ToolAccessResponse'
pricing_recipients:
type: array
items:
$ref: '#/components/schemas/ToolPricingRecipientResponse'
required:
- created_at
- creator
- is_active
- manifest_hash
- manifest_hash_verified
- metadata_uri
- pricing_recipients
- registry_addr
- registry_chain
- tool_id
- updated_at
ToolCollectionResponse:
type: object
properties:
slug:
type: string
name:
type: string
image_url:
type: string
opensea_url:
type: string
contracts:
type: array
items:
$ref: '#/components/schemas/Contract'
required:
- contracts
- name
- opensea_url
- slug
ToolSearchPaginatedResponse:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/ToolSearchResultResponse'
next:
type: string
required:
- results
ToolPaymentStatsResponse:
type: object
properties:
total_payments:
type: integer
format: int64
total_volume_usd:
type: number
format: double
unique_buyers:
type: integer
format: int64
payments_last_24h:
type: integer
format: int64
payments_last_7d:
type: integer
format: int64
required:
- payments_last_24h
- payments_last_7d
- total_payments
- total_volume_usd
- unique_buyers
Eip3009Fields:
type: object
properties:
caller_address:
type: string
signature:
type: string
chain_id:
type: integer
format: int64
from:
type: string
to:
type: string
value:
type: integer
valid_after:
type: integer
valid_before:
type: integer
nonce:
type: string
ToolUsageResponse:
type: object
properties:
id:
type: string
verified:
type: boolean
verification_type:
type: string
required:
- id
- verification_type
- verified
X402SettlementFields:
type: object
properties:
caller_address:
type: string
tx_hash:
type: string
chain_id:
type: integer
format: int64
responses:
InternalError:
description: Internal server error. Please open a support ticket so OpenSea can investigate.
NotFound:
description: Resource not found
BadRequest:
description: For error reasons, review the response data.
securitySchemes:
ApiKeyAuth:
type: apiKey
description: API key required for authentication
name: x-api-key
in: header
x-tagGroups:
- name: Data & Discovery
tags:
- Chain Endpoints
- Account Endpoints
- Collection Endpoints
- NFT Endpoints
- Contract Endpoints
- Token Endpoints
- Search Endpoints
- name: Marketplace & Trading
tags:
- Listing Endpoints
- Offer Endpoints
- Order Endpoints
- Swap Endpoints
- Drops Endpoints
- name: Analytics & Events
tags:
- Analytics Endpoints
- name: Tools [Beta]
tags:
- Tool Endpoints [Beta]
- name: Transactions
tags:
- Transaction Endpoints