Address Transactions

GET /v1/addresses/{address}/transactions

Paginated transaction history for a Kaspa address, indexed from realtime relay events (utxos_changed, mempool_entry).

This endpoint reads from the Kwery Supabase index populated by the tx-indexer worker. Historical activity before the indexer was deployed is not included.

Plan requirement

Developer and Business plans. Free plan users receive 403.

Credits

• 10 credits base + 1 credit per row returned

Query parameters

Example

import kaspa from "kaspa-wasm";

const API_KEY = "kwery_live_YOUR_KEY";
const API_URL = "https://kwery-api.com";

const { Address } = kaspa;
const address = new Address("kaspa:qq...");

const history = await fetch(
  `${API_URL}/v1/addresses/${encodeURIComponent(address.toString())}/transactions?limit=25`,
  { headers: { "X-API-Key": API_KEY } },
).then((r) => r.json());

console.log(history.items, history.next_cursor);

Response

{
  "address": "kaspa:qq...",
  "items": [
    {
      "tx_id": "abc123...",
      "direction": "receive",
      "amount_sompi": 100000000,
      "asset": "KAS",
      "status": "confirmed",
      "counterparty": "kaspa:qq...",
      "block_time": "2025-06-25T12:00:00+00:00",
      "event_kind": "utxos_changed"
    }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "credits_used": 11
}

Use next_cursor for the next page. When next_cursor is null, you are on the last page.