{"uid":"cap_aIQwfQ7hvEjeT7RRGVE-q","slug":"tanship-payai-durable-rate-limit-check-cd037f0c","name":"Tanship PayAI — Durable Rate Limit Check","description":"Payment-gated AI and browser automation API using the x402 protocol. All /v1/* endpoints require USDC payment on Base (eip155:8453) via x402 v2 exact scheme.","url":"https://x402.tanship.dev/v1/durable/ratelimit/check?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":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hV251MtpO_DvVD8tjVu7f","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a named rate limit slot is currently allowed or blocked, using a durable (persistent) rate limiter, gated by USDC micropayment via x402.","exampleAgentPrompt":"Check whether the rate limit for my current request is still within bounds — use the Tanship durable rate limit checker and let me know if the call should be allowed or blocked.","exampleUseCases":[{"title":"Agent pipeline throttle guard","prompt":"Before making the next step in my workflow, check the durable rate limit to see if my agent is still within its allowed request quota or if it should pause."},{"title":"Per-user API cap enforcement","prompt":"I want to enforce a per-user cap on my service — can you check the durable rate limit for user ID 'user_abc123' to see if they've exceeded their hourly allowance?"},{"title":"Pre-call downstream API gate","prompt":"Before I send a request to an expensive external API, check the Tanship durable rate limit to confirm I haven't hit my usage ceiling for today."}],"resultDescription":"Returns a decision on whether the checked rate limit slot is currently allowed or blocked, along with details such as remaining request quota and when the limit resets, enabling agents to gate downstream actions accordingly.","failureModes":["Payment not provided or insufficient USDC — returns HTTP 402 with x402 payment requirements","Malformed input body or missing required fields — returns 400 bad request","Rate limit key not found or not configured — may return an error or a default allow/block state","Network timeout reaching the durable backend — returns 5xx error","Invalid bodyType enum value — rejected at schema validation"],"whenToPreferThis":"Use this endpoint when you need a persistent, durable rate limit check that survives restarts and is shared across distributed agent instances — particularly when enforcing usage caps before calling expensive or sensitive downstream APIs. Prefer this over in-memory rate limiters when consistency and durability across calls matter, and when you're already operating in a payment-gated x402 workflow on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T00:31:34.760Z","isFirstParty":false,"canonicalSlug":"tanship-payai-durable-rate-limit-check-cd037f0c"}