Reef for developers
A free, read-only API for Reef's BDAG pools on BlockDAG chain 1404, and a one-line widget you can put on your own site. Every number is read from the chain and cached for 60 seconds. No key, no sign-up, no tracking.
API
| Endpoint | Returns |
|---|---|
GET /api/v1/pairs | Every BDAG pool on Reef: token, symbol, reserves, pool price in BDAG, FDV and liquidity in BDAG, share of LP locked or burned. |
GET /api/v1/pairs/<id> | One pool, plus 24h volume and number of swaps. <id> is a token address, a pool address, or reef, nocap, cooked. |
curl https://reefdex.fyi/api/v1/pairs/reef
{
"chainId": 1404, "quote": "BDAG",
"pair": "0x1Ea3…182D", "token": "0xb7a1…f416", "symbol": "REEF", "name": "Reef", "decimals": 18,
"reserveBDAG": "34398631.39…", "reserveToken": "156390.07…",
"priceBDAG": 219.95,
"totalSupply": "21000000", "fdvBDAG": "4618950000…", "liquidityBDAG": "68797262.78…",
"lpLockedOrBurnedPct": 99.99, "lpHeldBy": ["REEF presale lock", "dead address"],
"volume24hBDAG": "508564.27…", "swaps24h": 2, "block": 27415171,
"swap": "https://reefdex.fyi/?from=bdag&to=0xb7a1…f416"
}
priceBDAG is the rate in that pool's reserves right now, not a market price feed; a real swap gets a worse rate as it gets larger. fdvBDAG is total supply × priceBDAG, and liquidityBDAG is both sides of the pool valued in BDAG; when FDV is far above liquidity, treat it as a rough guide. Amounts are decimal strings so they don't lose precision. Responses allow any origin (CORS), so you can call them from a browser. Please cache on your side too and don't poll more than once a minute.
Pool widget
Paste this where you want the card. Change t= to your token's address; add &theme=light for light pages.
<iframe src="https://reefdex.fyi/embed/pair/?t=reef" width="420" height="170" style="border:0;max-width:100%" loading="lazy" title="REEF on Reef"></iframe>
Swap links
Link straight to a pre-filled swap: https://reefdex.fyi/?from=bdag&to=<token address>&amount=1000. It only fills in the form; the user checks and signs in their own wallet.
Need more?
Custom integrations, token launches with a locked Reef pool, and contract reviews are available from Undercurrent Works, who built Reef.
Not an endorsement of any token. Reef is unaudited beta software. Contracts: addresses.
