GET
token information
/tokens/{mint}
Normalized token identity, verified status, official links, market data, venues, supply, and update time.
mint · token contract address
pumpfast public api · v1
build token discovery into anything.
Read PumpFast token metadata, market snapshots, confirmed-USDC rankings, and weekly results from any server or browser app. No API key is required.
quick start
one URL. plain JSON.
- Anonymous read access
- CORS enabled for every browser origin
- Leaderboard and token responses cached for at least 60 seconds
- Stable, versioned response envelopes
- Request IDs and server timing on every response
- Wallet boost and X upvote verification
- Embeddable leaderboard and token widgets
curl "https://pumpfa.st/api/v1/leaderboards/global?limit=10"const first = await fetch(
"https://pumpfa.st/api/v1/leaderboards/weekly?week=0&limit=10"
).then((response) => response.json());
const next = first.pagination.nextCursor
? await fetch(
"https://pumpfa.st/api/v1/leaderboards/weekly?week=0&limit=10&cursor=" +
encodeURIComponent(first.pagination.nextCursor)
).then((response) => response.json())
: null;endpoints
read the discovery layer.
GET
token image
/tokens/{mint}/image
A validated, cached image response that avoids relying on an upstream IPFS gateway in your app.
mint · token contract address
GET
wallet boost check
/tokens/{mint}/boosts/{wallet}
Check confirmed boost status, count, cumulative USDC, timestamps, and the latest transaction signature for one wallet and token.
mint · token contract address | wallet · wallet address
GET
X upvote check
/tokens/{mint}/upvotes/{xUserId}
Check whether a stable numeric X account ID upvoted a token in the current or a previous PumpFast week.
mint · token contract address | xUserId · numeric X ID | week · 0 is current
GET
global leaderboard
/leaderboards/global
Tokens ranked by cumulative confirmed USDC boosts, including supporters, weekly votes, and tracked clicks.
limit · 1–100 | cursor · previous nextCursor | offset · legacy
GET
weekly leaderboard
/leaderboards/weekly
Current or historical weekly results with the exact period, revenue, reward pool, upvotes, and token rankings.
week · 0 is current | limit · 1–100 | cursor · previous nextCursor
token response
normalized metadata + markets
{
"apiVersion": "1",
"data": {
"mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"name": "Bonk",
"symbol": "Bonk",
"isVerified": true,
"imageProxyUrl": "https://pumpfa.st/api/v1/tokens/DezXAZ...pPB263/image",
"priceUsd": 0.00001234,
"marketCap": 1080000000,
"volume24h": 24500000,
"liquidityUsd": 13200000,
"venues": ["Orca", "Raydium", "Jupiter"],
"updatedAt": "2026-09-03T12:00:00.000Z"
}
}leaderboard response
ranking + pagination
{
"apiVersion": "1",
"data": [
{
"rank": 1,
"mint": "...",
"name": "Example Token",
"symbol": "EXAMPLE",
"totalPaid": 250,
"supporters": 8,
"weeklyUpvotes": 34,
"clicks": 120
}
],
"pagination": {
"limit": 25,
"offset": 0,
"total": 42,
"hasMore": true,
"nextCursor": "eyJ2ZXJzaW9uIjoxLC4uLn0",
"snapshot": "dG9rZW4tb3JkZXI"
}
}activity checks
verify participation.
Check one token against a wallet or X account. A valid check always returns `200`; inspect `boosted` or `upvoted` for the answer.
- Boost checks count confirmed transactions only.
- Upvote checks use the stable numeric X user ID.
- `week=0` means the current PumpFast week.
request examples
curl "https://pumpfa.st/api/v1/tokens/TOKEN_CA/boosts/WALLET"
curl "https://pumpfa.st/api/v1/tokens/TOKEN_CA/upvotes/X_USER_ID?week=0"widgets
embed discovery anywhere.
Paste an iframe into any website—no API key or JavaScript SDK is required. Widgets refresh every minute, adapt to narrow containers, and open PumpFast actions in a new tab.
01 · global
global leaderboard
Rank tokens by cumulative confirmed USDC boosts. Choose how many entries to show with the limit parameter.
embed code
<iframe
src="https://pumpfa.st/widgets/leaderboard?type=global&limit=3"
title="PumpFast global leaderboard"
width="100%"
height="360"
loading="lazy"
style="border:0"
></iframe>live preview
loading live widget...
02 · weekly
weekly leaderboard
Show this week’s upvote ranking and live reward pool using the same compact leaderboard layout.
embed code
<iframe
src="https://pumpfa.st/widgets/leaderboard?type=weekly&limit=3"
title="PumpFast weekly leaderboard"
width="100%"
height="360"
loading="lazy"
style="border:0"
></iframe>live preview
loading live widget...
03 · token
token spotlight
Replace the address in the path to show a token’s metadata, market data, and PumpFast actions.
embed code
<iframe
src="https://pumpfa.st/widgets/token/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
title="Bonk on PumpFast"
width="100%"
height="430"
loading="lazy"
style="border:0"
></iframe>live preview
loading live widget...
parameters
configure the embed.
| widget | parameter | accepted | default |
|---|---|---|---|
| leaderboard | type | global | weekly | global |
| leaderboard | limit | 1–10 | 5 |
| both | ref | referral code | — |
type — Chooses the all-time USDC board or current weekly board.
limit — Sets the number of ranked tokens shown.
ref — Preserves your referral when a visitor opens PumpFast.
Add `&ref=YOUR_CODE` to a leaderboard URL or `?ref=YOUR_CODE` to a token URL.
dimensions
give the widget room.
- minimum width
- 320 px
- token height
- 430 px
- 5-row board
- 520 px
- 10-row board
- 920 px
Use `width="100%"` so the widget follows its container. Increase the iframe height when you raise the leaderboard limit; iframe contents do not resize the host page automatically.
content security policy
PumpFast allows embedding from any site. If your site has a restrictive CSP, allow PumpFast in its `frame-src` directive.
Content-Security-Policy: frame-src https://pumpfa.st;live data
Token data and leaderboard results refresh every 60 seconds. Loading, empty, and retry states are built in.
referral links
The optional `ref` value follows visitors into PumpFast when they open a token, boost, or upvote action.
analytics
Every iframe load counts as a PumpFast page view. Widget paths identify leaderboard and token traffic, and token-widget trade clicks are recorded with `widget` as their source.
rate limits
Token lookups allow 30 requests per minute per IP. Other public reads allow 120. A `429` response includes `Retry-After`.
response headers
X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-Reset
X-Request-Id
Server-Timing
errors
Errors return a stable code and readable message under the `error` key. Public endpoints never require cookies or wallet authentication. An expired cursor returns `409`; restart from the first page when that happens. Temporary dependency failures return `503` without exposing internal provider details.