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