Production API and agent contract

Use AetherQuant from your service or agent.

Account-scoped, read-only US-equity daily-bar snapshots from the IEX market-data feed. This page describes only the deployed, account-scoped API and the customer-installed MCP bridge.

Create a product API key in the signed-in dashboard. Keep it in a server or local-agent environment variable—never in browser code, a prompt, source control, or a shared configuration file.

Quick start

Sign in to your AetherQuant dashboard and create a product API key.
Store the key as PRODUCT_API_KEY in your local shell or server secret manager.
Call the account-scoped status endpoint before invoking a product workflow.

API basehttps://client-platform-rho.vercel.app/v1

export PRODUCT_API_KEY="replace-with-a-product-key"
curl -sS "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/status" -H "X-API-Key: $PRODUCT_API_KEY"

A key is product-scoped: it can access only its own product workspace and never another customer account. Missing or invalid keys return 401; invalid request input returns 422; an exhausted monthly quota returns 429.

Plan quota

Each plan uses the same account-scoped unit: completed read-only market-data snapshot requests per calendar month.

Plan	Monthly quota
Developer	1,000 completed read-only market-data snapshot requests per calendar month
Pro Dev Tier	100,000 completed read-only market-data snapshot requests per calendar month

A provider failure is not metered. A completed request may truthfully return no bars when the feed has no usable result. Usage is reported by the status endpoint and reset by the control plane's calendar-month usage window.

Supported API endpoints

All paths below are relative to https://client-platform-rho.vercel.app/v1 and require X-API-Key. The API returns JSON and creates only account-owned artifacts.

GET/products/aetherquant/api/status

Read the authenticated workspace's plan labels, monthly quota, usage, remaining quota, and current period boundary.

curl -sS "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/status" -H "X-API-Key: $PRODUCT_API_KEY"

GET/products/aetherquant/api/work-items?limit=20

List up to 100 workspace artifacts owned by the authenticated product key.

curl -sS "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/work-items?limit=20" -H "X-API-Key: $PRODUCT_API_KEY"

GET/products/aetherquant/api/work-items/{work_item_id}

Read one owned artifact and its immutable revision history.

curl -sS -X GET "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/work-items/{work_item_id}"   -H "X-API-Key: $PRODUCT_API_KEY"

Requires X-API-Key.

POST/products/aetherquant/api/work-items/{work_item_id}/versions

Save a complete new revision and return it to draft status.

curl -sS -X POST "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/work-items/{work_item_id}/versions"   -H "X-API-Key: $PRODUCT_API_KEY"   -H "Content-Type: application/json"   --data '{"title":"Revised artifact","payload":{"artifact":{}},"change_note":"Explain the revision"}'

Requires X-API-Key.
The payload is a complete replacement snapshot.

POST/products/aetherquant/api/work-items/{work_item_id}/submit-review

Move a draft into human review.

curl -sS -X POST "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/work-items/{work_item_id}/submit-review"   -H "X-API-Key: $PRODUCT_API_KEY"

Requires X-API-Key.

POST/products/aetherquant/api/work-items/{work_item_id}/approve

Approve an artifact already in review without publishing it.

curl -sS -X POST "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/work-items/{work_item_id}/approve"   -H "X-API-Key: $PRODUCT_API_KEY"   -H "Content-Type: application/json"   --data '{"confirmation":true}'

Requires X-API-Key.
Explicit confirmation is required.

POST/products/aetherquant/api/work-items/{work_item_id}/archive

Archive an artifact while retaining its version history.

curl -sS -X POST "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/work-items/{work_item_id}/archive"   -H "X-API-Key: $PRODUCT_API_KEY"   -H "Content-Type: application/json"   --data '{"confirmation":true}'

Requires X-API-Key.
Explicit confirmation is required.

GET/products/aetherquant/api/work-items/{work_item_id}/export

Return an account-scoped JSON export.

curl -sS -X GET "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/work-items/{work_item_id}/export"   -H "X-API-Key: $PRODUCT_API_KEY"

Requires X-API-Key.

POST/products/aetherquant/api/market-data

Fetch and save one account-owned, read-only IEX daily-bar snapshot.

curl -sS -X POST "https://client-platform-rho.vercel.app/v1/products/aetherquant/api/market-data"   -H "X-API-Key: $PRODUCT_API_KEY"   -H "Content-Type: application/json"   --data '{"ticker":"AAPL","limit":30}'

Requires X-API-Key.
Returns 201 only after a completed snapshot is retained.

Use the product from an MCP-compatible agent

The supported bridge is a local stdio process in services/customer-mcp. It calls the same production API with a key held only in its process environment.

{
  "mcpServers": {
    "aetherquant": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/automated-businesses/services/customer-mcp",
        "client-platform-mcp",
        "--product",
        "aetherquant"
      ],
      "env": {
        "CLIENT_PLATFORM_API_KEY": "replace-with-a-product-key"
      }
    }
  }
}

Run the configuration from a checked-out copy of this project. The bridge exposes one product selected by --product aetherquant; it does not expose checkout, billing, API-key creation, API-key revocation, or cross-product access as tools.

workspace_status

Read the configured workspace plan and current monthly usage.

list_workspace_artifacts

List saved workspace artifacts owned by the API key.

get_workspace_artifact

Read one owned artifact and its immutable version history.

create_workspace_artifact_version

Save a complete new revision in draft status.

submit_workspace_artifact_for_review

Submit a draft for human review without approving it.

approve_workspace_artifact

Approve a reviewed artifact only after explicit confirmation; never publish it.

archive_workspace_artifact

Archive an artifact after explicit confirmation while retaining its versions.

export_workspace_artifact

Return an account-scoped JSON export without an external side effect.

aetherquant_market_snapshot

Fetch a read-only IEX US-equity daily-bar snapshot.

Safety and operating boundaries

No brokerage account, order, position, portfolio, or trade endpoint is exposed.
Daily bars and derived research metrics are informational only and are not investment advice.
The API accepts a US-equity ticker and 1 through 100 daily bars.

Do not give an agent a Stripe credential, payment card, browser session, or API key in its prompt. The documented MCP bridge reads only the product API key from its local environment and returns only the product API response.