registry

What this skill does

# 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](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.
- **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](https://frames.ag/skill.md) 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](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 |
| [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 |
| [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 |
| [Exa API](https://registry.frames.ag/api/service/exa/skill.md) | `exa` | Semantic web search via Exa | 4 | $0.002 - $0.01 |
| [Wordspace Agent](https://registry.frames.ag/api/service/wordspace/skill.md) | `wordspace` | AI agent loop with sandboxed execution and OpenProse skills | 1 | $2 |
| [OpenRouter](https://registry.frames.ag/api/service/openrouter/skill.md) | `openrouter` | Text generation via 300+ models (OpenAI, Anthropic, Google, Meta, etc.) | 0 | free |
| [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 |
| [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 |
| [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 |
| [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 |

## 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](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)

| 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](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)

| 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](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)

| Endpoint | Price | Description |
|----------|-------|-------------|
| `POST /api/invoke` | $0.001 | Test x402 payme