Search Token (Ultra API)

curl --request GET \
  --url https://api.jup.ag/ultra/v1/search \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.jup.ag/ultra/v1/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jup.ag/ultra/v1/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jup.ag/ultra/v1/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.jup.ag/ultra/v1/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "icon": "<string>",
    "decimals": 123,
    "tokenProgram": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "twitter": "<string>",
    "telegram": "<string>",
    "website": "<string>",
    "discord": "<string>",
    "instagram": "<string>",
    "tiktok": "<string>",
    "otherUrl": "<string>",
    "dev": "<string>",
    "mintAuthority": "<string>",
    "freezeAuthority": "<string>",
    "issuer": "<string>",
    "circSupply": 123,
    "totalSupply": 123,
    "launchpad": "<string>",
    "partnerConfig": "<string>",
    "graduatedPool": "<string>",
    "graduatedAt": "<string>",
    "holderCount": 123,
    "fdv": 123,
    "mcap": 123,
    "usdPrice": 123,
    "priceBlockId": 123,
    "liquidity": 123,
    "fees": 123,
    "apy": {
      "jupEarn": 123
    },
    "stats5m": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats1h": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats6h": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats24h": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats7d": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats30d": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "firstPool": {
      "id": "<string>",
      "createdAt": "<string>"
    },
    "audit": {
      "isSus": true,
      "mintAuthorityDisabled": true,
      "freezeAuthorityDisabled": true,
      "topHoldersPercentage": 123,
      "devBalancePercentage": 123,
      "devMints": 123
    },
    "organicScore": 123,
    "organicScoreLabel": "high",
    "isVerified": true,
    "tags": [
      "<string>"
    ],
    "updatedAt": "2023-11-07T05:31:56Z"
  }
]

{
  "error": "<string>"
}

{
  "error": "<string>"
}

GET

curl --request GET \
  --url https://api.jup.ag/ultra/v1/search \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.jup.ag/ultra/v1/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jup.ag/ultra/v1/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jup.ag/ultra/v1/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.jup.ag/ultra/v1/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "icon": "<string>",
    "decimals": 123,
    "tokenProgram": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "twitter": "<string>",
    "telegram": "<string>",
    "website": "<string>",
    "discord": "<string>",
    "instagram": "<string>",
    "tiktok": "<string>",
    "otherUrl": "<string>",
    "dev": "<string>",
    "mintAuthority": "<string>",
    "freezeAuthority": "<string>",
    "issuer": "<string>",
    "circSupply": 123,
    "totalSupply": 123,
    "launchpad": "<string>",
    "partnerConfig": "<string>",
    "graduatedPool": "<string>",
    "graduatedAt": "<string>",
    "holderCount": 123,
    "fdv": 123,
    "mcap": 123,
    "usdPrice": 123,
    "priceBlockId": 123,
    "liquidity": 123,
    "fees": 123,
    "apy": {
      "jupEarn": 123
    },
    "stats5m": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats1h": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats6h": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats24h": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats7d": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "stats30d": {
      "priceChange": 123,
      "holderChange": 123,
      "liquidityChange": 123,
      "volumeChange": 123,
      "buyVolume": 123,
      "sellVolume": 123,
      "buyOrganicVolume": 123,
      "sellOrganicVolume": 123,
      "numBuys": 123,
      "numSells": 123,
      "numTraders": 123,
      "numOrganicBuyers": 123,
      "numNetBuyers": 123
    },
    "firstPool": {
      "id": "<string>",
      "createdAt": "<string>"
    },
    "audit": {
      "isSus": true,
      "mintAuthorityDisabled": true,
      "freezeAuthorityDisabled": true,
      "topHoldersPercentage": 123,
      "devBalancePercentage": 123,
      "devMints": 123
    },
    "organicScore": 123,
    "organicScoreLabel": "high",
    "isVerified": true,
    "tags": [
      "<string>"
    ],
    "updatedAt": "2023-11-07T05:31:56Z"
  }
]

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Ultra Swap API is no longer actively maintained and has been superseded by Swap V2.

Authorizations

x-api-key

string

header

required

Get API key via https://developers.jup.ag/portal

Query Parameters

query

string

default:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

required

Search for a token and its information by its symbol, name or mint address
Comma-separate to search for multiple
Limit to 100 mint addresses in query
Default to 20 mints in response when searching via symbol or name

Response

Successful response

string

The token's mint address

name

string

symbol

string

icon

string | null

URL to the token's logo image

decimals

number

tokenProgram

string

The token program address (SPL Token or Token-2022)

createdAt

string<date-time>

Token creation timestamp

twitter

string | null

website

string | null

discord

string | null

instagram

string | null

tiktok

string | null

otherUrl

string | null

dev

string | null

The token's developer wallet address

mintAuthority

string | null

Mint authority address (present when mint authority is not disabled)

freezeAuthority

string | null

Freeze authority address (present when freeze authority is not disabled)

issuer

string | null

Token issuer name (e.g., "Circle" for USDC)

circSupply

number | null

totalSupply

number | null

launchpad

string | null

partnerConfig

string | null

graduatedPool

string | null

graduatedAt

string | null

holderCount

number | null

fdv

number | null

Fully diluted valuation in USD

mcap

number | null

Market cap in USD

usdPrice

number | null

priceBlockId

number | null

Solana block number for the price data point

liquidity

number | null

Total liquidity in USD

fees

number | null

Trading fees in USD

apy

object | null

APY data, only present for assets listed on Jupiter Lend's Earn

Show child attributes

stats5m

object | null

Show child attributes

stats1h

object | null

Show child attributes

stats6h

object | null

Show child attributes

stats24h

object | null

Show child attributes

stats7d

object | null

7-day stats (typically only priceChange, but may include volume fields)

Show child attributes

stats30d

object | null

30-day stats (typically only priceChange, but may include volume fields)

Show child attributes

firstPool

object | null

Show child attributes

audit

object | null

Audit information. All sub-fields are conditional and vary per token.

Show child attributes

organicScore

number

Organic trading activity score (0-100)

organicScoreLabel

enum<string>

Available options:

high,

medium,

low

isVerified

boolean | null

Swap

Meta-Aggregator

Metis (Onchain Router)

Advanced

Routing Integration

Guides

Migration

Authorizations

Query Parameters

Response