Octodamus Agent Commerce API
The Agent Commerce API from Octodamus — 4 operation(s) for agent commerce.
The Agent Commerce API from Octodamus — 4 operation(s) for agent commerce.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/octodamus-com:octodamus-com-agent-commerce-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: OctoData Agent Commerce API
description: AI-powered market intelligence by Octodamus (@octodamusai)
contact:
name: Octodamus
url: https://octodamus.com/
email: octodamusai@gmail.com
version: 3.0.0
security: []
tags:
- name: Agent Commerce
paths:
/v1/key/status:
get:
tags:
- Agent Commerce
summary: Key Status
description: '**Check API key status, tier, expiry, and renewal instructions.**
AI agents can poll this to self-renew before expiry — no human required.
```json
{
"status": "active",
"tier": "premium",
"expires": "2027-04-08T00:00:00",
"days_remaining": 365,
"renew": {
"instructions": "POST /v1/agent-checkout?product=premium_annual&agent_wallet=0xYOUR",
"price_usdc": 29,
"network": "base-mainnet"
}
}
```'
operationId: key_status_v1_key_status_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v1/agent-checkout:
post:
tags:
- Agent Commerce
summary: Agent Checkout
description: '**Crypto checkout — Base USDC, Ethereum USDC, or Bitcoin.**
Flow:
1. POST /v1/agent-checkout?product=premium_annual&chain=base&agent_wallet=0x...
2. Send exact amount to payment_address on the specified chain
3. Poll GET /v1/agent-checkout/status?payment_id=xxx every 15s
4. Receive api_key or download_url when confirmed
Chains: `base` (USDC, ~2s confirm) | `eth` (USDC, ~15s confirm) | `btc` (~10min confirm)
Products:
- `premium_trial` — $5 — 7-day Premium trial, 10k req/day
- `premium_annual` — $29 — Premium API key, 10k req/day, no expiry
- `guide_early` — $29 — Build The House guide download
- `guide_standard` — $39 — Build The House guide download'
operationId: agent_checkout_v1_agent_checkout_post
parameters:
- name: product
in: query
required: true
schema:
type: string
description: premium_trial | premium_annual | guide_early | guide_standard
title: Product
description: premium_trial | premium_annual | guide_early | guide_standard
- name: agent_wallet
in: query
required: false
schema:
type: string
description: Your wallet address (optional but recommended for faster matching)
default: ''
title: Agent Wallet
description: Your wallet address (optional but recommended for faster matching)
- name: label
in: query
required: false
schema:
type: string
description: Agent or project name
default: ''
title: Label
description: Agent or project name
- name: email
in: query
required: false
schema:
type: string
description: Email for key delivery (optional)
default: ''
title: Email
description: Email for key delivery (optional)
- name: chain
in: query
required: false
schema:
type: string
description: 'Payment chain: base | eth | btc'
default: base
title: Chain
description: 'Payment chain: base | eth | btc'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/agent-checkout/status:
get:
tags:
- Agent Commerce
summary: Agent Checkout Status
description: 'Poll payment status. When status = ''fulfilled'', your api_key is in the response.
Poll every 15 seconds after sending USDC. Base confirms in ~2 seconds.
Times out after 1 hour — create a new intent if expired.'
operationId: agent_checkout_status_v1_agent_checkout_status_get
parameters:
- name: payment_id
in: query
required: true
schema:
type: string
description: payment_id from /v1/agent-checkout
title: Payment Id
description: payment_id from /v1/agent-checkout
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/guide/download:
get:
tags:
- Agent Commerce
summary: Guide Download
description: Validate guide download token and return signed download link.
operationId: guide_download_v1_guide_download_get
parameters:
- name: token
in: query
required: true
schema:
type: string
description: Download token from fulfilled guide payment
title: Token
description: Download token from fulfilled guide payment
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
x402Payment:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 pay-per-call on Base. Sign an EIP-3009 USDC authorization and send as this header. No signup required. See api.octodamus.com/v2/demo for a free preview.
ApiKeyAuth:
type: apiKey
in: header
name: X-OctoData-Key
description: Annual API key from api.octodamus.com/v1/signup (free Basic tier available).
x-discovery:
protocols:
- x402
network: base