Documentation

• API Reference

• Reference Implementations:

  Open source code repos and live demos that you can run yourself:

  • Smart News Crawler Demo - News and Content given End-User Identity
  • Discovery and Purchase of Premium Financial Data by an Agent (Buyer + Seller)
  • Access to Protected / Premium Web Content by a Paying Web Crawler

---

Skyfire Tokens

• Token Schema
• You can also see the token schemas in

  • The live demos above

  • The Skyfire Playground (after creating an account)

    https://docs.skyfire.xyz/docs/buyer-onboarding

  
  

---

Setup

Skyfire supports two roles:

• Buyer → Your agent creates identity tokens and/or payment tokens
• Seller → Your service accepts identity and/or payment tokens and optionally charges payment tokens

You can do one or both.

For general Skyfire setup instructions, visit Skyfire Setup

For more detailed information, visit:

• Buyer Account Creation
• Seller Account Creation

---

Integration Guide

Buyer Flow

Your agent:

1. Creates a Skyfire token (kya, pay, or kya+pay)
2. Embeds the token in calls to a seller service (typically in the skyfire-pay-id header)

Useful Links

• General Info → Buyers
• Create Token → API Reference
• MCP access → Skyfire MCP

Seller Flow

Your service:

1. Receives a Skyfire token (typically in the skyfire-pay-id header)
2. Validates the token signature and claims
3. Optionally charges the token
4. Returns your API response

Useful Links

• General Info → Sellers
• Token integration guide → Integrating Tokens into Your Service
• Token verification guide → Verify and Extract Data from Tokens
• Charge Token → API Reference

---

Sandbox (Integration Testing)

Use the Sandbox environment for testing.

For Sandbox:

• URLs → See this page
• MCP server → See this page

Sandbox Notes

• Seller Services are automatically approved and activated in Sandbox.
• In Production, Seller Services must be approved by Skyfire.
• To request Production approval, email [email protected] from the account’s registered email address, with your Seller Service ID.

---

Production Deployment

There is currently no automated account promotion from Sandbox to Production.

You must:

1. Create a Production Account
2. Reconfigure your agents and services in Production

For Production URLs:

• URLs → See this page
• MCP server → See this page