--- title: "Search Arkham addresses, entities, tokens, pools, and names" method: POST path: "/search" tags: ["Search"] --- # Search Arkham addresses, entities, tokens, pools, and names `POST /search` Search Arkham addresses, entities, tokens, pools, and names. $6.00 per call. ## Request body - object - `arkhamAddresses` union — Max Arkham-curated addresses with labels to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `arkhamAddressesOffset` union — Skip the first N Arkham addresses with labels (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `arkhamEntities` union — Max Arkham-curated entities to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `arkhamEntitiesOffset` union — Skip the first N Arkham entities (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `ens` union — Max ENS primary names to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `ensOffset` union — Skip the first N ENS names (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `filterLimits` union — (Legacy. Prefer flat parameters such as arkhamAddresses=50.) URL-encoded JSON object specifying maximum results per cat… - string - number - boolean - union[] - union - string - number - boolean - `filterOffsets` union — (Legacy. Prefer flat parameters such as arkhamAddressesOffset=10.) URL-encoded JSON object specifying pagination offset… - string - number - boolean - union[] - union - string - number - boolean - `opensea` union — Max OpenSea usernames to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `openseaOffset` union — Skip the first N OpenSea usernames (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `polymarketEvents` union — Max Polymarket prediction events to return (0–50, default 0). Also enables the predictions-wallet match for address que… - string - number - boolean - union[] - union - string - number - boolean - `pools` union — Max Solana pools to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `poolsOffset` union — Skip the first N pools (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `query` union — Search query string to match against entities, addresses, tokens, pools, ENS names, and more. An empty query returns no… - string - number - boolean - union[] - union - string - number - boolean - `services` union — Max CEX/VASP entities to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `servicesOffset` union — Skip the first N CEX/VASP entities (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `tags` union — Max tag matches to return (0–50, default 0). - string - number - boolean - union[] - union - string - number - boolean - `tagsOffset` union — Skip the first N tag matches (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `tokens` union — Max tokens to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `tokensOffset` union — Skip the first N tokens (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `twitter` union — Max Twitter-handle matches to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `twitterOffset` union — Skip the first N Twitter matches (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `types` union — Max entity-type matches to return (0–50, default 5). - string - number - boolean - union[] - union - string - number - boolean - `typesOffset` union — Skip the first N entity-type matches (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `userAddresses` union — Max user-defined addresses with labels to return (0–50, default 5). Requires authentication. - string - number - boolean - union[] - union - string - number - boolean - `userAddressesOffset` union — Skip the first N user addresses with labels (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean - `userEntities` union — Max user-defined entities to return (0–50, default 5). Requires authentication. - string - number - boolean - union[] - union - string - number - boolean - `userEntitiesOffset` union — Skip the first N user entities (0–500, default 0). - string - number - boolean - union[] - union - string - number - boolean ## Response `200` Successful response - unknown ## Other responses - `400` — Fatal for the request as written: validation failed or required JSON body fields are missing. Fix the request; do not retry it unchanged. Payment is not settled. - `402` — Payment challenge, not an application error. Read the base64 x402 v2 challenge from PAYMENT-REQUIRED, sign it, and retry the same request with PAYMENT-SIGNATURE. If a post-payment 402 omits PAYMENT-REQUIRED, verification failed: read the new challenge, re-sign, and retry once. - `404` — The upstream Arkham resource does not exist. Fatal for the same input. Payment is not settled. - `429` — Per-wallet endpoint rate limit exceeded. Retry with at least 1 second of backoff; keep heavy endpoints at no more than 1 request per second. - `5XX` — Arkham failed or timed out, including 502 and 504 responses. Retry with backoff. x402 payments and MPP transaction credentials are not settled for failed requests; MPP hash credits are redeemed at admission and are not refunded automatically. --- [API](https://skmtc.net/arkm/apis/arkham-x402.md) · [All operations](https://skmtc.net/arkm/apis/arkham-x402/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkm/arkham-x402/revisions/7830c19a58c4/schema)