# AgentToll — Watch Price by Symbol

> AgentToll — Watch Price by Symbol is a paid API for AI agents from agenttoll.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the current USD price of a crypto asset by ticker or CoinGecko ID, compared against a reference price with directional change and alert threshold

## Facts

- Endpoint: GET https://agenttoll.app/api/watch/price/%7Bsymbol%7D
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-watch-price-by-symbol-33dc2201
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Iguvm5HTaYVK8zu_EWTT1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agenttoll-watch-price-by-symbol-33dc2201
```

Example prompt: Check the current ETH price against my reference of $1900 and tell me if it has moved more than 2% in either direction.

## When to prefer this

Use this endpoint when you need a real-time USD price for a specific crypto asset by ticker or CoinGecko ID, especially when you also want to compare it against a known reference price and detect whether a percentage threshold has been breached — all in a single call. Prefer it over generic market data APIs when operating on Base and when paying per-call with no API key setup is acceptable. It is particularly well-suited for agent-driven alert loops, trading triggers, and portfolio monitoring workflows.

## Known failure modes

- Unknown or misspelled symbol/CoinGecko ID returns an error or empty result
- Missing required 'ref' query parameter causes a 400 or validation error
- Price feed temporarily unavailable returns a 5xx error
- Payment not processed correctly (x402 flow failure) results in 402 response blocking access
- Stale or delayed price data if upstream oracle is lagging

## How this service works

Base-native onchain data for AI agents — gas, token prices by contract, address analytics, DEX pools, new-token radar. From $0.001 a call in USDC via x402. No API keys. Open source.

## Output

A JSON object containing the current UTC timestamp, the asset symbol, the current USD price, the reference price supplied, the percentage change from reference, the direction ('up' or 'down'), whether the threshold was triggered (boolean), and the threshold percent used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Ticker or CoinGecko id"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ref"
     ],
     "properties": {
      "pct": {
       "type": "number",
       "description": "Threshold in percent, default 2"
      },
      "ref": {
       "type": "number",
       "description": "Reference price in USD to compare against"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "at": "2026-08-05T13:31:58.678Z",
  "ref": 1900,
  "usd": 1867.28,
  "symbol": "eth",
  "changePct": -1.7221,
  "direction": "down",
  "triggered": false,
  "thresholdPct": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-watch-price-by-symbol-33dc2201/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.app](https://www.zero.xyz/host/agenttoll.app/llms.txt)