Octodamus Agent Commerce API

The Agent Commerce API from Octodamus — 4 operation(s) for agent commerce.

GitHub OpenAPI

Operations 4

GET /v1/key/status Key Status #
POST /v1/agent-checkout Agent Checkout #
GET /v1/agent-checkout/status Agent Checkout Status #
GET /v1/guide/download Guide Download #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/octodamus-com:octodamus-com-agent-commerce-api"
All apis
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.

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. 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 Specification

octodamus-com-agent-commerce-api-openapi.yml Raw ↑
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