Project Detail

GET/gateway/v1/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`.

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

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

Project Detail

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/project/detail?id=25c6612a-395c-4974-94eb-3b5f9f4b2ed7&q=ethereum&fields=overview,token_info,funding', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataObjectResponseHumaProjectDetailBody.json",
  "data": {
    "contracts": {
      "contracts": [
        {
          "address": "<string>",
          "chain": "<string>",
          "label": "<string>"
        }
      ]
    },
    "funding": {
      "rounds": [
        {
          "amount": 123,
          "date": "<string>",
          "investors": [
            {
              "id": "<string>",
              "is_lead": true,
              "logo": "<string>",
              "name": "<string>",
              "type": "<string>"
            }
          ],
          "round_name": "<string>",
          "valuation": 123
        }
      ],
      "total_raise": 123
    },
    "overview": {
      "chains": [],
      "description": "<string>",
      "exchanges": [],
      "id": "<string>",
      "logo_url": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "tags": [],
      "tge_status": "<string>",
      "token_symbol": "<string>",
      "website": "<string>"
    },
    "social": {
      "discord": {
        "followers_count": 123,
        "handle": "<string>",
        "url": "<string>"
      },
      "github": {
        "followers_count": 123,
        "handle": "<string>",
        "url": "<string>"
      },
      "telegram": {
        "followers_count": 123,
        "handle": "<string>",
        "url": "<string>"
      }
    },
    "team": {
      "members": [
        {
          "id": "<string>",
          "image": "<string>",
          "name": "<string>",
          "role": "<string>",
          "social_links": {}
        }
      ]
    },
    "tge_status": {
      "current_status": "<string>",
      "exchanges": [],
      "last_event_time": 123
    },
    "token_info": {
      "all_time_high": 123,
      "all_time_high_date": 123,
      "all_time_low": 123,
      "all_time_low_date": 123,
      "circulating_supply": 123,
      "fdv": 123,
      "high_24h": 123,
      "image": "<string>",
      "low_24h": 123,
      "market_cap_usd": 123,
      "name": "<string>",
      "price_change_24h": 123,
      "price_change_30d": 123,
      "price_change_7d": 123,
      "price_usd": 123,
      "symbol": "<string>",
      "total_supply": 123,
      "volume_24h": 123
    },
    "tokenomics": {
      "circulating_supply": 123,
      "fdv": 123,
      "market_cap_usd": 123,
      "total_supply": 123
    }
  },
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>"
  }
}