# Orion Liquidity Risk API

> Orion Liquidity Risk API is a paid API for AI agents from orionkr.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Checks Base/memecoin token liquidity health before a trade, detecting fake liquidity, thin liquidity, rug-risk signals, and execution safety issues.

## Facts

- Endpoint: GET https://orionkr.xyz/v1/liquidity-risk
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orionkr-xyz-2dd8b0fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sw91JvPN-8CtJWqgtNEIu

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 orionkr-xyz-2dd8b0fd
```

Example prompt: Before I buy this Base memecoin at 0x4e7B3f9b2c1d8a5F6e0C3D2A1B9c8E7d6F5a4B3C, run Orion's liquidity risk check on it — I need to know if the liquidity is fake, too thin, or if there are rug-pull signals that would make the trade unsafe to execute.

## When to prefer this

Use this endpoint specifically when you need a focused liquidity health check — fake liquidity detection, thin liquidity flags, and rug-risk signals — for Base chain tokens or memecoins before executing a swap or buy. Prefer this over the broader token risk scan when liquidity quality and execution safety are the primary concern, and over the swap safety endpoint when you want explicit fake/thin liquidity classification rather than a general safety gate.

## Known failure modes

- Invalid or unrecognized token address returns an error
- Token not deployed on Base chain causes lookup failure
- Insufficient on-chain liquidity data for new/unlisted tokens
- Payment of 0.02 USDC not provided or payment fails via x402
- Rate limiting if called too frequently in rapid succession

## How this service works

Liquidity risk API for Base/memecoin trades. Checks fake liquidity, thin liquidity, rug-risk signals, and execution safety before buying.

## Output

Returns a liquidity risk assessment including flags for fake liquidity, thin liquidity, rug-risk signals, and an execution safety verdict (e.g. PASS/WAIT/FAIL style) indicating whether the trade is safe to proceed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string",
       "const": "base"
      },
      "wallet": {
       "type": "string"
      },
      "address": {
       "type": "string",
       "description": "Base wallet, token, or contract address."
      },
      "amountIn": {
       "type": "string"
      },
      "tokenAddress": {
       "type": "string",
       "description": "Optional Base token contract address."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [],
     "properties": {
      "success": {
       "type": "boolean"
      },
      "verdict": {
       "type": "string"
      },
      "risk_score": {
       "type": "number"
      },
      "blocking_flags": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "required_next_call": {
       "type": "string"
      },
      "verdict_ttl_seconds": {
       "type": "number"
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orionkr-xyz-2dd8b0fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orionkr.xyz](https://www.zero.xyz/host/orionkr.xyz/llms.txt)