Skip to main content

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

Filtering Options

Coinpath data can be filtered using following arguments:

  • 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 BTC fund flow from a seed address, returning sender/receiver addresses, amounts in USD, block height, and transaction hashes.

Open this query on IDE

{
  bitcoin(network: bitcoin) {
    coinpath(
      initialAddress: { is: "bc1p4kufll9uhnpkgzuc65slcxd2qaw2hl9xecket3h8yyu4awglcsqslqaztd" }
      date: { after: "2023-10-10" }
      options: { limit: 10, asc: "block.height", seed: 10 }
    ) {
      amount(in: USD)
      block {
        height
      }
      sender {
        address
      }
      receiver {
        address
      }
      transaction {
        hash
      }
      currency {
        name
        address
      }
    }
  }
}

For more coinpath examples — including inbound tracing and two-address relationship analysis — see the Bitcoin Coinpath API examples and the Coinpath Money Flow API examples.