For AI agents
Give your agent USDC and a MultiversX key. It finds CoRelayer, picks a plan, pays in USDC and starts sending. No account and no dashboard. Its plan covers the network fee.
Read https://co-relayer.com/llms.txt and set up gasless MultiversX transactions with CoRelayer.01 · Why agents
Your agent pays in USDC. Its plan covers the network fee on every transaction we send for it.
Buy over HTTP 402, or sign the purchase itself. No account, no card, no person.
The price ceilings your agent signs are enforced by the contract, not by us.
Agent Metered has no monthly fee. Pay per transaction from the USDC you deposit.
02 · Start to finish
Paths and fields come from the OpenAPI document. Your agent can read all of it first.
# buy a plan, no account POST /v1/x402/purchase 402 Payment Required PAYMENT-SIGNATURE: USDC, signed once 200 OK · plan active # send a transaction POST /v1/relay 200 OK · fee covered by the plan
Three files on this site, no key needed. They say what it costs, which chain it’s on and where the contract lives. Pin the chain id before you sign anything.
# 1. discover: three files, no key needed
GET /llms.txt
GET /pricing.json
GET /.well-known/corelayer.json
# -> prices, chain id, contract address, API hostPlans and prices come back as data, so your agent can pick a plan for its own traffic. A quote gives the exact amount and the ceiling to sign.
# 2. price
GET {apiBase}/v1/pricing
# -> { tiers, tariff, relayUnit }
# the plan quote
POST {apiBase}/v1/subscribe/prepare
{ address, tierId, months, payWith, gasless }
# -> { quote: { quoteId, maxPrice }, transaction }
# the price of one transaction
POST {apiBase}/v1/quote
{ tx }
# -> { ru, priceMicroUsdc }Inside an HTTP 402 exchange, or by signing the contract call yourself. Same purchase, same price, either way. No account to create.
# 3. pay: over x402, or sign the call yourself
POST {apiBase}/v1/x402/purchase
{ tierId, months, payer }
# -> 402 Payment Required names the payment
# or sign the transaction that /v1/subscribe/prepare returns
# and relay it (step 4)Ask for a relayer, put its address in the transaction, sign once and submit. Running many agents? Add your platform’s sponsor key (X-Api-Key) and your account pays for all of them.
# 4. relay: assign, sign once, submit
POST {apiBase}/v1/relay/assign
{ sender, proof }
# -> { relayer, shard, lease }
# set tx.relayer, then sign the transaction ONE time
POST {apiBase}/v1/relay
{ tx, lease, intentKey }
# -> { intentId, txHash, relayer, state }
# the authoritative status of that nonce
GET {apiBase}/v1/intents/{sender}/{nonce}
# many agents: add header X-Api-Key (your sponsor key){apiBase} is https://api.co-relayer.com. Read it from /.well-known/corelayer.json rather than hard-coding it.
import { relayOnce } from '@corelayer/sdk';
type Opts = Parameters<typeof relayOnce>[0];
// The agent's own key: its address and the two things it signs.
type AgentKey = Pick<Opts, 'sender' | 'signProof' | 'signOnce'>;
// The client, the transaction builder and one key per action.
type Job = Pick<Opts, 'client' | 'buildTransaction' | 'intentKey'>;
// Your agent signs once, with its own key. Its plan covers the fee.
export function relayAsAgent(agent: AgentKey, job: Job) {
return relayOnce({ ...job, ...agent });
}03 · Who pays
Every agent plan. Its own account, plus named wallets with no fee: 1 on Agent Metered, 25 on Agent Pro and 1,000 on Agent Fleet; more at 5 credits each, up to 10,000 per account.
proof.kind "key"
Agent Pro and Agent Fleet. One sponsor key on your server covers any agent address, within the contracts you allow and an optional daily limit per agent.
X-Api-Key
04 · Plans
For one agent getting started
No monthly fee
$0.015 per transaction
Pay per transaction from the USDC you deposit
For platforms running many agents
$85 per 30 days
$0.0085 per transaction
10,000 transactions included, then $0.012 each with pay-as-you-go
For fleets of agents and devices
$650 per 30 days
$0.0065 per transaction
100,000 transactions included, then $0.011 each with pay-as-you-go
05 · Spending limits
Let your agent spend without asking, and never more than you allowed.
max_pricemax_renew_pricemax_payg_pricepay-as-you-go budgetEach limit is part of the transaction your agent signs, so the contract enforces it.
06 · Integrations
Buy a plan or top up credits inside an HTTP 402 exchange.
Read prices, network status, relayers and your quota as MCP tools.
TypeScript, Go, Rust and Python, with one-signature relaying built in.
Already on another agent relayer kit? Change one base URL.
07 · Errors
Every error comes back with a stable code and says whether to retry.
08 · FAQ
No. Its wallet is its account.
$0.015 on Agent Metered, less on a plan.
No. It can spend only the USDC it deposited, and you can sign a per-transaction ceiling (max_payg_price).
Yes. A sponsor key on Agent Pro or Agent Fleet pays for any agent you run.
How sponsoring works →It pins the chain id and contract address from /.well-known/corelayer.json. The SDKs can check each relayer against the on-chain list before signing: pass verifyRelayer.
Discovery for agents →Get started
Connect a MultiversX wallet and pay a plan in USDC. Buying your plan is already a gasless transaction.
Or point your agent at https://co-relayer.com/llms.txt
Questions? support@co-relayer.com