A token's price averaged over time from its indexed swaps, built to be hard to move: one price per block, outliers trimmed, a floor on trading and liquidity. Says thin market instead of a price when there is too little to go on.
This sends a real request to the live engine through your free daily allowance. The reply is exactly what an agent receives.
| Name | Type | What it is |
|---|---|---|
| token * | address | Token contract address. |
| window | enum = 30m | How far back to average. One of: 5m, 30m, 1h, 4h. |
| Ask with | The answer may be | USDG per call |
|---|---|---|
| fresh=live | at most 15 s old | 0.003 |
| fresh=recent | at most 5 min old | 0.0015 |
| fresh=delayed | at most 1 h old | 0.0006 |
| # | Source | State | Answered | Failed | Avg time | Last answer |
|---|---|---|---|---|---|---|
| 1 | index | ok | 14 | 0 | 4 ms | 7m ago |
Quality 100 of 100: availability 100 (100.00% of 14 collections answered in 7 days); speed 100 (4 ms average collection); first source 100 (index answered 14 of 14 times without a fallback).
| Check | Reading | Result |
|---|---|---|
| Trades in the window | 205, at least 12 | met |
| Blocks with trades, after trimming | 194, at least 6 | met |
| Wallets trading | 103, at least 4 | met |
| Traded in the window | $13,296, at least $500 | met |
| Age of the last trade | 7 s, at most 900 s | met |
| Blocks trimmed as outliers | 0 of 194, at most 40% | met |
| Liquidity left in the pool | some remains | met |
{
"feed": "chain.twap",
"params": {
"token": "0x5d992fa5b7da8efde5fd36d24e81097ed6ad4351",
"window": "30m"
},
"data": {
"at": "2026-11-17T20:24:49.000Z",
"atSec": 1794947089,
"evidence": {
"firstBlock": 116838877,
"firstTx": "0x4a93edc2a52aea58193a963625d05ae8161e6459d35fcc609fc9a8edf998ec84",
"lastBlock": 116856208,
"lastTx": "0xe3ccad64033233f527627683723c88c9c31be99ee836cca76619362355494b6e",
"trimmed": []
},
"price": "0.000000018248019473",
"priceUsd": "0.000032714244",
"priceX18": "18248019473",
"quoteAsset": "ETH",
"reasons": [],
"rule": {
"maxAgeSec": 900,
"maxScatterBps": 6000,
"maxTrimmedShare": 0.4,
"minBlocks": 6,
"minCurveReserveUsd": 250,
"minTraders": 4,
"minTrades": 12,
"minVolumeUsd": 500,
"trimBps": 1000,
"windowSec": 1800
},
"stats": {
"blocks": 194,
"blocksTrimmed": 0,
"curveReserveUsd": null,
"lastTradeAgeSec": 7,
"poolLiquidity": "29277002188455996003514",
"traders": 103,
"trades": 205,
"volume": "7.416754266068300785",
"volumeUsd": "13296.42"
},
"symbol": "OBSYN",
"thin": false,
"token": "0x5d992fa5b7da8efde5fd36d24e81097ed6ad4351",
"venue": "pool",
"window": {
"from": "2026-11-17T19:54:56.000Z",
"seconds": 1800,
"to": "2026-11-17T20:24:56.000Z"
}
},
"source": "index",
"collectedAt": 1794947096,
"collectedAtIso": "2026-11-17T20:24:56.000Z",
"proof": {
"engine": "0x0c0e4c7abafb4e4c08dd97e3168209432a38bfb7",
"digest": "0xd9bc6038d8dc9643b2086dec8f57ca69bdfe9e91e4a0c7f2a5c199dcc35231cc",
"signature": "0x1f29100f84ddda1eea901eba67ae07b6fa8d5972d8621b2759c3bdcbf2f8e73d31f64a6cb305f5722f624d117a529bf852faaccbbe22c245618989b8f865e5f11c"
}
}const answer = await specula.get("chain.twap", {"token":"0x5d992fa5b7da8efde5fd36d24e81097ed6ad4351","window":"30m"}); console.log(answer.data, answer.source, answer.meta.price.amount);
curl "https://speculaagents.fun/api/v1/feeds/chain.twap?token=0x5d992fa5b7da8efde5fd36d24e81097ed6ad4351&window=30m"How paying works