Registry

by frames-engineering0b968707971eNo license4 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 6 months ago

Pay-per-call API gateway for AI agents. 10 services available via x402 — no API keys, no subscriptions.

Instructions onlyDevOps & Cloud
AI-generated overview

Pay-per-call API gateway documentation for AI agents, listing 10 x402-paid services and how to pay per request.

What it does
This skill documents the Frames Registry, a pay-per-call API gateway that exposes ten services (Twitter, AI generation, Exa search, OpenRouter, Jupiter, NEAR Intents, AgentMail, CoinGecko, Wordspace and a test service) behind x402 crypto payments. It lists each service's endpoints, per-call prices, supported networks and tokens, and the free platform endpoints for discovery, pricing and health. It also describes the x402 payment flow, including the 402 response, payment header signing and retry, and integration through a hosted wallet proxy or a self-managed wallet.
When to use it
Use it when an agent needs to call one of the listed third-party APIs and pay per request with crypto instead of using API keys or subscriptions. It is also useful for discovering available services, checking endpoint prices, or verifying an x402 client integration against the test service.
Requirements
Network access to the registry host and its API endpoints. A crypto wallet funded with USDC (or USDT/CASH where supported) on Base, Base Sepolia, Solana or Solana Devnet; either a hosted wallet service that signs x402 payments, or a self-managed EVM/Solana wallet able to sign EIP-3009 or SPL transfers. No scripts are included; the skill is instructions only.

Frames Registry

Pay-per-call API gateway for AI agents. 10 services available via the x402 payment protocol. No API keys, no subscriptions — just pay per request with crypto.

Base URL

https://registry.frames.ag

Prerequisites

A crypto wallet funded with USDC is required to use paid endpoints. Two options:

  • AgentWallet (recommended for agents) — server-side wallet that handles 402 detection, payment signing, and retries automatically via a single POST /x402/fetch call. No private key management needed on your side.
  • Self-managed wallet — any EVM wallet (Base) or Solana wallet with USDC. You sign x402 payment headers directly.

Quick Start

  1. Set up a wallet — create an AgentWallet or fund your own wallet with USDC
  2. Discover services: GET https://registry.frames.ag/api/services
  3. Read service docs: GET https://registry.frames.ag/api/service/{slug}/skill.md
  4. Check pricing: GET https://registry.frames.ag/api/pricing
  5. Make a paid request — via AgentWallet's /x402/fetch or directly with x402 headers (see Payment Protocol below)

Services (10)

ServiceSlugDescriptionEndpointsPrice Range
Twitter APItwitterFull Twitter API access - users, tweets, search, communities, spaces, trends, and more via twitterapi.io26$0.005 - $0.02
AI Generation APIai-genRun AI models for image, video, audio, and 3D generation1$0.01
x402 Test ServicetestTest x402 payment flows on Base Sepolia (EVM) and Solana Devnet. Use this service to verify your x402 client integration is working correctly.2$0.001
Exa APIexaSemantic web search via Exa4$0.002 - $0.01
Wordspace AgentwordspaceAI agent loop with sandboxed execution and OpenProse skills1$2
OpenRouteropenrouterText generation via 300+ models (OpenAI, Anthropic, Google, Meta, etc.)0free
Jupiter APIjupiterSolana token swap, price, search, and portfolio via Jupiter4$0.002 - $0.01
NEAR Intents APInear-intentsCross-chain token swaps via 1Click deposit addresses1$0.01
AgentMail APIagentmailEmail infrastructure for AI agents — create inboxes, send/receive emails, manage threads5$0.005 - $0.01
CoinGecko APIcoingeckoCrypto price data, market info, and token search — prices, market caps, trending tokens, and search across 10,000+ cryptocurrencies5$0.002 - $0.005

Service Endpoints

Each service lives at https://registry.frames.ag/api/service/{slug} and exposes:

