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

# API

For contract interaction: 

**Tokens**

* URL:[ ](https://api.metavault.trade/tokens)<https://api.kperp.exchange/tokens>
* Retrieve a list of tokens and info for each token
* USD amounts are multiplied by (10 \*\* 30)
* Token amounts are multiplied by (10 \*\* token.decimals)

**Actions**

* URL: <https://api.kperp.exchange/actions>
* Retrieve a list of actions, these will include swaps, increasing a position, decreasing a position and liquidations
* Params:
  * account (optional): pass in the checksum address of an account
  * after (optional): for pagination, the id to start after
* To get the checksum address: <https://web3-tools.netlify.app/>, you can also use a library like [ethers](https://docs.ethers.io/v5/)

**Volume**

* Hourly:[ ](https://api.metavault.trade/hourly_volume)<https://api.kperp.exchange/hourly_volume>
* Daily: <https://api.kperp.exchange/daily_volume>
* Weekly:[ ](https://api.metavault.trade/weekly_volume)<https://api.kperp.exchange/weekly_volume>
* Total: <https://api.kperp.exchange/total_volume>
* Volumes are separated by action, token, day / week
* Params:
  * after (optional): for pagination, the id to start after

#### Supply

* Circulating supply: <https://api.kperp.exchange/circulating-supply>
* Total supply: <https://api.kperp.exchange/total-supply>