API Reference
POST /wallet/genesis
Create (or return) a TEE-secured agent wallet and API key
Endpoint
POST https://api.usezenithpay.xyz/wallet/genesisAuth
Bearer API key required.
Request body
{
"email": "agent@domain.com",
"label": "research-agent-01"
}email and label are optional but recommended for operations traceability.
Response shape (201)
{
"agentAddress": "0x...",
"apiKey": "zpk_...",
"label": "research-agent-01",
"createdAt": "2026-01-01T00:00:00Z",
"message": "Wallet created. Activate at https://usezenithpay.xyz/onboarding?agent=0x..."
}Error shape
{
"error": "conflict",
"message": "Agent already registered ...",
"status": 409
}