Odds88

https://docs.odds88.io
Admin
Odds88 is a sports data aggregation platform providing REST APIs and WebSocket feeds for real-time...
Tokens:65,403
Snippets:418
Trust Score:8
Update:6 months ago
Show doc for...
Tokens:
Raw
### Bet Placement Request JSON

Source: https://docs.odds88.io/integration-process/recommended-integration-flow/optional-features/starting-price-integration/bet-placement

Example payload for placing a bet. Note that the price field is set to null for Starting Price market bets.

```json
{
  "id": "TestBet88",
  "player": {
    "deviceId": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36",
    "languageId": "en",
    "ip": "0.0.0.0",
    "segmentId": 1000
  },
  "priceChange": 1,
  "items": [
    {
      "eventId": 12345,
      "marketId": 1,
      "selectionId": 2,
      "racingSelection": null,
      "price": null
    }
  ],
  "betType": 0,
  "amount": {
    "currency": "EUR",
    "value": 10000,
    "precision": 4
  }
}
```

--------------------------------

### PUT /api/KafkaFeed/start

Source: https://docs.odds88.io/odds88-client-api/odds88-feeds/delta-feed-through-kafka

Initiates the data flow to the client's Kafka topic. This should be called once before starting consumption.

```APIDOC
## PUT /api/KafkaFeed/start

### Description
Initiates the data flow to the client's Kafka topic. This should be called once before starting consumption.

### Method
PUT

### Endpoint
/api/KafkaFeed/start
```

--------------------------------

### GET /api/CurrencyExchange/active-currencies

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/currency-exchange-api

Gets the list of supported currencies by type. Rate-limited to 10 requests per minute.

```APIDOC
## GET /api/CurrencyExchange/active-currencies

### Description
Gets the list of supported currencies by type.

### Method
GET

### Endpoint
/api/CurrencyExchange/active-currencies

### Query Parameters
- **type** (integer) - Optional - Currency type to filter (if null - returns all active currencies for all types). Possible values: 1 (Fiat), 2 (Crypto), 3 (Custom).

### Responses
#### Success Response (200)
- **symbol** (string) - The currency symbol.
- **type** (integer) - The type of currency (1: Fiat, 2: Crypto, 3: Custom).
- **precision** (integer) - The precision value for the currency.

#### Response Example
```json
[
  {
    "symbol": "USD",
    "type": 1,
    "precision": 2
  },
  {
    "symbol": "BTC",
    "type": 2,
    "precision": 8
  }
]
```

### Rate Limits
- 10 requests per 1 minute per account.
```

--------------------------------

### GET /api/Dictionary/reject-reasons

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/dictionary-api

Retrieves a list of possible rejection reasons available in the system.

```APIDOC
## GET /api/Dictionary/reject-reasons

### Description
Gets possible reject reasons that can exist.

### Method
GET

### Endpoint
/api/Dictionary/reject-reasons

### Response
#### Success Response (200)
- **OK** - The request was successful.

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
```

--------------------------------

### Market Contingency Example 1

Source: https://docs.odds88.io/integration-process/recommended-integration-flow/optional-features/pickem-integration/market-contingency

Demonstrates two markets that cannot be combined due to overlapping ContingencyKey and ContingencyScope values.

```javascript
{
Id: 1500,
Name: "Team2 total",
IsActive: true,
ContingencyKey: [1001-MT3-MT3, 1001-MT3-MT4],
ContingencyScope: [C1112],
Selections: {…},
}
```

```javascript
{
Id: 1501,
Name: "Team1 total",
IsActive: true,
ContingencyKey: [1001-MT4-MT4, 1001-MT3-MT4],
ContingencyScope: [C1112],
Selections: {…},
}
```

--------------------------------

### Market Contingency Example 2

Source: https://docs.odds88.io/integration-process/recommended-integration-flow/optional-features/pickem-integration/market-contingency

Shows how a market with an empty ContingencyScope invalidates other markets with overlapping ContingencyKeys.

```javascript
{
Id: 1300,
Name: "Haso runs",
IsActive: true,
ContingencyKey: [1001-MT1-MT1, 1001-MT1-MT2],
ContingencyScope: [P112],
Selections: {…},
}
,
{
Id: 1301,
Name: "Kako runs",
IsActive: true,
ContingencyKey: [1001-MT1-MT1, 1001-MT1-MT2],
ContingencyScope: [P1113],
Selections: {…},
}
```

```javascript
{
Id: 1400,
Name: "Total",
IsActive: true,
ContingencyKey: [1001-MT2-MT2, 1001-MT1-MT2],
ContingencyScope: [],
Selections: {…},
}
```

--------------------------------

### Start Data Flow Endpoint

Source: https://docs.odds88.io/odds88-client-api/odds88-feeds/delta-feed-through-kafka

Initiates the data flow to the client's Kafka topic; call this once before consumption.

```http
/api/KafkaFeed/start
```

