Wallet Data by Address

Wallet transactions. A wallet's AMM legs across all tokens and mains, newest first in chain order, attributed to the wallet behind the trade (a hub-loan exit is listed under the borrower); the hop leg of a routed trade is left out unless `legs=all`. Protocol legs are never listed. `nextCursor` is opaque. `amountUSDC` is deprecated (use amountQuote + quoteAsset + quoteDecimals) and so is `price` (raw pair units; use priceE18). Sends X-Deprecated-Fields: amountUSDC, price; each row carries usdSource. Legs on invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Wallet portfolio in USD. Spot holdings of BASIS tokens (each priced through its own main and that main's pair-asset USD source), one balance per pair asset, each main's vault stake net of its loan (a position, not a token balance), open hub and leverage loans net of debt; listed apart and not in the totals: unvested tokens (`vesting`), prediction shares valued at the stored odds (`predictions`) and open Up/Down stakes (`updown`). One chain read: a balanceOf multicall over the tokens and pair assets. Prices are the latest synced trade (Sync rows); vault positions, loans, vesting, market positions and odds and Up/Down bets come from the database. Each holding carries its cost basis and realized P&L from the spot ledger of GET /api/v1/wallet/{address}/pnl: bought tokens only, after fees (costBasis lists every token in that ledger). Every *UsdE18 field is USD × 1e18 as a decimal string, null when unknown: a token with no price has no value, never $1; an unknown line is left out of totalUsdE18 and counted in unpriced. totalUSD covers spot only; totalUsdE18 is all lines. 503 { error, feature: "trading" } on a network with no deployment. holdings[].balance is whole tokens as an exact decimal string (was a float); balanceWei is the raw amount with `decimals`. Removed on 2026-10-09 (chain reads, see the SDK): what can be claimed now (vesting claimable / effectiveTotal, prediction redeem payouts, Up/Down claimable payouts, holder rewards, vault rewards: the whole `claimables` block) and vaults[].earned / collateralWei. Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Loans (me). Alias of /api/v1/wallet/{address}/loans for the authenticated wallet. Loans of a wallet, offset paged.

Loan events (me). Alias of /api/v1/wallet/{address}/loans/events for the authenticated wallet. Loan events of a wallet, cursor paged, newest first.

Vault events (me). Alias of /api/v1/wallet/{address}/vault/events for the authenticated wallet. Vault events of a wallet, cursor paged.

Vault position (me). Alias of /api/v1/wallet/{address}/vault for the authenticated wallet. A wallet's vault stake, pledge and loan, one row per main (one vault serves every main; ?main= filters). Database only, no chain read. Removed on 2026-10-09 (read them on chain): earned (STAKING.earned), freeToUnstake and the deprecated free (STAKING.freeToUnstake), stakeUsdE18 / valueUsdE18 (current price).

Vesting events (me). Alias of /api/v1/wallet/{address}/vesting/events for the authenticated wallet. Vesting events, cursor paged. `vestingContract` defaults to every contract (the deployment's only when `vestingId` is given).

Wallet summary (me). Alias of /api/v1/wallet/{address}/summary for the authenticated wallet. Counts and totals of a wallet.

Wallet projects (me). Alias of /api/v1/wallet/{address}/projects for the authenticated wallet. Tokens and markets a wallet created; each list offset paged. markets[].endTime is unix seconds (null until indexed). Database only, no chain read: totalSupply is the sum of the indexed balances (as on GET /api/v1/tokens/{address}), frozen and presaleComplete are folded on the token's registry row. Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

My referrals. The same `onchain` block as GET /api/v1/wallet/{address}/referrals, plus the top-level referral fields (who referred you, and the wallets you referred at level 1 and 2, from the on-chain graph; joinedAt = the ReferrerSet block time). Points were removed at the relaunch, so no tier, rank or points fields are returned. Redirected referral payouts are kept apart from the earnings: when the referrer cannot receive the pair asset, TAXES sends the payout to the protocol instead (PayoutRedirected); it is not earned and never in `earnings`. `onchain.redirected` (per pair asset, raw + USD at the event), `onchain.redirectedTotal`, and `onchain.redirects` (the newest 100 records of the window; `redirectsTruncated`; every record is also a `referral_redirected` row of GET /api/v1/wallet/{address}/activity?types=referral). Privacy: wallet addresses remain available, but attached username/avatar fields are null. Named social browsing uses username profiles, without raw wallets.

Fees paid (me). Alias of /api/v1/wallet/{address}/fees for the authenticated wallet. Fees the wallet paid, per pair asset and category.

Creator earnings (me). Alias of /api/v1/wallet/{address}/earnings for the authenticated wallet. Creator payouts and holder rewards of a wallet. Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

A wallet's market positions, any wallet (MK-8). Every market the wallet created, bet, traded, listed or redeemed in, latest activity first (created-only markets last). `shares` per outcome come from the PredictionPosition fold of the stored rows (seed, bets, book fills, redeems; `sharesSource` index), or live (READER.getAllUserShares, `sharesSource` live) for a market the fold has not reached yet; they include sharesInOrders. `resolved` is the folded Market column. `cost` / `costUsdE18` are every buy (bets, book buys, the creator's seed split seed / n, dust to outcome 0); `costBasis` / `costBasisUsdE18` are the fold's average cost of the shares still held; `costComplete` is false when a buy's pair value was unknown, so costBasis leaves that buy out (the field and meaning of GET /api/v1/markets/{address}/holders). The creator's seed carries its USD at the seed block (Market.seedUsdE18), split into costUsdE18 the same way. Database only, except shares of a market the fold has not reached yet. What a resolved market still pays out is a chain read (removed on 2026-10-09): TRANCHE_READER.quoteRedeemUSDB(host, market, user) + REDEMPTION_READER.quoteRedemption(market, tokenPayout), then HOST.redeem(market, fractionBps, slices, minOut). Paged in the database, latest activity first (a market the wallet only created, with no dated activity, sorts last). The indexed `status` is derived from the folded resolution and the resolver's time windows: ?status= filters the wallet's whole history (the stored part in the database, the open markets' phases computed for every candidate), so paging and `pagination.total` are exact. Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Fees paid. Fees the wallet paid, per pair asset and category. Alias: /api/v1/me/fees (the authenticated wallet).

