Signal API Docs — Mecker Capital

01 / Getting Started

All data provided by this API is for informational and educational purposes. It does not constitute financial advice.

Every call hits a single base URL. Authenticate with either an API key (for subscribers) or x402 micropayments (for AI agents paying per call).

Base URL

https://api.meckercapital.com

First call

curl -H "Authorization: Bearer sk-YOUR_KEY" \
  https://api.meckercapital.com/v1/pairs/tradeable?min_regime=green

02 / Authentication

API Key

For developers. Subscribe to a plan, generate a key from the dashboard, pass it as a Bearer token.

Authorization: Bearer sk-YOUR_KEY

x402 Micropayments

For AI agents. Pay-per-call with USDC on Base L2. No account, no subscription. Each endpoint advertises its price in the 402 response.

See per-endpoint prices in section 03.

03 / Endpoints

Free

No auth required. Useful for agent discovery.

GET /v1/strategy/description

Plain-text summary of the strategy, methodology, and asset universe.

GET /v1/strategy/pair_count

Number of cointegrated pairs currently tracked by the engine.

Standard

Available on Developer and Pro plans, or pay-per-call via x402.

GET /v1/pairs/tradeable x402 $0.10

List cointegrated pairs with regime, z-score, and signal direction.

min_regime string: Filter threshold: GREEN, YELLOW, or RED. Defaults to YELLOW.

GET /v1/pairs/{pair_key}/evaluate x402 $0.10

Full pair evaluation: regime, z-score, signal, backtest summary, tradeable recommendation.

pair_key string required: Path param. Pair identifier, e.g. "SOL-AVAX".

GET /v1/signals/{pair_key} x402 $0.05

Current z-score, mean-reversion direction (LONG_SPREAD / SHORT_SPREAD / FLAT), and regime.

pair_key string required: Path param.

GET /v1/pairs/{pair_key}/backtest x402 $0.10

Historical performance for the pair: total return, Sharpe, max DD, win rate, trade count.

pair_key string required: Path param.

Premium

Available on Pro plans, or pay-per-call via x402.

POST /v1/premium/signals/entry_params x402 $0.50

Compute market-neutral entry sizing for a pair with an active signal.

pair_key string required: Pair identifier.
equity_usd number required: Your account equity in USD.
max_leverage number required: Max leverage you accept (e.g. 5 for 5x).
max_notional_usd number: Optional cap on gross notional.

GET /v1/premium/signals/{pair_key}/exit x402 $0.25

EXIT or HOLD recommendation with reasoning, confidence, and estimated PnL.

pair_key string required: Path param.
bars_held number required: How many hourly bars the position has been held.

POST /v1/premium/risk/check x402 $0.25

Validate a portfolio against exposure, per-pair, single-asset, and cross-pair conflict limits.

positions array required: Array of open position objects.
equity_usd number required: Total account equity.

GET /v1/premium/opportunities x402 $3.00

Top pairs ranked by signal strength (absolute z-score). Includes GREEN and YELLOW regimes.

max_pairs number: Max results to return. Defaults to 10.

04 / Code Examples

Entry sizing — basic

You control leverage and notional. The API computes leg sizes from the hedge ratio.

curl -X POST -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pair_key": "LTC-AVAX", "equity_usd": 10000, "max_leverage": 5.0}' \
  https://api.meckercapital.com/v1/premium/signals/entry_params

Entry sizing — with notional cap

# 10x leverage but capped at $50k gross
curl -X POST -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pair_key": "LTC-AVAX", "equity_usd": 10000, "max_leverage": 10.0, "max_notional_usd": 50000}' \
  https://api.meckercapital.com/v1/premium/signals/entry_params

Python

import requests

r = requests.get(
    "https://api.meckercapital.com/v1/pairs/tradeable",
    headers={"Authorization": "Bearer sk-YOUR_KEY"},
    params={"min_regime": "green"},
)
r.raise_for_status()
for pair in r.json()["data"]:
    print(pair["pair_key"], pair["signal"], pair["z_score"])

05 / MCP Integration

Claude Desktop, Cursor, and other MCP-aware agents can call the Signal API directly. Point the MCP client at the SSE endpoint below.

MCP Endpoint

https://api.meckercapital.com/mcp/sse

Claude Desktop config

// claude_desktop_config.json
{
  "mcpServers": {
    "accordion": {
      "url": "https://api.meckercapital.com/mcp/sse"
    }
  }
}

06 / Rate Limits

Plan	Calls / minute	Access
Free	10	Free endpoints + public performance data
Starter	60	Standard endpoints + MCP
Pro	300	Standard + Premium + MCP + early access
x402	Unlimited	All endpoints, pay-per-call

Exceeding the per-minute cap returns 429 Too Many Requests with a Retry-After header. Upgrade or switch to x402 for additional headroom.

07 / Feedback

Hit a bug, want an endpoint that doesn't exist, or just have a note? Send it straight to me — no account required. Email is optional; leave it if you want a reply.