Documentation Index
Fetch the complete documentation index at: https://home.1151.to/llms.txt
Use this file to discover all available pages before exploring further.
POST /wallet/create
Create a wallet and receive its identifier and address.
Request
{
"api_key": "sk_live_...",
"wallet_name": "first_wallet",
"network": "eth",
"testnet": false,
"metadata": {
"customer_id": "cust_123",
"environment": "staging"
}
}
| Field | Type | Required | Notes |
|---|
api_key | string | ✓ | Customer API key. |
wallet_name | string | ✓ | Wallet label reused when fetching or deleting by name. |
network | string | ✓ | Supported values: btc, eth, tron (case-insensitive). |
testnet | boolean | ✕ | Defaults to false. Set to true for Sepolia, Nile, or Bitcoin testnet wallets. |
metadata | object | ✕ | Optional JSON object stored alongside the wallet. Keys must be strings and the payload must be JSON serializable. |
Response
{
"id": "w_c8b07c7d-9c7d-4a33-9200-0bdfa82dc497",
"wallet_name": "first_wallet",
"address": "0xf3e1...",
"created_at": 1711370574,
"network": "eth",
"testnet": false,
"included_in_plan": true,
"metadata": {
"customer_id": "cust_123",
"environment": "staging"
}
}
| Field | Description |
|---|
id | Wallet identifier (w_<uuid>). |
address | Blockchain address for deposits. |
included_in_plan | true if the wallet is counted against the plan quota. |
created_at | Unix timestamp when the wallet was provisioned. |
metadata | Custom JSON blob you supplied on creation (null when omitted). |
Errors
| Status | Payload | When it happens |
|---|
400 | { "error": "Missing required fields" } | Missing wallet_name, network, or malformed JSON. |
403 | { "error": "API key is not valid" } | API key fails validation. |
403 | { "error": "Standard plan allows max 5 wallets" } | standard plan exceeded. |
400 | { "error": "Unsupported network: <value>" } | Unsupported network string. |
500 | { "error": "<message>" } | Unexpected service error. |
Examples
from py_1151 import Client
client = Client(api_key="sk_live_...")
wallet = client.create_wallet(
name="first_wallet",
network="eth",
testnet=True,
metadata={"customer_id": "cust_123"},
)
print(wallet.id, wallet.address)
