# Get top trades

GET /api/v1/market-data/leaderboard/top-trades

## Get top trades

> Returns the highest-PnL individual trades globally, ranked by realised profit. Useful for showcasing notable trades and the most profitable positions closed across all markets.

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/market-data/leaderboard/top-trades","name":"get-top-trades"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/market-data/leaderboard/top-trades":{"get":{"description":"Returns the highest-PnL individual trades globally, ranked by realised profit. Useful for showcasing notable trades and the most profitable positions closed across all markets.","tags":["get-top-trades"],"summary":"Get top trades","parameters":[{"schema":{"type":"string","default":"all","enum":["1d","7d","30d","all"]},"description":"Time period","name":"period","in":"query"},{"schema":{"type":"integer","default":10,"maximum":50,"minimum":1},"description":"Max results","name":"limit","in":"query"},{"schema":{"type":"integer","default":0},"description":"Pagination offset","name":"offset","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.PaginatedResponse-handler_TopTradeEntry"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}}}}}},"components":{"schemas":{"api.PaginatedResponse-handler_TopTradeEntry":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/handler.TopTradeEntry"}},"pagination":{"$ref":"#/components/schemas/api.Pagination"}}},"handler.TopTradeEntry":{"type":"object","properties":{"avgPrice":{"type":"number"},"deltaCollateral":{"type":"number"},"deltaQuantity":{"type":"number"},"eventType":{"type":"string"},"outcomeImage":{"type":"string"},"outcomeName":{"type":"string"},"pnl":{"type":"number"},"pnlPct":{"type":"number"},"questionImage":{"type":"string"},"questionTitle":{"type":"string"},"rank":{"type":"integer"},"resolvedAt":{"type":"integer"},"walletAddress":{"type":"string"}}},"api.Pagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"totalResults":{"type":"integer"}}},"api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```