# Recent Percentage Price Change for a Token

> Recent Percentage Price Change for a Token is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-01).

Returns the recent percentage price change for a specific ERC-20 token on a given blockchain network

## Facts

- Endpoint: POST https://twin.unykorn.org/token-price-change?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/recent-percentage-price-change-for-a-token-36a07995
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k_tBfz7DJDdkD3a3M3NDe

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 recent-percentage-price-change-for-a-token-36a07995 -d '<json body>'
```

Example prompt: What's the recent percentage price change for the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?

## When to prefer this

Use this endpoint when you need a quick, on-demand percentage price change metric for a specific ERC-20 token on one of the 10 supported EVM-compatible chains (Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Gnosis, Linea, Scroll). It is ideal for agents that need lightweight price momentum signals without pulling full OHLCV data, and for workflows that already use the x402 micropayment protocol for API access.

## Known failure modes

- Invalid contract address format (must be a 0x-prefixed 40-hex-character address)
- Unsupported chain name (only the 10 enumerated chains are accepted)
- Token contract not found or not tracked on the specified chain
- Payment failure or insufficient funds via x402 protocol
- Network or upstream data provider timeout

## How this service works

Recent percentage price change for a token — Genesis402 / UnyKorn Operator Network

## Output

A JSON object confirming success (ok: true), the type of result ('token-price-change'), the recent percentage price change for the queried token, and a payment receipt containing the transaction hash, USD amount paid, and a unique receipt ID, along with an ISO 8601 timestamp of when the data was generated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "chain": {
     "enum": [
      "ethereum",
      "base",
      "polygon",
      "arbitrum",
      "optimism",
      "bsc",
      "avalanche",
      "gnosis",
      "linea",
      "scroll"
     ],
     "type": "string"
    },
    "contract": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "token-price-change",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.005,
   "receipt_id": "g402-<16hex>"
  },
  "generated_at": "<iso8601>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/recent-percentage-price-change-for-a-token-36a07995/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)