# x402node Token Price Percent Change

> x402node Token Price Percent Change is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-17).

Returns the USD percentage price change of a token over a chosen time period, identified by chain and contract address or CoinGecko ID.

## Facts

- Endpoint: GET https://api.x402node.dev/prices/change?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402node-token-price-percent-change-183512e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ORmZvHmPB4epZoCn6BGBb

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 x402node-token-price-percent-change-183512e3
```

Example prompt: What's the percentage price change for the PEPE token on Ethereum over the last 24 hours — I want to know if it's been pumping?

## When to prefer this

Use this endpoint when you need a fast, single-call lookup of a token's recent price momentum by chain and contract address or CoinGecko ID — especially for pump detection, momentum screening, or setting price change alerts without building your own price history logic.

## Known failure modes

- Invalid or unsupported chain identifier returns an error
- Contract address not found on specified chain returns 404 or empty result
- Unsupported time period parameter returns a validation error
- CoinGecko ID does not exist returns an error
- Network timeout or upstream data provider outage returns 5xx
- Payment not settled (x402) results in 402 Payment Required

## How this service works

Percentage USD price change of a token over a chosen period, by chain and contract address or coingecko id. For momentum, alerts and screening. Live percent change. price change, percent change, momentum, pump detector, token performance Accepts payment on Base or Solana — either network works.

## Output

Returns the live USD percentage price change of the specified token over the chosen period, enabling momentum analysis, pump detection, and screening.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "description": "chain:address or coingecko:id"
      },
      "period": {
       "type": "string",
       "description": "e.g. 1h, 24h, 7d (default 24h)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402node-token-price-percent-change-183512e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)