Skip to main content
POST /wallet/get Returns metadata about a wallet owned by your account.

​
Request

{
  "api_key": "sk_live_...",
  "wallet_id": "w_c8b07c7d-9c7d-4a33-9200-0bdfa82dc497"
}
FieldTypeRequiredNotes
api_keystring✓Customer API key.
wallet_idstring✓Accepts wallet ID (w_<uuid>), on-chain address, or wallet name.
Use whichever identifier you have on hand; the API normalises them to the wallet ID internally.

​
Response

{
  "result": "ok",
  "wallet": {
    "id": "w_c8b07c7d-9c7d-4a33-9200-0bdfa82dc497",
    "created_at": 1711370574,
    "wallet_name": "first_wallet",
    "address": "0xf3e1...",
    "network": "eth",
    "testnet": false,
    "last_used": 1712609133,
    "metadata": {
      "customer_id": "cust_123"
    }
  }
}
  • last_used updates when a send completes.
  • result is always "ok" on success.
  • metadata echoes the custom JSON you set on creation or send (null when not provided).

​
Not found response

{
  "error": "Wallet not found"
}
Returned with HTTP 404 if the wallet does not exist or is not owned by your account. The response body mirrors other error payloads so you can reuse shared error-handling logic.

​
Errors

StatusPayloadWhen it happens
400{ "error": "Missing required fields" }api_key or wallet_id omitted.
403{ "error": "API key is not valid" }API key fails validation.
404{ "error": "Wallet not found" }The wallet ID/address does not belong to your account.
500{ "error": "<message>" }Unexpected service error.

​
Examples

from py_1151 import Client

client = Client(api_key="sk_live_...")

wallet = client.get_wallet("w_c8b07c7d-9c7d-4a33-9200-0bdfa82dc497")

if wallet.id is None:
    print("Wallet not found")
else:
    print(wallet.id, wallet.address, wallet.last_used)
Each snippet calls the same endpoint and handles the not-found case by checking whether an ID is present in the response.