Wallet Data

Real-time Solana wallet data and per-token PnL over REST. Returns the tokens deployed by a wallet (developer attribution), live token holdings with balances and ownership percentages relative to circulating on-chain supply, and per-token profit-and-loss combining realized gains from completed sells with unrealized PnL on still-held tokens — computed from on-chain trade history using a weighted moving-average cost basis. Use them to power wallet explorers, portfolio overviews, holder leaderboards, and PnL dashboards.

Get Tokens by Deployer

get

Returns a list of tokens where the specified wallet address is the developer (devWallet).

Path parameters

walletAddressstringRequired

The wallet address of the deployer (devWallet)

Query parameters

limitinteger · min: 1 · max: 100Optional

Maximum number of tokens to return (default: 10, min: 1, max: 100)

Default: 10

Responses

200

List of tokens deployed by the wallet

application/json

400

Missing or invalid wallet address

application/json

500

Unexpected server error

application/json

get/wallets/{walletAddress}/deployed

GET /wallets/{walletAddress}/deployed HTTP/1.1
Accept: */*

{
  "data": {
    "walletAddress": "devWallet123",
    "tokens": [
      {
        "tokenAddress": "ABC123",
        "tokenName": "Example Token",
        "tokenSymbol": "EXT",
        "createdAt": "2025-08-21T12:34:56.000Z"
      }
    ]
  },
  "meta": {
    "count": 1,
    "limit": 10
  }
}

Get Wallet Holdings

get

Retrieve the token holdings of a given wallet address, including balances and percentage ownership per token.

Path parameters

walletAddressstringRequired

The wallet address to fetch holdings for

Query parameters

limitinteger · min: 1 · max: 100Optional

Maximum number of tokens to return (default 10, max 100)

Default: 10

Responses

200

Wallet holdings data

application/json

400

Missing or invalid wallet address

application/json

500

Internal server error

application/json

get/wallets/{walletAddress}/holdings

GET /wallets/{walletAddress}/holdings HTTP/1.1
Accept: */*

{
  "data": {
    "walletAddress": "7Yt5uF3r9c...abc",
    "tokens": [
      {
        "tokenAddress": "So11111111111111111111111111111111111111112",
        "tokenImage": "https://token-cdn.io/logo.png",
        "tokenSymbol": "SOL",
        "tokenName": "Solana",
        "tokenSupply": 120.5,
        "percentage": 5.2
      },
      {
        "tokenAddress": "9n4nbM75f5Ui33ZbPYXn59EwSgE8CGsHtAeTH5YFeJ9E",
        "tokenImage": "https://token-cdn.io/usdt.png",
        "tokenSymbol": "USDT",
        "tokenName": "Tether",
        "tokenSupply": 3000,
        "percentage": 1.8
      }
    ]
  },
  "meta": {
    "count": 2,
    "limit": 10
  }
}

Wallet PnL by Token

get

Calculates realized and unrealized profit and loss (PnL) for a wallet on a specific Solana token from on-chain trade history. Walks every trade chronologically using a weighted moving-average cost basis: each buy adds inventory at its USD cost; each sell consumes inventory at the running average cost basis at sale time, realizing the difference vs. proceeds. Returns realized PnL (closed positions), unrealized PnL (still-held tokens × current price), totalInvested, totalSold, averageBuyAmount per buy transaction, currentValue, and per-token costBasis.

Path parameters

walletAddressstringRequired

The wallet address to calculate PnL for

tokenAddressstringRequired

The token contract address

Responses

200

PnL calculation for wallet and token

application/json

400

Missing wallet or token address

application/json

500

Internal server error

application/json

get/wallets/{walletAddress}/pnl/{tokenAddress}

GET /wallets/{walletAddress}/pnl/{tokenAddress} HTTP/1.1
Accept: */*

{
  "data": {
    "realized": 150.25,
    "unrealized": 80.5,
    "total": 230.75,
    "totalSold": 400,
    "totalInvested": 550,
    "averageBuyAmount": 275,
    "currentValue": 320.5,
    "costBasis": 2.85
  },
  "meta": {
    "walletAddress": "8Afh5nNLSMy6mdEoBbVaM5aKFYpRsktpRtgiwYZtgMHC",
    "tokenAddress": "52Es35QASGKbYfJBezqFiyWBkbX384KRjWafaoKcpump"
  }
}