{"uid":"cap_CfOgAItNLNWzK9RNfswcX","slug":"three-ws-onchain-identity-verify-0dfad875","name":"three.ws Onchain Identity Verify","description":"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.","url":"https://three.ws/api/x402/onchain-identity-verify","method":"GET","headers":{},"bodySchema":{"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":{"type":"string"},"detail":{"type":"string"}}}},"verified":{"oneOf":[{"type":"boolean"},{"type":"string","const":"unverifiable"}],"description":"true (proven), false (disproven), or \"unverifiable\" (insufficient on-chain data)."},"identity_type":{"enum":["ens","sns","evm_address","solana_address","erc8004","threews_agent_id","unknown"],"type":"string"}}}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P2kwNzHZ0k5hqdppWRXPR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:39:43.531Z","isFirstParty":false}