143), not bridged from another chain. As of November 11, 2026, the xStocks API lists more than 1,500 assets on Monad.
This guide covers what is different about integrating xStocks compared with an ordinary ERC-20:
- Each equity has two tokens: a rebasing base token and a non-rebasing wrapped token.
- Balances of the base token change on dividends and splits without any transfer.
- Balance changes are scheduled on-chain a short time ahead, and the price feeds stop updating on weekends.
xStocks are subject to the issuer’s eligibility and jurisdiction restrictions. For example, they are not offered to U.S. persons. Check the xStocks documentation before offering them in your application.
Choose the right token
Every xStock has a base token (for exampleSPYx) and a wrapped token (wSPYx).
Use the base token for anything a user sees or trades: wallet balances and swap UIs. One
SPYx tracks one share of SPY at the price shown on any market data site.
Use the wrapped token inside any contract that records balances in its own storage: lending markets, vaults, and AMM pools. A contract that caches base-token balances goes out of sync when the multiplier changes. In a Uniswap v2-style pool, for example, the extra tokens from a dividend sit outside the pool’s reserves until someone calls sync() or takes them with skim().
Find token addresses
The xStocks API is the source of truth for addresses. Public endpoints need no API key.page until page.hasNextPage is false.
network=Monad limits the list to assets that have a Monad deployment. It does not trim each asset’s deployments array, which still has an entry for every network the asset is on, such as Solana and BNB Chain. Select the entry with chainId 143 yourself:
addressis the base token.wrapperAddressV2is the wrapped token. A few assets have no wrapper yet, so handle a missing field.stablecoinslists the tokens accepted for issuance and redemption. On Monad this is USDC.
GET /api/v2/public/assets/{SYMBOL}. It returns the deployments on every network.
Before you rely on a wrapper address, call asset() on it and confirm that it returns the base token.
Addresses for the most liquid tickers
Base and wrapped tokens both have 18 decimals.Handle dividends and splits
xStocks do not pay dividends in cash. The issuer reinvests each dividend into more of the underlying, and every holder’s token balance grows to match. Splits and reverse splits rescale balances the same way. The base token implements this with a single multiplier shared by all holders:sharesOf(account)is the internal balance. It changes only on transfer, mint, or burn.balanceOf(account)is the balance in shares of the underlying. It changes whenever the multiplier does.transfer()andapprove()take amounts inbalanceOf()units, as with any ERC-20. The token converts the amount to shares, so the amount that moves can be 1 wei less than requested.- Each transfer emits
Transferwith thebalanceOf()amount andTransferShareswith the internal amount.
Read the multiplier
getCurrentMultiplier() returns three values. The first is the multiplier in effect now, scaled by 1e18. It switches to a scheduled value in the first block at or after the activation time.
Know when the multiplier changes
The issuer schedules each new multiplier in a transaction that sets an activation time. At that time the new value takes effect without a further transaction. Dividend-paying equities change a few times a year. Do not assume a fixed time of day or a long notice period. The xStocks docs give 00:30 UTC on the day after the ex-date as the standard, but past changes have also activated at 23:55 UTC and at other times, including during the trading day. On Monad, the twoSPYx changes in October 2026 were scheduled 3 hours 15 minutes and 30 minutes before they activated.
Watch the token contract
The base token exposes the schedule on-chain.Poll the xStocks API
The API publishes the current multiplier and, according to the xStocks docs, any pending change:newMultiplier and activationDateTime are 0 when no change is scheduled. Past changes are available at /api/v2/public/assets/{SYMBOL}/multiplier/history?network=Monad.
network is a required parameter on both endpoints, but it does not change the result. The multiplier and its history are the same on every network.
Rules for tracking balances
- Take advance notice from
MultiplierScheduledor from the API. Nothing is emitted at the activation time itself, andMultiplierUpdatedarrives late. - Do not reconstruct base-token balances from
Transferevents alone. IndexTransferSharesorsharesOf()amounts and apply the current multiplier, or re-readbalanceOf()after each activation. - Avoid the activation window. xStocks recommends that venues and protocols pause interactions with a token for about 15 minutes before and after its activation time.
Wrap and unwrap
The wrapped token is a standard ERC-4626 vault.assets are base tokens in balanceOf() units. shares are wrapped tokens. Wrapped shares equal the internal (sharesOf()) amount deposited, so convertToAssets(1e18) returns the current multiplier.
Price wrapped tokens with Chainlink
Chainlink publishes USD price feeds on Monad for six wrapped xStocks. Each feed returns the price of one wrapped token, which is the price of the underlying multiplied by the current multiplier. Feeds use the standardAggregatorV3Interface and have 8 decimals.
wSPYx feed published no rounds between Saturday, November 14, 2026 at 00:40 UTC and Monday, November 16 at 01:00 UTC, a gap of 48 hours. A fixed one-hour staleness check on updatedAt therefore reverts all weekend. Decide how borrows and liquidations behave during that gap, when the last price can be far from where the market reopens.
To price a base token, divide the wrapped price by the multiplier. For other oracle providers on Monad, see Oracles.
Trade and source liquidity
Swap through an aggregator
The 1inch token list for Monad includes the base token of all 1,516 xStocks and none of the wrapped tokens (as of November 16, 2026). Quote and swap the base token, and wrap afterwards if your contract needs the wrapped form. Equities do not trade around the clock. Thetrading object on each asset in the xStocks API reports openNow, nextChangeAt, and the order limits for each session in limitsPerPeriod. For SPYx, the maximum order value in the closed session is 0.
Trade on an order book
Kuru runs on-chain order books for five xStocks on Monad mainnet. Each market trades the base token against USDC.
For the remaining contract addresses, market parameters, and fees, see Kuru’s mainnet deployments. To place orders, see the Kuru SDK quickstart.
Integrate xChange directly
Market makers and venues can request the issuer’s quotes from the xChange API. The xChange endpoints return401 without an API key. According to the xStocks docs, you also register your wallet, request a signed quote, and submit it to the xStocks swap contract before it expires (60 seconds by default). See the xChange integration guide.
Integration checklist
- Display and quote the base token. Hold the wrapped token in contracts that store balances.
- Load addresses from the xStocks API, select the deployment with
chainId143, and verifyasset()on each wrapper. - Track
sharesOf()or re-readbalanceOf()after every multiplier activation. - Watch
MultiplierScheduledor poll the multiplier endpoint, and pause around each activation time. - Price wrapped collateral from an oracle, never from the vault’s conversion rate.
- Set staleness rules that account for the weekend gap in equity price feeds.
- Check the issuer’s eligibility restrictions for your users.

