# Jupiter Solana DEX Aggregator API
> Live data from Jupiter — the leading DEX aggregator on Solana — served from its public API as clean JSON, no cache. Get the live USD price, on-chain liquidity and 24h price change for any Solana token mint (one or many at once); get the best swap route Jupiter finds between two token mints for a given input amount — the output amount, price impact and number of routing hops, the heart of the aggregator; or search Solana tokens by symbol, name or mint and get the top match's price, liquidity, market cap, decimals and holder count. Read live from Jupiter, nothing cached. This is Jupiter's own Solana swap-routing, token-price and token-search layer — distinct from EVM on-chain explorers, other DEX/DeFi feeds and generic price APIs: the live routing and pricing engine of Solana's biggest swap aggregator.

## 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/jupiter-api/..."
```

## Pricing
- **Free** (Free) — 950 calls/Mo, 3 req/s
- **Starter** ($10/Mo) — 33,000 calls/Mo, 12 req/s
- **Pro** ($28/Mo) — 172,000 calls/Mo, 28 req/s
- **Business** ($68/Mo) — 870,000 calls/Mo, 55 req/s

## Endpoints

### Price

#### `GET /v1/price` — USD price, liquidity and 24h change for token mints

**Parameters:**
- `ids` (query, required, string) — One or more Solana mints (comma-separated) Example: `So11111111111111111111111111111111111111112`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/jupiter-api/v1/price?ids=So11111111111111111111111111111111111111112"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "prices": {
            "So11111111111111111111111111111111111111112": {
                "decimals": 9,
                "usd_price": 62.83270031,
                "liquidity_usd": 621773237.77,
                "price_change_24h_pct": -3.1102
            }
        },
        "source": "Jupiter"
    },
    "meta": {
        "timestamp": "2026-06-10T22:58:08.676Z",
        "request_id": "59bf20df-19e6-4133-9ee9-fe05574d0e1a"
    },
    "status": "ok",
    "message": "Price retrieved successfully",
    "success": true
}
```

### Quote

#### `GET /v1/quote` — Best swap route between two mints

**Parameters:**
- `input` (query, required, string) — Input token mint Example: `So11111111111111111111111111111111111111112`
- `output` (query, required, string) — Output token mint Example: `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`
- `amount` (query, required, string) — Input amount in raw base units Example: `1000000000`
- `slippage_bps` (query, optional, string) — Slippage tolerance in bps Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/jupiter-api/v1/quote?input=So11111111111111111111111111111111111111112&output=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1000000000&slippage_bps=50"
```

**Response:**
```json
{
    "data": {
        "route": [
            "Quantum"
        ],
        "source": "Jupiter",
        "in_amount": "1000000000",
        "swap_mode": "ExactIn",
        "input_mint": "So11111111111111111111111111111111111111112",
        "out_amount": "62848506",
        "route_hops": 1,
        "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "slippage_bps": 50,
        "price_impact_pct": 0,
        "other_amount_threshold": "62534264"
    },
    "meta": {
        "timestamp": "2026-06-10T22:58:08.789Z",
        "request_id": "ecd0d4d7-2130-4e71-8f65-855bdf341002"
    },
    "status": "ok",
    "message": "Quote retrieved successfully",
    "success": true
}
```

### Token

#### `GET /v1/token` — Search Solana tokens by symbol, name or mint

**Parameters:**
- `query` (query, required, string) — Symbol, name or mint Example: `USDC`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/jupiter-api/v1/token?query=USDC"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "USDC",
        "source": "Jupiter",
        "results": [
            {
                "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "name": "USD Coin",
                "symbol": "USDC",
                "fdv_usd": 8180891300.09,
                "decimals": 6,
                "usd_price": 0.99979261,
                "holder_count": 5248202,
                "liquidity_usd": 397803028.73,
                "market_cap_usd": 8180891300.09,
                "circulating_supply": 8182588255.151976
            },
            {
                "mint": "9BEcn9aPEmhSPbPQeFGjidRiEKki46fVQDyPpSQXPA2D",
                "name": "jupiter lend USDC",
                "symbol": "jlUSDC",
                "fdv_usd": 404858636.42,
                "decimals": 6,
                "usd_price": 1.04677031,
                "holder_count": 11862,
                "liquidity_usd": 404858636.42,
                "market_cap_usd": 404858636.42,
                "circulating_supply": 386769316.481295
            },
            {
                "mint": "AvZZF1YaZDziPY2RCK4oJrRVrbN3mTD9NL24hPeaZeUj",
                "name": "Syrup USDC",
                "symbol": "syrupUSDC",
                "fdv_usd": 115691278.98,
                "decimals": 6,
                "usd_price": 1.1680353,
                "holder_count": 3626,
                "liquidity_usd": 23344685.48,
                "market_cap_usd": 115691278.98,
                "ci
…(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/jupiter-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Amounts are raw base units (use the token's decimals); SOL mint = So11111111111111111111111111111111111111112, USDC = EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.",
        "source": "Jupiter API (lite-api.jup.ag, live)",
        "service": "jupiter-api",
        "sol_usd": 62.8327,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/price": "USD price, liquidity and 24h change for token mints (ids=mint1,mint2).",
            "GET /v1/quote": "Best swap route between two mints (input=, output=, amount=raw, slippage_bps=50).",
            "GET /v1/token": "Search Solana tokens by symbol, name or mint (query=USDC)."
        },
        "description": "Live data from Jupiter, the leading DEX aggregator on Solana, via its public API. The price endpoint returns the live USD price, on-chain liquidity and 24h change for any Solana token mint (one or many); the quote endpoint returns the best swap route Jupiter finds between two mints for a given input amount — output amount, price impact and routing hops; the token endpoint searches Solana tokens by symbol, name or mint and returns the top match's price, liquidity, market cap, decimals and holder count. Live, no key, nothing stored. Distinct from EVM on-chain explorers, other DEX/DeFi feeds and generic price APIs — this is Jupiter's own Solana swap-routing, token-price and token-search layer.",
        "upstream_status": "ok"
    },
    "meta": {
        "tim
…(truncated, see openapi.json for full schema)
```


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