--------------------------------

### GET /feed/cashout/v2

Source: https://docs.odds88.io/odds88-client-api/odds88-feeds/cashout-feed

Retrieves real-time updated suggested cashout values for bets.

```APIDOC
## GET /feed/cashout/v2

### Description
The feed contains real-time updated suggested cashout values for bets. The stream connection is rate-limited and there can be only 1 active connection at a time.

### Method
GET

### Endpoint
/feed/cashout/v2

### Parameters
#### Query Parameters
- **revision** (integer) - Required - Unix time stamp seconds of the moment, from which you want to get recovery. Can be 0 for initial connection. Max value - 3 days from current time.

### Response
#### Success Response (200)
- **pingId** (string) - Message ping id, if the message is a ping
- **data** (object) - Message data containing betId, playerId, status, timestamp, and amount details.
```

--------------------------------

### POST /api/events/schedule/v2

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/feed-api

Retrieves a list of non-outright events for a specified UTC start date.

```APIDOC
## POST /api/events/schedule/v2

### Description
Gets a list of non-outright events with a specified UTC start date. This endpoint is rate-limited to 10 requests per second per account.

### Method
POST

### Endpoint
/api/events/schedule/v2

### Request Body
- **QueryTradingEventModel** (object) - Required - The request body containing the query parameters for the event schedule.

### Response
#### Success Response (200)
- **Array<EventInfoViewModelV2>** - A list of event information objects.

#### Error Responses
- **400** - Bad Request (ProblemDetails)
- **401** - Unauthorized
- **403** - Forbidden
- **429** - Too many requests
- **500** - Internal Server Error
```

--------------------------------

### Multi Bet Placement JSON

Source: https://docs.odds88.io/integration-process/recommended-integration-flow/optional-features/each-way-betting-integration/bet-placement

Example structure for a multi bet request involving multiple selection items.

```json
{
  "id": "TestBet88",
  "player": {
    "deviceId": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36",
    "languageId": "en",
    "ip": "0.0.0.0",
    "segmentId": 1000
  },
  "priceChange": 1,
  "items": [
    {
      "eventId": 12345,
      "marketId": 71356478,
      "selectionId": 41009286,
      "price": 5.5
    },
    {
      "eventId": 54321,
      "marketId": 71356478,
      "selectionId": 37593953,
      "price": 2.5
    }
  ],
  "betType": 0,
  "amount": {
    "currency": "EUR",
    "value": 200000,
    "precision": 4
  }
}
```

--------------------------------

### GET /api/v2/metadata-feed

Source: https://docs.odds88.io/odds88-client-api/odds88-feeds/metadata-feed

Retrieves metadata updates for events starting from a specified revision timestamp.

```APIDOC
## GET /api/v2/metadata-feed

### Description
The feed contains metadata updates for events. The stream connection is rate-limited and there can be only 1 active connection at a time.

### Method
GET

### Endpoint
/api/v2/metadata-feed

### Parameters
#### Query Parameters
- **revision** (integer) - Required - Unix time stamp seconds of the moment, from which you want to get recovery. Can be 0 for initial connection. Max value - 3 days from current time.

### Response
#### Success Response (200)
- **eventId** (integer) - Event ID
- **sportId** (integer) - Sport ID
- **dataType** (string) - Data type
- **version** (integer) - Version number
- **data** (object) - Event metadata content
- **creationTime** (string) - Creation timestamp
```

--------------------------------

### GET /api/events

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/feed-api

Retrieves a list of non-outright events. You can filter events by specifying a UTC start date. Rate limits apply.

```APIDOC
## GET /api/events

### Description
Gets list of non-outright event with specified UTC start date.

### Method
GET

### Endpoint
/api/events

### Query Parameters
- **startDate** (string) - Optional - Starting date of event. If null returns Events with StartTime=null or from tomorrow.
- **sportIds** (array[integer]) - Optional - If not null filters by SportIds.
- **locationIds** (array[integer]) - Optional - If not null filters by LocationIds.

### Rate Limits
- 10 req/1s per account

### Response
#### Success Response (200)
- **id** (integer) - TradeArt event id.
- **name** (string) - Event name.
- **status** (EventStatus) - Event status representing current status of the match.
- **tradingStatus** (TradingStatus) - Status of trading for the event showing how it should be processed.
- **statusDescription** (string) - Free text event status description (optional).
- **country** (ReferenceViewModelV2) - Id and Name of event's country.
- **sport** (ReferenceViewModelV2) - Id and Name of event's sport.
- **competition** (ReferenceViewModelV2) - Id and Name of event's competition.
- **season** (ReferenceViewModelV2) - Id and Name of event's season. Can be null for not-outright events.
- **competitors** (array[ReferenceViewModelV2]) - Ids and Names of event's competitors.
- **startTime** (string) - Start time of the event. Can be null.
- **isOutright** (boolean) - Flag which indicates that event is outright.
- **customDisplayData** (object) - Custom display parameters of the event.
- **isBetBuilderSupported** (boolean) - Indicates whether this selection can be used in Bet Builder.
- **mappingInfo** (array[MappingViewModel]) - Represents information about external feeds.

### Response Example
```json
{
  "id": 12345,
  "name": "Example Event",
  "status": 3, 
  "tradingStatus": 0,
  "statusDescription": null,
  "country": {"id": 1, "name": "Example Country"},
  "sport": {"id": 2, "name": "Example Sport"},
  "competition": {"id": 3, "name": "Example Competition"},
  "season": null,
  "competitors": [{"id": 4, "name": "Team A"}, {"id": 5, "name": "Team B"}],
  "startTime": "2023-10-27T10:00:00Z",
  "isOutright": false,
  "customDisplayData": {},
  "isBetBuilderSupported": true,
  "mappingInfo": []
}
```
```

