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

# Agent Token Approvals (x402)

> ERC-20 token approvals of an EVM address on one chain, paginated. Same response as GET /approvals/{chain}: `{cursor, pageSize, items}`.

Paid per call via the x402 payment protocol instead of an API key. An unpaid request returns 402 with a base64 `payment-required` header carrying the payment challenge (0.025 USDC on Base, eip155:8453); an x402-capable client settles it and retries.

**The API-key REST API is the default way to use Octav.** Use these only when the caller explicitly wants pay-per-call, or is an autonomous agent holding a wallet but no API key. There is no /agent/transactions — transaction history requires an API key.

See [Agent Endpoints (x402)](https://docs.octav.fi/api/endpoints/agent-x402).



## OpenAPI

````yaml /openapi.json get /agent/approvals/{chain}
openapi: 3.0.0
info:
  title: Octav API
  description: >-
    Comprehensive blockchain data API for portfolio management, transactions,
    and DeFi analytics
  version: 1.0.0
  contact:
    name: Octav Support
    url: https://octav.fi
    email: info@octav.fi
servers:
  - url: https://api.octav.fi/v1
    description: Production API
security:
  - bearerAuth: []
tags:
  - name: Portfolio
    description: Portfolio and holdings endpoints
  - name: Virtual Users
    description: Virtual user management and portfolio endpoints (Pro only)
  - name: Nav
    description: Net Asset Value endpoints
  - name: Wallet
    description: Wallet information endpoints
  - name: Transactions
    description: Transaction history endpoints
  - name: Approvals
    description: Token approval endpoints
  - name: Tokens
    description: Token data endpoints
  - name: Airdrops
    description: Airdrop eligibility endpoints
  - name: Polymarket
    description: Polymarket prediction market positions
  - name: Snapshot Subscriptions
    description: >-
      Subscribe addresses to daily portfolio snapshots, renew them, and list
      what your key can read
  - name: Sync
    description: Data synchronization endpoints
  - name: Status
    description: Status check endpoints
  - name: Credits
    description: Credit balance endpoints
  - name: Chains
    description: Blockchain network and protocol endpoints
  - name: Contract Protocol
    description: Resolve a contract address to its DeFi protocol
  - name: Agent (x402)
    description: >-
      Pay-per-call endpoints for autonomous agents via the x402 protocol — no
      API key. A nine-endpoint subset; the API-key REST endpoints above are the
      default.
  - name: Beacon Validators
    description: >-
      Ethereum beacon chain validator endpoints — details, rewards, withdrawals,
      and deposits (mainnet only)
  - name: Address Book
    description: >-
      Manage the wallet addresses saved to your account — the list a bundle
      draws from
  - name: Bundles
    description: Group saved address book addresses into named bundles
paths:
  /agent/approvals/{chain}:
    get:
      tags:
        - Agent (x402)
      summary: Agent Token Approvals (x402)
      description: >-
        ERC-20 token approvals of an EVM address on one chain, paginated. Same
        response as GET /approvals/{chain}: `{cursor, pageSize, items}`.


        Paid per call via the x402 payment protocol instead of an API key. An
        unpaid request returns 402 with a base64 `payment-required` header
        carrying the payment challenge (0.025 USDC on Base, eip155:8453); an
        x402-capable client settles it and retries.


        **The API-key REST API is the default way to use Octav.** Use these only
        when the caller explicitly wants pay-per-call, or is an autonomous agent
        holding a wallet but no API key. There is no /agent/transactions —
        transaction history requires an API key.


        See [Agent Endpoints
        (x402)](https://docs.octav.fi/api/endpoints/agent-x402).
      operationId: getAgentApprovals
      parameters:
        - name: chain
          in: path
          required: true
          description: Chain to read approvals on.
          schema:
            type: string
            enum:
              - arbitrum
              - avalanche
              - base
              - binance
              - ethereum
              - gnosis
              - linea
              - optimism
              - polygon
          example: ethereum
        - name: addresses
          in: query
          required: true
          description: >-
            EVM wallet address (`0x...`). Only one address is accepted per call;
            a comma-separated list returns `400 Multiple addresses not supported
            yet`.
          schema:
            type: string
          example: '0x6426af179aabebe47666f345d69fd9079673f6cd'
        - name: limit
          in: query
          required: false
          description: Results per page (max 100).
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
        - name: cursor
          in: query
          required: false
          description: Pagination cursor from the previous page.
          schema:
            type: string
      responses:
        '200':
          description: Successful response — same shape as the API-key equivalent
          content:
            application/json:
              schema:
                type: object
        '402':
          description: >-
            Payment required — the x402 challenge, not an error. Read the
            `payment-required` header, settle the payment, retry.
          headers:
            payment-required:
              description: >-
                Base64-encoded JSON x402 payment challenge (x402Version,
                resource, accepts, extensions).
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.