> For the complete documentation index, see [llms.txt](https://docs.radfi.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.radfi.co/dev/api-endpoints/histories.md).

# Histories

## Get histories by address

> Returns paginated history items.\
> \
> \- Each swap has: token0Id, token1Id, token0Amount, token1Amount, feeTier, fee, volumeInSats etc.\
> \- tokenIn/tokenOut = the pair token0/token1 and amounts (direction comes from which side is in/out).\
> \- fee is the pool fee (e.g. fee 10000 = 1% tier).\
> \- If tokens\_eq is true, return tokens with history items.

```json
{"openapi":"3.0.0","info":{"title":"Radfi API","version":"1.0"},"servers":[{"url":"https://api.radfi.co","description":"Production"}],"paths":{"/api/histories":{"get":{"operationId":"HistoryController_paginate","summary":"Get histories by address","description":"Returns paginated history items.\n\n- Each swap has: token0Id, token1Id, token0Amount, token1Amount, feeTier, fee, volumeInSats etc.\n- tokenIn/tokenOut = the pair token0/token1 and amounts (direction comes from which side is in/out).\n- fee is the pool fee (e.g. fee 10000 = 1% tier).\n- If tokens_eq is true, return tokens with history items.","parameters":[{"name":"page","required":false,"in":"query","description":"Page number (default: 1)","schema":{"type":"number"}},{"name":"pageSize","required":false,"in":"query","description":"Number of items per page (default: 10)","schema":{"type":"number"}},{"name":"sort","required":false,"in":"query","description":"Sort field and order. Use - prefix for descending. Example: -createdAt, createdAt","schema":{"type":"string"}},{"name":"select","required":false,"in":"query","description":"Fields to select (comma separated). Use + prefix to include hidden fields. Example: name,status,+holders","schema":{"type":"string"}},{"name":"populate","required":false,"in":"query","description":"Relations to populate (comma separated). Example: wallet,token","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["histories"]}}}}
```