Skip to main content
GET
/
addresses
/
{address}
/
activity
Satoshi Activity by Address
curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/addresses/{address}/activity \
  --header 'api-key: <api-key>'
{
  "data": [
    {
      "amount": "4456732",
      "confirmations": 48,
      "height": 892671,
      "kind": "increase",
      "tx_hash": "9f2d17f672ebb9962940aba94daef140cc876f32edba5e9325c18ca17534120e"
    },
    {
      "amount": "4456732",
      "confirmations": 43,
      "height": 892676,
      "kind": "decrease",
      "tx_hash": "2c34dbe0d8dcbf4faba291e50cda1d9b6f70cccdbb2fcd23a9341d2791845998"
    }
  ],
  "last_updated": {
    "block_hash": "00000000000000000000c7f19aca70cdeab9d7f04a79d1c8283b66dce78796e8",
    "block_height": 892719
  },
  "next_cursor": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.gomaestro.org/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
api-key
string
header
required

Project API Key

Path Parameters

​
address
string
required

Bitcoin address or hex encoded script pubkey

Query Parameters

​
order
enum<string>
default:asc

The order in which the results are sorted. Supported values: asc, desc

Available options:
asc,
desc
​
count
integer
default:100

The max number of results per page

Required range: x >= 0
​
from
integer<int64> | null

Return only transactions included on or after a specific height

Required range: x >= 0
​
to
integer<int64> | null

Return only transactions included on or before a specific height

Required range: x >= 0
​
cursor
string | null

Pagination cursor string, use the cursor included in a page of results to fetch the next page

​
activity_kind
enum<string>

Only return transactions of a specific activity kind. Supported values: "increase" for transactions where satoshi balance increases, "decrease" for decrease, and "self_transfer" for transactions where satoshi balance remained the same.

Available options:
self_transfer,
increase,
decrease
​
exclude_self_transfers
boolean | null

Do not return self-transfer transactions - transactions in which satoshi balance did not increase or decrease.

Response

Requested data

​
data
object[]
required
​
last_updated
object
required
​
next_cursor
string | null