# Live Price Oracle (`zinin/live-price-oracle`) Actor Current USD price for any token by contract address or ticker: 24h change, liquidity, volume, best DEX pair. Keyless, no wallet, no RPC node — DexScreener's public API. Built to be called cheaply by AI agents that just need the number. - **URL**: https://apify.com/zinin/live-price-oracle.md - **Developed by:** [Tim Zinin](https://apify.com/zinin) (community) - **Categories:** Agents, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 price fetcheds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Live Price Oracle — Crypto Price by Symbol or Address Point this Actor at a token contract address or ticker and get back its current USD price straight from DexScreener's public API, plus 24h change, liquidity and volume from the token's best-liquidity trading pair. No wallet, no RPC node, no API key — built to be called cheaply and often, e.g. by an AI agent quoting a trade over x402. ### What you get - **Price by address or ticker.** Pass an EVM `0x…` address, a Solana base58 address, or a plain ticker like `WETH` — one row per entry. - **The full picture on the best pair**: current USD price, 24h price change, that pair's liquidity and 24h volume, and which DEX and chain it trades on. - **Chain-scoped lookups.** Set `chainId` to pin the search to one EVM chain (Ethereum, BSC, Base, Polygon, Arbitrum). Pass a chain this Actor doesn't recognize and the row is rejected outright — `found: false`, free — instead of silently handing back a pair from the wrong chain. - **PulseChain guard.** PulseChain is a full state-fork of Ethereum, so a pre-fork Ethereum address has an unrelated "twin" there with unrelated liquidity that could otherwise silently outrank the real chain. PulseChain pairs are excluded unless they're the only match. - **Built for high-frequency calls.** Concurrency up to 20, keyless, no signup — cheap enough for an agent to hit before every quote or trade-sizing decision, not just once a day. - Runs on Apify: schedule it, monitor it, call it from the API or the MCP server, export to JSON/CSV/Excel, or push straight into your own pipeline. ### Who uses it - **Trading bots and AI agents** — a keyless, per-call price source cheap enough to hit before every quote or trade. - **Portfolio trackers** — refresh USD value across a token list without running a node. - **Researchers and dashboards** — pull price, liquidity and volume for a token list in one run. ### How to run it 1. Click **Try for free** — no card needed on the free plan. 2. Paste contract addresses or tickers into **Tokens**, one per row, and optionally set **Chain ID** to pin the search to a single EVM chain. 3. Press **Start** and read the results from the dataset — UI, API or webhook. ### Pricing Pay-per-event: **$0.005 per run start + $0.002 per result**. No monthly seat. 100 tokens cost about **$0.21**; 1,000 tokens about **$2.01**. A token that could not be priced — not found on the requested chain, or an unrecognized `chainId` — is still returned with `found: false` and the reason, and it is **not** charged for. You pay for a price, not for an attempt. ### Input | Field | Type | Description | |-------|------|-------------| | `tokens` | array of strings | Contract addresses (EVM `0x…` or Solana base58) or tickers/search terms. Up to 100. One row per entry. | | `chainId` | integer | Optional. Restrict to one EVM chain: 1=Ethereum, 56=BSC, 8453=Base, 137=Polygon, 42161=Arbitrum. An unrecognized chainId is rejected for free rather than falling through unfiltered. Leave empty to accept the best pair on any chain. | | `maxConcurrency` | integer | Parallelism (1–20, default 10). | ```json { "tokens": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "WETH"] } ```` ### Output One dataset row per input. This is a real row from a real run: ```json { "input": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "found": true, "chainId": "ethereum", "symbol": "USDC", "priceUsd": 1.00083, "priceChangeH24": -0.01, "liquidityUsd": 884338.84, "volumeH24": 46805699.37, "pairAddress": "0x0fb0e40cec3bb23e13abc585958a93c796fbea56955e19a23727a716a0423239", "dexId": "uniswap", "source": "dexscreener", "asOf": "2026-07-26T13:20:21.757Z", "summary": "USDC: $1.00083 (24h -0.0%)", "checkedAt": "2026-07-26T13:20:21.757Z" } ``` | Field | Description | |-------|--------------| | `input` | The address or search term you passed | | `found` | Whether a price was found | | `chainId` / `dexId` / `pairAddress` | Where the best pair trades | | `symbol` | The token's ticker | | `priceUsd` | Current price in USD | | `priceChangeH24` | 24h price change, percent | | `liquidityUsd` / `volumeH24` | The best pair's pool liquidity and 24h volume | | `source` | Always `"dexscreener"` | | `asOf` / `checkedAt` | When this price was pulled | | `summary` | Human-readable one-liner: `"{symbol}: $x (24h {change}%)"` | | `error` | Present only when `found: false` — why no price was returned, including an unsupported `chainId` | #### Need the rest of the picture? These run on the same account, take the same shape of input and bill the same way, so they slot into an existing pipeline without new plumbing. | Actor | What it does | |---|---| | [Rug Pull Risk Scorer](https://apify.com/zinin/rug-pull-scorer) | Score ERC-20/BEP-20 token rug-pull risk from honeypot.is simulation + DexScreener liquidity/age | | [Structured Data Extractor](https://apify.com/zinin/structured-extract) | Turn any URL into clean structured JSON — title, description, image, JSON-LD, headings, links, emails and… | | [Token Launch Radar](https://apify.com/zinin/token-launch-radar) | Look up any token contract address or ticker across DEXes and get liquidity, 24h volume, pair age, a 0-100… | | [AI Crawler Access Checker](https://apify.com/zinin/ai-crawler-access-checker) | Check which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended & more) can access your website | | [B2B Lead Enricher](https://apify.com/zinin/b2b-lead-enricher) | Turn a list of company websites into sales-qualified lead cards: detected tech stack, a rough revenue… | ### FAQ / Limitations **Does it need an API key or wallet?** No — DexScreener's public API is free and keyless. **How fresh is the data?** As fresh as DexScreener's own feed — typically seconds to a couple of minutes behind the DEX itself. **What happens if I pass a chain the token doesn't trade on, or a chain this Actor doesn't know?** An unrecognized `chainId` is rejected up front — `found: false`, not charged. A recognized chain with no pair for that token also comes back `found: false`, with the reason spelled out. **How is "best pair" chosen?** Highest liquidity on the requested chain (or across all chains if `chainId` is left empty), with PulseChain excluded unless it's the only match — see "PulseChain guard" above. **Can I call it from an AI agent?** Yes — it's a standard Apify Actor, callable via the Apify API or the Apify MCP server, and cheap enough to call per quote. **What this is NOT.** This is a price feed, not financial advice. It reports what DexScreener's public API shows — price, liquidity and volume — and nothing more. Nothing in its output is a recommendation to buy, sell or hold any token; verify independently before trading on it. Found a wrong result, or need a chain we don't cover? Open an issue on this Actor's page. *** Built by [zinin](https://apify.com/zinin). Questions? Telegram [@timzinin](https://t.me/timzinin). # Actor input Schema ## `tokens` (type: `array`): Token contract addresses (EVM `0x…` or Solana base58) or tickers/search terms (e.g. `WETH`, `PEPE`). One row per entry. ## `chainId` (type: `integer`): Restrict results to one EVM chain: 1=Ethereum, 56=BSC, 8453=Base, 137=Polygon, 42161=Arbitrum. Leave empty to accept the best pair on any chain. ## `maxConcurrency` (type: `integer`): How many tokens to look up in parallel. ## Actor input object example ```json { "tokens": [ "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "WETH" ], "maxConcurrency": 10 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "tokens": [ "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "WETH" ] }; // Run the Actor and wait for it to finish const run = await client.actor("zinin/live-price-oracle").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "tokens": [ "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "WETH", ] } # Run the Actor and wait for it to finish run = client.actor("zinin/live-price-oracle").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "tokens": [ "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "WETH" ] }' | apify call zinin/live-price-oracle --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zinin/live-price-oracle", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Live Price Oracle", "description": "Current USD price for any token by contract address or ticker: 24h change, liquidity, volume, best DEX pair. Keyless, no wallet, no RPC node — DexScreener's public API. Built to be called cheaply by AI agents that just need the number.", "version": "0.1", "x-build-id": "uhgHoPLZy6fyAPq7U" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zinin~live-price-oracle/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zinin-live-price-oracle", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/zinin~live-price-oracle/runs": { "post": { "operationId": "runs-sync-zinin-live-price-oracle", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/zinin~live-price-oracle/run-sync": { "post": { "operationId": "run-sync-zinin-live-price-oracle", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "tokens" ], "properties": { "tokens": { "title": "Tokens", "maxItems": 100, "type": "array", "description": "Token contract addresses (EVM `0x…` or Solana base58) or tickers/search terms (e.g. `WETH`, `PEPE`). One row per entry.", "items": { "type": "string" } }, "chainId": { "title": "Chain ID (optional)", "type": "integer", "description": "Restrict results to one EVM chain: 1=Ethereum, 56=BSC, 8453=Base, 137=Polygon, 42161=Arbitrum. Leave empty to accept the best pair on any chain." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many tokens to look up in parallel.", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```