Guava Wallet Intelligence API

openapi: 3.1.0
info:
  title: Guava Wallet Intelligence API
  version: '2026-11-11'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-11: 35 operation(s) read from 4 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Guava Wallet Intelligence has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 4
    documentation: 31
    pages-with-code: 4
    pages-read: 4
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-11'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.guavaintel.com/api
  - https://www.guavaintel.com/api-reference
  - https://www.guavaintel.com/api-access
  - https://www.guavaintel.com/docs
servers:
- url: https://api.guavaintel.com
paths:
  /address/{chain}/{address}/security:
    get:
      operationId: get_address_chain_address_security
      tags:
      - Address
      summary: Detect honeypots, rug pulls, and 30+ risk factors.
      x-source: https://www.guavaintel.com/api
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/chains:
    get:
      operationId: get_api_v1_chains
      tags:
      - Api
      summary: List Supported Chains
      x-source: https://www.guavaintel.com/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ChainsResponse'
      x-evidence:
        kind: documentation
  /api/v1/keys:
    get:
      operationId: get_api_v1_keys
      tags:
      - Api
      summary: Get API Key Info
      x-source: https://www.guavaintel.com/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1KeysResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_keys
      tags:
      - Api
      summary: Generate API Key
      x-source: https://www.guavaintel.com/api-reference
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1KeysResponse'
      x-evidence:
        kind: documentation
  /api/v1/nft/ai-analysis/{chain}/{address}:
    get:
      operationId: get_api_v1_nft_ai_analysis_chain_address
      tags:
      - Api
      summary: AI-powered safety analysis for an NFT collection (Pro only).
      x-source: https://www.guavaintel.com/docs
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nft/collection-health/{chain}/{address}:
    get:
      operationId: get_api_v1_nft_collection_health_chain_address
      tags:
      - Api
      summary: Get health score for an NFT collection (holder distribution, wash trade, metadata).
      x-source: https://www.guavaintel.com/docs
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nft/collection-stats/{chain}/{address}:
    get:
      operationId: get_api_v1_nft_collection_stats_chain_address
      tags:
      - Api
      summary: 'Get OpenSea market stats: floor price, volume, sales, owners, market cap.'
      x-source: https://www.guavaintel.com/docs
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nft/mint-scan:
    post:
      operationId: post_api_v1_nft_mint_scan
      tags:
      - Api
      summary: Scan an NFT contract for drainers, rug indicators, and deployer reputation.
      x-source: https://www.guavaintel.com/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nft/search:
    get:
      operationId: get_api_v1_nft_search
      tags:
      - Api
      summary: Search OpenSea for collections, NFTs, and tokens by name.
      x-source: https://www.guavaintel.com/docs
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nft/trending-collections:
    get:
      operationId: get_api_v1_nft_trending_collections
      tags:
      - Api
      summary: Get trending NFT collections from OpenSea sorted by volume or change.
      x-source: https://www.guavaintel.com/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/token/{chain}/{contract}/security:
    get:
      operationId: get_api_v1_token_chain_contract_security
      tags:
      - Api
      summary: Token Security Check
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: contract
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1TokenChainContractSecurityResponse'
      x-evidence:
        kind: documentation
  /api/v1/usage:
    get:
      operationId: get_api_v1_usage
      tags:
      - Api
      summary: Get Usage Stats
      x-source: https://www.guavaintel.com/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1UsageResponse'
      x-evidence:
        kind: documentation
  /api/v1/wallet/{chain}/{address}:
    get:
      operationId: get_api_v1_wallet_chain_address
      tags:
      - Api
      summary: Analyze Wallet
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1WalletChainAddressResponse'
      x-evidence:
        kind: documentation
  /chains:
    get:
      operationId: get_chains
      tags:
      - Chains
      summary: Multi-Chain Support for 31 blockchains including Ethereum, Solana, BSC, Polygon, Arbitrum, and more.
      x-source: https://www.guavaintel.com/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /compare:
    post:
      operationId: post_compare
      tags:
      - Compare
      summary: Compare multiple wallets side-by-side. Rank by value, risk, or activity.
      x-source: https://www.guavaintel.com/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /keys:
    get:
      operationId: get_keys
      tags:
      - Keys
      summary: Get API Key Info
      x-source: https://www.guavaintel.com/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetKeysResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_keys
      tags:
      - Keys
      summary: Generate API Key
      x-source: https://www.guavaintel.com/api-reference
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostKeysResponse'
      x-evidence:
        kind: documentation
  /platform-alerts:
    get:
      operationId: get_platform_alerts
      tags:
      - Platform Alerts
      summary: Scam Platform Feed
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Results per page (max 200)
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: Pagination offset
      - name: reported_by
        in: query
        required: false
        schema:
          type: string
        description: iscan | cma_kenya | manual_seed | community
      - name: scam_type
        in: query
        required: false
        schema:
          type: string
        description: ponzi | unlicensed_platform | clone_firm | phishing
      - name: search
        in: query
        required: false
        schema:
          type: string
        description: Search domain, platform, or corporate name
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAlertsResponse'
      x-evidence:
        kind: documentation
  /portfolio/{address}:
    get:
      operationId: get_portfolio_address
      tags:
      - Portfolio
      summary: Get comprehensive wallet data including portfolio, risk scores, transaction history, and behavioral patterns.
      x-source: https://www.guavaintel.com/api
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /portfolio/{address}/stablecoins:
    get:
      operationId: get_portfolio_address_stablecoins
      tags:
      - Portfolio
      summary: Monitor large stablecoin movements and whale wallet activity in real-time.
      x-source: https://www.guavaintel.com/api
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /reports/platform:
    post:
      operationId: post_reports_platform
      tags:
      - Reports
      summary: Report a Scam Platform
      x-source: https://www.guavaintel.com/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostReportsPlatformRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostReportsPlatformResponse'
      x-evidence:
        kind: documentation
  /reports/platform/{domain}:
    get:
      operationId: get_reports_platform_domain
      tags:
      - Reports
      summary: Platform Report Status
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: domain
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetReportsPlatformDomainResponse'
      x-evidence:
        kind: documentation
  /safety/address-poisoning/{chain}/{address}:
    get:
      operationId: get_safety_address_poisoning_chain_address
      tags:
      - Safety
      summary: Address Poisoning Detection
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSafetyAddressPoisoningChainAddressResponse'
      x-evidence:
        kind: documentation
  /safety/scan-platform:
    get:
      operationId: get_safety_scan_platform
      tags:
      - Safety
      summary: Investment Platform Scanner
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        description: URL or domain of the platform
      - name: fresh
        in: query
        required: false
        schema:
          type: boolean
        description: Bypass the 6-hour result cache
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSafetyScanPlatformResponse'
      x-evidence:
        kind: documentation
  /safety/scan-url:
    get:
      operationId: get_safety_scan_url
      tags:
      - Safety
      summary: Website Legitimacy Scanner
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        description: URL to scan for legitimacy
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSafetyScanUrlResponse'
      x-evidence:
        kind: documentation
  /safety/spam-tokens/{chain}/{address}:
    get:
      operationId: get_safety_spam_tokens_chain_address
      tags:
      - Safety
      summary: Spam Token / Fake Airdrop Detection
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSafetySpamTokensChainAddressResponse'
      x-evidence:
        kind: documentation
  /safety/sybil-score/{chain}/{address}:
    get:
      operationId: get_safety_sybil_score_chain_address
      tags:
      - Safety
      summary: Airdrop Farmer / Sybil Score
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSafetySybilScoreChainAddressResponse'
      x-evidence:
        kind: documentation
  /safety/tx-risk:
    get:
      operationId: get_safety_tx_risk
      tags:
      - Safety
      summary: Pre-Signature Transaction Risk Analysis
      x-source: https://www.guavaintel.com/api-reference
      parameters:
      - name: to
        in: query
        required: true
        schema:
          type: string
        description: Contract address the transaction calls
      - name: calldata
        in: query
        required: true
        schema:
          type: string
        description: Hex-encoded calldata (with or without 0x prefix)
      - name: value
        in: query
        required: false
        schema:
          type: number
        description: 'ETH value being sent (default: 0)'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSafetyTxRiskResponse'
      x-evidence:
        kind: documentation
  /search/token:
    get:
      operationId: get_search_token
      tags:
      - Search
      summary: Search tokens by symbol or name. Get contract addresses, prices, and market data.
      x-source: https://www.guavaintel.com/api
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        description: search query
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /search/trending:
    get:
      operationId: get_search_trending
      tags:
      - Search
      summary: Search tokens by symbol or name. Get contract addresses, prices, and market data.
      x-source: https://www.guavaintel.com/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /token/{chain}/{contract}/security:
    get:
      operationId: get_token_chain_contract_security
      tags:
      - Token
      summary: Detect honeypots, rug pulls, and 30+ risk factors.
      x-source: https://www.guavaintel.com/api
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: contract
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /usage:
    get:
      operationId: get_usage
      tags:
      - Usage
      summary: Get Usage Stats
      x-source: https://www.guavaintel.com/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetUsageResponse'
      x-evidence:
        kind: documentation
  /v1/token/ethereum/0x.../security:
    get:
      operationId: get_v1_token_ethereum_0x_security
      tags:
      - Token
      summary: GET /v1/token/ethereum/0x.../security
      x-source: https://www.guavaintel.com/api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1TokenEthereum0XSecurityResponse'
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\n 'https://api.guavaintel.com/v1/token/ethereum/0x.../security',\n {\n headers: {\n 'Authorization': 'Bearer YOUR_API_KEY'\n\
          \ }\n }\n)"
  /wallet/{chain}/{address}:
    get:
      operationId: get_wallet_chain_address
      tags:
      - Wallet
      summary: Get comprehensive wallet data including portfolio, risk scores, transaction history, and behavioral patterns.
      x-source: https://www.guavaintel.com/api
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /whale/{chain}/{address}:
    get:
      operationId: get_whale_chain_address
      tags:
      - Whale
      summary: Monitor large stablecoin movements and whale wallet activity in real-time.
      x-source: https://www.guavaintel.com/api
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1ChainsResponse:
      type: object
      properties:
        chains:
          type: array
        total:
          type: integer
    GetApiV1KeysResponse:
      type: object
      properties:
        has_key:
          type: boolean
        key_prefix:
          type: string
        tier:
          type: string
        requests_today:
          type: integer
        rate_limit:
          type: integer
    PostApiV1KeysResponse:
      type: object
      properties:
        api_key:
          type: string
        tier:
          type: string
        rate_limit:
          type: integer
        message:
          type: string
    GetApiV1TokenChainContractSecurityResponse:
      type: object
      properties:
        contract:
          type: string
        chain:
          type: string
        is_honeypot:
          type: boolean
        risk_score:
          type: integer
        risk_level:
          type: string
        security_info:
          type: object
        analyzed_at:
          type: string
    GetApiV1UsageResponse:
      type: object
      properties:
        limit:
          type: integer
        used:
          type: integer
        remaining:
          type: integer
        reset:
          type: string
    GetApiV1WalletChainAddressResponse:
      type: object
      properties:
        address:
          type: string
        chain:
          type: string
        risk_score:
          type: integer
        risk_level:
          type: string
        balance:
          type: object
        transactions:
          type: object
        tokens:
          type: array
        flags:
          type: array
        analyzed_at:
          type: string
    GetKeysResponse:
      type: object
      properties:
        has_key:
          type: boolean
        key_prefix:
          type: string
        tier:
          type: string
        requests_today:
          type: integer
        rate_limit:
          type: integer
    PostKeysResponse:
      type: object
      properties:
        api_key:
          type: string
        tier:
          type: string
        rate_limit:
          type: integer
        message:
          type: string
    GetPlatformAlertsResponse:
      type: object
      properties:
        total:
          type: integer
        platforms:
          type: array
    PostReportsPlatformRequest:
      type: object
      properties:
        url:
          type: string
          description: Platform URL or domain
        report_type:
          type: string
          description: scam | ponzi | fake_broker | clone_firm | withdrawal_frozen | phishing
        description:
          type: string
          description: What happened (free text)
      required:
      - url
    PostReportsPlatformResponse:
      type: object
      properties:
        ok:
          type: boolean
        report_id:
          type: integer
        domain:
          type: string
        status:
          type: string
        unique_reporters:
          type: integer
        reports_needed_to_publish:
          type: integer
    GetReportsPlatformDomainResponse:
      type: object
      properties:
        domain:
          type: string
        total_reports:
          type: integer
        unique_reporters:
          type: integer
        community_flagged:
          type: boolean
        threshold:
          type: integer
    GetSafetyAddressPoisoningChainAddressResponse:
      type: object
      properties:
        scanned:
          type: boolean
        alert_count:
          type: integer
        alerts:
          type: array
        transactions_analyzed:
          type: integer
        risk_level:
          type: string
        risk_score_bump:
          type: integer
        summary:
          type: string
    GetSafetyScanPlatformResponse:
      type: object
      properties:
        url:
          type: string
        domain:
          type: string
        risk_score:
          type: integer
        risk_level:
          type: string
        verdict:
          type: string
        dimensions:
          type: array
        evidence:
          type: object
        sources_used:
          type: array
        cached:
          type: boolean
    GetSafetyScanUrlResponse:
      type: object
      properties:
        url:
          type: string
        domain:
          type: string
        is_trusted:
          type: boolean
        overall_risk_score:
          type: integer
        risk_level:
          type: string
        verdict:
          type: string
        dimensions:
          type: array
        detected_issues:
          type: array
        is_known_scam:
          type: boolean
    GetSafetySpamTokensChainAddressResponse:
      type: object
      properties:
        scanned:
          type: boolean
        alert_count:
          type: integer
        alerts:
          type: array
        tokens_analyzed:
          type: integer
        clean_tokens:
          type: integer
        risk_level:
          type: string
        summary:
          type: string
    GetSafetySybilScoreChainAddressResponse:
      type: object
      properties:
        scanned:
          type: boolean
        farmer_score:
          type: integer
        risk_level:
          type: string
        is_likely_farmer:
          type: boolean
        features:
          type: array
        cluster_signals:
          type: array
        summary:
          type: string
    GetSafetyTxRiskResponse:
      type: object
      properties:
        is_safe:
          type: boolean
        risk_level:
          type: string
        risk_score:
          type: integer
        verdict:
          type: string
        to_address:
          type: string
        value_eth:
          type: number
        calldata_analysis:
          type: object
        warnings:
          type: array
        recommendations:
          type: array
        is_known_drainer:
          type: boolean
    GetUsageResponse:
      type: object
      properties:
        limit:
          type: integer
        used:
          type: integer
        remaining:
          type: integer
        reset:
          type: string
    GetV1TokenEthereum0XSecurityResponse:
      type: object
      properties:
        headers:
          type: object
          properties:
            Authorization:
              type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
security:
- apiKey: []
tags:
- name: Address
- name: Api
- name: Chains
- name: Compare
- name: Keys
- name: Platform Alerts
- name: Portfolio
- name: Reports
- name: Safety
- name: Search
- name: Token
- name: Usage
- name: Wallet
- name: Whale