Sign in
search

Unified search across all entity types.

?q= is required. ?type= (CSV) restricts the result to specific entity types — values must be in the closed allowlist (transaction, contract, asset, account, nft, pool). ?limit= caps each entity bucket independently (default 10, ceiling 50).

Behaviour (task 0271):

  • One SQL path: broad search across the six entity-typed CTEs.
  • Response is { "groups": {…} } with up to limit rows per entity bucket. Rows carry the same columns regardless of bucket: entity_type, identifier, label, route_token (asset routing token or null), plus optional enrichment (successful, last_activity_at) and composite routing (contract_id, token_id) fields.
  • FE decides "singleton → direct navigation" by inspecting the response: total row count == 1 and routeForHit(singleton) resolves ⇒ navigate; else show the dropdown / list.

Authoritative SQL: search::queries.

get/v1/search

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

qstring required

Search query string. Required, non-empty after trim.

typestring

CSV of entity types to include. Allowed: transaction, contract, asset, account, nft, pool.

limitinteger

Per-group result cap. Default 10, max 50.

Response

Search results

Changes

No recorded changes to this operation across all 50 revisions of this API.