phemex-py 0.1.1

Typed, production-grade Python SDK for the Phemex crypto exchange API

phemex-py

Typed, production-grade Python SDK for the Phemex crypto exchange API.

• Sync and async clients (built on httpx)
• Fully typed request/response models (built on Pydantic)
• USD-M perpetual futures: orders, positions, market data, funding rates, and more

Installation

pip install phemex-py

Quick Start

Authentication

You need a Phemex API key and secret. Create one from your Phemex account settings.

Setting them as environment variables is a tried and true method:

PHEMEX_KIND=test
PHEMEX_KEY=
PHEMEX_SECRET=

The kind parameter controls which Phemex environment to connect to:

Kind	URL
vip	https://vapi.phemex.com
public	https://api.phemex.com
test	https://testnet-api.phemex.com

Sync Client

from phemex_py import PhemexClient

with PhemexClient(
        kind="public",
        api_key="your-api-key",
        api_secret="your-api-secret",
) as client:
    # Get server time
    server_time = client.server_time()

    # Get product info
    products = client.usdm_rest.product_information()

    # Get ticker
    ticker = client.usdm_rest.ticker(symbol="BTCUSDT")

    # Get open orders
    orders = client.usdm_rest.open_orders(symbol="BTCUSDT")

    # Get account positions
    positions = client.usdm_rest.positions()

Async Client

import asyncio
from phemex_py import AsyncPhemexClient


async def main():
    async with AsyncPhemexClient(
            kind="public",
            api_key="your-api-key",
            api_secret="your-api-secret",
    ) as client:
        ticker = await client.usdm_rest.ticker(symbol="BTCUSDT")
        positions = await client.usdm_rest.positions()


asyncio.run(main())

Testnet

Use kind="test" for paper trading:

client = PhemexClient(
    kind="test",
    api_key="your-testnet-key",
    api_secret="your-testnet-secret",
)

API Coverage

USD-M Perpetual REST API

Category	Endpoints
Market Data	product_information, order_book, klines, trades, ticker, tickers
Orders	place_order, amend_order, cancel_order, bulk_cancel, cancel_all
Positions	positions, positions_with_pnl, switch_position_mode, set_leverage, assign_position_balance
Account	risk_units
History	open_orders, closed_orders, closed_positions, user_trades, order_history, lookup_order, trade_history
Funding	funding_fee_history, funding_rates

Links

• Phemex API Documentation
• GitHub Repository
• PyPI Package

License

MIT