EndpointDescription
GET /Service info
GET /healthHealth check
GET /docsInteractive API docs
GET /openapi.jsonOpenAPI 3.x spec
GET /skill.mdAgent-friendly documentation

Pricing Details

Twitter API (twitter)

Base: https://registry.frames.ag/api/service/twitter | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/user-info$0.005Look up a Twitter user's profile by username — returns bio, follower/following counts, verification status, and profile metadata
POST /api/user-tweets$0.01Fetch a user's recent tweets by username or user ID, with optional reply inclusion and cursor pagination
POST /api/user-followers$0.01List accounts following a user, paginated up to 200 per page with cursor-based navigation
POST /api/user-following$0.01List accounts a user follows, paginated up to 200 per page with cursor-based navigation
POST /api/verified-followers$0.01List only verified (blue-check) accounts following a user, by user ID with cursor pagination
POST /api/search-users$0.01Search for Twitter users by keyword — matches against names, bios, and usernames
POST /api/user-mentions$0.01Fetch tweets that @mention a user, with optional time range filtering (sinceTime/untilTime unix timestamps)
POST /api/check-follow$0.005Check whether one user follows another — returns the follow relationship between two usernames
POST /api/batch-users$0.02Fetch multiple user profiles in one request by comma-separated user IDs
POST /api/tweets-by-ids$0.01Fetch full tweet data for multiple tweets by comma-separated tweet IDs
POST /api/tweet-replies$0.01Get replies to a specific tweet, sortable by Relevance, Latest, or Likes with cursor pagination
POST /api/search-tweets$0.01Advanced tweet search with operators — supports from:, to:, has:media, date ranges, engagement filters, and boolean logic
POST /api/tweet-quotes$0.01Get all quote tweets of a specific tweet, with optional time range and reply inclusion filters
POST /api/tweet-retweeters$0.01List users who retweeted a specific tweet, with cursor pagination
POST /api/tweet-thread$0.01Retrieve the full conversation thread for a tweet — parent tweets and replies in context
POST /api/list-tweets$0.01Fetch tweets from a Twitter List by list ID, with optional time range and reply filters
POST /api/list-followers$0.01List users who follow a specific Twitter List, with cursor pagination
POST /api/list-members$0.01List all members of a Twitter List, with cursor pagination
POST /api/community-info$0.005Get a Twitter Community's metadata — name, description, member count, rules, and creation date
POST /api/community-members$0.01List members of a Twitter Community, with cursor pagination
POST /api/community-tweets$0.01Fetch tweets posted in a Twitter Community, with cursor pagination
POST /api/space-detail$0.005Get details about a Twitter Space — title, host, participants, schedule, and state (live/scheduled/ended)
POST /api/article$0.01Retrieve a long-form Twitter Article (Notes) by the tweet ID that contains it
POST /api/trends$0.01Get trending topics for a location by WOEID (1=Worldwide, 23424977=US, 2459115=NYC)
POST /api/invoke$0.01Search tweets (legacy — use /api/search-tweets instead)
POST /api/search$0.01Search tweets (legacy — use /api/search-tweets instead)

AI Generation API (ai-gen)

Base: https://registry.frames.ag/api/service/ai-gen | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/invoke$0.01Run AI model prediction (price varies by model)

x402 Test Service (test)

Base: https://registry.frames.ag/api/service/test | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/invoke$0.001Test x402 payment flow (Base Sepolia & Solana Devnet)
POST /api/echo$0.001Echo data with payment verification

Exa API (exa)

Base: https://registry.frames.ag/api/service/exa | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/search$0.01Semantic web search
POST /api/find-similar$0.01Find similar pages
POST /api/contents$0.002Extract URL contents
POST /api/answer$0.01AI-powered answer

Wordspace Agent (wordspace)

Base: https://registry.frames.ag/api/service/wordspace | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/invoke$2Run wordspace AI agent loop

Jupiter API (jupiter)

