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

# 列出一個或多個限價單 PDA 的鏈上事件紀錄

> 回傳一個或多個限價單 PDA 的事件紀錄（`open`、`increase`、`decrease`、`settle`、`close`），適合用於呈現單一訂單的時間軸。透過 `nextPageId` 進行游標分頁。




## OpenAPI

````yaml /zh-Hant/api-reference/openapi/temp-api-v1.yaml get /limit-order/history/event/list-by-pda
openapi: 3.0.3
info:
  title: Temp API
  description: |
    此為短期端點的暫存區，這些端點尚未在 Raydium 主 API 中取得固定位置。
    此服務中的端點可能隨時變更、被棄用或遷移，恕不另行通知。

    **穩定性警告：** 本服務以快速迭代為優先，不提供最低 API 穩定性保證。
    請僅用於非關鍵路徑、內部工具或正在開發中的功能。
  version: 1.0.0
  contact:
    name: Raydium
    url: https://raydium.io
servers:
  - url: https://temp-api-v1.raydium.io
    description: Mainnet
  - url: https://temp-api-v1-devnet.raydium.io
    description: Devnet
security: []
tags:
  - name: Temporary
    description: 臨時端點（不穩定）
paths:
  /limit-order/history/event/list-by-pda:
    get:
      tags:
        - Temporary
      summary: 列出一個或多個限價單 PDA 的鏈上事件紀錄
      description: >
        回傳一個或多個限價單 PDA
        的事件紀錄（`open`、`increase`、`decrease`、`settle`、`close`），適合用於呈現單一訂單的時間軸。透過
        `nextPageId` 進行游標分頁。
      operationId: listLimitOrderEventsByPda
      parameters:
        - name: pda
          in: query
          required: true
          description: |
            一個或多個限價單 PDA 公鑰，以逗號分隔，每個必須為有效的 base58 公鑰。
          schema:
            type: string
        - name: nextPageId
          in: query
          required: false
          description: 由前一頁回傳的不透明分頁游標（TTL 約 1 小時）。
          schema:
            type: string
        - name: size
          in: query
          required: false
          description: 每頁筆數（1–100，預設 20）。
          schema:
            type: integer
            default: 20
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LimitOrderEventByPdaResponse'
        '400':
          description: 無效的請求
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: 伺服器錯誤
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    LimitOrderEventByPdaResponse:
      type: object
      description: '`/limit-order/history/event/list-by-pda` 的回應資料。'
      properties:
        id:
          type: string
        success:
          type: boolean
          example: true
        data:
          type: object
          properties:
            rows:
              type: array
              items:
                $ref: '#/components/schemas/LimitOrderEventItem'
            nextPageId:
              type: string
              nullable: true
              description: 下一頁的不透明游標；若為最後一頁則不存在。
          required:
            - rows
      required:
        - success
        - data
    ErrorResponse:
      type: object
      properties:
        id:
          type: string
        success:
          type: boolean
          example: false
        msg:
          type: string
          description: 錯誤訊息
      required:
        - success
        - msg
    LimitOrderEventItem:
      type: object
      description: 針對某 limit order PDA 觀察到的單筆鏈上變更事件。
      properties:
        pda:
          type: string
        txid:
          type: string
        slot:
          type: integer
        blockTime:
          type: integer
        poolId:
          type: string
        mintA:
          type: string
        mintB:
          type: string
        zeroForOne:
          type: boolean
        tick:
          type: integer
        price:
          type: number
        autoRunner:
          type: boolean
          description: 若為 true，表示此事件由 `limit_order_admin` keeper 執行；false 則表示由擁有者簽署。
        type:
          type: string
          enum:
            - open
            - increase
            - decrease
            - settle
            - close
        inputAmountChangeUi:
          type: number
          description: 訂單輸入餘額的淨變化量，以人類可讀單位表示（帶正負號）。
        inputAmountValuePreUi:
          type: number
        inputAmountValuePostUi:
          type: number
        outputAmountChangeUi:
          type: number
          description: 訂單累計輸出的淨變化量，以人類可讀單位表示（帶正負號）。
        outputAmountValuePreUi:
          type: number
        outputAmountValuePostUi:
          type: number
      required:
        - pda
        - txid
        - slot
        - blockTime
        - poolId
        - mintA
        - mintB
        - zeroForOne
        - tick
        - price
        - autoRunner
        - type
        - inputAmountChangeUi
        - inputAmountValuePreUi
        - inputAmountValuePostUi
        - outputAmountChangeUi
        - outputAmountValuePreUi
        - outputAmountValuePostUi

````