ASasksurf
Project

Aggregated Project Detail

Returns a crypto project's profile with selectable sub-resources: overview (description, chains, exchanges), token_info (price, market cap, supply, all-time high/low dates), tokenomics, funding, team, contracts, social, tge_status.

Available fields (via fields): overview, token_info, tokenomics, funding, team, contracts, social, tge_status.

Important: tokenomics is a legacy supply/valuation group (total_supply, circulating_supply, market_cap_usd, fdv). It does not include token unlock schedule, allocation, or unlock percentage data. For unlock schedule and unlocked-supply percentage, use /token/tokenomics.

Lookup: accepts project names directly via q (e.g. ?q=aave) — no need to call /search/project first. Also accepts UUID via id. Returns 404 if not found.

For DeFi metrics (TVL, fees, revenue, volume, users) and per-chain breakdown, use /project/defi/metrics.

get/gateway/v1/project/detail

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

idstring

Surf project UUID. PREFERRED — always use this when available from a previous response (e.g. project_id from /fund/portfolio or id from /search/project). Takes priority over q.

Example:25c6612a-395c-4974-94eb-3b5f9f4b2ed7
x_idstring

Numeric X (Twitter) account ID. Resolves to the associated project.

Example:984188226826010624
handlestring

X (Twitter) handle without @. Resolves to the associated project via twitter account lookup.

Example:uniswap
qstring

Fuzzy entity name search. Only use when 'id' is not available. May return unexpected results for ambiguous names.

Example:ethereum
fieldsstring

Comma-separated sub-resources to include. Can be overview, token_info, tokenomics, funding, team, contracts, social, or tge_status.

Example:overview,token_info,funding

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataObjectResponseHumaProjectDetailBody.json"
}

Changes

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