# 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 /v1/ordinals/address/{address}/brc20/{ticker}

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

```json
{"openapi":"3.0.3","info":{"title":"SecretKeyLabs API","version":"1.0.0"},"tags":[{"name":"Ordinals"}],"servers":[{"url":"https://api.secretkeylabs.io"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}}},"paths":{"/v1/ordinals/address/{address}/brc20/{ticker}":{"get":{"tags":["Ordinals"],"description":"Retrieve transaction history for a specific BRC20 token for a specific address.","parameters":[{"schema":{"default":0,"minimum":0,"type":"number"},"in":"query","name":"offset","required":false},{"schema":{"default":60,"minimum":25,"maximum":60,"type":"number"},"in":"query","name":"limit","required":false},{"schema":{"minLength":10,"default":"bc1q0egjvlcfq77cxd9kvpgppyuxckzvws46e3sxch","format":"BitcoinAddress","type":"string"},"in":"path","name":"address","required":true},{"schema":{"type":"string"},"in":"path","name":"ticker","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"transactions":{"type":"array","items":{"type":"object","properties":{"txid":{"type":"string"},"blockHeight":{"type":"number"},"blockTime":{"type":"number"},"ownActivity":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"sent":{"type":"number"},"received":{"type":"number"},"outgoing":{"type":"number"},"incoming":{"type":"number"}},"required":["address","sent","received","outgoing","incoming"]}},"totalOut":{"type":"number"},"totalIn":{"type":"number"},"addressList":{"type":"object","properties":{"hasMore":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"type":{"type":"string"},"isInput":{"type":"boolean"},"isOutput":{"type":"boolean"}},"required":["type","isInput","isOutput"]}}},"required":["hasMore","items"]},"runes":{"type":"object","properties":{"ownActivity":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"runeId":{"type":"string"},"runeName":{"type":"string"},"divisibility":{"type":"number"},"symbol":{"type":"string"},"address":{"type":"string"},"sent":{"type":"string"},"received":{"type":"string"},"outgoing":{"type":"string"},"incoming":{"type":"string"}},"required":["runeId","runeName","divisibility","symbol","address","sent","received","outgoing","incoming"]}},"hasMore":{"type":"boolean"}},"required":["items","hasMore"]},"allActivity":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"runeId":{"type":"string"},"runeName":{"type":"string"},"divisibility":{"type":"number"},"symbol":{"type":"string"},"outgoing":{"type":"string"},"incoming":{"type":"string"},"isMint":{"type":"boolean"},"isEtch":{"type":"boolean"},"isBurn":{"type":"boolean"}},"required":["runeId","runeName","divisibility","symbol","outgoing","incoming","isMint","isEtch","isBurn"]}},"hasMore":{"type":"boolean"}},"required":["items","hasMore"]}},"required":["ownActivity","allActivity"]},"inscriptions":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"inscriptionId":{"type":"string"},"contentType":{"type":"string"},"address":{"type":"string"},"sent":{"type":"boolean"},"received":{"type":"boolean"},"inscribed":{"type":"boolean"},"burned":{"type":"boolean"}},"required":["inscriptionId","address","sent","received","inscribed","burned"]}},"hasMore":{"type":"boolean"}},"required":["items","hasMore"]}},"required":["txid","blockHeight","blockTime","ownActivity","totalOut","totalIn","addressList","runes","inscriptions"]}},"offset":{"type":"number"},"limit":{"type":"number"}},"required":["transactions","offset","limit"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"description":"Invalid input","type":"string"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"description":"Unauthorized","type":"string"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not found","type":"string"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"description":"Rate limit exceeded","type":"string"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"description":"Internal server error","type":"string"}}}}}}}}}
```