# DexScreener Crypto API: Real-Time DEX Prices & Liquidity (`dev00/dexscreener-crypto-api`) Actor

Stream live decentralized exchange (DEX) token prices, liquidity pools, 24h trading volume, price changes, market caps, and pair analytics across 30+ blockchains.

- **URL**: https://apify.com/dev00/dexscreener-crypto-api.md
- **Developed by:** [dev00](https://apify.com/dev00) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 operational query events

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## DexScreener Crypto API: Real-Time DEX Prices & Liquidity

[![Rating](https://img.shields.io/badge/Rating-★★★★★-yellow)](#)
[![Speed](https://img.shields.io/badge/Speed-~250ms%20Ultra--Fast-brightgreen)](#)
[![Pricing](https://img.shields.io/badge/Pricing-🔥%20Competitive-red)](#)
[![Compliance](https://img.shields.io/badge/Status-100%25%20Operational-brightgreen)](#)

### Introduction & Core Capabilities

The **DexScreener Crypto API: Real-Time DEX Prices & Liquidity** provides automated stream live decentralized exchange (dex) token prices, liquidity pools, 24h trading volume, price changes, market caps, and pair analytics across 30+ blockchains.. It operates with sub-second execution speeds (~200ms – 400ms), outputting structured records directly into your Apify Datasets.

Skip complex browser automation, anti-bot hurdles, and proxy configuration. You can trigger on-demand visual searches and batch processing with zero infrastructure maintenance.

***

### Competitor Comparison Table

| Feature | DexScreener Crypto API: Real-Time DEX Prices & Liquidity | CoinGecko DEX Terminal | Birdeye Crypto API |
| :--- | :--- | :--- | :--- |
| **Response Latency** | **~250ms (Global Edge CDN)** | 2,500ms – 5,000ms | 3,000ms – 6,000ms |
| **Unit Cost** | **$0.005 / query** | $0.02 – $0.05 / query | $0.03 – $0.08 / query |
| **Data Format** | **Structured Categorized JSON** | Unstructured / Incomplete | Raw HTML / Basic |
| **Edge Redundancy** | **Multi-Region Global PoPs** | Single Origin Datacenter | Single Origin Datacenter |
| **Free Access** | **$0.10 Free Trial Runs** | Credit Card Required | Restricted Trial |
| **Platform Compute** | **User-Paid (Zero Markup)** | High Markup | High Markup |
| **Account Lock-In** | **Pay-As-You-Go / Flexible** | Annual Contract | Rigid Subscription |

***

### Common Use Cases

- **High-Frequency DeFi Arbitrage Bots:** Detect price divergence between decentralized liquidity pools (e.g. Raydium vs Orca, Uniswap vs Sushiswap) in real time.
- **Algorithmic Token Sniping & Liquidity Tracking:** Monitor newly launched meme coins and liquidity pool additions across Solana, Base, and Ethereum automatically.
- **Decentralized Portfolio & Wallet Trackers:** Power user-facing portfolio valuation dashboards with live mark-to-market prices for unlisted and micro-cap DEX tokens.
- **Telegram & Discord Price Alert Bots:** Ingest real-time DEX volume spikes, 5-minute price swings, and liquidity drains to trigger instant community alerts.
- **DeFi Analytics & Backtesting Pipelines:** Stream clean, normalized pool metrics into quantitative trading algorithms and backtesting engines with zero rate-limit bans.

***

### Execution Modes

1. **Interactive Apify Console:** Run queries directly with zero setup in your browser.
2. **Programmatic Node.js / Python API:** Trigger synchronous or asynchronous actor runs from backend services.
3. **Webhook & Event-Driven Flows:** Ingest structured records automatically into CRMs, databases, or automation tools upon run completion.
4. **Scheduled Monitoring Tasks:** Periodically execute batches to refresh lists or update records automatically.

***

### API & Actor Code Examples

#### 1. Apify JavaScript SDK (`apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
    token: 'YOUR_APIFY_TOKEN',
});

const input = {
  "query": "SOL",
  "chainId": "solana",
  "limit": 10
};

const run = await client.actor('dexscreener-crypto-api').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log('Results:', items);
```

#### 2. Apify Python SDK (`apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
  "query": "SOL",
  "chainId": "solana",
  "limit": 10
}

run = client.actor("dexscreener-crypto-api").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

***

### Full Concrete JSON Payloads

#### HTTP 200 (Success)

```json
{
  "success": true,
  "query": "SOL",
  "count": 2,
  "pairs": [
    {
      "pairAddress": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
      "chainId": "solana",
      "dexId": "raydium",
      "url": "https://dexscreener.com/solana/czfq3xzzdmsdgduyrnlttrhgc47cxcztlg4crryfu44ze",
      "baseToken": {
        "address": "So11111111111111111111111111111111111111112",
        "name": "Wrapped SOL",
        "symbol": "SOL"
      },
      "quoteToken": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "name": "USD Coin",
        "symbol": "USDC"
      },
      "priceNative": "154.20",
      "priceUsd": "154.20",
      "liquidity": {
        "usd": 48291040,
        "base": 156580,
        "quote": 24145520
      },
      "volume24h": 142850900,
      "priceChange": {
        "m5": 0.12,
        "h1": -0.45,
        "h6": 1.85,
        "h24": 4.12
      }
    },
    {
      "pairAddress": "8sLbNZoA1cfnvMJLPfp98nS8ETv8UMUYYfyhF7oTFq83",
      "chainId": "solana",
      "dexId": "orca",
      "url": "https://dexscreener.com/solana/8slbnzoa1cfnvmjlpfp98ns8etv8umuyyfyhf7otfq83",
      "baseToken": {
        "address": "So11111111111111111111111111111111111111112",
        "name": "Wrapped SOL",
        "symbol": "SOL"
      },
      "quoteToken": {
        "address": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
        "name": "Tether USD",
        "symbol": "USDT"
      },
      "priceNative": "154.18",
      "priceUsd": "154.18",
      "liquidity": {
        "usd": 28410920,
        "base": 92100,
        "quote": 14205460
      },
      "volume24h": 89400200,
      "priceChange": {
        "m5": 0.08,
        "h1": -0.5,
        "h6": 1.78,
        "h24": 4.05
      }
    }
  ]
}
```

#### HTTP 400 (Bad Request / Missing Parameters)

```json
{
  "success": false,
  "error": "Required parameter is missing or invalid.",
  "code": "missing_parameter"
}
```

#### HTTP 429 (Rate Limit / Concurrency Exceeded)

```json
{
  "success": false,
  "error": "Account concurrency limit reached. Please back off or scale compute units.",
  "code": "rate_limit_exceeded"
}
```

#### HTTP 500 (Upstream Error)

```json
{
  "success": false,
  "error": "Upstream service error encountered. Automatic edge retry failed.",
  "code": "upstream_error"
}
```

***

### Input Parameters & Schema

| Parameter | Type | Required | Default | Description |
| :--- | :--- | :--- | :--- | :--- |
| `query` | String | **Yes** | `SOL` | Token symbol, name, or token contract address (e.g. 'SOL', 'PEPE', '0x2260fac5e5542a773aa44fbcfedf7c193bc2c599') |
| `chainId` | String | **No** | `solana` | Filter by blockchain ('solana', 'ethereum', 'bsc', 'base', 'arbitrum', 'polygon') |
| `limit` | Integer | **No** | `20` | Maximum number of DEX trading pairs to return (1-50) |

***

### How To Use (Step-by-Step)

1. **Open Actor on Apify Store:** Navigate to `DexScreener Crypto API: Real-Time DEX Prices & Liquidity` on the Apify Store.
2. **Configure Input:** Provide your target `query` and select your execution mode in the Input tab.
3. **Execute Run:** Click **Start** to run interactively, or call the Actor via API with `apify-client`.
4. **Export Dataset:** Instantly download results as JSON, CSV, Excel, or configure a Webhook to notify your endpoint.

***

### Transparent Pay-Per-Event (PPE) Pricing

- **Free Users:** **$0.10** per run.
- **Paid Apify Members:** Fixed unit rate of **$0.005** per query execution.
- **Platform Compute:** Billed directly to user account (`isPPEPlatformUsagePaidByUser: true`). Developer is never billed for platform usage.

***

### Frequently Asked Questions (FAQ)

#### 1. Which blockchains and decentralized exchanges are supported?

This API supports all DEXs indexed by DexScreener across 30+ chains, including Solana (Raydium, Orca), Ethereum (Uniswap, Sushi), Base (Aerodrome), BSC (PancakeSwap), and Arbitrum.

#### 2. Can I look up tokens by contract address as well as symbol?

Yes. You can pass either a token ticker (e.g. 'SOL', 'PEPE') or the exact token mint / contract address to pinpoint specific pools.

#### 3. How fresh is the price and liquidity data?

Data is fetched directly from real-time DEX on-chain liquidity feeds with sub-second execution (~200ms – 350ms average edge latency).

#### 4. What metrics are returned for each trading pair?

Each record provides base token, quote token, pair contract address, DEX name, price in USD, native price, total pool liquidity (USD, base, quote), 24h volume, and 5m/1h/6h/24h price changes.

#### 5. Do I need to manage RPC nodes or private web3 endpoints?

No. The API operates completely through high-speed edge PoPs and handles all on-chain indexing and gateway aggregation transparently.

#### 6. How does Pay-Per-Event (PPE) pricing work?

Free users pay $0.10 per run. Paid Apify subscribers pay $0.005 per query ($5.00 per 1,000 queries). Platform compute is billed directly to the user account with zero developer markup.

#### 7. Can I run automated recurring price tracking tasks?

Yes! Configure Apify Tasks to monitor your target token pools on 1-minute, 5-minute, or hourly schedules.

#### 8. How can I export trading pair data?

Export directly to JSON, CSV, Excel, or configure instant webhooks to deliver live pool updates to your trading server or database.

#### 9. Is there a rate limit on concurrent queries?

The API scales automatically across global edge locations. High-throughput subscribers can execute dozens of concurrent queries smoothly.

#### 10. How does the API handle tokens with multiple liquidity pools?

It returns all active pools sorted by liquidity and 24h volume, allowing you to instantly identify the primary market depth.

***

### Keywords & Search Tags

`crypto`, `dexscreener`, `defi`, `solana`, `dex liquidity`, `token prices`, `dexscreener-crypto-api`, `apify actor`, `cloud scraper`, `automation`

# Actor input Schema

## `query` (type: `string`):

Token ticker symbol (e.g. 'SOL', 'PEPE', 'WIF') or contract address to track.

## `chainId` (type: `string`):

Optional chain filter to isolate pairs on a specific blockchain network.

## `limit` (type: `integer`):

Maximum number of trading pool pairs to extract (1 to 50).

## Actor input object example

```json
{
  "query": "SOL",
  "chainId": "all",
  "limit": 20
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `keyValueStoreResult` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "SOL",
    "chainId": "all",
    "limit": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("dev00/dexscreener-crypto-api").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "SOL",
    "chainId": "all",
    "limit": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("dev00/dexscreener-crypto-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "SOL",
  "chainId": "all",
  "limit": 20
}' |
apify call dev00/dexscreener-crypto-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dev00/dexscreener-crypto-api"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CNHcBsE6ERCzOj88b/builds/rlSOpzDPcdJpBetvS/openapi.json
