Skip to content
Corious

Documentation

How Corious reads the market, what each number means, and where coverage ends. Developer setup lives in the repository README.

Using Corious

  • Terminal: pick a chain, search by name, symbol or address, filter by liquidity, volume, age and price change, and star tokens to keep a local watchlist.
  • Token page: market summary, pool selector, candlestick chart with gaps shown as gaps, recent swaps, verified contract fields next to provider-reported ones, and a swap panel where supported.
  • Wallet Watch: inspect any public address, save it with a nickname, page through history with the inspected range and limits on screen.
  • Fee Inspector: itemized costs of a transaction hash, or a fee summary over a wallet's recent history, with CSV export.
  • Portfolio: balances and current value for a connected wallet or a public address, with explicit coverage.
  • Settings: default chain, motion, polling, slippage, local data export/import, and the full capability matrix.

Every figure carries a source and an update time. Missing values show as “—”, never as zero. Every screen in the observation room paints provider or on-chain data with its read time, and says “waiting” or “unavailable” when there is none.

Sources and coverage

DataRobinhood ChainSolanaBNB ChainNEAR
Token search, pairs, pricesDexScreener (key-free)
Pool lists, OHLCV, recent swapsGeckoTerminal (key-free, ~30 requests/min shared; Corious paces requests and serves the last good read when throttled)
Wallet historyBlockscout APIPublic RPC (signatures + parsed transactions)Etherscan API v2 (key required)NearBlocks API (key optional)
BalancesBlockscout + RPCRPC token accountsRPC + Etherscan transfer history (key) or watchlist tokensRPC + FastNear token list
Historical USD for feesBlockscout historic rate, else DefiLlamaDefiLlama coins API (CoinGecko ids), within 4 h of the block
Swap routingKyberSwap AggregatorJupiter lite APIKyberSwap AggregatorNot integrated

Identity is verified on-chain where possible (ERC-20 metadata, Solana mint accounts, NEAR ft_metadata) and shown separately from provider-reported names. Public pool lists contain look-alike tokens; the contract address is the only identity Corious trusts. The live matrix is on the settings page.

Launch lifecycle

Launch-stage columns (New / Almost bonded / Migrated) are enabled only where a verified launchpad is indexed. On Robinhood Chain, Corious reads the Pons V2 launch factory (Sourcify exact match) and each curve's state: graduated() decides “Migrated”, realQuoteReserve() / graduationThreshold() decides “Almost bonded” (≥ 70%), and the curve's launchedAt decides “New” (≤ 24 h). Coverage is limited to curves launched or traded inside the scanned block windows shown on the page. Nothing is inferred from market cap or age alone. Other chains show a standard market table and say so.

Fee methodology

Each cost component has a status:

  • decoded — computed from receipt fields or events of verified contracts (gas × effective gas price; KyberSwap router Fee events; Uniswap v3-style pool fees from the pool's fee() tier and the Swap event input amount; Solana meta.fee; NEAR tokens burnt summed across receipts).
  • estimated — derived with a documented approximation. Corious currently uses none; the slot exists for future components.
  • unknown — not decodable with evidence (hook fees, bonding-curve fees, RFQ fills, transfer taxes, Solana platform fees, rent deposits).
  • not applicable — the component cannot exist in this transaction (for example no router fee event in a router swap).

Components already included in another figure (the L1 data share of an L2 gas fee, Solana base/priority split, pool fees embedded in the swap price) are marked “included in” and never added to the total. Price impact and slippage are not fees and are not counted. Unexplained balance differences are never attributed to a tax. USD uses a historical rate at the transaction time or stays blank; today's price is never substituted. Wallet summaries state how many transactions were inspected, their time range and the pagination limit.

Portfolio and P&L

Portfolio shows balances, a current USD price per asset where a reliable one exists, the value of priced assets, and allocation among priced assets. Unpriced assets are listed explicitly. Coverage is “full”, “partial” or “native only” depending on what the providers returned. P&L requires a complete acquisition history with cost basis; transfers, airdrops and trades outside indexed venues make that incomplete, so Corious reports “P&L unavailable” instead of assuming a zero cost basis.

Trading and limitations

  • EVM swaps (Robinhood Chain, BNB Chain) route through the KyberSwap MetaAggregationRouterV2 at the pinned address 0x6131B5fae19EA4f9D964eAc0408E4408b66337b5. Before your wallet is asked to sign, Corious decodes the calldata and checks the sell token, buy token, receiver, amount, minimum received, flags, permits and fee lines, then simulates from your account and estimates gas.
  • Token approvals are for the exact sell amount. Native sales carry the exact value and no more.
  • Solana swaps are built by Jupiter and simulated on the RPC; your Wallet Standard wallet signs and sends the transaction.
  • NEAR has no routing integration in this release; the capability matrix says so.
  • Quotes expire after 20–30 seconds. Expired quotes are refreshed, never signed. A route whose output moved more than 1% between quote and build is refused.
  • Corious adds no integrator fee. Provider or pool fees embedded in a route are shown in the quote.
  • Corious never asks for a seed phrase or private key and never sends wallet secrets anywhere. Nothing is custodial.
  • No mainnet transaction was submitted during development; the execution path was exercised with a stub wallet and live quotes. See the README integration matrix for exactly what was live-tested.

Alerts and local data

Price and wallet-activity alerts run only while Corious is open in your browser, polling the same providers as the pages. Events are de-duplicated per rule; notifications are requested only after you click “Enable browser notifications”. Watchlists, tracked wallets, preferences and alert rules are versioned JSON in localStorage with import/export on the settings page. No account, no server-side storage, no keys.

Token and X

The project token is $CORIOUS on Robinhood Chain. Contract address: soon. It has not been published yet.

The only official channel is @CoriousRH on X. The address shown in the site header, the footer and this page updates the moment it is published; an address that appears anywhere else first is not Corious. Corious never sells tokens, never asks for a wallet secret and adds no integrator fee to swaps.