Solana token lookup (Jupiter)

Resolve a Solana token by mint, ticker or name through Jupiter's token index and get its profile in one read: name, symbol, decimals, price, market cap, FDV, liquidity, holder count, circulating and total supply, verified flag, organic score (Jupiter's wash-trade-resistant activity score), tags, launchpad, dev wallet, first pool and date, audit facts (mint and freeze authority disabled, top-holder share, dev mints) and 24h stats (price, holder and liquidity change, buy/sell volume, traders, net buyers). Send POST /api/sol-token-lookup with the required field query and pay $0.002 per call over x402 or MPP (there is no free tier). It returns a JSON object with query, count, tokens, source and fetchedAt.

Up to 20 matches for a name search; a mint returns its exact match first. Keyless.

Category: Crypto & onchain data · Tags: solana token lookup jupiter metadata ticker spl · Also found as: solana-token-lookup-jupiter solana-token-lookup

TRY IN PLAYGROUND →

Parameters

Example request

curl -i -X POST https://agent402.tools/api/sol-token-lookup \
  -H "Content-Type: application/json" \
  -d '{"query":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","limit":3}'

Without payment this returns HTTP 402 Payment Required with the exact price for sol-token-lookup; any x402 v2 or MPP client pays it and retries.

Example response

{
  "query": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  "count": 1,
  "tokens": [
    {
      "mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
      "name": "Jupiter",
      "symbol": "JUP",
      "decimals": 6,
      "priceUsd": 0.2034,
      "marketCapUsd": 675335464.98,
      "fdvUsd": 1395785031.78,
      "liquidityUsd": 3092754.48,
      "holderCount": 835540,
      "circulatingSupply": 3320312968.08,
      "totalSupply": 6862431164.93,
      "isVerified": true,
      "organicScore": 99.31,
      "organicScoreLabel": "high",
      "tags": [
        "strict",
        "verified",
        "defi"
      ],
      "audit": {
        "mintAuthorityDisabled": true,
        "freezeAuthorityDisabled": true,
        "topHoldersPct": 15.28,
        "devBalancePct": null,
        "devMints": 1
      },
      "mintAuthority": null,
      "freezeAuthority": null,
      "launchpad": null,
      "dev": "JUPh...",
      "firstPool": {
        "id": "2psp...",
        "createdAt": "2024-01-29T17:33:29Z"
      },
      "stats24h": {
        "priceChangePct": -2.4,
        "holderChangePct": 0.1,
        "liquidityChangePct": -1.2,
        "buyVolumeUsd": 26000000,
        "sellVolumeUsd": 25000000,
        "numBuys": 1696,
        "numSells": 1735,
        "numTraders": 1191,
        "numNetBuyers": 668
      },
      "createdAt": "2025-07-25T13:18:02Z"
    }
  ],
  "source": "jupiter",
  "fetchedAt": "2026-08-22T12:00:00.000Z"
}

From an MCP client

catalog.call {
  "slug": "sol-token-lookup",
  "params": {
    "query": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
    "limit": 3
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for sol-token-lookup; the stdio package pays it from a wallet or from AGENT402_CREDITS_KEY. Local install: npx -y agent402-mcp.

Errors and behavior

• query is required. An input the tool rejects returns an HTTP 4xx whose body carries error, tool, expected, required and example, so the caller can correct it.
• A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement is cancelled when the tool fails. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
• Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key (Authorization: Bearer a402_...) also pays it.
• A GET or HEAD to /api/sol-token-lookup returns the same 402 quote, so the price can be read without a body.
• An Idempotency-Key header makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB is not replayed).

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.(false); // keep your own spending ceiling in code
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/sol-token-lookup", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "query": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
    "limit": 3
  }),
});

Related tools