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

# Get upcoming special settlements



## OpenAPI

````yaml openapi/api-gateway.json GET /special-settlements-pending
openapi: 3.1.0
info:
  title: ax-api-gateway
  description: ''
  license:
    name: ''
  version: 15.22.0
servers:
  - url: https://gateway.architect.exchange/api
security: []
tags:
  - name: api-gateway
    description: API gateway
paths:
  /special-settlements-pending:
    get:
      tags:
        - api-gateway
      operationId: get_upcoming_special_settlements
      parameters:
        - name: days
          in: query
          description: Number of days ahead to include. Defaults to 7; capped at 365.
          required: false
          schema:
            type:
              - integer
              - 'null'
            format: int32
            minimum: 0
      responses:
        '200':
          description: Upcoming special settlements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetUpcomingSpecialSettlementsResponse'
      security:
        - session_token: []
components:
  schemas:
    GetUpcomingSpecialSettlementsResponse:
      type: object
      required:
        - special_settlements
      properties:
        special_settlements:
          type: array
          items:
            $ref: '#/components/schemas/UpcomingSpecialSettlement'
          description: Upcoming special settlements, ordered by settlement time.
    UpcomingSpecialSettlement:
      type: object
      description: |-
        Public, user-facing view of an upcoming special settlement. Deliberately
        omits internal/operational fields (notes, retry bookkeeping).
      required:
        - symbol
        - settlement_ts
        - long_holder_extra_funding_amount
      properties:
        long_holder_extra_funding_amount:
          type: string
          description: |-
            Per-contract amount credited to long holders (and debited from short
            holders) when the settlement executes. Always non-negative.
        settlement_ts:
          type: string
          format: date-time
          description: |-
            Time at which the settlement will be applied. Positions held in the
            symbol at this instant determine who is credited or debited.
        symbol:
          type: string
          description: Symbol the settlement applies to.
  securitySchemes:
    session_token:
      type: http
      scheme: bearer
      description: User session token

````