# Get trade history for market maker hopper

`GET https://api.cryptohopper.com/v1/hopper/{id}/marketmaker/history/{start}/{limit}`

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

Returns the finished market maker orders (completed, cancelled or failed) of a market maker bot, newest first, one page at a time.

OAuth scope: `read`

Ordered by order date, newest first.

## Headers

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

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `limit` | string | yes | Maximum number of market makers to return, at most 500. |
| `start` | string | yes | Number of market makers to skip (offset), 0 for the first page. |
| `id` | string | yes | Hopper ID of a market maker bot. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/marketmaker/history/START/LIMIT" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "id": "7699990",
            "base_currency": "USDT",
            "currency": "BTC",
            "exchange": "binance",
            "market": "BTCUSDT",
            "market_trend": "neutral",
            "order_layer": "1",
            "order_sequence": "sametime",
            "buy_order_id": "55139001",
            "buy_trade_id": "88109001",
            "buy_order_type": "limit",
            "buy_amount": "0.001",
            "buy_amount_filled": "0.001",
            "buy_rate": "64800",
            "buy_cost": "64.8",
            "buy_fee": "0.0648",
            "sell_order_id": "55139002",
            "sell_trade_id": "88109002",
            "sell_order_type": "limit",
            "sell_amount": "0.001",
            "sell_amount_filled": "0.001",
            "sell_rate": "65000",
            "sell_cost": "65",
            "sell_fee": "0.065",
            "order_date": "2026-09-24 18:00:00",
            "order_date_step": "2026-09-24 18:00:00",
            "completed_date": "2026-09-24 18:20:00",
            "order_trigger": "manual",
            "profit": "0.07",
            "completed": "1",
            "cancelled": "0",
            "failed": "0"
        }
    ]
}
```

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