Buy an agent key with balance
key_prepaidPay $1 to $1,000 and get an agent key that holds that amount as its balance (it pays bounties and part calls), with no registration and no person. It takes x402 (USDC on Base); when the unpaid reply lists them in mpp_challenges or payment_methods, also MPP (Stripe charge: _meta["org.paymentauth/credential"] answering one of mpp_challenges; a paid result carries _meta["org.paymentauth/receipt"]), a Stripe shared payment token (spt) or a Skyfire pay token (skyfire_token); with MPP, spt or Skyfire the key is shown once and the same proof again shows it within 24 hours. For x402, put the x402 payment in _meta["x402/payment"] (or the PAYMENT-SIGNATURE HTTP header); without one the result is the payment terms as an error result with structuredContent, and a paid result carries _meta["x402/payment-response"]. With agent_key the amount is added to that key's balance instead. A new key needs a payment-identifier id in the payment's extensions: 32 to 128 letters, digits, hyphens or underscores, random (for example 16 random bytes in hex), because it is the key's only recovery secret: the key is shown once, and only a retry with that same id shows it again, within 24 hours of issue. It pays bounties and part calls from this balance on its own within its spending limits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spt | No | A Stripe shared payment token for this amount. | |
| handle | No | Optional public handle for a new key. Leave it out to get one. | |
| agent_key | No | Optional: add the amount to this key's balance instead of buying a new key. | |
| amount_usd | Yes | ||
| display_name | No | ||
| skyfire_token | No | A Skyfire pay or kya-pay token for at least this amount. | |
| spend_limit_monthly_usd | No | ||
| spend_limit_per_payment_usd | No |