Lucrios Console Endpoints
Base URL https://data.lucrios.finance. Every request takes your key in x-api-key.
Pools and tokens
Every pool the indexer knows that has traded, with the last 24 hours. Dollar values are strings.
GET /pools Pools with price, 24h change, volume, liquidity, trades, holders and risk marks.
| Parameter | Values |
|---|---|
sort | volume (default), price, change_1h, change_24h, liquidity, trades, holders, holders_change, age |
order | desc (default) or asc |
page, per_page | Paging |
q | Symbol or address |
min_volume_usd, min_liquidity_usd | Minimums, in dollars |
min_holders, min_holders_change | Minimums of holders and their 24h change |
hide | Risk marks to leave out, comma separated: rugged, honeypot, clone, rug_launcher, contract |
{ pools: [...], page, per_page, total }GET /tokens Tokens, each with its main pool. Same filters and sorting as /pools; age is the token's oldest pool.
{ tokens: [...], page, per_page, total }GET /tokens/:address One token: price, 24h stats, holders, contract check, lookalike, honeypot and rug marks, and its 50 most liquid pools. token.pools says how many it has in all.
{ token: {...}, pools: [...] }GET /tokens/:address/pools Every pool the token is in, as base or quote. Paged, with the same filters and sorting as /pools.
| Parameter | Values |
|---|---|
sort, order, page, per_page, min_liquidity_usd, hide, ... | As in /pools |
{ pools: [...], page, per_page, total }Markets
A market is one pool. In the path, :pool takes the pool's pool_address as /pools returns it (the pool contract on Uniswap v2 and v3, the 32-byte pool id on Uniswap v4) or its id. Case does not matter.
GET /markets/:pool/candles OHLC candles, oldest first.
| Parameter | Values |
|---|---|
interval | 1m, 5m, 15m, 30m, 1h, 4h, 6h, 1d |
from, to | Unix seconds; from inclusive, to exclusive |
limit | How many |
fill | true repeats the last close in intervals with no trades |
{ market_id, symbol, interval, candles: [{ open_time, open, high, low, close, volume }] }GET /markets/:pool/flow Buys and sells per interval: counts, volume on each side and the largest of each.
| Parameter | Values |
|---|---|
interval | Default 1h |
limit | How many intervals, latest first, returned oldest first |
{ market_id, symbol, interval, buckets: [{ open_time, buys, sells, buy_volume, sell_volume, largest_buy, largest_sell }] }GET /markets/:pool/swaps Recent swaps, newest first.
| Parameter | Values |
|---|---|
limit | 1 to 200 |
{ market_id, symbol, swaps: [...] }GET /markets/:pool/price The last price and the block it came from.
{ market_id, price, block_number, block_time }GET /markets/:pool/launch The pool since birth: creation, first swap, liquidity adds and removals, early holders and who created it.
{ market_id, pool_created_at, first_swap_at, events: [{ at, kind, base_amount, quote_amount }], holders, created_by }Wallets
Wallets that traded, with their results over a window.
GET /wallets Pro Ranked wallets.
| Parameter | Values |
|---|---|
sort | realized, volume, win_rate, trades or last_trade |
period | 24h, 7d or 30d (default) |
min_closed | Minimum markets with a result (default 3) |
order, page, per_page | Sorting direction and paging |
{ wallets: [{ address, trades, buys, sells, markets, markets_closed, markets_won, volume_usd, realized_usd, avg_hold_seconds, ... }], total, period }GET /wallets/:address Pro One wallet: each market it traded, with what it bought, sold and realized, and its latest trades.
{ wallet: {...}, markets: [...], trades: [...] }Safety
What to check before buying. Checks list findings, never a verdict of safe: they cover the traps seen on this chain so far, not every trap there is.
GET /markets/:pool/check Pro The checks of one pool: who holds the liquidity, the launcher, the creator's record, a bundled launch, a copied name, the contract and whether buyers can sell.
{ market_id, symbol, pool_address, pool_id, verdict: { status, dangers, warnings, unknown }, findings: [{ level, check, text, market_id, address }] }GET /tokens/:address/check Pro The checks of a token: its contract, its own pools (small pools other wallets opened around it are left out and reported), who holds their liquidity, the blacklist, and other tokens with the same name.
{ address, symbol, main_pool_id, pools_checked, verdict, findings: [...] }GET /wallets/:address/check Pro The checks of a wallet: whether it pulled liquidity, whether the wallet that funded it (its first ETH, and who signed that transaction) is on the rug blacklist, which of the pools it created were emptied, and whether the liquidity of its live pools is locked, and in which protocol. If the address is itself a trusted lock contract, lock_contract names it.
{ address, lock_contract, verdict, findings, funders: [{ address, flag }], pools_created, pools: [{ market_id, symbol, liquidity_usd, rugged_at, lock: { status, locked, holder, protocol } }] }GET /liquidity-pulls Pro Liquidity removals across all pools, with the transaction, the dollars removed and whether the pool was drained. Up to 500, oldest first.
| Parameter | Values |
|---|---|
since | Unix seconds; default the last 7 days |
{ pulls: [{ at, market_id, symbol, base_token, removed_usd, quote_amount, drained, tx_hash, pool_created_at }] }