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

# Get staking positions

> Stake positions for a wallet across all roles: amount, status, cooldowns, and claimable rewards. Public on-chain data.



## OpenAPI

````yaml GET /api/agent/positions
openapi: 3.1.0
info:
  title: x402 Singularity Layer API
  description: >-
    OpenAPI-backed reference for marketplace discovery, payment routes,
    webhooks, wallet-first auth, agent endpoints, and ERC-8004 flows.
  version: 1.0.0
servers:
  - url: https://api.x402layer.cc
security: []
tags:
  - name: Marketplace
    description: Public discovery and listing lookup
  - name: Public Endpoints
    description: Public endpoint metadata and hosted checkout context
  - name: Public Payment Links
    description: Hosted public payment-link lookup
  - name: Payments
    description: Hosted x402 payment challenge routes
  - name: Receipts
    description: Signed receipt lookup and verification helpers
  - name: Ratings
    description: Public listing ratings and authenticated rating actions
  - name: Webhooks
    description: Seller webhook management API
  - name: Agent Auth
    description: Wallet-first challenge and verification routes
  - name: Agent Endpoints
    description: Create, read, top up, and delete agent endpoints
  - name: ERC-8004
    description: Agent registry and registration lifecycle routes
  - name: Marketplace Agents
    description: Public ERC-8004 marketplace discovery routes
  - name: Compute Catalog
    description: Compute plans, regions, and OS catalog
  - name: Compute Instances
    description: Provision, inspect, extend, and destroy compute instances
  - name: Compute API Keys
    description: API keys for compute agent access
  - name: Fundraiser Campaigns
    description: List, view, create, and edit fundraiser campaigns
  - name: Fundraiser Contributions
    description: Record and list campaign contributions
  - name: Fundraiser Comments
    description: Campaign comment threads
  - name: Fundraiser Media
    description: Campaign image uploads and OG images
  - name: Enterprise
    description: >-
      Enterprise partner configuration, endpoint listing, revenue stats, and
      transaction ledger
  - name: Staking
    description: Agentic $SGL staking
  - name: SGL Grid
    description: >-
      Decentralized, confidential, OpenAI-compatible inference served by
      attested TEE nodes.
  - name: Compute Credits
    description: Prepaid USDC credit balance shared across Machines and Grid.
paths:
  /api/agent/positions:
    get:
      tags:
        - Staking
      summary: A wallet's stake positions
      description: >-
        Stake positions for a wallet across all roles: amount, status,
        cooldowns, and claimable rewards. Public on-chain data.
      operationId: getPositions
      parameters:
        - name: wallet
          in: query
          required: true
          description: Solana wallet address (base58).
          schema:
            type: string
          example: 8d3o8mLHpBA13m2CtuPSCbu1gujwjotzQvz75xGcHH5U
      responses:
        '200':
          description: Positions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StkPositionsResponse'
        '400':
          $ref: '#/components/responses/StkError'
        '500':
          $ref: '#/components/responses/StkError'
      servers:
        - url: https://staking.x402layer.cc
components:
  schemas:
    StkPositionsResponse:
      type: object
      properties:
        wallet:
          type: string
        positions:
          type: array
          items:
            $ref: '#/components/schemas/StkPosition'
        totals:
          type: object
          properties:
            stakedSgl:
              type: number
            stakedValueUsd:
              type: number
            claimableUsdc:
              type: number
            claimableSgl:
              type: number
            positionCount:
              type: integer
    StkPosition:
      type: object
      properties:
        role:
          $ref: '#/components/schemas/StkStakeRole'
        stakeType:
          type: integer
          enum:
            - 0
            - 1
            - 2
        amount:
          type: number
          description: $SGL staked.
        status:
          type: string
          enum:
            - active
            - unstaking
            - slashed
        stakedAt:
          type: integer
          description: Unix ms.
        unlockAt:
          type:
            - integer
            - 'null'
          description: Unix ms cooldown end, or null.
        cooldownEndsAt:
          type:
            - integer
            - 'null'
        claimableUnlock:
          type: boolean
          description: >-
            True when unstaking cooldown has elapsed and tokens can be
            withdrawn.
        rewardsOwedUsdc:
          type: number
        rewardsOwedSgl:
          type: number
        valueUsd:
          type: number
    StkError:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
    StkStakeRole:
      type: string
      enum:
        - compute
        - validator
        - yield
      description: >-
        Stake type. compute = compute node operator, validator = marketplace
        validator, yield = yield enjoyer.
  responses:
    StkError:
      description: Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StkError'

````