PHPackages                             hristonev/sportmonks-client-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. hristonev/sportmonks-client-bundle

ActiveSymfony-bundle[API Development](/categories/api)

hristonev/sportmonks-client-bundle
==================================

Easily talk to an SportMonks API in Symfony

1.0.3(7y ago)149.2k6[7 issues](https://github.com/hristonev/sportmonks-client-bundle/issues)[1 PRs](https://github.com/hristonev/sportmonks-client-bundle/pulls)MITPHP

Since Oct 31Pushed 7y ago3 watchersCompare

[ Source](https://github.com/hristonev/sportmonks-client-bundle)[ Packagist](https://packagist.org/packages/hristonev/sportmonks-client-bundle)[ RSS](/packages/hristonev-sportmonks-client-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (7)Used By (0)

SportMonks API Client Library
=============================

[](#sportmonks-api-client-library)

[![Build Status](https://camo.githubusercontent.com/bc5205dc9d191f32db92b6edc253415b9894e4f7e28ad5110d293d38e447ab92/68747470733a2f2f7472617669732d63692e6f72672f68726973746f6e65762f73706f72746d6f6e6b732d636c69656e742d62756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/hristonev/sportmonks-client-bundle)

API Version support
-------------------

[](#api-version-support)

This API Client supports SportMonks v2.0.

Requirements
------------

[](#requirements)

- PHP 5.6 or higher

### Installation

[](#installation)

`composer require hristonev/sportmonks-client-bundle`

Configuration
-------------

[](#configuration)

```
// Bootstrap
require 'vendor/autoload.php';

use SportMonks\API\HTTPClient as SportMonksAPI;
use SportMonks\API\Utilities\Auth;

// Default values. Can be initialized without arguments.
$scheme = 'https';
$hostname = 'sportmonks.com';
$subDomain = 'soccer';
$port = 443;

// Auth.
$token = 'open sesame';

$client = new SportMonksAPI();
// or
//$client = new SportMonksAPI($scheme, $hostname, $subDomain, $port);

// Set auth.
$client->setAuth(Auth::BASIC, [
    'token' => $token
]);
```

Usage example
-------------

[](#usage-example)

### Paginated resource

[](#paginated-resource)

```
$data = [];
do{
    $data = array_merge($data, $client->countries()->findAll());
}while($client->countries()->nextPage());
print_r($data);
```

Reference
---------

[](#reference)

### Include data

[](#include-data)

```
$seasonId = 6361;
$teamId = 85;
$client->squad()->getBySeasonAndTeam(
    $seasonId,
    $teamId,
    [
        'query' => [
            'include' => 'player,position'
        ]
    ]
)
```

Above example, includes player info and player-position info into collection. [Check](https://www.sportmonks.com/soccer/documentation/v2.0/items/includes-sortinglimiting/48) for more query parameters.

### Basic methods `endpoints`

[](#basic-methods-endpoints)

Basic methods find({id}), findAll(), nextPage(). nextPage() is used on paginated response.

- continents
- countries
- leagues
- seasons
    - find(id, true) `Include results.`
    - standings(season\_id)
    - standingsLive(season\_id)
    - topScorers(season\_id)
- fixtures
    - between()->period(from, to, teamId) `Params from and to are DateTime objects, teamId is integer. TeamId is optional.`
    - date()->day(date) `Param is DateTime object.`
    - commentaries(fixture\_id)
    - videoHighlights(fixture\_id)
    - tvStations(fixture\_id)
    - odds(fixture\_id)
    - oddsByBookmaker(fixture\_id, bookmaker\_id)
    - oddsByMarket(fixture\_id, market\_id)
    - oddsInPlay(fixture\_id)
    - `Fixtures does not support findAll method.`
- teams
    - find(id, true) `Include stats.`
    - season(id) `Get teams by season.`
    - `Teams does not support findAll method.`
- head2Head
    - get(array) `Array must contain 2 elements(team1_id,team2_id).`
    - `There is no additional mthods.`
- liveScores
    - today()
    - inPlay()
- highlights
    - `Video haighlights does not support find method. Additional method in fixtures is presented.`
- venues
    - `Venue does not support findAll method.`
- bookmakers
- players
    - `Players does not support findAll method.`
- squad
    - getBySeasonAndTeam(season\_id, team\_id) `No other methods`

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 88.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~129 days

Total

5

Last Release

2598d ago

Major Versions

0.0.1 → 1.0.12017-11-07

### Community

Maintainers

![](https://www.gravatar.com/avatar/33c8d00b1c5c2be9367a3348befbd5902125acd2fa5bdfc399a6883018ba9d1d?d=identicon)[hristonev](/maintainers/hristonev)

---

Top Contributors

[![hristonev](https://avatars.githubusercontent.com/u/5811972?v=4)](https://github.com/hristonev "hristonev (32 commits)")[![kashmiry](https://avatars.githubusercontent.com/u/4423561?v=4)](https://github.com/kashmiry "kashmiry (2 commits)")[![evsar3](https://avatars.githubusercontent.com/u/1992754?v=4)](https://github.com/evsar3 "evsar3 (1 commits)")[![MrDarkest](https://avatars.githubusercontent.com/u/20922157?v=4)](https://github.com/MrDarkest "MrDarkest (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/hristonev-sportmonks-client-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/hristonev-sportmonks-client-bundle/health.svg)](https://phpackages.com/packages/hristonev-sportmonks-client-bundle)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)