HTTP/1.1 402 PAYMENT REQUIRED agent402.base.eth · BASE · SOLANA · POLYGON · ARBITRUM · MONAD · CELO · AVALANCHE · SEI · OPTIMISM · STELLAR · ALGORAND · ROBINHOOD · USDC · USDG
Agent402 / tools / skill-trip-planner

Skill: Multi-stop trip planner

$0.050 per call · USDC via x402 · POST /api/skill/trip-planner

Bundled execution of the Multi-stop trip planner workflow - Plan a multi-stop journey deterministically: geocode each stop, sum the pairwise haversine distances, estimate arrival times by adding driving hours per leg, count business days from today to each arrival, and pull the weather forecast at every US stop. Six tools - three pure-CPU (math + time), three egress (geocoding + weather) - covering the deterministic skeleton of every road-trip / sales-tour / delivery-route planning problem. One x402 payment runs 6 underlying tools (geocode, geo-distance, add-time, business-days, time-convert, weather-forecast); partial-success per step.

Input

FieldTypeDescription
stops *stringcomma-separated ordered list of stops (e.g. 'New York NY, Pittsburgh PA, Cleveland OH, Chicago IL')
startIso *stringtrip start time as UTC ISO 8601 (e.g. '2026-07-20T08:00:00Z')

Example output

{
  "pack": "trip-planner",
  "args": {
    "stops": "New York NY, Pittsburgh PA, Cleveland OH, Chicago IL",
    "startIso": "2026-07-20T08:00:00Z"
  },
  "steps": [
    {
      "slug": "geocode",
      "ok": true,
      "result": {}
    },
    {
      "slug": "geo-distance",
      "ok": true,
      "result": {}
    },
    {
      "slug": "add-time",
      "ok": true,
      "result": {}
    },
    {
      "slug": "business-days",
      "ok": true,
      "result": {}
    },
    {
      "slug": "time-convert",
      "ok": true,
      "result": {}
    },
    {
      "slug": "weather-forecast",
      "ok": true,
      "result": {}
    }
  ],
  "summary": "6/6 steps succeeded"
}

Try it - see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/skill/trip-planner \
  -H "Content-Type: application/json" \
  -d '{"stops":"New York NY, Pittsburgh PA, Cleveland OH, Chicago IL","startIso":"2026-07-20T08:00:00Z"}'

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/skill/trip-planner", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "stops": "New York NY, Pittsburgh PA, Cleveland OH, Chicago IL",
    "startIso": "2026-07-20T08:00:00Z"
  }),
});
Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).

Related tools

Skill: Earnings deep-dive

$0.050 · POST /api/skill/earnings-deep-dive

Bundled execution of the Earnings deep-dive workflow - Everything you need before a company reports: the upcoming earnin…

Skill: Options analytics

$0.050 · POST /api/skill/options-analytics

Bundled execution of the Options analytics workflow - Price a European option on a live stock: pull the current quote, e…

Skill: Fixed-income desk

$0.050 · POST /api/skill/fixed-income-desk

Bundled execution of the Fixed-income desk workflow - Read the rate environment and price a bond in one workflow: the li…