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

# Check wallet relay spending limits

> Get daily relay spending limits and current usage for a specific wallet address (separate tracking for mainnet and testnet)



## OpenAPI

````yaml get /relay/limits/{address}
openapi: 3.0.0
info:
  title: HTTPayer Proxy API
  version: 1.0.0
  description: >-
    HTTPayer is a payment router for 402 response codes and the x402 Protocol.
    Users can access APIs that use the x402 standard through the HTTPayer proxy.
  contact:
    name: HTTPayer Team
    url: https://httpayer.com
servers:
  - url: https://api.httpayer.com
    description: Production server
security: []
tags:
  - name: Relay
    description: Cross-chain payment relay endpoints
  - name: Account
    description: Account balance and limits endpoints
  - name: Webhooks
    description: Async task status and webhooks
  - name: LLM
    description: OpenAI-powered endpoints for translation and chat
  - name: Health
    description: Health check endpoints
paths:
  /relay/limits/{address}:
    get:
      tags:
        - Relay
      summary: Check wallet relay spending limits
      description: >-
        Get daily relay spending limits and current usage for a specific wallet
        address (separate tracking for mainnet and testnet)
      parameters:
        - in: path
          name: address
          required: true
          schema:
            type: string
          description: Wallet address (EVM or Solana)
          example: 4.145319684088198e+46
      responses:
        '200':
          description: Spending limits retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  wallet_address:
                    type: string
                    description: Normalized wallet address
                  mainnet:
                    type: object
                    description: Mainnet spending limits and usage
                    properties:
                      wallet_limits:
                        type: object
                        properties:
                          daily_limit:
                            type: number
                            description: Maximum USD per day for this wallet on mainnet
                            example: 100
                          today_spent:
                            type: number
                            description: Amount spent today on mainnet in USD
                            example: 25.5
                          remaining:
                            type: number
                            description: Amount remaining for today on mainnet in USD
                            example: 74.5
                          percentage_used:
                            type: string
                            description: Percentage of daily limit used on mainnet
                            example: '25.50'
                      system_limits:
                        type: object
                        properties:
                          daily_limit:
                            type: number
                            description: System-wide daily limit on mainnet in USD
                            example: 1000
                          today_spent:
                            type: number
                            description: System-wide spending today on mainnet in USD
                            example: 450.75
                          remaining:
                            type: number
                            description: System-wide remaining for today on mainnet in USD
                            example: 549.25
                          percentage_used:
                            type: string
                            description: Percentage of system limit used on mainnet
                            example: '45.08'
                      can_relay:
                        type: boolean
                        description: Whether wallet can currently relay mainnet payments
                        example: true
                  testnet:
                    type: object
                    description: Testnet spending limits and usage
                    properties:
                      wallet_limits:
                        type: object
                        properties:
                          daily_limit:
                            type: number
                            description: Maximum USD per day for this wallet on testnet
                            example: 100
                          today_spent:
                            type: number
                            description: Amount spent today on testnet in USD
                            example: 5
                          remaining:
                            type: number
                            description: Amount remaining for today on testnet in USD
                            example: 95
                          percentage_used:
                            type: string
                            description: Percentage of daily limit used on testnet
                            example: '5.00'
                      system_limits:
                        type: object
                        properties:
                          daily_limit:
                            type: number
                            description: System-wide daily limit on testnet in USD
                            example: 1000
                          today_spent:
                            type: number
                            description: System-wide spending today on testnet in USD
                            example: 50
                          remaining:
                            type: number
                            description: System-wide remaining for today on testnet in USD
                            example: 950
                          percentage_used:
                            type: string
                            description: Percentage of system limit used on testnet
                            example: '5.00'
                      can_relay:
                        type: boolean
                        description: Whether wallet can currently relay testnet payments
                        example: true
                  relay_fee_model:
                    type: object
                    description: HTTPayer relay fee model details
                    properties:
                      percentage:
                        type: number
                        example: 3
                      minimum_usd:
                        type: number
                        example: 0.002
                      description:
                        type: string
                        example: 3% with $0.002 minimum
                      formula:
                        type: string
                        example: Fee = max(percentage × target_amount, minimum_fee)
                  reset_time:
                    type: string
                    format: date-time
                    description: Time when daily limits reset (midnight UTC)
        '400':
          description: Invalid wallet address
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          type: string
          description: Additional error details

````