registry

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)

Service	Slug	Description	Endpoints	Price Range
Twitter API	twitter	Full Twitter API access - users, tweets, search, communities, spaces, trends, and more via twitterapi.io	26	$0.005 - $0.02
AI Generation API	ai-gen	Run AI models for image, video, audio, and 3D generation	1	$0.01
x402 Test Service	test	Test 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 API	exa	Semantic web search via Exa	4	$0.002 - $0.01
Wordspace Agent	wordspace	AI agent loop with sandboxed execution and OpenProse skills	1	$2
OpenRouter	openrouter	Text generation via 300+ models (OpenAI, Anthropic, Google, Meta, etc.)	0	free
Jupiter API	jupiter	Solana token swap, price, search, and portfolio via Jupiter	4	$0.002 - $0.01
NEAR Intents API	near-intents	Cross-chain token swaps via 1Click deposit addresses	1	$0.01
AgentMail API	agentmail	Email infrastructure for AI agents — create inboxes, send/receive emails, manage threads	5	$0.005 - $0.01
CoinGecko API	coingecko	Crypto price data, market info, and token search — prices, market caps, trending tokens, and search across 10,000+ cryptocurrencies	5	$0.002 - $0.005

Service Endpoints

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

Endpoint	Description
GET /	Service info
GET /health	Health check
GET /docs	Interactive API docs
GET /openapi.json	OpenAPI 3.x spec
GET /skill.md	Agent-friendly documentation

Pricing Details

Twitter API (twitter)

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

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

AI Generation API (ai-gen)

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

Endpoint	Price	Description
POST /api/invoke	$0.01	Run AI model prediction (price varies by model)

x402 Test Service (test)

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

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

Exa API (exa)

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

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

Wordspace Agent (wordspace)

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

Endpoint	Price	Description
POST /api/invoke	$2	Run wordspace AI agent loop

Jupiter API (jupiter)

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

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

NEAR Intents API (near-intents)

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

Endpoint	Price	Description
POST /api/quote	$0.01	Cross-chain swap quote and deposit address

AgentMail API (agentmail)

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

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

CoinGecko API (coingecko)

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

Endpoint	Price	Description
POST /api/price	$0.002	Get token prices in any fiat/crypto currency
POST /api/token-info	$0.005	Get detailed token information and market data
POST /api/trending	$0.005	Get currently trending tokens
POST /api/markets	$0.005	Get token market data with sorting and pagination
POST /api/search	$0.003	Search 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:

Model	Price
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:

Model	Price
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:

Network	ID	Type	Environment
Base	eip155:8453	EVM	Mainnet
Base Sepolia	eip155:84532	EVM	Testnet
Solana	solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp	Solana	Mainnet
Solana Devnet	solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1	Solana	Devnet

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

Platform Endpoints (FREE)

Endpoint	Description
GET https://registry.frames.ag/api	Platform info and version
GET https://registry.frames.ag/api/services	List all services with metadata
GET https://registry.frames.ag/api/services/:slug	Single service details
GET https://registry.frames.ag/api/pricing	All pricing policies
GET https://registry.frames.ag/api/networks	Supported payment networks
GET https://registry.frames.ag/api/health	Health check
GET https://registry.frames.ag/api/packages	Skill/agent package catalog
GET https://registry.frames.ag/api/packages/:slug/bundle	Download package bundle
GET https://registry.frames.ag/.well-known/x402	x402 discovery document
GET https://registry.frames.ag/docs	Interactive 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