Mercado, cripto e economia

Mercado, cripto e economia: Cotações, criptomoedas e indicadores econômicos.

Atualizado em 05/11/2026.

O que é Mercado, cripto e economia na APIcultura

Acesse Mercado, cripto e economia pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Cotações, criptomoedas e indicadores econômicos. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Pesquisa e conhecimento. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Cotações de criptomoedas (cripto-cotacoes)

Preços de moedas (CoinGecko). Preço: R$ 0,01 por chamada.

• coins (string, opcional), ex.: bitcoin,ethereum
• currency (string, opcional)
• limit (integer, opcional)

Schema de entrada de cripto-cotacoes

{
  "required": [],
  "properties": {
    "coins": {
      "type": "string",
      "maxLength": 2000
    },
    "currency": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "type": "number"
    }
  }
}

Buscar criptomoedas (cripto-buscar)

Busca preços de criptomoedas. Preço: R$ 0,54 por chamada.

• query (string, obrigatório), ex.: Bitcoin BTC price
• max_num_results (integer, obrigatório, mín. 1, máx. 10), ex.: 1
• search_type (string, obrigatório)
• max_price (number, obrigatório)
• response_length (string, obrigatório)
• included_sources (array[string], obrigatório), ex.: valyu/valyu-crypto

Schema de entrada de cripto-buscar

{
  "required": [
    "query",
    "max_num_results",
    "search_type",
    "max_price",
    "response_length",
    "included_sources"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "max_num_results": {
      "type": "number"
    },
    "search_type": {
      "type": "string",
      "maxLength": 2000
    },
    "max_price": {
      "type": "number"
    },
    "response_length": {
      "type": "string",
      "maxLength": 2000
    },
    "included_sources": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Indicadores econômicos (economia-indicadores)

Busca indicadores econômicos. Preço: R$ 0,45 por chamada.

• query (string, obrigatório), ex.: United States unemployment rate
• max_num_results (integer, obrigatório, mín. 1, máx. 10), ex.: 1
• search_type (string, obrigatório)
• max_price (number, obrigatório)
• response_length (string, obrigatório)
• included_sources (array[string], obrigatório), ex.: valyu/valyu-bls,valyu/valyu-worldbank-indicators

Schema de entrada de economia-indicadores

{
  "required": [
    "query",
    "max_num_results",
    "search_type",
    "max_price",
    "response_length",
    "included_sources"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "max_num_results": {
      "type": "number"
    },
    "search_type": {
      "type": "string",
      "maxLength": 2000
    },
    "max_price": {
      "type": "number"
    },
    "response_length": {
      "type": "string",
      "maxLength": 2000
    },
    "included_sources": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Cotação no Google Finance (financas-cotacao-acao)

Cotação de um ativo no Google Finance. Preço: R$ 0,02 por chamada.

• keyword (string, opcional), ex.: CLW00:NYMEX
• location_code (integer, opcional), ex.: 2840
• language_code (string, opcional)
• device (string, opcional)
• location_name (string, opcional)
• language_name (string, opcional), ex.: English
• os (string, opcional)
• tag (string, opcional)
• window (string, opcional)

Schema de entrada de financas-cotacao-acao

{
  "required": [],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "number"
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "device": {
      "type": "string",
      "maxLength": 2000
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "language_name": {
      "type": "string",
      "maxLength": 2000
    },
    "os": {
      "type": "string",
      "maxLength": 2000
    },
    "tag": {
      "type": "string",
      "maxLength": 2000
    },
    "window": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Previsão do tempo (clima-previsao)

Previsão diária para um local. Preço: R$ 0,01 por chamada.

• days (integer, opcional), ex.: 7
• latitude (string, opcional), ex.: 1.35
• longitude (string, opcional), ex.: 103.82
• place (string, opcional), ex.: Singapore

Schema de entrada de clima-previsao

{
  "required": [],
  "properties": {
    "days": {
      "type": "number"
    },
    "latitude": {
      "type": "string",
      "maxLength": 2000
    },
    "longitude": {
      "type": "string",
      "maxLength": 2000
    },
    "place": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "cripto-cotacoes", "input": {"coins":"bitcoin,ethereum"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/cripto-cotacoes \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"coins":"bitcoin,ethereum"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,01 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Experimente

Teste no playground interativo: Mercado, cripto e economia no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Mercado, cripto e economia é marca de seus respectivos donos, citada apenas para identificar a integração.