# MapleAI Jev Structured Decision API

> MapleAI Jev Structured Decision API is a paid API for AI agents from base.mapleai.shop, paid per call via x402, $0.0025/call, status unknown (last checked 2026-10-02).

Answers structured named questions about a given state description using the Jev decision model, returning typed answers (noul, choice, or score) with confidence values

## Facts

- Endpoint: POST https://base.mapleai.shop/jev?utm_source=zero.xyz
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapleai-jev-structured-decision-api-7ee5452e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xkBau5LBjAAjCU5qX3hF4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mapleai-jev-structured-decision-api-7ee5452e -d '<json body>'
```

Example prompt: Using Jev, analyze this situation — 'The customer was charged twice for one order' — and answer two questions: first, is this a billing issue (noul type), and second, does it require a refund (noul type)?

## When to prefer this

Choose this endpoint when you need structured, typed answers to multiple named questions about a text situation in a single call — especially when you want noul (yes/no/unclear) confidence scores, not just free-text. It is more deterministic and cost-predictable than a general chat completion, and better suited to automation pipelines that need machine-parseable decision outputs rather than prose responses.

## Known failure modes

- Invalid question type enum (must be noul, choice, or score) returns a validation error
- Missing 'state' or 'questions' field causes a 400-level error
- Insufficient USDC balance or x402 payment failure blocks the request
- Very long state strings may exceed token limits or increase cost significantly
- Ambiguous or poorly worded question instructions may yield low-confidence or unreliable answers

## How this service works

Jev structured decisions via SystemOne, priced by input tokens

## Output

A JSON object containing the model version used, token usage stats (input and output tokens), and an 'answers' map where each named question key maps to its typed result — noul questions return a float confidence between 0 and 1, choice questions return a selected option, and score questions return a numeric score.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "model": {
   "enum": [
    "jev-latest"
   ],
   "type": "string",
   "example": "jev-latest"
  },
  "state": {
   "type": "string",
   "example": "The customer was charged twice for one order."
  },
  "questions": {
   "type": "object",
   "example": {
    "billing": {
     "type": "noul",
     "instructions": "Is this about a billing issue?"
    }
   },
   "description": "Named questions. Each value needs type (noul, choice or score) and instructions.",
   "additionalProperties": {
    "type": "object",
    "required": [
     "type",
     "instructions"
    ],
    "properties": {
     "type": {
      "enum": [
       "noul",
       "choice",
       "score"
      ],
      "type": "string"
     },
     "instructions": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "model": "jev-1.13.0",
  "usage": {
   "input_tokens": 282,
   "output_tokens": 20
  },
  "answers": {
   "billing": {
    "noul": 0.98,
    "type": "noul"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapleai-jev-structured-decision-api-7ee5452e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base.mapleai.shop](https://www.zero.xyz/host/base.mapleai.shop/llms.txt)