--------------------------------

### Configure Kafka Consumer in .NET

Source: https://docs.odds88.io/odds88-client-api/odds88-feeds/delta-feed-through-kafka

Sets up the ConsumerConfig object with required security and connection parameters.

```csharp
var config = new ConsumerConfig
{
    BootstrapServers = "server address",
    SecurityProtocol = SecurityProtocol.SaslSsl,
    SaslMechanism = SaslMechanism.ScramSha512,
    SaslUsername = "username",
    SaslPassword = "password",
    GroupId = "groupid",
    AutoOffsetReset = AutoOffsetReset.Latest,
    EnableAutoCommit = false
};
```

--------------------------------

### GET /feed/v1/schedule

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/feed-api

Fetches a schedule of regular events. This endpoint can be filtered by sports, locations, and start date. It returns a list of events with their details, but excludes market information. Note: This endpoint is rate-limited to 10 requests per second.

```APIDOC
## GET /feed/v1/schedule

### Description
Fetches a schedule of regular events based on sports, locations, and start date. Returns event details but not market information.

### Method
GET

### Endpoint
/feed/v1/schedule

### Query Parameters
- **sports** (string) - Optional - Comma-separated list of sports to filter by.
- **locations** (string) - Optional - Comma-separated list of locations to filter by.
- **startDate** (string) - Optional - The start date for fetching events (e.g., YYYY-MM-DD).

### Rate Limiting
- 10 requests per second

### Response
#### Success Response (200)
- **events** (array) - An array of event objects.
  - **eventId** (string) - The unique identifier for the event.
  - **sportId** (string) - The identifier for the sport.
  - **locationId** (string) - The identifier for the location.
  - **startTime** (string) - The start time of the event in ISO 8601 format.
  - **name** (string) - The name of the event.
  - **sportName** (string) - The name of the sport.
  - **locationName** (string) - The name of the location.

#### Response Example
```json
{
  "events": [
    {
      "eventId": "evt123",
      "sportId": "spr456",
      "locationId": "loc789",
      "startTime": "2023-10-27T10:00:00Z",
      "name": "Team A vs Team B",
      "sportName": "Football",
      "locationName": "Stadium X"
    }
  ]
}
```
```

--------------------------------

### Handle Selection Prices in SP Markets

Source: https://docs.odds88.io/integration-process/recommended-integration-flow/optional-features/starting-price-integration/markets

Selection price and startingPrice fields are null before the event starts; use originalPrice for indicative values.

```json
{
  "id": 12345,
  "name": "Goway",
  "probability": 0.39130363,
  "price": null,
  "originalPrice": 2.15,
  "status": 0,
  "settlement": 0,
  "deadHeatFactor": 0,
  "extraParameters": {},
  "isBetBuilderSupported": false,
  "competitorId": 54321
  "startingPrice": null
}
```

--------------------------------

### GET /api/CurrencyExchange/currency-precision

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/currency-exchange-api

Gets the precision value of the specified currency. Rate-limited to 1 request per second.

```APIDOC
## GET /api/CurrencyExchange/currency-precision

### Description
Gets precision value of the specified currency.

### Method
GET

### Endpoint
/api/CurrencyExchange/currency-precision

### Query Parameters
- **symbol** (string) - Required - Currency ticker symbol.

### Responses
#### Success Response (200)
- **precision** (integer) - The precision value for the currency.

#### Response Example
```json
{
  "precision": 2
}
```

### Rate Limits
- 1 request per 1 second per account.
```

--------------------------------

### Get Active Currencies OpenAPI Specification

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/currency-exchange-api

This OpenAPI specification defines the 'Get active currencies' endpoint, which retrieves a list of supported currencies by type. It includes details on request parameters, responses, and rate limits.

