Search

Read-only endpoints to search for accounts, blocks, smart contracts, and transactions

Search

get

Searches for the blocks, transactions, addresses, smart contracts, and token assets that a term refers to. The term can be a complete identifier or the beginning of one: a block or transaction hash, a Stacks or Bitcoin block height, an address, a contract id, or an asset identifier. Contract and asset names are matched anywhere in the name, so a term like arkadiko finds the contracts and tokens named after it. Names must contain the term; misspellings are not matched. At most 20 results are returned, best match first; there is no pagination, so narrow the term to see something that did not surface. A term that matches nothing returns an empty list rather than an error. Only canonical, mined entities are searched.

Query parameters

qstringRequired

The term to search for. Hex terms need at least 8 characters, addresses at least 6, and contract or asset names at least 3; block heights have no minimum.

Example: {"value":"213377"}

Responses

200

Default Response

application/json

4XX

Default Response

application/json

get/extended/v3/search

GET /extended/v3/search?q=text HTTP/1.1
Host: api.hiro.so/
Accept: */*

{
  "results": [
    {
      "type": "block",
      "result": {
        "height": 777678,
        "hash": "0xdaf79950c5e8bb0c620751333967cdd62297137cdaf79950c5e8bb0c62075133",
        "index_hash": "text",
        "time": 1,
        "time_iso": "2026-10-08T19:18:41.000Z"
      }
    }
  ]
}