---
name: api.smartflowproai.com
description: api.smartflowproai.com exposes two endpoints: a health check for verifying service and payment infrastructure status, and a decision API that returns a structured buy/sell signal (action, confidence score, risk level, and supporting signals) for a given token address. It is a decision-support layer, not a price feed or financial advisory service.
host: api.smartflowproai.com
---

# api.smartflowproai.com

SmartFlow Pro AI serves agents that need a pre-computed, signal-backed trading decision for a specific token before executing or screening automated trades. It provides a single decision object per token query rather than raw market data, and includes an x402 payment-aware health probe to confirm the paid API infrastructure is live before spending on decision calls.

## When to use this host

Use this host when an agent needs a single, pre-computed buy/sell decision signal with confidence and risk metadata for a specific token address prior to an automated trade or screening step. Use fetch-bazaar-health-check first if the agent is starting a session or has not recently confirmed service availability. Do not use this host as a real-time price feed, OHLCV source, or portfolio analytics tool — for raw market data, route to a dedicated market data provider. Do not treat outputs as financial advice; the decision signal may return INSUFFICIENT_DATA if no signals exist for the queried token on the current day. This host has no charting, historical data, order execution, or wallet management capabilities.

## Capabilities

### Service Readiness

Verifies that the SmartFlow bazaar service is operational and that x402 payment headers and scheme are correctly configured, allowing agents to gate paid calls on confirmed availability.

- **`fetch-bazaar-health-check`** — Returns the current health status of the SmartFlow bazaar service, including response time, x402 payment header presence, payment scheme, network, and timestamp.

### Token Decision Signals

Returns a structured buy/sell action decision for a token address, including confidence score, risk level, supporting signals, and model metadata, for use in automated trading or screening workflows.

- **`fetch-bazaar-decision`** — Returns a buy/sell action decision for a token, including a confidence score, risk level, supporting signals, and model metadata.

## Workflows

### Gated Token Decision Fetch

*Use when an agent needs to retrieve a token decision signal while ensuring the paid API service is live and correctly configured before incurring payment costs.*

1. **`fetch-bazaar-health-check`** — Confirm the bazaar service is healthy and x402 payment infrastructure is present; abort or retry if status is not healthy.
2. **`fetch-bazaar-decision`** — Submit the target token address and retrieve the action, score, risk, and signals for downstream trading or screening logic.

## Skill reference

### `fetch-bazaar-decision`

**Bazaar Decision API** — Returns a buy/sell action decision for a token, including a confidence score, risk level, supporting signals, and model metadata.

*Use when:* Use when an agent needs a structured decision signal (action, score, risk, signals) for a specific token address before taking an automated trading or screening action.

*Not for:* Do not use as a source of financial advice or as a real-time price feed; this is a decision-support tool only and may return INSUFFICIENT_DATA if no signals are available for the token today.

**Inputs:**

- `asset` (string, required) — The token contract address to evaluate (e.g. an ERC-20 address on Base).

**Returns:** Returns an action string (e.g. INSUFFICIENT_DATA), a numeric score, risk level, per-signal breakdown object, signals_counted, model_version, timestamp, and a disclaimer.

**Example:** `GET https://api.smartflowproai.com/bazaar/decision?asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`

---

### `fetch-bazaar-health-check`

**SmartFlow Bazaar Health Check** — Returns the current health status of the SmartFlow bazaar service, including response time, x402 payment header presence, payment scheme, network, and timestamp.

*Use when:* Use when an agent needs to verify that the SmartFlow bazaar service is operational and that x402 payment infrastructure is correctly configured before initiating paid API calls.

*Not for:* Do not use for ongoing real-time monitoring or streaming uptime checks; this is a single-shot health probe. Not suitable for retrieving business data or quotes.

**Returns:** Returns a JSON object with status='healthy', responseTime in ms, x402HeaderPresent boolean, paymentScheme, network identifier, checkedAt timestamp, and provider name.

**Example:** `GET https://api.smartflowproai.com/bazaar/health-check`

---