```json
{"openapi":"3.0.4","info":{"title":"[T1159-STAGE] Odds88 API","version":"v1"},"tags":[{"name":"CurrencyExchange"}],"security":[{"Bearer":[]}]},"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\","scheme":"Bearer","bearerFormat":"JWT"}},"schemas":{"CurrencyExchange.Models.CurrencyType":{"enum":[1,2,3],"type":"integer","description":"* `1` - Fiat
* `2` - Crypto
* `3` - Custom","format":"int32"},"CurrencyExchange.Models.Currencies.OutboundDTO.ActiveCurrencyDto":{"type":"object","properties":{"symbol":{"type":"string","nullable":true},"type":{"allOf":[{"$ref":"#/components/schemas/CurrencyExchange.Models.CurrencyType"}],"description":"* `1` - Fiat
* `2` - Crypto
* `3` - Custom"},"precision":{"type":"integer","format":"int32"}},"additionalProperties":false}}},"paths":{"/api/CurrencyExchange/active-currencies":{"get":{"tags":["CurrencyExchange"],"summary":"Gets active currencies for the given currency type","description":"\n**Rate Limits (per account):**\n- **10 req/1m**","operationId":"Get active currencies","parameters":[{"name":"type","in":"query","description":"Currency type to filter (if null - returns all active currencies for all types)","schema":{"allOf":[{"$ref":"#/components/schemas/CurrencyExchange.Models.CurrencyType"}],"description":"* `1` - Fiat
* `2` - Crypto
* `3` - Custom"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.ActiveCurrencyDto"}}},"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.ActiveCurrencyDto"}}},"text/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.ActiveCurrencyDto"}}}}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"429":{"description":"Too many requests"},"500":{"description":"Internal Server Error"}}}}}}
```

--------------------------------

### Multibet Bet Placement with BetBuilder Leg

Source: https://docs.odds88.io/integration-process/recommended-integration-flow/optional-features/betbuilder-integration/bet-placement

This example demonstrates how to place a multibet where one of the legs is a BetBuilder bet. Standard bet legs can be included alongside BetBuilder legs in the 'items' array.

```json
{
  "id": "bet-id",
  "player": {...},
  "amount": {
    "currency": "USD",
    "value": 50000,
    "precision": 4
  },
  "priceChange": 1,
  "items": [
    {
      "eventId": 4780136,
      "marketId": -1,
      "selectionId": -1,
      "racingSelection": "",
      "betBuilderBetItems": [
        {
          "marketId": 1,
          "selectionId": 1
        },
        {
          "marketId": 67,
          "selectionId": 20
        }
      ],
      "price": 6.75
    },
    {
      "eventId": 4870489,
      "marketId": 1,
      "selectionId": 1,
      "racingSelection": "",
      "betBuilderBetItems": [],
      "price": 2.76
    }
  ]
}
```

--------------------------------

### Get Currency Precision OpenAPI Specification

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/currency-exchange-api

This OpenAPI specification defines the 'Get currency precision' endpoint, which retrieves the precision value for a given currency ticker symbol. It includes details on request parameters, responses, and rate limits.

```json
{"openapi":"3.0.4","info":{"title":"[T1159-STAGE] Odds88 API","version":"v1"},"tags":[{"name":"CurrencyExchange"}],"security":[{"Bearer":[]}],
```

```json
"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\","scheme":"Bearer","bearerFormat":"JWT"}},"schemas":{"CurrencyExchange.Models.Currencies.OutboundDTO.CurrencyPrecisionDto":{"type":"object","properties":{"precision":{"type":"integer","format":"int32"}},"additionalProperties":false}}},"paths":{"/api/CurrencyExchange/currency-precision":{"get":{"tags":["CurrencyExchange"],"summary":"Gets precision value for the given currency ticker symbol","description":"\n**Rate Limits (per account):**\n- **1 req/1s**","operationId":"Get precision of a currency","parameters":[{"name":"symbol","in":"query","description":"Currency ticker symbol","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.CurrencyPrecisionDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.CurrencyPrecisionDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.CurrencyPrecisionDto"}}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"429":{"description":"Too many requests"},"500":{"description":"Internal Server Error"}}}}}}
```

--------------------------------

### GET /api/schema/periods

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/schema-api

Retrieves all existing periods for a specific sport.

```APIDOC
## GET /api/schema/periods

### Description
Gets all existing periods for a specific sport. If no sportId is provided, all periods are returned.

### Method
GET

### Endpoint
/api/schema/periods

### Parameters
#### Query Parameters
- **sportId** (integer) - Optional - TradeArt sport id.

### Response
#### Success Response (200)
- **id** (integer) - Period ID
- **name** (string) - Period name
- **sportId** (integer) - Associated sport ID
```

--------------------------------

### Single Bet Placement JSON

Source: https://docs.odds88.io/integration-process/recommended-integration-flow/optional-features/each-way-betting-integration/bet-placement

Example structure for a single bet request including player details and stake amount.

```json
{
  "id": "TestBet88",
  "player": {
    "deviceId": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36",
    "languageId": "en",
    "ip": "0.0.0.0",
    "segmentId": 1000
  },
  "priceChange": 1,
  "items": [
    {
      "eventId": 12345,
      "marketId": 71356478,
      "selectionId": 41009286,
      "price": 5.5
    }
  ],
  "betType": 0,
  "amount": {
    "currency": "EUR",
    "value": 200000,
    "precision": 4
  }
}
```

