# Markets, events & trades.

> Source: https://implyra.com/docs/markets
> Implyra API docs · API reference · Markets & trades

Go from discovery to market-level trading activity, lifecycle lists, and analytics.

Transport: GET

## Recent market trades

`GET /markets/:slug/trades`

Use the slug returned by discovery to retrieve recent trades with trader classification enrichment and available profile data. This endpoint uses limit and offset query parameters.

| Name | Type | Description |
| --- | --- | --- |
| `slug` | path · string | A market slug returned by market discovery. URL-encode it when constructing the path. |
| `limit` | query · number | The number of trades to return (maximum 100). |
| `offset` | query · number | The number of trades to skip for offset pagination. |

```sh
curl --fail-with-body \
  "$IMPLYRA_API_URL/markets/example-market/trades?limit=20&offset=0"
```

## Market analytics

`GET /markets/:slug/analytics`

Retrieve aggregate analytics for a market, including available holder counts, PnL breakdown, and trader-type distribution. Some analytics fields are nullable; render missing values as unavailable.

## Lifecycle lists

| Name | Type | Description |
| --- | --- | --- |
| `GET /markets/recently-started` | limit: 1–50 | Active markets ordered by creation date, newest first. Default limit: 10. |
| `GET /markets/ending-soon` | limit: 1–50 | Active markets ordered by end date, soonest first. Default limit: 10. |

## Additional market endpoints

| Name | Type | Description |
| --- | --- | --- |
| `GET /markets/:slug/holders` | Holders | Paginated positions, participant classification, and optional profile enrichment. |
| `GET /markets/:slug/volume-profile` | Volume | Hourly volume buckets across the market’s trading history. |
| `GET /markets/:slug/entry-timing` | Activity | Volume over time and cumulative trading totals. |
| `GET /markets/:slug/top-traders` | Leaderboard | A market-specific leaderboard ranked by trading volume, with buy/sell direction. |