{"uid":"cap_3plXPlGfZDuWvehvkW5ex","slug":"net-protocol-subdomain-claim-b4524329","name":"Net Protocol Subdomain Claim","description":"The onchain data layer","url":"https://netprotocol.app/api/subdomains/v1/claim","method":"POST","headers":{},"bodySchema":{"type":"object","required":["name","target"],"properties":{"name":{"type":"string","description":"subdomain label; resolves at <name>.hostedon.net"},"target":{"type":"string","description":"where the subdomain points"},"durationSeconds":{"type":"integer","description":"lease length in seconds; defaults to 86400 (24h), max 1209600 (2 weeks). Price is $0.01/hour."}}},"responseSchema":{"type":"object","required":["hostname","registration"],"properties":{"hostname":{"type":"string","description":"<name>.hostedon.net"},"registration":{"type":"object","required":["name","owner","paidUntil","target"],"properties":{"name":{"type":"string"},"epoch":{"type":"integer"},"owner":{"type":"string","description":"owner wallet, lowercased 0x"},"target":{"type":"object"},"paidUntil":{"type":"integer","description":"unix seconds the lease expires"},"registeredAt":{"type":"integer"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.24","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.24/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.24","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.24","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Xz5EWXzZVgLRHPxhIR6E0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.24","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Claims and registers a leased subdomain under .hostedon.net, pointing it to a specified target for a configurable duration.","exampleAgentPrompt":"Claim the subdomain 'myproject' under hostedon.net and point it to https://myproject.example.com for 48 hours.","exampleUseCases":[{"title":"Temporary staging environment subdomain","prompt":"Register the subdomain 'staging-v2' on hostedon.net pointing to https://staging.myapp.io for exactly 72 hours so the team can test the new release."},{"title":"Dapp launch with custom subdomain","prompt":"Claim 'coolnft' as a subdomain on hostedon.net and point it to https://coolnft.xyz for the maximum 2-week lease so users can find our mint page."},{"title":"Automated demo environment per client","prompt":"Set up a subdomain called 'clientdemo' on hostedon.net that points to https://demo.myservice.com and keep it alive for 24 hours for today's sales call."}],"resultDescription":"Returns the fully qualified hostname (e.g. myproject.hostedon.net) and a registration object containing the subdomain name, owner wallet address (lowercased 0x), the target it points to, the unix timestamp when the lease was registered, and the unix timestamp when the lease expires (paidUntil).","failureModes":["Subdomain name already taken or not available — conflict error returned","Invalid or missing required fields (name or target) — validation error","Lease duration exceeds maximum of 1,209,600 seconds (2 weeks) — rejected","Insufficient payment / payment not settled via x402 — authorization failure","Target URL malformed or unparseable — input validation error"],"whenToPreferThis":"Choose this endpoint when you need a quick, cheap, temporary subdomain under hostedon.net without going through traditional DNS registrars or long-term commitments. It is ideal for ephemeral infrastructure (staging, demos, hackathons), onchain-native apps that want a human-readable hostname, or agents that need to programmatically provision and expire subdomains on demand. Prefer alternatives if you need a permanent domain registration, a TLD other than .hostedon.net, or DNSSEC/advanced DNS record types.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:34.359Z","isFirstParty":false}