Referrals. On-chain referral tree and earnings of a wallet. The `points` counts (hasReferrer, directCount, indirectCount) are read from the same on-chain graph. Redirected referral payouts are kept apart from the earnings: when the referrer cannot receive the pair asset, TAXES sends the payout to the protocol instead (PayoutRedirected); it is not earned and never in `earnings`. `onchain.redirected` (per pair asset, raw + USD at the event), `onchain.redirectedTotal`, and `onchain.redirects` (the newest 100 records of the window; `redirectsTruncated`; every record is also a `referral_redirected` row of GET /api/v1/wallet/{address}/activity?types=referral).

Creator earnings. Creator payouts and holder rewards of a wallet. Alias: /api/v1/me/earnings (the authenticated wallet). Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Loans. Loans of a wallet, offset paged. Alias: /api/v1/loans (the authenticated wallet).

Loan events. Loan events of a wallet, cursor paged, newest first. Alias: /api/v1/loans/events (the authenticated wallet).

Vaults. One row per live main. Since the next deploy ONE vault serves every main (every row names the same `vault`); each main has its own pool: stake, pledges, rewards, yield and APR are per main. minStake and pools(main) are one multicall, shared for 15 s.

Vault position. A wallet's vault stake, pledge and loan, one row per main (one vault serves every main; ?main= filters). Database only, no chain read. Alias: /api/v1/vault/position (the authenticated wallet). Removed on 2026-10-09 (read them on chain): earned (STAKING.earned), freeToUnstake and the deprecated free (STAKING.freeToUnstake), stakeUsdE18 / valueUsdE18 (current price).

Vault events. Vault events of a wallet, cursor paged. Alias: /api/v1/vault/events (the authenticated wallet).

