---
title: "[Beta] Report tool usage (metrics only)"
method: POST
path: "/api/v2/tools/usage"
tags: ["Tool Endpoints [Beta]"]
---

# [Beta] Report tool usage (metrics only)

`POST /api/v2/tools/usage`

[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). Identify the tool by providing tool_chain_id + tool_registry_address (an onchain EVM address, or x402_bazaar / x402_bankr for x402 tools) + tool_onchain_id, or alternatively just tool_endpoint (the tool's canonical URL). This endpoint does NOT trigger any onchain transactions. This endpoint is under active development and may change without notice.

## Request body

- ToolUsageRequest
  - `verification_type` string
  - `tool_chain_id` integer
  - `tool_registry_address` string
  - `tool_onchain_id` integer
  - `tool_endpoint` string
  - `latency_ms` integer
  - `eip3009` Eip3009Fields
    - `caller_address` string
    - `signature` string
    - `chain_id` integer
    - `from` string
    - `to` string
    - `value` integer
    - `valid_after` integer
    - `valid_before` integer
    - `nonce` string
  - `x402` X402SettlementFields
    - `caller_address` string
    - `tx_hash` string
    - `chain_id` integer

## Response `200`

OK

## Other responses

- `400` — For error reasons, review the response data.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal server error. Please open a support ticket so OpenSea can investigate.

---

[API](https://skmtc.dev/opensea/apis/opensea-api.md) · [All operations](https://skmtc.dev/opensea/apis/opensea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opensea/opensea-api/revisions/acee8835f2ae/schema)