Developer Documentation
Comprehensive online calculator reference for students, professionals, and everyday users. Covers calculators across categories (financial, health, math, science, conversion, date/time), formula cards with step-by-step derivations, calculator comparisons, real-world scenarios, glossary, and in-depth guides. 15 languages supported.
- Calculators organized by category (financial, health, math, science, conversion, date/time)
- Formula cards with mathematical notation, derivations, and applications
- Calculator comparisons — when to use which calculator
- Real-world scenarios with worked examples using calculators
- Calculation glossary with mathematical and financial terminology
- In-depth guides organized by series
Quick Start
curl -s "https://calcfyi.com/api/v1/calculators/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/categories/ | Calculator categories |
| GET | /api/v1/categories/{slug}/ | Category detail |
| GET | /api/v1/calculators/ | All calculators |
| GET | /api/v1/calculators/{slug}/ | Calculator detail |
| GET | /api/v1/glossary/ | Glossary terms |
| GET | /api/v1/guides/ | Guide articles |
| GET | /api/v1/formulas/ | Formula cards |
| GET | /api/v1/comparisons/ | Calculator comparisons |
| GET | /api/v1/scenarios/ | Real-world scenarios |
| GET | /api/v1/faqs/ | FAQs |
| GET | /api/v1/stats/ | Site statistics |
URL Patterns
Use these patterns to construct URLs programmatically:
/category/
Browse calculator categories (e.g. /category/)
/category/{slug}/
Category detail with calculators (e.g. /category/financial/)
/calculator/{slug}/
Calculator tool (e.g. /calculator/compound-interest/)
/glossary/
Calculation glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/compound-interest/)
/guide/
In-depth guides (e.g. /guide/)
/guide/{series}/
Guide series (e.g. /guide/financial-literacy/)
/guide/{series}/{slug}/
Guide detail (e.g. /guide/financial-literacy/understanding-apr/)
/formula/
Formula cards (e.g. /formula/)
/formula/{slug}/
Formula card detail (e.g. /formula/pythagorean-theorem/)
/compare/
Calculator comparisons (e.g. /compare/)
/compare/{slug}/
Comparison detail (e.g. /compare/simple-vs-compound-interest/)
/scenario/
Real-world scenarios (e.g. /scenario/)
/scenario/{slug}/
Scenario detail (e.g. /scenario/mortgage-refinancing/)
/search/
Search calculators, formulas, glossary (e.g. /search/?q=mortgage)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
OpenAPI Specification
Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.
SDK Packages
PyPI
pip install calcfyi
Online calculators — financial, health and math API client
Embed Widget
Embed data cards on your site:
https://widget.calcfyi.com
npm install calcfyi-embed
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.