# Metera — Agent Readable Spec

## Identity

Name: Metera
Homepage: https://metera.xyz
API base: https://api.metera.xyz
Canonical instructions: https://metera.xyz/AGENTS.md
Agent wallet skill (per agent): https://api.metera.xyz/skill/:agentKey
Marketplace JSON: https://api.metera.xyz/api/marketplace

## Purpose

Let any API charge AI agents automatically in USDC on Solana.
Let any AI agent pay for APIs autonomously via the x402 protocol.
Zero humans in the loop. Zero KYC. Zero bank accounts.

## Definition

Metera is billing infrastructure built on the x402 protocol (HTTP 402 Payment Required) on Solana. It has two sides:

Providers register any API URL, set a price per call in USDC, and receive a public proxy endpoint. Metera handles payment verification on-chain before forwarding the request.

Agents get a Solana wallet with configurable spending limits. They pay for any API in the marketplace with one HTTP call. Spending limits are enforced on-chain via Squads Protocol v4 for Starter, Pro, and Enterprise plans.

## How to join as an agent

1. Go to https://metera.xyz/agents
2. Create an agent wallet (one click, Solana wallet via Privy)
3. Deposit USDC via Pix (Brazil) or transfer directly on Solana
4. Read https://api.metera.xyz/skill/YOUR_AGENT_KEY
5. Follow the instructions in the skill file

## How to join as a provider

1. Go to https://metera.xyz/proxy
2. Register your API URL and set a price per call in USDC
3. Receive https://api.metera.xyz/p/your-slug
4. Get paid in USDC on every call, directly to your Solana wallet

## Agent connection rule

FIRST: check if METERA_AGENT_KEY exists in environment.

If it exists:
  Read https://api.metera.xyz/skill/{METERA_AGENT_KEY}
  Follow the instructions there.
  The agent is already connected.

If it does not exist:
  Tell the human: "Go to metera.xyz/agents, create an agent wallet, and share your agent key with me."
  Wait for the agent key before proceeding.

## x402 payment flow

Recommended method — one-step proxy:

POST https://api.metera.xyz/agent/{agentKey}/fetch
Content-Type: application/json

{
  "url": "https://api.metera.xyz/p/weather-api",
  "method": "GET"
}

The server handles payment verification on-chain and returns:
{
  "success": true,
  "response": { "status": 200, "body": {} },
  "payment": {
    "amount": "0.001",
    "token": "USDC",
    "chain": "solana",
    "txHash": "..."
  },
  "paid": true
}

## Spending tiers

Tier 1 (auto): amount <= maxPerCall — executes immediately, enforced on-chain by Squads.
Tier 2 (verify): rate check and pattern detection — soft block on anomalies.
Tier 3 (human): amount > tier3Threshold — held pending human approval.

## Marketplace

Browse all available APIs:
GET https://api.metera.xyz/api/marketplace

Response includes: name, slug, description, category, pricePerCall (USDC), totalCalls, uptimePercent, avgLatencyMs

## Technical metadata

{
  "name": "metera",
  "version": "1.0.0",
  "description": "Billing infrastructure for AI agents on Solana. x402 protocol. USDC settlement.",
  "homepage": "https://metera.xyz",
  "x402": {
    "supported": true,
    "chains": ["solana"],
    "tokens": ["USDC"],
    "proxyEndpoint": "https://api.metera.xyz/p/{slug}",
    "agentEndpoint": "https://api.metera.xyz/agent/{agentKey}/fetch"
  },
  "marketplace": {
    "endpoint": "https://api.metera.xyz/api/marketplace",
    "registration": "https://metera.xyz/proxy"
  }
}