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
1---2name: registry3description: Pay-per-call API gateway for AI agents. 10 services available via x402 — no API keys, no subscriptions.4---5
6# Frames Registry
7
8Pay-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.
9
10## Base URL
11
12```
13https://registry.frames.ag
14```
15
16## Prerequisites
17
18A crypto wallet funded with USDC is required to use paid endpoints. Two options:
19
20- **[AgentWallet](https://frames.ag/skill.md) (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.
21- **Self-managed wallet** — any EVM wallet (Base) or Solana wallet with USDC. You sign x402 payment headers directly.
22
23## Quick Start
24
251. **Set up a wallet** — create an [AgentWallet](https://frames.ag/skill.md) or fund your own wallet with USDC
262. **Discover services:** `GET https://registry.frames.ag/api/services`
273. **Read service docs:** `GET https://registry.frames.ag/api/service/{slug}/skill.md`
284. **Check pricing:** `GET https://registry.frames.ag/api/pricing`
295. **Make a paid request** — via AgentWallet's `/x402/fetch` or directly with x402 headers (see Payment Protocol below)
30
31## Services (10)
32
33| Service | Slug | Description | Endpoints | Price Range |
34|---------|------|-------------|-----------|-------------|
35| [Twitter API](https://registry.frames.ag/api/service/twitter/skill.md) | `twitter` | Full Twitter API access - users, tweets, search, communities, spaces, trends, and more via twitterapi.io | 26 | $0.005 - $0.02 |
36| [AI Generation API](https://registry.frames.ag/api/service/ai-gen/skill.md) | `ai-gen` | Run AI models for image, video, audio, and 3D generation | 1 | $0.01 |
37| [x402 Test Service](https://registry.frames.ag/api/service/test/skill.md) | `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 |
38| [Exa API](https://registry.frames.ag/api/service/exa/skill.md) | `exa` | Semantic web search via Exa | 4 | $0.002 - $0.01 |
39| [Wordspace Agent](https://registry.frames.ag/api/service/wordspace/skill.md) | `wordspace` | AI agent loop with sandboxed execution and OpenProse skills | 1 | $2 |
40| [OpenRouter](https://registry.frames.ag/api/service/openrouter/skill.md) | `openrouter` | Text generation via 300+ models (OpenAI, Anthropic, Google, Meta, etc.) | 0 | free |
41| [Jupiter API](https://registry.frames.ag/api/service/jupiter/skill.md) | `jupiter` | Solana token swap, price, search, and portfolio via Jupiter | 4 | $0.002 - $0.01 |
42| [NEAR Intents API](https://registry.frames.ag/api/service/near-intents/skill.md) | `near-intents` | Cross-chain token swaps via 1Click deposit addresses | 1 | $0.01 |
43| [AgentMail API](https://registry.frames.ag/api/service/agentmail/skill.md) | `agentmail` | Email infrastructure for AI agents — create inboxes, send/receive emails, manage threads | 5 | $0.005 - $0.01 |
44| [CoinGecko API](https://registry.frames.ag/api/service/coingecko/skill.md) | `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 |
45
46## Service Endpoints
47
48Each service lives at `https://registry.frames.ag/api/service/{slug}` and exposes:
49
50| Endpoint | Description |
51|----------|-------------|
52| `GET /` | Service info |
53| `GET /health` | Health check |
54| `GET /docs` | Interactive API docs |
55| `GET /openapi.json` | OpenAPI 3.x spec |
56| `GET /skill.md` | Agent-friendly documentation |
57
58## Pricing Details
59
60### Twitter API (`twitter`)
61
62Base: `https://registry.frames.ag/api/service/twitter` | [Docs](https://registry.frames.ag/api/service/twitter/docs) | [OpenAPI](https://registry.frames.ag/api/service/twitter/openapi.json) | [Skill](https://registry.frames.ag/api/service/twitter/skill.md)
63
64| Endpoint | Price | Description |
65|----------|-------|-------------|
66| `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 |
67| `POST /api/user-tweets` | $0.01 | Fetch a user's recent tweets by username or user ID, with optional reply inclusion and cursor pagination |
68| `POST /api/user-followers` | $0.01 | List accounts following a user, paginated up to 200 per page with cursor-based navigation |
69| `POST /api/user-following` | $0.01 | List accounts a user follows, paginated up to 200 per page with cursor-based navigation |
70| `POST /api/verified-followers` | $0.01 | List only verified (blue-check) accounts following a user, by user ID with cursor pagination |
71| `POST /api/search-users` | $0.01 | Search for Twitter users by keyword — matches against names, bios, and usernames |
72| `POST /api/user-mentions` | $0.01 | Fetch tweets that @mention a user, with optional time range filtering (sinceTime/untilTime unix timestamps) |
73| `POST /api/check-follow` | $0.005 | Check whether one user follows another — returns the follow relationship between two usernames |
74| `POST /api/batch-users` | $0.02 | Fetch multiple user profiles in one request by comma-separated user IDs |
75| `POST /api/tweets-by-ids` | $0.01 | Fetch full tweet data for multiple tweets by comma-separated tweet IDs |
76| `POST /api/tweet-replies` | $0.01 | Get replies to a specific tweet, sortable by Relevance, Latest, or Likes with cursor pagination |
77| `POST /api/search-tweets` | $0.01 | Advanced tweet search with operators — supports from:, to:, has:media, date ranges, engagement filters, and boolean logic |
78| `POST /api/tweet-quotes` | $0.01 | Get all quote tweets of a specific tweet, with optional time range and reply inclusion filters |
79| `POST /api/tweet-retweeters` | $0.01 | List users who retweeted a specific tweet, with cursor pagination |
80| `POST /api/tweet-thread` | $0.01 | Retrieve the full conversation thread for a tweet — parent tweets and replies in context |
81| `POST /api/list-tweets` | $0.01 | Fetch tweets from a Twitter List by list ID, with optional time range and reply filters |
82| `POST /api/list-followers` | $0.01 | List users who follow a specific Twitter List, with cursor pagination |
83| `POST /api/list-members` | $0.01 | List all members of a Twitter List, with cursor pagination |
84| `POST /api/community-info` | $0.005 | Get a Twitter Community's metadata — name, description, member count, rules, and creation date |
85| `POST /api/community-members` | $0.01 | List members of a Twitter Community, with cursor pagination |
86| `POST /api/community-tweets` | $0.01 | Fetch tweets posted in a Twitter Community, with cursor pagination |
87| `POST /api/space-detail` | $0.005 | Get details about a Twitter Space — title, host, participants, schedule, and state (live/scheduled/ended) |
88| `POST /api/article` | $0.01 | Retrieve a long-form Twitter Article (Notes) by the tweet ID that contains it |
89| `POST /api/trends` | $0.01 | Get trending topics for a location by WOEID (1=Worldwide, 23424977=US, 2459115=NYC) |
90| `POST /api/invoke` | $0.01 | Search tweets (legacy — use /api/search-tweets instead) |
91| `POST /api/search` | $0.01 | Search tweets (legacy — use /api/search-tweets instead) |
92
93### AI Generation API (`ai-gen`)
94
95Base: `https://registry.frames.ag/api/service/ai-gen` | [Docs](https://registry.frames.ag/api/service/ai-gen/docs) | [OpenAPI](https://registry.frames.ag/api/service/ai-gen/openapi.json) | [Skill](https://registry.frames.ag/api/service/ai-gen/skill.md)
96
97| Endpoint | Price | Description |
98|----------|-------|-------------|
99| `POST /api/invoke` | $0.01 | Run AI model prediction (price varies by model) |
100
101### x402 Test Service (`test`)
102
103Base: `https://registry.frames.ag/api/service/test` | [Docs](https://registry.frames.ag/api/service/test/docs) | [OpenAPI](https://registry.frames.ag/api/service/test/openapi.json) | [Skill](https://registry.frames.ag/api/service/test/skill.md)
104
105| Endpoint | Price | Description |
106|----------|-------|-------------|
107| `POST /api/invoke` | $0.001 | Test x402 payment flow (Base Sepolia & Solana Devnet) |
108| `POST /api/echo` | $0.001 | Echo data with payment verification |
109
110### Exa API (`exa`)
111
112Base: `https://registry.frames.ag/api/service/exa` | [Docs](https://registry.frames.ag/api/service/exa/docs) | [OpenAPI](https://registry.frames.ag/api/service/exa/openapi.json) | [Skill](https://registry.frames.ag/api/service/exa/skill.md)
113
114| Endpoint | Price | Description |
115|----------|-------|-------------|
116| `POST /api/search` | $0.01 | Semantic web search |
117| `POST /api/find-similar` | $0.01 | Find similar pages |
118| `POST /api/contents` | $0.002 | Extract URL contents |
119| `POST /api/answer` | $0.01 | AI-powered answer |
120
121### Wordspace Agent (`wordspace`)
122
123Base: `https://registry.frames.ag/api/service/wordspace` | [Docs](https://registry.frames.ag/api/service/wordspace/docs) | [OpenAPI](https://registry.frames.ag/api/service/wordspace/openapi.json) | [Skill](https://registry.frames.ag/api/service/wordspace/skill.md)
124
125| Endpoint | Price | Description |
126|----------|-------|-------------|
127| `POST /api/invoke` | $2 | Run wordspace AI agent loop |
128
129### Jupiter API (`jupiter`)
130
131Base: `https://registry.frames.ag/api/service/jupiter` | [Docs](https://registry.frames.ag/api/service/jupiter/docs) | [OpenAPI](https://registry.frames.ag/api/service/jupiter/openapi.json) | [Skill](https://registry.frames.ag/api/service/jupiter/skill.md)
132
133| Endpoint | Price | Description |
134|----------|-------|-------------|
135| `POST /api/swap` | $0.01 | Get swap quote and unsigned transaction |
136| `POST /api/price` | $0.002 | Token price lookup |
137| `POST /api/tokens` | $0.002 | Token search and metadata |
138| `POST /api/portfolio` | $0.005 | Wallet portfolio positions |
139
140### NEAR Intents API (`near-intents`)
141
142Base: `https://registry.frames.ag/api/service/near-intents` | [Docs](https://registry.frames.ag/api/service/near-intents/docs) | [OpenAPI](https://registry.frames.ag/api/service/near-intents/openapi.json) | [Skill](https://registry.frames.ag/api/service/near-intents/skill.md)
143
144| Endpoint | Price | Description |
145|----------|-------|-------------|
146| `POST /api/quote` | $0.01 | Cross-chain swap quote and deposit address |
147
148### AgentMail API (`agentmail`)
149
150Base: `https://registry.frames.ag/api/service/agentmail` | [Docs](https://registry.frames.ag/api/service/agentmail/docs) | [OpenAPI](https://registry.frames.ag/api/service/agentmail/openapi.json) | [Skill](https://registry.frames.ag/api/service/agentmail/skill.md)
151
152| Endpoint | Price | Description |
153|----------|-------|-------------|
154| `POST /api/inbox/create` | $0.01 | Create a new email inbox for an AI agent |
155| `POST /api/send` | $0.01 | Send an email from an agent inbox |
156| `POST /api/messages` | $0.005 | List messages in an inbox |
157| `POST /api/message` | $0.005 | Get a specific message by ID |
158| `POST /api/threads` | $0.005 | List email threads in an inbox |
159
160### CoinGecko API (`coingecko`)
161
162Base: `https://registry.frames.ag/api/service/coingecko` | [Docs](https://registry.frames.ag/api/service/coingecko/docs) | [OpenAPI](https://registry.frames.ag/api/service/coingecko/openapi.json) | [Skill](https://registry.frames.ag/api/service/coingecko/skill.md)
163
164| Endpoint | Price | Description |
165|----------|-------|-------------|
166| `POST /api/price` | $0.002 | Get token prices in any fiat/crypto currency |
167| `POST /api/token-info` | $0.005 | Get detailed token information and market data |
168| `POST /api/trending` | $0.005 | Get currently trending tokens |
169| `POST /api/markets` | $0.005 | Get token market data with sorting and pagination |
170| `POST /api/search` | $0.003 | Search tokens by name or symbol |
171
172### AI Model Pricing (`ai-gen`)
173
174Price is set dynamically based on the `model` field in the request body.
175
176**Image Models:**
177
178| Model | Price |
179|-------|-------|
180| `flux/schnell` | $0.004/image |
181| `flux/2-pro` | $0.02 |
182| `flux/kontext-pro` | $0.05/image |
183| `bytedance/seedream-4` | $0.04/image |
184| `google/nano-banana` | $0.05/image |
185| `google/nano-banana-2` | $0.09/image (1K), $0.13/image (2K), $0.19/image (4K) |
186| `google/nano-banana-pro` | $0.18/image |
187| `google/imagen-4-fast` | $0.03/image |
188| `ideogram/v3-turbo` | $0.04/image |
189| `prunaai/z-image-turbo` | $0.006/image |
190| `prunaai/p-image` | $0.006/image |
191| `fofr/sdxl-emoji` | $0.01 |
192| `qwen/qwen-image-edit-2511` | $0.04/image |
193| `openai/dall-e-3` | $0.15/image |
194| `nightmareai/real-esrgan` | $0.003/image |
195
196**Video Models:**
197
198| Model | Price |
199|-------|-------|
200| `google/veo-3` | $0.48/sec (audio), $0.24/sec (no audio) |
201| `google/veo-3-fast` | $0.18/sec (audio), $0.12/sec (no audio) |
202| `google/veo-3.1` | $0.48/sec (audio), $0.24/sec (no audio) |
203| `google/veo-3.1-fast` | $0.18/sec (audio), $0.12/sec (no audio) |
204| `openai/sora-2` | $0.12/sec |
205| `openai/sora-2-pro` | $0.36/sec (720p), $0.60/sec (1080p) |
206| `kwaivgi/kling-v2.5-turbo-pro` | $0.09/sec |
207| `kwaivgi/kling-v2.6` | $0.09/sec |
208| `kwaivgi/kling-v2.6-motion-control` | $0.09/sec (std), $0.15/sec (pro) |
209| `bytedance/seedance-1-pro` | $0.04/sec (480p), $0.08/sec (720p), $0.18/sec (1080p) |
210| `bytedance/seedance-1-lite` | $0.03/sec (480p), $0.05/sec (720p), $0.09/sec (1080p) |
211| `bytedance/seedance-1-pro-fast` | $0.02/sec (480p), $0.03/sec (720p), $0.08/sec (1080p) |
212| `bytedance/seedance-1.5-pro` | $0.04/sec (720p), $0.07/sec (720p+audio) |
213| `minimax/video-01` | $0.60 |
214| `wan-video/wan-2.2-t2v-fast` | $0.12 |
215| `wan-video/wan-2.2-i2v-fast` | $0.07 |
216| `wan-video/wan-2.5-i2v-fast` | $0.09/sec (720p), $0.13/sec (1080p) |
217| `runwayml/gen4-turbo` | $0.06/sec |
218| `runwayml/gen4-aleph` | $0.22/sec |
219| `veed/fabric-1.0` | $0.10/sec (480p), $0.18/sec (768p) |
220| `shreejalmaharjan-27/tiktok-short-captions` | $0.002/sec |
221
222## Payment Protocol (x402)
223
224All paid endpoints use the [x402](https://www.x402.org/) payment protocol. No API keys needed.
225
226**Flow:**
227
2281. Call any paid endpoint without a payment header
2292. Receive `402 Payment Required` with a `PAYMENT-REQUIRED` header (Base64 JSON with price, network, payTo address)
2303. Sign a payment for the requested amount on your chosen network
2314. Retry the same request with the `PAYMENT-SIGNATURE` header
2325. Receive the response plus a `PAYMENT-RESPONSE` confirmation header
233
234Failed requests are automatically refunded.
235
236**Supported Networks:**
237
238| Network | ID | Type | Environment |
239|---------|----|------|-------------|
240| Base | `eip155:8453` | EVM | Mainnet |
241| Base Sepolia | `eip155:84532` | EVM | Testnet |
242| Solana | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` | Solana | Mainnet |
243| Solana Devnet | `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1` | Solana | Devnet |
244
245**Accepted Tokens:** USDC, USDT, CASH (availability varies by network)
246
247## Platform Endpoints (FREE)
248
249| Endpoint | Description |
250|----------|-------------|
251| `GET https://registry.frames.ag/api` | Platform info and version |
252| `GET https://registry.frames.ag/api/services` | List all services with metadata |
253| `GET https://registry.frames.ag/api/services/:slug` | Single service details |
254| `GET https://registry.frames.ag/api/pricing` | All pricing policies |
255| `GET https://registry.frames.ag/api/networks` | Supported payment networks |
256| `GET https://registry.frames.ag/api/health` | Health check |
257| `GET https://registry.frames.ag/api/packages` | Skill/agent package catalog |
258| `GET https://registry.frames.ag/api/packages/:slug/bundle` | Download package bundle |
259| `GET https://registry.frames.ag/.well-known/x402` | x402 discovery document |
260| `GET https://registry.frames.ag/docs` | Interactive docs (HTML) |
261
262## Agent Integration
263
264### With AgentWallet (recommended)
265
266[AgentWallet](https://frames.ag/skill.md) 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.
267
2681. Authenticate with AgentWallet (email OTP → API token)
2692. Fund your wallet with USDC on Base or Solana
2703. Call any Frames Registry endpoint through AgentWallet's proxy:
271
272```
273POST https://frames.ag/x402/fetch
274{
275 "url": "https://registry.frames.ag/api/service/twitter/api/search-tweets",
276 "method": "POST",
277 "body": { "query": "AI agents" }
278}
279```
280
281AgentWallet detects the 402 response, signs payment, and retries automatically.
282
283### Direct x402 (self-managed wallet)
284
285Requires an EVM or Solana wallet with USDC and the ability to sign EIP-3009 or SPL transfers.
286
2871. Make the request to the paid endpoint
2882. Parse the `PAYMENT-REQUIRED` header from the 402 response (Base64 JSON with price, network, payTo)
2893. Sign a payment authorization for the exact amount
2904. Retry with the `PAYMENT-SIGNATURE` header