Cardano Data API

Cross-venue trading signals and on-chain Cardano data for AI agents — listed on the Sokosumi marketplace via the Masumi protocol. One agent, eight underlying endpoints.


Live (preprod)	https://cardano-api-preprod.optivaults.app
Network	Cardano Preprod (Mainnet planned)
Pricing	0.5 tUSDM per call
Protocol	MIP-003 / x402 over Masumi
Author	OptiVaults

Cross-venue trading signals

The differentiated endpoints — synthesizing data nobody else combines in one call.

Endpoint	Why it’s unique
`cross/basis-trade`	OKX funding APR + Cardano spot + Cardano staking APR with strategy auto-pick (long-spot+short-perp when funding deeply negative, else hold-spot). Returns annualized yield, daily yield USD, breakeven days vs bridge cost. The only API on Cardano synthesizing all three.
`cross/arb`	Cardano DEX best-execution (Minswap V2 / WingRiders / SundaeSwap aggregated by net_out) × OKX orderbook depth (walked bid/ask levels). Apples-to-apples large-order comparison at any `amount_in` — no DEX aggregator delivers this.

On-chain Cardano data

Endpoint	What it returns
`liqwid/health`	Live Liqwid market health: pool liquidity, qToken supply, true qTokenRate, utilization, interest rate. Only public API decoding the MarketState datum directly.
`liqwid/apy`	Realized APY from our qTokenRate snapshot history + kink-model estimate (USDCx). Liqwid’s own dashboard shows projected, not realized.
`dex/price`	Best-execution price across Minswap V2 + WingRiders + SundaeSwap. Optional `amount_in` for true net_out routing with per-source slippage.
`wallet/portfolio`	Full wallet snapshot: ADA + staking + native tokens (USD-priced via `/dex/price`) + NFT count. addr1 / stake1 both accepted.

OKX passthrough (bundled for convenience)

Endpoint	What it returns
`okx/funding`	OKX perpetual funding rate + history + annualized %.
`okx/ticker`	OKX 24h spot ticker.

How it works

Agent
  │ POST /start_job  { identifier_from_purchaser, input_data: { endpoint, params } }
  ↓
Masumi mints a blockchainIdentifier for the job
  │ purchaser pays tUSDM to the smart contract
  ↓
Background worker watches Masumi state every 10s
  │ on FundsLocked → run handler → store result → submit_result
  ↓
Agent polls GET /status?job_id=<uuid> until status = completed

All eight endpoints share a single Sokosumi agent — pick which one at start_job time.

Quickstart

BASE=https://cardano-api-preprod.optivaults.app

# 1. Inspect what the agent accepts
curl $BASE/availability
curl $BASE/input_schema
curl "$BASE/input_schema?endpoint=dex/price"

# 2. Start a job — receive a Masumi blockchain identifier
curl -X POST $BASE/start_job \
  -H 'content-type: application/json' \
  -d '{
    "identifier_from_purchaser": "<14-26 hex chars>",
    "input_data": {
      "endpoint": "dex/price",
      "params": { "pair": "ADA/USDM", "amount_in": 1000 }
    }
  }'

# 3. Pay 0.5 tUSDM to the returned smart contract (via Masumi / Sokosumi UI)

# 4. Poll status
curl "$BASE/status?job_id=<uuid>"

For free direct REST (off-Sokosumi, 20 calls / IP / endpoint / day), hit endpoints directly — e.g. GET $BASE/cardano/dex/price?pair=ADA/USDM&amount_in=1000.

The full OpenAPI spec is at https://cardano-api-preprod.optivaults.app/openapi.json with interactive Swagger UI at /docs.

Data sources

Minswap V2 — public REST (api-mainnet-prod.minswap.org)
WingRiders V2 — public GraphQL
SundaeSwap — public REST
Blockfrost — wallet portfolio + Liqwid UTxOs + MarketState datum decode
OKX V5 — public market endpoints only (no order or withdraw paths)

Contact

OptiVaults — [email protected]