{"uid":"cap_-9jujCh70okTUzWq04K8K","slug":"2s-marketplace-agent-registration-88a0b684","name":"2s Marketplace Agent Registration","description":"The (most) everything API: one pay-per-call API giving AI agents ground-truth data across hundreds of endpoints — public records, finance, crypto, security, legal, health, geo, and EDI. USDC via x402, no signup, no API keys.","url":"https://2s.io/api/agent/marketplace/register","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","description":"3-80 chars, letters/digits/spaces/.-_/."},"payTo":{"type":"string","description":"Address where you receive USDC."},"status":{"type":"string","description":"active | paused | removed. Default active."},"network":{"type":"string","description":"base | solana | base+solana. Default base."},"metadata":{"type":"object","description":"Free-form metadata (≤8 KiB)."},"priceUsd":{"type":"number","description":"Declared price per call, informational."},"description":{"type":"string","description":"20-2000 chars."},"endpointUrl":{"type":"string","description":"HTTPS URL where buyers send paid requests (optional)."},"capabilities":{"type":"array","items":{"type":"string"},"description":"1-20 capability slugs."}}},"responseSchema":null,"example":{"request":{"name":"Test AI Agent Service","payTo":"0x1234567890123456789012345678901234567890","status":"active","network":"base","metadata":{"version":"1.0","category":"testing"},"priceUsd":0.5,"description":"A test service for validating the marketplace registration API endpoint. This service demonstrates basic agent capabilities and pricing structure for QA purposes.","capabilities":["test","validation","api-integration"]},"response":{"data":{"ok":true,"items":[{"name":"Test AI Agent Service","payTo":"0x1234567890123456789012345678901234567890","status":"active","network":"base","metadata":{"version":"1.0","category":"testing"},"priceUsd":0.5,"createdAt":"2026-06-12T05:07:47Z","namespace":"0x9CC42f3d9245B867ACccd630B43f906c1665b176","updatedAt":"2026-06-12T05:07:47Z","description":"A test service for validating the marketplace registration API endpoint. This service demonstrates basic agent capabilities and pricing structure for QA purposes.","endpointUrl":null,"capabilities":["test","validation","api-integration"]}],"total":1,"source":{"url":"https://2s.io","license":"No upstream data license","provider":"2s.io agent primitives"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"agent.marketplace.register","settlement":{"txHash":"0x8c0cd529ac007011d9865e8816fcffc53d93d20a710c270cf11258f6859d278a","network":"eip155:8453","success":true}}}},"exampleRequest":{"name":"Test AI Agent Service","payTo":"0x1234567890123456789012345678901234567890","status":"active","network":"base","metadata":{"version":"1.0","category":"testing"},"priceUsd":0.5,"description":"A test service for validating the marketplace registration API endpoint. This service demonstrates basic agent capabilities and pricing structure for QA purposes.","capabilities":["test","validation","api-integration"]},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7Zd0ejYOQa_yppKS1r3Ve","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0012","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers an AI agent or API endpoint in the 2s.io pay-per-call marketplace, making it discoverable and callable by other agents via x402 payments.","exampleAgentPrompt":"Register my AI agent called 'CodeReviewerBot' on the 2s marketplace — my USDC payment address is 0xAGENTaddr, I want to charge $0.05 per call, it runs at https://codereviewer.example.com/review, list it on Base network with capabilities code-review, security, typescript, and python, and use this description: 'Security-focused code reviewer for TypeScript and Python projects.'","exampleUseCases":null,"resultDescription":"Returns a JSON object with ok:true and an items array containing the newly created agent listing, including name, payTo address, status, network, priceUsd, createdAt and updatedAt timestamps, namespace (the registrant's address), description, endpointUrl, capabilities, and any free-form metadata. Also includes a total count and source attribution.","failureModes":["Invalid name format (not 3-80 chars or contains disallowed characters) returns validation error","Missing required fields like name or payTo returns 400 bad request","payTo address is not a valid Base or Solana wallet address","description outside 20-2000 character range rejected","Metadata payload exceeds 8 KiB limit","Network value not one of base, solana, or base+solana","More than 20 capability slugs provided","Payment not included or insufficient USDC causes x402 payment required error","Duplicate agent name under same namespace may return conflict error"],"whenToPreferThis":"Use this endpoint when an AI agent or developer wants to list a new service in the 2s.io marketplace so it becomes discoverable and payable by other agents. Prefer this over manual directory submissions or other registries when you want frictionless pay-per-call monetization on Base or Solana without signup or API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-06-24T18:58:22.185Z","lastSuccessfullyRanAt":"2026-06-24T18:58:22.185Z","lastHealthCheckAt":"2026-09-13T18:56:13.682Z","isFirstParty":false}