{"uid":"cap_MsqCZ-YtoZr5yL6_V8m-O","slug":"three-ws-agent-bouncer-solana-reputation-gate-db710dc0","name":"three.ws Agent Bouncer — Solana Reputation Gate","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/agent-bouncer","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":["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 id."},"banned":{"type":"boolean","description":"true when the agent’s wallet is on the Club ban list."},"exists":{"type":"boolean","description":"false when no agent is registered under this id. The call still returns a verdict (never admitted, tier \"unknown\", reputation null) rather than an error, so a buyer vetting an unknown counterparty gets the answer they paid for."},"policy":{"type":"object"},"reason":{"type":["string","null"],"description":"Primary reason when refused; null when admitted."},"visits":{"type":"integer","minimum":0,"description":"Prior settled club tips by this agent’s wallet."},"reasons":{"type":"array","items":{"type":"string"}},"admitted":{"type":"boolean","description":"true when the agent clears the policy and is not banned."},"agent_id":{"type":"string","format":"uuid"},"newcomer":{"type":"boolean","description":"true when the agent has no Solana history yet."},"fetchedAt":{"type":"string","format":"date-time"},"reputation":{"type":["object","null"],"description":"null when exists is false."},"wallet_address":{"type":["string","null"]}}}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mdxS4Ip4kg2TJVykA7Vkp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"VIP gating for premium agent chat","prompt":"Before letting this agent into our premium chat room, check its three.ws reputation — I want at least 5 confirmed on-chain payments, at least 3 distinct payers, and a payment failure rate no higher than 0.1. The agent ID is f47ac10b-58cc-4372-a567-0e02b2c3d479."},{"title":"Newcomer screening for agent marketplace","prompt":"Run a bouncer check on three.ws agent 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d — I want to know if it's banned, what tier it's at, and whether it qualifies with at least 1 attestation and at least 2 confirmed payments. Deny newcomers with no Solana history."},{"title":"Open-door policy with ban enforcement only","prompt":"Check agent 6ba7b810-9dad-11d1-80b4-00c04fd430c8 on three.ws — I don't care about payment counts or attestations, but I do need to know if its wallet is on the ban list before I let it through."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:45:52.446Z","isFirstParty":false}