twap

Time-weighted average price over a window.

Rolling time-weighted average price per window, native and USD, with the running accumulators behind it.

Try it

Connect your wallet to send this request against the live API and see the response inline.

Parameters

baseoptional

string

Filter to a base token mint (base58). Omit to return every pair on the market.

quoteoptional

string

Filter to a quote token mint (base58).

windowrequired

enum

Aggregation window. One of: 1s, 10s, 30s, 1m, 5m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 24h.

limitoptional

integer

Maximum data points (1-1000, default 100). Query only; ignored when streaming.

Parameter	Type	Required	Description
base	string	optional	Filter to a base token mint (base58). Omit to return every pair on the market.
quote	string	optional	Filter to a quote token mint (base58).
window	enum	required	Aggregation window. One of: 1s, 10s, 30s, 1m, 5m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 24h.
limit	integer	optional	Maximum data points (1-1000, default 100). Query only; ignored when streaming.

Request

Transport

curl -X POST https://rpc.raptor.trade \
  -H "Authorization: Bearer $RAPTOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "solana::market::twap",
  "params": {
    "base": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "window": "1h"
  }
}'

Response

Responses are always a JSON array - one entry per request - and each entry's result holds the array of data. The shape is identical over HTTP and WebSocket.

[
  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": [
      {
        "id": 1024,
        "base": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "quote": "So11111111111111111111111111111111111111112",
        "timestamp": "2026-06-01T02:16:22.000000000Z",
        "slot": "37",
        "window_duration": "PT1H",
        "twap": "0.00001942",
        "twap_usd": "0.000019",
        "current_price": "0.00001942",
        "current_price_usd": "0.000019",
        "cumulative_weighted_sum": "0.00001942",
        "cumulative_weighted_sum_usd": "0.000019",
        "total_duration": "PT57S",
        "data_points": "37",
        "window_start": "2026-06-01T02:16:22.000000000Z",
        "window_end": "2026-06-01T02:16:22.000000000Z"
      }
    ]
  }
]

Fields

Numbers come back as strings and timestamps as ISO-8601 strings; every data point carries a stable id. See Data model.

baseUtf8

Base token mint.

quoteUtf8

Quote token mint.

timestampDateTime

Last update time.

slotUint8

Slot of the last update.

window_durationDuration

Window length, e.g. 1h.

twapFloat8

Time-weighted average price.

twap_usdFloat8

TWAP in USD.

current_priceFloat8

Latest price.

current_price_usdFloat8

Latest price in USD.

cumulative_weighted_sumFloat8

Running price-by-time sum.

cumulative_weighted_sum_usdFloat8

USD price-by-time sum.

total_durationDuration

Time span covered by the window.

data_pointsUint4

Samples folded in.

window_startDateTime

Window start.

window_endDateTime

Window end.

Field	Type	Description
base	Utf8	Base token mint.
quote	Utf8	Quote token mint.
timestamp	DateTime	Last update time.
slot	Uint8	Slot of the last update.
window_duration	Duration	Window length, e.g. 1h.
twap	Float8	Time-weighted average price.
twap_usd	Float8	TWAP in USD.
current_price	Float8	Latest price.
current_price_usd	Float8	Latest price in USD.
cumulative_weighted_sum	Float8	Running price-by-time sum.
cumulative_weighted_sum_usd	Float8	USD price-by-time sum.
total_duration	Duration	Time span covered by the window.
data_points	Uint4	Samples folded in.
window_start	DateTime	Window start.
window_end	DateTime	Window end.

Errors

Invalid parameters return -32602; an unknown method returns -32601. See Errors for the full table.

Previousblock Nextvwap