# Carteras Colectivas Developer Portal

> Colombian mutual fund data API for apps and AI agents

## Docs

- [Fund vs benchmark comparison](https://docs.carterascolectivas.co/api-reference/benchmarks/fund-vs-benchmark-comparison.md): Win rate, average excess return, tracking error, and information ratio vs category benchmark.
- [List all fund categories](https://docs.carterascolectivas.co/api-reference/categories/list-all-fund-categories.md): Returns all 13 fund categories with fund counts and total AUM. Call this first to understand available fund types.
- [Fee analysis and impact projection](https://docs.carterascolectivas.co/api-reference/fees/fee-analysis-and-impact-projection.md): Expense ratio, management fees, category comparison, and projected fee impact on returns over time.
- [Compare multiple funds side by side](https://docs.carterascolectivas.co/api-reference/funds/compare-multiple-funds-side-by-side.md): Compare 2-10 funds on returns, volatility, and Sharpe ratio.
- [Filter and browse funds](https://docs.carterascolectivas.co/api-reference/funds/filter-and-browse-funds.md): Filter funds by category, AUM range, and sort criteria.
- [Get fund summary](https://docs.carterascolectivas.co/api-reference/funds/get-fund-summary.md): Returns a 5-year performance summary for a specific fund.
- [List funds in a segment](https://docs.carterascolectivas.co/api-reference/funds/list-funds-in-a-segment.md): All funds available to a specific investor segment.
- [Search funds by name](https://docs.carterascolectivas.co/api-reference/funds/search-funds-by-name.md): Search for funds by name. If results span multiple investor segments, ask the user which segment they belong to before proceeding.
- [Compare performance across segments](https://docs.carterascolectivas.co/api-reference/performance/compare-performance-across-segments.md): Average returns, volatility, and Sharpe ratios by investor segment.
- [Historical performance analysis](https://docs.carterascolectivas.co/api-reference/performance/historical-performance-analysis.md): Annual returns, average return, volatility, Sharpe ratio, max drawdown, best/worst years, and benchmark comparison.
- [Performance attribution](https://docs.carterascolectivas.co/api-reference/performance/performance-attribution.md): Fund return vs benchmark return decomposition and excess return analysis.
- [Portfolio composition](https://docs.carterascolectivas.co/api-reference/portfolios/portfolio-composition.md): Breakdown by asset class, sector, credit rating, and issuer country with percentages.
- [Percentile ranking within category](https://docs.carterascolectivas.co/api-reference/rankings/percentile-ranking-within-category.md): Where this fund ranks vs all peers in its category. Higher percentile = better.
- [Match investor to recommended funds](https://docs.carterascolectivas.co/api-reference/recommendations/match-investor-to-recommended-funds.md): Given an investor segment and risk profile, returns recommended funds ranked by match score.
- [Correlation analysis vs benchmark](https://docs.carterascolectivas.co/api-reference/risk/correlation-analysis-vs-benchmark.md): Correlation, R-squared vs benchmark. Also returns most correlated peer funds.
- [Risk metrics](https://docs.carterascolectivas.co/api-reference/risk/risk-metrics.md): Volatility, Sharpe ratio, Martin ratio, and maximum drawdown with plain-language interpretations.
- [Category distribution within segment](https://docs.carterascolectivas.co/api-reference/segments/category-distribution-within-segment.md): How funds and AUM are distributed across categories within a segment.
- [Get segment details](https://docs.carterascolectivas.co/api-reference/segments/get-segment-details.md): Detailed statistics for a specific investor segment.
- [Market segmentation overview](https://docs.carterascolectivas.co/api-reference/segments/market-segmentation-overview.md): Statistics for each investor segment: fund counts, AUM, investor counts, and market shares. Segments: pn (retail), pj (corporate), institucional (pension/insurance), especiales (government/special).
- [Authentication](https://docs.carterascolectivas.co/authentication.md): API key auth via the x-api-key header
- [Changelog](https://docs.carterascolectivas.co/changelog.md): Recent updates to the Carteras Colectivas API platform
- [Data API](https://docs.carterascolectivas.co/data-api/coming-soon.md): REST API for direct database access — coming soon
- [Introduction](https://docs.carterascolectivas.co/introduction.md): Colombian mutual fund data for apps and AI agents
- [Quickstart](https://docs.carterascolectivas.co/quickstart.md): Make your first API call in under five minutes

## OpenAPI Specs

- [openapi](https://docs.carterascolectivas.co/api-reference/openapi.yaml)