--------------------------------

### GET /api/Metadata/event/all/{eventId}

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/metadata-api

Retrieves all latest metadata for a specific event.

```APIDOC
## GET /api/Metadata/event/all/{eventId}

### Description
Gets all latest metadata for a specific event. This endpoint is rate-limited to 1 request per second.

### Method
GET

### Endpoint
/api/Metadata/event/all/{eventId}

### Parameters
#### Path Parameters
- **eventId** (integer) - Required - TradeArt event id.

### Response
#### Success Response (200)
- **eventId** (integer) - Event ID
- **sportId** (integer) - Sport ID
- **dataType** (string) - Data type
- **version** (integer) - Version number
- **data** (object) - Metadata content
- **creationTime** (string) - Creation timestamp
```

--------------------------------

### Get Available Metadata Types for Competitor

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/global-metadata-api

Use this endpoint to discover what types of metadata are available for a specific competitor. The response lists available metadata types as strings. Rate limits apply.

```json
{"openapi":"3.0.4","info":{"title":"[T1159-STAGE] Odds88 API","version":"v1"},"tags":[{"name":"GlobalMetadata"}],"security":[{"Bearer":[]}]},"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"","scheme":"Bearer","bearerFormat":"JWT"}}},"paths":{"/api/GlobalMetadata/sport/{sportId}/league/{leagueId}/competitor/{competitorId}/types":{"get":{"tags":["GlobalMetadata"],"description":"\n**Rate Limits (per account):**\n- **40 req/1s**","parameters":[{"name":"sportId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"leagueId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"competitorId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"type":"array","items":{"type":"string"}}},"application/json":{"schema":{"type":"array","items":{"type":"string"}}},"text/json":{"schema":{"type":"array","items":{"type":"string"}}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"429":{"description":"Too many requests"}}}}}}}
```

--------------------------------

### GET /api/translations/all/sport/{sportId}

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/translations-api

Retrieves all existing translations for a specific sport entity.

```APIDOC
## GET /api/translations/all/sport/{sportId}

### Description
Gets all existing translations for a specific sport. This endpoint is rate-limited to 20 requests per second.

### Method
GET

### Endpoint
/api/translations/all/sport/{sportId}

### Parameters
#### Path Parameters
- **sportId** (integer) - Required - TradeArt sport id.

### Response
#### Success Response (200)
- **id** (integer) - ID of the entity.
- **translations** (object) - Translations for the entity, where the key is the language code and the value is the translated text.

#### Response Example
{
  "id": 1,
  "translations": {
    "en": "Football",
    "fr": "Football"
  }
}
```

--------------------------------

### GET /api/Metadata/event/types/{eventId}

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/metadata-api

Retrieves all existing metadata types for a specific event.

```APIDOC
## GET /api/Metadata/event/types/{eventId}

### Description
Gets all existing metadata types for a specific event. This endpoint is rate-limited to 40 requests per second.

### Method
GET

### Endpoint
/api/Metadata/event/types/{eventId}

### Parameters
#### Path Parameters
- **eventId** (integer) - Required - TradeArt event id.

### Response
#### Success Response (200)
- **types** (array of strings) - List of available metadata types
```

--------------------------------

### Market Contingency Example 3

Source: https://docs.odds88.io/integration-process/recommended-integration-flow/optional-features/pickem-integration/market-contingency

Illustrates a scenario where a market with an empty ContingencyScope restricts another market with an overlapping ContingencyKey.

```javascript
{
Id: 1500,
Name: "Team2 total",
IsActive: true,
ContingencyKey: [1001-MT3-MT3, 1001-MT2-MT3],
ContingencyScope: [C1112],
Selections: {…},
}
```

```javascript
{
Id: 1600,
Name: "Total",
IsActive: true,
ContingencyKey: [1001-MT2-MT2, 1001-MT2-MT3],
ContingencyScope: [],
Selections: {…},
}
```

--------------------------------

### POST /api/Account/login

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/account-api

Logs a user into the system and returns an access token. This token can be used to authenticate subsequent requests to other API endpoints. The endpoint is rate-limited to 5 requests per second per account.

```APIDOC
## POST /api/Account/login

### Description
Logs a user into the system and returns an access token. This token can be used to authenticate subsequent requests to other API endpoints. The endpoint is rate-limited to 5 requests per second per account.

### Method
POST

### Endpoint
/api/Account/login

### Parameters
#### Request Body
- **clientId** (string) - Required - The client identifier.
- **password** (string) - Required - The user's password.

### Request Example
```json
{
  "clientId": "your_client_id",
  "password": "your_password"
}
```

### Response
#### Success Response (200)
- **string** - An access token string.

#### Response Example
```json
"your_access_token"
```

#### Error Response (429)
- **Too many requests**
```

