# How It Works Source: https://docs.share.land/guides/how-it-works The complete picture - from signing up to trading SQFT tokens. ## The flow Sign up at share.land. Complete your profile to unlock trading. Connect a crypto wallet or use Shareland's built-in wallet. Add funds to get started. Explore available neighborhoods and cities. Each market shows live price, volume, and price history. Select a market and buy SQFT tokens. Your position reflects real-time exposure to that market's \$/sqft price. Track your positions, gains/losses, and market movements from your portfolio dashboard. Sell your tokens whenever you want. Funds are returned to your wallet immediately. ## Fees Shareland charges a flat **1.5% fee** on each transaction - buy or sell. There are no hidden fees, management fees, or withdrawal fees. ## Trade limits To protect market integrity during our early launch phase, daily trade limits apply per wallet. Limits may be adjusted over time as liquidity grows. ## Market hours Shareland markets operate continuously. Price updates from the oracle run on a regular cadence tied to real estate data availability. ## Security * Smart contracts are ERC-20 based, built on OpenZeppelin libraries, and [verified on BaseScan](/reference/contract-addresses) * Funds are held in on-chain contracts, not a centralized custodian * Privy wallet infrastructure provides secure, non-custodial key management # Introduction Source: https://docs.share.land/guides/introduction Smart real estate investing for everyone. Shareland is the first platform that lets anyone invest in real estate by the square foot: no minimum investment, no lockups, and fully liquid. ## What makes Shareland different Traditional real estate investing requires hundreds of thousands of dollars, years of commitment, and trusted brokers. Shareland changes that. | Traditional RE | Shareland | | ------------------ | ---------------- | | \$50,000+ minimum | No minimum | | Months to buy/sell | Instant trades | | High fees (6%) | 1.5% fee | | One property | Any neighborhood | ## The Square Foot Token (SQFT) The SQFT token is a synthetic asset that tracks the price per square foot of residential real estate in any geography. When a neighborhood's home prices rise, your SQFT tokens go up in value. Understand the mechanics behind the Square Foot Token ## Built on solid research Shareland's pricing methodology was developed with Dr. Susan Wachter (Wharton School) and Dr. Andrey Pavlov (Simon Fraser University), two of the world's leading real estate economists. ## Ready to start? Get set up in minutes Make your first investment # Quickstart Source: https://docs.share.land/guides/quickstart From zero to your first SQFT trade in under 5 minutes. Get from zero to your first real estate investment in under 5 minutes. ## 1. Create your account Go to [share.land](https://share.land) and click **Log In**. Connect any Web3 wallet: MetaMask, Coinbase Wallet, Rainbow, or any WalletConnect-compatible wallet. Complete your profile (name + accepting the Terms of Service) to unlock trading. Shareland is not available to residents of the United States or other restricted jurisdictions. See the [FAQ](/reference/faq) for the full list of restricted countries. ## 2. Fund your wallet Add USDC to your wallet to start trading. Your wallet address is visible in your portfolio under **User Profile**. ## 3. Pick a market Shareland markets Browse the **Explore Markets** section. Four markets are live at launch: * **New York** * **Miami** * **San Francisco** * **Los Angeles** See live prices at [share.land](https://share.land). Click any card to see the full detail view - price chart, neighborhood breakdown, and community posts. ## 4. Make your first trade In the market detail panel, click **Trade** β†’ **Buy**. Enter the amount in USDC and confirm. Your position appears in your portfolio instantly. That's it - you now have exposure to real estate by the square foot. πŸ™οΈ *** ## What's next? Track your positions and P\&L Provide liquidity and earn USDC yield Learn how prices are set Common questions answered # Supported Markets Source: https://docs.share.land/guides/supported-markets All currently available SQFT markets on the Shareland exchange. Shareland currently supports four markets at launch. Each market tracks the price per square foot of residential real estate in that geography. ## Live Markets **SQFT\_NYC** Β· NY **SQFT\_LA** Β· CA **SQFT\_SF** Β· CA **SQFT\_MIA** Β· FL Oracle prices update daily at 04:00 UTC. Market prices update in real time based on trading activity. See live prices at [share.land](https://share.land). ## What each market tracks Each market tracks the average **price per square foot** of residential real estate in that geography. The Shareland oracle aggregates recent home sales, active listings, and historical trends to produce a \$/sqft reference price, published daily at 04:00 UTC. See [Understanding the Oracle](/how-to/understand-oracle) for details on the update pipeline and methodology. ## How markets are added New markets go through a validation process before launch: 1. **Data review** - sufficient transaction volume must exist for reliable oracle pricing 2. **Oracle validation** - prices are backtested and validated by Shareland's data team (led by Dr. Andrey Pavlov) 3. **Launch** - market goes live with initial liquidity ## Request a market Want to see a specific neighborhood or city? Post a request in the [Discord community](https://discord.com/invite/5njaDH5y39). # Tycoonβ„’ AI Agent Source: https://docs.share.land/guides/tycoon The autonomous intelligence layer for real estate investing on Shareland. Tycoon is an AI agent built to navigate the world's largest asset class. It transforms real estate into a liquid, on-chain market by giving you direct exposure through Shareland's SQFT tokens, digital assets pegged to the price per square foot of individual neighborhoods and cities. Analyze market signals, act on your insights, and manage a real estate portfolio like a pro, all without the brokers, deeds, or lockups of the traditional market. Available on Virtuals Protocol ## How It Works Powered by Shareland, Tycoon brings real estate to life as a liquid, on-chain asset class that is global, accessible, and tradable in seconds. Leveraging Shareland's neighborhood-level infrastructure, Tycoon tracks housing markets, structures strategies around them, and enables agents or individuals to allocate capital seamlessly. No brokers. No deeds. No lockups. Just pure exposure to real estate, fully transparent and verifiable on-chain. ## What Powers Tycoon ### Shareland Infrastructure Shareland tokenizes real estate at the neighborhood level. Tycoon leverages this system to price, trade, mint, and burn synthetic real estate tokens, providing precise, liquid exposure to housing markets worldwide. ### Multi-Modal AI Architecture Tycoon runs on proprietary AI that fuses economic modeling, real estate data, and market sentiment. By combining pricing oracles, transaction trends, and liquidity flows, Tycoon interprets real estate like a professional investor would. ### ACP (Agent Commerce Protocol) Through ACP, Tycoon integrates with the wider Virtuals economy. Other agents can deploy capital into Tycoon's strategies, access property exposure, or collaborate on portfolio construction. ## How Tycoon Operates ### Neighborhood Market Investing Tycoon provides exposure to real estate at the neighborhood level, not just broad indexes or entire cities. By tokenizing localized markets, users can trade specific areas they believe will grow. ### Managed Real Estate Strategies Tycoon provides complete real estate strategies that other agents can plug into. From identifying opportunities to executing trades, Tycoon acts as a full-service portfolio manager. ### Liquid Real Estate Tycoon provides access to liquid real estate through Shareland's SQFT tokens, market-tracking instruments that mirror neighborhood housing prices, traded on-chain with flexibility traditional real estate can't offer. ## `$TYCOON` Token Utility **Contract address (Base):** ``` 0xdA4c86B5444294a5Ba3b806aE7718f1f95Cc3120 ``` [View on BaseScan](https://basescan.org/token/0xdA4c86B5444294a5Ba3b806aE7718f1f95Cc3120) | [Get on Virtuals](https://app.virtuals.io/virtuals/38268) ### Discounted Fees All Shareland transactions routed through Tycoon receive the lowest fee tier available. Tycoon is the most cost-efficient way to trade on the platform. ### Buyback and Burn 10% of Shareland transaction fees and 100% of Tycoon's agent fees are used to buy and burn `$TYCOON`, creating continuous buy pressure and permanently reduced supply. ### First Access to New Markets When Shareland expands to new neighborhoods or regions, `$TYCOON` holders have the first opportunity to trade before markets open to the public. Tycoon is live on X (Twitter) at [@sharelandtycoon](https://x.com/sharelandtycoon). Tycoon is a data visualization and market intelligence tool provided for informational and entertainment purposes only. Nothing produced by Tycoon constitutes financial, investment, or trading advice. Always do your own research. See the [Terms of Service](https://share.land/terms) and [Regulatory Information](/reference/regulatory) for details. # What are SQFT Tokens? Source: https://docs.share.land/guides/what-are-sqft-tokens Understanding the Square Foot Token, Shareland's core investment instrument. The Square Foot Token (SQFT) is a synthetic asset that tracks the **price per square foot** of residential real estate in a specific geography, whether that's a neighborhood like Beverly Hills, a city like Chicago, or a custom region. ## How SQFT is priced SQFT tokens are priced by the market. Shareland uses an automated market maker (AMM) that sets prices based on supply and demand. Users can also place limit orders to buy or sell at a specific price, similar to a traditional order book. To keep prices grounded in reality, each market has an **oracle** that publishes a reference price based on real-world housing data (recent sales, active listings, and historical trends). Arbitrage incentives create a soft peg that pulls the market price toward the oracle value over time, but the two can diverge in the short term. ## Example **Example:** If the San Francisco SQFT market is trading at \$1,300 and you buy \$5,000 worth of tokens, then the market price rises to \$1,400, your position value increases by roughly 8%. ## The Peg Mechanism (Arbitrage) SQFT tokens maintain their peg to the oracle price through arbitrage. When SQFT trades at a **premium** or **discount** relative to the oracle price, the market incentivizes traders to restore balance: * **Premium:** If SQFT trades higher than the oracle price, you can mint new tokens (by locking collateral) and sell them at the higher market price, effectively shorting with less capital exposure because buyers are subsidizing your entry. This selling pressure pushes the price down. * **Discount:** If SQFT trades lower than the oracle price, you can buy tokens cheaply and redeem them (burn) to unlock your collateral at the higher oracle value. This buying pressure pushes the price up. These forces continuously pull the market price back toward the oracle price. ## SQFT is a derivative, not ownership SQFT tokens give you **price exposure** to real estate, not fractional ownership of a property. This is similar to how commodity futures let you gain exposure to oil prices without owning barrels of oil. This structure means: * **No property management:** you're not a landlord * **Instant liquidity:** buy and sell anytime the market is open * **Lower fees:** 1.5% vs 6% in traditional real estate * **No minimum:** invest any amount ## Supported markets Shareland launches with select US neighborhoods and cities. Markets are added over time based on data availability and community demand. See all currently available SQFT markets # Why Shareland Source: https://docs.share.land/guides/why-shareland The problem with real estate investing today - and how Shareland fixes it. ## The problem with real estate investing Residential real estate is the backbone of personal wealth accumulation in the United States. As an investment, it offers an attractive risk-return profile while protecting against inflation, market volatility, and regulatory uncertainty. But investing in real estate comes with serious structural problems: * **Illiquid** - you can't sell a fraction of your house when you need cash * **Non-divisible** - you own one property, not a diversified basket * **Non-diversifiable** - a typical homeowner is entirely exposed to one specific neighborhood * **Capital-intensive** - entry requires hundreds of thousands of dollars * **Slow** - buying and selling takes months and costs 6% in fees Most Americans concentrate a meaningful portion of their assets into their primary home - with no way to diversify or hedge that exposure. ## Why existing alternatives don't work There are three products that theoretically provide real estate price exposure today: | Product | Problem | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Single-family REITs | No neighborhood-level exposure. Returns poorly correlated to actual housing markets. | | Multifamily REITs | Same issue - broad exposure only, not specific to where you live or want to invest. | | Case-Shiller futures | Metropolitan area only (not neighborhoods). Complex structure built for institutions, not individuals. Now largely discontinued. | Bank stocks and mortgage-backed securities don't provide the exposure either. **Retail investors currently have no tool that enables diversified, self-directed residential real estate exposure.** ## vs. Tokenized Real Estate Platforms Several platforms have emerged claiming to "democratize" real estate investing through tokenization. Here's how Shareland compares (as of Q1 2026): | Feature | Shareland | Arrived | RealT | Lofty | | -------------------------- | ------------------------------------ | ---------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------ | | **Exposure Type** | Synthetic price exposure (\$/sqft) | Direct property ownership (equity shares) | Tokenized rental property shares | Tokenized rental property shares | | **Minimum Investment** | \$1 | \$100 | \~\$50 | \~\$50 | | **Liquidity** | Instant (trade anytime) | None - locked until property sells | Limited secondary market | Limited secondary market | | **Geographic Granularity** | Neighborhood-level | Property-specific | Property-specific | Property-specific | | **Diversification** | Buy multiple neighborhoods instantly | Must buy shares in multiple properties | Must buy shares in multiple properties | Must buy shares in multiple properties | | **Fees** | 1.5% transaction fee | 1% annual management + 5-10% platform fee on sale | 1-2% annual management | 1-2% annual management | | **Returns** | Track market price appreciation | Rental income + appreciation (if property sells) | Rental income + appreciation (if property sells) | Rental income + appreciation (if property sells) | | **Risk** | Market price volatility | Property-specific risk (vacancy, repairs, property manager competence) | Property-specific risk | Property-specific risk | | **Regulatory** | SEC-registered securities offering | Reg CF/Reg A+ | Reg D (accredited only) or Reg CF | Reg CF | **Key insight:** Traditional tokenized platforms require you to choose specific properties and wait years for liquidity. Shareland lets you trade synthetic exposure to entire neighborhoods with instant liquidity - more like trading stocks than owning rental property. ## The Shareland solution Shareland is a protocol that lets anyone trade synthetic land tokens that track the price of residential real estate in any neighborhood. * **Any amount** - from a dollar to millions * **Any geography** - from a specific block to the entire US * **Any timeframe** - from one day to forever * **1.5% fees** - vs 6% traditional * **Instant liquidity** - buy and sell on-chain immediately The result: all the benefits of real estate investing - attractive returns, inflation protection, diversification - without the downsides of illiquid asset ownership. Understand the mechanics behind synthetic real estate tokens # Borrow, Mint, and Burn Source: https://docs.share.land/how-to/borrow-mint-burn How to mint (borrow) tokens against collateral and burn them to close positions. On Shareland, "borrowing" and "minting" refer to the same action: creating new SQFT tokens by locking collateral. ## How to Mint (Borrow) ### Step 1: Open a market From the exchange, click any market card to open the detail panel. ### Step 2: Open the Borrow tab In the action panel, click **Trade** then select the **Borrow** tab. ### Step 3: Enter your collateral and mint amount Enter the amount of USDC you want to deposit as collateral and the number of SQFT tokens to mint. The panel shows your collateralization ratio. Keep it above 120% for safety. ### Step 4: Confirm Review the details and confirm. The protocol locks your USDC and issues new SQFT tokens to your wallet. ## How to Burn (Close a Position) ### Step 1: Open the Borrow tab Navigate to the market where you have an open mint position and open the **Borrow** tab. ### Step 2: Select Burn Choose the amount of SQFT tokens you want to burn (return to the protocol). ### Step 3: Confirm Review and confirm. The protocol burns your SQFT tokens and releases the corresponding USDC collateral back to your wallet. If the SQFT price has dropped since you minted, you can buy back the tokens for less than you sold them for, keeping the difference as profit (shorting). ## Collateralization & Liquidation To ensure the system remains solvent, all minted positions must be over-collateralized based on the **Oracle Price** (not the market trading price). * **Minimum Collateralization Ratio (MCR):** 110% * This is the liquidation threshold. If your collateral value falls below 110% of your debt value (calculated using the Oracle Price), your position may be liquidated. * **Recommendation:** We strongly recommend minting at a ratio of **120% or higher** to provide a safety buffer against real estate price movements. **Liquidation Risk:** If the **Oracle price** of the underlying real estate rises (increasing your debt value relative to your collateral), your collateralization ratio decreases. Monitor your health factor closely. Market price fluctuations on the exchange do **not** affect your liquidation risk directly, only changes in the Oracle price do. ## Example * **Collateral:** You deposit \$1,100 USDC. * **Mint:** You mint \$1,000 worth of SQFT tokens. * **Ratio:** Your collateralization ratio is 110% (\$1,100 / \$1,000). * This is the minimum. To be safe, you should deposit more collateral (e.g., \$1,200) or mint fewer tokens. # Buy SQFT Tokens Source: https://docs.share.land/how-to/buy-sqft How to make your first trade on the Shareland exchange. You'll need USDC on the **Base** network to trade. There is no in-app on-ramp. Acquire USDC on Base through your wallet provider before getting started. ## Step 1: Browse markets From the exchange, browse the available markets. Each card shows the current oracle price (\$/sqft), 24h volume, and recent price movement. Shareland markets view ## Step 2: Select a market Click any market card to open the detail panel on the right. You'll see: * Live price chart and oracle price * Neighborhood breakdown with individual area prices * Community posts from other traders * Your current position in this market (if any) Market detail panel ## Step 3: Open the action panel Click **Trade** in the market action panel to open the buy/sell interface. ## Step 4: Choose order type The trade panel has two tabs: **Market** and **Limit**. ### Market order (default) Select the **Buy** tab under **Market**. Enter the USDC amount you want to trade. The interface shows you: * Number of SQFT tokens you'll receive * 1.5% transaction fee * Total cost Market orders execute immediately at the current AMM price. ### Limit order Select the **Limit** tab to set a specific price. Enter: * **Price** β€” the maximum \$/sqft you're willing to pay * **Amount** β€” USDC to spend or SQFT tokens to buy Your order sits in the order book until the market reaches your price. You can view and cancel open orders from the **Orders** tab. There is no minimum trade size. A minimum fee of \$0.10 applies per transaction. Trade panel: buy ## Step 5: Confirm Review the details and confirm. Market orders settle on-chain in seconds. Limit orders remain open until filled or cancelled. Your position appears in your portfolio immediately after execution. Your new position is visible instantly in the Portfolio tab. Track your positions after your first trade # Community Tab Source: https://docs.share.land/how-to/community-tabs Post messages and see what other traders are saying about a market. Each market on Shareland has a community tab where traders can post messages about that neighborhood or market. ## How to access it 1. From the exchange, click any market card to open the detail panel 2. In the panel, select the **Community** tab You'll see messages posted by other traders in that market. ## Posting Type your message and post directly from the community tab. Keep posts relevant to the market. Be respectful and stay on topic. Shareland reserves the right to remove posts that violate community standards. # Create an Account Source: https://docs.share.land/how-to/create-account Get set up on Shareland in minutes. ## Step 1: Go to share.land Visit [share.land](https://share.land) and click **Log In** in the top right corner. ## Step 2: Sign in A Privy popup will appear. You can sign in with: * **Email** β€” enter your email and verify with a code * **Google** β€” sign in with your Google account * **External wallet** β€” connect MetaMask, Coinbase Wallet, Rainbow, or any WalletConnect-compatible wallet Privy login modal If you sign in with email or Google, Shareland creates a secure wallet for you automatically β€” no crypto experience needed. ## Step 3: Start exploring Once connected, you're ready to browse markets and make your first trade. Explore live SQFT markets Make your first trade # Fund Your Account Source: https://docs.share.land/how-to/fund-your-account How to get USDC on Base so you can trade on Shareland. Shareland runs on the **Base** network. To trade, you need **USDC** β€” the currency used to buy and sell SQFT tokens. USDC must be on the **Base** network specifically. Funds on Ethereum mainnet, Arbitrum, Polygon, or other networks will not appear in Shareland. ## Step 1: Buy USDC Purchase USDC from a crypto exchange. Popular options include: * [Coinbase](https://www.coinbase.com) β€” supports direct withdrawals to Base * [Kraken](https://www.kraken.com) * [Binance](https://www.binance.com) If your exchange supports Base network withdrawals directly, you can skip the bridging step entirely. Coinbase supports this natively. ## Step 2: Send to your wallet on Base Withdraw USDC from the exchange to your wallet address. When withdrawing: 1. Copy your wallet's public address (the same address you use to log into Shareland) 2. In the exchange withdrawal screen, paste your wallet address 3. **Select "Base" as the network** β€” this is the critical step Double-check that you've selected **Base** as the withdrawal network. If you send on the wrong network (e.g., Ethereum mainnet or Arbitrum), your funds will not appear in Shareland. See [Common Mistakes](#common-mistakes) below. ## Step 3: Verify on Shareland Once the transfer completes (usually within a few minutes): 1. Go to [share.land](https://share.land) and connect your wallet 2. Your USDC balance should appear automatically 3. You're ready to trade If your USDC balance appears on [share.land](https://share.land), you're all set to start trading. ## Common Mistakes ### Sent funds on the wrong network If you accidentally sent USDC on Ethereum mainnet, Arbitrum, or another network instead of Base: 1. **Don't panic** β€” your funds are not lost, they're just on a different network 2. Send them back to your exchange account (on the network you used) 3. Re-send from the exchange, this time selecting **Base** as the network ### Sent the wrong token Shareland uses **USDC** (USD Coin), not USDT, DAI, or other stablecoins. Make sure you're sending USDC specifically. ### Balance not showing up If your transfer completed but your balance isn't showing in Shareland: * Confirm the transaction on [BaseScan](https://basescan.org) by searching your wallet address * Make sure you're connected with the same wallet you sent funds to * Try refreshing the page ## FAQ Most wallets (MetaMask, Coinbase Wallet, etc.) handle gas fees automatically using your USDC β€” no ETH needed. If your wallet does not support this, a very small amount of ETH on Base (less than \$0.01 per trade) may be required. There is no minimum trade size on Shareland. A minimum fee of \$0.10 applies per transaction, so very small trades may not be cost-efficient. Any Web3 wallet that supports the Base network: MetaMask, Coinbase Wallet, Rainbow, or any WalletConnect-compatible wallet. You need a self-custody wallet (like Coinbase Wallet, not your Coinbase exchange account). Withdraw from Coinbase to your Coinbase Wallet on the Base network, then connect that wallet to Shareland. Set up your Shareland account Make your first trade # Sell SQFT Tokens Source: https://docs.share.land/how-to/sell-sqft How to close a position and return funds to your wallet. ## Step 1: Open the action panel You can open the sell panel two ways: * **From Portfolio:** Navigate to **Portfolio** in the top nav β†’ click any position in the **Assets** tab * **From the market:** Click any market card on the exchange to open the action panel directly Portfolio assets tab ## Step 2: Choose order type The sell panel has two tabs: **Market** and **Limit**. ### Market order (default) Select the **Sell** tab under **Market**. Enter the amount to close, either a specific number of tokens or a USDC value. Partial exits are fully supported. Market orders execute immediately at the current AMM price. ### Limit order Select the **Limit** tab to set a specific price. Enter: * **Price** β€” the minimum \$/sqft you're willing to accept * **Amount** β€” number of SQFT tokens to sell Your order sits in the order book until the market reaches your price. You can view and cancel open orders from the **Orders** tab. Trade panel: sell ## Step 3: Confirm Review the transaction details, including the 1.5% fee, and confirm. Market orders settle immediately. Limit orders remain open until filled or cancelled. Funds return to your connected wallet after the transaction confirms on-chain. You can sell any portion of a position. You don't have to exit all at once. Track your remaining positions # Stake, Unstake, and Claim Source: https://docs.share.land/how-to/stake-and-claim How to stake tokens and claim rewards on Shareland. Staking provides liquidity to the exchange by depositing **both SQFT tokens and USDC** into a market's liquidity pool. In return, you receive LP (liquidity provider) tokens representing your share of the pool, and earn USDC rewards from trading fees. Rewards accrue continuously and can be claimed at any time. ## How to Stake ### Step 1: Open a market From the exchange, click any market card to open the detail panel. Shareland markets view ### Step 2: Open the Stake tab In the market detail panel, select the **Stake** tab. Stake panel ### Step 3: Enter your amounts Staking requires **two inputs**: * **SQFT tokens** (Land) β€” the amount of SQFT tokens to deposit * **USDC** (Stable) β€” the amount of USDC to deposit alongside The panel shows the required ratio based on current pool composition. Enter one side and the other will auto-calculate, or adjust both manually. ### Step 4: Confirm Review and confirm the transaction. You'll receive LP tokens representing your share of the liquidity pool. Your position is visible in your Portfolio. Staking is two-sided liquidity provision. You are depositing both SQFT and USDC into the pool, which means your position is exposed to both assets. This carries different risk characteristics than simply holding SQFT tokens. ## How to Unstake ### Step 1: Open the Unstake tab Navigate to the market where you have staked tokens and select the **Unstake** tab. ### Step 2: Enter the amount Enter the number of LP tokens (or equivalent position) you want to withdraw from the pool. You will receive both SQFT tokens and USDC back in proportion to your pool share. ### Step 3: Confirm Approve the transaction to withdraw your tokens back to your wallet. ## How to Claim Rewards Rewards accumulate over time based on your staked position. 1. **Check Rewards:** View your accrued rewards in the **Portfolio** tab under **Staking Rewards**. 2. **Claim:** Click the **Claim** button to transfer USDC rewards to your wallet. Staking rewards are distributed in USDC and can be claimed at any time from your Portfolio. Track your staking rewards in Portfolio # Understanding the Oracle Source: https://docs.share.land/how-to/understand-oracle How Shareland prices SQFT tokens in real time using academically validated methodology. The Shareland oracle publishes a reference price for each SQFT market. It aggregates real estate transaction data to produce a live, reliable price per square foot, which the market uses as an anchor through arbitrage incentives. ## Data sources The oracle aggregates data from multiple authoritative sources to produce neighborhood-level price per square foot estimates: * **County recorder offices** β€” Official deed records of closed home sales with verified transaction prices * **Multiple Listing Services (MLS)** β€” Active listings and pending transactions across participating brokerages * **Public listing platforms** β€” Zillow, Redfin, and other aggregators that track asking prices and market trends * **Tax assessor databases** β€” Property characteristics (size, bed/bath count, lot details) for accurate per-sqft normalization ### Data weighting Raw data points are weighted by: * **Recency** β€” Sales from the past 90 days carry more weight than older comps * **Geographic proximity** β€” Transactions within the target neighborhood receive higher relevance scores * **Transaction volume** β€” Markets with frequent turnover produce more stable price signals * **Property type** β€” Single-family, condo, and townhome sales are filtered and weighted differently based on market composition ## Price updates Oracle prices update **every 24 hours** at 00:00 UTC. The update cycle: 1. **Data ingestion** (00:00-02:00 UTC) β€” New sales and listings from the past 24 hours are pulled and validated 2. **Model computation** (02:00-03:00 UTC) β€” Weighted regression models compute updated \$/sqft values for each market 3. **Anomaly detection** (03:00-04:00 UTC) β€” Outlier checks run to flag unusual price movements 4. **On-chain publication** (04:00 UTC) β€” Validated prices are written to the oracle contract on Base You'll see updated prices reflected in the exchange UI after 04:00 UTC each day. ## Market halts If the oracle detects an anomaly β€” such as a **single-day price change exceeding Β±10%** β€” the market may automatically halt to protect investors. Common triggers include: * Data pipeline errors (missing or corrupted feed data) * Flash crash events in underlying housing markets * Coordinated listing manipulation (rare but monitored) When a halt occurs: * The exchange UI will display a **"Market Paused"** banner * Open orders remain in the order book but cannot execute * You may receive a notification depending on your account settings * Shareland's data team investigates and publishes a resolution timeline Markets resume once the anomaly is investigated and resolved, typically within 24-48 hours. ## Oracle vs. Market Price The **Oracle Price** represents the true underlying value of the real estate per square foot based on transaction data. The **Market Price** is what buyers and sellers are currently trading at on the Shareland exchange. Key differences: | | Oracle Price | Market Price | | -------------- | ---------------------------- | --------------------------------- | | **Updated** | Daily (04:00 UTC) | Real-time (continuous) | | **Source** | Real estate transaction data | Supply/demand on Shareland | | **Used for** | Debt ratios, liquidations | Trading, order execution | | **Volatility** | Low (daily changes \~0.5-2%) | Higher (intraday swings possible) | ### Why this matters for collateralized positions * **Debt Calculation:** Your debt position (collateralization ratio) is always calculated using the **Oracle Price**, not the secondary market trading price. * **Liquidation:** Liquidations are triggered ONLY if the **Oracle Price** moves significantly enough to drop your ratio below 110%. Exchange market volatility (Market Price swings) does **not** trigger liquidation. This protects you from short-term market manipulation or liquidity crunches on the exchange itself. ## Methodology Shareland's oracle methodology was developed in collaboration with **Dr. Susan Wachter** (Wharton School) and **Dr. Andrey Pavlov** (Simon Fraser University). The approach uses academically validated regression models for neighborhood-level real estate pricing, adapted from peer-reviewed research on housing price indices. The core model is a **repeat-sales index** similar to the Case-Shiller methodology, but enhanced with: * Geographic clustering algorithms to define micro-market boundaries * Hedonic regression adjustments for property characteristics (sqft, bed/bath, lot size) * Time-weighted smoothing to reduce noise from sparse transaction data ### On-chain verification Oracle prices are published to two contracts on **Base mainnet**: * **DecentralizedOracle** β€” `0x6b0523C666582513CAd89E3F653854EF650E0e2C` ([BaseScan](https://basescan.org/address/0x6b0523C666582513CAd89E3F653854EF650E0e2C)) * **SimpleOracle** β€” `0x37C408c0F1752e33ed169cEe6B5B881551Ad64Ea` ([BaseScan](https://basescan.org/address/0x37C408c0F1752e33ed169cEe6B5B881551Ad64Ea)) You can verify any published price directly on-chain at any time. A full methodology document with model specifications and backtesting results is available for investors. Contact the team at [team@share.land](mailto:team@share.land) to request access. # View Your Portfolio Source: https://docs.share.land/how-to/view-portfolio Understanding your Shareland portfolio dashboard. Navigate to **Portfolio** in the top nav to see your full trading dashboard. Portfolio dashboard ## Portfolio tabs | Tab | What you'll find | | ------------- | ------------------------------------------------------- | | **Assets** | All your open SQFT positions and their current value | | **Watchlist** | Markets you're tracking but haven't traded yet | | **Activity** | Full history of every buy, sell, and reward transaction | ## What's on the dashboard **Portfolio Value** - total current value of all open positions in USDC, at live oracle prices. Updates in real time. **Staking Rewards** - protocol revenue distributed to your wallet. Click **Claim** to withdraw at any time. **Buying Power** - USDC available in your wallet to trade. ## Reading your positions Each position in the **Assets** tab shows: * **Market** - which SQFT token you hold (e.g. SQFT\_NYC) * **Current value** - position value in USDC at the live oracle price * **Gain/loss** - unrealized P\&L since your entry ## Transaction history The **Activity** tab shows a full log of every trade, mint, burn, and reward claim, with timestamps, amounts, and fees paid. Ready to build your portfolio? # Trading Guide for AI Agents Source: https://docs.share.land/reference/agent-trading Complete instructions for programmatic SQFT token trading on the Shareland exchange β€” contract addresses, function signatures, code examples. Shareland is a tokenized real estate exchange on **Base** (Ethereum L2). Users trade **SQFT tokens** β€” synthetic assets that track the \$/sqft price of residential real estate in specific neighborhoods and cities. All trading happens on-chain through an AMM (automated market maker) with USDC as the settlement currency. This guide provides everything an AI agent or trading bot needs to execute trades programmatically. ## Network & Chain | Parameter | Mainnet | Testnet | | -------------- | ------------------------------------ | ---------------------------------------------------- | | Chain | Base | Base Sepolia | | Chain ID | `8453` | `84532` | | RPC | `https://mainnet.base.org` | `https://sepolia.base.org` | | Block explorer | [basescan.org](https://basescan.org) | [sepolia.basescan.org](https://sepolia.basescan.org) | ## Token Details | Token | Decimals | Mainnet Address | | -------------------------- | -------- | ------------------------------------------------------------------- | | USDC (settlement currency) | 6 | `0x833589fcd6edb6e08f4c7c32d4f71b54bda02913` | | SQFT tokens (per-market) | 6 | Varies per market (see [Discovering Markets](#discovering-markets)) | Both USDC and SQFT tokens use **6 decimals**. To convert a human-readable amount to on-chain units, multiply by `1e6`. For example, \$100 USDC = `100000000` (100 Γ— 10^6). ## Core Contract Addresses (Mainnet) These are **beacon addresses** β€” the shared implementation layer. Each market has its own proxy contracts that point to these beacons. | Contract | Address | | --------------------------- | -------------------------------------------- | | ShareLandMarket (beacon) | `0x6E43100ad67C1e5FcFE86f764C309D0fc09b63D7` | | ShareLandToken (beacon) | `0xEe5FB96a1632820a1F2b8FAf29f203829D3d7CE2` | | OrderBook (beacon) | `0x6A4fB77BAc500893E9A753dE32DcEA0E939D30B0` | | CollateralPosition (beacon) | `0x8604455F37C96A86B1069B409b88E9b3fc2e3c36` | | MarketFormula | `0x697631c4fda4B984c6E350f2b0716a8a100C7693` | | MarketDeployer | `0xb44305543e4d370DaC0A027d791b467DC8CF0e2f` | You **do not** interact with the beacon addresses directly. Each market has its own proxy addresses. Use the API (below) to get the correct proxy address for the market you want to trade. ## Discovering Markets Call the public API to get all available markets and their per-market contract addresses. **No authentication required.** ```bash theme={null} # Mainnet curl -s https://dropym7xnur1f.cloudfront.net/lands | jq '.data.landBuskets' # Testnet curl -s https://d1v6qjbkcqbflx.cloudfront.net/lands | jq '.data.landBuskets' ``` Yes, it's `landBuskets` β€” a portmanteau of "baskets" and "buckets." The team couldn't decide between the two, so we went with both. It's intentional. Each market in the response includes a `contractAddresses` object with the proxy addresses you need: ```json theme={null} { "tokenSymbol": "SFO", "name": "San Francisco", "contractAddresses": { "market": "0x...", "shareLandToken": "0x...", "stableToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "collateralPosition": "0x...", "orderBook": "0x...", "liquidityProviderToken": "0x...", "simpleOracle": "0x...", "decentralizedOracle": "0x..." }, "marketInfo": { "marketPrice": 1300000000, "oraclePrice": 1295000000, "totalSupply": 50000000000, "paused": false } } ``` Key fields: * **`contractAddresses.market`** β€” the ShareLandMarket proxy you call `purchase()` and `sell()` on * **`contractAddresses.shareLandToken`** β€” the ERC-20 SQFT token for this market * **`contractAddresses.stableToken`** β€” USDC address * **`marketInfo.marketPrice`** β€” current price in USDC (6 decimals). Divide by `1e6` for human-readable \$/sqft * **`marketInfo.paused`** β€” if `true`, the market is halted and trades will revert ### Global Market Data ```bash theme={null} curl -s https://dropym7xnur1f.cloudfront.net/market-data | jq '.data' ``` Returns aggregate volume, market cap, TVL, and transaction counts. ## How to Buy SQFT Tokens Trading on Shareland is a two-step process: **approve** USDC spending, then **call purchase**. ### Step 1: Approve USDC Before buying, you must approve the market contract to spend your USDC. Approve at least the amount you want to spend plus the 1.5% transaction fee. ```solidity theme={null} // On the USDC contract (ERC-20 standard) function approve(address spender, uint256 amount) external returns (bool) ``` * `spender` = the market's proxy address (`contractAddresses.market`) * `amount` = USDC amount to spend including fees. To be safe, approve `usdcAmount * 10150 / 10000` or simply a large amount. ### Step 2: Purchase The simplest entry point β€” specify how much USDC to spend: ```solidity theme={null} function purchase(uint256 stableTokenAmount) external ``` * `stableTokenAmount` β€” USDC amount to spend (6 decimals). For example, `100000000` = \$100 USDC. * The contract calculates how many SQFT tokens you receive based on the AMM bonding curve. * A 1.5% transaction fee is charged on top (deducted from your approved USDC). **With slippage protection** (recommended for production bots): ```solidity theme={null} function purchaseWithMinReceived( uint256 stableTokenAmount, uint256 minReceivedLandTokenAmount ) public ``` * `minReceivedLandTokenAmount` β€” minimum SQFT tokens you're willing to accept. If the AMM would give you fewer, the transaction reverts. **By token amount** (specify how many SQFT tokens you want): ```solidity theme={null} function purchaseLandToken(uint256 landTokenAmount) public ``` * `landTokenAmount` β€” exact number of SQFT tokens to buy (6 decimals). * The contract calculates the USDC cost. You must have approved enough USDC (cost + fees). ### Events A successful purchase emits: ```solidity theme={null} event MarketTransaction( address indexed account, uint256 landTokenAmount, uint256 stableTokenAmount, uint256 transactionFees, TransactionType transactionType // TransactionType.Purchase ); ``` ## How to Sell SQFT Tokens No approval needed β€” the market contract has the `TRANSFER_ROLE` on the SQFT token and will transfer tokens from your wallet directly. ```solidity theme={null} function sell(uint256 landTokenAmount) external ``` * `landTokenAmount` β€” SQFT tokens to sell (6 decimals). * You receive USDC minus the 1.5% transaction fee. **With slippage protection:** ```solidity theme={null} function sellWithMinReceived( uint256 landTokenAmount, uint256 minReceivedStableTokenAmount ) public ``` * `minReceivedStableTokenAmount` β€” minimum USDC you're willing to accept. Reverts if you'd receive less. ## Transaction Fees A **1.5% fee** is charged on every trade (buy and sell), denominated in USDC. * **Buy:** You pay `usdcCost + fee`. Fee = `usdcCost Γ— 150 / 10000`. * **Sell:** You receive `usdcProceeds - fee`. Fee = `usdcProceeds Γ— 150 / 10000`. * A minimum fee of \$0.10 applies per transaction. * Fees go to the market's liquidity providers. ## Trade Limits Markets may enforce per-wallet trade limits within rolling time epochs. Limits are configurable per market and may change over time. * **Epoch period:** a fixed time window (e.g., 24 hours) * **Purchase limit:** max USDC spent per epoch * **Sell limit:** max USDC received per epoch * Limits are tracked as a **net** amount (purchases minus sells) If limits are set to 0, there are no restrictions. If your trade would exceed the limit, the transaction reverts with an error. You can query limits by reading the market contract's public storage, but in practice, start with small trades to determine the current limits. ## ABI for Trading Minimal ABI needed for trading (JSON format): ```json theme={null} [ { "name": "purchase", "type": "function", "stateMutability": "nonpayable", "inputs": [{ "name": "stableTokenAmount", "type": "uint256" }], "outputs": [] }, { "name": "purchaseWithMinReceived", "type": "function", "stateMutability": "nonpayable", "inputs": [ { "name": "stableTokenAmount", "type": "uint256" }, { "name": "minReceivedLandTokenAmount", "type": "uint256" } ], "outputs": [] }, { "name": "purchaseLandToken", "type": "function", "stateMutability": "nonpayable", "inputs": [{ "name": "landTokenAmount", "type": "uint256" }], "outputs": [] }, { "name": "sell", "type": "function", "stateMutability": "nonpayable", "inputs": [{ "name": "landTokenAmount", "type": "uint256" }], "outputs": [] }, { "name": "sellWithMinReceived", "type": "function", "stateMutability": "nonpayable", "inputs": [ { "name": "landTokenAmount", "type": "uint256" }, { "name": "minReceivedStableTokenAmount", "type": "uint256" } ], "outputs": [] } ] ``` Standard ERC-20 ABI for USDC approval and balance checks: ```json theme={null} [ { "name": "approve", "type": "function", "stateMutability": "nonpayable", "inputs": [ { "name": "spender", "type": "address" }, { "name": "amount", "type": "uint256" } ], "outputs": [{ "name": "", "type": "bool" }] }, { "name": "balanceOf", "type": "function", "stateMutability": "view", "inputs": [{ "name": "account", "type": "address" }], "outputs": [{ "name": "", "type": "uint256" }] }, { "name": "allowance", "type": "function", "stateMutability": "view", "inputs": [ { "name": "owner", "type": "address" }, { "name": "spender", "type": "address" } ], "outputs": [{ "name": "", "type": "uint256" }] } ] ``` ## Code Examples ### Using viem (recommended) ```typescript theme={null} import { createPublicClient, createWalletClient, http, parseUnits, formatUnits } from "viem"; import { base } from "viem/chains"; import { privateKeyToAccount } from "viem/accounts"; const USDC_ADDRESS = "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"; const MARKET_ADDRESS = "0x..."; // Per-market proxy from API const account = privateKeyToAccount("0xYOUR_PRIVATE_KEY"); const publicClient = createPublicClient({ chain: base, transport: http("https://mainnet.base.org"), }); const walletClient = createWalletClient({ account, chain: base, transport: http("https://mainnet.base.org"), }); const erc20Abi = [ { name: "approve", type: "function", stateMutability: "nonpayable", inputs: [ { name: "spender", type: "address" }, { name: "amount", type: "uint256" }, ], outputs: [{ name: "", type: "bool" }], }, { name: "balanceOf", type: "function", stateMutability: "view", inputs: [{ name: "account", type: "address" }], outputs: [{ name: "", type: "uint256" }], }, ] as const; const marketAbi = [ { name: "purchase", type: "function", stateMutability: "nonpayable", inputs: [{ name: "stableTokenAmount", type: "uint256" }], outputs: [], }, { name: "sell", type: "function", stateMutability: "nonpayable", inputs: [{ name: "landTokenAmount", type: "uint256" }], outputs: [], }, ] as const; // Buy $100 worth of SQFT tokens async function buyTokens() { const usdcAmount = parseUnits("100", 6); // $100 USDC const approveAmount = (usdcAmount * 10150n) / 10000n; // +1.5% buffer for fees // Step 1: Approve USDC await walletClient.writeContract({ address: USDC_ADDRESS, abi: erc20Abi, functionName: "approve", args: [MARKET_ADDRESS, approveAmount], }); // Step 2: Purchase const hash = await walletClient.writeContract({ address: MARKET_ADDRESS, abi: marketAbi, functionName: "purchase", args: [usdcAmount], }); const receipt = await publicClient.waitForTransactionReceipt({ hash }); console.log("Purchase confirmed:", receipt.transactionHash); } // Sell 50 SQFT tokens async function sellTokens() { const tokenAmount = parseUnits("50", 6); // 50 SQFT tokens const hash = await walletClient.writeContract({ address: MARKET_ADDRESS, abi: marketAbi, functionName: "sell", args: [tokenAmount], }); const receipt = await publicClient.waitForTransactionReceipt({ hash }); console.log("Sell confirmed:", receipt.transactionHash); } ``` ### Using ethers.js ```typescript theme={null} import { ethers } from "ethers"; const USDC_ADDRESS = "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"; const MARKET_ADDRESS = "0x..."; // Per-market proxy from API const provider = new ethers.JsonRpcProvider("https://mainnet.base.org"); const wallet = new ethers.Wallet("YOUR_PRIVATE_KEY", provider); const erc20Abi = [ "function approve(address spender, uint256 amount) returns (bool)", "function balanceOf(address account) view returns (uint256)", ]; const marketAbi = [ "function purchase(uint256 stableTokenAmount)", "function sell(uint256 landTokenAmount)", ]; const usdc = new ethers.Contract(USDC_ADDRESS, erc20Abi, wallet); const market = new ethers.Contract(MARKET_ADDRESS, marketAbi, wallet); // Buy $100 worth of SQFT tokens async function buyTokens() { const usdcAmount = ethers.parseUnits("100", 6); const approveAmount = (usdcAmount * 10150n) / 10000n; const approveTx = await usdc.approve(MARKET_ADDRESS, approveAmount); await approveTx.wait(); const purchaseTx = await market.purchase(usdcAmount); const receipt = await purchaseTx.wait(); console.log("Purchase confirmed:", receipt.hash); } // Sell 50 SQFT tokens async function sellTokens() { const tokenAmount = ethers.parseUnits("50", 6); const sellTx = await market.sell(tokenAmount); const receipt = await sellTx.wait(); console.log("Sell confirmed:", receipt.hash); } ``` ## Common Mistakes **Do NOT use `CollateralPosition` for spot trading.** The `CollateralPosition` contract (`openCollateralPosition`, `closeCollateralPosition`) is for **borrowing/minting** β€” it creates leveraged collateralized debt positions, not spot trades. If you want to simply buy or sell SQFT tokens, use `ShareLandMarket.purchase()` and `ShareLandMarket.sell()`. | Mistake | What happens | Fix | | ------------------------------------------------------ | -------------------------------------------------- | -------------------------------------------------------------------- | | Calling the beacon address instead of the market proxy | Transaction fails or interacts with wrong contract | Use `contractAddresses.market` from the API for each specific market | | Insufficient USDC approval | Transaction reverts | Approve at least `amount Γ— 1.015` to cover fees | | Wrong decimals | Wildly incorrect amounts | Both USDC and SQFT use 6 decimals | | Trading on a paused market | Transaction reverts | Check `marketInfo.paused` via the API first | | Using `CollateralPosition` for spot trades | Creates a leveraged debt position, not a trade | Use `ShareLandMarket.purchase()` / `sell()` | ## Advanced: Collateral Positions (Borrowing/Minting) This section is for advanced agents only. Most trading bots should use `purchase()` and `sell()` above. The `CollateralPosition` contract allows users to **mint** new SQFT tokens by locking USDC collateral, and **burn** them to reclaim collateral. This is a leveraged mechanism similar to a CDP (Collateralized Debt Position) in DeFi. * `openCollateralPosition(uint256 landTokenAmount, uint256 stableTokenAmount)` β€” lock USDC collateral, mint SQFT tokens * `closeCollateralPosition()` β€” burn minted tokens, reclaim collateral * `adjustCollateralPosition(uint256 landTokenAmount, uint256 stableTokenAmount)` β€” modify position size These functions are gated by the `actionAllowed` modifier, which checks `MarketFormula.isVerificationRequiredForCDP` and `MarketFormula.isWhiteListed(msg.sender)`. If CDP verification is required and your address is not whitelisted, these calls will revert. ## Full Reference * [Contract Addresses](/reference/contract-addresses) β€” all verified contract addresses on Base mainnet * [What are SQFT Tokens?](/guides/what-are-sqft-tokens) β€” how SQFT pricing and the oracle peg work * [How It Works](/guides/how-it-works) β€” fees, trade limits, and market hours * [FAQ](/reference/faq) # Contract Addresses Source: https://docs.share.land/reference/contract-addresses Verified smart contract addresses for the Shareland exchange on Base mainnet. Shareland runs entirely on-chain on **Base** (chainId 8453). All contracts are verified on BaseScan, and you can inspect the source code at any time. ## Core Contracts These are the beacon addresses that users interact with. | Contract | Address | BaseScan | | ---------------------- | -------------------------------------------- | ------------------------------------------------------------------------------- | | ShareLandMarket | `0x6E43100ad67C1e5FcFE86f764C309D0fc09b63D7` | [View](https://basescan.org/address/0x6E43100ad67C1e5FcFE86f764C309D0fc09b63D7) | | ShareLandToken | `0xEe5FB96a1632820a1F2b8FAf29f203829D3d7CE2` | [View](https://basescan.org/address/0xEe5FB96a1632820a1F2b8FAf29f203829D3d7CE2) | | OrderBook | `0x6A4fB77BAc500893E9A753dE32DcEA0E939D30B0` | [View](https://basescan.org/address/0x6A4fB77BAc500893E9A753dE32DcEA0E939D30B0) | | CollateralPosition | `0x8604455F37C96A86B1069B409b88E9b3fc2e3c36` | [View](https://basescan.org/address/0x8604455F37C96A86B1069B409b88E9b3fc2e3c36) | | LiquidityProviderToken | `0xf6394875d3759cabF05aE57D4F7A1b8B9bFE9f58` | [View](https://basescan.org/address/0xf6394875d3759cabF05aE57D4F7A1b8B9bFE9f58) | ## Oracle Contracts | Contract | Address | BaseScan | | ------------------- | -------------------------------------------- | ------------------------------------------------------------------------------- | | DecentralizedOracle | `0x6b0523C666582513CAd89E3F653854EF650E0e2C` | [View](https://basescan.org/address/0x6b0523C666582513CAd89E3F653854EF650E0e2C) | | SimpleOracle | `0x37C408c0F1752e33ed169cEe6B5B881551Ad64Ea` | [View](https://basescan.org/address/0x37C408c0F1752e33ed169cEe6B5B881551Ad64Ea) | ## Infrastructure | Contract | Address | BaseScan | | --------------------- | -------------------------------------------- | ------------------------------------------------------------------------------- | | MarketFormula | `0x697631c4fda4B984c6E350f2b0716a8a100C7693` | [View](https://basescan.org/address/0x697631c4fda4B984c6E350f2b0716a8a100C7693) | | ExchangeRateConverter | `0x0BcF105266f378ecD2BC1fea13fbf7550f574615` | [View](https://basescan.org/address/0x0BcF105266f378ecD2BC1fea13fbf7550f574615) | ## External Tokens | Token | Address | BaseScan | | ------------- | -------------------------------------------- | ------------------------------------------------------------------------------- | | USDC (Circle) | `0x833589fcd6edb6e08f4c7c32d4f71b54bda02913` | [View](https://basescan.org/address/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913) | | \$TYCOON | `0xdA4c86B5444294a5Ba3b806aE7718f1f95Cc3120` | [View](https://basescan.org/address/0xdA4c86B5444294a5Ba3b806aE7718f1f95Cc3120) | ## Architecture Shareland uses an **upgradeable beacon proxy pattern** (OpenZeppelin). The core addresses above are beacons. Individual market proxies point to these beacons, and implementation contracts sit behind them. Beacons can be upgraded without changing any proxy addresses. All implementation source code is verified on BaseScan. If you see a MetaMask "Address needs review" warning, this is a standard alert for newer contracts. You can verify any address above by clicking the BaseScan link and confirming the source code is verified. # FAQ Source: https://docs.share.land/reference/faq Answers to the most common questions about Shareland. ## Platform Shareland is not available if you are located in, incorporated in, or a resident or citizen of a **Restricted Jurisdiction** as defined in our [Terms of Service](https://share.land/terms) (v1.2, effective June 30, 2026). That page lists all blocked countries and regions. During sign-up, you'll be asked to confirm your jurisdiction. Users in restricted countries will not be able to access the exchange. Using a VPN to bypass geofencing is a violation of our Terms of Service. There is no minimum trade size. However, a minimum fee of \$0.10 applies per transaction. No maximum. Trade any amount. Shareland charges a flat **1.5% fee** on each transaction (buy or sell). No management fees, no withdrawal fees, no hidden charges. No. SQFT tokens are synthetic instruments that track the price per square foot of real estate in specific neighborhoods. You gain price exposure without owning physical property, similar to how commodity futures give you exposure to oil prices without owning barrels of oil. SQFT tokens are priced by the market. Shareland uses an automated market maker (AMM) that sets prices based on supply and demand, with support for limit orders at specific prices. Each market also has an oracle that publishes a reference price based on real-world housing data (recent sales, listings, and historical trends). Arbitrage incentives create a soft peg that pulls the market price toward the oracle value over time. The oracle methodology was developed with Dr. Susan Wachter (Wharton School) and Dr. Andrey Pavlov (Simon Fraser University). Yes. SQFT tokens reflect real estate prices, which can go down as well as up. Only trade what you can afford to lose. Please read all risk disclosures before trading. Not yet. Shareland currently runs as a web application accessible from any mobile or desktop browser. A native mobile app is on the roadmap. ## Token Mechanics Shareland may automatically halt trading in a market if suspicious activity or anomalous pricing is detected. This is a protective measure to maintain marketplace health. Your tokens remain in your wallet and are unaffected during a halt. Markets resume once the issue is resolved. Sell your SQFT tokens. Proceeds return to your connected wallet immediately after the on-chain transaction confirms. From there, transfer to any external wallet or exchange as you normally would. Staking deposits both SQFT tokens and USDC into a market's liquidity pool, where they help facilitate trades on the exchange. In return, you receive LP (liquidity provider) tokens and earn USDC rewards from trading fees. Rewards accrue continuously and can be claimed at any time from your Portfolio. Note that LP positions carry different risk characteristics than simply holding SQFT. See the [staking guide](/how-to/stake-and-claim) for details. Borrowing (minting) lets you lock USDC as collateral to create new SQFT tokens. This opens a debt position. To unlock your collateral, you return (burn) the same number of SQFT tokens. Shareland requires a minimum collateralization ratio (MCR) of 110%. We recommend maintaining 120% or above for safety. If your ratio drops to 110%, your position will be automatically liquidated. ## Technical Shareland uses [Privy](https://privy.io) for secure, non-custodial wallet management. You control your keys. Shareland never takes custody of your funds or private keys. Shareland runs on the **Base** blockchain, an Ethereum L2 built by Coinbase. All transactions are executed programmatically via self-custodial wallets. Tax treatment of synthetic derivative instruments varies by jurisdiction. Shareland does not provide tax advice. We recommend consulting a tax professional familiar with digital assets in your country. Visit [share.land](https://share.land) and click **Log In**. You can sign in with email, Google, or an external wallet (MetaMask, Coinbase Wallet, etc.). If you use email or Google, a secure wallet is created for you automatically. You need USDC on the Base network to trade. Send USDC from a crypto exchange (like Coinbase) to your wallet address on Base. If you signed up with email or Google, your wallet address is shown in the app. See [Fund Your Account](/how-to/fund-your-account) for step-by-step instructions. SQFT tokens are structured as synthetic derivative instruments, not securities. Shareland is pursuing regulatory clarity under the **CFTC** framework. See our [Terms of Service](https://share.land/terms) for the full legal picture. # Glossary Source: https://docs.share.land/reference/glossary Key terms used on the Shareland exchange. The Square Foot Token. Shareland's core trading instrument. Each token represents synthetic price exposure to the \$/sqft value of a specific real estate market or neighborhood. The data engine that publishes a reference price for each SQFT market by aggregating real estate transaction data and listing prices. Developed with Dr. Susan Wachter (Wharton School) and Dr. Andrey Pavlov (Simon Fraser University). A tradeable geography on Shareland: a specific neighborhood, city, or region. Each market has its own SQFT token and price feed. An instrument that tracks the price of an underlying asset without requiring ownership of that asset. SQFT tokens are synthetic. They track real estate prices without you owning property. The SQFT tokens you currently hold in a specific market. Your portfolio is made up of all your open positions. USDC deposited to secure a mint (borrow) position. Shareland requires a minimum collateralization ratio (MCR) of 110%. If your ratio drops to 110%, your position is automatically liquidated. Recommended minimum is 120%. The creation of new SQFT tokens by locking USDC collateral. Minting is how you open a borrow/short position. You deposit USDC and receive newly created SQFT tokens. The destruction of SQFT tokens by returning them to the protocol to unlock your deposited USDC collateral. Burning is how you close a mint (borrow) position. Depositing both SQFT tokens and USDC into a market's liquidity pool to earn USDC yield from trading fees. You receive LP (liquidity provider) tokens in return. LP positions carry different risk characteristics than simply holding SQFT. A time-limited loyalty program period on Shareland. Season 2 ran from late 2025 through May 2026. Future seasons have not been announced. The gain or loss on a position you haven't yet sold. It becomes "realized" when you sell. A temporary pause in trading triggered when Shareland detects suspicious activity or anomalous pricing. Used to protect marketplace health. Your tokens remain in your wallet and are unaffected during a halt. The wallet infrastructure Shareland uses for secure, non-custodial key management. You control your keys. Shareland never holds custody of funds. The Ethereum L2 blockchain Shareland runs on, built by Coinbase. All transactions settle on Base. Shareland's AI agent. Provides market intelligence, real estate analysis, and portfolio strategy. Available as a chatbot on X (Twitter). More capabilities planned as part of Tycoon's product roadmap. The utility token for the Tycoon AI agent. Holders receive discounted fees, early market access, staking allocation, and benefit from a buyback-and-burn mechanism. Available on Virtuals Protocol. The ability to buy or sell tokens quickly without significantly affecting the price. Shareland maintains liquidity through its market infrastructure. The protocol enabling agent-to-agent coordination in the Virtuals ecosystem. Tycoon uses ACP to allow other agents to deploy capital into Shareland strategies. # Regulatory & Legal Source: https://docs.share.land/reference/regulatory Important legal information about trading on Shareland. ## Risk Disclosure Trading SQFT tokens involves significant risk. Real estate prices can go down as well as up. You may lose some or all of your funds. Do not trade more than you can afford to lose. ## Nature of SQFT Tokens SQFT tokens are synthetic derivative instruments designed to track the price per square foot of residential real estate in specific neighborhoods. They do not represent ownership of real property, shares in a property, or any security. There is no right of redemption against Shareland or any property owner. ## Restricted Jurisdictions Shareland is **strictly prohibited** for citizens, residents, and persons physically located in any **Restricted Jurisdiction** as defined in our [Terms of Service](https://share.land/terms) (v1.2, effective June 30, 2026). That page is the authoritative list of blocked countries and regions. Use of a VPN or other circumvention tool to bypass geofencing is a violation of our Terms of Service and subjects you to full indemnification liability. ## No Investment Advice Nothing on the Shareland exchange or in this documentation constitutes investment advice. Tycoon AI is a data visualization tool for entertainment only and does not provide financial advice or execute transactions on your behalf. ## Regulatory Pathway Shareland operates as a non-custodial software interface. SQFT tokens are synthetic derivatives, not securities, and Shareland is pursuing regulatory clarity under the **CFTC** (Commodity Futures Trading Commission) framework, following pathways established by Polymarket and Kalshi. ## Terms of Service Full legal terms: [Terms of Service on share.land](https://share.land/terms) (v1.2, effective June 30, 2026). Shareland, Inc. is incorporated in Delaware.