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

# Minute rounds

> Minute rounds of the last 48 hours, newest first. A round that is still open is dated by its open time. A page holds at most 100 rounds.



## OpenAPI

````yaml /openapi/data-api.json get /v0/minute/rounds
openapi: 3.1.0
info:
  title: Rekt data API
  version: '0'
  summary: Read-only HTTP API for settled trades and ended positions.
  description: >-
    `https://data.rekt.trading` serves settled trades and ended positions. It is
    read-only and it needs no account. It sets no cookies and accepts no
    credentials. Responses carry `Access-Control-Allow-Origin: *`. Start at `GET
    /v0/health`.


    The program is the ground of truth. This API is a lagging mirror of it. Read
    live state from the chain through the SDK.


    Rules:


    - Every route answers `GET`, `HEAD` and `OPTIONS`. Any other method gets
    `405`.

    - A request URL is at most 2,048 characters. A longer one gets `414`.

    - Requests are rate-limited for each client address. `GET /v0/health` states
    the limit under `access`. A request over it gets `429` and a `Retry-After`
    header. Wait that long, then retry.

    - This API ignores a parameter that it does not know. A filter that this API
    refuses gets `400`.

    - Money amounts are decimal strings of base units of USDC (6 decimals).
    Addresses are 64 hex characters unless a field says base58. Transaction
    signatures are base58.

    - A response can hold fields that this description does not list. Ignore a
    field that you do not know.
servers:
  - url: https://data.rekt.trading
    description: The data API.
security: []
tags:
  - name: Health
    description: Freshness and limits.
  - name: Aggregates
    description: All-time totals and day series.
  - name: Trades
    description: Settled trades of the last 48 hours.
  - name: Positions
    description: Ended positions of the last 48 hours.
  - name: Minute
    description: Minute rounds of the last 48 hours.
