fmp-py-client

A fully asynchronous Python client for the Financial Modeling Prep API. Access 180+ financial data endpoints with a modern, type-safe interface.

Features

• Async/await support - Built on httpx for high-performance concurrent requests
• Fully typed - Complete type hints for IDE autocomplete and static analysis
• 180+ endpoints - Stocks, financials, ETFs, crypto, forex, economics, and more
• Clean API - Intuitive method names that mirror the FMP API structure
• Robust error handling - Custom exceptions with detailed error information

Installation

pip install fmp-py-client

Or with uv:

uv add fmp-py-client

Quick Start

import asyncio
from fmp_py_client import AsyncFMPClient

async def main():
    async with AsyncFMPClient("your-api-key") as client:
        # Get a stock quote
        quote = await client.quote("AAPL")
        print(f"Apple: ${quote[0]['price']}")

        # Get company profile
        profile = await client.profile("AAPL")
        print(f"Market Cap: ${profile[0]['mktCap']:,}")

        # Search for companies
        results = await client.search_name("Tesla", limit=5)
        for company in results:
            print(f"{company['symbol']}: {company['name']}")

asyncio.run(main())

API Coverage

Error Handling

from fmp_py_client import (
    AsyncFMPClient,
    FMPAuthenticationError,
    FMPRateLimitError,
    FMPNotFoundError,
)

async with AsyncFMPClient("your-api-key") as client:
    try:
        quote = await client.quote("AAPL")
    except FMPAuthenticationError:
        print("Invalid API key")
    except FMPRateLimitError as e:
        print(f"Rate limited. Retry after {e.retry_after}s")
    except FMPNotFoundError:
        print("Symbol not found")

Documentation

Full documentation is available at cbian.github.io/fmp-py-client.

• Getting Started
• API Reference
• Examples

Requirements

• Python 3.12+
• An API key from Financial Modeling Prep (free tier available)

License

MIT