5 Star API

Authentication

All endpoints except GET /v1/health require an API key passed as a Bearer token.

Authorization: Bearer j5s_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Example

curl https://api.join5star.xyz/v1/me \
  -H "Authorization: Bearer j5s_your_key_here"

Errors

All errors return a consistent shape:

{
  "error": {
    "code":    "rate_limited",
    "message": "Too many requests. Retry after 30s.",
    "retryAfter": 30
  }
}

Rate Limits

When rate limited, the response includes a Retry-After header with seconds to wait.

Data Freshness

Check if the API is online. Use this to verify connectivity before making authenticated requests.

Response

{
  "ok":      true,
  "version": "1.1.0",
  "time":    1791916786866
}

Returns your API key details, plan, scopes, and today's usage.

Example

curl https://api.join5star.xyz/v1/me \
  -H "Authorization: Bearer j5s_your_key"

Response

{
  "customer_id":    "cust_xxx",
  "plan":           "pro",
  "scopes":         ["wallet:read", "token:read", "leaderboard:read"],
  "key": {
    "id":               "key_xxxx",
    "rate_limit_per_min": 200,
    "daily_quota":       100000
  },
  "usage_today":    42,
  "quota_remaining": 99958
}

Returns PnL, rank, trade stats, and identity (pump.fun username, X handle) for a wallet. Add ?include=pnl for daily PnL history, or ?include=enrich for X follower data.

Parameters

Example

# Basic wallet lookup
curl https://api.join5star.xyz/v1/wallet/6ATnpbwa43DtscAWjiR3uh5bEfpc4mhFpF42F5a5f68T \
  -H "Authorization: Bearer j5s_your_key"

# With PnL history and X enrichment
curl "https://api.join5star.xyz/v1/wallet/6ATnpbwa43DtscAWjiR3uh5bEfpc4mhFpF42F5a5f68T?include=pnl,enrich" \
  -H "Authorization: Bearer j5s_your_key"

Response

{
  "address":      "6ATnpbwa43DtscAWjiR3uh5bEfpc4mhFpF42F5a5f68T",
  "rank":         1,
  "pnl_usd":      37103.87,
  "win_rate":     0.72,
  "trades":       214,
  "pump_username": "pumphandle",
  "x_username":   "traderxyz",
  "x_followers":  4200,
  "updated_at":   1791900000000,
  // present when ?include=pnl
  "pnl_history": [
    { "day": "2026-10-13", "pnl_board": 37103.87, "pnl_1d": 2100.00, "pnl_7d": 8400.00 }
  ]
}

Token metadata and trade summary — name, creator, graduation status, volume, and unique trader count.

Parameters

Example

curl https://api.join5star.xyz/v1/token/ztkLqdndQbgxLD9hJjxRnq2NvjhPihrHscYqowkpump/stats \
  -H "Authorization: Bearer j5s_your_key"

Response

{
  "mint":           "ztkLqdndQbgxLD9hJjxRnq2NvjhPihrHscYqowkpump",
  "name":           "My Token",
  "symbol":         "MTK",
  "creator":        "walletAddress...",
  "created_at":     1791800000000,
  "graduated_at":   null,
  "image_uri":      "https://...",
  "twitter_handle": "@handle",
  "trade_count":    42,
  "buy_count":      28,
  "sell_count":     14,
  "total_volume_sol": 12.5,
  "unique_traders": 18
}

Wallets with the most volume on a given token, with their profile data. Use this to see which tracked traders are active on a token.

Parameters

Example

curl "https://api.join5star.xyz/v1/token/ztkLqdndQbgx.../top-traders?limit=5" \
  -H "Authorization: Bearer j5s_your_key"

Response

[
  {
    "wallet":      "walletAddress...",
    "total_sol":   5.2,
    "buys":        3,
    "sells":       2,
    "rank":        4,
    "x_username":  "traderxyz",
    "pump_username": "pumphandle"
  }
]

The earliest wallets to buy a token in our database — ranked by trade timestamp. Useful for identifying early callers and insider wallets.

Parameters

Example

curl "https://api.join5star.xyz/v1/token/ztkLqdndQbgx.../first-buyers?limit=10" \
  -H "Authorization: Bearer j5s_your_key"

Response

[
  {
    "wallet":       "walletAddress...",
    "sol_amount":   0.5,
    "mc_at_trade":  12000,
    "ts":           1791800000000,
    "rank":         1,
    "x_username":   null
  }
]

Current pump.fun PnL leaderboard — top 100 wallets ranked by total PnL with win rates and social handles.

Parameters

Example

curl "https://api.join5star.xyz/v1/top-performers?limit=10&sort=pnl_usd" \
  -H "Authorization: Bearer j5s_your_key"

Response

[
  {
    "address":       "walletAddr...",
    "rank":          1,
    "pnl_usd":       154072.62,
    "win_rate":      0.81,
    "trades":        412,
    "x_username":    "toptrader",
    "x_followers":   12000,
    "pump_username": "pumptop",
    "updated_at":    1791900000000
  }
]

Given a wallet address, returns the linked pump.fun username, X (Twitter) handle, and follower count.

Parameters

Example

curl "https://api.join5star.xyz/v1/enrich?wallet=6ATnpbwa43DtscAWjiR3uh5bEfpc4mhFpF42F5a5f68T" \
  -H "Authorization: Bearer j5s_your_key"

Response

{
  "wallet":        "6ATnpbwa43DtscAWjiR3uh5bEfpc4mhFpF42F5a5f68T",
  "pump_username": "pumphandle",
  "x_username":   "xhandle",
  "x_followers":  5400,
  "x_verified":   false,
  "source":       "pumpfun"
}

Returns your saved watchlist of wallets.

Example

curl https://api.join5star.xyz/v1/tracked-wallets \
  -H "Authorization: Bearer j5s_your_key"

Response

[
  {
    "wallet":   "walletAddr...",
    "label":    "Alpha Whale",
    "added_at": 1791800000000
  }
]

Add a wallet to your watchlist with an optional label.

Body

{
  "wallet": "walletAddress...",
  "label":  "Alpha Whale"
}

Example

curl -X POST https://api.join5star.xyz/v1/tracked-wallets \
  -H "Authorization: Bearer j5s_your_key" \
  -H "Content-Type: application/json" \
  -d '{"wallet":"walletAddr...","label":"Alpha Whale"}'

Response

// HTTP 201
{ "ok": true }