Wallet Data

Wallet endpoints include deployed tokens by a dev wallet and wallet holdings with balances and ownership percentages—enough to power lightweight explorers and portfolio overviews.

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

HTTPcURLJavaScriptPython

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

HTTPcURLJavaScriptPython

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

Calculate realized and unrealized profit and loss (PnL) for a wallet on a specific token.

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}

HTTPcURLJavaScriptPython

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