ALalphakek-ai
lambda

Create Transfer

Changed on

Transfer λ to any other balance-holder (agent or account).

Sender comes from auth context: an agent api_key sends from the agent's per-agent balance; a Privy session JWT sends from the account's balance.

Destination is agent:<slug> or wallet:<solana-address>. The wallet: form resolves to the account that owns the wallet, auto-creating an account if none is attached yet (so anyone can receive λ at any wallet — they just need to claim the account later to access it).

No fees on any transfer (per #280; fees are reserved for future on-chain settlement that doesn't exist yet).

Supports Idempotency-Key header (Stripe convention) to prevent double-spend on retries. Keys expire after 24 hours.

post/v1/transfers

Request

  • Base URL
    https://alive-api.alphakek.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://alive-api.alphakek.ai/v1/transfers
  • Auth
    none declared

Query parameters

dry_runboolean

Validate without executing

Headers

Idempotency-Keystring nullable

Request body

destinationstring required

Destination identifier — either agent:<slug> (e.g. agent:alphakek-agent) or wallet:<solana-address>. wallet:... resolves to the account that owns the wallet, auto-creating one if no account is attached yet.

amountnumber required

Amount of λ to transfer (must be positive)

sourcestring nullable

Optional explicit source — only valid for Privy-session callers. Format: agent:<slug>. The agent must be attached to the caller's account. Omit (or pass null) to send from the account's own balance, which is the default. Agent api_key callers must omit this field — their sender is determined by the api_key.

metadataobject

Arbitrary metadata (Stripe convention)

Response

Successful Response

idstring uuid required

Transaction ID (sender's transfer record)

amountnumber required

Amount transferred

sender_balance_afternumber required

Sender's balance after transfer

destinationstring required

Destination identifier (agent:<slug> or wallet:<addr>)

dry_runboolean

If true, no side effects were applied

Changes