---
title: "GET /api/autocomplete"
method: GET
path: "/api/autocomplete"
tags: ["autocomplete", "ens", "erc20", "farcaster"]
---

# GET /api/autocomplete

`GET /api/autocomplete`

Retrieve a list of autocomplete suggestions

## Query parameters

- `query` string, required — The query to autocomplete
- `char` '@' | '$', required — The prefix character. $ is more specific and looks only for ERC20 tokens (by address or symbol), @ is more general and looks for ENS/Farcaster name and ERC20 tokens.

## Response `200`

List of autocomplete suggestions

- object
  - `results` union[], required
    - union
      - object
        - `type` 'ens', required
        - `address` string, required — Hex format string, e.g. `0x1234567890abcdef`
        - `name` string, required
        - `avatarUrl` string, nullable, required
        - `url` string, required
        - `value` string, required — The value in hex format of the autocomplete suggestion that should be used.
      - object
        - `type` 'erc20', required
        - `address` string, required — Hex format string, e.g. `0x1234567890abcdef`
        - `name` string, required
        - `symbol` string, required
        - `caip19` string, required
        - `chainId` integer, required
        - `decimals` integer, required
        - `logoURI` string, nullable, required
        - `value` string, required — The value in CAIP-19 format of the autocomplete suggestion that should be used.
      - object
        - `type` 'farcaster', required
        - `address` string, required — Hex format string, e.g. `0x1234567890abcdef`
        - `fid` integer, required
        - `fname` string, required
        - `displayName` string, nullable
        - `username` string, required
        - `pfpUrl` string, nullable
        - `url` string, required
        - `value` string, required — The value in hex format of the autocomplete suggestion that should be used.

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/ethcomments/apis/ethereum-comments-protocol-indexer-api.md) · [All operations](https://skmtc.dev/ethcomments/apis/ethereum-comments-protocol-indexer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ethcomments/ethereum-comments-protocol-indexer-api/revisions/fc5aae1cdc03/schema)