santyvv-data — market & on-chain data

What can be ordered, at what price and under what name. Includes this MCP server's tools and the equivalent HTTP routes. Free.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Live probe of every public source behind the data (response, HTTP status and latency). Free: use it to decide whether a paid call is worth it, and to see where a number came from.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

What an asset is worth right now, in USD, as a MEDIAN across several venues with its spread - not a single exchange's last trade. Use it to quote, to compare venues or to spot a dislocated market. Cuesta $0.02 por llamada, en USDC sobre Base (protocolo x402).

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string",
      "maxLength": 10,
      "description": "Comma-separated symbols, up to 20. Example: BTC,ETH,SOL (por defecto: BTC)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

What a token is and what it is worth: name, symbol, decimals, supply, contract address and price per token. Use it to confirm that an address is a real contract and what it represents. Cuesta $0.03 por llamada, en USDC sobre Base (protocolo x402).

{
  "type": "object",
  "properties": {
    "tokens": {
      "type": "string",
      "maxLength": 42,
      "description": "Comma-separated contract addresses, up to 10. Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
      ],
      "description": "Network the token lives on. (por defecto: base)"
    }
  },
  "required": [
    "tokens"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Recent candles for a trading pair at the interval you ask for (1m to 1d). What you need to compute trend or volatility, or to draw a chart without an exchange API key. Cuesta $0.01 por llamada, en USDC sobre Base (protocolo x402).

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "maxLength": 20,
      "description": "Pair to query. Example: BTCUSDT"
    },
    "interval": {
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "1d",
        "1w",
        "1M"
      ],
      "description": "Size of each candle. (por defecto: 1h)"
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "How many candles to return. (por defecto: 100)"
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The big picture: total market cap, Bitcoin dominance, 24 h change, the coins by market cap and the top movers. This is the context question, not the one about a single asset. Cuesta $0.03 por llamada, en USDC sobre Base (protocolo x402).

{
  "type": "object",
  "properties": {
    "vs": {
      "type": "string",
      "maxLength": 8,
      "description": "Quote currency. (por defecto: usd)"
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 250,
      "description": "How many coins to return in the market-cap list. (por defecto: 20)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

How much money is deposited in a DeFi protocol (TVL in USD) with its 24 h and 7 day change. The measure of a protocol's size and health before you interact with it. Cuesta $0.01 por llamada, en USDC sobre Base (protocolo x402).

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "maxLength": 60,
      "description": "DeFiLlama protocol identifier. Example: aave (por defecto: aave)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

What an address holds: the native balance of the network and, if you pass a token, that ERC-20 balance with its decimals. Use it to verify a payment or a holding without opening a block explorer. Cuesta $0.03 por llamada, en USDC sobre Base (protocolo x402).

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "20-byte address (0x followed by 40 hex characters)."
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
      ],
      "description": "Network to query. (por defecto: base)"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Optional: ERC-20 token contract (USDC on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)."
    }
  },
  "required": [
    "address",
    "token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}