# Mercado, cripto e economia

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

URL: https://apicultura.app/ferramentas/mercados-economia/
Atualizado em 05/11/2026 (2026-11-05).

## 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](/catalogo/?cat=pesquisa). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `cripto-cotacoes` | Cotações de criptomoedas | R$ 0,01 | `POST /v1/call/cripto-cotacoes` |
| `cripto-buscar` | Buscar criptomoedas | R$ 0,54 | `POST /v1/call/cripto-buscar` |
| `economia-indicadores` | Indicadores econômicos | R$ 0,45 | `POST /v1/call/economia-indicadores` |
| `financas-cotacao-acao` | Cotação no Google Finance | R$ 0,02 | `POST /v1/call/financas-cotacao-acao` |
| `clima-previsao` | Previsão do tempo | R$ 0,01 | `POST /v1/call/clima-previsao` |

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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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:

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

## Exemplo de chamada HTTP

```bash
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](/ferramentas/ferramenta.html?slug=mercados-economia). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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