---
title: "GET /v1/cq/covalent/app/bitcoin/transactions/"
method: GET
path: "/v1/cq/covalent/app/bitcoin/transactions/"
tags: ["get-transactions-for-bitcoin-address"]
---

# GET /v1/cq/covalent/app/bitcoin/transactions/

`GET /v1/cq/covalent/app/bitcoin/transactions/`

## Request

- Base URL: `https://api.covalenthq.com`
- URL: `https://api.covalenthq.com/v1/cq/covalent/app/bitcoin/transactions/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/docs/v1/cq/covalent/app/bitcoin/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches the full transaction history of a Bitcoin non-HD wallet address.

## Query parameters

- `address` string
- `page-size` integer
- `page-number` integer

## Response `200`

Successful response

- object
  - `updated_at` string, date-time: The timestamp when the response was generated. Useful to show data staleness to users.
  - `items` object[]: List of response items.
    - `chain_id` integer: The requested chain ID eg: `20090103`.
    - `chain_name` string: The requested chain name eg: `btc-mainnet`.
    - `contract_decimals` integer: Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`.
    - `block_signed_at` string, date-time: The block signed timestamp in UTC.
    - `block_height` integer: The height of the block.
    - `block_hash` string: The hash of the block.
    - `tx_hash` string: The requested transaction hash.
    - `tx_idx` integer: The position index of the tx in the block.
    - `type` string: Either 'input' as the sender or 'output' as the receiver of btc.
    - `address` string: The wallet address.
    - `value` string: b;The value attached to this tx in satoshi.
    - `quote` number, double: The value attached to this tx in USD.
    - `quote_rate` number, double: The value token exchange rate in USD.
    - `fees_paid` string: b;The total transaction fees denoted in satoshi.
    - `gas_quote` number, double: The gas spent in USD.
    - `gas_quote_rate` number, double: The native gas token exchange rate in USD.
    - `coinbase` boolean: Indicates if this is a coinbase tx where btc is rewarded to a miner for validating the block.
    - `locktime` integer: The earliest Unix timestamp or block height at which the tx is valid and can be included. Is `0` if no restriction.
    - `weight` integer: A measure that reflects impact on the block size limit. Used to determine fees.
  - `pagination` object: Pagination metadata.
    - `has_more` boolean: True if there is another page.
    - `page_number` integer: The requested page number.
    - `page_size` integer: The requested number of items on the current page.
    - `total_count` integer: The total number of items across all pages for this request.

---

[API](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis.md) - [All operations](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/revisions/31713d2c30bc?raw)