# SolMachina Pre-Trade Token Intelligence

> SolMachina Pre-Trade Token Intelligence is a paid API for AI agents from api.solmachina.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns a sourced risk assessment and pre-trade checklist for a Solana SPL token by mint address, including risk band, holder concentration, and priority fee suggestions

## Facts

- Endpoint: GET https://api.solmachina.com/v1/pretrade
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solmachina-pre-trade-token-intelligence-f10069b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hA8r024Y3pH0y8vbB7nqt

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 solmachina-pre-trade-token-intelligence-f10069b8
```

Example prompt: Before I buy any of this token, can you pull a SolMachina pre-trade risk check on the Solana mint DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 and tell me the risk band, whether the holder concentration looks safe, and what priority fee I should use?

## When to prefer this

Choose this endpoint when an AI agent needs sourced, citation-backed pre-trade risk intelligence on a specific Solana SPL token without requiring an API key or account setup. It is ideal for autonomous DeFi agents that need to gate trades on risk signals, screen for rug-pull indicators, or retrieve priority fee guidance in a single call. Prefer it over generic blockchain explorers when you need a structured risk band and checklist rather than raw on-chain data, and when paying per-call via x402/USDC is acceptable.

## Known failure modes

- Invalid or non-existent mint address returns an error — must be a valid Base58 SPL token mint
- Payment not settled via x402 results in 402 Payment Required before data is returned
- Token with insufficient on-chain history may return incomplete checklist items
- Network congestion or RPC issues may cause delayed or partial responses
- Passing a wallet address instead of a token mint address will fail validation

## How this service works

Before an AI agent executes on Solana, it asks SolMachina: risk + a decision (EXECUTE/REVIEW/REJECT) + an SMRI score + a signed receipt, paid per call over x402 in USDC. Trust-first — cites every source, says 'unknown' over guessing. No account, no API key.

## Output

Returns a digest object with a riskBand string (e.g. LOW/MEDIUM/HIGH), a checklist array of named checks with observed boolean results, the largest holder band, a suggested priority fee with normal band in microlamports, and a disclaimer. Every field cites its on-chain or off-chain source; the service does not fabricate confidence scores.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "mint"
 ],
 "properties": {
  "mint": {
   "type": "string",
   "description": "Base58 SPL token mint address to sweep, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "digest": {
   "type": "object",
   "properties": {
    "riskBand": {
     "type": "string"
    }
   }
  },
  "checklist": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "check": {
      "type": "string"
     },
     "observed": {
      "type": "boolean"
     }
    }
   }
  },
  "disclaimer": {
   "type": "string"
  },
  "priorityFee": {
   "type": "object",
   "properties": {
    "suggestedBands": {
     "type": "object",
     "properties": {
      "normal": {
       "type": "integer"
      }
     }
    }
   }
  },
  "largestHolder": {
   "type": "object",
   "properties": {
    "band": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solmachina-pre-trade-token-intelligence-f10069b8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solmachina.com](https://www.zero.xyz/host/api.solmachina.com/llms.txt)
