# Token Price Alert

> Token Price Alert is a paid API for AI agents from 402.com.tr, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Registers a price-threshold alert on a Base token that polls DexScreener and POSTs a webhook when the price crosses above or below a specified USD target.

## Facts

- Endpoint: GET https://402.com.tr/api/x402/price-alert
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-price-alert-c87a2e3f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iLaRGnOod7QdGBr5OUGqU

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 token-price-alert-c87a2e3f
```

Example prompt: Set up a price alert for Base token 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed — notify my webhook at https://myapp.example.com/hooks/price when it goes above $0.05.

## When to prefer this

Choose this endpoint when you need event-driven price notifications for Base tokens without running your own polling infrastructure. Ideal for trading bots, DCA agents, or alert systems that need to react to price crossings asynchronously via webhook. Best suited for tokens with DexScreener coverage on Base; not appropriate for CEX-listed assets or non-Base chains.

## Known failure modes

- Invalid or non-Base token address returns an error
- Webhook URL is not a valid HTTPS URL — rejected at registration
- Threshold not a valid USD number — parse error
- Direction value not 'above' or 'below' — validation failure
- Alert expires after 30 days without triggering if price never crosses
- Webhook endpoint unreachable at trigger time — notification may be lost
- DexScreener data unavailable for illiquid tokens — polling may fail silently

## How this service works

Pay once to register a price-threshold alert on any Base token. Supply target price, direction (above/below), and an https webhook URL. A polling cron (daily by default; configurable to ~minutes) checks DexScreener and POSTs your webhook when it crosses. Expires after 30 days. Or omit the webhook and poll with check=<id>: the verdict is THRESHOLD_MET, ok, FIRED, or unknown when the price feed could not be read.

## Output

On registration: a confirmation with an alert ID, expiry timestamp (30 days), and polling interval. On status poll: current alert state (pending/triggered/expired). When the threshold is crossed: a POST is sent to the registered webhook URL with token address, threshold, direction, current price, and timestamp.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token",
      "threshold",
      "direction"
     ],
     "properties": {
      "check": {
       "type": "string",
       "description": "Or: alert id to poll its status"
      },
      "token": {
       "type": "string",
       "description": "Token address"
      },
      "webhook": {
       "type": "string",
       "description": "Webhook URL (optional — omit to poll)"
      },
      "direction": {
       "type": "string",
       "description": "Direction (above/below)"
      },
      "threshold": {
       "type": "string",
       "description": "Price threshold (USD)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-price-alert-c87a2e3f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402.com.tr](https://www.zero.xyz/host/402.com.tr/llms.txt)