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

# Lấy siêu dữ liệu vị trí CLMM bị khóa

> Lấy siêu dữ liệu cho một vị trí CLMM bị khóa. Trả về dữ liệu vị trí bao gồm thời gian khóa, phí tích lũy và định giá hiện tại.




## OpenAPI

````yaml /vi/api-reference/openapi/dynamic-ipfs-v1.yaml get /lock/clmm/position
openapi: 3.0.3
info:
  title: API IPFS Động
  description: >
    Tái tạo siêu dữ liệu và hình ảnh NFT động cho các vị trí CLMM. Được sử dụng
    bởi các dApps để lấy dữ liệu hình ảnh vị trí và định giá theo thời gian
    thực, bao gồm chi tiết pool, số tiền, phí và phần thưởng.


    Dịch vụ này lưu trữ siêu dữ liệu vị trí trong IPFS và cung cấp trạng thái vị
    trí được tính toán (giá trị USD, phần trăm TVL, phí chưa yêu cầu) theo ID vị
    trí. Hỗ trợ cả các vị trí mở khóa và bị khóa trên các loại pool CLMM và
    CPMM.
  version: 1.0.0
  contact:
    name: Raydium
    url: https://raydium.io
servers:
  - url: https://dynamic-ipfs.raydium.io
    description: Mainnet
  - url: https://dynamic-ipfs-devnet.raydium.io
    description: Devnet
security: []
tags:
  - name: CLMM Position
    description: Lấy siêu dữ liệu động cho các vị trí Concentrated Liquidity Market Maker
  - name: Locked Positions
    description: Lấy dữ liệu vị trí bị khóa (CLMM và CPMM)
paths:
  /lock/clmm/position:
    get:
      tags:
        - Locked Positions
      summary: Lấy siêu dữ liệu vị trí CLMM bị khóa
      description: >
        Lấy siêu dữ liệu cho một vị trí CLMM bị khóa. Trả về dữ liệu vị trí bao
        gồm thời gian khóa, phí tích lũy và định giá hiện tại.
      operationId: getLockedClmmPosition
      parameters:
        - name: id
          in: query
          required: true
          description: Khóa công khai PDA vị trí bị khóa (base58)
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CLNFTInterface'
        '400':
          description: ID vị trí không hợp lệ hoặc chủ sở hữu không khớp
          content:
            text/plain:
              schema:
                type: string
        '404':
          description: Không tìm thấy vị trí
          content:
            text/plain:
              schema:
                type: string
        '500':
          description: Lỗi máy chủ
          content:
            text/plain:
              schema:
                type: string
components:
  schemas:
    CLNFTInterface:
      type: object
      description: Vị trí CLMM hoàn chỉnh với chi tiết pool và định giá
      properties:
        poolInfo:
          $ref: '#/components/schemas/PoolInfoConcentrated'
        positionInfo:
          $ref: '#/components/schemas/CLPositionInfo'
      required:
        - poolInfo
        - positionInfo
    PoolInfoConcentrated:
      type: object
      description: Thông tin pool Concentrated Liquidity Market Maker
      properties:
        id:
          type: string
          description: ID Pool
        programId:
          type: string
          description: ID chương trình sở hữu pool
        mintA:
          $ref: '#/components/schemas/MintInfo'
        mintB:
          $ref: '#/components/schemas/MintInfo'
        tvl:
          type: number
          description: Tổng Giá Trị Khóa tính bằng USD
        rewardDefaultInfos:
          type: array
          description: Token thưởng cho pool này
          items:
            $ref: '#/components/schemas/RewardInfo'
    CLPositionInfo:
      type: object
      description: Trạng thái vị trí CLMM
      properties:
        tvlPercentage:
          type: number
          description: TVL vị trí dưới dạng phần trăm của pool (0-100)
        usdValue:
          type: number
          description: Giá trị vị trí tính bằng USD
        amountA:
          type: number
          description: Số lượng Token A trong vị trí
        amountB:
          type: number
          description: Số lượng Token B trong vị trí
        unclaimedFee:
          $ref: '#/components/schemas/UnclaimedFeeInfo'
      required:
        - tvlPercentage
        - usdValue
        - amountA
        - amountB
        - unclaimedFee
    MintInfo:
      type: object
      properties:
        address:
          type: string
          description: Địa chỉ mint token
        decimals:
          type: integer
          description: Số thập phân token
        symbol:
          type: string
          description: Ký hiệu token
    RewardInfo:
      type: object
      properties:
        mint:
          $ref: '#/components/schemas/MintInfo'
    UnclaimedFeeInfo:
      type: object
      description: Phí đã tích lũy nhưng chưa được yêu cầu rút trong vị trí CLMM
      properties:
        amountA:
          type: number
          description: Phí Token A chưa được yêu cầu rút
        amountB:
          type: number
          description: Phí Token B chưa được yêu cầu rút
        usdFeeValue:
          type: number
          description: Giá trị phí giao dịch tính bằng USD
        reward:
          type: array
          items:
            type: number
          description: Số lượng reward chưa được yêu cầu rút cho mỗi token reward
        usdRewardValue:
          type: number
          description: Giá trị reward tính bằng USD
        usdValue:
          type: number
          description: Tổng giá trị chưa được yêu cầu rút tính bằng USD

````