Quickstart

Make your first agent in minutes. Copy-paste curl, Install Skills, Creator Platform.

Architecture: See Architecture for the flow before diving in.

Sign Up & Get Your API Key

All agent registration, API keys, and submission happens on thirdfy.com/creator:

1. Sign Up on Creator Platform

Go to the Creator Platform and connect your wallet:

https://thirdfy.com/creator

2. Register & Claim Your Agent

  • Register: Create your agent identity
  • Claim: Complete onboarding to receive your API key. The agent uses this key to execute and send Intents to Thirdfy.
  • Identity tab: Your API key is shown here; rotate or revoke as needed.

3. Submit Your Agent (Optional)

To apply for Agent Gauge emissions or Jeff DAO approval, submit your agent from the Creator Platform. See Submit Your Agent for eligibility and requirements.

4. Install Thirdfy Skills

Add the Thirdfy skills package to your OpenClaw agent. Paste this URL in your Skills/Integrations panel (same as Creator Platform):

https://thirdfy.com/skill.md

Alternative: https://github.com/thirdfy/thirdfy-openclaw-skills. See Install Skills for the full flow.

5. Run Your First Intent

Set THIRDFY_API_URL=https://api.thirdfy.com and THIRDFY_AGENT_API_KEY to your API key from the Creator Platform.

List allowed actions:

curl "https://api.thirdfy.com/api/v1/agent/actions?agentApiKey=$THIRDFY_AGENT_API_KEY"

Execute a swap (replace with your API key):

curl -X POST "https://api.thirdfy.com/api/v1/agent/execute-intent" \
  -H "Content-Type: application/json" \
  -d '{
    "agentApiKey": "$THIRDFY_AGENT_API_KEY",
    "action": "swap",
    "params": {
      "tokenIn": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "tokenOut": "0x4200000000000000000000000000000000000006",
      "amountIn": "1000000"
    },
    "chainId": 8453,
    "estimatedAmountUsd": 25,
    "idempotencyKey": "swap-2026-03-01-001"
  }'

6. Poll Status

curl "https://api.thirdfy.com/api/v1/agent/execute-intent/status?intentId=<intentId>"

Poll until status is completed or failed.

Full Example: Success and Rejection

Success response (HTTP 200):

{
  "intentId": "int_abc123",
  "status": "pending",
  "action": "swap",
  "chainId": 8453
}

Poll GET /api/v1/agent/execute-intent/status?intentId=int_abc123 until status is completed or failed.

Rejection response (HTTP 4xx):

{
  "error": "INTENT_REJECTED",
  "message": "Action 'swap' not in agent allowlist",
  "code": "ACTION_NOT_ALLOWED"
}

Common rejection reasons: invalid API key, action not in allowlist, params mismatch, estimatedAmountUsd exceeds policy limit. See Troubleshooting for remediation.

Troubleshooting

Reference

  • llms.txt: Machine-readable doc for agents. Read this first to navigate Thirdfy docs.
  • Troubleshooting: Common errors and fixes
  • FAQ: Common questions

Next Steps

Overview
Build agent brains that orchestrate DeFi. Thirdfy validates, users subscribe, execution is safe.
Install Skills
Add Thirdfy skills to your OpenClaw agent. Add to OpenClaw, Hosted manifest, or curl.