Kekr
Documentation

Build, trade and launch with Kekr

Kekr is an onchain agent for Robinhood Chain. This guide covers the product end to end: how accounts work, how the launchpad prices and graduates tokens, how creators earn, and how to integrate through the API and CLI.

Introduction

Kekr turns plain language into onchain actions. Ask it what is trending, how a token is doing, or to buy, sell or launch, and it answers with live data and a ready to sign transaction. Every token launched through Kekr trades on a fair bonding curve and graduates into a permanently locked Uniswap v4 pool.

SurfaceWhat you can do
ChatResearch tokens, quote and place trades, launch tokens and check fees in conversation.
DiscoverBrowse every token on the launchpad by freshness, size or bonding progress.
LaunchFull control launch form for Club members, with socials, fee routing and an initial buy.
TradeOne tap buys across the most active curves.
Creator feesTrack and claim what your tokens have earned.
API and CLIAutomate prompts, launches and market data from your own code.
Non custodial by design
Kekr never holds your funds or your keys. Trades and wallet launches are prepared by Kekr and signed by you. Nothing moves until you confirm it in your wallet.

Quickstart

  1. Sign in. Use email, SMS, X, Farcaster, Telegram or an existing wallet. A secure embedded wallet is created for you if you do not have one.
  2. Fund your wallet. Send a little ETH on Robinhood Chain to the address shown in the account menu. Gas on Robinhood Chain costs a fraction of a cent.
  3. Ask the agent. Try “what is closest to graduating?” or “buy 0.005 ETH of $MCAT”.
  4. Confirm. Review the transaction card and approve it in your wallet.
  5. Launch. Hold 1,000,000 $KEKR to join Club, then launch from chat or the launch form.

Accounts and wallets

Sign in is handled by a dedicated authentication provider. You can use email, SMS, X, Farcaster or Telegram, or connect a wallet you already own. Social and email accounts receive an embedded wallet on Robinhood Chain the first time they sign in.

Your wallet address

Open the account menu at the bottom of the sidebar to copy your address. Use it to deposit ETH or tokens, and as the fee recipient for your launches.

Network

SettingValue
NetworkRobinhood Chain
Chain ID4663
Gas tokenETH
Block timeAbout 100 ms

Club membership

Club is the membership tier for builders on Kekr. There is nothing to buy or renew: membership is read live from your wallet. Hold at least 1,000,000 $KEKR in the wallet you sign in with and you are in.

BenefitEveryoneClub
Launch tokensNoYes, on every channel
Agent messages5 per dayUnlimited
API requests100 per day1,000 per day
Research, trading, wallet and fee toolsYesYes

Balances are rechecked about every 30 seconds. If your balance drops below the threshold, launching locks again until you top back up. See Club for your live status.

The agent

The agent reads live chain data and prepares transactions through a set of tools. It does not guess prices or addresses: if a tool cannot answer, it tells you.

CapabilityExample prompt
Discover tokens“What launched in the last hour?” · “Show the biggest tokens.”
Token research“How is $MCAT doing?” · “Who created this token?”
Quotes“How many $MCAT do I get for 0.01 ETH?”
Trading“Buy $20 of $MCAT.” · “Sell 50% of my $DOG.”
Launching“Launch Moon Cat, ticker MCAT, generate a logo, 2% creator tax.”
Portfolio“What is in my wallet?”
Creator fees“How much can I claim?” · “Claim my fees.”

Attachments

Attach an image with the paperclip button and the agent will use it as the logo for your next launch. PNG, JPEG, GIF and WebP up to 5 MB are supported.

Confirmations

Whenever the agent prepares a transaction, a card appears with a summary and a Confirm button. Read the summary, then approve in your wallet. Multi step actions, such as an approval followed by a sell, are signed in order.

Trading

Before graduation, every token trades against its own bonding curve. The curve is a constant product market with virtual ETH liquidity, so the price rises smoothly as tokens are bought and falls as they are sold. There is always liquidity on the curve.

How a quote is calculated

  • Buys: fees are taken from the ETH you send, then the remainder is priced on the curve.
  • Sells: tokens are priced on the curve first, then fees are taken from the ETH you receive.
  • Slippage: defaults to 3%. If the price moves further than that before your transaction lands, it reverts and you keep your funds.

Anti snipe protection

Buys in the first seconds after a launch pay a steep, rapidly decaying tax that starts near 99%. This removes the advantage of bots buying in the same block as the launch. Creators can buy in the launch transaction itself, which is exempt.

After graduation

Graduated tokens trade in their Uniswap v4 pool. Their prices and market caps on Kekr are read directly from that pool.

Launching a token

Club only
Launching is available to Club members. Hold 1,000,000 $KEKR in your wallet to unlock it.

Token economics

ParameterValue
Total supply1,000,000,000, fixed and not mintable
Sold on the curveAbout 71% of supply
Graduation target4.2 ETH raised on the curve
Launch fee0.0005 ETH, waived for gasless launches
Presale or team allocationNone

Launch options