Base: https://registry.frames.ag/api/service/jupiter | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/swap$0.01Get swap quote and unsigned transaction
POST /api/price$0.002Token price lookup
POST /api/tokens$0.002Token search and metadata
POST /api/portfolio$0.005Wallet portfolio positions

NEAR Intents API (near-intents)

Base: https://registry.frames.ag/api/service/near-intents | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/quote$0.01Cross-chain swap quote and deposit address

AgentMail API (agentmail)

Base: https://registry.frames.ag/api/service/agentmail | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/inbox/create$0.01Create a new email inbox for an AI agent
POST /api/send$0.01Send an email from an agent inbox
POST /api/messages$0.005List messages in an inbox
POST /api/message$0.005Get a specific message by ID
POST /api/threads$0.005List email threads in an inbox

CoinGecko API (coingecko)

Base: https://registry.frames.ag/api/service/coingecko | Docs | OpenAPI | Skill

EndpointPriceDescription
POST /api/price$0.002Get token prices in any fiat/crypto currency
POST /api/token-info$0.005Get detailed token information and market data
POST /api/trending$0.005Get currently trending tokens
POST /api/markets$0.005Get token market data with sorting and pagination
POST /api/search$0.003Search tokens by name or symbol

AI Model Pricing (ai-gen)

Price is set dynamically based on the model field in the request body.

Image Models:

ModelPrice
flux/schnell$0.004/image
flux/2-pro$0.02
flux/kontext-pro$0.05/image
bytedance/seedream-4$0.04/image
google/nano-banana$0.05/image
google/nano-banana-2$0.09/image (1K), $0.13/image (2K), $0.19/image (4K)
google/nano-banana-pro$0.18/image
google/imagen-4-fast$0.03/image
ideogram/v3-turbo$0.04/image
prunaai/z-image-turbo$0.006/image
prunaai/p-image$0.006/image
fofr/sdxl-emoji$0.01
qwen/qwen-image-edit-2511$0.04/image
openai/dall-e-3$0.15/image
nightmareai/real-esrgan$0.003/image

Video Models:

ModelPrice
google/veo-3$0.48/sec (audio), $0.24/sec (no audio)
google/veo-3-fast$0.18/sec (audio), $0.12/sec (no audio)
google/veo-3.1$0.48/sec (audio), $0.24/sec (no audio)
google/veo-3.1-fast$0.18/sec (audio), $0.12/sec (no audio)
openai/sora-2$0.12/sec
openai/sora-2-pro$0.36/sec (720p), $0.60/sec (1080p)
kwaivgi/kling-v2.5-turbo-pro$0.09/sec
kwaivgi/kling-v2.6$0.09/sec
kwaivgi/kling-v2.6-motion-control$0.09/sec (std), $0.15/sec (pro)
bytedance/seedance-1-pro$0.04/sec (480p), $0.08/sec (720p), $0.18/sec (1080p)
bytedance/seedance-1-lite$0.03/sec (480p), $0.05/sec (720p), $0.09/sec (1080p)
bytedance/seedance-1-pro-fast$0.02/sec (480p), $0.03/sec (720p), $0.08/sec (1080p)
bytedance/seedance-1.5-pro$0.04/sec (720p), $0.07/sec (720p+audio)
minimax/video-01$0.60
wan-video/wan-2.2-t2v-fast$0.12
wan-video/wan-2.2-i2v-fast$0.07
wan-video/wan-2.5-i2v-fast$0.09/sec (720p), $0.13/sec (1080p)
runwayml/gen4-turbo$0.06/sec
runwayml/gen4-aleph$0.22/sec
veed/fabric-1.0$0.10/sec (480p), $0.18/sec (768p)
shreejalmaharjan-27/tiktok-short-captions$0.002/sec

Payment Protocol (x402)

All paid endpoints use the x402 payment protocol. No API keys needed.

