Skip to main content

Bitcoin Omni Layer API

The Omni Layer is a protocol built on top of Bitcoin for issuing and trading custom tokens — most famously the original Bitcoin-issued USDT. These APIs return Omni-specific transaction and transfer data so you can track issuance, redemptions, and per-address Omni token activity directly on the Bitcoin chain.

Endpoint

Bitcoin GraphQL queries are served at https://graphql.bitquery.io.

Get the latest Omni transactions on Bitcoin​

Returns the 10 most recent Omni Layer transactions with block height, timestamp, fee in USD, transaction hash, and sender address — ordered by block height descending.

query ($network: BitcoinNetwork!) {
  bitcoin(network: $network) {
    omniTransactions(
      options: {desc: "block.height", limit: 10}
      date: {after: "2023-11-20"}
    ) {
      block {
        height
      }
      blockHash
      date {
        date
      }
      feeValue(in: USD)
      hash
      index
      txSender
    }
  }
}

Filter by sender with txSender: {is: "..."}, narrow with a different date window, or add limit / offset for pagination.

List Omni transfers for a specific address​

Returns every Omni token transfer originating from a given Bitcoin address — block hash, sender (transferFrom), and receiver (transferTo). Replace ADDRESS_HERE with the wallet you want to inspect.

query ($network: BitcoinNetwork!) {
  bitcoin(network: $network) {
    omniTransfers(options: {desc: "block.height"}, txSender: {is: "ADDRESS_HERE"}) {
      block {
        height
      }
      blockHash
      transferFrom
      transferTo
    }
  }
}

Filter incoming transfers with transferTo: {is: "..."} instead, add a date window to scope a period, or extend the query with currency / amount fields to identify which Omni token moved.