polymer-pay-sybil

star 1

Unified search API combining Exa web search and xAI Grok capabilities. Search the web, X/Twitter, or both simultaneously with structured output support, reasoning modes, and automatic truncation handling.

polymerdao By polymerdao schedule Updated 4/23/2026
play_arrow Run Skill in Manus View GitHub

name: polymer-pay-sybil description: Unified search API combining Exa web search and xAI Grok capabilities. Search the web, X/Twitter, or both simultaneously with structured output support, reasoning modes, and automatic truncation handling. endpoints:

  • path: /api/health method: GET price: $0.00 description: Service status check
  • path: /api/status method: GET price: $0.0001 description: Poll async request
  • path: /api/search/exa method: POST price: $0.05 description: Exa raw web search
  • path: /api/answer/exa method: POST price: $0.05 description: Exa RAG with schema
  • path: /api/search/grok-web method: POST price: $0.06 description: Grok web search (fast)
  • path: /api/search/grok-web/thinking method: POST price: $0.08 description: Grok web + reasoning
  • path: /api/search/grok-x method: POST price: $0.06 description: Grok X/Twitter (fast)
  • path: /api/search/grok-x/thinking method: POST price: $0.08 description: Grok X + reasoning
  • path: /api/search/grok-combined method: POST price: $0.10 description: Web + X (fast)
  • path: /api/search/grok-combined/thinking method: POST price: $0.12 description: Combined + reasoning
  • path: /api/search/grok-combined/max method: POST price: $0.15 description: Web + X max tokens
  • path: /api/search/grok-combined/thinking/max method: POST price: $0.18 description: Combined + reasoning max metadata: polymer-pay-skill: emoji: 🔮 requires: env: - POLYMER_PAY_API_KEY primaryEnv: POLYMER_PAY_API_KEY registries: {} provider: mavs-agent-army

Sybil

Unified search service through the Polymer Pay proxy. Access Exa's semantic web search and xAI's Grok (web + X/Twitter) from a single API with normalized citations, schema support, and intelligent truncation handling.

Authentication

All requests route through the Polymer Pay proxy and require an API key header:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api

Async Request Pattern

All search endpoints use an async request/polling pattern:

  1. POST to start a task → returns { requestId } with HTTP 202
  2. GET /status?requestId=xxx to poll → returns { status, result }
  3. Status flow: pending → processing → completed / failed

Common Operations

Health Check (Free)

Verify service availability before spending credits.

Pricing: $0.00

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/health",
  "headers": {
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Status Polling

Check the status of an async request.

Pricing: $0.0001

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/status?requestId=YOUR_REQUEST_ID",
  "headers": {
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Exa Web Search

Raw semantic search results from Exa with domain filtering.

Pricing: $0.02

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/search/exa",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "latest AI research",
    "options": {
      "numResults": 10,
      "domains": {
        "allow": ["arxiv.org", "openai.com"],
        "block": ["example.com"]
      }
    }
  }
}

Exa Answer (RAG with Schema)

Get synthesized answers with optional structured output via JSON Schema.

Pricing: $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/answer/exa",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "What are the top 3 AI trends?",
    "systemPrompt": "Analyze and return structured data",
    "outputSchema": {
      "type": "object",
      "properties": {
        "trends": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {"type": "string"},
              "impact_score": {"type": "number"}
            }
          }
        }
      },
      "required": ["trends"]
    }
  }
}

Grok Web Search

Real-time web search via xAI's Grok. Max 2400 tokens by default.

Pricing: $0.06 (fast), $0.08 (thinking)

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/search/grok-web",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "Analyze the implications of quantum computing on cryptography",
    "systemPrompt": "Provide deep technical analysis",
    "outputSchema": {
      "type": "object",
      "properties": {
        "sentiment": {"type": "string", "enum": ["bullish", "bearish", "neutral"]},
        "key_factors": {"type": "array", "items": {"type": "string"}}
      }
    },
    "options": {
      "domains": {
        "allow": ["bloomberg.com", "reuters.com"]
      }
    }
  }
}

With reasoning/thinking mode:

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/search/grok-web/thinking",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "Analyze the implications of quantum computing on cryptography",
    "systemPrompt": "Provide deep technical analysis"
  }
}

Grok X (Twitter) Search

Search X/Twitter posts with optional handle filtering. Max 2400 tokens by default.

