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

# turnkey-sdk-types — Type definitions for Turnkey API

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

## What it is and what it does

Turnkey SDK Types is a code-generated package that exports Pydantic models for the Turnkey API based on an OpenAPI specification. It solves a specific Python problem: the Turnkey API includes request fields with names that are reserved Python keywords (like `from`). The package uses Pydantic's Field aliasing to let you write `from_` in your Python code while automatically serializing it as `from` when making API calls.

The package is primarily a dependency for Turnkey SDK clients rather than a standalone tool. It contains both auto-generated types (request/response models) and hand-maintained core types and error classes. The generation process reads from an OpenAPI spec and regenerates the type definitions; users should not manually edit generated files. With a single runtime dependency (pydantic) and pure-Python distribution, installation is straightforward.

Use it for:

- Building Turnkey API clients in Python without manually writing request/response type definitions.
- Avoiding syntax errors when working with API fields that use Python reserved keywords.
- Type-checking Turnkey API calls in an IDE or with mypy to catch errors before runtime.
- Ensuring request serialization matches the Turnkey API's expected field names automatically.
- Integrating Turnkey wallet operations into a larger Python application with strong typing.

## Worth the install?

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

Provides generated Pydantic type definitions for the Turnkey API, handling Python keyword conflicts through field aliasing so reserved words like `from` can be used in API requests.

Yes, if you are building a Turnkey API client or integrating Turnkey wallet operations into a Python application. The package solves a real problem (keyword field aliasing) and has low install friction. However, it is in alpha status and has had only one release; verify that it covers your API use case and that the OpenAPI spec is kept current before relying on it for production work.

## Install

pip install turnkey-sdk-types
uv add turnkey-sdk-types
poetry add turnkey-sdk-types

## Installing turnkey-sdk-types

Before you install: Low friction: single pure-Python wheel dependency on pydantic. Active maintenance with recent release; repository is not archived. Alpha status (Development Status :: 3) signals early-stage maturity.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install turnkey-sdk-types

from turnkey_sdk_types import v1EthSendTransactionIntent

# Use generated types with automatic field aliasing
request = v1EthSendTransactionIntent(from_="0x...")

Requires Python >= 3.8; pydantic must be installed as a runtime dependency.

Verify before relying:

- Whether the package is actively maintained beyond the single release on 2026-03-09, given the 158-day gap to current date.
- Whether generated types cover the full current Turnkey API surface or if the OpenAPI spec is regularly updated.
- Real-world adoption and stability signals beyond download counts, since this is an alpha package.

## 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 types, pydantic api models, openapi type generation, python keyword field aliasing, turnkey sdk types, api request type definitions, generated pydantic models, type-definitions, openapi-generated, blockchain-sdk

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