Flow:

  1. Call any paid endpoint without a payment header
  2. Receive 402 Payment Required with a PAYMENT-REQUIRED header (Base64 JSON with price, network, payTo address)
  3. Sign a payment for the requested amount on your chosen network
  4. Retry the same request with the PAYMENT-SIGNATURE header
  5. Receive the response plus a PAYMENT-RESPONSE confirmation header

Failed requests are automatically refunded.

Supported Networks:

NetworkIDTypeEnvironment
Baseeip155:8453EVMMainnet
Base Sepoliaeip155:84532EVMTestnet
Solanasolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpSolanaMainnet
Solana Devnetsolana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1SolanaDevnet

Accepted Tokens: USDC, USDT, CASH (availability varies by network)

Platform Endpoints (FREE)

EndpointDescription
GET https://registry.frames.ag/apiPlatform info and version
GET https://registry.frames.ag/api/servicesList all services with metadata
GET https://registry.frames.ag/api/services/:slugSingle service details
GET https://registry.frames.ag/api/pricingAll pricing policies
GET https://registry.frames.ag/api/networksSupported payment networks
GET https://registry.frames.ag/api/healthHealth check
GET https://registry.frames.ag/api/packagesSkill/agent package catalog
GET https://registry.frames.ag/api/packages/:slug/bundleDownload package bundle
GET https://registry.frames.ag/.well-known/x402x402 discovery document
GET https://registry.frames.ag/docsInteractive docs (HTML)

Agent Integration

With AgentWallet (recommended)

AgentWallet is a server-side wallet for AI agents. It manages keys, balances, and x402 payment signing so agents don't need to handle crypto directly.

  1. Authenticate with AgentWallet (email OTP → API token)
  2. Fund your wallet with USDC on Base or Solana
  3. Call any Frames Registry endpoint through AgentWallet's proxy:
POST https://frames.ag/x402/fetch{  "url": "https://registry.frames.ag/api/service/twitter/api/search-tweets",  "method": "POST",  "body": { "query": "AI agents" }}

AgentWallet detects the 402 response, signs payment, and retries automatically.

Direct x402 (self-managed wallet)

Requires an EVM or Solana wallet with USDC and the ability to sign EIP-3009 or SPL transfers.

  1. Make the request to the paid endpoint
  2. Parse the PAYMENT-REQUIRED header from the 402 response (Base64 JSON with price, network, payTo)
  3. Sign a payment authorization for the exact amount
  4. Retry with the PAYMENT-SIGNATURE header

Source and attribution

Source:frames-engineering/skillsinskills/registryat commit0b96870

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from frames-engineering/skills

Websh

frames-engineering

Turns web pages into a shell-like filesystem where URLs are paths and Unix-style commands query cached page content.

Productivity & Workflow4updated 6 months ago

Wordspace

frames-engineering

CLI skill for bootstrapping wordspace projects and managing reusable .prose workflows from GitHub.

Productivity & Workflow4updated 6 months ago

More in DevOps & Cloud

Playwright Devops

microsoft

Featured

DevOps workflows for Playwright: analyze GitHub Actions failures for the last commit on main and fetch failed job logs.

Includes scripts
DevOps & Cloud97Kupdated today

M5 Onboard

anthropics

Featured

Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.

DevOps & Cloud37Kupdated today

Yeet

openai

Featured

Stages, commits, pushes, and opens or updates a GitHub pull request in one flow using the GitHub CLI.

DevOps & Cloud27Kupdated 4 weeks ago

Runbook

anthropics

Featured

Creates or updates step-by-step operational runbooks for recurring tasks, including troubleshooting, rollback and escalation.

DevOps & Cloud27Kupdated today

Incident Response

anthropics

Featured

Guides an incident response workflow: severity triage, status updates, mitigation tracking, and blameless postmortems.

DevOps & Cloud27Kupdated today

Deploy Checklist

anthropics

Featured

Generates a pre-deployment readiness checklist covering pre-deploy, deploy, post-deploy and rollback triggers.

DevOps & Cloud27Kupdated today
Registry Agent Skill | SourceWeft