Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions content/en/api-reference/events-by-id.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Requires API key via `X-API-Key` header, `Authorization: Bearer` header, or `api

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eventId` | string | Yes | Unique event identifier (e.g., `evt_nba_bos_lal_20260208`) |
| `eventId` | string | Yes | Unique event identifier (e.g., `nba_celtics_lakers_2026-02-08_b3`) |

## Response Headers

Expand Down Expand Up @@ -76,13 +76,13 @@ Each entry in the `markets` array summarizes an available market type for this e
<Tabs items={['cURL', 'JavaScript', 'Python']}>
<Tabs.Tab>
```bash
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208" \
curl -X GET "https://api.sharpapi.io/api/v1/events/nba_celtics_lakers_2026-02-08_b3" \
-H "X-API-Key: YOUR_API_KEY"
```
</Tabs.Tab>
<Tabs.Tab>
```javascript
const eventId = 'evt_nba_bos_lal_20260208';
const eventId = 'nba_celtics_lakers_2026-02-08_b3';
const response = await fetch(
`https://api.sharpapi.io/api/v1/events/${eventId}`,
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
Expand All @@ -96,7 +96,7 @@ console.log(`Markets: ${data.markets.map(m => m.type).join(', ')}`);
```python
import requests

event_id = 'evt_nba_bos_lal_20260208'
event_id = 'nba_celtics_lakers_2026-02-08_b3'
response = requests.get(
f'https://api.sharpapi.io/api/v1/events/{event_id}',
headers={'X-API-Key': 'YOUR_API_KEY'}
Expand All @@ -119,7 +119,7 @@ Single-resource responses wrap the object in `data` as a single object (not an a
```json
{
"data": {
"id": "evt_nba_bos_lal_20260208",
"id": "nba_celtics_lakers_2026-02-08_b3",
"external_ids": {
"draftkings": "12345678",
"fanduel": "87654321",
Expand Down Expand Up @@ -188,7 +188,7 @@ Single-resource responses wrap the object in `data` as a single object (not an a
]
},
"meta": {
"event_id": "evt_nba_bos_lal_20260208"
"event_id": "nba_celtics_lakers_2026-02-08_b3"
}
}
```
Expand Down
10 changes: 5 additions & 5 deletions content/en/api-reference/events-markets.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Requires API key via `X-API-Key` header, `Authorization: Bearer` header, or `api

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eventId` | string | Yes | Unique event identifier (e.g., `evt_nba_bos_lal_20260208`) |
| `eventId` | string | Yes | Unique event identifier (e.g., `nba_celtics_lakers_2026-02-08_b3`) |

## Response Headers

Expand Down Expand Up @@ -57,13 +57,13 @@ All responses include standard rate limit and metadata headers:
<Tabs items={['cURL', 'JavaScript', 'Python']}>
<Tabs.Tab>
```bash
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/markets" \
curl -X GET "https://api.sharpapi.io/api/v1/events/nba_celtics_lakers_2026-02-08_b3/markets" \
-H "X-API-Key: YOUR_API_KEY"
```
</Tabs.Tab>
<Tabs.Tab>
```javascript
const eventId = 'evt_nba_bos_lal_20260208';
const eventId = 'nba_celtics_lakers_2026-02-08_b3';
const response = await fetch(
`https://api.sharpapi.io/api/v1/events/${eventId}/markets`,
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
Expand All @@ -83,7 +83,7 @@ for (const market of data) {
```python
import requests

event_id = 'evt_nba_bos_lal_20260208'
event_id = 'nba_celtics_lakers_2026-02-08_b3'
response = requests.get(
f'https://api.sharpapi.io/api/v1/events/{event_id}/markets',
headers={'X-API-Key': 'YOUR_API_KEY'}
Expand Down Expand Up @@ -158,7 +158,7 @@ for market in result['data']:
}
],
"meta": {
"event_id": "evt_nba_bos_lal_20260208",
"event_id": "nba_celtics_lakers_2026-02-08_b3",
"count": 5,
"updated_at": "2026-02-08T12:05:00Z"
}
Expand Down
42 changes: 21 additions & 21 deletions content/en/api-reference/events-odds.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Requires API key via `X-API-Key` header, `Authorization: Bearer` header, or `api

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eventId` | string | Yes | Unique event identifier (e.g., `evt_nba_bos_lal_20260208`) |
| `eventId` | string | Yes | Unique event identifier (e.g., `nba_celtics_lakers_2026-02-08_b3`) |

## Query Parameters

Expand Down Expand Up @@ -71,13 +71,13 @@ All responses include standard rate limit and metadata headers:
<Tabs items={['cURL', 'JavaScript', 'Python']}>
<Tabs.Tab>
```bash
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds" \
curl -X GET "https://api.sharpapi.io/api/v1/events/nba_celtics_lakers_2026-02-08_b3/odds" \
-H "X-API-Key: YOUR_API_KEY"
```
</Tabs.Tab>
<Tabs.Tab>
```javascript
const eventId = 'evt_nba_bos_lal_20260208';
const eventId = 'nba_celtics_lakers_2026-02-08_b3';
const response = await fetch(
`https://api.sharpapi.io/api/v1/events/${eventId}/odds`,
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
Expand All @@ -90,7 +90,7 @@ console.log(`${meta.total} total odds for this event`);
```python
import requests

event_id = 'evt_nba_bos_lal_20260208'
event_id = 'nba_celtics_lakers_2026-02-08_b3'
response = requests.get(
f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
headers={'X-API-Key': 'YOUR_API_KEY'}
Expand All @@ -106,13 +106,13 @@ print(f"{result['meta']['total']} total odds for this event")
<Tabs items={['cURL', 'JavaScript', 'Python']}>
<Tabs.Tab>
```bash
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread" \
curl -X GET "https://api.sharpapi.io/api/v1/events/nba_celtics_lakers_2026-02-08_b3/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread" \
-H "X-API-Key: YOUR_API_KEY"
```
</Tabs.Tab>
<Tabs.Tab>
```javascript
const eventId = 'evt_nba_bos_lal_20260208';
const eventId = 'nba_celtics_lakers_2026-02-08_b3';
const response = await fetch(
`https://api.sharpapi.io/api/v1/events/${eventId}/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread`,
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
Expand All @@ -124,7 +124,7 @@ const { data } = await response.json();
```python
import requests

event_id = 'evt_nba_bos_lal_20260208'
event_id = 'nba_celtics_lakers_2026-02-08_b3'
response = requests.get(
f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
params={
Expand All @@ -144,17 +144,17 @@ odds = response.json()['data']
<Tabs.Tab>
```bash
# First page
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=0" \
curl -X GET "https://api.sharpapi.io/api/v1/events/nba_celtics_lakers_2026-02-08_b3/odds?limit=50&offset=0" \
-H "X-API-Key: YOUR_API_KEY"

# Next page
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=50" \
curl -X GET "https://api.sharpapi.io/api/v1/events/nba_celtics_lakers_2026-02-08_b3/odds?limit=50&offset=50" \
-H "X-API-Key: YOUR_API_KEY"
```
</Tabs.Tab>
<Tabs.Tab>
```javascript
const eventId = 'evt_nba_bos_lal_20260208';
const eventId = 'nba_celtics_lakers_2026-02-08_b3';
let offset = 0;
const limit = 50;
let allOdds = [];
Expand All @@ -178,7 +178,7 @@ console.log(`Fetched all ${allOdds.length} odds`);
```python
import requests

event_id = 'evt_nba_bos_lal_20260208'
event_id = 'nba_celtics_lakers_2026-02-08_b3'
all_odds = []
offset = 0
limit = 50
Expand Down Expand Up @@ -209,9 +209,9 @@ print(f"Fetched all {len(all_odds)} odds")
{
"data": [
{
"id": "dk_evt_nba_bos_lal_20260208_ml_home",
"id": "dk_nba_celtics_lakers_2026-02-08_b3_ml_home",
"sportsbook": "draftkings",
"event_id": "evt_nba_bos_lal_20260208",
"event_id": "nba_celtics_lakers_2026-02-08_b3",
"market_type": "moneyline",
"selection": "Boston Celtics",
"selection_type": "home",
Expand All @@ -224,9 +224,9 @@ print(f"Fetched all {len(all_odds)} odds")
"last_seen_at": "2026-02-08T12:05:00Z"
},
{
"id": "dk_evt_nba_bos_lal_20260208_ml_away",
"id": "dk_nba_celtics_lakers_2026-02-08_b3_ml_away",
"sportsbook": "draftkings",
"event_id": "evt_nba_bos_lal_20260208",
"event_id": "nba_celtics_lakers_2026-02-08_b3",
"market_type": "moneyline",
"selection": "Los Angeles Lakers",
"selection_type": "away",
Expand All @@ -239,9 +239,9 @@ print(f"Fetched all {len(all_odds)} odds")
"last_seen_at": "2026-02-08T12:05:00Z"
},
{
"id": "pin_evt_nba_bos_lal_20260208_ml_home",
"id": "pin_nba_celtics_lakers_2026-02-08_b3_ml_home",
"sportsbook": "pinnacle",
"event_id": "evt_nba_bos_lal_20260208",
"event_id": "nba_celtics_lakers_2026-02-08_b3",
"market_type": "moneyline",
"selection": "Boston Celtics",
"selection_type": "home",
Expand All @@ -254,9 +254,9 @@ print(f"Fetched all {len(all_odds)} odds")
"last_seen_at": "2026-02-08T12:03:00Z"
},
{
"id": "dk_evt_nba_bos_lal_20260208_spread_home",
"id": "dk_nba_celtics_lakers_2026-02-08_b3_spread_home",
"sportsbook": "draftkings",
"event_id": "evt_nba_bos_lal_20260208",
"event_id": "nba_celtics_lakers_2026-02-08_b3",
"market_type": "spread",
"selection": "Boston Celtics",
"selection_type": "home",
Expand All @@ -269,9 +269,9 @@ print(f"Fetched all {len(all_odds)} odds")
"last_seen_at": "2026-02-08T12:05:00Z"
},
{
"id": "dk_evt_nba_bos_lal_20260208_total_over",
"id": "dk_nba_celtics_lakers_2026-02-08_b3_total_over",
"sportsbook": "draftkings",
"event_id": "evt_nba_bos_lal_20260208",
"event_id": "nba_celtics_lakers_2026-02-08_b3",
"market_type": "total",
"selection": "Over",
"selection_type": "over",
Expand Down
4 changes: 2 additions & 2 deletions content/en/api-reference/events.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -233,7 +233,7 @@ data = response.json()
{
"data": [
{
"id": "evt_nba_bos_lal_20260208",
"id": "nba_celtics_lakers_2026-02-08_b3",
"external_ids": {
"draftkings": "33483200",
"fanduel": "nba-bos-lal-20260208"
Expand All @@ -250,7 +250,7 @@ data = response.json()
"books": ["betmgm", "caesars", "draftkings", "fanduel"]
},
{
"id": "evt_nba_gsw_mia_20260208",
"id": "nba_heat_warriors_2026-02-08_b3",
"external_ids": {
"draftkings": "33483205"
},
Expand Down
2 changes: 1 addition & 1 deletion content/en/api-reference/historical-odds-closing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,7 @@ for event in data['events']:
"league": "nba",
"events": [
{
"event_id": "evt_nba_bos_mia_20260410",
"event_id": "nba_celtics_heat_2026-04-10_b3",
"sport": "basketball",
"league": "nba",
"home_team": "Boston Celtics",
Expand Down
10 changes: 5 additions & 5 deletions content/en/api-reference/odds-batch.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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": ["evt_nba_lal_bos_20260126", "evt_nba_gsw_mia_20260126"],
"event_ids": ["nba_celtics_lakers_2026-01-26_b3", "nba_heat_warriors_2026-01-26_b3"],
"sportsbook": "draftkings",
"market": "moneyline"
}'
Expand All @@ -66,7 +66,7 @@ const response = await fetch('https://api.sharpapi.io/api/v1/odds/batch', {
'Content-Type': 'application/json'
},
body: JSON.stringify({
event_ids: ['evt_nba_lal_bos_20260126', 'evt_nba_gsw_mia_20260126'],
event_ids: ['nba_celtics_lakers_2026-01-26_b3', 'nba_heat_warriors_2026-01-26_b3'],
sportsbook: 'draftkings',
market: 'moneyline'
})
Expand Down Expand Up @@ -96,7 +96,7 @@ response = requests.post(
'Content-Type': 'application/json'
},
json={
'event_ids': ['evt_nba_lal_bos_20260126', 'evt_nba_gsw_mia_20260126'],
'event_ids': ['nba_celtics_lakers_2026-01-26_b3', 'nba_heat_warriors_2026-01-26_b3'],
'sportsbook': 'draftkings',
'market': 'moneyline'
}
Expand Down Expand Up @@ -125,7 +125,7 @@ if result['data']['missing_events']:
"data": {
"events": [
{
"event_id": "evt_nba_lal_bos_20260126",
"event_id": "nba_celtics_lakers_2026-01-26_b3",
"event_name": "Los Angeles Lakers @ Boston Celtics",
"sport": "basketball",
"league": "nba",
Expand Down Expand Up @@ -155,7 +155,7 @@ if result['data']['missing_events']:
]
},
{
"event_id": "evt_nba_gsw_mia_20260126",
"event_id": "nba_heat_warriors_2026-01-26_b3",
"event_name": "Golden State Warriors @ Miami Heat",
"sport": "basketball",
"league": "nba",
Expand Down
2 changes: 1 addition & 1 deletion content/en/api-reference/odds-best.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ for item in result['data']:
"success": true,
"data": [
{
"event_id": "evt_nba_lal_bos_20260126",
"event_id": "nba_celtics_lakers_2026-01-26_b3",
"event_name": "Los Angeles Lakers @ Boston Celtics",
"sport": "basketball",
"league": "nba",
Expand Down
2 changes: 1 addition & 1 deletion content/en/api-reference/opportunities-arbitrage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ for arb in data['data']:
"data": [
{
"id": "arb_dk_pin_nba_lal_bos_ml",
"event_id": "evt_nba_lal_bos_20260208",
"event_id": "nba_celtics_lakers_2026-02-08_b3",
"event_name": "Los Angeles Lakers @ Boston Celtics",
"sport": "basketball",
"league": "nba",
Expand Down
4 changes: 2 additions & 2 deletions content/en/api-reference/opportunities-ev.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ for opp in data['data']:
"data": [
{
"id": "ev_dk_nba_33483153_ml_PHO",
"game_id": "evt_nba_phi_pho_20260208",
"game_id": "nba_76ers_suns_2026-02-08_b3",
"ev_percentage": 4.2,
"odds_american": -105,
"odds_decimal": 1.952,
Expand Down Expand Up @@ -155,7 +155,7 @@ for opp in data['data']:
},
{
"id": "ev_fd_nba_33483153_ml_PHO",
"game_id": "evt_nba_phi_pho_20260208",
"game_id": "nba_76ers_suns_2026-02-08_b3",
"ev_percentage": 2.8,
"odds_american": -108,
"odds_decimal": 1.926,
Expand Down
2 changes: 1 addition & 1 deletion content/en/api-reference/opportunities-low-hold.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ for hold in data['data']:
"data": [
{
"id": "lh_nba_lal_bos_ml_0",
"event_id": "evt_nba_lal_bos_20260208",
"event_id": "nba_celtics_lakers_2026-02-08_b3",
"event_name": "Los Angeles Lakers @ Boston Celtics",
"sport": "basketball",
"league": "nba",
Expand Down
2 changes: 1 addition & 1 deletion content/en/api-reference/opportunities-middles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ for middle in data['data']:
"data": [
{
"id": "a1b2c3d4e5f67890",
"event_id": "evt_nfl_buf_kc_20260217",
"event_id": "nfl_bills_chiefs_2026-02-17_b2",
"event_name": "Buffalo Bills @ Kansas City Chiefs",
"sport": "football",
"league": "nfl",
Expand Down
4 changes: 2 additions & 2 deletions content/en/api-reference/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ Used for singletons (`/account`, `/events/:eventId`) and non-paginated reference
```json
{
"data": {
"id": "evt_abc123",
"id": "nba_celtics_lakers_2026-02-08_b3",
"sport": "nba",
"home_team": "PHI 76ers",
"away_team": "PHO Suns",
Expand Down Expand Up @@ -278,7 +278,7 @@ All list endpoints support filtering via query parameters. Filters use **singula
| `sport` | string | `basketball,football` | Filter by sport |
| `league` | string | `nba,nfl` | Filter by league |
| `market` | string | `moneyline,spread` | Filter by market type |
| `event` | string | `evt_abc123` | Filter by event ID |
| `event` | string | `nba_celtics_lakers_2026-02-08_b3` | Filter by event ID |
| `live` | boolean | `true` | Only live/in-progress events |
| `sort` | string | `-odds_american` | Sort field with optional `-` prefix for descending |
| `fields` | string | `id,sportsbook,odds_american` | Comma-separated fields to include in response |
Expand Down
2 changes: 1 addition & 1 deletion content/en/api-reference/stream.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,7 @@ A previously detected arbitrage opportunity is no longer available.
```
event: arb:expired
id: evt_00046
data: {"expired":["evt_abc123:moneyline:opp_a1b2c3"],"timestamp":"2026-01-26T02:10:39.500Z"}
data: {"expired":["nba_celtics_lakers_2026-02-08_b3:moneyline:opp_a1b2c3"],"timestamp":"2026-01-26T02:10:39.500Z"}
```

### `middles:detected`
Expand Down
Loading