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
blockchain		Always bitcoin.	bitcoin
sort		The sorting order for the results.	asc or desc
page_size		Number of results to return data for. (max: 5000). See Pagination	100
start_block		Starting block height (inclusive).	600000
end_block		Ending block height (inclusive).	700000
start_time		Starting time in ISO 8601 (inclusive).	2022-05-01T00:00:00.000Z
end_time		Ending time in ISO 8601 (inclusive).	2022-05-01T00:00:00.000Z
transaction_hash		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?blockchain=bitcoin"

Python

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"
    }
}