# DEX Screener Token Pairs API Documentation

<p><strong>DEX Screener Token Pairs API Documentation</strong> List all pairs that trade one token. Pass the chain and token address from search unchanged. Each pair has the full pair field set: price USD, liquidity, 24h volume, price change, FDV, buys and sells, socials and full-size image URLs. Results are ranked by 24h volume. Prices are numbers with a currency field and creation times are ISO 8601. A genuinely empty answer and every failed request cost no credit. Cost: 1 credit per successful request. Scrappa is an independent service and is not affiliated with or endorsed by DEX Screener.</p>

- **Documentation:** [https://scrappa.co/docs/dexscreener-api/dexscreener_token_pairs](https://scrappa.co/docs/dexscreener-api/dexscreener_token_pairs)
- **API group:** DEX Screener API
- **Endpoint:** `GET https://scrappa.co/api/dexscreener/token/pairs`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `chain` | string | Yes | Chain slug from search, e.g. ethereum. |
| `address` | string | Yes | Token address from search. |

## Example response

```json
{
    "data": {
        "chain": "ethereum",
        "count": 1,
        "pairs": [
            {
                "volume": {
                    "h24": 12000000
                },
                "currency": "USD",
                "priceUsd": 3450.5,
                "pairAddress": "0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8"
            }
        ],
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    },
    "meta": {
        "source": "dexscreener",
        "credits": 1,
        "billable": true,
        "endpoint_family": "token.pairs"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | The upstream data is temporarily unavailable. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
