{"uid":"cap_0mD-8ObSTzCM6FqffFsA7","slug":"speraxos-erc-8004-agent-registration-api-25811a7b","name":"SperaxOS ERC-8004 Agent Registration API","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/tools/erc8004/registerAgent?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","description":"The name of the agent to register"},"chain":{"type":"string","default":"bsc-testnet","description":"Blockchain to register on. Accepts full names (bsc-mainnet, ethereum, arbitrum) or shortcuts (bsc, eth, arb, base, op, polygon, matic). Options: bsc-testnet, bsc-mainnet, ethereum, sepolia, arbitrum, base, optimism, polygon, arbitrum-sepolia, base-sepolia, optimism-sepolia, polygon-amoy"},"trust":{"type":"array","items":{"type":"string"},"description":"Trust mechanisms (e.g., reputation, crypto-economic, institutional)"},"imageUrl":{"type":"string","description":"Optional URL to an avatar/image for the agent"},"services":{"type":"array","items":{"type":"object","required":["name","endpoint"],"properties":{"name":{"type":"string","description":"Service name (e.g., A2A, MCP, inference)"},"endpoint":{"type":"string","description":"Service endpoint URL"}}},"description":"Array of service endpoints the agent provides (A2A, MCP, etc.)"},"description":{"type":"string","description":"A description of the agent and its purpose"},"serviceRegistryHash":{"type":"string","description":"IPFS CID (CIDv1 or CIDv0) of the agent's commerce service manifest. When provided, the hash is stored in on-chain metadata under the key \"a2a.serviceRegistry\" so that peer agents can discover and verify paid capabilities without trusting a centralised database."}}},"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_kPiaUFRdmH78qz5UjRsKp","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 an AI agent on-chain using the ERC-8004 standard, storing its identity, services, trust mechanisms, and optional IPFS service manifest on a target blockchain.","exampleAgentPrompt":"Register my AI agent called 'ArbitrageBot' on Base mainnet with a description of 'automated DeFi arbitrage agent', trust mechanisms of reputation and crypto-economic, an A2A service endpoint at https://myagent.example.com/a2a, and store my IPFS service manifest CID bafybeiabc123 in the on-chain metadata.","exampleUseCases":[{"title":"Bootstrap agent discovery on Base","prompt":"Register my new agent called 'DataFetcherAgent' on Base mainnet — its purpose is fetching and summarizing DeFi market data, it uses institutional and reputation trust, and its MCP endpoint is at https://datafetcher.example.com/mcp. Also store my service registry IPFS CID bafybeid456xyz so other agents can find it."},{"title":"Deploy test agent on BSC testnet","prompt":"Register a test agent named 'SandboxAgent' on bsc-testnet with description 'sandbox agent for integration testing', trust mechanism of crypto-economic, and an A2A service endpoint at https://sandbox.myproject.dev/a2a."},{"title":"Publish multi-service agent to Arbitrum","prompt":"I need to register my agent 'TradingOrchestrator' on Arbitrum mainnet — it offers both an A2A endpoint at https://trader.example.io/a2a and an inference endpoint at https://trader.example.io/infer. Add reputation and institutional trust, use this avatar image https://trader.example.io/avatar.png, and pin my service manifest at IPFS CID bafybeigh789."}],"resultDescription":"Returns confirmation that the agent has been registered on-chain, including the transaction hash or on-chain record reference, along with any stored metadata fields such as the service registry IPFS hash anchored under 'a2a.serviceRegistry'.","failureModes":["Invalid or unsupported chain identifier returns an error listing valid options","Malformed IPFS CID for serviceRegistryHash causes rejection","Missing required 'name' field results in validation error","Payment failure via x402 protocol (insufficient USDC balance) causes 402 response","Service endpoint URLs that are malformed or unreachable may cause registration to fail","Duplicate agent registrations on the same chain may conflict depending on registry logic"],"whenToPreferThis":"Choose this endpoint when you need to anchor an AI agent's identity and service endpoints on-chain in a standards-compliant way (ERC-8004), especially when you want peer agents to discover your agent's paid capabilities via an IPFS service manifest without relying on a centralized database. It is preferable over off-chain registries when trustless discoverability and verifiability across blockchain networks are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:53:39.772Z","isFirstParty":false,"canonicalSlug":"speraxos-erc-8004-agent-registration-api-25811a7b"}