https-outcalls

Manage HTTPS outcalls from Internet Computer canisters with deterministic transform functions.

28|11|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/dfinity/icskills --skill https-outcalls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: https-outcalls
Source: https://github.com/dfinity/icskills/tree/main/skills/https-outcalls
Command: npx skills add https://github.com/dfinity/icskills --skill https-outcalls

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables Internet Computer (IC) canisters to securely and reliably make HTTPS requests to external web services, bridging on-chain logic with off-chain data and functionality.

Core Features & Use Cases

  • External API Integration: Fetch data from any public web API (e.g., market data, weather services).
  • Secure Communication: Utilizes HTTPS for secure data transfer.
  • Consensus-Ready: Employs transform functions to ensure deterministic responses across all replicas for consensus.
  • Cycle Management: Automatically handles cycle costs for outgoing requests.
  • Use Case: A decentralized application needs to display real-time cryptocurrency prices. This Skill allows the canister to query an external price API like CoinGecko and display the data on-chain.

Quick Start

Use the https-outcalls skill to fetch the current ICP price in USD from an external API.

Frequently Asked Questions about https-outcalls

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch data from an external API using an Internet Computer canister?

You can fetch data from an external API using an Internet Computer canister by making HTTPS outcalls. This Skill manages request arguments, custom headers, and cycle costs to securely retrieve off-chain web data.

Why do HTTPS outcalls require a transform function for consensus?

HTTPS outcalls require a transform function for consensus because external API responses can vary between replicas. The transform function ensures deterministic response validation across the Internet Computer network.

Can I use HTTPS outcalls to send POST requests with a custom body from a canister?

Yes, you can use HTTPS outcalls to send POST requests with a custom body from a canister. The Skill supports both GET and POST methods, allowing custom headers and request bodies for web integration.

Does the Internet Computer automatically handle cycle costs for canister HTTPS outcalls?

Yes, the Internet Computer automatically handles cycle costs for canister HTTPS outcalls. This Skill manages the cycle requirements internally to ensure secure and reliable external web service requests.

What are the limitations of making HTTPS outcalls from an Internet Computer canister?

Limitations of making HTTPS outcalls from an Internet Computer canister include response size limits and the need for deterministic transform functions. These constraints ensure consensus across replicas during external web service integration.

What is the best way to connect an IC canister to external web services?

The best way to connect an IC canister to external web services is through HTTPS outcalls. This approach bridges on-chain logic with off-chain data by managing request arguments and response validation securely.