# three.ws Agent Bouncer — Solana Reputation Gate > three.ws Agent Bouncer — Solana Reputation Gate is a paid API for AI agents from three.ws, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13). Checks whether a 3D AI agent (identified by UUID) passes a configurable reputation policy based on its on-chain Solana payment history, attestations, and ban status. ## Facts - Endpoint: GET https://three.ws/api/x402/agent-bouncer - Price: $0.01/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-agent-bouncer-solana-reputation-gate-db710dc0 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MsqCZ-YtoZr5yL6_V8m-O 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-agent-bouncer-solana-reputation-gate-db710dc0 ``` Example prompt: Check whether agent 'a1b2c3d4-e5f6-7890-abcd-ef1234567890' on three.ws is allowed past the door — require at least 3 confirmed on-chain payments, at least 2 distinct payers, and don't admit newcomers with zero Solana history. ## When to prefer this Use this endpoint when you need to enforce Solana-based reputation gating for three.ws AI agents — specifically when you want to control access to a gated experience, club, or service based on verified on-chain payment history, attestations, distinct payer counts, or ban-list status. Prefer this over generic identity checks when your trust model is anchored to blockchain-verifiable payment behavior rather than off-chain credentials. ## Known failure modes - Invalid or non-existent agent_id UUID returns an error or ok:false - Agent wallet not found on Solana returns newcomer:true with zero history - Agent on ban list returns banned:true and admitted:false with a reason - Policy thresholds not met returns admitted:false with specific reasons array - Network or Solana RPC timeout may cause latency or transient errors - Malformed request missing required agent_id field returns a validation error ## 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: 'admitted' (boolean) indicating if the agent passes the policy, 'banned' (boolean) for ban-list status, 'tier' (one of newcomer/regular/trusted/vip/banned), 'reason' and 'reasons' array explaining any denial, 'visits' (count of prior settled tips), 'newcomer' flag, 'wallet_address', a 'reputation' object with full on-chain data, the echoed 'agent_id', and a 'fetchedAt' timestamp. ## 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": [ "agent_id" ], "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "three.ws agent_id (UUID). Returned by /api/agents and /api/agent-page." }, "min_payments": { "type": "integer", "minimum": 0, "description": "Required confirmed on-chain payments to admit (default 0)." }, "allow_newcomers": { "type": "boolean", "description": "Admit agents with no Solana track record (default true)." }, "max_failure_rate": { "type": "number", "maximum": 1, "minimum": 0, "description": "Maximum tolerated payment failure rate, 0–1 (default 1 = no cap)." }, "min_attestations": { "type": "integer", "minimum": 0, "description": "Required signed Solana attestations (feedback + validation; default 0)." }, "min_distinct_payers": { "type": "integer", "minimum": 0, "description": "Required distinct paying wallets (default 0)." } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "ok", "exists", "admitted", "banned", "tier", "agent_id", "reputation" ], "properties": { "ok": { "type": "boolean", "const": true }, "name": { "type": [ "string", "null" ] }, "tier": { "enum": [ "unknown", "newcomer", "regular", "trusted", "vip", "banned" ], "type": "string", "description": "Door tier earned from the agent’s Solana track record. \"unknown\" means no agent is registered under this … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "ok": true, "name": "Helios", "tier": "trusted", "banned": false, "exists": true, "policy": { "minPayments": 10, "allowNewcomers": true, "maxFailureRate": 0.2, "minAttestations": 0, "minDistinctPayers": 3 }, "reason": null, "visits": 4, "admitted": true, "agent_id": "7b9a4f30-2d11-4e2d-9d12-1cdb1f6a3a55", "newcomer": false, "fetchedAt": "2026-06-22T17:00:00.000Z", "reputation": { "buybacks": { "failed": 0, "confirmed": 5, "total_burn_atomics": "500000000" }, "payments": { "failed_count": 3, "failure_rate": 0.021, "confirmed_count": 142, "distinct_payers": 87, "confirmed_amount_atomics": "142000000" }, "attestations": { "feedback_count": 14, "validation_count": 8, "latest_attested_at": "2026-05-12T08:21:00Z" }, "distributions": { "failed": 1, "confirmed": 12, "success_rate": 0.923 }, "deployed_mints": 2 }, "wallet_address": "THREEsynthetic1111111111111111111111111PayTo" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-agent-bouncer-solana-reputation-gate-db710dc0/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)