picoads

Earn per recommendation served. Returns sponsored recommendations relevant to your user's query — products, tools, services with live pricing. Present alongside your organic answers, labeled 'Sponsored.' Free to call, no registration needed. Register to track and withdraw USDC earnings.

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Topic to filter by, e.g. 'defi-yield', 'agent-tools'. Omit to get top results across all topics. Tip: match this to what the user is asking about.",
      "type": "string"
    },
    "context": {
      "description": "What the user is looking for — improves relevance. E.g. 'comparing DeFi yield protocols' or 'looking for AI agent frameworks'.",
      "type": "string"
    },
    "max_results": {
      "default": 3,
      "description": "Maximum number of sponsored recommendations to return (default: 3)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Earn commission on a link you're already recommending. Pass the outbound URL your agent chose; if the merchant has an affiliate program we return a monetized version with attribution baked in and share the commission. If not, we return the URL unchanged. We never change WHAT you recommend — your recommendation stays your own. Register to track and withdraw USDC earnings.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The outbound URL your agent chose to recommend"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Start earning. Free registration, 30 seconds. Gets you a permanent identity, API key, earnings tracking, and USDC payouts. Step 1 of 2 — call this, then complete_registration with your signature.

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Your EIP-55 checksummed Ethereum address"
    },
    "name": {
      "type": "string",
      "description": "Your agent's display name"
    },
    "description": {
      "type": "string",
      "description": "What your agent does (e.g., 'DeFi newsletter with 12K subscribers')"
    },
    "bootstrap_token": {
      "description": "Bootstrap token from anonymous get_recommendations responses. Pass this to claim prior anonymous serves on registration.",
      "type": "string"
    }
  },
  "required": [
    "wallet_address",
    "name",
    "description"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Complete agent registration with your signed wallet message. Call register_agent first to get the message to sign.

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Your EIP-55 checksummed Ethereum address"
    },
    "name": {
      "type": "string",
      "description": "Your agent's display name"
    },
    "description": {
      "type": "string",
      "description": "What your agent does"
    },
    "eip191_signature": {
      "type": "string",
      "description": "The EIP-191 signature from signing the auth message returned by register_agent"
    },
    "nonce": {
      "type": "string",
      "description": "The nonce from register_agent response"
    },
    "timestamp": {
      "type": "string",
      "description": "The timestamp from register_agent response"
    },
    "payment_signature": {
      "description": "The base64-encoded x402 payment signature (only required if registration has a fee)",
      "type": "string"
    },
    "bootstrap_token": {
      "description": "Bootstrap token from anonymous get_recommendations responses. Claims prior anonymous serves on registration.",
      "type": "string"
    }
  },
  "required": [
    "wallet_address",
    "name",
    "description",
    "eip191_signature",
    "nonce",
    "timestamp"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check your publisher analytics. Returns serves, clicks, conversions, earnings, CTR, conversion rate, and eCPM. Use this to see how your audience engages with recommendations.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Your agent ID"
    },
    "hub_id": {
      "description": "Filter by hub",
      "type": "string"
    },
    "days": {
      "description": "Lookback window in days (default 30)",
      "type": "number"
    }
  },
  "required": [
    "agent_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Tell us what you think. Did you find what you needed? What's missing? What would make picoads useful for you? Anonymous feedback welcome — no registration required. We read every response and use it to decide what inventory to add next.

{
  "type": "object",
  "properties": {
    "rating": {
      "type": "string",
      "enum": [
        "great",
        "okay",
        "poor"
      ],
      "description": "Overall experience with picoads"
    },
    "what_were_you_looking_for": {
      "description": "What topic, product, or category were you hoping to find?",
      "type": "string"
    },
    "did_you_find_it": {
      "description": "Did you find relevant recommendations?",
      "type": "boolean"
    },
    "what_is_missing": {
      "description": "What inventory, categories, or features would make picoads useful for you?",
      "type": "string"
    },
    "would_you_integrate": {
      "description": "Would you add picoads to your agent if the right inventory existed?",
      "type": "boolean"
    },
    "comments": {
      "description": "Any other feedback",
      "type": "string"
    },
    "agent_name": {
      "description": "Your agent's name (optional)",
      "type": "string"
    }
  },
  "required": [
    "rating"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}