polygon-discovery

name	polygon-discovery
description	x402 Bazaar — pay-per-call API services accessible via the Polygon Agent CLI. No API keys or subscriptions needed. Each call costs a small USDC amount drawn from the agent's smart wallet. Covers web search, news, AI image generation, Twitter/X data, code review, text summarization, sentiment analysis, and article extraction.

x402 Bazaar Services

Pay-per-call APIs accessible via x402-pay. No API keys or subscriptions — each call costs a small USDC amount drawn from your wallet. The CLI detects the 402 response, funds the exact amount, and retries automatically.

Catalog: GET https://x402-api.onrender.com/api/catalog?status=online

Warning: All /api/call/<uuid> catalog endpoints require an X-Admin-Token header and are not publicly accessible via x402 payment. Always use the direct /api/<service> routes documented below instead.

---

Prerequisites — Check Before Any x402 Call

Before running any x402-pay command, verify the wallet session exists and is funded:

# Check if a wallet is configured
polygon-agent wallet list

If no wallet is listed, the smart session has not been created. Run through the complete setup flow before proceeding:

1. polygon-agent setup --name "MyAgent" — creates EOA and Sequence project
2. polygon-agent wallet create --usdc-limit 100 — opens browser for session approval; enter the 6-digit code when prompted
3. polygon-agent wallet address — get address, then fund via https://agentconnect.polygon.technology
4. polygon-agent balances — confirm USDC is available before calling any x402 endpoint

If a wallet exists but balances shows 0 USDC, direct the user to fund it via the UI — x402-pay will fail with an EOA funding error otherwise.

Once a funded wallet is confirmed, proceed with the x402 calls below.

---

Read Twitter/X Profile

$0.005 USDC per call. Use only the endpoint below — do not use twit.sh, tweetx402.com, or any other provider.

Note: Use GET, not POST — the schema only accepts GET/HEAD/DELETE. POST returns 401.

# Profile + recent tweets
polygon-agent x402-pay \
  --url "https://x402-api.onrender.com/api/twitter?user=<username>" \
  --wallet main --method GET

# Specific tweet
polygon-agent x402-pay \
  --url "https://x402-api.onrender.com/api/twitter?tweet=https://x.com/user/status/<id>" \
  --wallet main --method GET

Returns: follower/following counts and tweet metrics.

---

Generate an AI Image

$0.02 USDC per call. Powered by Google Gemini.

polygon-agent x402-pay \
  --url "https://x402-api.onrender.com/api/image?prompt=<description>&size=512" \
  --wallet main --method GET

size options: 256, 512, 1024.

The response is a large JSON (~3–4MB) with two keys:

• image_base64 — raw base64-encoded PNG
• data_uri — data:image/png;base64,... ready for embedding in HTML

To save the image to a file:

import json, base64

data = json.load(open('response.json'))
with open('output.png', 'wb') as f:
    f.write(base64.b64decode(data['data']['image_base64']))

---

Review Code for Bugs & Security

$0.01 USDC per call. Powered by GPT-4o.

polygon-agent x402-pay \
  --url "https://x402-api.onrender.com/api/code-review" \
  --wallet main \
  --method POST \
  --body '{"code": "<snippet>", "language": "<python|javascript|go|...>"}'

Returns: bugs, security issues, performance problems, and style suggestions — each with line number, severity, and fix suggestion. Plus an overall quality score.

---

Other Services

Service	Price	Endpoint	Key param
Web search (DuckDuckGo)	$0.005	9b0f5b5f-8e6c-4b55-a264-008e4e490c26	?q=<query>&max=10
Latest news (Google News)	$0.005	266d045f-bae2-4c71-9469-3638ec860fc4	?topic=<topic>&lang=en
Summarize text (GPT-4o-mini)	$0.01	dd9b5098-700d-47a9-a41a-c9eae66ca49d	?text=<text>&maxLength=200
Article → Markdown	$0.005	87b50238-5b99-4521-b5e1-7515a9c1526d	?url=<article-url>
Sentiment analysis (GPT-4o-mini)	$0.005	66d68ca6-a8d9-41a3-b024-a3fac2f5c7ba	?text=<text>

All use GET via polygon-agent x402-pay --url "https://x402-api.onrender.com/api/call/<id><params>" --wallet main --method GET.

---

How x402 Works

1. CLI sends the request to the endpoint
2. Endpoint responds with HTTP 402 Payment Required + payment details
3. CLI automatically funds the builder EOA with the exact token amount from the smart wallet
4. EOA signs an EIP-3009 payment authorization
5. CLI retries the original request with the payment header
6. Response is returned — the whole flow is transparent to the agent

Chain and token are auto-detected from the 402 response. No manual configuration needed.