v1.0MITSolanax402

Documentation

Everything you need to monetize your API or connect your AI agent to paid services.

Metera is MIT licensed. The npm packages are free forever. The hosted platform at metera.xyz is the commercial offering.

What is Metera?

Metera is the economic layer for AI agents.

If you have an API, Metera lets AI agents pay you automatically in USDC on Solana.

If you have an AI agent, Metera gives it a wallet, spending limits, and access to hundreds of paid APIs — with one line of code.

No banks. No credit cards. No humans in the loop.

How it works

For API owners

1
Register your API
Paste your URL · Set a price
2
Get your public endpoint
api.metera.xyz/p/your-api
3
Agents call your API
Metera charges automatically. USDC lands in your wallet.

For AI agents

1
Create an agent wallet
Wallet created automatically · Deposit via Pix or card
2
Connect to your agent
Read metera.xyz/skill/your-key
3
Your agent pays automatically
Detects x402, pays in USDC, retries — zero extra code.

Register your API

No code required. Go to metera.xyz/proxy, paste your API URL and set a price. Metera generates a public endpoint instantly.

example
# Your API URL:
https://your-api.com/weather
 
# Metera endpoint:
https://api.metera.xyz/p/weather-api

How agents pay

When an agent calls your endpoint without payment, Metera returns HTTP 402 with payment instructions. The agent pays in USDC on Solana in ~400ms. Metera verifies the payment on-chain and proxies the request to your original API.

You receive 100% of the payment directly in your Solana wallet. No custody. No intermediary.

Pricing

FreeUp to 3 endpoints · 0% fee
ProUnlimited endpoints · $99/month · 0% fee
Enterprise0.5% of volume · white-label · SLA

Create an agent wallet

1
Go to metera.xyz/agents
Sign in with GitHub.
2
Click "Create agent wallet"
A Solana wallet is created automatically. No seed phrase. No private key setup. No crypto knowledge needed.

Deposit USDC

1
Click "Deposit" on your agent wallet
Pay with Pix or credit card via MoonPay.
2
USDC arrives in your wallet in minutes
No crypto knowledge required.

Connect to your AI agent

Copy your skill URL from the dashboard and paste it in Claude Code, Cursor, or any MCP-compatible client:

bash
Read https://metera.xyz/skill/your-agent-key and follow the instructions

Your agent now knows:

Which wallet to use
How to pay for APIs automatically
What your spending limits are
Which APIs are available in the marketplace

Spending limits

Protect your agent from unexpected costs. Set limits per call, per hour, per day or per month.

Max per call$0.01Never pay more than this per request
Max per day$1.00Daily budget cap
Max per month$10.00Monthly budget cap

Discover paid APIs

The Metera Marketplace lists all APIs available for AI agents to consume. Browse by category: data, AI, media, finance. Each API shows price, uptime, latency and total calls.

Browse the marketplace at metera.xyz/marketplace

List your API

Any API registered as a hosted endpoint appears automatically in the marketplace when marked as public. Agents across the network discover and pay your API autonomously — no signup flow, no API keys, no billing setup.

Weather dataUSDC on SolanaCurrency ratesx402 protocolIP geolocationSemantic searchCrypto pricesAI inferencePublic holidaysNews feedWeather dataUSDC on SolanaCurrency ratesx402 protocolIP geolocationSemantic searchCrypto pricesAI inferencePublic holidaysNews feed
0% feeInstant settlement~400ms paymentsNo credit cardOn-chain verifiedNo custodyMIT licensedAgent-nativeREST + JSONAuto-discovery0% feeInstant settlement~400ms paymentsNo credit cardOn-chain verifiedNo custodyMIT licensedAgent-nativeREST + JSONAuto-discovery
Claude CodeCursorOpenCodeGPT agentsCustom MCPSolana mainnetskill.mdHTTP 402USDC stablecoinHelius verifiedClaude CodeCursorOpenCodeGPT agentsCustom MCPSolana mainnetskill.mdHTTP 402USDC stablecoinHelius verified
No signup flow
Agents pay in real time with no account, no subscription and no human approval. Any autonomous caller can use your API.
0% platform fee
You set the price per call and receive USDC directly to your Solana wallet. Metera takes nothing from your revenue.
Instant settlement
USDC lands in your wallet in ~400ms per call. No invoice cycles, no payout delays, no bank in the middle.
Agent discovery
Your API appears in every connected agent's skill.md automatically, and is queryable at api.metera.xyz/api/marketplace.

What is x402?

x402 is an open HTTP standard for machine-to-machine payments. When a server returns HTTP 402, it means: "This resource costs money. Here is how to pay."

The x402 Foundation — backed by Google, Microsoft, Stripe, Coinbase and Cloudflare — defines the standard. Metera is the implementation.

How the payment flow works

payment flow
$ Agent calls API
→ API returns HTTP 402 with payment details
→ Agent signs a USDC transaction on Solana
→ Sends payment proof in the next request header
→ API verifies payment on-chain
→ Returns the response
 
# This happens in ~400ms. No human involved. No checkout. No invoice.

Security

Anti-replay protection

Every transaction hash can only be used once. Replay attacks are blocked at the network level.

On-chain verification

Every payment is verified on the Solana blockchain before any data is returned.

Spending limits

Hard caps enforced server-side. No agent can exceed the limits you set.

Non-custodial

Metera never holds your funds. Payments go directly wallet-to-wallet on-chain.

FAQ