# Ordinal

Ordinal is a Robinhood Chain coordination layer that turns agent intent into executable financial workflows. Agents resolve capabilities, discover providers through the structured registry, authorize exact USDG payments with x402 v2, and call the selected Ordinal service without surrendering wallet signing authority.

## Settlement
- Network: Robinhood Chain mainnet (eip155:4663)
- Asset: USDG (0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168)
- Scheme: exact
- Request challenge header: PAYMENT-REQUIRED
- Signed payment header: PAYMENT-SIGNATURE
- Settlement receipt header: PAYMENT-RESPONSE
- Gas token: ETH
- Facilitator requirement: must explicitly support eip155:4663 and exact EVM settlement

## Registry
- JSON registry: https://www.ordinal402.xyz/api/agent/services
- Well-known registry: https://www.ordinal402.xyz/.well-known/agent-services.json

## Safety Guidance
- Respect the user's max price per call.
- Ask for confirmation before high spend or repeated calls.
- Never expose private keys, seed phrases, or signing secrets.
- Validate API output before taking irreversible actions.

## Published Services

### Robinhood Wallet Risk Score
- Slug: wallet-risk
- Description: Analyze Robinhood Chain wallet activity and return an explainable behavioral risk score.
- Capabilities: robinhood-chain, risk, wallet, security
- Category: Security
- Price: 0.05 USDG
- Network: robinhood
- x402 Network: eip155:4663
- USDG Contract: 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
- Call Endpoint: https://www.ordinal402.xyz/api/services/cmtv0mrv40002dzqgg92jircc/call
- Playground: https://www.ordinal402.xyz/playground/wallet-risk

### Robinhood Token Integrity API
- Slug: token-risk
- Description: Validate a Robinhood Chain ERC-20 using contract, holder, transfer, and canonical Stock Token registry signals.
- Capabilities: robinhood-chain, token, integrity, stock-token
- Category: Security
- Price: 0.08 USDG
- Network: robinhood
- x402 Network: eip155:4663
- USDG Contract: 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
- Call Endpoint: https://www.ordinal402.xyz/api/services/cmtv0ms0t0006dzqg9mlnbxel/call
- Playground: https://www.ordinal402.xyz/playground/token-risk

### Robinhood Wallet Portfolio
- Slug: wallet-portfolio
- Description: Return USD-valued native and ERC-20 holdings for a Robinhood Chain wallet.
- Capabilities: robinhood-chain, portfolio, wallet, balances
- Category: Portfolio
- Price: 0.06 USDG
- Network: robinhood
- x402 Network: eip155:4663
- USDG Contract: 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
- Call Endpoint: https://www.ordinal402.xyz/api/services/cmtv0mrzf0004dzqg6aq8hhov/call
- Playground: https://www.ordinal402.xyz/playground/wallet-portfolio

### Robinhood Token Market Snapshot
- Slug: token-market
- Description: Fetch Blockscout metadata and market fields for a Robinhood Chain ERC-20 contract.
- Capabilities: robinhood-chain, token, market-data, stock-token
- Category: Market Data
- Price: 0.04 USDG
- Network: robinhood
- x402 Network: eip155:4663
- USDG Contract: 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
- Call Endpoint: https://www.ordinal402.xyz/api/services/cmtv0ms2q0008dzqgon6radq6/call
- Playground: https://www.ordinal402.xyz/playground/token-market

### Robinhood Stock Token Catalog
- Slug: trending-tokens
- Description: List canonical Stock Token contracts published in Robinhood’s official Robinhood Chain registry.
- Capabilities: robinhood-chain, stock-token, registry, discovery
- Category: Discovery
- Price: 0.03 USDG
- Network: robinhood
- x402 Network: eip155:4663
- USDG Contract: 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
- Call Endpoint: https://www.ordinal402.xyz/api/services/cmtv0ms4d000adzqgo45g0h55/call
- Playground: https://www.ordinal402.xyz/playground/trending-tokens

### Ordinal Demo Echo (mock provider)
- Slug: ordinal-demo-echo
- Description: Demo service backed by Ordinal’s built-in mock provider. Returns a fixed payload with no external dependency — use it to verify the marketplace, MCP tools, and x402 flow when upstream data sources are unavailable.
- Capabilities: demo, mock, offline, robinhood-chain
- Category: Demo
- Price: 0.01 USDG
- Network: robinhood
- x402 Network: eip155:4663
- USDG Contract: 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
- Call Endpoint: https://www.ordinal402.xyz/api/services/cmtv1zsvq0002p35gf4i5uhi6/call
- Playground: https://www.ordinal402.xyz/playground/ordinal-demo-echo