Transaction

What is this endpoint for?

This endpoint offers in-depth insights into Bitcoin and other UTXO wallets at the transaction level over time.

Wallet Data can also be accessed through Google BigQuery. To get started, read our guide.

Endpoint

https://us.market-api.kaiko.io/v2/data/wallet.v1/transactions

Parameters

Parameter	Required	Description	Example
blockchain	No	Should be one of the currently supported blockchains.	bitcoin
sort	No	The sorting order for the results.	asc or desc
page_size	No	Number of results to return data for. (max: 5000). See Pagination	100
start_block	No	Starting block height (inclusive).	600000
end_block	No	Ending block height (inclusive).	700000
start_date	No	Starting time in ISO 8601 (inclusive).	2022-05-01T00:00:00.000Z
end_date	No	Ending time in ISO 8601 (inclusive).	2022-05-01T00:00:00.000Z
transaction_hash	No	The specific transaction hash to query.	f6932e70e4c5483d7b1fa2ee7c56ad89207221bbf186ad0a15cd0cc4e18906f5

Fields

Field	Description	Example
chain	Blockchain name.	bitcoin
block_number	The height of the block.	395211
timestamp	The timestamp of the block.	1453853136
transaction_hash	Transaction hash.	94ad60ff0ef4cd0f31cab884adc6c39720273e9468ac0019a339911f0dd26e76
transaction_id	Transaction ID.	f6932e70e4c5483d7b1fa2ee7c56ad89207221bbf186ad0a15cd0cc4e18906f5
transaction_index	The index of the transaction.	0
sender_addresses	The addresses that sends the coin.	[1A8MMLhpGEyNqEsqzkReXtmBx9LBQgt8Mh]
receiver_addresses	The addresses that receives the coin.	[19Ntq9wC9i39284EZVVf4R7DbCz7gThxzs,12eKGe5hLdKBe8mQ7dv8NixEcX96XHBkoZ]
token_symbol	Symbol of the coin transfered	BTC
amount_out	Amount of asset transfered.	10.12592654
fees	Fees paid for the transaction.	0.0004
amount_out_usd	Amount of asset transferred in usd.	3965.771819253574
fees_usd	Fees paid for the transaction in usd.	0.15665813112855445

Request example

cURL

curl --compressed -H "Accept: application/json" -H "X-Api-Key: <client-api-key>" \
  "https://eu.market-api.kaiko.io/v2/data/wallet.v1/transactions"

Python

import http.client
import json

# Enter your Kaiko API Key
api_key = "KAIKO_API_KEY"
api_host = "us.market-api.kaiko.io"
api_base_endpoint = "/v2/data/wallet.v1/transactions"

# Start of parameter configuration
optional_params = {
    "blockchain": "bitcoin",
    "start_time":'2024-01-01T00:00:00.000Z",
    "end_time":'2024-01-02T00:00:00.000Z",
}
# End of parameter configuration

conn = http.client.HTTPSConnection(api_host)
headers = {
    "X-Api-Key": api_key,
    "Accept": "application/json"
}

url_params = []
for param, value in optional_params.items():
    url_params.append(f"{param}={value}")
url_params = '&'.join(url_params)

# Pagination for next pages
all_data = []
next_url = f"{api_base_endpoint}?{url_params}"
while next_url:
    conn.request("GET", next_url, headers=headers)
    response = conn.getresponse()
    data = json.loads(response.read().decode("utf-8"))
    all_data.extend(data.get("data", []))
    print(f"Fetched {len(data.get('data', []))} datapoints. Total: {len(all_data)}")
    next_url = data.get("next_url", "").replace("https://us.market-api.kaiko.io", "")
    if not next_url:
        break
conn.close()
print(f" datapoints fetched: {(all_data)}")

Response example

{
    "query":
    {
        "live": "False",
        "start_time": "2009-01-01T00:00:00.000Z",
        "end_time": "2009-01-01T00:00:00.000Z",
        "start_block": 0,
        "end_block": 0,
        "page_size": 1000,
        "sort": "ASCENDING",
        "data_version": "v1",
        "commodity": "wallet_data",
        "request_time": "2009-01-01T00:00:00.000Z"
    },
    "time": "2009-01-01T00:00:00.000Z",
    "timestamp": 1704069091000,
    "access":
    {
        "access_range":
        {
            "start_timestamp": 1073001600000,
            "end_timestamp": "None"
        },
        "data_range":
        {
            "start_timestamp": "None",
            "end_timestamp": "None"
        }
    },
    "data":
    [
        {
            "chain": "bitcoin",
            "block_number": 823787,
            "timestamp": 1704069091000000000,
            "transaction_hash": "e651241e9982332ea4cf59923d8cbc7468e1960bb5ab9f68d9e72984830c530c",
            "transaction_id": "e651241e9982332ea4cf59923d8cbc7468e1960bb5ab9f68d9e72984830c530c",
            "transaction_index": 15,
            "sender_addresses":
            [
                "1n8gms991ydy1e696e9sb9esyy5cksu7hz"
            ],
            "receiver_addresses":
            [
                "1n8gms991ydy1e696e9sb9esyy5cksu7hz",
                "3juadjkqtgzr9p9n59rtugv5pl2tohf6t9",
                "bc1q5g4w7sajpqvd0syvghsqvrxcf2ysxce0yxqjkx"
            ],
            "token_symbol": "BTC",
            "amount_out": 0.37257751,
            "fees": 0.0014,
            "amount_out_usd": 15729.55,
            "fees_usd": 59.1
        },
        /* ... */
    ],
    "continuation_token": "xxx",
    "next_url": "https://us.market-api.kaiko.io/v2/data/wallet.v1/transactions?continuation_token=xxx"
    }
}