Skip to main content

positions api

get positions

GET /user/positions
returns all token positions across all wallets.
{
  "positions": [
    {
      "wallet_address": "ABC...",
      "wallet_type": "dev",
      "token_mint": "XYZ...pump",
      "token_name": "...",
      "token_symbol": "...",
      "balance": 1000000,
      "current_value_sol": 0.5,
      "cost_basis_sol": 0.3,
      "unrealized_pl_sol": 0.2,
      "price_usd": 0.00008,
      "market_cap_usd": 8000
    }
  ]
}
fieldwhat
wallet_addresswallet holding tokens
wallet_typedev, bundle, snipe, etc
token_mintmint address
balanceraw token balance
current_value_solcurrent sol value
cost_basis_soltotal sol spent
unrealized_pl_solunrealized p&l
price_usdcurrent price in usd
market_cap_usdmarket cap in usd

trade history

GET /user/trade-history
returns all trades with timestamps, amounts, and signatures.

token info

GET /token/:mint
returns token metadata, price, market cap, and holder info.

ohlcv candles

GET /token/:mint/ohlcv/:timeframe
returns ohlcv candle data for charting.
timeframewhat
1m1 minute candles
5m5 minute candles
15m15 minute candles
1h1 hour candles
4h4 hour candles
1d1 day candles

search tokens

GET /search?q=<query>
search tokens by name, symbol, or mint address.