Transaction
What is this endpoint for?
This endpoint offers in-depth insights into Bitcoin wallets at the transaction level over time.
Endpoint
https://us.market-api.kaiko.io/v2/data/wallet.v1/transactions
Parameters
Parameter
Required
Description
Example
The specific transaction hash to query.
f6932e70e4c5483d7b1fa2ee7c56ad89207221bbf186ad0a15cd0cc4e18906f5
Fields
The timestamp of the block.
94ad60ff0ef4cd0f31cab884adc6c39720273e9468ac0019a339911f0dd26e76
f6932e70e4c5483d7b1fa2ee7c56ad89207221bbf186ad0a15cd0cc4e18906f5
The index of the transaction.
The addresses that sends the coin.
[1A8MMLhpGEyNqEsqzkReXtmBx9LBQgt8Mh]
The addresses that receives the coin.
[19Ntq9wC9i39284EZVVf4R7DbCz7gThxzs,12eKGe5hLdKBe8mQ7dv8NixEcX96XHBkoZ]
Symbol of the coin transfered
Amount of asset transfered.
Fees paid for the transaction.
Amount of asset transferred in usd.
Fees paid for the transaction in usd.
Request example
curl --compressed -H "Accept: application/json" -H "X-Api-Key: <client-api-key>" \
"https://eu.market-api.kaiko.io/v2/data/wallet.v1/transactions?blockchain=bitcoin"
##### 1. Import dependencies #####
import requests
import pandas as pd
##### 2. Choose the value of the query's parameters #####
# ---- Required parameters ---- #
blockchain = "bitcoin"
# ---- Optional parameters ---- #
start_block = 600000
end_block = 600001
start_time = None
end_time = None
page_size = 100
sort = "desc"
transaction_hash = None
# ---- API key configuration ---- #
api_key = "YOUR_API_KEY"
##### 3. Get the data #####
# ---- Function to run an API call ---- #
# Get the data in a dataframe --------- #
def get_kaiko_data(api_key: str, blockchain: str, start_block: int, end_block: int, start_time: str, end_time: str, page_size: int, sort: str, transaction_hash: str):
headers = {'Accept': 'application/json', 'X-Api-Key': api_key}
url = f'https://us.market-api.kaiko.io/v2/data/wallet.v1/transactions'
params = {
"blockchain": blockchain,
"start_block": start_block,
"end_block": end_block,
"start_time": start_time,
"end_time": end_time,
"page_size": page_size,
"sort": sort,
"transaction_hash": transaction_hash
}
try:
res = requests.get(url, headers=headers, params=params)
res.raise_for_status()
data = res.json()
if 'data' not in data:
print("No data returned.")
return pd.DataFrame()
df = pd.DataFrame(data['data'])
# Handle pagination with continuation token
while 'next_url' in data:
next_url = data['next_url']
if next_url is None:
break
res = requests.get(next_url, headers=headers)
res.raise_for_status()
data = res.json()
if 'data' in data:
df = pd.concat([df, pd.DataFrame(data['data'])], ignore_index=True)
return df
except requests.exceptions.RequestException as e:
print(f"API request error: {e}")
return pd.DataFrame()
# ---- Get the data ---- #
df = get_kaiko_data(api_key=api_key, blockchain=blockchain, start_block=start_block, end_block=end_block, start_time=start_time, end_time=end_time, page_size=page_size, sort=sort, transaction_hash=transaction_hash)
print (df)
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"
}
}