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

# List transactions for an account on a connection

> Returns paginated transactions for a single account belonging to this connection. The account is resolved to a provider-specific object (e.g. a Utila wallet). Pagination is opaque token (cursor) based — pass meta.next_cursor back as ?cursor to fetch the next page; null next_cursor means no more results. Providers without transaction support return a not-implemented error.



## OpenAPI

````yaml /api-reference/data-api.json get /v2/account-connections/{id}/transactions
openapi: 3.0.0
info:
  title: Range Data API
  description: >-
    The Range Data API for crypto addresses, networks, transactions, and
    entities.
  version: 1.6.1
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
tags:
  - name: Address Information
    description: Get information about a crypto address.
  - name: Entity Information
    description: Get information about entities.
  - name: Network Information
    description: Get information about networks.
  - name: Protocols
    description: Get information about cross-chain protocols.
  - name: Token transfers
    description: Get information about token transfers.
paths:
  /v2/account-connections/{id}/transactions:
    get:
      tags:
        - Account Connections
      summary: List transactions for an account on a connection
      description: >-
        Returns paginated transactions for a single account belonging to this
        connection. The account is resolved to a provider-specific object (e.g.
        a Utila wallet). Pagination is opaque token (cursor) based — pass
        meta.next_cursor back as ?cursor to fetch the next page; null
        next_cursor means no more results. Providers without transaction support
        return a not-implemented error.
      operationId: getConnectionTransactions
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
        - name: account_id
          required: true
          in: query
          description: >-
            Account id (in this API) to scope transactions to. Must belong to
            the connection.
          schema:
            example: acc_abc123
            type: string
        - name: wallet_address
          required: false
          in: query
          description: >-
            Realms wallet address to fetch history for. Must be a NativeTreasury
            PDA or Governance PDA belonging to this connection. Required when
            the Realm has more than one treasury.
          schema:
            example: B56RWQGf9RFw7t8gxPzrRvk5VRmB5DoF94aLoJ25YtvG
            type: string
        - name: cursor
          required: false
          in: query
          description: Opaque cursor returned in meta.next_cursor of a previous response.
          schema:
            example: eyJwYWdlVG9rZW4iOiJYWVoifQ==
            type: string
        - name: size
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 1000
            default: 100
            example: 100
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchConnectionTransactionsResponseDto'
components:
  schemas:
    SearchConnectionTransactionsResponseDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/CanonicalConnectionTransactionDto'
        meta:
          $ref: '#/components/schemas/CursorMetaDto'
      required:
        - items
        - meta
    CanonicalConnectionTransactionDto:
      type: object
      properties:
        id:
          type: string
          example: 0x9a3f...
          description: Provider-native unique identifier for this event.
        account_id:
          type: string
          example: acc_abc123
          description: Account (in this API) the event belongs to.
        provider:
          type: object
          example: hyperliquid
          description: Connection provider that produced this event.
        kind:
          type: string
          enum:
            - TRANSFER
            - TRADE
          example: TRADE
          description: 'Discriminator: which event-specific payload is populated.'
        status:
          type: string
          enum:
            - PENDING
            - CONFIRMED
            - FAILED
          example: CONFIRMED
        timestamp:
          type: string
          nullable: true
          example: '2026-01-15T10:00:00.000Z'
          description: Canonical event time (ISO 8601).
        hash:
          type: string
          nullable: true
          example: 0xabc...
        network:
          type: string
          nullable: true
          example: networks/ethereum-mainnet
        block_number:
          type: string
          nullable: true
          example: '21000000'
        transfers:
          nullable: true
          description: >-
            Value movement legs. Populated when kind === 'TRANSFER' (may be
            empty when the provider has not parsed the underlying transfers
            yet).
          type: array
          items:
            $ref: '#/components/schemas/TransferEventDto'
        trade:
          nullable: true
          description: Populated when kind === 'TRADE'.
          type: object
          allOf:
            - $ref: '#/components/schemas/TradeEventDto'
        raw:
          type: object
          additionalProperties: true
          example: {}
          description: >-
            Provider-native fields that are not part of the canonical shape
            (escape hatch; never relied upon by consumers).
      required:
        - id
        - account_id
        - provider
        - kind
        - status
        - raw
    CursorMetaDto:
      type: object
      properties:
        next_cursor:
          type: string
          nullable: true
          description: >-
            Opaque string cursor pointing to the next page of results. null if
            there is no next page.
          example: eyJpZCI6IjkxeFFlV3Z...
        previous_cursor:
          type: string
          nullable: true
          description: >-
            Opaque string cursor pointing to the previous page of results. null
            if there is no previous page.
          example: eyJpZCI6IjkxeFFlV3Z...
        first_page_cursor:
          type: string
          description: >-
            Opaque string cursor pointing to the very first page in the entire
            dataset with respect to the current filter.
          example: eyJpZCI6IjkxeFFlV3Z...
        last_page_cursor:
          type: string
          nullable: true
          description: >-
            Opaque string cursor pointing to the very last page in the entire
            dataset with respect to the current filter.
          example: eyJpZCI6IjkxeFFlV3Z...
        total_count:
          type: number
          nullable: true
          description: Total number of results.
          example: 100
        page_number:
          type: number
          description: Current page number.
          example: 1
    TransferEventDto:
      type: object
      properties:
        direction:
          type: string
          enum:
            - IN
            - OUT
            - SELF
          example: IN
        asset:
          type: string
          nullable: true
          example: USDC
        amount:
          type: string
          nullable: true
          example: '100.50'
          description: Quantity moved, in asset units.
        source_address:
          type: string
          nullable: true
          example: 0xabc...
        destination_address:
          type: string
          nullable: true
          example: 0xdef...
      required:
        - direction
    TradeEventDto:
      type: object
      properties:
        side:
          type: string
          enum:
            - BUY
            - SELL
          example: BUY
        base_asset:
          type: string
          nullable: true
          example: BTC
        base_amount:
          type: string
          nullable: true
          example: '0.01'
        quote_asset:
          type: string
          nullable: true
          example: USDC
        quote_amount:
          type: string
          nullable: true
          example: '500.0'
          description: Notional in quote asset units (price × base amount).
        price:
          type: string
          nullable: true
          example: '50000.0'
        fee:
          type: string
          nullable: true
          example: '0.45'
        fee_asset:
          type: string
          nullable: true
          example: USDC
          description: Asset the fee was charged in, when known.
        realized_pnl:
          type: string
          nullable: true
          example: '25.11'
          description: >-
            Realised PnL for a position-closing fill (perps). Null/absent for
            opens and spot.
        liquidation:
          type: boolean
          example: false
          description: >-
            True when the fill was a forced liquidation rather than a
            user-initiated trade.
      required:
        - side
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: API Key
      description: 'Use Authorization: Bearer <api-key>'
      type: http

````