{"uid":"cap_5NG0PBMmu56-et_oAj0wD","slug":"three-ws-x402-rate-limit-probe-c2ce64ca","name":"three.ws x402 Rate Limit Probe","description":"Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.","url":"https://three.ws/api/x402/rate-limit-probe?utm_source=zero.xyz","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"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"limit":500,"endpoint":"/api/x402/crypto-intel","reset_at":"2026-06-29T00:00:00.000Z","price_atomic":10000,"cooldown_active":false,"remaining_calls":42,"daily_cap_atomic":5000000,"daily_spent_atomic":4580000,"cooldown_ttl_seconds":null,"remaining_capacity_atomic":420000}},"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_wMkK04KrrerLMsC4lAMFp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks the current rate limit status, remaining call quota, and daily spending capacity for a specific three.ws x402-gated endpoint","exampleAgentPrompt":"Before sending another request to the three.ws crypto-intel endpoint, check whether I still have remaining calls today and whether any cooldown is active — I need to know my limit, how many I've used, and when the quota resets.","exampleUseCases":[{"title":"Pre-flight quota check for agent loop","prompt":"Before my agent fires off the next batch of three.ws API calls, check the rate limit probe to confirm I still have remaining capacity and the cooldown isn't active — tell me how many calls are left and when the limit resets."},{"title":"Daily spending cap monitoring","prompt":"Check how much of my daily spending cap I've burned through on the three.ws x402 endpoint today — I want to know the atomic amounts spent versus the cap so I can decide whether to keep running my workflow."},{"title":"Cooldown detection before retry","prompt":"My last three.ws request might have hit a rate limit — probe the rate limit status right now and tell me if there's a cooldown active and how many seconds until I can retry safely."}],"resultDescription":"Returns a JSON object with the endpoint's call limit, remaining calls today, daily cap in atomic units, daily amount spent in atomic units, remaining capacity in atomic units, price per call in atomic units, reset timestamp, and whether a cooldown is currently active along with its TTL in seconds.","failureModes":["Missing or invalid 'input' object returns a 400 validation error","Unsupported HTTP method in the 'method' enum field causes rejection","Invalid bodyType value outside 'json', 'form-data', 'text' causes schema rejection","Payment not included or insufficient USDC ($0.001 required) results in 402 Payment Required","Network timeout if the three.ws service is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need to programmatically check rate limit headroom before invoking a three.ws x402-gated API, or when implementing retry logic that should back off during cooldowns. It is the canonical pre-flight check for any agent that loops over three.ws endpoints and needs to avoid hitting hard limits or wasting micropayment budget.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:47:40.156Z","isFirstParty":false,"canonicalSlug":"three-ws-x402-rate-limit-probe-c2ce64ca"}