femtosElysium · Market data
Token candles
OHLCV of a token in USD through its reference pool, the most liquid one.
GET https://api.femtos.xyz/v1/candles
Parameters
| Param | In | Example or values |
|---|---|---|
layer | query | elysium |
token | query | <token> |
tf | query | 1s, 15s, 1m, 5m, 15m, 1h, 4h, 1d |
limit | query | 48 |
Example
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/candles?layer=elysium&token=<token>&tf=1h&limit=48"Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
market | string | Market (token form: the reference pool / USDC market) |
reference | object | token form, EVM: the reference pool (PoolRef) and its rule |
unit | usd | usdc | token form: what o/h/l/c are in |
candles[] | object | Ascending: {t, o, h, l, c, v, vq, n, vUsd, mcUsd, usd, mcap, …} |
candles[].o | decimal | Open, in the quote (HyperCore: USDC; EVM pools: the quote token; token form: USD) |
candles[].buys | int | token form (EVM): swaps buying the token |
candles[].mcap | object | Same candle as market cap in USD {o,h,l,c} (Elysium, HyperEVM): {o, h, l, c} |
asOf | ms | Time of `height` (HyperCore: ingested head; EVM: indexed head, committed with the candles) |
height | int | Head block of the layer the answer is cut at: every event up to it is counted (HyperCore: ingested head; EVM: indexed head, committed with the candles) |
billing | heavy | heavy over 30 days |
Related: Market data
- Candles GET /v1/candles
OHLCV of one pool in pair price, USD and market cap, ascending, UTC-aligned. - Forming candle WS elysium.candles
The forming candle, pushed once per block where it changes. - Trades GET /v1/trades
Latest swaps of one pool, newest first. - Trades stream WS elysium.trades
The swaps of one pool, one message per block that has some. - Daily token volume GET /v1/volume
USD swap volume of a token per UTC day, both sides of every priced swap. Testnet pool prices. - Token transfers GET /v1/transfers
ERC-20 Transfer events of one token, newest first. - Liquidity events GET /v1/liquidity
Liquidity added to and removed from one pool, newest first. - Swaps by wallet GET /v1/trades
Every swap a wallet sent (or a pool’s, a token’s), newest first, filterable by token, side, size and time. - Transfers by wallet GET /v1/transfers
ERC-20 transfers sent and received by a wallet, newest first, filterable by token, direction, size and time. - Pool detail GET /v1/pools/{address}
One pool: dex, fee, tokens, liquidity in USD, depth, 5m to 24h activity, top LPs. - Transaction GET /v1/tx/{hash}
One transaction: status, gas, decoded transfers, swaps and liquidity, bridge legs and journey. - Token prices GET /v1/prices
USD price of up to 100 tokens in one call, each with its source and provenance. - Price history GET /v1/prices/history
USD closes per unit of up to 25 tokens over a window, or the price of 100 tokens at one time (at=). - Token metadata GET /v1/tokens
Metadata of up to 100 tokens: supply, creator, logo and socials when indexed, family, spam. Also POST with a JSON body. - Token overview GET /v1/tokens/{address}
One token across all its pools: price, FDV, market cap, liquidity, windows, holders, top pools.