FieldNotes
Name and tickerUp to 32 characters for the name, 1 to 10 letters or digits for the ticker.
LogoStored on IPFS. PNG, JPEG, GIF or WebP up to 5 MB.
Description and socialsShown on the token page: X, Telegram, website, Discord and Farcaster.
Fee recipientThe wallet that receives the creator share. Defaults to you. Point it at a teammate, a treasury or a splitter contract to share fees.
Creator taxAn extra 0 to 10% on every trade, paid entirely to the fee recipient. Fixed at launch.
BuybacksOptionally route part of the fees into automatic buybacks of your token. Bought tokens vest over five years.
Initial buyBuy in the launch transaction itself, exempt from the anti snipe tax. Wallet launches only.

Launch modes

  • Your wallet: you pay the launch fee and gas, and can include an initial buy.
  • Gasless: Kekr pays the launch and you sign a free message. The fee recipient is still you. Limited per day.

Fees and rewards

FeeRateGoes to
Trading fee1% of every buy and sell70% to the creator, 30% to the protocol
Creator tax0 to 10%, chosen at launch100% to the creator
Anti snipe taxStarts near 99%, gone within secondsProtocol
Launch fee0.0005 ETHProtocol

Fees apply both on the curve and after graduation, so creators keep earning for the life of the token.

Claiming

  1. Open Creator fees with the fee recipient wallet.
  2. Use Sweep and claim on a token to move its accrued fees into escrow and claim them in one flow.
  3. Use Claim ETH to withdraw everything already in escrow.

You can also ask the agent to “claim my fees”.

Graduation

When a curve raises its target, the token graduates. Trading on the curve stops, and the raised ETH plus a reserved slice of supply seed a full range Uniswap v4 position. That position is held by a locker contract permanently, so the liquidity can never be pulled.

  • Graduation is automatic and can be completed by anyone.
  • The pool charges the same 1% fee through a hook, so creator earnings continue.
  • Token pages switch to pool pricing as soon as the pool exists.

Kekr on X

Mention @kekrdotapp on X to research tokens or launch one straight from a post.

  • Research and market questions work the same as in the web app.
  • Launches are gasless. Include a fee recipient address, and attach an image for the logo.
  • Because X accounts have no linked wallet, the fee recipient must be a Club wallet.
  • Trading requires a wallet signature, so it is available in the web app only.
example
@kekrdotapp launch Moon Cat $MCAT, fees to 0x1234...abcd

API overview

The API exposes the agent, gasless launches and read only market data over HTTPS with JSON bodies.

ItemValue
Base URL<your Kekr domain>/api/v1
AuthenticationX-API-Key header, or Authorization: Bearer
KeysAPI keys, created by signing a free message with your wallet
FormatJSON request and response bodies, amounts as strings in wei unless noted
shell
export KEKR_API_KEY=pk_your_key
curl https://your-domain/api/v1/token-launches?limit=5
Keep keys secret
API keys act on behalf of your wallet. Never embed them in client side code or share them publicly. Revoke a key at any time from the API keys page.

Agent API

Prompts run asynchronously. Submit a prompt to receive a job id, then poll the job every couple of seconds until it reaches a final state.

POST/api/v1/agent/promptAPI key
FieldTypeDescription
promptstringRequired. Up to 4,000 characters.
threadIdstringOptional. Continue an earlier conversation.
imageUrlstringOptional. Image to use as a logo for launches.
shell
curl -X POST https://your-domain/api/v1/agent/prompt \
  -H "X-API-Key: $KEKR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"prompt":"what are the top 5 tokens by market cap?"}'

# 202 Accepted
{"success":true,"jobId":"5e0c...","threadId":"9a1f...","status":"pending"}
GET/api/v1/agent/job/{jobId}API key
json
{
  "jobId": "5e0c...",
  "threadId": "9a1f...",
  "status": "completed",
  "prompt": "what are the top 5 tokens by market cap?",
  "response": "Here are the five largest tokens right now...",
  "actions": [],
  "createdAt": 1794390600000,
  "completedAt": 1794390604210
}
StatusMeaning
pendingQueued.
processingThe agent is working.
completedFinished. Read response and actions.
failedFinished with an error. Read error.
cancelledCancelled by you.
POST/api/v1/agent/job/{jobId}/cancelAPI key

Launch API

Launch a token gaslessly. The key owner must be a Club member. The fee recipient defaults to the key owner's wallet.

POST/api/v1/token-launches/deployAPI key
FieldTypeDescription
namestringRequired. Up to 32 characters.
symbolstringRequired. 1 to 10 letters or digits.
imagestringRequired. An https image URL or an ipfs:// URI.
descriptionstringOptional. Up to 500 characters.
feeRecipientaddressOptional. Defaults to the key owner.
creatorTaxBpsnumberOptional. 0 to 1000 (0 to 10%). Defaults to 100.
socialsobjectOptional. twitter, telegram, website, discord, farcaster.
shell
curl -X POST https://your-domain/api/v1/token-launches/deploy \
  -H "X-API-Key: $KEKR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "name": "Moon Cat",
    "symbol": "MCAT",
    "image": "https://example.com/cat.png",
    "creatorTaxBps": 100
  }'

