# ChainFolioAI API

**Canonical:** https://apis.io/apis/chainfolioai-com/chainfolioai-com-api/  
**Provider:** ChainFolioAI — https://apis.io/providers/chainfolioai-com/  
**Documentation:** https://chainfolioai.com/developers

ChainFolioAI API is one of 2 APIs that [ChainFolioAI](https://apis.io/providers/chainfolioai-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

ChainFolioAI API as documented publicly: 25 operations. Contract generated from the documentation by API Evangelist (2026-11-03); not the provider's own document.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1` | Índice de descoberta — lista os endpoints. |
| GET | `/api/v1/btc-blocks` | Blocos Bitcoin recentes (altura, nº de transações, taxa mediana, pool, timestamp) e taxas recomendadas da mempool. |
| POST | `/api/v1/chat` | POST /api/v1/chat |
| GET | `/api/v1/defi` | Posições de lending lidas dos contratos: depositado, emprestado e líquido. |
| GET | `/api/v1/derivatives` | Derivados de um símbolo: open interest, long/short, funding, CVD, taker, put/call e score. |
| GET | `/api/v1/fear-greed` | Índice Fear & Greed — valor atual (0–100) e últimos 8 dias. |
| GET | `/api/v1/fire` | Anos até à independência financeira (regra dos 4%). |
| GET | `/api/v1/global` | Capitalização total do mercado, variação 24 h e dominância BTC/ETH. |
| GET | `/api/v1/global/api/v1/global` | GET /api/v1/global/api/v1/global |
| GET | `/api/v1/known-whales` | Baleias conhecidas pré-carregadas (exchanges, fundos, figuras públicas, governos). |
| GET | `/api/v1/market` | Top criptoativos por capitalização. |
| GET | `/api/v1/metrics` | Métricas do portefólio a partir do histórico: ROI, CAGR, Sharpe, volatilidade, quedas e VaR 95%. |
| GET | `/api/v1/news` | Últimas notícias de cripto (CoinDesk, CoinTelegraph). |
| GET | `/api/v1/nfts` | NFTs das carteiras EVM numa rede. |
| GET | `/api/v1/pnl` | Evolução do portefólio em euros: total atual e variação a 24 h, 7 d, 30 d e desde o início. |
| GET | `/api/v1/portfolio` | Último snapshot do portefólio: saldos por rede, CEX, DeFi e ativos manuais (endereços pseudonimizados). |
| GET | `/api/v1/price` | Preço, capitalização, volume e variação (24h/7d) de um criptoativo pelo símbolo. |
| GET | `/api/v1/price-on` | Preço de fecho de um ativo numa data (UTC). |
| GET | `/api/v1/realized-gains` | Mais-valias realizadas (FIFO) em euros, com taxas e gás deduzidos: total, por ativo e por ano. |
| GET | `/api/v1/score` | Pontuação 0–100 do portefólio, tal como aparece na app. |
| GET | `/api/v1/tax-countries` | Regimes fiscais publicados por país (taxas, prazo, isenção e lei). |
| GET | `/api/v1/tax-estimate` | Estimativa de imposto sobre mais-valias num país, na moeda desse país, com o método de custo do país e, onde a lei deixa, as perdas de anos anteriores. |
| GET | `/api/v1/trades` | Transações registadas (compras, vendas e taxas), da mais recente para a mais antiga. |
| GET | `/api/v1/wallets` | Carteiras e endereços ligados à conta (pseudonimizados). |
| GET | `/api/v1/whales` | Movimentos on-chain recentes dos endereços dados. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/chainfolioai-com/openapi/_ae-authored/chainfolioai-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/chainfolioai-com/json-schema/chainfolioai-com-get-api-v1-tax-estimate-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/chainfolioai-com/json-schema/chainfolioai-com-get-api-v1-defi-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/chainfolioai-com/json-schema/chainfolioai-com-get-api-v1-realized-gains-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/chainfolioai-com/json-schema/chainfolioai-com-get-api-v1-price-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/chainfolioai-com/json-schema/chainfolioai-com-get-api-v1-fire-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/chainfolioai-com/json-schema/chainfolioai-com-get-api-v1-global-response-schema.json

## Other ChainFolioAI APIs (1)

- [ChainFolioAI API](https://apis.io/apis/chainfolioai-com/chainfolioai-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/chainfolioai-com/chainfolioai-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/chainfolioai-com/.