{"uid":"cap_rygKU52fLbyzDK7FkYsus","slug":"agentdata-api-file-a-capability-want-23c2b4b7","name":"AgentData API — File a Capability Want","description":"File what you want to buy from an agent-facing API and cannot buy today. Optional kind is typically one of coin, country, vies_country, monitor_host, sms_service — free-form values possible. The $0.01 fee is there to keep intents honest, not to sell you anything: it is not a purchase of the capability and no promise that it gets built. Optionally add the price per call you would pay and your expected monthly volume. Free alternative: POST /agent/request.","url":"https://agentdata-api.sander-van-aard.workers.dev/agent/want","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object"},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_E4sSDYvuMsaKAjfUwGsVe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lets an AI agent file a paid intent expressing which API capability it cannot currently buy, optionally with willingness-to-pay and expected volume.","exampleAgentPrompt":"I tried to find an SMS service API to buy through agentdata but couldn't — can you file a want for an 'sms_service' capability, say I'd pay $0.005 per call and expect about 2000 calls a month?","exampleUseCases":[{"title":"Signal demand for missing coin feed","prompt":"I need a crypto coin price feed but can't find one to buy — file a want for a 'coin' kind capability, I'd pay $0.002 per call and I'd probably use it 5000 times a month."},{"title":"Request VIES country validation API","prompt":"There's no VIES country validation endpoint I can actually purchase right now — submit a want for a 'vies_country' capability on my behalf, with a willingness to pay $0.003 per call and around 1000 calls per month expected."},{"title":"Flag missing host monitoring capability","prompt":"I couldn't find a monitor_host API to buy today — can you file an intent for that kind of capability, noting I'd pay up to $0.01 per call with roughly 500 calls a month?"}],"resultDescription":"An acknowledgement that the intent has been filed, including the details of the submitted want (capability type, optional price-per-call, optional monthly volume). The $0.01 USDC fee is charged per submission to ensure honest signals; it does not constitute a purchase or promise of the capability being built.","failureModes":["Payment not included or insufficient — x402 payment challenge returned","Invalid or missing required body fields — 400 validation error","Duplicate or spam submission detected — rejected or rate-limited","Network or worker error — 5xx response from Cloudflare Workers runtime"],"whenToPreferThis":"Use this endpoint when an AI agent has searched for a purchasable API capability (e.g. coin feed, country data, SMS service, host monitoring) and cannot find one available to buy. It is the canonical way to file honest, paid demand signals with the agentdata marketplace. Use the free POST /agent/request alternative if the $0.01 fee is not acceptable. Do not use this to actually purchase or activate any capability — it is purely a demand-signaling mechanism.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:35.402Z","isFirstParty":false}