# Spark
> AI-powered trade intelligence — volatility analysis, SABR calibration, options strategy generation

## Docs
- [OpenAPI Schema](https://spark.igniteedge.ai/openapi.json): Full API specification
- [MCP Server](https://spark.igniteedge.ai/mcp): Model Context Protocol — auto-discovered tools from OpenAPI

## Free Endpoints
- [Handshake](https://spark.igniteedge.ai/v1/handshake): GET — demo trades, capabilities, pricing
- [Info](https://spark.igniteedge.ai/v1/info): GET — service version, integration status
- [Health](https://spark.igniteedge.ai/health): GET — liveness probe

## Paid Endpoints (x402 — USDC on Base Sepolia)
- [Market Insights](https://spark.igniteedge.ai/v1/market-insights): POST $0.01 — trade ideas for specified symbols
- [Portfolio Recommendations](https://spark.igniteedge.ai/v1/portfolio-recommendations): POST $0.01 — position-aware trade ideas

## x402 Payment Flow
Paid endpoints return HTTP 402 with a `payment-required` header (base64 JSON).
To pay: decode the header, sign an EIP-712 typed-data message with your wallet,
and resend the request with the signed payment in the `X-PAYMENT` header.
The x402 facilitator (https://x402.org/facilitator) settles the on-chain transfer.
Network: Base Sepolia (eip155:84532). Asset: USDC.

## Example Request
```
POST /v1/market-insights
Content-Type: application/json
X-PAYMENT: <base64-signed-payment>

{"agent_id": "my-agent", "symbols": ["AAPL", "TSLA"], "num_ideas": 3}
```