paths:
  /v0/minute/rounds:
    get:
      tags:
        - Minute
      summary: Minute rounds
      description: >-
        Minute rounds of the last 48 hours, newest first. A round that is still
        open is dated by its open time. A page holds at most 100 rounds.
      operationId: listMinuteRounds
      parameters:
        - $ref: '#/components/parameters/owner'
        - $ref: '#/components/parameters/limit100'
      responses:
        '200':
          description: A page of Minute rounds.
          headers:
            Cache-Control:
              description: '`public, max-age=5`.'
              schema:
                type: string
            Warning:
              description: >-
                Present only when `asOf.stale` is true. It states that the
                archive is stale.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MinuteRoundsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '414':
          $ref: '#/components/responses/UriTooLong'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  parameters:
    owner:
      name: owner
      in: query
      required: false
      description: >-
        Return only the rows of this wallet. Give the wallet as base58 or as 64
        hex characters. Any other value matches nothing: the page is empty and
        `filters.owner` repeats the value.
      schema:
        type: string
    limit100:
      name: limit
      in: query
      required: false
      description: >-
        The number of rounds in the page. The server reads a value above 100 as
        100.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 100
  schemas:
    MinuteRoundsResponse:
      type: object
      description: A page of Minute rounds, newest first.
      properties:
        asOf:
          $ref: '#/components/schemas/AsOf'
        tier:
          type: string
          description: >-
            The access tier that answered. It is `public` for a caller without a
            key.
          enum:
            - public
        window:
          $ref: '#/components/schemas/Window'
        units:
          type: string
          description: The units of the money and price fields, in words.
        filters:
          type: object
          description: The filters of this request, as sent.
          properties:
            owner:
              type:
                - string
                - 'null'
              description: The `owner` filter. Null when it was not sent.
            limit:
              type: integer
              description: 'The page size that applied. Unit: rounds.'
        matched:
          type: integer
          description: >-
            The number of rounds in the window that match the filters. Unit:
            rounds.
        sampleSize:
          type: integer
          description: 'The number of rounds in this page. Unit: rounds.'
        totalInArchive:
          type: integer
          description: 'The number of rounds in the archive, for all time. Unit: rounds.'
        summary:
          type: object
          description: Round counts and volume, for all time.
          properties:
            rounds:
              type: integer
              description: 'The number of rounds. Unit: rounds.'
            live:
              type: integer
              description: 'The number of live rounds. Unit: rounds.'
            settled:
              type: integer
              description: 'The number of settled rounds. Unit: rounds.'
            reconciled:
              type: integer
              description: 'The number of reconciled rounds. Unit: rounds.'
            voided:
              type: integer
              description: >-
                The number of rounds whose order the venue returned. Unit:
                rounds.
            grossVolume:
              type: string
              pattern: ^[0-9]+$
              description: >-
                The gross amount committed over all rounds, less the orders that
                the venue returned. Unit: base units of USDC (6 decimals), as a
                decimal string.
        rounds:
          type: array
          description: The rounds, newest first.
          items:
            $ref: '#/components/schemas/RoundRow'
      required:
        - asOf
        - tier
        - window
        - filters
        - matched
        - sampleSize
        - totalInArchive
        - rounds
    AsOf:
      type: object
      description: How fresh the archive is at the time of this response.
      properties:
        generatedAt:
          type: string
          description: The time the server made this response, in UTC (ISO 8601).
          format: date-time
        archiveTailSlot:
          type:
            - integer
            - 'null'
          description: >-
            The slot of the newest transaction in the archive. Unit: slots. Null
            when the archive is empty.
        archiveTailAt:
          type:
            - string
            - 'null'
          description: >-
            The block time of the newest transaction in the archive, in UTC (ISO
            8601). Null when the archive is empty.
          format: date-time
        stale:
          type: boolean
          description: >-
            True when the archive has not moved for longer than its freshness
            limit. The server still sends a stale response, with a `Warning`
            header.
        staleReason:
          type:
            - string
            - 'null'
          description: Why the archive is stale, in words. Null when `stale` is false.
        entryFeeBasis:
          type: string
          description: >-
            How the entry fees in the rows were found. `observed` means each fee
            is the fee that the trade paid. Only the routes whose rows carry an
            entry fee send this field.
          enum:
            - observed
      required:
        - generatedAt
        - archiveTailSlot
        - archiveTailAt
        - stale
        - staleReason
    Window:
      type: object
      description: The time window of a per-transaction route.
      properties:
        hours:
          type: integer
          description: 'The length of the window. Unit: hours.'
          examples:
            - 48
        since:
          type: string
          description: >-
            The start of the window, in UTC (ISO 8601). The route does not send
            rows before this time.
          format: date-time
        rule:
          type: string
          description: The window rule, in words.
      required:
        - hours
        - since
        - rule
    RoundRow:
      type: object
      description: One Minute round.
      properties:
        wallet:
          type:
            - string
            - 'null'
          description: The wallet that played the round, as 64 hex characters.
          pattern: ^[0-9a-f]{64}$
        seq:
          type:
            - string
            - 'null'
          description: The round number of this wallet, as a decimal string.
          pattern: ^[0-9]+$
        market:
          type:
            - string
            - 'null'
          description: The market account address, as 64 hex characters.
          pattern: ^[0-9a-f]{64}$
        direction:
          type:
            - string
            - 'null'
          description: The side of the round.
          enum:
            - long
            - short
            - null
        status:
          type: string
          description: >-
            Where the round stands. `live`: open. `settled` or `reconciled`:
            closed. `voided`: the venue returned the order, and the round did
            not start.
          enum:
            - live
            - settled
            - reconciled
            - voided
        openedAtUnix:
          type:
            - integer
            - 'null'
          description: 'The open time. Unit: Unix seconds.'
        deadlineUnix:
          type:
            - integer
            - 'null'
          description: 'The time the round ends. Unit: Unix seconds.'
        openedSlot:
          type:
            - integer
            - 'null'
          description: 'The slot of the open transaction. Unit: slots.'
        entryPrice:
          type:
            - string
            - 'null'
          description: >-
            The entry price, as a decimal string at the price scale of the
            market.
          pattern: ^[0-9]+$
        grossStake:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The gross amount committed over the open and every double-down.
            Unit: base units of USDC (6 decimals), as a decimal string.
        openingGross:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The gross amount of one leg. Every leg has this amount. Unit: base
            units of USDC (6 decimals), as a decimal string.
        totalStake:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The same value as `grossStake`. Unit: base units of USDC (6
            decimals), as a decimal string.
        netStake:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The collateral that reached the venue: the gross amount less the
            entry fees. Unit: base units of USDC (6 decimals), as a decimal
            string.
        legs:
          type: integer
          description: 'The open and every double-down: `1 + addCount`. Unit: legs.'
        addCount:
          type: integer
          description: 'The number of double-downs. Unit: double-downs.'
        addsReversed:
          type: integer
          description: >-
            The number of double-downs that the venue returned. Present only
            when the venue returned one.
        payout:
          type:
            - string
            - 'null'
          pattern: ^[0-9]+$
          description: >-
            The payout of the round. Null when `payoutSource` is `venue`: read
            the venue trade. Unit: base units of USDC (6 decimals), as a decimal
            string.
        payoutSource:
          type:
            - string
            - 'null'
          description: >-
            Where the payout figure comes from. `event`: the round settlement.
            `venue`: the venue settlement of the round.
          enum:
            - event
            - venue
            - null
        reason:
          type:
            - integer
            - 'null'
          description: The close reason code of the round settlement. Null on other paths.
        closeReason:
          type:
            - string
            - 'null'
          description: >-
            The close reason, by name. Null while the round is live and on the
            reconcile path.
        settledAtUnix:
          type:
            - integer
            - 'null'
          description: 'The close time. Unit: Unix seconds.'
        settledSlot:
          type:
            - integer
            - 'null'
          description: >-
            The slot of the close transaction. Unit: slots. Null while the round
            is live.
        openSignature:
          type:
            - string
            - 'null'
          description: The signature of the open transaction, in base58.
        settleSignature:
          type:
            - string
            - 'null'
          description: >-
            The signature of the close transaction, in base58. Null while the
            round is live.
        playerPda:
          type:
            - string
            - 'null'
          description: The player account of the wallet, as 64 hex characters.
          pattern: ^[0-9a-f]{64}$
        delivered:
          type:
            - boolean
            - 'null'
          description: >-
            True when the payout reached the wallet in the close transaction.
            False when the money left custody and the wallet got none of it.
            Null when the close transaction alone does not show it.
        destination:
          type:
            - string
            - 'null'
          description: >-
            The token account that got the payout, in base58. Null when the
            archive did not see it.
        entryPriceSource:
          type: string
          description: >-
            Where `entryPrice` comes from. `venue`: the venue fill. Present only
            when the venue states the entry.
          enum:
            - venue
        voided:
          type: object
          description: >-
            How the venue returned the order of the round. Present only when it
            did.
          properties:
            reason:
              type: string
              description: Why the venue returned the order, as a short code.
            text:
              type: string
              description: Why the venue returned the order, in words.
            refundTotal:
              type: string
              pattern: ^[0-9]+$
              description: >-
                The amount that the venue returned. Unit: base units of USDC (6
                decimals), as a decimal string.
            feeKept:
              type: string
              pattern: ^[0-9]+$
              description: >-
                The fee that the venue kept. Unit: base units of USDC (6
                decimals), as a decimal string.
            delivered:
              type: boolean
              description: True when the refund reached the wallet.
            slot:
              type: integer
              description: >-
                The slot of the transaction that returned the order. Unit:
                slots.
        queue:
          $ref: '#/components/schemas/QueueBlock'
      required:
        - status
        - grossStake
        - netStake
        - legs
        - addCount
    Error:
      type: object
      description: A refused request.
      properties:
        error:
          type: string
          description: What is wrong, in words.
        retryAfterSeconds:
          type: integer
          description: 'On `429` only: wait this long, then retry. Unit: seconds.'
        routes:
          type: array
          items:
            type: string
          description: 'On `404` for an unknown route only: the routes that this API serves.'
      required:
        - error
    QueueBlock:
      type: object
      description: >-
        The payout queue facts of a settlement that queued part of a win. Only a
        settlement that queued money carries this block.
      properties:
        owed:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The whole amount that the settlement owes the trader. Unit: base
            units of USDC (6 decimals), as a decimal string.
        paidNow:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The part of `owed` that the settlement paid in its own transaction.
            Unit: base units of USDC (6 decimals), as a decimal string.
        queued:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The part of `owed` that went into the payout queue. Unit: base units
            of USDC (6 decimals), as a decimal string.
        delivered:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The queued amount that later payments delivered to the trader. Unit:
            base units of USDC (6 decimals), as a decimal string.
        escrowed:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The queued amount that later payments set aside because the program
            could not deliver it. Unit: base units of USDC (6 decimals), as a
            decimal string.
        outstanding:
          type: string
          pattern: ^[0-9]+$
          description: >-
            The queued amount that is still owed: `queued - delivered -
            escrowed`. Unit: base units of USDC (6 decimals), as a decimal
            string.
        status:
          type: string
          description: Where the queued amount stands.
          enum:
            - in-full
            - parked
            - waiting
            - part-funded
            - funded
            - part-paid
            - paid
  responses:
    BadRequest:
      description: >-
        The request used a filter that this API refuses, or the path, the
        signature or `phase` is not valid. Fix the request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UriTooLong:
      description: The request URL is longer than 2,048 characters. Shorten it.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: >-
        Too many requests. Wait `Retry-After` seconds, then retry. `GET
        /v0/health` states the limit under `access`.
      headers:
        Retry-After:
          description: 'Wait this long before you retry. Unit: seconds.'
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServerError:
      description: The server could not answer. Retry later.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'

````

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