> ## 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.

# Submit a job

> Submits a job that runs a heavy computation with a small result.



## OpenAPI

````yaml /data-api/openapi.json post /v1/jobs
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/jobs:
    post:
      tags:
        - Async jobs
      summary: Submit a job
      description: >-
        Submits a job that runs a heavy computation with a small result.


        **Job kinds**

        - `account_fills_summary` (scope `accounts:read`): per coin, over up to
        90 days for one wallet, the fills, buy and sell notional, fees per fee
        token, realized PnL, and first and last fill. Both legs of self-matches
        count.


        **Limits**

        - Available on Growth plans and above.

        - At most 2 jobs run at a time, and at most 100 per day.

        - Results are kept for 24 hours.


        **Credits:** free.
      operationId: createJob
      parameters:
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            maxLength: 255
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - kind
                - params
              properties:
                kind:
                  type: string
                  enum:
                    - account_fills_summary
                params:
                  type: object
      responses:
        '200':
          description: Idempotent replay
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  kind:
                    type: string
                  params:
                    type: object
                  status:
                    type: string
                    enum:
                      - queued
                      - running
                      - succeeded
                      - failed
                      - canceled
                      - expired
                  created_at:
                    type: string
                  started_at:
                    type:
                      - string
                      - 'null'
                  finished_at:
                    type:
                      - string
                      - 'null'
                  expires_at:
                    type:
                      - string
                      - 'null'
                  result_rows:
                    type:
                      - integer
                      - 'null'
                  compute_units:
                    type: integer
                  result_url:
                    type:
                      - string
                      - 'null'
                  error:
                    type:
                      - object
                      - 'null'
                    properties:
                      code:
                        type: string
                      detail:
                        type: string
        '202':
          description: Queued
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  kind:
                    type: string
                  params:
                    type: object
                  status:
                    type: string
                    enum:
                      - queued
                      - running
                      - succeeded
                      - failed
                      - canceled
                      - expired
                  created_at:
                    type: string
                  started_at:
                    type:
                      - string
                      - 'null'
                  finished_at:
                    type:
                      - string
                      - 'null'
                  expires_at:
                    type:
                      - string
                      - 'null'
                  result_rows:
                    type:
                      - integer
                      - 'null'
                  compute_units:
                    type: integer
                  result_url:
                    type:
                      - string
                      - 'null'
                  error:
                    type:
                      - object
                      - 'null'
                    properties:
                      code:
                        type: string
                      detail:
                        type: string
        '400':
          description: Invalid kind or params
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Scope, plan or history limit
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Idempotency-Key reused with a different request
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Job limit
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - bearer: []
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.