{"uid":"cap_CLmQdn8WTJLynGQW0dY4w","slug":"speraxos-erc-8004-agent-registration-b06d0d26","name":"SperaxOS ERC-8004 Agent Registration","description":"AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.","url":"https://chat.sperax.io/api/x402/v1/erc8004/register?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","maxLength":256,"minLength":1},"chain":{"type":"string","default":"arbitrum"},"description":{"type":"string","maxLength":2000},"metadataUri":{"type":"string","format":"uri"},"walletAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9fqEyIGOiUD1d1JK_0HAN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0xD74f5255D557944cf7Dd0E45FF521520002D5748","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a new ERC-8004 agent identity on-chain with a name, description, metadata URI, and wallet address via the SperaxOS x402 API","exampleAgentPrompt":"Register my AI agent called 'YieldBot' on Arbitrum with the description 'Autonomous DeFi yield optimizer' and link it to my wallet 0xAbC1234567890abcdef1234567890abcdef123456 using the metadata URI https://mymeta.io/yieldbot.json — pay the $0.001 USDC fee via x402.","exampleUseCases":[{"title":"On-chain DeFi agent identity setup","prompt":"Register my DeFi agent named 'ArbitrageHunter' on Arbitrum with description 'Monitors DEX price spreads and executes arbitrage trades' and wallet 0xDead1234567890abcdef1234567890abcdef5678, using https://agents.mydomain.io/arb-hunter-meta.json as the metadata URI."},{"title":"Autonomous trading bot registration","prompt":"I want to give my trading bot an on-chain ERC-8004 identity — call it 'MomentumTrader', use Arbitrum, set the description to 'Trend-following momentum strategy bot', attach wallet 0xBEEF1234567890abcdef1234567890abcdef9abc, and use https://bot.registry.io/momentum.json for metadata."},{"title":"Multi-agent fleet member enrollment","prompt":"Add a new agent to my fleet on Arbitrum — name it 'LiquidityWatcher', description 'Monitors liquidity pool depths across Uniswap and Curve', wallet address 0xFace1234567890abcdef1234567890abcdef4321, and metadata at https://fleet.myprotocol.xyz/liq-watcher.json."}],"resultDescription":"Returns a confirmation of the on-chain ERC-8004 agent registration, including the registered agent's name, wallet address, chain, description, and metadata URI, along with a transaction or record identifier confirming the registration was created on the target chain.","failureModes":["Invalid wallet address format (not a 0x-prefixed 40-hex-char address) returns a validation error","Metadata URI is not a valid URI format — returns schema validation error","Name exceeds 256 characters or is empty — returns length validation error","Description exceeds 2000 characters — returns length validation error","Insufficient USDC balance to cover $0.001 x402 micropayment — payment fails before request is processed","x402 payment header malformed or missing — returns 402 Payment Required","Chain identifier not supported — returns error or defaults to Arbitrum","Duplicate registration for the same wallet/name combination may return a conflict error"],"whenToPreferThis":"Use this endpoint when you need to create a verifiable, on-chain ERC-8004 identity record for an AI agent, linking a wallet address to a human-readable name and metadata. Prefer this over off-chain identity systems when blockchain-level verifiability and discoverability are required. It is ideal for autonomous agent fleets that need persistent, decentralized identities payable without API keys via USDC micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T18:38:35.380Z","isFirstParty":false,"canonicalSlug":"speraxos-erc-8004-agent-registration-b06d0d26"}