Pricing: $0.06 (fast), $0.08 (thinking)

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/search/grok-x",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "Summarize sentiment about AI regulation",
    "options": {
      "dateRange": {"from": "2025-01-01", "to": "2025-12-31"},
      "includeImages": true
    }
  }
}

Grok Combined (Web + X)

Search both web and X/Twitter simultaneously. Max 2400 tokens by default.

Pricing: $0.10 (fast), $0.12 (thinking)

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/search/grok-combined",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "What is the reaction to the latest iPhone release?",
    "systemPrompt": "Compare news coverage with social media sentiment",
    "outputSchema": {
      "type": "object",
      "properties": {
        "facts": {"type": "array", "items": {"type": "string"}},
        "sentiment": {"type": "string"},
        "sources": {"type": "array", "items": {"type": "string"}}
      }
    },
    "options": {
      "domains": {
        "allow": ["techcrunch.com", "theverge.com"]
      },
      "includeImages": true
    }
  }
}

Grok Combined MAX (8000 tokens)

For longer responses that need more than 2400 tokens. Use when you need comprehensive, detailed answers.

Pricing: $0.15 (fast), $0.18 (thinking)

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/search/grok-combined/max",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "Give me a comprehensive overview of AI development in 2026 including major breakthroughs, key players, market trends, and future predictions"
  }
}

With thinking mode:

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/mavs-agent-army.fly.dev/api/sibyl/api/search/grok-combined/thinking/max",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "query": "Provide an in-depth analysis of the current state of quantum computing and its potential impact on cryptography"
  }
}

Response Format

Standard Response

{
  "requestId": "uuid-here",
  "status": "pending"
}

Polling Response

{
  "status": "completed",
  "result": {
    "content": "Search results or structured object",
    "citations": [
      {
        "id": "unique-id",
        "title": "Article Title",
        "url": "https://example.com/article",
        "publishedDate": "2025-01-15",
        "author": "Author Name",
        "snippet": "Article excerpt...",
        "source": "exa" | "web" | "x"
      }
    ],
    "metadata": {
      "provider": "exa" | "grok",
      "mode": "exa-search" | "exa-answer" | "grok-web" | "grok-x" | "grok-combined",
      "tokens": {"input": 100, "output": 500, "reasoning": 200},
      "latency": 1234
    }
  }
}

Truncation Response

When a response exceeds the token limit (2400 for regular endpoints), the API returns partial results with a warning:

{
  "status": "completed",
  "result": {
    "content": "...truncated content...",
    "citations": [...],
    "metadata": {...},
    "warning": "Response was truncated due to token limit (2400 tokens). Use /max endpoint for full response up to 8000 tokens.",
    "truncated": true,
    "maxEndpoint": "/api/search/grok-combined/max"
  }
}

Token Limits

  • Regular endpoints: 2,400 tokens max
  • MAX endpoints: 8,000 tokens max

When a response is truncated, use the /max endpoint for full results.

When to Use

  • Exa Search: Deep semantic web search, research papers, technical documentation
  • Exa Answer: When you need synthesized answers with citations
  • Grok Web: Real-time web search, current events, breaking news
  • Grok X: Social media sentiment, public opinion, trending topics
  • Grok Combined: Comprehensive research requiring both news and social context
  • Thinking Mode: Complex analysis requiring reasoning (e.g., investment analysis, technical comparisons)
  • MAX Endpoints: When you need detailed, comprehensive responses (>2400 tokens)
  • Schema Output: When you need structured, parseable data instead of free text

Best Practices

  1. Start with health check before expensive operations
  2. Use POST for all search requests - enables full options and schema support
  3. Check for truncation - If truncated: true, use the /max endpoint
  4. Use MAX endpoints proactively - If you need detailed answers, start with /max
  5. Prefer Exa for research - Better for academic/technical content
  6. Prefer Grok for real-time - Better for current events and social media
  7. Use domain filtering - Narrow results to trusted sources with allow parameter
  8. Use schema for structured data - Ensures consistent, parseable responses
  9. Reserve thinking mode for complex analysis (costs more but provides reasoning)
  10. Handle citations - Always display or store citations for attribution
  • For errors -- See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting
Install via CLI
npx skills add https://github.com/polymerdao/pay-apis --skill polymer-pay-sybil
Repository Details
star Stars 1
call_split Forks 2
navigation Branch main
article Path SKILL.md
More from Creator
polymerdao
polymerdao Explore all skills →