Sharp-API
diff --git a/‎content/en/api-reference/odds-batch.mdx‎
Lines changed: 53 additions & 79 deletions b/‎content/en/api-reference/odds-batch.mdx‎
Lines changed: 53 additions & 79 deletions
@@ -51,7 +51,7 @@ curl -X POST "https://api.sharpapi.io/api/v1/odds/batch" \
   -H "X-API-Key: YOUR_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "event_ids": ["nba_celtics_lakers_2026-01-26_b3", "nba_heat_warriors_2026-01-26_b3"],
+    "event_ids": ["mlb_phillies_pirates_2026-07-02_b2", "mlb_athletics_marlins_2026-07-03_b3"],
     "sportsbook": "draftkings",
     "market": "moneyline"
   }'
@@ -66,14 +66,14 @@ const response = await fetch('https://api.sharpapi.io/api/v1/odds/batch', {
     'Content-Type': 'application/json'
   },
   body: JSON.stringify({
-    event_ids: ['nba_celtics_lakers_2026-01-26_b3', 'nba_heat_warriors_2026-01-26_b3'],
+    event_ids: ['mlb_phillies_pirates_2026-07-02_b2', 'mlb_athletics_marlins_2026-07-03_b3'],
     sportsbook: 'draftkings',
     market: 'moneyline'
   })
 });
 
-const { data, meta } = await response.json();
-console.log(`Fetched odds for ${meta.found} of ${meta.requested} events`);
+const { data } = await response.json();
+console.log(`Fetched ${data.events.length} events (${data.missing_events.length} missing)`);
 
 // Events are nested under data.events
 for (const event of data.events) {
@@ -96,14 +96,14 @@ response = requests.post(
         'Content-Type': 'application/json'
     },
     json={
-        'event_ids': ['nba_celtics_lakers_2026-01-26_b3', 'nba_heat_warriors_2026-01-26_b3'],
+        'event_ids': ['mlb_phillies_pirates_2026-07-02_b2', 'mlb_athletics_marlins_2026-07-03_b3'],
         'sportsbook': 'draftkings',
         'market': 'moneyline'
     }
 )
 result = response.json()
-meta = result['meta']
-print(f"Fetched odds for {meta['found']}/{meta['requested']} events")
+data = result['data']
+print(f"Fetched {len(data['events'])} events ({len(data['missing_events'])} missing)")
 
 # Events are nested under data.events
 for event in result['data']['events']:
@@ -121,73 +121,52 @@ if result['data']['missing_events']:
 
 ```json
 {
-  "success": true,
   "data": {
     "events": [
       {
-        "event_id": "nba_celtics_lakers_2026-01-26_b3",
-        "event_name": "Los Angeles Lakers @ Boston Celtics",
-        "sport": "basketball",
-        "league": "nba",
-        "start_time": "2026-01-26T19:30:00Z",
-        "is_live": false,
+        "event_id": "mlb_phillies_pirates_2026-07-02_b2",
+        "event_name": "Pittsburgh Pirates @ Philadelphia Phillies",
+        "sport": "baseball",
+        "league": "mlb",
+        "start_time": "2026-07-02T16:35:00Z",
+        "is_live": true,
         "odds": [
           {
+            "id": "92183869662116",
             "sportsbook": "draftkings",
+            "event_uuid": "217ee1d7227d1ad1",
+            "external_event_id": "34343268",
             "market_type": "moneyline",
-            "selection": "Boston Celtics",
-            "selection_type": "home",
-            "odds_american": -210,
-            "odds_decimal": 1.476,
-            "line": null,
-            "timestamp": "2026-01-26T10:15:00.000Z"
-          },
-          {
-            "sportsbook": "draftkings",
-            "market_type": "moneyline",
-            "selection": "Los Angeles Lakers",
+            "market_label": "Moneyline",
+            "selection": "PIT Pirates",
             "selection_type": "away",
-            "odds_american": 175,
-            "odds_decimal": 2.75,
+            "odds_american": 104,
+            "odds_decimal": 2.04,
+            "odds_probability": 0.4902,
             "line": null,
-            "timestamp": "2026-01-26T10:15:00.000Z"
-          }
-        ]
-      },
-      {
-        "event_id": "nba_heat_warriors_2026-01-26_b3",
-        "event_name": "Golden State Warriors @ Miami Heat",
-        "sport": "basketball",
-        "league": "nba",
-        "start_time": "2026-01-26T20:00:00Z",
-        "is_live": false,
-        "odds": [
+            "timestamp": "2026-07-02T18:21:35.800662605Z"
+          },
           {
+            "id": "47445279247340",
             "sportsbook": "draftkings",
+            "event_uuid": "217ee1d7227d1ad1",
+            "external_event_id": "34343268",
             "market_type": "moneyline",
-            "selection": "Miami Heat",
+            "market_label": "Moneyline",
+            "selection": "PHI Phillies",
             "selection_type": "home",
-            "odds_american": -130,
-            "odds_decimal": 1.769,
+            "odds_american": -135,
+            "odds_decimal": 1.741,
+            "odds_probability": 0.5745,
             "line": null,
-            "timestamp": "2026-01-26T10:15:05.000Z"
+            "timestamp": "2026-07-02T18:21:35.800662605Z"
           }
         ]
       }
     ],
-    "missing_events": []
+    "missing_events": ["mlb_athletics_marlins_2026-07-03_b3"]
   },
-  "meta": {
-    "requested": 2,
-    "found": 2,
-    "missing": 0,
-    "max_batch": 50,
-    "filters": {
-      "sportsbook": "draftkings",
-      "market": "moneyline"
-    },
-    "updated_at": "2026-01-26T10:15:05.000Z"
-  }
+  "updated_at": "2026-07-02T18:21:36Z"
 }
 ```
 
