Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Harpd Agent Market Payments API
version: '2026-08-27'
description: Public machine discovery and free Harpd Rank resources. Paid machine access is disabled by default and requires an explicitly configured testnet or production payment mode.
x-guidance: 'For autonomous agents: call GET /api/agent/v1/rankings or /api/agent/v1/products/{slug} (free) to inspect Harpd Rank data. The paid GET /api/agent/v1/premium/rank-intelligence returns full Rank Intelligence (positions, movement, history, category summaries, #100 threshold) for 0.1 USDC on Base mainnet via x402, with no API key; the agent signs and settles USDC itself. Machine entry point: /.well-known/agent.json'
contact:
name: Harpd Support
email: harpdsupport@gmail.com
servers:
- url: https://api.harpd.com
tags:
- name: Payments
paths:
/v1/payments/config:
get:
operationId: getPaymentConfig
security: []
responses:
'200':
description: Public payment configuration
tags:
- Payments
summary: Get payment config
x-summary-source: derived
/v1/payments/health:
get:
operationId: getPaymentHealth
security: []
responses:
'200':
description: Non-sensitive payment health
tags:
- Payments
summary: Get payment health
x-summary-source: derived