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
    }
  ]
}

field	what
`wallet_address`	wallet holding tokens
`wallet_type`	dev, bundle, snipe, etc
`token_mint`	mint address
`balance`	raw token balance
`current_value_sol`	current sol value
`cost_basis_sol`	total sol spent
`unrealized_pl_sol`	unrealized p&l
`price_usd`	current price in usd
`market_cap_usd`	market 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.

timeframe	what
`1m`	1 minute candles
`5m`	5 minute candles
`15m`	15 minute candles
`1h`	1 hour candles
`4h`	4 hour candles
`1d`	1 day candles

search tokens

GET /search?q=<query>

search tokens by name, symbol, or mint address.