--------------------------------

### PickemEventSnapshotDeltaViewModel

Source: https://docs.odds88.io/odds88-client-api/odds88-feeds/pickem-feed/pickem-feed-messages

Represents a full snapshot of pickem event data, including event details and associated markets.

```APIDOC
## TradeArt.TradeArtApi.Contracts.DeltaMessage.Delta.PickemDelta.PickemEventSnapshotDeltaViewModel

### Description
Full snapshot of pickem event data.

### Properties
- **type** (TradeArt.TradeArtApi.Contracts.DeltaMessage.Enums.PickemDeltaType) - Captures the type of delta from a list of enums (0 - Unknown, 1 - EventStatusChanged, 2 - EventChanged, 3 - EventSnapshot, 4 - MarketsChanged).
- **eventId** (integer) - Id of the event.
- **version** (integer) - Gets or sets delta version.
- **correlationId** (string) - Gets or sets the correlation id of the message to trace back.
- **creationTime** (string) - Captures the timestamp the dto was created.
- **sportId** (integer) - Id of the sport.
- **locationId** (integer) - Id of the location.
- **leagueId** (integer) - Id of the league.
- **isOutright** (boolean) - Whether the event is outright.
- **updateSequence** (integer) - Event delta sequence. Incremented with each sent delta.
- **lastUpdatedTime** (integer) - Event update time. Incremented with each valuable update.
- **eventInfo** (TradeArt.TradeArtApi.Contracts.DeltaMessage.Delta.PickemDelta.PickemEventInfoViewModel) - Fixture info containing basic event information.
- **markets** (array) - Markets of the event.
```

--------------------------------

### GET /api/translations/all/league/{leagueId}

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/translations-api

Retrieves all existing translations for a specified league. This endpoint is rate-limited.

```APIDOC
## GET /api/translations/all/league/{leagueId}

### Description
Gets all existing translations for a specific league.

### Method
GET

### Endpoint
/api/translations/all/league/{leagueId}

### Parameters
#### Path Parameters
- **leagueId** (integer) - Required - TradeArt league id.

### Responses
#### Success Response (200)
- **id** (integer) - ID of the entity.
- **translations** (object) - Translations for the entity, where the key is the language code and the value is the translated text.

### Response Example
```json
{
  "id": 456,
  "translations": {
    "en": "English League Name",
    "fr": "Nom de Ligue Français"
  }
}
```

### Rate Limits
- **20 req/1s** per account.
```

--------------------------------

### GET /api/translations/all/region/{regionId}

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/translations-api

Retrieves all existing translations for a specified region. This endpoint is rate-limited.

```APIDOC
## GET /api/translations/all/region/{regionId}

### Description
Gets all existing translations for a specific region.

### Method
GET

### Endpoint
/api/translations/all/region/{regionId}

### Parameters
#### Path Parameters
- **regionId** (integer) - Required - TradeArt region id.

### Responses
#### Success Response (200)
- **id** (integer) - ID of the entity.
- **translations** (object) - Translations for the entity, where the key is the language code and the value is the translated text.

### Response Example
```json
{
  "id": 123,
  "translations": {
    "en": "English Translation",
    "es": "Spanish Translation"
  }
}
```

### Rate Limits
- **20 req/1s** per account.
```

--------------------------------

### Bet Placement API - Reject Reasons

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/bets-api

This section details the various reasons a bet placement request might be rejected. Each reason is associated with a specific integer code.

