JSON Formats

{
"gti_id": "string", // UUID for the consolidated GTI entity
"gti_version": "integer", // Version number of this record structure/data instance
"display_name": "string", // Primary user-friendly name
"aliases": ["string"], // Other known names or handles
"entity_category": "string", // 'person', 'organization', 'protocol', 'smart_contract', 'collective/DAO', 'bot'
"sources": ["string"], // List: "internal_db", "twitter_api", "blockchain_scan", "user_provided", "third_party_api", "manual_entry", "web_scrape", "sentiment_analysis"
"confidence_score": "float", // 0.0-1.0 score indicating confidence in the consolidated entity linkage
"tags": ["string"], // General descriptive tags: "influencer", "developer", "whale", "market_maker", "competitor", "community_mod", "scammer_alert"
"timestamp_created": "datetime", // ISO 8601 - First created
"timestamp_updated": "datetime", // ISO 8601 - Last updated anywhere
"last_seen_active": "datetime", // ISO 8601 - Timestamp of the most recent activity detected across any linked source

"profile_info": {
  "full_name": "string",
  "organization": "string",
  "profile_picture_url": "string", // Consolidated/primary profile pic
},

"internal_user_data": { // Optional: Internal platform specifics
  "internal_user_id": "string",
  "username": "string",
  "account_status": "string", // "active", "pending_verification", "closed"
  "registration_date": "datetime",
  "last_login_date": "datetime",
  "xp": "integer",
  "level": "integer",
  "leaderboard_position": "integer",
  "current_multiplier": "integer",
  
},

"social_presence": { // Optional: Presence across social/dev platforms
  "twitter": { // Simplified Twitter details
    "twitter_handle": "string",     // e.g., "account123"
    "display_name": "string",       // e.g., "Account Name"
    "profile_image_url": "string",  // URL to the profile picture
    "verified": "boolean"  
  },
  "discord": {
      "discord_user_id": "string",
      "discord_handle": "string", // username#discriminator
  },
  "telegram": {
      "telegram_user_id": "string",
      "telegram_username": "string"
  },
  "sentiment_analysis": { // Optional: Requires external processing
    "overall_sentiment_score": "float", // e.g., -1.0 (neg) to 1.0 (pos)
    "sentiment_trend_7d": "string", // "positive", "negative", "neutral", "volatile"
    "key_topics_mentioned": ["string"],
    "last_analyzed_timestamp": "datetime"
  }
},

"wallets": [ // Array of associated blockchain wallets
  {
    "wallet_address": "string",
    "blockchain": "string", // "ethereum", "solana", "bitcoin", "polygon", "bsc", "arbitrum", "optimism", etc.
    "address_type": "string", // "EOA", "contract", "multisig"
    "ens_name": "string",
    "other_name_services": [{"service": "string", "name": "string"}], // e.g., SNS, Lens handle linked to wallet
    "source_of_link": "string", // "twitter_bio", "user_provided", "internal_mapping", "transaction_analysis", "dns_record", "contract_ownership"
    "tags": ["string"], // "primary", "cold_storage", "trading", "nft_holding", "burner", "exploit_related", "doxxed"
    "first_transaction_timestamp": "datetime",
    "last_activity_timestamp": "datetime",
    "transaction_count": "integer",
    "balance_snapshot": { // Point-in-time balance
        "total_value_usd": "number",
        "token_balances": [{"asset": "string", "amount": "number", "value_usd": "number"}],
        "snapshot_timestamp": "datetime"
    },
    "notable_interactions": [ // Summary of interactions
        {"type": "string", // "protocol", "contract_type", "token_transfer"
         "name": "string", // e.g., "Uniswap V3", "ERC721", "USDC"
         "interaction_count": "integer",
         "first_interaction": "datetime",
         "last_interaction": "datetime"
        }
    ],
  }
],

"on_chain_footprint_summary": { // Optional: Aggregated across all linked wallets
  "total_linked_wallets": "integer",
  "blockchains_active_on": ["string"],
  "aggregate_balance_usd": "number", // Sum across wallets, potential double count warning needed
  "total_transactions_all_wallets": "integer",
  "total_gas_spent_usd_all_wallets": "number"
},

"performance_data": { // Optional: Trading/Investment performance metrics
  "timeframes_analyzed": ["string"], // e.g., "7d", "30d", "90d", "YTD", "all_time"
  "metrics": {
      "overall_pnl_usd": "number",
      "overall_pnl_percent": "number",
      "pnl_by_timeframe": {"7d": {"usd": "number", "percent": "number"}, "...": {}},
      "pnl_by_asset_class": {"spot": {"usd": "number"}, "futures": {"usd": "number"}, "nfts": {"usd": "number"}, "...": {}},
      "win_rate_percent": "number",
      "profit_factor": "number",
      "max_drawdown_percent": "number",
      "volatility_percent": "number",
      "total_trades": "integer",
      "winning_trades": "integer",
      "losing_trades": "integer",
      "preferred_assets_by_volume": ["string"],
      "preferred_exchanges_platforms": ["string"]
  },
  "last_calculated_timestamp": "datetime"
},

"relationships": [ // Optional: Links to other GTI entities
  {
    "related_gti_id": "string",
    "relationship_type": "string", // "follows_on_twitter", "interacted_onchain", "member_of_same_dao", "business_partner", "co-investor", "family_member", "sent_funds_to", "received_funds_from"
    "strength_score": "float", // Optional: 0.0-1.0 indicating strength/confidence
    "source_of_relationship": "string" // How was this link determined?
  }
],

"audit_trail": [ // Optional: History of changes to this GTI record
    {
        "timestamp": "datetime",
        "user_or_system": "string", // Who/what made the change
        "action": "string", // "create", "update_field", "merge", "add_wallet", "recalculate_performance"
        "changed_fields": ["string"],
        "notes": "string" // Optional explanation
    }
],

"notes": [ // Optional: Free-form analyst notes
    {
        "timestamp": "datetime",
        "author": "string", // Analyst username or system ID
        "note_content": "string"
    }
]
}