> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Project Detail



## OpenAPI

````yaml openapi.json GET /gateway/v1/project/detail
openapi: 3.1.0
info:
  title: Hermod
  version: 0.0.1
servers:
  - url: https://api.asksurf.ai
security: []
paths:
  /gateway/v1/project/detail:
    get:
      tags:
        - Project
      summary: Aggregated Project Detail
      description: >-
        Returns multiple project sub-resources in a single request.


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


        **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`.
      operationId: project-detail
      parameters:
        - description: >-
            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.
          explode: false
          in: query
          name: id
          schema:
            description: >-
              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.
            examples:
              - 25c6612a-395c-4974-94eb-3b5f9f4b2ed7
            type: string
        - description: >-
            Fuzzy entity name search. Only use when 'id' is not available. May
            return unexpected results for ambiguous names.
          explode: false
          in: query
          name: q
          schema:
            description: >-
              Fuzzy entity name search. Only use when 'id' is not available. May
              return unexpected results for ambiguous names.
            examples:
              - ethereum
            type: string
        - description: >-
            Comma-separated sub-resources to include. Can be `overview`,
            `token_info`, `tokenomics`, `funding`, `team`, `contracts`,
            `social`, or `tge_status`.
          explode: false
          in: query
          name: fields
          schema:
            default: >-
              overview,token_info,tokenomics,funding,team,contracts,social,tge_status
            description: >-
              Comma-separated sub-resources to include. Can be `overview`,
              `token_info`, `tokenomics`, `funding`, `team`, `contracts`,
              `social`, or `tge_status`.
            examples:
              - overview,token_info,funding
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataObjectResponseHumaProjectDetailBody'
          description: OK
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataAPIError'
          description: Error
      security:
        - AccessToken: []
components:
  schemas:
    DataObjectResponseHumaProjectDetailBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - >-
              https://example.com/schemas/DataObjectResponseHumaProjectDetailBody.json
          format: uri
          readOnly: true
          type: string
        data:
          $ref: '#/components/schemas/HumaProjectDetailBody'
        meta:
          $ref: '#/components/schemas/ObjectResponseMeta'
      required:
        - data
        - meta
      type: object
    DataAPIError:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://example.com/schemas/DataAPIError.json
          format: uri
          readOnly: true
          type: string
        error:
          $ref: '#/components/schemas/DataAPIErrorDetail'
      required:
        - error
      type: object
    HumaProjectDetailBody:
      additionalProperties: false
      properties:
        contracts:
          $ref: '#/components/schemas/ProjectContractsItem'
          description: Deployed smart contract addresses across chains
        funding:
          $ref: '#/components/schemas/ProjectFundingItem'
          description: Fundraising history (rounds, amounts, investors)
        overview:
          $ref: '#/components/schemas/ProjectOverviewItem'
          description: >-
            Comprehensive project overview (name, description, website, tags,
            chains, token symbol, social handles)
        social:
          $ref: '#/components/schemas/ProjectSocialItem'
          description: Social media links and follower counts
        team:
          $ref: '#/components/schemas/ProjectTeamItem'
          description: Team members with roles and social links
        tge_status:
          $ref: '#/components/schemas/ProjectTgeStatusItem'
          description: TGE status and exchange listings (pre/upcoming/post)
        token_info:
          $ref: '#/components/schemas/ProjectTokenInfoItem'
          description: Native token market data (price, supply, market cap, price changes)
        tokenomics:
          $ref: '#/components/schemas/ProjectTokenomicsItem'
          description: Token distribution and supply metrics
      type: object
    ObjectResponseMeta:
      additionalProperties: false
      properties:
        cached:
          description: Whether this response was served from cache
          type: boolean
        credits_used:
          description: Credits deducted for this request
          format: int64
          type: integer
      required:
        - credits_used
        - cached
      type: object
    DataAPIErrorDetail:
      additionalProperties: false
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      type: object
    ProjectContractsItem:
      additionalProperties: false
      properties:
        contracts:
          description: List of deployed smart contract addresses across chains
          items:
            $ref: '#/components/schemas/ProjectContractAddress'
          type:
            - array
            - 'null'
      type: object
    ProjectFundingItem:
      additionalProperties: false
      properties:
        rounds:
          description: List of individual funding rounds
          items:
            $ref: '#/components/schemas/ProjectFundingRound'
          type:
            - array
            - 'null'
        total_raise:
          description: Total capital raised across all rounds in USD
          format: double
          type: number
      type: object
    ProjectOverviewItem:
      additionalProperties: false
      properties:
        chains:
          description: Chains the project is deployed on
          items:
            type: string
          type:
            - array
            - 'null'
        description:
          description: Short description of the project
          type: string
        exchanges:
          description: Exchange names where the token is listed
          items:
            type: string
          type:
            - array
            - 'null'
        id:
          description: >-
            Surf project UUID — pass as 'id' parameter to /project/detail,
            /project/events, or /project/defi/metrics for exact lookup. Prefer
            over 'q' (fuzzy name search).
          type: string
        logo_url:
          description: Project logo image URL
          type: string
        name:
          description: Project name
          type: string
        slug:
          description: URL-friendly project slug
          type: string
        tags:
          description: Project category tags like `DeFi`, `NFT`, or `Layer2`
          items:
            type: string
          type:
            - array
            - 'null'
        tge_status:
          description: 'TGE status: pre, upcoming, or post'
          type: string
        token_symbol:
          description: Primary token ticker symbol
          type: string
        website:
          description: Project official website URL
          type: string
        x_followers:
          description: Number of X (Twitter) followers
          format: int64
          type: integer
        x_handle:
          description: X (Twitter) handle without the @ prefix
          type: string
      required:
        - id
        - name
        - x_followers
      type: object
    ProjectSocialItem:
      additionalProperties: false
      properties:
        discord:
          $ref: '#/components/schemas/ProjectSocialAccount'
          description: Discord community server
        github:
          $ref: '#/components/schemas/ProjectSocialAccount'
          description: GitHub organization or repository account
        telegram:
          $ref: '#/components/schemas/ProjectSocialAccount'
          description: Telegram group or channel
        twitter:
          $ref: '#/components/schemas/ProjectSocialAccount'
          description: X (Twitter) account for the project
      type: object
    ProjectTeamItem:
      additionalProperties: false
      properties:
        members:
          description: List of team members with their roles and social links
          items:
            $ref: '#/components/schemas/ProjectTeamMember'
          type:
            - array
            - 'null'
      type: object
    ProjectTgeStatusItem:
      additionalProperties: false
      properties:
        current_status:
          description: 'TGE status: `pre`, `upcoming`, or `post`. Omitted when unknown.'
          type: string
        exchanges:
          description: Exchange names where the token is listed
          items:
            type: string
          type:
            - array
            - 'null'
        last_event_time:
          description: Unix timestamp of the last TGE event
          format: int64
          type: integer
      type: object
    ProjectTokenInfoItem:
      additionalProperties: false
      properties:
        all_time_high:
          description: All-time high price in USD
          format: double
          type: number
        all_time_low:
          description: All-time low price in USD
          format: double
          type: number
        circulating_supply:
          description: Circulating token supply
          format: double
          type: number
        fdv:
          description: Fully diluted valuation in USD
          format: double
          type: number
        high_24h:
          description: 24-hour high price in USD
          format: double
          type: number
        image:
          description: Token logo image URL
          type: string
        low_24h:
          description: 24-hour low price in USD
          format: double
          type: number
        market_cap_usd:
          description: Market capitalization in USD
          format: double
          type: number
        name:
          description: Full token name
          type: string
        price_change_24h:
          description: 24-hour price change percentage
          format: double
          type: number
        price_change_30d:
          description: 30-day price change percentage
          format: double
          type: number
        price_change_7d:
          description: 7-day price change percentage
          format: double
          type: number
        price_usd:
          description: Current price in USD
          format: double
          type: number
        symbol:
          description: Token ticker symbol
          type: string
        total_supply:
          description: Total token supply
          format: double
          type: number
        volume_24h:
          description: 24-hour trading volume in USD
          format: double
          type: number
      required:
        - symbol
        - name
      type: object
    ProjectTokenomicsItem:
      additionalProperties: false
      properties:
        circulating_supply:
          description: Number of tokens currently in public circulation
          format: double
          type: number
        fdv:
          description: Fully diluted valuation in USD
          format: double
          type: number
        market_cap_usd:
          description: Total market capitalization in USD
          format: double
          type: number
        total_supply:
          description: Total token supply
          format: double
          type: number
      type: object
    ProjectContractAddress:
      additionalProperties: false
      properties:
        address:
          description: Contract address on the specified chain
          type: string
        chain:
          description: Chain name like `ethereum`, `bsc`, or `solana`
          type: string
        label:
          description: Human-readable label for this contract like `Token` or `Staking`
          type: string
      required:
        - chain
        - address
      type: object
    ProjectFundingRound:
      additionalProperties: false
      properties:
        amount:
          description: Amount raised in USD
          format: double
          type: number
        date:
          description: Date when the round closed in ISO 8601 format
          type: string
        investors:
          description: Investors participating in this round
          items:
            $ref: '#/components/schemas/ProjectFundingInvestor'
          type:
            - array
            - 'null'
        round_name:
          description: Funding round name like `Seed`, `Series A`, or `Private`
          type: string
        valuation:
          description: Project valuation at round close in USD
          format: double
          type: number
      required:
        - round_name
      type: object
    ProjectSocialAccount:
      additionalProperties: false
      properties:
        followers_count:
          description: Number of followers on this platform
          format: int64
          type: integer
        handle:
          description: Username or handle on the social platform
          type: string
        url:
          description: Profile URL on the social platform
          type: string
      type: object
    ProjectTeamMember:
      additionalProperties: false
      properties:
        image:
          description: Team member profile image URL
          type: string
        name:
          description: Team member's full name
          type: string
        role:
          description: Team member's role or title
          type: string
        social_links:
          additionalProperties:
            type: string
          description: >-
            Social profile links keyed by platform name like `twitter` or
            `linkedin`
          type: object
      required:
        - name
      type: object
    ProjectFundingInvestor:
      additionalProperties: false
      properties:
        is_lead:
          description: Whether this investor led the round
          type: boolean
        logo:
          description: Investor logo URL
          type: string
        name:
          description: Investor name
          type: string
        type:
          description: Investor type (FUND or PERSON)
          type: string
      required:
        - name
        - is_lead
      type: object

````