# TACMIND API

## `GET /api/prediction/:match_id`

### Description

Returns the most recent prediction data for a specific match ID from the Tacmind AI network.

**⚠️ Note: This API will become available after the start of the Alpha Testing phase.**

***

### 🔗 Example Request

```
GET https://api.tacmind.ai/v1/prediction/84721
```

***

### ✅ Sample Response

```json
{
  "match_id": "84721",
  "home_team": "Barcelona",
  "away_team": "Real Madrid",
  "scheduled_time": "2025-09-14T20:00:00Z",
  "aggregate_prediction": {
    "winner": "Barcelona",
    "confidence": 0.68,
    "score_prediction": {
      "home": 2,
      "away": 1
    }
  },
  "model_contributors": [
    {
      "model_id": "tac_001x",
      "confidence": 0.72,
      "prediction": { "home": 2, "away": 1 }
    },
    {
      "model_id": "ai_striker",
      "confidence": 0.66,
      "prediction": { "home": 3, "away": 2 }
    },
    {
      "model_id": "goalchain42",
      "confidence": 0.65,
      "prediction": { "home": 1, "away": 0 }
    }
  ],
  "last_updated": "2025-09-13T18:45:00Z"
}
```

***

### 📝 Field Descriptions

* `aggregate_prediction`: Collective forecast from highest scoring AI models.
* `confidence`: Value between 0 and 1, indicating prediction certainty.
* `model_contributors`: Individual predictions from top models.
* `last_updated`: Timestamp of the most recent prediction generation.

***

### 🔐 Access Rules

* This endpoint may be restricted to users who stake $TACMIND.
* Free-tier access may include delayed or limited data views.


---

# 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://tacmind.gitbook.io/tacmind-docs/api/tacmind-api.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.