```APIDOC
## Bet Placement API - Reject Reasons

This API endpoint provides information about various reasons why a bet placement request might be rejected. Each rejection reason is mapped to a specific integer code.

### Reject Reasons Enum

* **0** - None: Checks passed
* **1** - PriceChanged: Price Changed
* **2** - PriceChangedLow: Price Changed Low
* **3** - PriceChangedHigh: Price Changed High
* **4** - MissingMandatoryFields: Missing Mandatory Fields
* **5** - InvalidDataFormat: Invalid Data Format
* **6** - EventsOrMarketsCannotBeCombined: Events Or Markets Cannot Be Combined
* **7** - SelectionsFromSameMarket: Selections From Same Market
* **8** - MultipleSelectionsInEvent: Multiple Selections In Event
* **9** - DuplicateTeamIds: Duplicate Team Ids
* **10** - EventNotFound: Event Not Found
* **11** - EventNotActive: Event Not Active
* **12** - MarketNotFound: Market Not Found
* **13** - MarketNotActive: Market Not Active
* **14** - SelectionNotFound: Selection Not Found
* **15** - SelectionNotActive: Selection Not Active
* **16** - AdminConsoleError: Admin Console Error
* **17** - EventLimitExceeded: Event Limit Exceeded
* **18** - MarketLimitExceeded: Market Limit Exceeded
* **19** - BetLimitExceeded: Bet Limit Exceeded
* **20** - PayoutLimitExceeded: Payout Limit Exceeded
* **21** - EventVarLimitExceeded: Event CCF Limit Exceeded
* **22** - MarketVarLimitExceeded: Market CCF Limit Exceeded
* **23** - BetVarLimitExceeded: Bet CCF Limit Exceeded
* **24** - PayoutVarLimitExceeded: Payout CCF Limit Exceeded
* **25** - TooHighOdds: Total price was too large
* **26** - SportRestricted: Sport restricted for placing bets
* **27** - EventMarkedStale: Event has not received any updates from source for too long and bets cannot be accepted for it
* **28** - ResponseTimeoutExceeded: Bet placement response timed out
* **29** - ExoticSelectionInvalidFormat: Exotics selection has invalid format
* **39** - ExoticTypeNotMatchWithMarket: Exotics selection type does not match with market type
* **40** - ExoticsMultibetNotSupported: Exotics multibet is not supported
* **50** - SelectionLimitExceeded: Prematch selection Limit Exceeded
* **51** - SelectionVarLimitExceeded: Prematch selection CCF Limit Exceeded
* **52** - MarketIsNotFixedExotics: Requested market is not Fixed Exotics market
* **53** - FixedExoticsPriceNotFoundBySelection: The fixed exotics price was not found by selection
* **54** - FixedExoticsSelectionContainsMultipleCombinations: Multiple combinations are not supported for fixed exotics
* **55** - PlayerBetLimitExceeded: Liability is over player bet liability limit
* **56** - StartingPriceMarketLive: Starting price market went live
* **57** - StartingPriceMultibetNotSupported: Starting price multibet is not supported
* **58** - StartingPriceMarketMatch: Starting price market bets should not contain price
* **59** - NullBetPriceIsNotSupportedForThisMarket: Null bet price is not supported for this market
* **60** - CombinationContainsScratchedCompetitorNumber: Racing selection contains scratched competitor
* **61** - BetBuilderNotSupported: Bet Builder is not supported
* **62** - AlternativeOddsExpired: Alternative odds is expired or not available
* **63** - AlternativeOddsPriceInvalid: Alternative odds price is invalid
* **64** - AlternativeOddsBetItemsInvalid: Alternative odds bet item(s) are invalid
* **65** - AlternativeOddsBetAmountInvalid: Alternative odds bet amount is invalid
* **66** - PlayerMultiBetLimitExceeded: Liability is over player multi bet liability limit
* **67** - SegmentNotFound: Segment not found
* **68** - LiveBetNotSupportedForPickem: Live betting not supported for Pickem bets
* **69** - MarketIsContiguous: Market can't be mixed with other Pickem markets in this bet
* **70** - SegmentIsDisabled: Segment is disabled
* **71** - BetBuilderDuplicatedMarkets: Bet Builder bet item contained duplicated markets
* **72** - StakeTooLow: Stake is too low
* **73** - BetPlacementIsDisabled: Bet placement was manually disabled
* **100** - UnexpectedError: Something went wrong
```

--------------------------------

### GET /api/translations/{lang}/competitors

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/translations-api

Retrieves translations for specific competitors in a requested language.

```APIDOC
## GET /api/translations/{lang}/competitors

### Description
Gets translations to a specific language for specific competitors. This endpoint is rate-limited to 40 requests per second.

### Method
GET

### Endpoint
/api/translations/{lang}/competitors

### Parameters
#### Path Parameters
- **lang** (string) - Required - Language code for translation.

#### Query Parameters
- **competitors** (array of integers) - Optional - Competitors which will be translated.

### Response
#### Success Response (200)
- **id** (integer) - ID of the translation.
- **language** (string) - Language code.
- **translation** (string) - The translated text.

#### Response Example
[
  {
    "id": 123,
    "language": "en",
    "translation": "Team Name"
  }
]
```

--------------------------------

### GET /api/translations/{lang}/regions

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/translations-api

Retrieves translations for specified regions into a target language.

```APIDOC
## GET /api/translations/{lang}/regions

### Description
Gets translations to a specific language for specified regions.

### Method
GET

### Endpoint
/api/translations/{lang}/regions

### Parameters
#### Path Parameters
- **lang** (string) - Required - Language code for translation.

#### Query Parameters
- **regions** (array of integers) - Optional - Regions which will be translated.

### Response
#### Success Response (200)
- **id** (integer) - Translation ID
- **language** (string) - Language code
- **translation** (string) - Translated text

#### Response Example
[
  {
    "id": 10,
    "language": "en",
    "translation": "Europe"
  }
]
```

--------------------------------

### Bet Placement Response Models

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/bets-api

Details the structure of the BetResponseResponseViewModelV2 and associated models used when placing bets.

