# Get Available Coins

`GET`

### Overview

Returns the list of all supported coins and assets on the platform.

### Authentication

No authentication required.

### Request

* Method: `GET`
* Path: `/api/coins`
* Query parameters: None

### Response `200 OK`

```json
[
  {
    "i": "078dcd98-928d-479f-8110-ff6d27e44de2",
    "n": "USD Coin",
    "sn": "USDC",
    "ur": 1.0,
    "urd": "2026-01-15T10:30:00.000Z",
    "dpf": 6,
    "dps": 3,
    "ac": "ACTIVE",
    "iu": "https://example.com/usdc.png",
    "sc": false,
    "pmc": true
  }
]
```

| Field | Type    | Description                               |
| ----- | ------- | ----------------------------------------- |
| i     | string  | Coin ID                                   |
| n     | string  | Full coin name                            |
| sn    | string  | Short name or ticker                      |
| ur    | number  | USD exchange rate                         |
| urd   | string  | Rate update time in ISO 8601 format       |
| dpf   | integer | Decimal places for full precision         |
| dps   | integer | Decimal places for short display          |
| ac    | string  | Coin status                               |
| iu    | string  | Icon URL                                  |
| sc    | boolean | System coin flag                          |
| pmc   | boolean | Available as prediction market collateral |

### Error variants

Common public endpoint errors:

| Code | Description                         |
| ---- | ----------------------------------- |
| 400  | Bad Request — Invalid parameters    |
| 404  | Not Found — Resource does not exist |
| 500  | Internal Server Error               |

**Error response**

```json
{
  "status": 400,
  "error": "Bad Request",
  "message": "Invalid parameters"
}
```

### Python example

Install the dependency first.

```bash
pip install requests
```

Send the request and iterate over the result.

{% code title="get\_coins.py" %}

```python
import requests

BASE_URL = "https://wallet-mutator-view.outpoll.com"

response = requests.get(
    f"{BASE_URL}/api/coins",
    timeout=10,
)
response.raise_for_status()

coins = response.json()

for coin in coins:
    print(f"{coin['sn']:<6} {coin['n']:<20} rate={coin['ur']}")
```

{% endcode %}

Example output:

```
USDC   USD Coin             rate=1.0
```

{% hint style="info" %}
Use `response.raise_for_status()` to fail fast on HTTP errors.
{% endhint %}