How much does one call cost?

$0.005 in USDC on Base, per successful call. No sign-up, subscription or API key.

What happens if the call fails?

You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.

How does an AI agent pay?

With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.

VIN decoder

Validate a 17-character VIN and return make, model, year, plant and body details plus an ISO 3779 breakdown.

POST /api/v1/nodes/vin-decode

Per successful call

$0.005

USDC on Base via x402. Failed or empty calls: $0.

No sign-up or API key needed. Run this once and Claude Code, Cursor or your agent can call this node with x402:

add TollNode to your agent

npx agentcash add https://tollnode.com

then call this node

npx agentcash@latest fetch https://tollnode.com/api/v1/nodes/vin-decode -m POST -b '{"vin":"1HGCM82633A004352"}'

Quick setup for humans and agents

1. Fund an x402 wallet with a little USDC on Base. AgentCash (above), Coinbase Wallet or any x402 client works. One dollar covers hundreds of calls.
2. Call the endpoint. The first response is HTTP 402 with the exact price.
3. Your wallet signs and retries. TollNode runs the node and collects the quoted price only if the result is usable.

see the 402 yourself

curl -i -X POST https://tollnode.com/api/v1/nodes/vin-decode \
  -H 'content-type: application/json' \
  -d '{"vin":"1HGCM82633A004352"}'

Input

Field	Type	Notes
vin*	string	17-character VIN

Example response

{
  "vin": "1HGCM82633A004352",
  "local": {
    "vds": "CM826",
    "wmi": "1HG",
    "country": "United States",
    "plantCode": "A",
    "checkDigit": "3",
    "countryCode": "US",
    "manufacturer": "Honda",
    "sequentialNumber": "004352"
  },
  "nhtsa": {
    "make": "HONDA",
    "model": "Accord",
    "bodyClass": "Coupe",
    "errorCode": "0",
    "errorText": "0 - VIN decoded clean. Check Digit (9th position) is correct",
    "modelYear": "2003",
    "vehicleType": "PASSENGER CAR",
    "plantCountry": "UNITED STATES (USA)"
  },
  "cached": false,
  "validation": {
    "valid": true
  }
}

Try it free

A rate-limited demo for humans. Agents should use the paid endpoint.

Result

The public API returns 402 for a valid VIN. This demo shows the vehicle fields and the quote together, without taking payment.

FAQ

What does the VIN decoder node return?: Validate a 17-character VIN and return make, model, year, plant and body details plus an ISO 3779 breakdown.
How much does one call cost?: $0.005 in USDC on Base, per successful call. No sign-up, subscription or API key.
What happens if the call fails?: You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.
How does an AI agent pay?: With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.