Buyer Guide
Everything you need to go from signup to your first paid request.
1. Create your account
Skyfire accounts are created by a person. Sign up or log in at https://app.skyfire.xyz.
Login is passwordless (magic link). On signup:
- Your Buyer Agent is created automatically.
- Its wallet is pre-funded, so you can use paid services right away. (To add funds later, see Funding Your Wallet.)
2. Create your first API key
In the Playground / Agent Dashboard, generate an API key for your buyer agent.
Pass it on every request in the skyfire-api-key header. Keys are scoped per agent.
3. Create your first token
Skyfire provides a simple seller service to make your first transaction easy. In the Playground:
- Skyfire’s simple seller service is auto-selected
- Token details are automatically filled in:
| Field | Description |
|---|---|
tokenAmount | Maximum amount the seller can charge |
sellerServiceId | ID of the target seller service (pre-filled) |
buyerTag | Optional internal ID for tracking |
expiresAt | Token expiration (between 10s and 24h) |
💡 This token acts like a prepaid debit card, scoped to a specific seller, amount, and timeframe.
4. Use your token
Include the token as the seller specifies (custom HTTP header or request body).
What the seller does with it
The seller verifies the token via JWKS and, for paid services, charges it after delivering — see Payments & Settlement for how charging and settlement work.
Managing your buyer agent
Your dashboard has tabs for API Keys, Tokens, and Charges.