# Criffy Public API

> Public REST data APIs for Criffy Pro+ integrations.

## Docs

- [Get Your API Key](https://docs.criffy.com/account/rest-api-keys.md): How to generate and manage your public API key from the Criffy dashboard.
- [Get borrow offer APY history](https://docs.criffy.com/api-reference/borrow/get-borrow-offer-apy-history.md)
- [Get borrow offer by ID](https://docs.criffy.com/api-reference/borrow/get-borrow-offer-by-id.md)
- [List borrow offers](https://docs.criffy.com/api-reference/borrow/list-borrow-offers.md): Returns published borrow offers with filtering, sorting, and pagination. Inactive offers can be returned with `is_active: false`.
- [Get collateral offer by ID](https://docs.criffy.com/api-reference/collateral/get-collateral-offer-by-id.md)
- [Get collateral offer history](https://docs.criffy.com/api-reference/collateral/get-collateral-offer-history.md): This endpoint is part of the public contract but currently always returns `404 not_found` because collateral history is not stored.
- [List collateral offers](https://docs.criffy.com/api-reference/collateral/list-collateral-offers.md): Returns published collateral offers with filtering, sorting, and pagination. Inactive offers can be returned with `is_active: false`. `min_apy` is not supported for this resource family.
- [Get currency by slug](https://docs.criffy.com/api-reference/currencies/get-currency-by-slug.md): Returns the currency plus related `earn_offers`, `borrow_offers`, and `collateral_offers`. If the slug was renamed, the API can respond with `301 Moved Permanently` and redirect to the current slug.
- [List currencies](https://docs.criffy.com/api-reference/currencies/list-currencies.md): Returns published, non-delisted currencies ordered by market-cap rank.
- [Get earn offer APY history](https://docs.criffy.com/api-reference/earn/get-earn-offer-apy-history.md)
- [Get earn offer by ID](https://docs.criffy.com/api-reference/earn/get-earn-offer-by-id.md)
- [List earn offers](https://docs.criffy.com/api-reference/earn/list-earn-offers.md): Returns published earn offers with filtering, sorting, and pagination. Unavailable offers can be returned with `available: false`.
- [Get exchange by slug](https://docs.criffy.com/api-reference/exchanges/get-exchange-by-slug.md): Returns the current exchange resource. If the slug was renamed, the API can respond with `301 Moved Permanently` and redirect to the current slug.
- [List exchanges](https://docs.criffy.com/api-reference/exchanges/list-exchanges.md): Returns published, non-delisted exchanges ordered by weekly visits.
- [API Reference Overview](https://docs.criffy.com/api-reference/overview.md): How the Criffy REST reference is organized and what to expect from generated endpoint pages.
- [Get protocol by slug](https://docs.criffy.com/api-reference/protocols/get-protocol-by-slug.md): Returns the current protocol or a permanent redirect if the slug was renamed.
- [List protocols](https://docs.criffy.com/api-reference/protocols/list-protocols.md): Returns published, non-delisted protocols ordered by TVL.
- [Get wallet by slug](https://docs.criffy.com/api-reference/wallets/get-wallet-by-slug.md): Returns the current wallet or a permanent redirect if the slug was renamed.
- [List wallets](https://docs.criffy.com/api-reference/wallets/list-wallets.md): Returns published, non-delisted wallets ordered alphabetically.
- [Authentication](https://docs.criffy.com/getting-started/authentication.md): How Bearer API keys work in the Criffy public API.
- [Errors and Limits](https://docs.criffy.com/getting-started/errors-and-limits.md): Shared error envelope, retry headers, and usage-limit headers returned by the Criffy API.
- [Overview](https://docs.criffy.com/getting-started/overview.md): What the Criffy public API includes, how access works, and where to start.
- [Querying Data](https://docs.criffy.com/getting-started/querying.md): Pagination, filtering, sorting, and history window rules for the Criffy public API.

## OpenAPI Specs

- [public-api](https://docs.criffy.com/public-api.yaml)