```APIDOC
## BetResponseResponseViewModelV2

### Description
Represents the response object returned after a bet has been processed.

### Response Fields
- **id** (string) - Auto generated identifier of accepted bet
- **kind** (integer) - Bet kind (0: Single, 1: Multiple)
- **priceChange** (integer) - Price change auto acceptance (0: None, 1: Any, 2: Higher)
- **alternativePrice** (number) - Alternative price offered if liability was exceeded
- **originalBetId** (string) - References the original bet if an alternative price was offered
- **betType** (integer) - Bet Type (0: Standard, 1: Pickem)
- **freeBetType** (integer) - Free Bet Type (0: NotFree, 1: BasicFreeBet)
- **items** (array) - List of bet items
- **amount** (object) - Bet amount with local currency information
```

--------------------------------

### Pickem Market Data Models

Source: https://docs.odds88.io/odds88-client-api/odds88-feeds/pickem-feed/pickem-feed-messages

Schema definitions for Pickem market and selection objects.

```APIDOC
## PickemMarketViewModel

### Description
Represents pickem market data.

### Properties
- **id** (integer, int64) - Market Id
- **name** (string) - Market name
- **type** (integer, int64) - Market type Id
- **parameters** (object) - Parameters of market
- **lineParameterName** (string) - Market line parameter name
- **isActive** (boolean) - Weather event is active
- **selections** (array) - Market selections
- **extraParameters** (object) - Additional market information
- **displayOrder** (integer, int64) - Display order
- **contingencyKey** (array) - Contingency key
- **contingencyScope** (array) - Contingency scope

## PickemSelectionViewModel

### Description
Represents market selection information.

### Properties
- **id** (integer, int64) - Selection Id
- **name** (string) - Selection name
- **price** (number, float) - Selection odds
- **probability** (number, float) - Selection probability
- **isActive** (boolean) - Selection Is Active
- **extraParameters** (object) - Additional selection information
- **competitorId** (integer, int64) - Id of the competitor
- **settlement** (integer) - Settlement result (0: None, 1: Win, 2: Lose, 3: Refund, 4: HalfWin, 5: HalfLose)
- **polarity** (integer) - Polarity (0: None, 1: Positive, 2: Negative)
```

--------------------------------

### GET /api/translations/{lang}/sports

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/translations-api

Retrieves translations for specified sports into a target language.

```APIDOC
## GET /api/translations/{lang}/sports

### Description
Gets translations to a specific language for specified sports.

### Method
GET

### Endpoint
/api/translations/{lang}/sports

### Parameters
#### Path Parameters
- **lang** (string) - Required - Language code of translation.

#### Query Parameters
- **sports** (array of integers) - Optional - Sports which will be translated.

### Response
#### Success Response (200)
- **id** (integer) - Translation ID
- **language** (string) - Language code
- **translation** (string) - Translated text

#### Response Example
[
  {
    "id": 1,
    "language": "en",
    "translation": "Soccer"
  }
]
```

--------------------------------

### GET /api/schema/sports

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/schema-api

Retrieves a list of all available sports. This endpoint is subject to rate limiting.

```APIDOC
## GET /api/schema/sports

### Description
Gets all existing sports.

### Method
GET

### Endpoint
/api/schema/sports

### Parameters

### Request Body

### Request Example

### Response
#### Success Response (200)
- **id** (integer) - The unique identifier for the sport.
- **name** (string) - The name of the sport.

#### Response Example
```json
[
  {
    "id": 1,
    "name": "Football"
  },
  {
    "id": 2,
    "name": "Basketball"
  }
]
```

### Error Handling
- **401**: Unauthorized
- **403**: Forbidden
- **429**: Too many requests
- **500**: Internal Server Error

### Rate Limiting
- **1 req/1m** (per account)
```

--------------------------------

### PickemMarketViewModel

Source: https://docs.odds88.io/odds88-client-api/odds88-feeds/pickem-feed/pickem-feed-messages

Represents a market within a pickem event, including its ID, name, type, and parameters.

```APIDOC
## TradeArt.TradeArtApi.Contracts.DeltaMessage.Delta.PickemDelta.PickemMarketViewModel

### Description
Represents a market within a pickem event.

### Properties
- **id** (integer) - Market Id.
- **name** (string) - Market name.
- **type** (integer) - Market type Id.
- **parameters** (object) - Parameters of market.
```

--------------------------------

### GET /api/translations/templates/market-types

Source: https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/translations-api

Retrieves a market type translation template for a specific sport and a collection of market types.

```APIDOC
## GET /api/translations/templates/market-types

### Description
Gets market type translation template for a specific sport and market types. This endpoint is rate-limited to 10 requests per second.

### Method
GET

### Endpoint
/api/translations/templates/market-types

### Parameters
#### Query Parameters
- **sportId** (integer) - Optional - Sport id.
- **marketTypes** (array) - Optional - Collection of market type ids (up to 100).

### Response
#### Success Response (200)
- **id** (integer) - ID of the entity.
- **translations** (object) - Translations for the entity, where the key is the language code and the value is the translated text.
```
Tokens:
Raw