Search
Global semantic search across tokens, blocks, transactions, proposals, pools, and addresses.
Global Search
GET
/v1/search?query=<search_term>Smart routing heuristics determine which entity types to query based on the input pattern. All searches run in parallel.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| query | string | REQUIRED | — | Search term (minimum 1 char) |
| includeSpam | boolean | optional | false | Set to true to include token results classified as likely spam |
| hideSpam | boolean | optional | true | Set to false to include token results classified as likely spam |
🪙 Usage & Credits
This endpoint consumes 250 credits per request against your active API tier.
Notes
- Likely spam token results are hidden by default. Use `includeSpam=true` or `hideSpam=false` to include them.
- Numeric input → searches Blocks by height
- Hex string (≥8 chars) → searches Blocks by hash + Transactions
- Base58 (≥20 chars) → searches Tokens (exact PK) + Address
- Pool ID format (_ and +) → searches DEX Pools
- Short text → fuzzy searches Tokens, Proposals, Pools
Response
json
{
"found": "integer",
"results": [
{
"type": "string",
"id": "string",
"name": "string *",
"icon": "string *",
"height": "integer *",
"extra": "string *",
"spamLikely": "boolean *"
}
]
}Errors
| Status | Condition |
|---|---|
| 400 | Missing query parameter |