{"uid":"cap_lc-Bw_JEC4ed77kpG1BWf","slug":"three-ws-2612074d","name":"three.ws Symbol Availability","description":"three.ws Symbol Availability — given a candidate ticker symbol, check for exact and fuzzy collisions across pump.fun mints indexed by three.ws. Returns exact matches (same symbol on the same network) plus trigram-similar symbols (e.g. \"USDC\" vs \"USDCC\", \"PUMP\" vs \"PMP\"). Use before launching a token to avoid name confusion and aggregator-search dilution.","url":"https://three.ws/api/x402/symbol-availability","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ticker"],"properties":{"ticker":{"type":"string","maxLength":32,"minLength":1},"network":{"enum":["mainnet","devnet"],"type":"string","default":"mainnet"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ticker","network","exact_collision","exact_matches","similar","recommendation"],"properties":{"ticker":{"type":"string"},"network":{"type":"string"},"similar":{"type":"array","items":{"type":"object"}},"indexed_at":{"type":"string","format":"date-time"},"exact_matches":{"type":"array","items":{"type":"object"}},"recommendation":{"type":"string"},"exact_collision":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json"},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ticker":"TESTAI","network":"mainnet"}}},"response":{"ticker":"TESTAI","network":"mainnet","similar":[{"mint":"Aodd9LBDCue4HN6KyhpSai7yudFCoEWJ3FLHdgYajQzb","name":"deployed from three.ws","ticker":"TEST","similarity":0.5,"deployed_at":"2026-05-13T10:15:28.904Z"},{"mint":"Dc7aRCkV7V3PSBqu3KeXSaDMuc1JpnEEXHK9R9sEKEoY","name":"test","ticker":"TEST","similarity":0.5,"deployed_at":"2026-05-25T16:52:44.076Z"},{"mint":"DGW8x5hFraSNXJ9ctn8tfkP5AvyjpEQBwCX8yFsiMjL4","name":"test","ticker":"TEST","similarity":0.5,"deployed_at":"2026-05-25T17:37:24.606Z"}],"indexed_at":"2026-06-05T22:59:16.627Z","exact_matches":[],"recommendation":"available — 3 near-match(es) exist below 0.8 similarity","exact_collision":false}},"exampleRequest":{"ticker":"TESTAI","network":"mainnet"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OZ_SFPOyzSsag_e5NZkzM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a candidate ticker symbol is already in use on pump.fun by returning exact matches and trigram-similar symbols across indexed Solana mints.","exampleAgentPrompt":"Before I launch my new token, can you check if the symbol 'MOONFI' is already taken or has any similar-sounding tickers on pump.fun on the Solana network so I don't get confused with existing mints?","exampleUseCases":[{"title":"Avoid ticker confusion before token launch","prompt":"I'm about to release a token with the symbol 'SOLANA' on pump.fun—can you quickly check if that's already taken or if there are any similar symbols that might confuse users?"},{"title":"Validate unique branding for meme coin","prompt":"My team wants to launch 'DOGE2' as our ticker on Solana, but I need to make sure it won't clash with existing mints or symbols that sound too similar on pump.fun."},{"title":"Find safe alternative symbols","prompt":"The symbol I wanted, 'LUNA', looks like it might collide with something on pump.fun. Can you show me what similar symbols already exist so we can pick a safer alternative for our token launch?"}],"resultDescription":"Returns a boolean exact_collision flag, a list of exact_matches (same symbol on the same network), a list of trigram-similar symbols with their metadata, a human-readable recommendation string, and the indexed_at timestamp of the data.","failureModes":["Ticker symbol not provided — returns validation error","Network not specified — may return ambiguous or empty results","Symbol not yet indexed by three.ws — returns no matches but collision may still exist on-chain","Rate limiting or payment failure via x402 — returns 402 Payment Required","Trigram similarity threshold may miss highly abbreviated near-duplicates"],"whenToPreferThis":"Use this endpoint when a user wants to check ticker symbol uniqueness specifically within the pump.fun ecosystem on Solana before token launch. It provides both exact and fuzzy collision detection in a single call, which is more thorough than a simple name search. Prefer this over generic blockchain explorers when aggregator-search dilution and brand confusion are the concern.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:08.611Z","isFirstParty":false}