> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperdash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Active spot TWAPs

> Every running or trigger-waiting TWAP order on one spot token's pairs, largest first, from the latest node state snapshot.



## OpenAPI

````yaml /data-api/openapi.json get /v1/spot/{token}/twaps
openapi: 3.1.0
info:
  title: Hyperdash Data API
  version: v1
  description: >-
    Hyperliquid data from Hyperdash's own nodes and stored datasets; requests
    never call Hyperliquid's public API. Every response reports the credits it
    cost.
servers:
  - url: https://data.hyperdash.com
security: []
tags:
  - name: Accounts
  - name: Async jobs
  - name: Builders
  - name: Cohorts
  - name: HIP-3 dexes
  - name: Leaderboards
  - name: Lending
  - name: Liquidations
  - name: Markets
  - name: 'Markets: analytics'
  - name: 'Markets: funding'
  - name: 'Markets: liquidation and stop levels'
  - name: 'Markets: open interest and positioning'
  - name: 'Markets: order book'
  - name: 'Markets: prices and candles'
  - name: 'Markets: queue priority'
  - name: 'Markets: trades and flow'
  - name: 'Markets: TWAPs'
  - name: Network
  - name: Outcomes
  - name: Positions
  - name: Referrals
  - name: Snapshots
  - name: Spot
  - name: Staking
  - name: Traders
  - name: Vaults
paths:
  /v1/spot/{token}/twaps:
    get:
      tags:
        - Spot
      summary: Active spot TWAPs
      description: >-
        Every running or trigger-waiting TWAP order on one spot token's pairs,
        largest first, from the latest node state snapshot. Each row has the
        wallet, pair, side, total, executed and remaining size, executed
        notional, progress, duration and next slice.


        **Coverage**

        - Rows come from the latest node state snapshot, identified by
        `meta.snapshot_id`.

        - The snapshot is cut from the node state every 10,000 blocks, about
        every 12 minutes, and published about 3 minutes later, so it is 3 to 15
        minutes old.

        - `meta.snapshot_time` is its block time in epoch ms, or `null` when
        unknown, when there is no running TWAP to date it by.
        `meta.snapshot_time_estimated` is true when that time is derived from
        its TWAPs' next slices, accurate to within 15 seconds.

        - TWAPs started, ended or terminated since the snapshot are not
        reflected.


        **Limits**

        - A response has at most 100 rows, and no more than your plan's
        wallet-list cap.


        **Credits:** 10 per request + 1 per row + 5 per node read.


        **Scope:** `analytics:read`
      operationId: listSpotTwaps
      parameters:
        - name: token
          in: path
          required: true
          description: Spot token name, for example `HYPE` or `PURR`.
          schema:
            type: string
      responses:
        '200':
          description: OK
          headers:
            X-Credits-Charged:
              schema:
                type: integer
            X-Credit-Price-Version:
              schema:
                type: integer
            X-Request-Id:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - has_more
                  - next_cursor
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                          description: Wallet running the TWAP.
                        twap_id:
                          type: string
                          description: TWAP id, as a 64-bit decimal string.
                        pair:
                          type:
                            - string
                            - 'null'
                          description: Spot pair, for example `HYPE/USDC`.
                        pair_id:
                          type:
                            - string
                            - 'null'
                          description: Spot pair id, for example `@107`.
                        side:
                          type: string
                          description: '`buy` or `sell`.'
                        total_sz:
                          type: string
                          description: Total size, in base units. Decimal string.
                        executed_sz:
                          type: string
                          description: Executed size. Decimal string.
                        remaining_sz:
                          type: string
                          description: Remaining size. Decimal string.
                        executed_notional:
                          type: string
                          description: Executed notional, in quote units. Decimal string.
                        progress_pct:
                          type: string
                          description: Progress, from 0 to 100. Decimal string.
                        duration_s:
                          type: integer
                          description: Duration, in seconds.
                        start_time:
                          type: integer
                          description: Start, in epoch milliseconds.
                        reduce_only:
                          type: boolean
                          description: Reduce-only.
                        randomize:
                          type: boolean
                          description: Randomized slices.
                        next_slice_time:
                          type:
                            - string
                            - 'null'
                          description: Next slice time, as an ISO 8601 timestamp.
                        slices_done:
                          type: integer
                          description: Slices executed.
                        waiting:
                          type: boolean
                          description: Waiting for its trigger.
                        stop_px:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Stop price. A buy TWAP stops once the price reaches
                            it from below, and a sell TWAP once the price
                            reaches it from above. HL announced on 2026-10-29
                            that it will pause there instead and resume when the
                            price comes back. Decimal string.
                        trigger_px:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Trigger price of a TWAP waiting to start. Decimal
                            string.
                        trigger_above:
                          type:
                            - boolean
                            - 'null'
                          description: >-
                            `true` when it starts once the price rises above
                            `trigger_px`, `false` when it starts once the price
                            falls below it.
                    description: Result rows.
                  has_more:
                    type: boolean
                    description: '`true` when another page follows.'
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Cursor for the next page, passed as `cursor`. `null` on
                      the last page.
                  meta:
                    type: object
                    description: >-
                      Response metadata. Its keys depend on the endpoint and are
                      described above.
        '400':
          description: 'Invalid parameter (also: a request body that is not valid JSON)'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '401':
          description: Invalid, expired or revoked key
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Scope, plan, history or credit limit
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Price version changed, or a cursor's snapshot expired
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: >-
            Rate limited (Retry-After; free): request rate, concurrent requests
            (a request counts one slot per 1,000 rows it can return), or this
            server busy with your workspace's requests
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Upstream data source failed (free; retry later)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Backend at capacity or temporarily unavailable (Retry-After)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '504':
          description: Upstream data source timed out (free; retry later)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - bearer: []
      x-codeSamples:
        - lang: curl
          source: >-
            curl -H "Authorization: Bearer $HYPERDASH_API_KEY"
            'https://data.hyperdash.com/v1/spot/HYPE/twaps'
components:
  schemas:
    Problem:
      type: object
      required:
        - type
        - title
        - status
        - code
        - request_id
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        code:
          type: string
        detail:
          type: string
        hint:
          type: string
        request_id:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: Your API key, sent as `Bearer hdk_sk_live_v1_…`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.