# goldxbt

## Overview

GoldXBT is BaseGold's exclusive AI agent, purpose-built for gold market dominance. Powered by a proprietary prediction engine analyzing decades of gold market data, macroeconomic indicators, and on-chain sentiment, GoldXBT delivers institutional-grade signals to BGOLD holders—insights previously reserved for hedge funds and commodity trading desks.

## Why GoldXBT Matters

Traditional gold analysis costs $10,000+/month from firms like Goldman Sachs or Bloomberg Terminal. GoldXBT democratizes this intelligence, giving every BGOLD holder access to:

* Predictive algorithms analyzing 50+ market variables in real-time
* Sentiment fusion combining on-chain data, social signals, and macro trends
* Pattern recognition trained on 20+ years of gold price movements
* Institutional-grade outputs formatted for both human traders and AI agents

{% hint style="info" %}
GoldXBT aims to deliver institutional-grade signals directly to BGOLD holders at a fraction of the traditional cost.
{% endhint %}

## The GoldXBT Edge

| Traditional Gold Analysis      | GoldXBT                       |
| ------------------------------ | ----------------------------- |
| Bloomberg Terminal: $24,000/yr | **FREE for BGOLD holders**    |
| Analyst Reports: Days delayed  | **Real-time signals**         |
| Human Bias: Emotional          | **Pure data-driven**          |
| Access: Institutions only      | **Open to all BGOLD holders** |

## Core Capabilities

| Capability          | What You Get                       | Value                      |
| ------------------- | ---------------------------------- | -------------------------- |
| Price Predictions   | 30-day gold targets with reasoning | Know where gold is heading |
| Confidence Scoring  | AI-assessed reliability (0-100%)   | Trade with conviction      |
| Sentiment Analysis  | Bullish/Bearish/Neutral signals    | Time your entries          |
| Market Intelligence | Concise insights + key catalysts   | Stay ahead of the crowd    |

## How GoldXBT Works

