Octodamus Agent Purchases API
The Agent Purchases API from Octodamus — 8 operation(s) for agent purchases.
The Agent Purchases API from Octodamus — 8 operation(s) for agent purchases.
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-purchases-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 Purchases 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 Purchases
paths:
/v1/guide:
get:
tags:
- Agent Purchases
summary: Agent Buy Guide
description: '**Buy the Build the House guide — $29 USDC on Base.**
AI agents: hit this endpoint with no payment to get the 402 payment instructions.
Send `PAYMENT-SIGNATURE` header with your signed EIP-3009 authorization to receive
the guide download URL instantly.
Returns: `{"download_url": "...", "expires": "30 days", "product": "guide"}`'
operationId: agent_buy_guide_v1_guide_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v1/subscribe:
get:
tags:
- Agent Purchases
summary: Agent Buy Premium
description: '**Subscribe to OctoData Premium API on Base via x402.**
- `plan=trial` — $5 USDC, 7 days, 10k req/day
- `plan=annual` — $29 USDC, 365 days, 10k req/day (first 100 seats; $149 after)
AI agents: hit with no payment to get 402 instructions. Send `PAYMENT-SIGNATURE`
header with signed EIP-3009 authorization to receive your API key instantly.
Returns: `{"api_key": "octo_...", "tier": "premium", "expires_days": N}`'
operationId: agent_buy_premium_v1_subscribe_get
parameters:
- name: plan
in: query
required: false
schema:
type: string
description: '''trial'' ($5, 7 days) or ''annual'' ($29, 365 days)'
default: annual
title: Plan
description: '''trial'' ($5, 7 days) or ''annual'' ($29, 365 days)'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v2/guide/derivatives:
get:
tags:
- Agent Purchases
summary: Buy Derivatives Guide
description: '5 Derivatives Signals Every Crypto Trader Must Know — $3 USDC on Base.
Pay via x402 EIP-3009 USDC authorization. Returns PDF directly on payment.
No account, no subscription, no API key required.'
operationId: buy_derivatives_guide_v2_guide_derivatives_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'402':
description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
security:
- x402Payment: []
parameters:
- name: asset
in: query
required: false
schema:
type: string
enum:
- BTC
- ETH
- SOL
default: BTC
description: Optional asset focus (BTC, ETH, or SOL). Endpoints return full market coverage; this scopes the primary asset.
x-payment-info:
protocols:
- x402
price:
mode: fixed
currency: USD
amount: '3.00'
network: base
asset: USDC
payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
/v2/grok/brief/preview:
get:
tags:
- Agent Purchases
summary: Grok Brief Preview
description: 'Free Grok-annotated brief teaser -- no key, no payment.
Deliberately citable: an assistant answering "what''s the oracle read on BTC?"
should be able to quote the bias, whether the live X crowd agrees, and one
falsifier. The critique, blind spot and remaining falsifiers are the paid half.'
operationId: grok_brief_preview_v2_grok_brief_preview_get
parameters:
- name: asset
in: query
required: false
schema:
type: string
description: BTC, ETH, SOL, NVDA, TSLA, COIN, MSTR
default: BTC
title: Asset
description: BTC, ETH, SOL, NVDA, TSLA, COIN, MSTR
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v2/grok/brief:
get:
tags:
- Agent Purchases
summary: Grok Brief
description: 'Grok-annotated market brief -- $0.10 USDC on Base via x402.
Octodamus feeds make the call; Grok attacks it and returns the concrete
conditions that would prove it wrong. Refuses service (503, unpaid) when the
Grok layer is not live -- the adversarial half IS the product, so serving a
signal-only brief would be selling something else under the same name.'
operationId: grok_brief_v2_grok_brief_get
parameters:
- name: asset
in: query
required: false
schema:
type: string
description: BTC, ETH, SOL, NVDA, TSLA, COIN, MSTR
default: BTC
title: Asset
description: BTC, ETH, SOL, NVDA, TSLA, COIN, MSTR
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'402':
description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
security:
- x402Payment: []
x-payment-info:
protocols:
- x402
price:
mode: fixed
currency: USD
amount: '0.10'
network: base
asset: USDC
payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
/v2/guide/grok-desk/preview:
get:
tags:
- Agent Purchases
summary: Grok Desk Guide Preview
description: Free chapter 1 of the Grok research-desk guide -- the whole teaser.
operationId: grok_desk_guide_preview_v2_guide_grok_desk_preview_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/guide/grok-desk:
get:
tags:
- Agent Purchases
summary: Buy Grok Desk Guide
description: 'Grok + Octodamus: The Agent Research Desk -- $3 USDC on Base via x402.
Returns the full markdown guide on payment. No account, no API key.'
operationId: buy_grok_desk_guide_v2_guide_grok_desk_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'402':
description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
security:
- x402Payment: []
parameters:
- name: asset
in: query
required: false
schema:
type: string
enum:
- BTC
- ETH
- SOL
default: BTC
description: Optional asset focus (BTC, ETH, or SOL). Endpoints return full market coverage; this scopes the primary asset.
x-payment-info:
protocols:
- x402
price:
mode: fixed
currency: USD
amount: '3.00'
network: base
asset: USDC
payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
/v2/guide/derivatives/preview:
get:
tags:
- Agent Purchases
summary: Derivatives Guide Preview
description: Free preview of the derivatives guide — introduction and Signal 1 only.
operationId: derivatives_guide_preview_v2_guide_derivatives_preview_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
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