Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Probe Before You Pay

Always call orchus_probe before orchus_fetch or orchus_pay.

Probing is free. It tells you the exact price, network, and expected parameters before you spend USDC.

Why This Matters

x402 endpoints can vary in:

  • Price (even for the same URL over time)
  • Network (Solana or Base)
  • Required body parameters (POST endpoints)
  • Payment address

Guessing any of these wastes USDC on a failed transaction.

How to Probe

{
  "tool": "orchus_probe",
  "arguments": {
    "url": "https://api.example.com/price-feed",
    "method": "GET"
  }
}
Example response: 
URL: https://api.example.com/price-feed
x402: ✓ valid payment manifest
Latency: 142ms
Price: 0.01 USDC
Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Pay to: BqVq3uwK1Lo4qVwmrNscWvyHAghPJcmmEck5961kaNCG
 
Call orchus_fetch with this URL to pay and retrieve the response.

Then Pay

Once you know the price and network are acceptable:

{
  "tool": "orchus_fetch",
  "arguments": {
    "url": "https://api.example.com/price-feed"
  }
}

When Probe Returns Fail

If orchus_probe says the URL is not an x402 endpoint, it either:

  • Returns 200 directly (free endpoint — no payment needed, call it normally)
  • Is behind authentication (incompatible with x402)
  • Is down

Do not use orchus_fetch on URLs that fail probe.

Resources in the Library

All resources shown by orchus_resources have already been probe-verified. You still need to probe before paying — prices and networks can change between when the Library verified the resource and when you call it.