Mappings

Get Native ID Mappings

Maps our events and selections to a bookmaker’s own identifiers, so our prices can be matched to the bookmaker’s own markets. For Polymarket, marketId is the conditionId and outcomeId is the CLOB token id. For Kalshi, marketId is the contract ticker and outcomeId is yes or no. Each row carries our event’s home, away, date, sport and league.

Modes:

eventId, or eventIds with up to 10 ids
marketId, or marketIds with up to 10 ids, optionally with outcomeId
outcomeId alone
bulk sync: bookmaker with none of the above. Returns every mapping for upcoming and live linked events as { "data": [...], "nextCursor": "..." }. Pass nextCursor back as cursor until it is null.

Every mode returns {data, nextCursor}; nextCursor is null for lookups. market and active narrow every mode; sport, league, limit and cursor apply to bulk sync only. When outcomeId alone matches outcomes in more than one market (Kalshi outcome ids are yes and no), the request returns 400 and marketId must be added. market, hdp and side use our event’s orientation, the same as /v3/odds. A mapping stays listed with active: false after the bookmaker withdraws the outcome. A batch or bulk call counts as one request. Available on paid plans; the bookmaker must be in your selection.

GET

mappings

Get Native ID Mappings

curl --request GET \
  --url https://api.odds-api.io/v3/mappings

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.odds-api.io/v3/mappings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.odds-api.io/v3/mappings"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.odds-api.io/v3/mappings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "eventId": 71515842,
      "home": "Pittsburgh Steelers",
      "away": "Cleveland Browns",
      "date": "2023-11-07T05:31:56Z",
      "sport": {
        "name": "Football",
        "slug": "football"
      },
      "league": {
        "name": "Premier League",
        "slug": "premier-league"
      },
      "bookmaker": "Polymarket",
      "market": "Spread",
      "label": "<string>",
      "hdp": -2.5,
      "side": "home",
      "nativeEventId": "885112",
      "marketId": "0x3b5c0c7e...",
      "outcomeId": "71321045679252212594626385532706912750332728571942532289631379312455583992563",
      "outcomeLabel": "Browns",
      "extra": {},
      "active": true,
      "firstSeenAt": "2023-11-07T05:31:56Z",
      "lastCheckedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "<string>"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

Query Parameters

apiKey

string

required

API key for authentication

bookmaker

string

required

Bookmaker name

eventId

string

Our event id. Returns every mapping of this event.

eventIds

string

Comma-separated list of up to 10 of our event ids. Use instead of eventId.

marketId

string

The bookmaker's market id (Polymarket conditionId, Kalshi contract ticker). Can be combined with outcomeId.

marketIds

string

Comma-separated list of up to 10 bookmaker market ids. Use instead of marketId; can be combined with outcomeId.

outcomeId

string

The bookmaker's outcome id (Polymarket CLOB token id, Kalshi yes or no). For Kalshi, pass it together with marketId.

market

string

Only this market, by its exact name as served in /v3/odds (case-sensitive).

active

enum<string>

true for outcomes the bookmaker still lists, false for withdrawn ones. Default: both.

Available options:

true,

false

sport

string

Bulk sync only: sport slug or name.

league

string

Bulk sync only: league slug. Requires sport.

limit

integer

default:1000

Bulk sync only: rows per page.

Required range: 1 <= x <= 5000

cursor

string

Bulk sync only: the nextCursor of the previous page.

Response

OK. data holds the mappings; nextCursor is set only in bulk sync while more pages remain.

Every /v3/mappings response. nextCursor is null for lookups and set in bulk sync while more pages remain.

data

object[]

Show child attributes

nextCursor

string | null

Pass as cursor to get the next page. null on the last page.

Get Native ID Mappings

curl --request GET \
  --url https://api.odds-api.io/v3/mappings

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.odds-api.io/v3/mappings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.odds-api.io/v3/mappings"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.odds-api.io/v3/mappings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "eventId": 71515842,
      "home": "Pittsburgh Steelers",
      "away": "Cleveland Browns",
      "date": "2023-11-07T05:31:56Z",
      "sport": {
        "name": "Football",
        "slug": "football"
      },
      "league": {
        "name": "Premier League",
        "slug": "premier-league"
      },
      "bookmaker": "Polymarket",
      "market": "Spread",
      "label": "<string>",
      "hdp": -2.5,
      "side": "home",
      "nativeEventId": "885112",
      "marketId": "0x3b5c0c7e...",
      "outcomeId": "71321045679252212594626385532706912750332728571942532289631379312455583992563",
      "outcomeLabel": "Browns",
      "extra": {},
      "active": true,
      "firstSeenAt": "2023-11-07T05:31:56Z",
      "lastCheckedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "<string>"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

Getting Started

API Reference

WebSocket

Get Native ID Mappings

Query Parameters

Response