Platform overview

Understand Timu price markets and how the app fits together.

Price markets

Timu brings price views onchain. This documentation covers its price markets. A price market is a perpetual long/short prediction market: you deposit collateral, choose a direction and leverage, and the position value changes with oracle price and pool state. The related pages cover trading, liquidity, staking, and risk; feature availability depends on deployment.

Design principles

  • No centralized order book: users trade against onchain market contracts and shared liquidity.
  • Onchain by default: positions, liquidity, settlement, and key market state live in smart contracts.
  • Open market creation: supported deployments can let users create new price markets from the app.
  • 24/7 trading: active markets can be traded at any time while the chain, market, oracle, and settlement state allow it. A market bound to an external trading schedule (such as a stock index) blocks new risk outside its trading hours. The schedule itself does not block closing or risk-reducing actions, but actions that read the oracle can still fail when the price is unavailable.

Main app areas

  • Markets shows price markets with search, categories, and sorting.
  • Portfolio collects active positions, LP exposure, and price-market account data.
  • Create is for creating price markets when the connected environment supports it.
  • Staking is for TACO staking and price-market base-fee discounts where the contracts are deployed.

How data reaches the app

Timu reads from multiple sources. Price markets read pool and oracle data directly from contracts, with Pyth or other oracle sources depending on the market. Some list or historical views may also depend on data services.

If a chain does not have the required contracts or data-service configuration, some screens may be empty or limited even if your wallet is connected.

What this documentation covers

These docs focus on user decisions: how trades work, what liquidity providers own, how settlement happens, and which risks matter before signing transactions. They do not try to be a full smart contract specification.

On this page