mcpField
C
crypto-prices-criptoya

crypto-prices-criptoya

github.com/ferminrpOther3948 installsUpdated 13w ago
Repository

About crypto-prices-criptoya

A skill for querying crypto prices and withdrawal fees through the CriptoYa API. It guides users through exchange comparisons, input validation, error handling, and presenting actionable quote summaries.

Key features

  1. 01Query prices by exchange
  2. 02Get aggregated exchange quotes
  3. 03Check withdrawal fees
  4. 04Validate inputs and handle errors
  5. 05Summarize bids, asks, and spreads

Use cases

  1. 01Compare coin prices on a selected exchange
  2. 02Review quotes across exchanges
  3. 03Check withdrawal fees by coin and network

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ferminrp/agent-skills --skill crypto-prices-criptoya

After installing, type/crypto-prices-criptoyain Claude Code to confirm it loaded.

Details

From the project README

Crypto Prices CriptoYa

Consulta cotizaciones cripto de CriptoYa por exchange, cotizacion general y comisiones de retiro.

API Overview

  • Base URL: https://criptoya.com
  • Auth: None required
  • Response format: JSON en respuestas validas
  • Nota operativa: para pares o valores invalidos la API puede devolver texto plano "Invalid pair" con HTTP 200
  • Timestamp: campo time en unix epoch

Endpoints

  • GET /api/{exchange}/{coin}/{fiat}/{volumen}
  • GET /api/{coin}/{fiat}/{volumen}
  • GET /api/fees

Ejemplos:

curl -s "https://criptoya.com/api/BTC/ARS/0.1" | jq '.'
curl -s "https://criptoya.com/api/belo/BTC/ARS/0.1" | jq '.'
curl -s "https://criptoya.com/api/fees" | jq '.'

Valores admitidos

coin

BTC, ETH, USDT, USDC, DAI, UXD, USDP, WLD, BNB, SOL, XRP, ADA, AVAX, DOGE, TRX, LINK, DOT, MATIC, SHIB, LTC, BCH, EOS, XLM, FTM, AAVE, UNI, ALGO, BAT, PAXG, CAKE, AXS, SLP, MANA, SAND, CHZ

fiat

ARS, BRL, CLP, COP, MXN, PEN, VES, BOB, UYU, DOP, PYG, USD, EUR

exchange

cryptomkt, letsbit, belo, bitsoalpha, bybit, ripio, lemoncash, fiwind, tiendacrypto, eluter, universalcoins, buenbit, binance, huobip2p, bitso, eldoradop2p, lemoncashp2p, kucoinp2p, decrypto, mexcp2p, pluscrypto, cocoscrypto, bitgetp2p, cryptomktpro, satoshitango, coinexp2p, paydecep2p, binancep2p, bingxp2p, ripioexchange, astropay, dolarapp, vibrant, wallbit, vitawallet, weexp2p, trubit, okexp2p, bybitp2p, saldo, p2pme, airtm

volumen

Numero decimal usando punto: 0.1, 1, 250.5.

Campos clave

  • Cotizacion por exchange:
    • ask, totalAsk, bid, totalBid, time
  • Cotizacion general:
    • Objeto por exchange con los mismos campos (ask, totalAsk, bid, totalBid, time)
  • Fees:
    • Estructura anidada exchange -> coin -> red -> fee

Workflow

  1. Detectar intencion:
    • Cotizacion general
    • Cotizacion por exchange
    • Fees de retiro
  2. Validar inputs requeridos:
    • coin, fiat, volumen
    • exchange cuando aplique
  3. Ejecutar curl -s y parsear con jq.
  4. Si la respuesta es "Invalid pair" o no es JSON esperado, informar parametros invalidos.
  5. Presentar primero resumen accionable:
    • Mejor bid
    • Mejor ask
    • Spread relevante
  6. Presentar detalle:
    • Top exchanges y time por cotizacion

Error Handling

  • Parametro invalido / par no soportado:
    • Detectar texto "Invalid pair" aunque HTTP sea 200.
    • Informar claramente que la combinacion solicitada no esta soportada.
  • Red/timeout:
    • Reintentar hasta 2 veces con espera corta.
    • Si falla, devolver mensaje claro con endpoint consultado.
  • JSON inesperado:
    • Mostrar minimo crudo util y aclarar inconsistencia del origen.

Presenting Results

  • Priorizar:
    • Mejor precio de compra (ask)
    • Mejor precio de venta (bid)
    • Spread (ask - bid) por exchange
  • En comparativas:
    • Tabla corta por exchange con ask, bid, totalAsk, totalBid, time
  • Aclarar:
    • Datos informativos y sin recomendacion financiera

Out of Scope

Esta skill no debe usar en v1:

  • /api/dolar
  • /api/cer
  • /api/uva
  • /api/bancostodos

Comments

Markdown supported