{"success":true,"tokenAddress":"0x...","curveAddress":"0x...","txHash":"0x...","feeRecipient":"0x..."}

Market data API

These endpoints are public and do not require a key.

GET/api/v1/token-launches
QueryDescription
sortlatest (default), mcap, progress, graduated or app
limit1 to 100, default 50
offsetPagination offset
qFilter by name, ticker or address
GET/api/v1/tokens/{address or ticker}

Returns the token with live price, market cap, bonding progress, fees, socials and its most recent trades.

GET/api/v1/quote?token=&side=buy&amount=0.01

Quotes a buy (amount in ETH) or a sell (amount in tokens) without executing it.

GET/api/v1/token-launches/{wallet}/fees

Returns claimable creator fees for a wallet together with an unsigned claim transaction.

LLM Gateway

The LLM Gateway is a model marketplace: one API key for hundreds of models from more than fifty providers, including Anthropic, OpenAI, Google, xAI, Meta, Mistral, Moonshot, Qwen and DeepSeek. It speaks both the OpenAI and the Anthropic API formats, so existing SDKs work by changing the base URL and key. Browse the full catalog with live prices on the LLM Gateway page.

EndpointFormat
POST /api/llm/v1/chat/completionsOpenAI chat completions, streaming supported
POST /api/llm/v1/messagesAnthropic messages, streaming supported
GET /api/llm/v1/modelsPublic model list with prices in USD per 1M tokens

Billing

Usage is billed per token from a prepaid USD balance. Add credits with ETH on Robinhood Chain from the Credits tab. Cached input tokens are billed at the cache rate where a model publishes one.

shell
curl https://your-domain/api/llm/v1/chat/completions \
  -H "Authorization: Bearer $KEKR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5.5","messages":[{"role":"user","content":"Hello!"}]}'

See the Quickstart for SDK examples. The gateway allows 60 requests per minute per key.

Errors and limits

Errors return a JSON body of the form {"error": "message"} with a standard HTTP status.

StatusMeaning
400The request is invalid. Check the fields.
401Missing or invalid API key, or the wallet session could not be verified.
403Not allowed, for example launching without Club membership.
404Token or job not found.
429Daily limit reached. Limits reset at 00:00 UTC.
500 and 503A temporary problem. Retry with backoff.
LimitEveryoneClub
API requests per day1001,000
Agent messages per day5Unlimited
Gasless launches per dayNot available3 per account
Active API keys per wallet1010

CLI

The command line tool wraps the API for scripts and terminals. It ships with the Kekr source code.

shell
# from the repository root
npm install -g ./cli

export KEKR_HOST=https://your-domain
export KEKR_API_KEY=pk_your_key
CommandDescription
kekr launches --sort mcapList tokens by latest, mcap, progress or graduated.
kekr token MCATShow a token by ticker or address.
kekr launch --name "Moon Cat" --symbol MCAT --image ./cat.pngLaunch gaslessly. Uploads local images automatically.
kekr fees 0x...Show claimable fees for a wallet.
kekr prompt "what is trending?"Ask the agent and wait for the answer.

Security

  • Non custodial. Kekr cannot move your funds. Every transaction is signed in your wallet.
  • Simulated first. Launch transactions are simulated against the chain before you are asked to sign.
  • Locked liquidity. Graduated liquidity is held by a locker contract permanently.
  • Fixed supply. Token supply cannot be increased after launch.
  • Verify what you sign. Always check the amounts and the destination shown by your wallet.
Smart contract risk
The launchpad contracts are third party smart contracts. Like all smart contracts they may contain undiscovered bugs. Only commit funds you can afford to lose.

FAQ

Does Kekr hold my keys?

No. Embedded wallets are secured by the authentication provider and only you can authorize transactions.

Why can't I launch?

Launching requires Club membership. Hold 1,000,000 $KEKR in the wallet you sign in with, then refresh the Club page.

Can supply be minted later?

No. Supply is fixed at one billion at launch.

Can liquidity be removed after graduation?

No. The graduated position is locked permanently.

Why did my trade fail?

Usually the price moved beyond your slippage while the transaction was pending. Try again or raise slippage slightly.

Where do my creator fees go?

To the fee recipient chosen at launch. Claim them from the Creator fees page.

Glossary

TermDefinition
Bonding curveA pricing contract that sells tokens at a price set by a formula, so there is always liquidity.
BondedThe share of the graduation target already raised on the curve.
GraduationThe moment a curve fills and liquidity moves to a locked Uniswap v4 pool.
Fee recipientThe wallet that receives the creator share of fees for a token.
Creator taxAn optional extra fee on every trade that goes entirely to the fee recipient.
SlippageThe maximum price movement you accept between quote and execution.
ClubWallets holding at least 1,000,000 $KEKR. Required to launch.