Paste the address of any Robinhood Chain token and Quoro reads it from the chain: who launched it, who bought in the
first blocks, what the creator still holds, who funded the top holders. Every launch gets a Data score from 1 to 10,
and Quoro AI explains it in plain words, each sentence linked to the place on the block explorer where you can
check it. Then you buy with ETH, BNB or POL from any of 17 chains, or straight on the token's own curve or pool, and the
token lands in your own wallet. Quoro holds no funds and has no contract of its own: you sign every transaction.
This repository is the product as it runs at quoro.exchange: the site, the API server, the
launch-data engine, the Chrome extension and both bots. It is public so anyone can check how a score is counted and
what a page asks a wallet to sign.
What you get
- Data score 1–10 for every launch on Robinhood Chain launchpads, counted by published rules from public chain data.
- Quoro AI read. A one-line take the moment a token opens, and on request a full read where each sentence carries
numbered links to the explorer: the launch transaction, the creator, holders, trades, a shared funder, the curve.
- Who is behind the top holders. For the 10 largest holder wallets: groups funded from the same address, wallets
funded by the creator, wallets that got their first ETH within a day of the launch. Plus every other token the
creator launched and how many reached a pool.
- Buy from 17 chains in one signature with the chain's own coin, or directly on the token's curve or pool on
Robinhood Chain with no route fee. Works for launches and the 64 stock tokens. Sell to any of the 17 chains.
- Explore every launch live, a token page with the chart's full history (MA 20, EMA 50, VWAP), top 10 holders
and buy/sell flow, Portfolio, Watchlist, Points and Ask Quoro for questions about a token.
- Quoro Lens for Chrome: Data score labels next to Robinhood Chain token addresses in X posts and bios.
- @QuoroScoreBot on Telegram and @QuoroAI on X: send an address, get the score.
- A free read-only API: no key, no sign-up, callable from any site.
What's inside
| Folder | What it is |
|---|
server/ | server.py: the site, the public API, the Data score, Quoro AI, quotes from LI.FI, Relay and the direct route, holder insight, Points. Python standard library plus Pillow, on http.server. |
engine/ | The launch-data engine (FastAPI): indexes every launch on Robinhood Chain launchpads, reads curves and pools, runs the launch checks, builds candles and direct trade quotes. Listens on 127.0.0.1 only. |
site/ | The front end: vanilla JS, no framework. js/wallet.js holds the checks every transaction passes before the wallet sees it. Charts by TradingView Lightweight Charts (license in site/vendor/). |
privy/ | Source of the wallet-connection bundle (site/js/privy.js), built with esbuild. Wallet connect only: no email login, no embedded wallets. |
lens/ | Quoro Lens, the Chrome extension (Manifest V3). |
tgbot/ | @QuoroScoreBot for Telegram: score card image, flags and the AI read in one message. |
bot/ | @QuoroAI, the X reply account: tag it with an address, it replies with the score. |
|
How the Data score works
Data score = round(0.6 × Launch + 0.4 × Market), then the lowest cap that applies
- Launch, 0–10: how the token was set up. Starts at 10; findings take points off (wallets exempt from the opening
tax, snipers in the first blocks, a deployer whose earlier launches never reached a pool, a deployer who sold on this
curve, creator tax above 3%, no socials and more), two facts add a point back.
- Market, 0–10: how it trades now. Buyers (up to 4), how full the curve is (up to 3), the last trade (up to 2),
smart wallets (up to 1).
- Caps: a serious finding or the creator holding over 10% caps the score at 5; over 25% at 3; no trades for 24 hours
at 4; under 10 minutes old at 7; an incomplete chain read at 8.
Rules, not a model: the same facts always give the same number. Quoro AI only explains the number from the same facts;
it never sets it. Stock tokens and other tokens get no score. The score describes the launch and how it
trades, not the future price, and it is not financial advice.
Every rule, threshold and API field: docs/DATA-SCORE.md. Code: score() in
server/server.py, hygiene() in engine/score.py, the chain read in engine/check.py.
Non-custodial by design
There is no Quoro contract between you and a trade, and no Quoro key that can move your money. The server prices a
route and returns the transaction; your own wallet (connected through Privy) signs and sends it. Two layers check
every step first:
- The server keeps only routes through LI.FI's and Relay's own contracts on each chain, built for your address, on
the chain you pay from, sending no more than the amount you entered. A direct buy must call the token's own curve or
the v4 UniversalRouter.
- The page (
site/js/wallet.js) re-checks every step before the wallet sees the first one, and refuses the whole
trade if any step fails:
- the contract is on the per-chain allowlist of LI.FI and Relay contracts;
- an approval is for exactly the amount you sell, only to the contract that then takes the tokens;
- the value sent is never above the amount you entered, and a sale is signed only on Robinhood Chain;
- a direct pool buy is decoded: one V4 swap, ETH in, this token out of its own launchpad pool, taken by you, with a
minimum no looser than your slippage;
- a direct curve buy goes only to the curve that the launchpad's own registry names, read through your wallet's
connection, not from our server;
- the quote matches what the page shows: token, side, amount, chain and slippage.
What this does not cover, and how to report a problem: SECURITY.md.
Public API
Read-only JSON, no key, open to any origin (access-control-allow-origin: *). Base URL https://quoro.exchange.
# a token: facts, Data score, the flags and caps behind it (60 requests a minute)
curl https://quoro.exchange/api/token/0x44082d239727b12a5a3b3edf147b3c7bea80332c
# scored launches: trending, recent or all
curl "https://quoro.exchange/api/launches?sort=trending&limit=10"
# chain numbers: block, new tokens in 24 hours, how many tracked launches are flagged
curl https://quoro.exchange/api/pulse
An answer, trimmed:
{ "kind": "launch", "symbol": "QRO", "curvePct": 100.0, "graduated": true,
"facts": { "buyers": 117, "devPct": 0.02, "snipersPct": 0.0, "taxExempt": 0, "creatorTaxBps": 250 },
"score": { "value": 8, "hygiene": 10, "market": 8, "raw": 9.2, "partial": true, "flags": [], "credits": ["burned"] } }
Every field, error code and limit: docs/API.md. If you show a score, call it the Data score from
Quoro.
Architecture
flowchart LR
web["Browser<br/>quoro.exchange"]
lens["Quoro Lens<br/>Chrome, x.com"]
tg["@QuoroScoreBot<br/>Telegram"]
xbot["@QuoroAI<br/>X replies"]
server["server/server.py<br/>site, API, score, AI, quotes"]
engine["engine/<br/>launch-data engine<br/>127.0.0.1:8767"]
rpc[("Robinhood Chain<br/>RPC + WebSocket")]
lifi["LI.FI"]
relay["Relay"]
llm["OpenRouter"]
wallet["Your wallet<br/>via Privy"]
web --> server
lens --> server
tg --> server
xbot --> server
server --> engine
engine --> rpc
server --> rpc
server --> lifi
server --> relay
server --> llm
web -.->|"signs every transaction"| wallet
The browser never talks to LI.FI, Relay or OpenRouter directly; the server does, and the page checks what comes back.
The wallet sends each signed transaction to its own chain. More: docs/ARCHITECTURE.md.
Run it yourself
git clone https://github.com/QuoroExchange/quoro && cd quoro
python3 -m venv .venv && .venv/bin/pip install -r engine/requirements.txt
./start.sh # engine on 127.0.0.1:8767, site and API on http://127.0.0.1:8795
# with wallet connect and Quoro AI
PRIVY_APP_ID=… OPENROUTER_API_KEY=… ./start.sh
Nothing is required to start: without keys the site reads and scores tokens, and the parts that need a key (wallet
connect, Quoro AI, the holder funding read) stay off. The engine's seed data (smart-wallet, launch-farm and creator
records) is not in this repository; the engine runs without it, and those counts start at zero and build up from the
chain. Variables, the bots, Docker and Fly.io: docs/SELF-HOST.md.
Links
Quoro is an independent app built on Robinhood Chain. Routes run through LI.FI and
Relay; Quoro AI runs on models through OpenRouter.
Disclaimer
Quoro shows data and quotes and returns transactions for you to sign. The Data score and the AI read are readings of
public on-chain data at the time shown, not advice and not a price prediction. New tokens are risky and can lose all of
their value. A signed transaction can't be reversed, by you or by Quoro. Stock tokens are not available to persons in the
United States and are restricted in Canada, the United Kingdom, Switzerland and other countries: check the rules where
you live before you buy.
License
MIT. TradingView Lightweight Charts is © TradingView, Inc., under the Apache License 2.0
(site/vendor/LIGHTWEIGHT-CHARTS-LICENSE.txt).
