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

# Get Induced Subgraph

> Given a set of addresses (e.g. every node currently on a Trail canvas), returns only the edges that exist between addresses in that set — the sibling-to-sibling connections that byAddress cannot express because it only sees one root address at a time.



## OpenAPI

````yaml /api-reference/data-api.json post /v2/connections/subgraph
openapi: 3.0.0
info:
  title: Range Data API
  description: >-
    The Range Data API for crypto addresses, networks, transactions, and
    entities.
  version: 1.7.20
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
tags:
  - 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/connections/subgraph:
    post:
      tags:
        - Connections Information
      summary: Get Induced Subgraph
      description: >-
        Given a set of addresses (e.g. every node currently on a Trail canvas),
        returns only the edges that exist between addresses in that set — the
        sibling-to-sibling connections that byAddress cannot express because it
        only sees one root address at a time.
      operationId: getInducedSubgraph
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubgraphRequestDto'
      responses:
        '200':
          description: Edges between addresses in the given set.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubgraphResponseDto'
components:
  schemas:
    SubgraphRequestDto:
      type: object
      properties:
        addresses:
          minItems: 2
          description: >-
            Addresses currently on the canvas. The response is limited to edges
            between addresses in this set.
          type: array
          items:
            $ref: '#/components/schemas/AddressEntryDto'
        start_time:
          type: string
          description: Start time
        end_time:
          type: string
          description: End time
      required:
        - addresses
    SubgraphResponseDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SubgraphEdge'
        meta:
          $ref: '#/components/schemas/SubgraphMetaDto'
      required:
        - items
        - meta
    AddressEntryDto:
      type: object
      properties:
        address:
          type: string
          minLength: 1
          maxLength: 128
          example: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
          description: Blockchain address
        network:
          type: string
          minLength: 1
          maxLength: 64
          example: solana
          description: Blockchain network identifier
      required:
        - address
        - network
    SubgraphEdge:
      type: object
      properties:
        address:
          $ref: '#/components/schemas/AddressEntryDto'
        counterparty:
          $ref: '#/components/schemas/AddressEntryDto'
        total_payments:
          type: number
          example: 12
        payment_counts:
          description: Per-payment-type transfer counts.
          type: array
          items:
            type: object
        earliest_payment:
          type: string
          example: '2024-01-01T00:00:00.000Z'
        latest_payment:
          type: string
          example: '2024-02-01T00:00:00.000Z'
        is_sender:
          type: boolean
        is_receiver:
          type: boolean
        total_payments_may_be_incomplete:
          type: boolean
          description: >-
            Set when total_payments is a lower bound rather than a lifetime
            total (RNG-5517's Alchemy windowing).
      required:
        - address
        - counterparty
        - total_payments
        - payment_counts
        - earliest_payment
        - latest_payment
        - is_sender
        - is_receiver
    SubgraphMetaDto:
      type: object
      properties:
        failed_nodes:
          type: number
          example: 0
          description: >-
            Nodes whose counterparty lookup failed or timed out. Edges through a
            failed node may be missing — a caller cannot otherwise tell that
            apart from the node genuinely having no edges.
      required:
        - failed_nodes
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Authorization method required to allow user to access the api endpoints.

````