Cardano API Documentation
Overview
Bitquery's Cardano APIs let you query the chain through GraphQL — blocks, transactions, addresses, native tokens, UTXO-level inputs and outputs, staking, and multi-hop fund flow. Replace the example addresses and token IDs in any query with your own values to point them at real wallets and assets.
If you get stuck or need a data point that isn't covered here, reach out on Telegram.
Endpoint
Cardano GraphQL queries are served at https://graphql.bitquery.io.
What you can do with the Cardano API
- Look up blocks by height, hash, or time window — including epoch, slot, slot leader, and VRF key.
- Pull transactions with input/output totals, fees in ADA and USD, mint count, and withdrawals.
- Get address balances across ADA and every native token a wallet holds, plus staking and rewards.
- Walk UTXO-level inputs and outputs to reconstruct exact balances or build transaction feeds.
- Track mints and burns of any native token (NFTs, fungibles, stablecoins like DJED).
- Trace ADA flows inbound and outbound across multiple hops with Coinpath.
How the Cardano API differs from running your own node
cardano-node / RPC | Bitquery Cardano API |
|---|---|
| Raw chain state — you build the indexer | Pre-indexed and parsed: blocks, txs, UTXOs, native tokens, staking |
| No historical analytics out of the box | History, joins, aggregations, USD conversion |
| You stream and decode CBOR yourself | GraphQL response — pick the fields you need |
| Best for submitting transactions and full validation | Best for analytics, dashboards, wallet UIs, and compliance work |
Quick start
This query returns the 5 most recent Cardano blocks with hash, height, transaction count, and timestamp.
{
cardano(network: cardano) {
blocks(options: {desc: "height", limit: 5}) {
height
blockHash
transactionCount
timestamp {
time(format: "%Y-%m-%d %H:%M:%S")
}
}
}
}
API reference
Core data
- Cardano Blocks API — block lookups by height or time, epoch/slot context, slot-leader metadata.
- Cardano Transactions API — transaction details, fees in ADA and USD, mint counts, daily counts.
- Cardano Inputs and Outputs API — UTXO-level data for balance reconstruction and transfer feeds.
Addresses and staking
- Cardano Address API — per-asset balances, staking snapshot, and the
addressStatsaggregate cube.
Native tokens
- Cardano Mints API — native-token mint and burn events, including NFT drops and fungible issuance.
Stablecoins
- Djed Stablecoin API — DJED mints, burns, transfers, and wallet-level balance examples.
Fund tracing
- Cardano Coinpath API — multi-hop inbound and outbound ADA flow tracing for compliance and treasury work.