# DexScreener Token Discovery API
> Live discovery of newly launched and newly promoted tokens across decentralized exchanges, powered by DexScreener's public token-profiles and token-boosts feeds, no key, nothing stored. This is the new-token discovery cut: not the price of a known trading pair, but which freshly listed tokens are appearing and which ones are spending to get attention right now — the raw deal-flow that degen traders, launch trackers and trading bots watch. The top endpoint returns the tokens with the most cumulative boost (DexScreener's paid promotion), ranked by total boost — effectively what is trending. The latest endpoint returns the most recently boosted tokens. The profiles endpoint returns the newest token profiles: freshly created token pages with their description, icon and social links. Every item carries the chain, the token contract address, the DexScreener link and the project's website and social links, and any endpoint can be filtered to a single chain (Solana, Ethereum, Base and more). Note: many listed tokens are unvetted — this is raw discovery, not an endorsement. This is the token-discovery / new-listings cut — distinct from the DEX trading-pair price data, the market-overview and the on-chain APIs in the catalogue.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/dexscreener-api/..."
```

## Pricing
- **Free** (Free) — 26,000 calls/Mo, 3 req/s
- **Degen** ($7/Mo) — 290,000 calls/Mo, 12 req/s
- **Pro** ($21/Mo) — 1,150,000 calls/Mo, 30 req/s
- **Scale** ($50/Mo) — 3,800,000 calls/Mo, 65 req/s

## Endpoints

### Top

#### `GET /v1/top` — Most-boosted (trending) tokens

**Parameters:**
- `chain` (query, optional, string) — Filter by chain Example: `solana`
- `limit` (query, optional, string) — Max tokens (1-30) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dexscreener-api/v1/top?chain=solana&limit=30"
```

**Response:**
```json
{
    "data": {
        "note": "Tokens with the most cumulative boost — effectively trending / most-promoted right now.",
        "count": 30,
        "source": "DexScreener",
        "tokens": [
            {
                "icon": "hQNbET9G0lTU1TBz",
                "chain": "solana",
                "links": [
                    {
                        "url": "https://www.fifaday.vip",
                        "type": "website"
                    },
                    {
                        "url": "https://x.com/fifadaycoin",
                        "type": "twitter"
                    }
                ],
                "description": "Today marks DAY ONE of the FIFA World Cup 2026\nWe are 26",
                "total_boost": 500,
                "boost_amount": null,
                "token_address": "HGii9wjcuj31g9uAQu3ncpEj4LGwzT3vj2AxUyMypump",
                "dexscreener_url": "https://dexscreener.com/solana/hgii9wjcuj31g9uaqu3ncpej4lgwzt3vj2axuymypump"
            },
            {
                "icon": "OmcNViI1hiurGv_i",
                "chain": "solana",
                "links": [
                    {
                        "url": "https://www.fifa26coin.site",
                        "type": "website"
                    },
                    {
                        "url": "https://x.com/fifa26coin",
                        "type": "twitter"
                    }
                ],
                "description": "FIFA 26 is the meme coin built 
…(truncated, see openapi.json for full schema)
```

### Latest

#### `GET /v1/latest` — Most recently boosted tokens

