crypto-prices-criptoya

Original🇺🇸 English
Translated

Consulta cotizaciones de criptomonedas con CriptoYa por exchange y en forma agregada. Usar cuando el usuario pida "precio BTC en ARS", "cotizacion USDT", "precio ETH en USD", "mejor precio por exchange", "comparar exchanges", "precio en belo/ripio/lemon/binance/bybit", o cuando pida comisiones de retiro y fees por red.

6installs
Added on

NPX Install

npx skill4agent add ferminrp/agent-skills crypto-prices-criptoya

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:
bash
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