@@ -198,7 +177,7 @@ X-RateLimit-Limit: 300
 X-RateLimit-Remaining: 296
 X-RateLimit-Reset: 1737853200
 X-Data-Delay: 0
-X-Request-Id: req_batch_abc123
+X-Request-Id: 1782526326424224-82519
 ```
 
 ### Error Responses
@@ -208,8 +187,7 @@ X-Request-Id: req_batch_abc123
 {
   "error": {
     "code": "validation_error",
-    "message": "Batch limit exceeded. Your tier (hobby) allows 10 events per batch, but 25 were requested.",
-    "docs": "https://docs.sharpapi.io/en/api-reference/odds-batch"
+    "message": "Maximum 10 event_ids per request for hobby tier"
   }
 }
 ```
@@ -219,26 +197,28 @@ X-Request-Id: req_batch_abc123
 {
   "error": {
     "code": "validation_error",
-    "message": "The 'event_ids' field is required and must be a non-empty array of event IDs.",
-    "docs": "https://docs.sharpapi.io/en/api-reference/odds-batch"
+    "message": "event_ids array required"
   }
 }
 ```
 
 ***401 Unauthorized***
+
+No key supplied returns `missing_api_key`; a bad key returns `invalid_api_key`.
+
 ```json
 {
   "error": {
-    "code": "unauthorized",
-    "message": "Invalid or missing API key",
-    "docs": "https://docs.sharpapi.io/en/authentication"
+    "code": "missing_api_key",
+    "message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.",
+    "docs": "https://sharpapi.io/docs/authentication"
   }
 }
 ```
 
 ## Response Structure
 
-The batch response nests events and missing IDs under `data`, with counts in `meta`:
+The batch response nests events and missing IDs under `data`. There is **no** `meta` block — derive counts client-side from `data.events.length` and `data.missing_events.length`.
 
 ### Data Object
 
@@ -247,18 +227,8 @@ The batch response nests events and missing IDs under `data`, with counts in `me
 | `data.events` | EventOdds[] | Array of event objects with nested odds |
 | `data.missing_events` | string[] | Event IDs that were not found or had no odds |
 
-### Meta Object
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `meta.requested` | integer | Number of event IDs in your request |
-| `meta.found` | integer | Number of events that had odds data |
-| `meta.missing` | integer | Number of events not found |
-| `meta.max_batch` | integer | Maximum batch size for your tier |
-| `meta.filters` | object | Applied filters (`sportsbook`, `market`) |
-
 <Callout type="info">
-If an event ID in your request has no odds (e.g., the event has ended or doesn't exist), it will appear in `data.missing_events` rather than causing an error. The response will still include odds for all valid events.
+If an event ID in your request has no odds (e.g., the event has ended, doesn't exist, or has no rows matching your `sportsbook`/`market` filters), it will appear in `data.missing_events` rather than causing an error. The response will still include odds for all valid events.
 </Callout>
 
 ## Response Schema
@@ -275,19 +245,23 @@ Each item in the `data.events` array is an event object with nested odds:
 | `league` | string | League slug |
 | `start_time` | string | ISO 8601 event start time |
 | `is_live` | boolean | Whether event is live |
-| `game_state` | object \| undefined | Live game state (only for live events with scores) |
 | `odds` | array | Array of odds for this event |
 
 ### Odds Object (nested in event)
 
 | Field | Type | Description |
 |-------|------|-------------|
+| `id` | string | Unique odds identifier (same `id` as `/odds` rows) |
 | `sportsbook` | string | Sportsbook ID |
-| `market_type` | string | Market type |
+| `event_uuid` | string\|undefined | Stable canonical event UUID from the SharpAPI atlas, when mapped |
+| `external_event_id` | string\|undefined | The sportsbook's own native event ID, when distinct from `event_id` |
+| `market_type` | string | Canonical market type (e.g., `moneyline`) |
+| `market_label` | string\|undefined | Human-readable market display label (e.g., `Moneyline`) |
 | `selection` | string | Selection name |
-| `selection_type` | string | `home`, `away`, `over`, `under` |
+| `selection_type` | string | `home`, `away`, `over`, `under`, etc. — see [Selection types](/en/api-reference/odds/#selection-types) |
 | `odds_american` | number | American odds |
 | `odds_decimal` | number | Decimal odds |
+| `odds_probability` | number | Implied probability |
 | `line` | number \| null | Line value |
 | `timestamp` | string | ISO 8601 time SharpAPI last refreshed this odd through its pipeline — advances every ingest cycle. A feed-freshness / liveness signal (matches OpticOdds' `timestamp`); it is NOT when the price last changed. See [understanding the `timestamp` field](/en/concepts/pinnacle-odds-changed-at/). |
 
@@ -329,7 +303,7 @@ async function refreshWatchlist(eventIds) {
     body: JSON.stringify({ event_ids: eventIds })
   });
 
-  const { data, meta } = await response.json();
+  const { data } = await response.json();
 
   if (data.missing_events.length > 0) {
     console.warn('Missing events:', data.missing_events);