registry

community

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

>_frames-engineering/skills/skills/registry·commit 0b96870

name: registry version: 1.0.0 description: Pay-per-call API gateway for AI agents. 10 services available via x402 — no API keys, no subscriptions. homepage: https://registry.frames.ag metadata: category: api-gateway api_base: https://registry.frames.ag/api x402: supported: true chains: - evm - solana networks: - eip155:8453 - eip155:84532 - solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp - solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1 tokens: - USDC - USDT - CASH services: count: 10 slugs: - twitter - ai-gen - test - exa - wordspace - openrouter - jupiter - near-intents - agentmail - coingecko endpoints: twitter: /api/service/twitter ai-gen: /api/service/ai-gen test: /api/service/test exa: /api/service/exa wordspace: /api/service/wordspace openrouter: /api/service/openrouter jupiter: /api/service/jupiter near-intents: /api/service/near-intents agentmail: /api/service/agentmail coingecko: /api/service/coingecko skill_docs: /api/service/{slug}/skill.md wallet: recommended: agentwallet skill: https://frames.ag/skill.md endpoint: /x402/fetch

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