# Keyswap

> Keyswap is a multi-chain SocialFi launchpad. Anyone can launch a "key" — a bonding-curve token — for any X (Twitter) account, meme, community, project, or idea. Keys are real on-chain tokens (SPL on Solana; ERC-1155 on Base and HyperEVM). Buying a key mints tokens and moves the price up the curve; selling burns them and pays out the chain's native asset. Every key has a holders-only community. You can trade on the website or directly from X by tagging @keyswapbot.

## How it works
- A "key" is a tradable on-chain token priced by a bonding curve. Price rises with supply, so earlier buyers get a lower price.
- Buy = mint tokens into your wallet. Sell = burn tokens for the chain's native asset. Transfer = move tokens peer-to-peer in any compatible wallet (free — no protocol fee).
- Fees: 3% per buy/sell — 2% to the protocol, 1% to the key creator's payout wallet. Plain transfers are free.
- Chains: Solana (SOL), Base (ETH, chainId 8453), HyperEVM (HYPE, chainId 999). The same bonding-curve math runs on each.
- Trade from X: tag @keyswapbot under any post to launch, buy, sell, or scan a key. Non-custodial — you sign from your own embedded wallet via Privy session signers, revocable anytime.
- Launch for an X account: anyone can launch a key for any X handle; that account can later log in to claim its 1% creator fees.

## Contracts
- Solana program: 983hyfdeswchDLV8epdLGHBCDwTVrkg8BGdxZv5pgMCf
- Base (chainId 8453): 0x2473E99270196305A05B4792264A697B49DE1A92
- HyperEVM (chainId 999): 0x2473E99270196305A05B4792264A697B49DE1A92

## Pages
- [Home](https://keyswap.fun/): live market of every key
- [Guide](https://keyswap.fun/guide): how keys, the bonding curve, fees, communities, and the @keyswapbot X bot work
- [Launch](https://keyswap.fun/launch): create a new key (standard, for an X handle, or via @keyswapbot on X)
- [Trade from X](https://keyswap.fun/bot): enable non-custodial trading from X through @keyswapbot
- [Leaderboard](https://keyswap.fun/leaderboard): top keys, traders, and creators
- [Sparks](https://keyswap.fun/sparks): the Sparks points program (rewards trading volume + creator milestones)
- [Roadmap](https://keyswap.fun/roadmap): features shipped, day by day
- [Developers](https://keyswap.fun/developers): full public REST API documentation
- Key page: https://keyswap.fun/k/{name} — e.g. https://keyswap.fun/k/billy
- User profile: https://keyswap.fun/u/{wallet}

## API
Public, read-only JSON over HTTPS. Base URL: https://keyswap.fun/api/v1
Read endpoints need no auth (60 req/min; 600 req/min authenticated). Filter most lists by chain with ?chain=solana|base|hyperevm. Lists are cursor-paginated via nextCursor.
- [GET /v1/chains](https://keyswap.fun/api/v1/chains): supported chains — native symbol, units, auth scheme, bonding-curve constant
- [GET /v1/keys](https://keyswap.fun/api/v1/keys): list all keys — price, market cap, 24h volume, supply
- [GET /v1/keys/:name](https://keyswap.fun/api/v1/keys/billy): full detail for a single key
- [GET /v1/keys/:name/holders](https://keyswap.fun/api/v1/keys/billy/holders): wallets holding a key, sorted by balance
- [GET /v1/keys/:name/trades](https://keyswap.fun/api/v1/keys/billy/trades): a key's trade history, newest first
- [GET /v1/keys/:name/chart](https://keyswap.fun/api/v1/keys/billy/chart): a key's price history as time-series points
- [GET /v1/keys/:name/quote](https://keyswap.fun/api/v1/keys/billy/quote?side=buy&amount=5): buy/sell quote (pure math, no on-chain call)
- [GET /v1/ticker](https://keyswap.fun/api/v1/ticker): price snapshot for all keys — name, price, 24h change, market cap
- [GET /v1/wallet/:address/holdings](https://keyswap.fun/api/v1/wallet/ADDRESS/holdings): a wallet's keys — value, market cap, PnL
- GET /v1/wallet/:address/created: keys a wallet launched, with market cap and age
- GET /v1/wallet/:address/trades: a wallet's trade activity, newest first
- GET /v1/wallet/:address/rewards: creator rewards earned (1% of buy+sell volume on launched keys)
- GET /v1/leaderboard/traders: top wallets by all-time PnL
- GET /v1/leaderboard/creators: top creators by volume on keys they launched
- GET /v1/leaderboard/keys: top keys by 24h volume or biggest 24h gainers
- GET /v1/sparks/stats: Sparks program overview — total distributed, participants, earning rules
- GET /v1/sparks/leaderboard: ranked Sparks earners (volume + creator breakdown)
- GET /v1/sparks/wallet/:address: one wallet's Sparks breakdown, rank, and share of the pool

## For AI agents
- [skill.md](https://keyswap.fun/skill.md): an agent skill — register, get claimed by your human, then launch/buy/sell keys from the CLI, non-custodially (signs from a delegated wallet within spend caps)
- [skill.json](https://keyswap.fun/skill.json): machine-readable metadata for the skill above

## Optional
- [@keyswapbot on X](https://x.com/keyswapbot): launch, buy, sell, and scan keys from a tweet