Docs · Reference
Public API
Read Etchify data from your own app or bot.
Base URL
https://www.etchify.site/api. All responses are JSON. Amounts in base units are strings; token amounts have 6 decimals, ETH amounts 18.
Endpoints
| Method | Path | Returns |
|---|---|---|
| GET | /api/site | Contracts, curve, fees, live prices and Bitcoin fee rates |
| GET | /api/coins?sort=new|mcap|graduate|complete|active|bitcoin|named|holders|routed&q=&offset=&limit= | Coins with market data, fee route and dev-buy lock |
| GET | /api/coins/{token} | One coin, its Rune and its launch status |
| GET | /api/coins/{token}/candles?interval=60|300|900|3600|14400|86400 | OHLC price (ETH per token) |
| GET | /api/coins/{token}/trades?limit=50 | Recent trades |
| GET | /api/coins/{token}/holders | Holders on Robinhood Chain (and of the Rune on Bitcoin, where available) |
| GET | /api/coins/{token}/fees | Where the creator fee goes, what each wallet received, holder rounds |
| GET | /api/rune-name?name= | Whether a Rune name can be chosen right now |
| GET | /api/coins/{token}/quote?side=buy|sell&amount={base units} | Live quote from the coin's Uniswap v4 pool, fee included |
| GET | /api/bridge/{token} | Bridge state, fee and backing |
| GET | /api/portfolio?wallet={address} | Coins a wallet created (with creator fees) and holds |
Identify coins by token address or Rune ID, never by name or ticker: names repeat.
v1: Runes, stats and activity
For wallets, trackers and bots. Every v1 endpoint is open to any website (CORS), cached for a few seconds, and limited to 120 requests a minute per IP.
| Method | Path | Returns |
|---|---|---|
| GET | /api/v1/runes?sort=new|mcap|volume&limit=&offset= | Every Etchify Rune: price in sats and USD, 24 h change, volume and trades, market cap, liquidity, circulating, Rune ID and name, inscription, the share on Bitcoin |
| GET | /api/v1/runes/{id} | One Rune, by Rune ID (971505:1052), Rune name (with or without •) or token address |
| GET | /api/v1/stats | Runes backed 1:1, volume, trades, traders and bridge transfers, all time and 24 h |
| GET | /api/v1/activity?limit=&token= | The live feed: TRADE, LAUNCH, TO_BITCOIN and TO_ROBINHOOD, with the Robinhood Chain transaction and the Bitcoin txid |
| GET | /api/verify, /api/verify/{token} | The custody report behind Verify custody |
Limits
Reads are cached briefly at the edge. /api/portfolio is limited to 40 requests per minute per IP; over the limit the API answers 429.