# Currency exchange card

> Canonical HTML: https://screenrig.ai/docs/cards/currency/

Exchange rates against a base currency, with the day's change. The host supplies the rates.

Category: Finance. Tags: Prices and rates, Lobbies and reception.

## Previews

![Currency exchange](/cards/currency/v1/screenshots/canvas-bloom.webp?sha=a42c4c0fc7c2485c9c95cf57ee317ca33b99ff391aac3044e26fa03dc4096518)

Canvas

![Currency exchange](/cards/currency/v1/screenshots/corner-bloom.webp?sha=2ebf34cb9a168a630de8a578dd64a9fa57e36767b9a541c27e05aa73f05c3b7c)

Corner

![Currency exchange](/cards/currency/v1/screenshots/chip-bloom.webp?sha=ed87cbede441c19e36031f62dc5299895956a34e7002f260fe11e5e383f266cd)

Chip

## Views and forms

Views: canvas, corner, chip. Canvas forms: landscape, portrait, strip.

[Card views, themes and publishing](/docs/cards/). [Browse the gallery](/apps/#cards).

## Data and privacy

Feed: `screenrig.rates/v1`.

Feed documents carry source attribution. The Player supplies the feed to the card.

## Properties

For theme, background, accent and position, see [Common properties](/docs/cards/#common-properties).

Set static properties in `params`. Bind `data` to a project card data key for live values; that document holds only dynamic properties. Without a data key, put the complete configuration in `params`. Nested rows describe the contents of their parent property.

### Static properties

| Name | Type | Default | Values and limits | Description |
| --- | --- | --- | --- | --- |
| `title` | string | `""` | maxLength: `40` | Shown above the board; empty shows none. |
| `amount` | number | `1` | minimum: `0.01`; maximum: `1000000` | How much of the base currency each rate converts. |
| `codes` | array | `[]` | maxItems: `12` | Currencies to show, in this order; empty shows the feed's order. |
| `layout` | string | `"auto"` | `"auto"`, `"grid"`, `"list"` |  |
| `hour12` | boolean | `false` |  |  |
| `timeZone` | string, null | `null` |  |  |
| `base` | string | `"EUR"` | pattern: `"^[A-Z]{3}$"` | Currency the rates are quoted against: EUR or an ECB reference currency. Selects the feed. |

### Dynamic properties

This card has no dynamic properties.

## Canvas example

Add this item to a playlist page’s `primitives`. [Publish the playlist and assign a screen](/docs/cards/#publish-a-card-canvas).

```json
{
  "id": "currency",
  "primitive": "card",
  "card": "currency",
  "major": 1,
  "params": {
    "theme": "neomustard"
  },
  "rect": {
    "x": 0,
    "y": 0,
    "width": 1920,
    "height": 1080
  },
  "layer": 0,
  "content_fit": "fill"
}
```