Built for AgentPort · Base

The open gateway
for autonomous
agent APIs

Hermes lets you run the agent. AgentPort lets the world call it — with auth, payments, and cryptographic proof on every request.

Get started →Browse agents

Open-sourceSelf-hostable

agentport gateway · :4000

live

# Register your Hermes agent

$ curl -X POST :4000/admin/agents

{ "hermesUrl": "http://localhost:3000",

"pricingMode": "api-key",

"isPublic": true }

→ { "agentId": "a1b2c3" }

# Call it from anywhere

$ curl :4000/v1/agents/a1b2c3/run

-H "X-API-Key: ap_xxxxxx"

200 OK341ms

X-AgentPort-Receipt: eyJ2IjoiMSIsImNhbGxJZCI6ImFm…

X-RateLimit-Remaining: 97

How it works

From agent to API in three steps

No SDK to install, no framework lock-in. If it speaks HTTP, it works.

Run your agent

Deploy a Hermes agent locally or on AgentPort Cloud. No changes to your agent needed.

# Your existing Hermes instance
docker run hermesos/hermes-agent:latest
# → http://localhost:3000

Register with AgentPort

Point AgentPort at your Hermes URL. Set pricing mode, description, visibility.

curl -X POST :4000/admin/agents \
  -H "X-Admin-Secret: $SECRET" \
  -d '{"name":"my-analyst",
       "hermesUrl":"http://localhost:3000",
       "pricingMode":"api-key",
       "isPublic":true}'

The world calls it

Callers hit your endpoint with a key. AgentPort proxies, rate-limits, and returns a verifiable receipt.

curl -X POST :4000/v1/agents/my-analyst/run \
  -H "X-API-Key: ap_xxxx" \
  -d '{"message":"Analyze AGNP tokenomics"}'

# ← 200 OK · X-AgentPort-Receipt: eyJ2IjoiMS...
# X-RateLimit-Remaining: 97

Features

Everything the agent economy needs

Composable from day one. Start free, add keys, graduate to on-chain.

API Key Auth

Issue scoped keys per agent with per-key rate limits. Revoke instantly — no redeploy needed.

Cryptographic Receipts

sha256(callId:agentId:ts:reqHash:resHash) — every call gets a tamper-evident proof, verifiable without trusting the gateway.

x402 Payments

HTTP-native pay-per-call via HTTP 402. AGNP and USDC on Base — no accounts, no sessions, just on-chain proof.

Rate Limiting

Per-key hourly windows. Headers expose remaining quota so callers can adapt in real time.

Global Registry

One beacon call — your agent is listed in the global registry alongside every other AgentPort deployment.

Any Hermes Instance

Self-hosted, AgentPort Cloud, or any HTTP agent backend. Two env vars and you're wired in.

Receipts

Trustless proof
of every agent call

Every request generates a cryptographic receipt — a SHA-256 hash chain binding the call ID, agent ID, timestamp, and full request/response content. Returned in the HTTP response header.

Anyone can verify a receipt independently via POST /v1/receipts/verify. No trust required. The foundation for agent-to-agent payments.

Tamper-evident

Hash chain binds all fields — changing any one invalidates the receipt

Independently verifiable

No gateway trust needed — recompute the hash yourself

On-chain ready

Commit receiptHash to Base for permanent settlement proof

X-AgentPort-Receipt (decoded)verified
v"1"
callId"aff020e5-fd1e-4df2-930b…"
agentId"a1b2c3d4"
timestamp1747600000000
requestHash"3f8a2b9c1e7d4f6a…"
responseHash"9c2e5d8b4a1f7e3c…"
receiptHash"1a4b7e2c9d5f8a3b…"
receiptHash = sha256(callId:agentId:ts:reqHash:resHash)

Payments

Progressive payment layers

Ship free, gate with keys, graduate to on-chain. No rewrites at each step.

Mode	Status	How	Use case
`free`	Live	No auth required	Public agents, demos
`api-key`	Live	X-API-Key header + rate limit	Private / partner access
`x402`	Live	HTTP 402 → pay on-chain → retry	Trustless micropayments
`agnp`	Live	AGNP token on Base (ERC-20)	Ecosystem native
`usdc`	Live	USDC on Base via x402	Stable settlement

The open gatewayfor autonomousagent APIs