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

# Transactions

> Query transaction history with powerful filtering and search.

**Cost:** 1 credit per call

**Get your API key:** [Dev Portal](https://data.octav.fi)



## OpenAPI

````yaml /openapi.json get /transactions
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: 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: Beacon Validators
    description: >-
      Ethereum beacon chain validator endpoints — details, rewards, withdrawals,
      and deposits (mainnet only)
paths:
  /transactions:
    get:
      tags:
        - Transactions
      summary: Transactions
      description: |-
        Query transaction history with powerful filtering and search.

        **Cost:** 1 credit per call

        **Get your API key:** [Dev Portal](https://data.octav.fi)
      operationId: getTransactions
      parameters:
        - name: addresses
          in: query
          required: true
          description: Wallet address (EVM or SOL)
          schema:
            type: string
          example: '0x6426af179aabebe47666f345d69fd9079673f6cd'
        - name: limit
          in: query
          required: true
          description: Number of transactions per page (1-250, recommended 10-50)
          schema:
            type: integer
            minimum: 1
            maximum: 250
          example: 10
        - name: offset
          in: query
          required: true
          description: Pagination offset (0-based)
          schema:
            type: integer
            minimum: 0
          example: 0
        - name: sort
          in: query
          required: false
          description: Sort order by timestamp (DESC=newest first, ASC=oldest first)
          schema:
            type: string
            enum:
              - DESC
              - ASC
            default: DESC
        - name: initialSearchText
          in: query
          required: false
          description: >-
            Full-text search in transaction assets (token symbols, names,
            addresses)
          schema:
            type: string
        - name: interactingAddresses
          in: query
          required: false
          description: Filter by interacting addresses (comma-separated)
          schema:
            type: string
        - name: networks
          in: query
          required: false
          description: Filter by blockchain networks (comma-separated chain keys)
          schema:
            type: string
        - name: txTypes
          in: query
          required: false
          description: >-
            Filter by transaction types (comma-separated)


            See [Transaction
            Types](https://octav-0131e508.mintlify.app/api/reference/transaction-types)
          schema:
            type: string
        - name: protocols
          in: query
          required: false
          description: |-
            Filter by protocol keys (comma-separated)

            See [Protocol Keys](https://protocols.octav.fi/)
          schema:
            type: string
        - name: hideSpam
          in: query
          required: false
          description: Exclude spam transactions
          schema:
            type: boolean
            default: false
        - name: hideDust
          in: query
          required: false
          description: Exclude dust transactions
          schema:
            type: boolean
            default: false
        - name: startDate
          in: query
          required: false
          description: >-
            Start of the date range (ISO 8601, UTC). Inclusive: timestamp >=
            startDate, compared at the exact instant passed. Optional — omit to
            start from the wallet's first indexed transaction. camelCase only
            (start_date returns 400).
          schema:
            type: string
            format: date-time
          example: '2024-01-01T00:00:00Z'
        - name: endDate
          in: query
          required: false
          description: >-
            End of the date range (ISO 8601, UTC). Rounded up to the end of that
            calendar day (23:59:59Z); time-of-day is ignored. Inclusive:
            timestamp <= endOfDay(endDate). Optional. camelCase only (end_date
            returns 400).
          schema:
            type: string
            format: date-time
          example: '2024-12-31T23:59:59Z'
        - name: tokenId
          in: query
          required: false
          description: Filter by NFT token ID
          schema:
            type: string
      responses:
        '200':
          description: Successful response
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````