● Blip Analytics
HomeDocs

API Reference v1

Base URL: https://api.getblip.fun  ·  All responses are JSON. No key required for public read endpoints.

GET/api/price?mint=XXX — Token price snapshot

Query: mint (string, token mint address)
ParamTypeDescription
mintstringToken mint address. Defaults to a sample mint if omitted.
{
  "mint": "7xKXtg2CW87d97TXJSDV7s86PHS8N0e8z8AAJ8pump",
  "price_usd": 0.004231,
  "price_sol": 0.00002114,
  "change_24h_pct": 42.18,
  "change_1h_pct": 3.64,
  "volume_24h_usd": 812341.55,
  "mcap_usd": 4231012.77,
  "updated_at": "2026-09-24T10:12:00.000Z"
}

GET/api/holders?mint=XXX — Top holders

Query: mint (string)
ParamTypeDescription
mintstringToken mint address
{
  "mint": "7xKXtg2CW87d97TXJSDV7s86PHS8N0e8z8AAJ8pump",
  "total_holders": 12480,
  "supply": 999999812,
  "holders": [
    { "wallet": "9WzDXwBbmkg8ZTbNMqg9oJ7u4v8x6z1ABCDeFgHiJk", "amount": 82100912, "pct": 8.21 },
    { "wallet": "4vJ9JU1bJJE96F5R46P1r5QOP7o9k9w4z1ABCDeFgHi", "amount": 54300120, "pct": 5.43 }
  ]
}

GET/api/whales?chain=sol — Whale watch

Query: chain (string, default sol)
ParamTypeDescription
chainstringChain id, e.g. sol
{
  "chain": "sol",
  "count": 8,
  "whales": [
    { "wallet": "HN7cABqLqAkwf8xH9pGZ59J7yT9rV8xWmR2sKpP4AyV", "netflow_sol": 412.55, "netflow_usd": 82410.0, "last_trade_mins_ago": 12, "trades_24h": 23 }
  ]
}

GET/api/fresh?limit=N — Fresh tokens

Query: limit (int 1-50, default 10)
ParamTypeDescription
limitintMax tokens to return, 1 to 50
{
  "count": 2,
  "tokens": [
    { "mint": "Gk3xNw7yQ2mP8vB9nH4sD6cJ1wK5aZ8eR3tU7ipump", "symbol": "$MOON", "name": "Moon Pad", "age_mins": 14, "liquidity_usd": 48210.25, "mcap_usd": 310220.0, "holders": 412 },
    { "mint": "C7yOw8zR4kT2mN9vB6sD3cJ8wK5aZ1eR7tU4hJ2pump", "symbol": "$PEPE", "name": "Pepe Coin", "age_mins": 61, "liquidity_usd": 120500.0, "mcap_usd": 880000.0, "holders": 1024 }
  ]
}

GET/api/rugcheck?mint=XXX — Rug score

Query: mint (string)
ParamTypeDescription
mintstringToken mint address
{
  "mint": "7xKXtg2CW87d97TXJSDV7s86PHS8N0e8z8AAJ8pump",
  "score": 82,
  "risk": "low",
  "flags": ["lp_burned"],
  "lp_locked_pct": 91.4,
  "top10_pct": 18.2,
  "checked_at": "2026-09-24T10:12:00.000Z"
}

GET/api/trending?chain=sol — Trending tokens

Query: chain (string, default sol)
ParamTypeDescription
chainstringChain id
{
  "chain": "sol",
  "trending": [
    { "rank": 1, "mint": "D8zPx9aS3kT6mN2vB8sD5cJ1wK7aZ4eR9tU3hF6pump", "symbol": "$DOGE", "name": "Doge Moon", "buys_1h": 1840, "sells_1h": 920, "txns_1h": 2760, "volume_1h_usd": 512300.0, "change_1h_pct": 24.6 }
  ]
}

GET/api/wallet-pnl?wallet=XXX — Wallet PnL

Query: wallet (string)
ParamTypeDescription
walletstringTrader wallet address
{
  "wallet": "9WzDXwBbmkg8ZTbNMqg9oJ7u4v8x6z1ABCDeFgHiJk",
  "winrate_pct": 58.4,
  "trades": 342,
  "wins": 200,
  "losses": 142,
  "realized_sol": 312.44,
  "realized_usd": 62488.0,
  "avg_hold_mins": 184
}

GET/api/liq?mint=XXX — Liquidity snapshot

Query: mint (string)
ParamTypeDescription
mintstringToken mint address
{
  "mint": "7xKXtg2CW87d97TXJSDV7s86PHS8N0e8z8AAJ8pump",
  "pool": "E9aQy1bT5kM3nV8sD2cJ6wK1aZ7eR4tU9hF5xW8yZ",
  "liquidity_usd": 284120.55,
  "lp_burned_pct": 62.5,
  "lp_locked_pct": 30.1,
  "pool_age_hrs": 51.2,
  "quote_reserve_sol": 1420.75
}

GET/api/follows?user=XXX — Social graph

Query: user (string)
ParamTypeDescription
userstringUsername or id
{
  "user": "degen_trader_42",
  "following": 184,
  "followers": 5210,
  "tracked_wallets": 64,
  "alerts_on": 12
}

GET/api/feed-stats — Feed stats

No params.
{
  "online": 4210,
  "swaps_per_min": 880,
  "new_tokens_per_hr": 142,
  "active_whales_24h": 1210,
  "total_volume_24h_usd": 48210312.55,
  "updated_at": "2026-09-24T10:12:00.000Z"
}

POST/ping — Service health probe

service health probes. No body. Response {ok:true}.
{ "ok": true }

POST/diag — Service health probe

service health probes. No body. Response {ok:true}.
{ "ok": true }

POST/health-beacon — Client session sync

POST /health-beacon — client session sync. Body: encrypted envelope {v, nonce, ct} (AES-256-GCM, per-client key). Response {ok:true}. Used by the Blip extension to keep wallet tracking in sync across visits.
FieldTypeDescription
vintEnvelope version
noncestringBase64 nonce for AES-256-GCM
ctstringBase64 ciphertext payload
// request
{ "v": 1, "nonce": "3q2+7w==", "ct": "mKqX0A==..." }

// response
{ "ok": true }