Overview
Build on Stargaze Finance with the REST API, the launch contracts and viem.
Stargaze Finance is an Ethereum token launchpad and trading interface. Everything it shows is built from three public layers you can use directly: a read-only JSON API served by the app itself, two permissionless launch contracts (StargazeLaunchFactory and StargazeFairLaunch), and the official Uniswap V2/V3 deployments. This site documents exactly what is implemented in the codebase — nothing more.
- Quickstart guideDeploy the contracts to Sepolia and launch your first token with viem.
- REST APIMarket data, token detail, launches, portfolio and analytics as JSON.
- Smart contractsSignatures, parameters, events and revert conditions for every entry point.
- Data & cachingProviders, cache TTLs, stale-while-error and how unknown values are shown.
What is available
| Layer | What it gives you | Where to start |
|---|---|---|
| REST API | JSON endpoints under /api for market lists, token detail, OHLCV, trades, search, launches, analytics, portfolio, ETH price and $STFI status. GET only, no authentication. | Introduction |
| Launch contracts | createToken (instant launch with a Uniswap V2 pool) and createSale / commit / finalize / claim / refund (uniform-price fair launch). | Contracts reference |
| Uniswap | Quotes through V2 getAmountsOut and V3 QuoterV2, swaps through V2 Router02 and V3 SwapRouter02. | Quote & swap |
Networks
The app supports Ethereum mainnet (chain id 1) and Sepolia (chain id 11155111). Market data from CoinGecko, GeckoTerminal and DexScreener exists for mainnet only; on Sepolia you get on-chain data (balances, ERC-20 metadata, Stargaze launch events) and prices are null.
| Network | Contract | Address | Deploy block |
|---|---|---|---|
| Ethereum 1 | StargazeLaunchFactory | Not deployed yet | — |
| Ethereum 1 | StargazeFairLaunch | Not deployed yet | — |
| Sepolia 11155111 | StargazeLaunchFactory | Not deployed yet | — |
| Sepolia 11155111 | StargazeFairLaunch | Not deployed yet | — |
What is not provided
- No API keys, accounts or authentication for the REST API — and no built-in rate limiting (see Rate limits).
- No WebSocket or streaming endpoints. Poll the REST endpoints; the app itself refetches every 15–60 seconds.
- No published SDK package. The examples import ABIs from
@/lib/web3/abisand addresses from@/lib/config/chainsinside this repository; copy them into your own project if you build outside it.