Vesting events. Vesting events, cursor paged. `vestingContract` defaults to every contract (the deployment's only when `vestingId` is given). Alias: /api/v1/vesting/events (the authenticated wallet).

Wallet activity. Every kind of activity of a wallet in one cursor-paged feed, newest first: ONE keyset query over every table, so a page is exact and an older row is never dropped (it is on a later page). A book fill is listed once (type `book_fill`; MarketBookFill carries buyer and seller); MarketEvent `order_filled` rows are not returned as type `market`. `fee` = fees the wallet paid (FeePaid; the payer, or the wallet behind a relay payer), `referral` = its referrer link (referrer_set), referral payouts it received (referral_paid) and referral payouts it could not receive, sent to the protocol instead (referral_redirected, not earned), `creator_payout` = creator fees it received, `reward_claim` = holder rewards it claimed, `transfer` = wallet-to-wallet token transfers (action `sent` | `received`; the other side is neither the zero address nor a BASIS contract), `create` = tokens and markets the wallet created (action `token_created` | `market_created`; a market names its seed in `amounts` and its USD). Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Transaction. What the index holds for one transaction. Rows are ActivityRow (plus types fee, liquidation). A book fill is listed once (type `book_fill`; MarketBookFill carries buyer and seller); MarketEvent `order_filled` rows are not returned as type `market`. Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Wallet summary. Counts and totals of a wallet. Alias: /api/v1/me/stats (the authenticated wallet). `marketsCreated` leaves out invite-only markets the caller may not see (GET /api/v1/markets explains the rule); the wallet's own view counts them all.

Wallet projects. Tokens and markets a wallet created; each list offset paged. Alias: /api/v1/me/projects (the authenticated wallet). markets[].endTime is unix seconds (null until indexed). Database only, no chain read: totalSupply is the sum of the indexed balances (as on GET /api/v1/tokens/{address}), frozen and presaleComplete are folded on the token's registry row. Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Wallet roles. Whitelists and private-market roles of a wallet. `whitelists`: the frozen-token whitelists that hold it now (the folded whitelist), newest first. `privateMarkets`: its voter and buyer roles, from the newest MarketVoterSet / PrivateBuyerSet per (market, role) over its whole history, active roles only, latest change first. Each list holds at most 1000 rows: `whitelistsTotal` / `privateMarketsTotal` count every row and `whitelistsTruncated` / `privateMarketsTruncated` say a list was cut. Invite-only markets the caller may not see are left out, totals included (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Wallet followers. The wallets that follow this one on BASIS (the profile social graph), newest follow first, offset paged with a total. Read only: follow and unfollow happen in the dapp. The counts are on GET /api/v1/profile/{wallet}. Privacy: wallet addresses remain available, but attached username/avatar fields are null. Named social browsing uses username profiles, without raw wallets.

Wallets followed. The wallets this one follows on BASIS (the profile social graph), newest follow first, offset paged with a total. Read only: follow and unfollow happen in the dapp. The counts are on GET /api/v1/profile/{wallet}. Privacy: wallet addresses remain available, but attached username/avatar fields are null. Named social browsing uses username profiles, without raw wallets.

Wallet P&L. P&L of a wallet after fees from the profile P&L engine (cached 60 s), counting BOUGHT tokens only: the sum of three parts, each also served on its own. spot: the indexed BASIS spot trades (ASwap trades and their pool legs, a main bought directly with another token); a swap's cost is what the wallet paid and its proceeds what it received, in USD at the time, so the fees it paid are inside; open positions at the latest stored price x the bought quantity still held (no sell fee, no price impact, no chain read). Bought tokens only: tokens received (a vesting someone made for the wallet, a plain transfer in, a vault reward: anything that is not a trade) are kept apart and never counted; a sale is split pro rata between the bought and the received tokens in the wallet (locked vesting and hub collateral are left out) and only the bought part counts (its cost and its share of the proceeds); tokens given away (a transfer out, a vesting made for someone else, tokens spent on a bet) take their share of the cost out without realizing anything. Received or given tokens never make a wallet incomplete. predictions: per market, bets, book buys and the creator's seed are costs, book sales and redeems are proceeds (USD at the time); open shares at the stored odds x the market token's stored price; once a winner-take-all market is resolved its losing shares close at 0; the shares a wallet still holds on a resolved (or invalidated) market are valued at what a redeem pays it now (chain read: TrancheReader.quoteRedeemUSDB), else at the payout per share the market's redeems show, else at the last odds (counted in estimated). updown: per round, the stake (USD at bet time) against payouts and refunds (USD at the claim); a lost stake is realized at the settlement; open bets and unclaimed wins are held at cost. week / month = rolling 7 / 30 days, marked to market at the window start: a position held then starts the window at its value then; the P&L is what was realized in the window plus the change in value (tokens given away in the window take their start value out, no loss). feesUsdE18 counts the fees of every item, withheld ones included. Unknown cost or USD is withheld, never counted as 0 or as profit: an item whose history or price is missing is left out of the totals and counted in missingItems; totalUsdE18 is then null and the priced* fields sum the counted items. It excludes loans, leverage and vault yield: none of them is in any total or part. For a leverage position's result use GET /api/v1/wallet/{address}/loans: levCashIn, levCashOut and levCollateralOut (its lifetime cash flows; P&L = levCashOut + levCollateralOut + the net of a full close now - levCashIn). The same engine ranks GET /api/v1/stats/leaderboard?metric=pnl. Invite-only markets the caller may not see are left out (GET /api/v1/markets explains the rule); a wallet's own rows always show to that wallet.

Vault history. The vault's stake flows and yield over time for one main, from the stored events (Staked, Unstaked, RewardsCompounded, RewardsClaimed, LiquidationProcessed, YieldInjected, YieldToOwner); no chain read. A bucket is listed only when something happened in it; totalStaked / totalYieldMainAdded are running totals over all stored history at the end of the bucket.