---
id: turnkey-http
version: "0.1.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# turnkey-http — HTTP client for Turnkey API

License: permissive · Maintenance: active · Downloads: 75.4K/mo

## What it is and what it does

Turnkey HTTP is a Python SDK client that wraps the Turnkey API with auto-generated, typed methods derived from an OpenAPI specification. It handles the mechanics of HTTP communication and request signing through integration with the turnkey-api-key-stamper dependency, so you initialize it once with your API credentials and organization ID, then call typed methods directly on the client object without manually constructing requests or managing signatures.

The package is designed for developers integrating Turnkey's services into Python applications. It requires Python 3.8 or later and depends on requests for HTTP transport, turnkey-api-key-stamper for cryptographic request signing, and turnkey-sdk-types for type definitions. The client code is generated from an OpenAPI schema and should not be edited manually; regeneration is done via a provided script when the schema updates.

Use it for:

- Initialize a Turnkey API client with credentials and make typed method calls like get_whoami() without manually constructing HTTP requests.
- Build a Python application that needs to interact with Turnkey's cryptographic or custody services with full type safety.
- Integrate Turnkey API calls into an existing Python backend where request signing and authentication are handled transparently.
- Develop against a Turnkey API that evolves; regenerate the client from an updated OpenAPI spec to stay in sync with new endpoints.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Turnkey HTTP is an HTTP client for the Turnkey API that provides auto-generated typed methods from an OpenAPI specification, with built-in request signing via API key stamping.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is licensed permissively. It is a straightforward choice if you need to call the Turnkey API from Python and want typed, auto-generated methods with built-in request signing. The only caveat is that it is tightly coupled to Turnkey's API, so it is only useful if you are already using Turnkey services.

## Install

pip install turnkey-http
uv add turnkey-http
poetry add turnkey-http

## Installing turnkey-http

Before you install: Low install friction; the package is a pure Python wheel with three runtime dependencies (requests, turnkey-api-key-stamper, turnkey-sdk-types). Maintenance status is active with a recent commit history.

License in practice: Licensed under Apache-2.0 (permissive), so you can use, modify, and distribute the package freely in both open-source and proprietary projects without significant restrictions.

Quickstart:

pip install turnkey-http

from turnkey_http import TurnkeyClient
from turnkey_api_key_stamper import ApiKeyStamper, ApiKeyStamperConfig

config = ApiKeyStamperConfig(
    api_public_key="your-api-public-key",
    api_private_key="your-api-private-key"
)
stamper = ApiKeyStamper(config)
client = TurnkeyClient(
    base_url="https://api.turnkey.com",
    stamper=stamper,
    organization_id="your-org-id"
)
response = client.get_whoami()
print(response)

You must have valid Turnkey API credentials (public and private keys) and an organization ID to initialize the client.

Verify before relying:

- Whether the auto-generated client methods cover all current Turnkey API endpoints or if manual additions are sometimes needed.
- Performance characteristics and rate-limiting behavior when making concurrent requests through the client.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 75.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

turnkey api client, http client with request signing, openapi generated sdk, api key stamper integration, typed api methods, turnkey sdk http, api-client, request-signing, openapi-generated

[View on SkillFed](https://skillfed.io/packages/turnkey-http) · [View on PyPI](https://pypi.org/project/turnkey-http/)