Get BRC-20 activity

Retrieves BRC-20 activity filtered by ticker, address, operation, or block height.

GET
/ordinals/v1/brc-20/activity

Query Parameters

ticker?array<string>
block_height?Block Height

Bitcoin block height

Pattern"^[0-9]+$"
operation?array<Operation>
address?Address

Bitcoin address

offset?Offset

Result offset

limit?Limit

Results per page

Range1 <= value <= 60

Response Body

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

limitinteger
offsetinteger
totalinteger
resultsarray<object>
curl -X GET "https://api.hiro.so//ordinals/v1/brc-20/activity?ticker=string&block_height=777678&operation=deploy&address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&offset=0&limit=1"
fetch("https://api.hiro.so//ordinals/v1/brc-20/activity?ticker=string&block_height=777678&operation=deploy&address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&offset=0&limit=1")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//ordinals/v1/brc-20/activity?ticker=string&block_height=777678&operation=deploy&address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&offset=0&limit=1"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.hiro.so//ordinals/v1/brc-20/activity?ticker=string&block_height=777678&operation=deploy&address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&offset=0&limit=1"

response = requests.request("GET", url)

print(response.text)
{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "operation": "deploy",
      "ticker": "PEPE",
      "inscription_id": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218i0",
      "block_height": 778921,
      "block_hash": "0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133",
      "tx_id": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218",
      "location": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218:0:0",
      "address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8",
      "timestamp": 1677733170000,
      "mint": {
        "amount": "1000000"
      },
      "deploy": {
        "max_supply": "21000000",
        "mint_limit": "100000",
        "decimals": 18
      },
      "transfer": {
        "amount": "1000000",
        "from_address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8"
      },
      "transfer_send": {
        "amount": "1000000",
        "from_address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8",
        "to_address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8"
      }
    }
  ]
}