BRC-20 transaction history

This endpoint returns the full BRC-20 activity log for a given address, including mints, transfers, and deploys. Paginated and sorted by timestamp.

Ideal for tracking user balances, building history UIs, or monitoring on-chain token behavior.

get

Retrieve transaction history for a specific BRC20 token for a specific address.

Authorizations

apiKey

x-api-keystringRequired

Path parameters

addressstring · BitcoinAddress · min: 10RequiredDefault: bc1q0egjvlcfq77cxd9kvpgppyuxckzvws46e3sxch

tickerstringRequired

Query parameters

offsetnumberOptionalDefault: 0

limitnumber · min: 25 · max: 60OptionalDefault: 60

Responses

200

Default Response

application/json

400

Invalid input

application/json

401

Unauthorized

application/json

404

Not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/v1/ordinals/address/{address}/brc20/{ticker}

HTTPcURLJavaScriptPython

GET /v1/ordinals/address/{address}/brc20/{ticker} HTTP/1.1
Host: api.secretkeylabs.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "transactions": [
    {
      "txid": "text",
      "blockHeight": 1,
      "blockTime": 1,
      "ownActivity": [
        {
          "address": "text",
          "sent": 1,
          "received": 1,
          "outgoing": 1,
          "incoming": 1
        }
      ],
      "totalOut": 1,
      "totalIn": 1,
      "addressList": {
        "hasMore": true,
        "items": [
          {
            "address": "text",
            "type": "text",
            "isInput": true,
            "isOutput": true
          }
        ]
      },
      "runes": {
        "ownActivity": {
          "items": [
            {
              "runeId": "text",
              "runeName": "text",
              "divisibility": 1,
              "symbol": "text",
              "address": "text",
              "sent": "text",
              "received": "text",
              "outgoing": "text",
              "incoming": "text"
            }
          ],
          "hasMore": true
        },
        "allActivity": {
          "items": [
            {
              "runeId": "text",
              "runeName": "text",
              "divisibility": 1,
              "symbol": "text",
              "outgoing": "text",
              "incoming": "text",
              "isMint": true,
              "isEtch": true,
              "isBurn": true
            }
          ],
          "hasMore": true
        }
      },
      "inscriptions": {
        "items": [
          {
            "inscriptionId": "text",
            "contentType": "text",
            "address": "text",
            "sent": true,
            "received": true,
            "inscribed": true,
            "burned": true
          }
        ],
        "hasMore": true
      }
    }
  ],
  "offset": 1,
  "limit": 1
}