{"openapi":"3.1.0","info":{"title":"TrustLayer API","version":"1.0.0","description":"Reputation intelligence for AI agents. Trust scores, Sybil detection, reviewer quality analysis, and cross-chain identity resolution for 174K+ agents across 20 chains including Base, Ethereum, BSC, Celo, Gnosis, Optimism, Arbitrum, Avalanche, Monad, Polygon, Scroll, Mantle, Linea, and Solana.","x-guidance":"Agent IDs use chain:id format (e.g. base:1378, bsc:1629, ethereum:13446). Use /trust/{agentId} for full Sybil forensics, /score/{agentId} for a quick score, /gate?agent={agentId} for pass/fail trust checks before payments. Free demo at /demo/trust/{agentId} (5 req/hr). All paid endpoints cost $0.001 USDC via x402 on Base."},"servers":[{"url":"https://api.thetrustlayer.xyz"}],"paths":{"/trust/{agentId}":{"get":{"operationId":"getTrustReport","summary":"Full trust forensics report","description":"Sybil risk, reviewer quality, cross-chain identity, anomaly flags, score trajectory, and risk assessment.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001","asset":"USDC","network":"eip155:8453","payTo":"0x7B390424b3e211C0739585778de97ae719ccD137"},"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"},"description":"Agent ID in chain:id format (e.g. base:1378, ethereum:42, monad:100)"}],"responses":{"200":{"description":"Trust report returned successfully"},"402":{"description":"Payment Required"},"404":{"description":"Agent not found"}}}},"/score/{agentId}":{"get":{"operationId":"getTrustScore","summary":"Basic trust score lookup","description":"Composite trust score 0-100, component breakdown, and agent metadata.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001","asset":"USDC","network":"eip155:8453","payTo":"0x7B390424b3e211C0739585778de97ae719ccD137"},"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"},"description":"Agent ID in chain:id format (e.g. base:1378)"}],"responses":{"200":{"description":"Trust score returned successfully"},"402":{"description":"Payment Required"},"404":{"description":"Agent not found"}}}},"/agent/{agentId}":{"get":{"operationId":"getAgentProfile","summary":"Agent profile lookup","description":"Trust score, component breakdown, feedback counts, and metadata for any ERC-8004 agent.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001","asset":"USDC","network":"eip155:8453","payTo":"0x7B390424b3e211C0739585778de97ae719ccD137"},"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"},"description":"Agent ID in chain:id format (e.g. base:1378)"}],"responses":{"200":{"description":"Agent profile returned successfully"},"402":{"description":"Payment Required"},"404":{"description":"Agent not found"}}}},"/solana/{address}":{"get":{"operationId":"getSolanaWalletScore","summary":"Solana wallet trust scoring","description":"Live on-chain analysis via Helius: wallet age, tx diversity, DeFi activity, risk flags. Works for any Solana address.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001","asset":"USDC","network":"eip155:8453","payTo":"0x7B390424b3e211C0739585778de97ae719ccD137"},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Solana wallet address (32-44 characters)"}],"responses":{"200":{"description":"Solana wallet score returned"},"400":{"description":"Invalid address"},"402":{"description":"Payment Required"}}}},"/reviewer/{address}":{"get":{"operationId":"getReviewerProfile","summary":"Reviewer quality lookup","description":"Quality score and review history for a wallet address that has left ERC-8004 feedback.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001","asset":"USDC","network":"eip155:8453","payTo":"0x7B390424b3e211C0739585778de97ae719ccD137"},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Reviewer wallet address (0x...)"}],"responses":{"200":{"description":"Reviewer profile returned successfully"},"402":{"description":"Payment Required"},"404":{"description":"Reviewer not found"}}}},"/owner/{address}":{"get":{"operationId":"getOwnerPortfolio","summary":"Owner portfolio lookup","description":"Shows all agents operated by a single wallet address across all chains, with trust scores and risk assessment.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001","asset":"USDC","network":"eip155:8453","payTo":"0x7B390424b3e211C0739585778de97ae719ccD137"},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Owner wallet address (EVM 0x... or Solana)"}],"responses":{"200":{"description":"Owner portfolio returned successfully"},"402":{"description":"Payment Required"},"404":{"description":"No agents found for this owner"}}}},"/history/{agentId}":{"get":{"operationId":"getScoreHistory","summary":"Score time-series for an agent","description":"Full historical trust score snapshots, 7d/30d trajectory, and volatility (standard deviation).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001","asset":"USDC","network":"eip155:8453","payTo":"0x7B390424b3e211C0739585778de97ae719ccD137"},"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"},"description":"Agent ID in chain:id format (e.g. base:1378)"}],"responses":{"200":{"description":"Score history returned successfully"},"402":{"description":"Payment Required"},"404":{"description":"Agent not found"}}}},"/demo/trust/{agentId}":{"get":{"operationId":"getDemoTrustReport","summary":"Free trust report (rate-limited)","description":"Same data as /trust/{agentId} but free. Rate-limited to 5 requests per hour per IP. Use this for testing or if you cannot pay via x402 yet.","parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"},"description":"Agent ID in chain:id format (e.g. base:1378, ethereum:42, bsc:100)"}],"responses":{"200":{"description":"Trust report returned (includes _demo: true flag)"},"404":{"description":"Agent not found"},"429":{"description":"Rate limit exceeded"}}}},"/gate":{"get":{"operationId":"trustGate","summary":"Trust gate for payment routing — pass/fail","description":"Lightweight trust check for x402 payment routing. Returns pass/fail based on trust score and Sybil flags. Use before routing agent payments. Free tier: 100 req/month per IP.","parameters":[{"name":"agent","in":"query","required":true,"schema":{"type":"string"},"description":"Agent ID in chain:id format (e.g. base:1378)"},{"name":"threshold","in":"query","schema":{"type":"integer","default":64},"description":"Minimum trust score to pass (default: 64)"}],"responses":{"200":{"description":"Gate decision with pass/fail, score, flags, and recommendation"},"400":{"description":"Missing agent parameter"},"429":{"description":"Rate limit exceeded"}}}},"/leaderboard":{"get":{"operationId":"getLeaderboard","summary":"Top agents by trust score","description":"Rate-limited: 5 free requests per IP per hour. Filter by chain.","parameters":[{"name":"chain","in":"query","schema":{"type":"string","default":"all"},"description":"Filter by chain (base, ethereum, bsc, polygon, monad, or all)"},{"name":"limit","in":"query","schema":{"type":"integer","default":10,"maximum":50},"description":"Number of agents to return (max 50)"}],"responses":{"200":{"description":"Leaderboard returned"},"402":{"description":"Rate limit exceeded"}}}}}}