---
title: "Get Single Wallet Position"
method: GET
path: "/api/2/wallet/position"
tags: ["V2 - Wallet"]
---

# Get Single Wallet Position

`GET /api/2/wallet/position`

Get position data for a specific wallet and asset. Returns balance, PnL, buy/sell volumes, and token details.

## Query parameters

- `wallet` string, required — Wallet address
- `asset` string, required — Token contract address
- `chainId` string — Blockchain chain ID (e.g., "evm:56", "solana:solana")

## Response `200`

Single wallet position response

- object
  - `data` object, required
    - `token` object, required
      - `address` string, required
      - `chainId` string, required
      - `symbol` string, nullable, required
      - `name` string, nullable, required
      - `decimals` number, nullable
      - `id` number, nullable
      - `priceUSD` number, nullable
      - `priceToken` number, nullable
      - `priceTokenString` string, required
      - `approximateReserveUSD` number, nullable
      - `approximateReserveTokenRaw` string, required
      - `approximateReserveToken` number, nullable
      - `totalSupply` number, nullable
      - `circulatingSupply` number, nullable
      - `marketCapUSD` number, nullable
      - `marketCapDilutedUSD` number, nullable
      - `logo` string, nullable, required
      - `originLogoUrl` string, nullable
      - `rank` number, nullable
      - `cexs` string[]
      - `exchange` object
        - `name` string, required
        - `logo` string, required
      - `factory` string, nullable
      - `source` string, nullable
      - `sourceFactory` string, nullable
      - `sourceMetadata` object, nullable
        - `name` string, required
        - `logo` string, required
      - `sourceFactoryMetadata` object, nullable
        - `name` string, required
        - `logo` string, required
      - `liquidityUSD` number, nullable
      - `liquidityMaxUSD` number, nullable
      - `bonded` boolean
      - `bondingPercentage` number, nullable
      - `bondingCurveAddress` string, nullable
      - `preBondingFactory` string
      - `poolAddress` string
      - `blockchain` string
      - `type` string
      - `tokenType` '2020' | '2022', nullable
      - `deployer` string, nullable
      - `bondedAt` string, nullable, required
      - `athUSD` number, nullable
      - `atlUSD` number, nullable
      - `athDate` string, nullable
      - `atlDate` string, nullable
      - `priceChange1minPercentage` number, nullable
      - `priceChange5minPercentage` number, nullable
      - `priceChange1hPercentage` number, nullable
      - `priceChange4hPercentage` number, nullable
      - `priceChange6hPercentage` number, nullable
      - `priceChange12hPercentage` number, nullable
      - `priceChange24hPercentage` number, nullable
      - `poolPriceChange1minPercentage` number, nullable
      - `poolPriceChange5minPercentage` number, nullable
      - `poolPriceChange1hPercentage` number, nullable
      - `poolPriceChange4hPercentage` number, nullable
      - `poolPriceChange6hPercentage` number, nullable
      - `poolPriceChange12hPercentage` number, nullable
      - `poolPriceChange24hPercentage` number, nullable
      - `liquidityBurnPercentage` number, nullable
      - `volume1minUSD` number, nullable
      - `volume5minUSD` number, nullable
      - `volume15minUSD` number, nullable
      - `volume1hUSD` number, nullable
      - `volume4hUSD` number, nullable
      - `volume6hUSD` number, nullable
      - `volume12hUSD` number, nullable
      - `volume24hUSD` number, nullable
      - `volumeBuy1minUSD` number, nullable
      - `volumeBuy5minUSD` number, nullable
      - `volumeBuy15minUSD` number, nullable
      - `volumeBuy1hUSD` number, nullable
      - `volumeBuy4hUSD` number, nullable
      - `volumeBuy6hUSD` number, nullable
      - `volumeBuy12hUSD` number, nullable
      - `volumeBuy24hUSD` number, nullable
      - `volumeSell1minUSD` number, nullable
      - `volumeSell5minUSD` number, nullable
      - `volumeSell15minUSD` number, nullable
      - `volumeSell1hUSD` number, nullable
      - `volumeSell4hUSD` number, nullable
      - `volumeSell6hUSD` number, nullable
      - `volumeSell12hUSD` number, nullable
      - `volumeSell24hUSD` number, nullable
      - `trades1min` number, nullable
      - `trades5min` number, nullable
      - `trades15min` number, nullable
      - `trades1h` number, nullable
      - `trades4h` number, nullable
      - `trades6h` number, nullable
      - `trades12h` number, nullable
      - `trades24h` number, nullable
      - `buys1min` number, nullable
      - `buys5min` number, nullable
      - `buys15min` number, nullable
      - `buys1h` number, nullable
      - `buys4h` number, nullable
      - `buys6h` number, nullable
      - `buys12h` number, nullable
      - `buys24h` number, nullable
      - `sells1min` number, nullable
      - `sells5min` number, nullable
      - `sells15min` number, nullable
      - `sells1h` number, nullable
      - `sells4h` number, nullable
      - `sells6h` number, nullable
      - `sells12h` number, nullable
      - `sells24h` number, nullable
      - `buyers1min` number, nullable
      - `buyers5min` number, nullable
      - `buyers15min` number, nullable
      - `buyers1h` number, nullable
      - `buyers4h` number, nullable
      - `buyers6h` number, nullable
      - `buyers12h` number, nullable
      - `buyers24h` number, nullable
      - `sellers1min` number, nullable
      - `sellers5min` number, nullable
      - `sellers15min` number, nullable
      - `sellers1h` number, nullable
      - `sellers4h` number, nullable
      - `sellers6h` number, nullable
      - `sellers12h` number, nullable
      - `sellers24h` number, nullable
      - `traders1min` number, nullable
      - `traders5min` number, nullable
      - `traders15min` number, nullable
      - `traders1h` number, nullable
      - `traders4h` number, nullable
      - `traders6h` number, nullable
      - `traders12h` number, nullable
      - `traders24h` number, nullable
      - `feesPaid1minUSD` number, nullable
      - `feesPaid5minUSD` number, nullable
      - `feesPaid15minUSD` number, nullable
      - `feesPaid1hUSD` number, nullable
      - `feesPaid4hUSD` number, nullable
      - `feesPaid6hUSD` number, nullable
      - `feesPaid12hUSD` number, nullable
      - `feesPaid24hUSD` number, nullable
      - `totalFeesPaidUSD` number, nullable
      - `totalFeesPaidNativeRaw` string, nullable
      - `organicTrades1min` number, nullable
      - `organicTrades5min` number, nullable
      - `organicTrades15min` number, nullable
      - `organicTrades1h` number, nullable
      - `organicTrades4h` number, nullable
      - `organicTrades6h` number, nullable
      - `organicTrades12h` number, nullable
      - `organicTrades24h` number, nullable
      - `organicTraders1min` number, nullable
      - `organicTraders5min` number, nullable
      - `organicTraders15min` number, nullable
      - `organicTraders1h` number, nullable
      - `organicTraders4h` number, nullable
      - `organicTraders6h` number, nullable
      - `organicTraders12h` number, nullable
      - `organicTraders24h` number, nullable
      - `organicVolume1minUSD` number, nullable
      - `organicVolume5minUSD` number, nullable
      - `organicVolume15minUSD` number, nullable
      - `organicVolume1hUSD` number, nullable
      - `organicVolume4hUSD` number, nullable
      - `organicVolume6hUSD` number, nullable
      - `organicVolume12hUSD` number, nullable
      - `organicVolume24hUSD` number, nullable
      - `organicVolumeBuy1minUSD` number, nullable
      - `organicVolumeBuy5minUSD` number, nullable
      - `organicVolumeBuy15minUSD` number, nullable
      - `organicVolumeBuy1hUSD` number, nullable
      - `organicVolumeBuy4hUSD` number, nullable
      - `organicVolumeBuy6hUSD` number, nullable
      - `organicVolumeBuy12hUSD` number, nullable
      - `organicVolumeBuy24hUSD` number, nullable
      - `organicVolumeSell1minUSD` number, nullable
      - `organicVolumeSell5minUSD` number, nullable
      - `organicVolumeSell15minUSD` number, nullable
      - `organicVolumeSell1hUSD` number, nullable
      - `organicVolumeSell4hUSD` number, nullable
      - `organicVolumeSell6hUSD` number, nullable
      - `organicVolumeSell12hUSD` number, nullable
      - `organicVolumeSell24hUSD` number, nullable
      - `organicBuys1min` number, nullable
      - `organicBuys5min` number, nullable
      - `organicBuys15min` number, nullable
      - `organicBuys1h` number, nullable
      - `organicBuys4h` number, nullable
      - `organicBuys6h` number, nullable
      - `organicBuys12h` number, nullable
      - `organicBuys24h` number, nullable
      - `organicSells1min` number, nullable
      - `organicSells5min` number, nullable
      - `organicSells15min` number, nullable
      - `organicSells1h` number, nullable
      - `organicSells4h` number, nullable
      - `organicSells6h` number, nullable
      - `organicSells12h` number, nullable
      - `organicSells24h` number, nullable
      - `organicBuyers1min` number, nullable
      - `organicBuyers5min` number, nullable
      - `organicBuyers15min` number, nullable
      - `organicBuyers1h` number, nullable
      - `organicBuyers4h` number, nullable
      - `organicBuyers6h` number, nullable
      - `organicBuyers12h` number, nullable
      - `organicBuyers24h` number, nullable
      - `organicSellers1min` number, nullable
      - `organicSellers5min` number, nullable
      - `organicSellers15min` number, nullable
      - `organicSellers1h` number, nullable
      - `organicSellers4h` number, nullable
      - `organicSellers6h` number, nullable
      - `organicSellers12h` number, nullable
      - `organicSellers24h` number, nullable
      - `createdAt` string, nullable, required
      - `latestTradeDate` string, nullable, required
      - `holdersCount` number, nullable
      - `description` string, nullable, required
      - `socials` object, required
        - `twitter` string, nullable, required
        - `website` string, nullable, required
        - `telegram` string, nullable, required
        - `others` object, nullable, required
        - `uri` string
      - `security` object, nullable, required
        - `buyTax` string, nullable
        - `sellTax` string, nullable
        - `transferPausable` boolean
        - `top10Holders` string
        - `isBlacklisted` boolean
        - `noMintAuthority` boolean
        - `balanceMutable` boolean
        - `lowLiquidity` string
        - `burnRate` string
        - `liquidityBurnPercentage` number
        - `isHoneypot` boolean
        - `isNotOpenSource` boolean
        - `renounced` boolean
        - `locked` string
        - `isWhitelisted` boolean
        - `isMintable` boolean
        - `modifyableTax` boolean
        - `selfDestruct` boolean
      - `twitterReusesCount` number, nullable
      - `twitterRenameCount` number, nullable
      - `twitterRenameHistory` object[]
        - `username` string, required
        - `lastChecked` string, required
      - `deployerMigrationsCount` number, nullable
      - `deployerTokensCount` number, nullable
      - `securityScore` number, nullable
      - `securityScoreUpdatedAt` string, nullable
      - `dexscreenerListed` boolean, nullable
      - `dexscreenerHeader` string, nullable
      - `dexscreenerAdPaid` boolean, nullable
      - `dexscreenerAdPaidDate` string, nullable
      - `dexscreenerPendingAt` string, nullable
      - `dexscreenerSocialPaid` boolean, nullable
      - `dexscreenerSocialPaidDate` string, nullable
      - `liveStatus` string, nullable, required
      - `liveThumbnail` string, nullable, required
      - `livestreamTitle` string, nullable, required
      - `liveReplyCount` number, nullable, required
      - `dexscreenerBoosted` boolean, nullable
      - `dexscreenerBoostedDate` string, nullable
      - `dexscreenerBoostedAmount` number, nullable
      - `isMayhemMode` boolean, nullable
      - `isCashbackCoin` boolean, nullable
      - `isAgentMode` boolean, nullable
      - `isOGCoin` boolean, nullable
      - `top10HoldingsPercentage` number, nullable
      - `top50HoldingsPercentage` number, nullable
      - `top100HoldingsPercentage` number, nullable
      - `top200HoldingsPercentage` number, nullable
      - `devHoldingsPercentage` number, nullable
      - `insidersHoldingsPercentage` number, nullable
      - `bundlersHoldingsPercentage` number, nullable
      - `snipersHoldingsPercentage` number, nullable
      - `proTradersHoldingsPercentage` number, nullable
      - `freshTradersHoldingsPercentage` number, nullable
      - `smartTradersHoldingsPercentage` number, nullable
      - `insidersCount` number, nullable
      - `bundlersCount` number, nullable
      - `snipersCount` number, nullable
      - `freshTradersCount` number, nullable
      - `proTradersCount` number, nullable
      - `smartTradersCount` number, nullable
      - `freshTradersBuys` number, nullable
      - `proTradersBuys` number, nullable
      - `smartTradersBuys` number, nullable
    - `balance` number, required
    - `rawBalance` string, required
    - `amountUSD` number, required
    - `buys` number, required
    - `sells` number, required
    - `volumeBuyToken` number, required
    - `volumeSellToken` number, required
    - `volumeBuy` number, required
    - `volumeSell` number, required
    - `avgBuyPriceUSD` number, required
    - `avgSellPriceUSD` number, required
    - `realizedPnlUSD` number, required
    - `unrealizedPnlUSD` number, required
    - `totalPnlUSD` number, required
    - `totalFeesPaidUSD` number
    - `buyFeesPaidUSD` number
    - `sellFeesPaidUSD` number
    - `firstDate` string, nullable, required
    - `lastDate` string, nullable, required
    - `labels` string[], nullable
  - `wallet` object
    - `fundingInfo` object, nullable
      - `from` string, nullable, required
      - `date` string, nullable, required
      - `chainId` string, nullable, required
      - `txHash` string, nullable, required
      - `amount` string, nullable, required
      - `formattedAmount` number, nullable, required
      - `currency` object, nullable, required
        - `name` string, required
        - `symbol` string, required
        - `logo` string, nullable, required
        - `decimals` number, required
        - `address` string, required
      - `fromWalletLogo` string, nullable, required
      - `fromWalletTag` string, nullable, required
      - `fromWalletMetadata` object, nullable
        - `entityName` string, nullable, required
        - `entityLogo` string, nullable, required
        - `entityLabels` string[], required
        - `entityType` string, nullable, required
        - `entityDescription` string, nullable, required
        - `entityTwitter` string, nullable, required
        - `entityWebsite` string, nullable, required
        - `entityGithub` string, nullable, required
        - `entityDiscord` string, nullable, required
        - `entityTelegram` string, nullable, required
        - `extra` object
    - `entity` string, nullable
    - `labels` string[]

## Other responses

- `402` — Payment Required

---

[API](https://skmtc.net/mobula/apis/mobula-api.md) · [All operations](https://skmtc.net/mobula/apis/mobula-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobula/mobula-api/versions/32f95d9e8ff2/schema)