orchus_probe

Probe any URL for x402 payment requirements — without paying. Use this before every orchus_fetch call.

Parameters

Parameter	Type	Required	Description
`url`	string	Yes	The x402-gated URL to probe
`method`	string	No	HTTP method: `GET` (default), `POST`, `PUT`

Example

{
  "tool": "orchus_probe",
  "arguments": {
    "url": "https://api.coingecko.com/x402/price"
  }
}

Response (x402 valid):

URL: https://api.coingecko.com/x402/price
x402: ✓ valid payment manifest
Latency: 142ms
Price: 0.005 USDC
Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Pay to: BqVq3uwK1Lo4qVwmrNscWvyHAghPJcmmEck5961kaNCG
 
Call orchus_fetch with this URL to pay and retrieve the response.

Response (not x402):

https://api.example.com/free is not an x402 endpoint (expected 402, got 200).

Why Always Probe

Confirms the price before committing USDC
Reveals the network (Solana vs Base) — ensures your wallet is funded on the right chain
Shows Pay to address — useful for auditing
POST endpoints: use orchus_resources to get the input schema, then probe to confirm current price

Probe Results

Result	Meaning
`pass`	Valid 402 + well-formed payment manifest
`partial`	402 returned but manifest is malformed — paying may fail
`fail`	No 402 response — not an x402 endpoint