# Get available templates

`GET https://api.cryptohopper.com/v1/market/templates`

Part of [Marketplace](https://www.cryptohopper.com/api-documentation/api-reference/marketplace.md) in the Cryptohopper API reference.

Returns the templates in the marketplace, sorted by number of sales.

The list is under the key template, with the number of items in result. Only published items in the marketplace store are returned.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `start` | string | no | Offset for paging. Default 0. |
| `exchange` | string | no | Only return items for this exchange, for example binance. Only letters, digits and underscores are accepted; any other value is ignored. |
| `limit` | string | no | Maximum number of items to return, 1 to 500. Default 500; 0 or a value above 500 also returns 500. |
| `available_in_app` | string | no | Meant to limit the list to items sold in the mobile app. In the current code a value sent here is compared to an integer and never matches, so it does not filter the list. |
| `quote_currency` | string | no | Only return items with this quote currency, for example USDT. Default all. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/market/templates" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "template": [
            {
                "exchange": "binance",
                "quote_currency": "USDT",
                "risk_level": "medium",
                "allowed_coins": [
                    "BTC",
                    "ETH"
                ],
                "id": "10512",
                "item_id": "10512",
                "type": "template",
                "name": "Binance Swing Trader",
                "description": "Swing trading template for major USDT pairs.",
                "logo": "https://cdn.cryptohopper.com/images/marketplace/10512.png",
                "feature_image": "https://cdn.cryptohopper.com/images/marketplace/10512_feature.png",
                "top_item": "0",
                "link": "https://www.cryptohopper.com/marketplace/item?item_id=10512",
                "rating": "4.50000",
                "total_votes": "12",
                "sales": "340",
                "price_id": "5",
                "price": "19.00",
                "created": "2025-11-02 14:21:09",
                "price_currency": "USD",
                "max_downloads": "0",
                "seller_id": "321",
                "seller_name": "Example Trading",
                "seller_logo": "https://cdn.cryptohopper.com/images/marketplace/sellers/321.png",
                "available_in_app": "1"
            }
        ],
        "result": 1
    }
}
```

Status codes: 200, 400. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.