# 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"
```

### 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"
```

### 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"
```

### Meta

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

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


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