SYNTHWAVDocsDocs
Ctrl K
Synthwav / Search Tokens

Search Tokens

GET /api/v1/tip/tokens/search

Required scope: tip:tokens:read

Search accepts a ticker, name, FA metadata address, or complete Coin type. Exact matches rank before prefix and partial matches. Verified Coin, paired-FA, and wrapper-FA identities collapse into one result rooted at the original asset; searching any member still finds that canonical result. Internal family members are never returned by the Synthwav Portal API.

Query parameters

ParameterRequiredDescription
queryYesSearch text, up to 200 characters.
limitNoResults per page, from 1 to 50. Default: 20.
cursorNoOpaque cursor returned by the previous page.
curl "https://api.synthwav.io/api/v1/tip/tokens/search?query=SUPRAWR&limit=20" \
  --header "x-api-key: ${TIP_API_KEY}"

Response

{
  "ok": true,
  "data": {
    "items": [
      {
        "identity": {
          "assetType": "fa",
          "id": "0x82ed1f483b5fc4ad105cef5330e480136d58156c30dc70cd2b9c342981997cee"
        },
        "symbol": "SUPRAWR",
        "name": "SUPRAWR",
        "decimals": 6,
        "icon": null,
        "tags": [],
        "verification": {
          "tipEligible": true,
          "listingStatus": "verified",
          "authorityVerified": true,
          "authorityVerifiedAt": "2026-07-01T00:00:00.000Z",
          "stewardActive": false
        },
        "family": {
          "tipProfileId": "fa:0x82ed1f483b5fc4ad105cef5330e480136d58156c30dc70cd2b9c342981997cee",
          "canonical": {
            "assetType": "fa",
            "id": "0x82ed1f483b5fc4ad105cef5330e480136d58156c30dc70cd2b9c342981997cee"
          },
          "conflicted": false
        }
      }
    ]
  },
  "meta": {
    "apiVersion": "1",
    "requestId": "f65d9849-4c74-41f6-b386-72bd0dc83d78",
    "generatedAt": "2026-08-28T12:00:00.000Z",
    "query": "suprawr",
    "registryRevision": 42,
    "pagination": {
      "limit": 20,
      "hasMore": false,
      "nextCursor": null
    }
  }
}

authorityVerified is true when the token family's current canonical Authority or active Steward has signed Synthwav's verification challenge, or when a Synthwav registry administrator has manually verified the family. authorityVerifiedAt is the ISO 8601 time of the active verification, or null for an unverified token. These fields are separate from listingStatus: authority verification is not a listing decision, endorsement, identity check, or security audit.

Cursors are bound to both the normalized query and registry revision. If the registry changes between pages, restart the search after a 409 CURSOR_STALE response.

Get Help