Tokens API

Tracked-wallet activity around tokens: paginated trades on a given mint, a per-wallet roll-up for a mint, and a discovery view of tokens many wallets are holding at once.

All endpoints require your API key (Authorization: Bearer <API_KEY>) and cost heavier credits (these run wider scans).

---

Token swaps

GET /tokens/{mint}/swaps

Tracked-wallet swaps on a single mint, newest first. This endpoint is cursor paginated and returns tracked wallets only.

curl "https://api.prysmatic-sol.xyz/tokens/<mint>/swaps?limit=100" -H "Authorization: Bearer <API_KEY>"

Query parameters

Name	Type	Default	Description
limit	int	100	Number of rows to return (1..200).
cursor	string	none	Cursor from the previous response's next_cursor.

Response

{
  "mint": "FSA7iqBeeENna2LUmZyqCYce7op2jBc9ztXLKdM6bonk",
  "count": 1,
  "limit": 100,
  "has_more": true,
  "next_cursor": "eyJ0IjoxNzgxNDUwMzYxLCJpIjo5MzQyfQ",
  "items": [
    {
      "block_time": 1781450361,
      "wallet": "W72",
      "side": "sell",
      "base_mint": "FSA7iqBeeENna2LUmZyqCYce7op2jBc9ztXLKdM6bonk",
      "base_amount": "6280118271393",
      "base_decimals": 6,
      "quote_mint": "So11111111111111111111111111111111111111112",
      "quote_amount": "9311208742",
      "program": "FLASHX8DrLbgeR8FcfNV1F5krxYcYMUdBkrP1EPBtxB9",
      "confidence": "delta_only",
      "quote_mismatch": false
    }
  ]
}

Field	Meaning
block_time	Trade time (unix seconds).
wallet	Wallet alias.
side	buy or sell.
base_amount	Raw token amount (divide by 10 ^ base_decimals).
quote_mint	The quote coin (WSOL / USDC / USDT).
quote_amount	Raw quote amount. For WSOL it is lamports (/ 1e9 for SOL).
confidence	high or delta_only (how the swap was derived).
quote_mismatch	true if no clean opposing quote leg was found.

Use the cursor to fetch the next page:

curl "https://api.prysmatic-sol.xyz/tokens/<mint>/swaps?limit=100&cursor=eyJ0IjoxNzgxNDUwMzYxLCJpIjo5MzQyfQ" -H "Authorization: Bearer <API_KEY>"

---

Token wallet aggregates

GET /tokens/{mint}/wallet-aggregates

One row per wallet that traded the mint, with the position facts:

curl "https://api.prysmatic-sol.xyz/tokens/<mint>/wallet-aggregates" -H "Authorization: Bearer <API_KEY>"

{
  "mint": "FSA7iqBeeENna2LUmZyqCYce7op2jBc9ztXLKdM6bonk",
  "tracked_wallets": 4,
  "wallets": [
    {
      "wallet": "W221",
      "alias": "W221",
      "buys": 2,
      "sells": 2,
      "base_bought": "23606614317783",
      "base_sold": "21460559039733",
      "base_net": "2146055278050",
      "sol_in": 8.69,
      "sol_out": 5.63,
      "pct_held": 0.0909,
      "first_buy_time": 1781448342,
      "last_trade_time": 1781448742,
      "entry_mcap": 51230.0
    }
  ]
}

Field	Meaning
base_bought/sold	Raw tokens bought / sold.
base_net	base_bought - base_sold (what is still held).
sol_in / out	SOL spent buying / received selling.
pct_held	base_net / base_bought, the fraction of the buy still held.
entry_mcap	Market cap (USD) snapshotted at the wallet's first buy.

---

Tokens held by multiple wallets

GET /tokens/held

Tokens currently held by at least N tracked wallets, a quick way to see what smart money is collectively sitting on. 25 per page, ordered by how many wallets co-hold each token (highest first).

"Held" uses the same definition as wallet holdings: net buys - sells > 0.

curl "https://api.prysmatic-sol.xyz/tokens/held?min_wallets=2&page=1" -H "Authorization: Bearer <API_KEY>"

Query parameters

Name	Type	Default	Description
min_wallets	int	2	Held by at least this many wallets (>=).
page	int	1	Page number (>= 1).

Response

{
  "min_wallets": 2,
  "page": 1,
  "page_size": 25,
  "total": 2,
  "has_more": false,
  "items": [
    {
      "token": { "address": "FSA7iqBeeENna2LUmZyqCYce7op2jBc9ztXLKdM6bonk", "decimals": 6 },
      "holders": { "wallet_count": 4, "wallets": ["W72", "W99", "W221", "W225"] },
      "aggregate": { "tokens_held": 18452310.42, "sol_invested": 21.7 }
    }
  ]
}

Field	Meaning
holders.wallet_count	How many tracked wallets currently hold the token.
holders.wallets	Their aliases.
aggregate.tokens_held	Total still held across those wallets.
aggregate.sol_invested	Total SOL those wallets spent buying it.