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

# List nodes for a wallet

> Registered node records for an operator wallet. No auth (public node metadata, no secrets).



## OpenAPI

````yaml GET /grid/nodes
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:
  /grid/nodes:
    servers:
      - url: https://grid.x402compute.cc
    get:
      tags:
        - SGL Grid
      summary: List nodes for a wallet
      description: >-
        Registered node records for an operator wallet. No auth (public node
        metadata, no secrets).
      parameters:
        - name: wallet
          in: query
          required: true
          schema:
            type: string
          example: 8d3o8m…HH5U
        - name: limit
          in: query
          required: false
          schema:
            type: integer
          example: 20
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    example: 1
                  nodes:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        wallet_address:
                          type: string
                        tee_type:
                          type: string
                          example: apple_se
                        cpu_cores:
                          type: integer
                          example: 10
                        ram_gb:
                          type: integer
                          example: 16
                        gpu_model:
                          type: string
                          example: apple_metal
                        available_models:
                          type: array
                          items:
                            type: string
                        reputation_score:
                          type: number
                          example: 66
                        total_jobs_completed:
                          type: integer
                          example: 235
                        status:
                          type: string
                          example: active
                        sgl_staked:
                          type: number
                          example: 50000
                        off_grid:
                          type: boolean
                          example: false
                        node_public_key:
                          type: string
                          description: Node ed25519 identity key.
                        anchored:
                          type: boolean
                          example: true
                          description: >-
                            Whether the operator verified (anchored) this node's
                            key on-chain.

````