# three.ws Onchain Identity Verify

> three.ws Onchain Identity Verify is a paid API for AI agents from three.ws, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Verifies whether a three.ws 3D AI agent is linked to a specific onchain token or contract address on a given blockchain, returning cryptographic evidence of the association.

## Facts

- Endpoint: GET https://three.ws/api/x402/onchain-identity-verify
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-onchain-identity-verify-0dfad875
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CfOgAItNLNWzK9RNfswcX

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability three-ws-onchain-identity-verify-0dfad875
```

Example prompt: Can you verify whether the three.ws agent with ID 7b9a4f30-2d11-4e2d-9d12-1cdb1f6a3a55 is linked to the Solana mint C3vQABCDEFGHJKLMNopqrstuvwxyZ12345abcdefghi on chain solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp?

## When to prefer this

Use this endpoint when you need to cryptographically confirm that a specific three.ws 3D AI agent is associated with a particular token, NFT mint, or smart contract on a supported blockchain. Ideal for gating access, displaying trust badges, or confirming agent provenance before interacting with or paying an agent. Prefer this over generic blockchain explorers when you need the agent_id-to-contract linkage specifically within the three.ws ecosystem.

## Known failure modes

- Invalid agent_id UUID format returns validation error
- Unknown or unsupported CAIP-2 chain ID returns error
- contract_or_mint address format mismatch for the specified chain (e.g. EVM address on Solana chain) returns error
- Agent not found returns verified: false with null evidence
- Payment of $0.005 USDC not provided returns 402 Payment Required
- Network or indexer timeout causes delayed or failed response

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with a 'verified' boolean, the agent_id, chain, and contract_or_mint echoed back, an 'indexed_at' timestamp, and an 'evidence' object containing the blockchain family (solana or evm), associated wallet address, transaction hash, confirmation timestamp, and metadata URI — or null evidence if unverified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "identity",
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Optional CAIP-2 chain hint. Examples: eip155:1, eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp. Inferred from the identity/address shape when omitted."
      },
      "address": {
       "type": "string",
       "description": "The contract / mint / wallet the identity claims to control."
      },
      "identity": {
       "type": "string",
       "description": "The claimed identity: an ENS name (vitalik.eth), SNS name (bonfida.sol), EVM wallet (0x…), Solana wallet (base58), ERC-8004 id (eip155:8453:42), or three.ws agent_id (uuid)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "claim",
      "verified",
      "evidence",
      "method",
      "ts"
     ],
     "properties": {
      "ts": {
       "type": "string",
       "format": "date-time"
      },
      "claim": {
       "type": "object",
       "required": [
        "identity",
        "address"
       ],
       "properties": {
        "chain": {
         "type": [
          "string",
          "null"
         ]
        },
        "address": {
         "type": "string"
        },
        "identity": {
         "type": "string"
        }
       }
      },
      "method": {
       "type": "string"
      },
      "caveats": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "evidence": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "kind",
         "ref",
         "detail"
        ],
        "properties": {
         "ref": {
          "type": "string"
         },
         "kind": {
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-07-07T00:00:00.000Z",
  "claim": {
   "chain": "eip155:1",
   "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
   "identity": "vitalik.eth"
  },
  "method": "ens-resolution",
  "caveats": [],
  "evidence": [
   {
    "ref": "vitalik.eth",
    "kind": "ens_forward_resolution",
    "detail": "resolves to 0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
   }
  ],
  "verified": true,
  "identity_type": "ens"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-onchain-identity-verify-0dfad875/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)