**Parameters:**
- `chain` (query, optional, string) — Filter by chain Example: `solana`
- `limit` (query, optional, string) — Max tokens (1-30) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dexscreener-api/v1/latest?chain=solana&limit=30"
```

**Response:**
```json
{
    "data": {
        "note": "Most recently boosted (newly promoted) tokens.",
        "count": 29,
        "source": "DexScreener",
        "tokens": [
            {
                "icon": "L-wx9-b_ljOWohW3",
                "chain": "solana",
                "links": [
                    {
                        "url": "https://x.com/search?q=ireland&src=recent_search_click",
                        "type": "website"
                    },
                    {
                        "url": "https://x.com/i/communities/2031772012989845535",
                        "type": "twitter"
                    }
                ],
                "description": null,
                "total_boost": 10,
                "boost_amount": 10,
                "token_address": "D6RcGUfNTkWdnNheCNqdQ6JWo8dX138tr1QB2AVbpump",
                "dexscreener_url": "https://dexscreener.com/solana/d6rcgufntkwdnnhecnqdq6jwo8dx138tr1qb2avbpump"
            },
            {
                "icon": "PKelh4eAvwh6l4L-",
                "chain": "solana",
                "links": [
                    {
                        "url": "https://x.com/i/communities/1999478587750019423",
                        "type": "twitter"
                    },
                    {
                        "url": "https://t.me/spacexiposol",
                        "type": "telegram"
                    }
                ],
                "description": "SpaceX IPO CTO to millions before the $IPO",
            
…(truncated, see openapi.json for full schema)
```

### Profiles

#### `GET /v1/profiles` — Newest token profiles

**Parameters:**
- `chain` (query, optional, string) — Filter by chain Example: `solana`
- `limit` (query, optional, string) — Max tokens (1-30) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dexscreener-api/v1/profiles?chain=solana&limit=30"
```

**Response:**
```json
{
    "data": {
        "note": "Newest token profiles (freshly created token pages).",
        "count": 26,
        "source": "DexScreener",
        "tokens": [
            {
                "icon": "https://cdn.dexscreener.com/cms/images/EmOXDoy12FrfQTEN?width=64&height=64&fit=crop&quality=95&format=auto",
                "chain": "solana",
                "links": [
                    {
                        "url": "https://x.com/schoen_xyz/status/2065229028827582762?s=46",
                        "type": "twitter"
                    }
                ],
                "description": null,
                "token_address": "57pFFeM1BCACozgSrXMSfJjodWEUR9cFSj7CzcPUpump",
                "dexscreener_url": "https://dexscreener.com/solana/57pffem1bcacozgsrxmsfjjodweur9cfsj7czcpupump"
            },
            {
                "icon": "https://cdn.dexscreener.com/cms/images/4k8pATMY-h1VBW43?width=64&height=64&fit=crop&quality=95&format=auto",
                "chain": "solana",
                "links": [
                    {
                        "url": "https://x.com/Meme_Team_26",
                        "type": "twitter"
                    },
                    {
                        "url": "https://t.me/memeteamonxpad",
                        "type": "telegram"
                    },
                    {
                        "url": "https://www.tiktok.com/@meme.team.26",
                        "type": "tiktok"
                    },
                    {
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dexscreener-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "boost is DexScreener's paid-promotion unit; total_boost is cumulative. Optional chain filter (chain=solana, ethereum, base). Many tokens are unvetted — this is raw discovery, not endorsement.",
        "source": "DexScreener (api.dexscreener.com, live)",
        "service": "dexscreener-api",
        "endpoints": {
            "GET /v1/top": "Tokens with the most cumulative boost — trending / most-promoted (chain optional, limit=30).",
            "GET /v1/meta": "This document.",
            "GET /v1/latest": "Most recently boosted (newly promoted) tokens (chain optional).",
            "GET /v1/profiles": "Newest token profiles — freshly created token pages with links (chain optional)."
        },
        "description": "Live discovery of newly launched and newly promoted tokens across decentralized exchanges, from DexScreener. The new-token discovery cut: not the price of a known pair, but which freshly listed tokens are appearing and which are spending on promotion right now. The top endpoint returns tokens with the most cumulative boost (trending / most-promoted); the latest endpoint returns the most recently boosted tokens; the profiles endpoint returns the newest token profiles with their description and social links. Each item carries chain, token contract, description, icon, DexScreener link and the project's links. Live, no key, nothing stored. The token-discovery / new-listings cut — distinct from the DEX trading-pair price d
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/dexscreener-api
OpenAPI spec: https://www.oanor.com/api/dexscreener-api/openapi.json