{% @mermaid/diagram content="flowchart TB
subgraph DataIngestion\["🔒 Proprietary Data Layer"]
SPOT\[Global Gold Spot<br/>50+ Exchanges]
MACRO\[Macro Indicators<br/>Fed, CPI, DXY]
ONCHAIN\[On-Chain Signals<br/>Whale Movements]
SENTIMENT\[Social Sentiment<br/>Filtered Alpha]
end

```
subgraph Engine["⚡ GoldXBT Intelligence Engine"]
    PROCESS[Signal Processing]
    PREDICT[Prediction Core]
    CONFIDENCE[Confidence Calibration]
end

subgraph Output["📡 Signal Distribution"]
    API["REST API<br/>Developers"]
    TWITTER["Twitter<br/>@goldonbasexyz"]
    X402["X402 Premium<br/>AI Agents"]
    DASHBOARD["Dashboard<br/>Holders"]
end

SPOT --> PROCESS
MACRO --> PROCESS
ONCHAIN --> PROCESS
SENTIMENT --> PROCESS

PROCESS --> PREDICT
PREDICT --> CONFIDENCE

CONFIDENCE --> API
CONFIDENCE --> TWITTER
CONFIDENCE --> X402
CONFIDENCE --> DASHBOARD" %}
```

## Signal Access Tiers

GoldXBT uses a simple 3-tier system based on your BGOLD holdings (launching Q2 2026):

| Tier           | Requirement         | What You Get                                                                   |
| -------------- | ------------------- | ------------------------------------------------------------------------------ |
| 🌐 **Public**  | None                | Follow [@goldonbasexyz](https://x.com/goldonbasexyz) for free daily commentary |
| 🥇 **Holder**  | Hold 100,000+ BGOLD | Full Dashboard access: predictions, confidence scores, sentiment, API access   |
| 💎 **Premium** | Pay 50 BGOLD/day    | Real-time WebSocket feed + Deep analysis reports + Priority signals            |

### How Verification Works

* **Holder Tier**: Connect your wallet on the BaseGold Dashboard. System checks your BGOLD balance on-chain. No signup needed.
* **Premium Tier**: Pay via X402 protocol (AI agents) or direct BGOLD transfer. Access token valid for 24 hours.

{% hint style="info" %}
Why This Model?

* Holding 100,000 BGOLD = you're invested in the ecosystem = you deserve premium signals
* Premium tier creates buy pressure (50 BGOLD/day burned or sent to treasury)
* Public tier builds awareness and trust via Twitter
  {% endhint %}

## Prediction Response Format

{% code title="goldxbt-prediction.json" %}

```json
{
  "agent": "GoldXBT",
  "timestamp": "2026-01-15T12:00:00Z",
  "marketData": {
    "currentGoldPrice": 2650,
    "vnxauPrice": 95,
    "ethPrice": 3200
  },
  "prediction": {
    "analysis": "Gold showing strength amid inflation concerns...",
    "priceTarget": 2750,
    "confidence": 78,
    "timeframe": "30 days",
    "reasoning": [
      "Inflation data supports gold demand",
      "Central bank buying continues",
      "Technical breakout above $2600 resistance"
    ]
  },
  "sentiment": "bullish"
}
```

{% endcode %}

## API Endpoints

### Public Endpoints (No authentication)

| Endpoint             | Method | Description                                 |
| -------------------- | ------ | ------------------------------------------- |
| `/api/ai/health`     | GET    | Check GoldXBT status                        |
| `/api/ai/commentary` | GET    | Get latest public commentary (12hr delayed) |

### Holder Endpoints (100,000+ BGOLD required)

| Endpoint            | Method | Description                                      |
| ------------------- | ------ | ------------------------------------------------ |
| `/api/ai/predict`   | POST   | Get 30-day gold prediction with confidence score |
| `/api/ai/sentiment` | GET    | Get current market sentiment analysis            |
| `/api/ai/ask`       | POST   | Ask GoldXBT any gold-related question            |
| `/api/ai/history`   | GET    | View past predictions and accuracy               |

### Premium Endpoints (50 BGOLD/day via X402)

| Endpoint                   | Method    | Description                          |
| -------------------------- | --------- | ------------------------------------ |
| `/api/ai/signals/realtime` | WebSocket | Real-time signal stream (no delay)   |
| `/api/ai/analysis/deep`    | POST      | Extended analysis with macro factors |
| `/api/ai/alerts/custom`    | POST      | Set custom price alerts              |

## X402 Premium Access Flow

AI agents (or users) can purchase Premium tier access via X402:

```mermaid
sequenceDiagram
    participant User as User/AI Agent
    participant API as GoldXBT API
    participant X402 as X402 Protocol
    participant Contract as BGOLD Contract
    
    User->>API: GET /api/ai/signals/realtime
    API-->>User: 402 Payment Required
    Note over API,User: X-Payment-Amount: 50 BGOLD<br/>X-Payment-Period: 24 hours
    
    User->>X402: Create Payment (50 BGOLD)
    X402->>Contract: Transfer 50 BGOLD to Treasury
    Contract-->>X402: Transfer Confirmed
    X402-->>User: Access Token (valid 24h)
    
    User->>API: Connect WebSocket + Token
    API-->>User: ✅ Real-time Gold Signals
    
    loop Every Signal Update
        API-->>User: {prediction, confidence, sentiment, timestamp}
    end
```

## Twitter Integration

GoldXBT signals are posted to [@goldonbasexyz](https://x.com/goldonbasexyz), building public credibility and giving free-tier users access to delayed signals:

| Tweet Type  | Frequency          | Content                         |
| ----------- | ------------------ | ------------------------------- |
| Predictions | Every 12h          | Price target + confidence score |
| Commentary  | Every 12h (offset) | Market sentiment + key points   |
| Alerts      | On trigger         | Major price movements           |

Example Tweet Format:

```
🟡 GoldXBT Signal

📊 30-Day Target: $2,750/oz
📍 Current: $2,650/oz (+3.8%)
🎯 Confidence: 78%

Gold showing strength amid inflation concerns. 
Central bank buying continues to support prices.

#Gold #BaseChain #BGOLD $BGOLD
```

## GoldXBT Roadmap

| Milestone                   | Target  | Status         | Implementation           |
| --------------------------- | ------- | -------------- | ------------------------ |
| GoldXBT Intelligence Engine | Q2 2026 | 🔄 In Progress | Backend AI system        |
| Prediction API              | Q2 2026 | 🔄 In Progress | REST endpoints           |
| Twitter Integration         | Q2 2026 | 📋 Planned     | Auto-posting bot         |
| Holder Tier Verification    | Q2 2026 | 📋 Planned     | On-chain balance check   |
| X402 Premium Payments       | Q3 2026 | 📋 Planned     | Payment gateway contract |
| Real-time WebSocket         | Q3 2026 | 📋 Planned     | Streaming signals        |
| Deep Analysis Reports       | Q3 2026 | 📋 Planned     | Extended market analysis |
| Multi-asset Expansion       | Q4 2026 | 📋 Planned     | Silver, platinum signals |

## Why Hold 100,000+ BGOLD?

| Benefit             | Value                                                         |
| ------------------- | ------------------------------------------------------------- |
| Instant Holder Tier | Unlock full GoldXBT predictions (worth $24k/yr elsewhere)     |
| VNXAU Reflections   | Earn \~$2.50/day in gold at $100k volume (scales with volume) |
| No Recurring Fees   | Hold once, access forever (unlike 50 BGOLD/day Premium)       |
| AI Agent Compatible | Your trading bots can query GoldXBT API automatically         |

Math Example:

* 100,000 BGOLD at $0.01 = $1,000 investment
* GoldXBT Holder access = $24,000/year value
* Plus VNXAU reflections = passive gold income
* ROI: Access alone pays for itself 24x per year

***

If you want, I can:

* Convert any of the tables into cards for a more visual layout.
* Add expandable details for each API endpoint with sample requests/responses.
* Create a stepper walkthrough for onboarding (connect wallet → verify balance → access dashboard → use API).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://basegold.gitbook.io/basegold/features/goldxbt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.