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

Set up a wallet — create an AgentWallet or fund your own wallet with USDC
Discover services: GET https://registry.frames.ag/api/services
Read service docs: GET https://registry.frames.ag/api/service/{slug}/skill.md
Check pricing: GET https://registry.frames.ag/api/pricing
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:

Call any paid endpoint without a payment header
Receive 402 Payment Required with a PAYMENT-REQUIRED header (Base64 JSON with price, network, payTo address)
Sign a payment for the requested amount on your chosen network
Retry the same request with the PAYMENT-SIGNATURE header
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.

Authenticate with AgentWallet (email OTP → API token)
Fund your wallet with USDC on Base or Solana
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.

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

registry

Safety Notice

Copy this and send it to your AI assistant to learn

Frames Registry

Base URL

Prerequisites

Quick Start

Services (10)

Service Endpoints

Pricing Details

Twitter API (`twitter`)

AI Generation API (`ai-gen`)

x402 Test Service (`test`)

Exa API (`exa`)

Wordspace Agent (`wordspace`)

Jupiter API (`jupiter`)

NEAR Intents API (`near-intents`)

AgentMail API (`agentmail`)

CoinGecko API (`coingecko`)

AI Model Pricing (`ai-gen`)

Payment Protocol (x402)

Platform Endpoints (FREE)

Agent Integration

With AgentWallet (recommended)

Direct x402 (self-managed wallet)

Source Transparency

Related Skills

agentwallet

websh

open-prose

registry

Safety Notice

Copy this and send it to your AI assistant to learn

Frames Registry

Base URL

Prerequisites

Quick Start

Services (10)

Service Endpoints

Pricing Details

Twitter API (twitter)

AI Generation API (ai-gen)

x402 Test Service (test)

Exa API (exa)

Wordspace Agent (wordspace)

Jupiter API (jupiter)

NEAR Intents API (near-intents)

AgentMail API (agentmail)

CoinGecko API (coingecko)

AI Model Pricing (ai-gen)

Payment Protocol (x402)

Platform Endpoints (FREE)

Agent Integration

With AgentWallet (recommended)

Direct x402 (self-managed wallet)

Source Transparency

Related Skills

agentwallet

websh

open-prose

Twitter API (`twitter`)

AI Generation API (`ai-gen`)

x402 Test Service (`test`)

Exa API (`exa`)

Wordspace Agent (`wordspace`)

Jupiter API (`jupiter`)

NEAR Intents API (`near-intents`)

AgentMail API (`agentmail`)

CoinGecko API (`coingecko`)

AI Model Pricing (`ai-gen`)