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

# Public API

These endpoints can be used by applications, dashboards, integrations, analytics platforms, and other third-party services to retrieve product prices and performance metrics without requiring authentication.

### Base URL

`https://public-api.piku.co/v1`

All endpoints are publicly accessible and return data in JSON format.

### Available Endpoints

| USP                      | `/tokens/usp`                      |
| ------------------------ | ---------------------------------- |
| FXArbUSDTRY              | `/tokens/fxarbusdtry`              |
| StockMarketTRBasisTrade  | `/tokens/stockmarkettrbasistrade`  |
| CarryTradeUSDTRYLeverage | `/tokens/carrytradeusdtryleverage` |

Each token endpoint returns the following core metrics:

* **symbol** — Product or token identifier
* **price** — Current product/token price
* **apy7d** — Annualized performance based on the last 7 days
* **apy30d** — Annualized performance based on the last 30 days
* **apyAllTime** — Annualized performance calculated over the available lifetime of the product

Some products may return additional product-specific fields.

> **Important:** APY values are historical performance metrics and should not be interpreted as guaranteed or expected future returns. Performance may vary over time.

**Example Response**

```
{
  "symbol": "USP",
  "price": "1.121552",
  "apy7d": "12.07",
  "apy30d": "11.06",
  "apyAllTime": "13.66",
  "redemptionFeeBps": "20"
}
```

List of endpoints:

\
[https://public-api.piku.co/v1/tokens/fxarbusdtry ](https://public-api.piku.co/v1/tokens/fxarbusdtry)

<https://public-api.piku.co/v1/tokens/stockmarkettrbasistrade>

[https://public-api.piku.co/v1/tokens/carrytradeusdtryleverage ](https://public-api.piku.co/v1/tokens/carrytradeusdtryleverage)

<https://public-api.piku.co/v1/tokens/usp>
