Skip to main content

The coinpath field allows us to retrieve detailed information about money flow using coinpath technology.

Filtering Options

Coinpath data can be filtered using following arguments:

  • currency: Filter by the currency involved in the transaction.
  • date: Filter by the date of the transaction.
  • depth: Filter by the depth of the transaction.
  • initialAddress: Filter by the initial address.
  • initialDate: Filter by the initial date.
  • initialTime: Filter by the initial time.
  • options: Filter returned data by ordering, limiting, and constraining it.
  • receiver: Filter by the receiver's address.
  • sender: Filter by the sender's address.
  • time: Filter by the time of the transaction.

The following are available fields for the coinpath:

  • amount: returns the amount of tokens involved in the transaction.
  • any:
  • block: returns details of the block where the transaction happened.
  • count: returns the aggregate count of transactions.
  • countBigInt: returns the aggregate count of transactions in BigInt format.
  • currency: returns details of the currency used in the transaction.
  • depth: returns depth information.
  • maximum: returns maximum of selected coinpath measurable fields
  • minimum: returns minimum of selected coinpath measurable fields
  • receiver: returns information about the receiver.
  • sender: returns information about the sender.
  • transaction: returns transaction details.
  • transactions: returns attributes of transactions.

Example Query​

The following query traces outbound fund flow from an address up to 2 hops deep, returning sender/receiver details, amounts, block timestamps, and transaction hashes. You can switch to inbound tracing by adding direction: inbound inside options.

Open this query on IDE

{
  ethereum(network: ethereum) {
    coinpath(
      initialAddress: { is: "0xa09871aeadf4994ca12f5c0b6056bbd1d343c029" }
      currency: { is: "ETH" }
      depth: { lteq: 2 }
      options: {
        seed: 110
        asc: "depth"
        desc: "amount"
        limitBy: { each: "depth", limit: 10 }
      }
      date: { since: "2018-03-01", till: "2021-01-31" }
    ) {
      sender {
        address
        annotation
        smartContract {
          contractType
          currency {
            symbol
            name
          }
        }
      }
      receiver {
        address
        annotation
        smartContract {
          contractType
          currency {
            symbol
            name
          }
        }
      }
      amount
      currency {
        symbol
        name
      }
      transaction {
        hash
        value
      }
      block {
        height
        timestamp {
          time(format: "%y-%d-%m")
        }
      }
      depth
      count
    }
  }
}

For more coinpath examples — including inbound tracing, two-address relationship analysis, and multi-hop fund tracking — see the Coinpath Money Flow API examples.