{"uid":"cap_k_tBfz7DJDdkD3a3M3NDe","slug":"recent-percentage-price-change-for-a-token-36a07995","name":"Recent Percentage Price Change for a Token","description":"Recent percentage price change for a token — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/token-price-change?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}$"}}}}},"responseSchema":{"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>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__ekiUTrVVVis5QvnIYuWH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the recent percentage price change for a specific ERC-20 token on a given blockchain network","exampleAgentPrompt":"What's the recent percentage price change for the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?","exampleUseCases":[{"title":"DeFi portfolio price monitoring","prompt":"Check how much the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum has changed in price recently — I want to know if it's up or down."},{"title":"Cross-chain token price comparison","prompt":"Get the recent price change percentage for the token at contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon so I can compare it to its performance on other chains."},{"title":"Arbitrage opportunity detection","prompt":"What's the recent price change for the token at 0x82af49447d8a07e3bd95bd0d56f35241523fbab1 on Arbitrum? I need to know if there's been a significant move I should act on."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:45.841Z","isFirstParty":false,"canonicalSlug":"recent-percentage-price-change-for-a-token-36a07995"}