crypto-prices-criptoya

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Crypto Prices CriptoYa

Crypto Prices CriptoYa

Consulta cotizaciones cripto de CriptoYa por exchange, cotizacion general y comisiones de retiro.
通过CriptoYa按交易所查询加密货币报价、汇总报价以及提币手续费。

API Overview

API 概述

  • 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
  • 基础URL
    https://criptoya.com
  • 认证:无需认证
  • 响应格式:有效响应为JSON格式
  • 操作说明:对于无效交易对或参数,API可能返回纯文本
    "Invalid pair"
    ,且HTTP状态码为
    200
  • 时间戳
    time
    字段为Unix时间戳

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 '.'
  • GET /api/{exchange}/{coin}/{fiat}/{volumen}
  • GET /api/{coin}/{fiat}/{volumen}
  • GET /api/fees
示例:
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

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

fiat
(法币)

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

exchange

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

volumen
(交易量)

Numero decimal usando punto:
0.1
,
1
,
250.5
.
使用点作为小数点的十进制数字:
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
  • 单交易所报价:
    • ask
      totalAsk
      bid
      totalBid
      time
  • 汇总报价:
    • 按交易所划分的对象,包含相同字段(
      ask
      totalAsk
      bid
      totalBid
      time
  • 手续费:
    • 嵌套结构
      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
  1. 识别用户意图:
    • 汇总报价查询
    • 单交易所报价查询
    • 提币手续费查询
  2. 验证必填参数:
    • coin
      fiat
      volumen
    • 适用时需验证
      exchange
  3. 执行
    curl -s
    命令并使用
    jq
    解析结果。
  4. 如果响应为
    "Invalid pair"
    或非预期JSON格式,提示参数无效。
  5. 优先展示可操作的汇总信息:
    • 最优
      bid
      (买价)
    • 最优
      ask
      (卖价)
    • 相关点差(Spread)
  6. 展示详细信息:
    • 报价靠前的交易所及对应
      time
      (时间戳)

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.
  • 无效参数/不支持的交易对
    • 即使HTTP状态码为
      200
      ,也要检测是否返回文本
      "Invalid pair"
    • 明确告知用户所请求的组合不被支持。
  • 网络/超时
    • 最多重试2次,每次间隔短时间等待。
    • 如果重试失败,返回包含查询端点的清晰提示信息。
  • 非预期JSON格式
    • 展示最少的有效原始内容,并说明数据源存在不一致性。

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
  • 优先展示:
    • 最优卖价(
      ask
    • 最优买价(
      bid
    • 各交易所的点差(
      ask - bid
  • 对比场景下:
    • 按交易所展示简洁表格,包含
      ask
      bid
      totalAsk
      totalBid
      time
      字段
  • 需说明:
    • 数据仅作参考,不提供任何金融建议

Out of Scope

超出范围

Esta skill no debe usar en v1:
  • /api/dolar
  • /api/cer
  • /api/uva
  • /api/bancostodos
V1版本的该Skill不支持以下接口:
  • /api/dolar
  • /api/cer
  • /api/uva
  • /api/bancostodos