# Miorail Stock Representation Choice

> Miorail Stock Representation Choice is a paid API for AI agents from miorail.xyz, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-18).

Returns the best tokenized stock representation(s) for a given security, trade direction, and size in USDC, including issuer and on-chain token details.

## Facts

- Endpoint: GET https://miorail.xyz/api/x402/intelligence/v1/stocks/representations?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/miorail-stock-representation-choice-47656f07
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nZQQsC_GvzznqOIZNAaS9

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 miorail-stock-representation-choice-47656f07
```

Example prompt: What's the best on-chain token representation for buying $1000 USDC worth of Coinbase stock (ISIN US19260Q1076) — give me the issuer, token address, and whether a route policy is established?

## When to prefer this

Use this endpoint when an agent needs to identify the correct on-chain tokenized stock token and issuer for a given ISIN before routing a trade through a DEX or liquidity protocol. Prefer this over generic DEX aggregators when you need an authoritative, reviewed mapping from a traditional security identifier (ISIN) to a specific on-chain token address, with issuer provenance and route policy confirmation.

## Known failure modes

- Missing or invalid underlyingKey returns an error or empty representations array
- Unsupported sizeUsdc value (not one of 100, 1000, 10000, 100000) may return no results or an error
- Unknown or unreviewed security key results in empty representations
- Payment not processed (x402 protocol failure) blocks access to the resource
- missingEvidence field populated when no measurement exists at the exact size/direction combo

## How this service works

Miorail x402 paid resource

## Output

Returns a list of tokenized stock representations for the queried security, each with issuer ID, on-chain token address, liquidity sources (e.g. KyberSwap with quote status), and whether a route policy is established. Also includes a missingEvidence array flagging any representations lacking measurement at the exact size and direction requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "underlyingKey"
     ],
     "properties": {
      "sizeUsdc": {
       "type": "string",
       "description": "A measured ladder size: 100, 1000, 10000 or 100000"
      },
      "direction": {
       "type": "string",
       "description": "buy or sell; default buy"
      },
      "underlyingKey": {
       "type": "string",
       "description": "Reviewed security key, e.g. security:isin:US67066G1040"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "service": "stock_representation_choice",
  "missingEvidence": [
   "at least one reviewed representation has no measurement at this exact size and direction"
  ],
  "representations": [
   {
    "sources": [
     {
      "source": "kyberswap",
      "status": "quoted"
     }
    ],
    "issuerId": "coinbase",
    "tokenAddress": "0xb20000000000000000000078ee7ce2fe4908108c",
    "routePolicyEstablished": true
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/miorail-stock-representation-choice-47656f07/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from miorail.xyz](https://www.zero.xyz/host/miorail.xyz/llms.txt)