SURGE data feeds
Free, read-only JSON for terminals, trackers and aggregators that want to list AXO SURGE coins on Robinhood Chain. Everything below describes the fields you receive.
Overview
v1- Chain: Robinhood Chain, chain id 4663. Factory (immutable):
0xCF30E0eB529574EC955cAFD72F0E1841Ffe2e4B5. - Feeds are static JSON files served over HTTPS and refreshed about every 20 seconds. They are not a live stream; cache for at least 10 seconds.
- Every feed carries an as-of stamp. Treat a feed older than 120 seconds as delayed and say so to your users. Do not present an old file as live.
- Free to use. A link back to the coin page (
https://axocoin.site/axo-surge.html#t=<token>) is appreciated. - Compatibility: within a schema version (the number at the end of
schema), fields are only ever added, never renamed or removed. Ignore fields you do not know.
Feeds
Base URL: https://vntfznfrdwajuyzddglr.supabase.co/storage/v1/object/public/axo-signal/
axo-surge/board/1.axo-surge/creators/1.axo-surge/token/1.axo-surge/creators-day/1.axo-surge/digest/1.Envelope (every live feed)
| schema | string, axo-surge/<kind>/<version> |
| asOf / asOfIso | unix seconds / ISO time when the file was produced |
| chainId, factory | number, string (address). Check both before using a file. |
| headBlock, indexedBlock | chain head seen, and the last block whose events are included |
| refreshSecs | intended refresh period |
Amounts: fields ending in Eth are decimal numbers in ETH; fields ending in Wei, and token amounts, are decimal strings in base units (18 decimals). Addresses are lower case. Times are unix seconds, UTC.
Board feed fields
tokens[], newest first. totals has tokens and graduated. tape[] is the latest trades across all coins.
| token, name, symbol, image, desc, links{web,x,tg} | coin identity and the creator-supplied metadata (image is an https address; see the image note below) |
| creator, pair, createdAt, createTx | creator wallet, the pool address reserved for the coin, creation time, launch transaction hash |
| status | live, graduating or graduated |
| raisedEth, thresholdEth, pctToGraduation | ETH raised on the curve, the coin's graduation threshold, percent filled (100 once graduated) |
| volume24hEth, volumeTotalEth, trades, uniqueBuyers, lastTradeAt | curve volume only (trades on the bonding curve), trade count, number of distinct buying wallets, time of the latest trade |
| graduated, graduatedAt | graduation flag and time |
| lock | null, or the creator lock: amount, pctSupply, cliffSecs, vestSecs, started, vestStart, cliffAt, vestEnd, claimed |
| creatorFeesEth, creatorFeesWei, feeEvents | creator fees paid to the creator wallet on this coin's trades |
| copycat[] | name or symbol overlaps: {kind: "surge"|"known", by: "symbol"|"name", label}. A warning label only; nothing is blocked. |
Tape entry
| token, symbol, name, side, eth, tokens, trader, ts, tx | side is buy or sell; tokens is a base-unit string |
Creator feed fields
| creators[].creator | wallet address |
| launches, graduated, stillTrading | counts of coins from this wallet on this factory |
| totalRaisedEth, feesEarnedEth | sums over the wallet's coins |
| locksCreated, locksFullyClaimed, firstLaunchAt, tokens[] | creator-lock counts, first launch time, coin addresses |
| latestSnapshot | null, or {day, hash, object, ledgerId}: the most recent daily snapshot of this feed's creator records, and its SHA-256 over the canonical JSON of the published object |
The record covers SURGE history on this factory only. A new wallet shows nothing, which says nothing about the person behind it.
Per-coin feed fields
| token, name, symbol, creator, copycat[] | as in the board feed |
| chart | available, unit (ETH per token), columns (t, open, high, low, close, volumeEth, trades), intervals with 1m, 5m, 1h arrays of candles (oldest first), lastPriceEth, lastTradeAt. Prices are the bonding-curve price after each trade. Minutes without trades have no candle. Curve trades only: after graduation, trading happens on the pool. |
| trades[] | latest 100 curve trades, newest first: ts, side, eth, tokens, priceEth, trader, tx |
| holders | available, holderCount, top[] (address, balance, pctSupply, label), creator{address,balance,pctSupply}, inCurveContract, burnedLp{graduated, amountLp, to, tx} |
| report | the Launch Report, below |
Launch Report (axo-surge/launch-report/1)
| code | status: match, mismatch or unavailable; the deployed code hash and the reference hash. Code facts (noOwner, noMint, noBlacklist, noPause, fixedSupply) are present only when status is match. |
| terms | fee, creator share of the fee, opening-window settings, graduation threshold, as recorded at launch |
| creator | address, lock, holding, surgeRecord, and safe (AXO SAFE history of other tokens from the wallet) |
| opening | opening-window buyers and each top wallet's share of opening buys; funding with the funding sources found for the top wallets and any source shared by several of them |
| graduation | status, pool address, liquidity paired, liquidity tokens burned and the burn address, graduation transaction |
Reading statuses. A section or line may carry status ok, pending, no_data or unavailable. no_data, pending, unavailable and a wallet with no funding source found are all "we do not know", never "clean". Please keep that wording in your product. The report is a set of facts, not a score and not a prediction.
On-chain events
If you prefer to read the chain yourself, these are the factory events (all topics are indexed by token where shown).
Created(address indexed token, address indexed creator, address pair, uint64 createdAt) Metadata(address indexed token, string name, string symbol, string metadataURI) Terms(address indexed token, uint16 feeBps, uint16 creatorFeeBps, uint16 sniperBps, uint32 sniperWindow, uint128 threshold, uint128 sniperSecondCap) Trade(address indexed token, address indexed trader, bool isBuy, uint256 ethAmount, uint256 tokenAmount, uint256 fee, uint256 realEth, uint256 realTok) FeeSplit(address indexed token, bool isBuy, uint256 fee, uint256 creatorAmount, uint256 treasuryAmount) LockCreated(address indexed token, address indexed creator, uint256 amount, uint64 cliffSecs, uint64 vestSecs) LockVestingStarted(address indexed token, uint64 start, uint64 cliff, uint64 end) LockClaimed(address indexed token, address indexed creator, uint256 amount, uint256 totalClaimed) Completed(address indexed token, uint256 realEth) Graduated(address indexed token, address indexed pair, uint256 ethLiquidity, uint256 tokenLiquidity, uint256 lpBurned, uint64 graduatedAt)
metadataURI is data:application/json;base64, followed by JSON with the optional keys d (description), i (image address, https or ipfs), w, t, g (website, X, Telegram). Treat every value as untrusted text.
Each coin is a standard ERC-20 with a fixed supply of 1,000,000,000 (18 decimals). The factory reads: getCurve(token), spotPrice(token), quoteBuy, quoteSell.
Images and content
Image addresses are supplied by coin creators and are not checked or hosted by AXO. If you display them, apply your own content and host checks. On axocoin.site only public https hosts are shown, and every coin page has a Report control.
Daily digest feed
| day, empty, postable | the completed UTC day; empty is true when nothing happened |
| stats | launches, graduations, trades, curveVolumeEth, ethOnLiveCurves, totalCoins |
| closestToGraduation | the live coin with the highest percent filled at the end of that day, or null |
| text | a plain one-line summary of the same numbers |
Back to SURGE. Tokens launched on bonding curves are high-risk. Nothing here is financial advice.