---
title: "Paid: Rate-Limit Probe"
method: POST
path: "/api/x402/rate-limit-probe"
---

# Paid: Rate-Limit Probe

`POST /api/x402/rate-limit-probe`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/x402/rate-limit-probe`
- Auth: none required

Rate-Limit Capacity Probe — pay $0.001 USDC to learn how many more calls the x402 autonomous loop can make to a target endpoint today before hitting its daily USDC spend cap. Returns remaining_calls, reset_at, and cooldown_active so agents can throttle dynamically instead of discovering the cap by failure.

## Request body

- object
  - `endpoint` string, required

## Response `200`

three.ws Rate-Limit Probe result JSON

## Other responses

- `400`: Validation error
- `402`: Payment Required (x402)

---

[API](https://skmtc.dev/three/apis/three-ws-api.md) · [All operations](https://skmtc.dev/three/apis/three-ws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/three/apis/three-ws-api/revisions/dbc5e3a81b79?raw)