> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fieldfunded.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visual Assets

> PNG team logos (~85% coverage), PNG & SVG team logos for featured leagues, SVG league logos, 182 SVG country flags and custom SVG sport icons

## Overview

FieldFunded provides a complete set of visual assets to build rich UIs without needing third-party image sources. All assets are served as static files — no authentication required.

## Team Logos

PNG team logos are included automatically in API responses via the `home_logo` and `away_logo` fields. Approximately **85% of matches** have team logos available. When a team logo is unavailable, a default placeholder is returned.

```json theme={null}
{
  "home_team": "Arsenal",
  "away_team": "Chelsea",
  "home_logo": "https://api.fieldfunded.com/api/logo/t-38",
  "away_logo": "https://api.fieldfunded.com/api/logo/t-42"
}
```

* **Format**: PNG
* **Coverage**: \~85% of all matches
* **Fallback**: Default placeholder when unavailable
* **No auth required**: Logo URLs work directly in `<img>` tags

## Country Flags

182 SVG country flags for league grouping and UI decoration.

**URL Pattern**: `https://api.fieldfunded.com/assets/flags/{country_code}.svg`

```html theme={null}
<img src="https://api.fieldfunded.com/assets/flags/gb.svg" alt="UK" width="24" />
<img src="https://api.fieldfunded.com/assets/flags/us.svg" alt="USA" width="24" />
<img src="https://api.fieldfunded.com/assets/flags/br.svg" alt="Brazil" width="24" />
```

The `country_code` uses lowercase [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) codes (e.g., `gb`, `us`, `br`, `de`, `es`, `fr`, `pt`, `jp`).

## Featured Team Logos (SVG & PNG)

High-quality PNG and SVG team logos are available for featured leagues.

**SVG URL Pattern**: `https://api.fieldfunded.com/assets/logos/{league_slug}/{team_slug}.svg`

```html theme={null}
<!-- Example: Arsenal SVG Logo -->
<img src="https://api.fieldfunded.com/assets/logos/premier-league/arsenal.svg" alt="Arsenal" width="32" />
```

Use the `league.slug` and `team.slug` (or lowercase team name with hyphens) to construct the URL.

## League Logos (SVG)

Custom SVGs for the competition logos themselves.

**URL Pattern**: `https://api.fieldfunded.com/assets/leagues/{league_slug}.svg`

```html theme={null}
<!-- Example: Premier League Logo -->
<img src="https://api.fieldfunded.com/assets/leagues/premier-league.svg" alt="Premier League" width="32" />
```

**Supported Leagues**: `premier-league`, `la-liga`, `bundesliga`, `serie-a`, `ligue-1`, `nba`, `nfl`, `nhl`, `mlb`.

> **Note**: Not all leagues have custom logos. The majority of top leagues and popular teams are covered. Niche/regional leagues may only have placeholder assets.

## Sport Icons

32 custom SVG icons covering all supported sports and esports.

**URL Pattern**: `https://api.fieldfunded.com/assets/icons/sports/{sport_key}.svg`

Use the `sport.key` field from any event response to construct the URL:

```javascript theme={null}
const event = await api.getEvent(eventId);
const iconUrl = `https://api.fieldfunded.com/assets/icons/sports/${event.sport.key}.svg`;
```

### Traditional Sports (24)

| Sport             | Key                 | Icon URL                                     |
| ----------------- | ------------------- | -------------------------------------------- |
| Soccer            | `soccer`            | `/assets/icons/sports/soccer.svg`            |
| Basketball        | `basketball`        | `/assets/icons/sports/basketball.svg`        |
| Tennis            | `tennis`            | `/assets/icons/sports/tennis.svg`            |
| Ice Hockey        | `ice-hockey`        | `/assets/icons/sports/ice-hockey.svg`        |
| Baseball          | `baseball`          | `/assets/icons/sports/baseball.svg`          |
| American Football | `american-football` | `/assets/icons/sports/american-football.svg` |
| Rugby             | `rugby`             | `/assets/icons/sports/rugby.svg`             |
| Cricket           | `cricket`           | `/assets/icons/sports/cricket.svg`           |
| MMA               | `mma`               | `/assets/icons/sports/mma.svg`               |
| Handball          | `handball`          | `/assets/icons/sports/handball.svg`          |
| Volleyball        | `volleyball`        | `/assets/icons/sports/volleyball.svg`        |
| Table Tennis      | `table-tennis`      | `/assets/icons/sports/table-tennis.svg`      |
| Boxing            | `boxing`            | `/assets/icons/sports/boxing.svg`            |
| Darts             | `darts`             | `/assets/icons/sports/darts.svg`             |
| Snooker           | `snooker`           | `/assets/icons/sports/snooker.svg`           |
| Badminton         | `badminton`         | `/assets/icons/sports/badminton.svg`         |
| Futsal            | `futsal`            | `/assets/icons/sports/futsal.svg`            |
| Beach Volley      | `beach-volley`      | `/assets/icons/sports/beach-volley.svg`      |
| Floorball         | `floorball`         | `/assets/icons/sports/floorball.svg`         |
| Bandy             | `bandy`             | `/assets/icons/sports/bandy.svg`             |
| Water Polo        | `water-polo`        | `/assets/icons/sports/water-polo.svg`        |
| Aussie Rules      | `aussie-rules`      | `/assets/icons/sports/aussie-rules.svg`      |
| Field Hockey      | `field-hockey`      | `/assets/icons/sports/field-hockey.svg`      |
| Chess             | `chess`             | `/assets/icons/sports/chess.svg`             |

### Esports (8)

| Game              | Key                 | Icon URL                                     |
| ----------------- | ------------------- | -------------------------------------------- |
| Counter-Strike    | `counter-strike`    | `/assets/icons/sports/counter-strike.svg`    |
| Dota 2            | `dota2`             | `/assets/icons/sports/dota2.svg`             |
| League of Legends | `league-of-legends` | `/assets/icons/sports/league-of-legends.svg` |
| Valorant          | `valorant`          | `/assets/icons/sports/valorant.svg`          |
| Rainbow Six       | `rainbow-six`       | `/assets/icons/sports/rainbow-six.svg`       |
| King of Glory     | `king-of-glory`     | `/assets/icons/sports/king-of-glory.svg`     |
| Call of Duty      | `call-of-duty`      | `/assets/icons/sports/call-of-duty.svg`      |
| Mobile Legends    | `mobile-legends`    | `/assets/icons/sports/mobile-legends.svg`    |

## Usage Tips

* All asset URLs work without authentication — use them directly in `<img>` tags
* SVG icons use `fill="currentColor"`, so you can style them with CSS `color` property
* For optimal performance, cache asset URLs client-side (they rarely change)
* Use the `sport.key` from `/v1/sports` or any event response to construct icon URLs dynamically
