⚡ Async Python client for the Firi cryptocurrency exchange API.

pip install firipy

Requires Python 3.13+.

All methods are async and must be awaited:

import asyncio
from firipy import FiriAPI

async def main():
    async with FiriAPI("your-api-key") as client:
        time = await client.time()
        print(time)

        markets = await client.markets()
        print(markets)

        balances = await client.balances()
        print(balances)

asyncio.run(main())

Built-in client-side pacing (seconds to sleep before each request). Default is 1 second:

client = FiriAPI("your-api-key", rate_limit=2)    # 2 second delay
client = FiriAPI("your-api-key", rate_limit=0)    # no delay

Uses asyncio.sleep so it won't block the event loop.

Structured exceptions are raised by default:

Suppress exceptions with raise_on_error=False:

async with FiriAPI("your-api-key", raise_on_error=False) as client:
    data = await client.markets()
    if isinstance(data, dict) and "error" in data:
        print("Failed:", data)

Error dict shape: {"error": str, "status": int | None}.

Default count is 500 (DEFAULT_COUNT). A warning is emitted above MAX_COUNT (10,000).

Instead of btc_address(), eth_address(), etc. you can use:

await client.coin_address("BTC")
await client.coin_withdraw_pending("ETH")

Per-asset convenience methods remain available.

• Checked against developers.firi.com (Trading API 1.0.0) on 2025-11-21.
• When Firi updates their spec, diff it against the endpoint table above.
• Use the rate-limit guardrails (DEFAULT_COUNT, MAX_COUNT) to stay within API constraints.

Contributions welcome! Submit a pull request or create an issue on the GitHub page.

git clone https://github.com/jeircul/firipy
cd firipy
uv sync
uv run pytest -q

Linting and type checking:

uv run ruff check .
uv run ruff format --check .
uv run ty check

If you have go-task installed:

task install        # uv sync
task lint           # ruff check
task format         # ruff format
task typecheck      # ty check
task test           # pytest
task qa             # lint + typecheck + test
task balance        # print live balances (API_KEY_FIRI required)
task live-test      # read-only smoke against production (LIVE_FIRI_TESTS=1)
task build          # uv build (sdist + wheel)
task release-check  # qa + build
# Version bump helpers (patch by default)
task version PART=minor
task version NEW=1.1.0
task version DRY_RUN=1

1. Document all changes under the [Unreleased] section in CHANGELOG.md.
2. Run task version PART=major|minor|patch (or NEW=x.y.z). This updates pyproject.toml and moves changelog entries into a dated section. Preview first with DRY_RUN=1.
3. Run task release-check to verify lint, type-check, tests, and build all pass.
4. Commit the version bump, push to a feature branch, open a PR into main, and merge once CI is green.
5. Tag vX.Y.Z on main (or draft a GitHub Release). Publishing the release triggers publish.yml which uploads to PyPI.
6. Optionally run LIVE_FIRI_TESTS=1 task live-test before tagging to smoke-test against production.
7. Quick manual check: task balance prints balances from /v2/balances.

v1.0.0 is async-only and uses httpx instead of requests. See the CHANGELOG for a full migration guide.

This client was developed by Ove Aursland and is not officially associated with Firi.