Documentation - Bifrost API

The Nine Blockchain Realms

"Through the rainbow bridge of Bifrost, nine digital realms connect, each guarding ancestral secrets of blockchain technology. Heimdall watches the passages between worlds, allowing only the worthy to cross the sacred portals."

Warning from Asgard's Guardians

By decree of the High Sages of Asgard, seven of the nine sacred realms are shrouded in the mists of time, their portals sealed with ancestral runes while Heimdall strengthens the interdimensional bridges. Only the luminous Realm of Alfheim (Binance Smart Chain) and the mysterious Realm of Svartalfheim (Polygon) remain accessible to worthy mortals. May your journey through the golden paths and the dark elves' forges be prosperous, until the cosmic winds blow again and the other portals are reopened by the will of the gods.

The Nine Realms and Their Mythical Correspondences

Sealed

Bitcoin - Asgard

The Realm of the Gods, where Odin resides

Sealed

Ethereum - Midgard

The Realm of Mortals, center of all activity

Active

Binance Smart Chain - Alfheim

Realm of the Light Elves, fast and bright

Sealed

Optimism - Ljosalfgard

Realm of the Luminous Elves, optimism and speed

Sealed

Arbitrum - Vanaheim

Realm of the Vanir, wisdom and scalability

Sealed

Cronos - Jotunheim

Realm of the Giants, colossal power and speed

Sealed

Avalanche - Niflheim

Realm of Frozen Mists, avalanche consensus

Sealed

Polygon - Svartalfheim

Realm of the Dark Elves, solution forgers

Sealed

Base - Muspelheim

Realm of Primordial Fire, incandescent energy

Coins of the Mortal Realms

"In the golden chambers of mortal realms, each coin carries the ancestral power of its homeland, forged with the wisdom of the ancients and blessed by celestial guardians."

Ancestral Warning from the Guardians

The mortal realm currencies (BRL, USD, EUR, etc.) are merely ethereal mirrors used by the oracles to calculate conversions between worlds. These currencies are NOT directly accepted in Asgard's sacred vaults. Only the divine tokens of the nine blockchain realms can cross the Bifrost bridges and be deposited in the celestial coffers.

ARS - Pesos of the Argentine Realm

Born from the winds of infinite pampas

AUD - Dollars of the Australian Realm

Tempered by the winds of the mystical outback

BRL - Gold of the Brazilian Kingdom

Forged in the sacred mines of the Amazon

CAD - Dollars of the Canadian Realm

Crystallized in the eternal glaciers of the north

CHF - Francs of the Swiss Realm

Sculpted in the sacred Alpine peaks

EUR - Coins of the European Realm

Molded in the union of ancestral realms

GBP - Pounds of the Britannia Realm

Guarded by dragons of the mystical islands

INR - Rupees of the Indian Realm

Minted in Bharat’s bazaars, scented with ancestral spices

JPY - Yen of the Rising Sun Realm

Illuminated by the aurora of eternal samurai

MXN - Pesos of the Mexican Realm

Blessed by Aztec spirits

THB - Bahts of the Thai Realm

Forged on the banks of the Chao Phraya, consecrated in gilded pagodas

USD - Silver of the American Empire

Minted in the temples of eternal freedom

Heimdall's Seal

"In the mists of Niflheim, only bearers of the golden seal can cross the digital rainbow bridges."

To cross the sacred portals of Bifrost, worthy mortals must carry the Access Rune, a mystical seal inscribed in the headers of all invocations to the nine realms.

The Ancestral Access Rune

In each call to the sacred portals, present the Access Rune in the mystical header:

X-Bifrost-Invoke: your_access_rune_to_the_bifrost

The Invocation Rune

This sacred header must accompany all your requests to the nine realms. Replace your_access_rune_to_the_bifrost with your personal rune, forged in the halls of Asgard and granted by the divine guardians.

Mystical Rune Example

curl -X GET "https://bridge.bifrostcrypto.com/endpoint" \
  -H "X-Bifrost-Invoke: your_access_rune_to_the_bifrost" \
  -H "Content-Type: application/json"

Request Limits

"The guardians of Heimdall monitor every passage across the rainbow bridge. Each Sacred Access Rune has its own crossing limit. Those who attempt to cross excessively will be temporarily prevented."

Sacred Rules of Limits

Default Limit

500 requests per minute per Sacred Rune

🚫 When Limit is Exceeded

If you exceed the limit, you will receive HTTP code 429:

HTTP/1.1 429 Too Many Requests

{
  "error": "limit_exceeded_for_rune"
}

Global Realms Summary

"In the halls of knowledge of Asgard, the global summary reveals all secrets: tokens accepted by the gods, currencies recognized by the nine realms and the sacred configurations of the divine portals."

GET

/external/summary

Reveals the complete wisdom of the nine realms: accepted tokens, fiat currencies and configurations.

Ancestral Warning from the Guardians

Wisdom of the Nine Realms200

{
    "message": "summary_retrieved_success",
    "data": {
        "accepted_tokens": [
            {
                "symbol": "ETH",
                "contract_address": null,
                "network": "Ethereum",
                "min_receipt": 0.001,
                "max_receipt": 9.223372036854776e+18,
                "min_withdrawal": 0.001,
                "max_withdrawal": 9.223372036854776e+18,
                "network_fee": 0.0005
            },
            {
                "symbol": "USDT",
                "contract_address": "0x55d398326f99059fF775485246999027B3197955",
                "network": "BinanceSmartChain",
                "min_receipt": 2,
                "max_receipt": 1000000000,
                "min_withdrawal": 2,
                "max_withdrawal": 1000000000,
                "network_fee": 0.5
            }
        ],
        "accepted_fiats": [
            {
                "code": "BRL",
                "name": "Brazilian Real",
                "symbol": "R$"
            },
            {
                "code": "USD",
                "name": "US Dollar",
                "symbol": "$"
            }
        ],
        "user_info": {
            "minimum_payment": 99.9,
            "receipt_rate": 5,
            "payment_rate": 2,
            "deposit_rate": 0.5,
            "withdrawal_rate": 0.5,
            "user_pays_payment_network_fee": false,
            "user_pays_receipt_network_fee": false,
            "user_pays_deposit_network_fee": false,
            "user_pays_withdrawal_network_fee": false
        },
        "summary_stats": {
            "total_tokens": 11,
            "total_fiats": 11,
            "generated_at": "2025-09-07 19:33:37"
        }
    }
}

GET

/external/summary/tokens

Queries only the tokens accepted by the gods of the nine realms.

Sacred Tokens200

{
    "message": "tokens_retrieved_success",
    "tokens": [
        {
            "symbol": "ETH",
            "contract_address": null,
            "network": "Ethereum",
            "min_receipt": 0.001,
            "max_receipt": 9.223372036854776e+18,
            "min_withdrawal": 0.001,
            "max_withdrawal": 9.223372036854776e+18,
            "network_fee": 0.0005
        },
        {
            "symbol": "BNB",
            "contract_address": null,
            "network": "BinanceSmartChain",
            "min_receipt": 0.001,
            "max_receipt": 100000,
            "min_withdrawal": 0.001,
            "max_withdrawal": 100000,
            "network_fee": 0.0005
        },
        {
            "symbol": "USDT",
            "contract_address": "0x55d398326f99059fF775485246999027B3197955",
            "network": "BinanceSmartChain",
            "min_receipt": 2,
            "max_receipt": 1000000000,
            "min_withdrawal": 2,
            "max_withdrawal": 1000000000,
            "network_fee": 0.5
        },
        {
            "symbol": "USDC",
            "contract_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "network": "Ethereum",
            "min_receipt": 2,
            "max_receipt": 1000000000,
            "min_withdrawal": 2,
            "max_withdrawal": 1000000000,
            "network_fee": 1.0e-5
        }
    ],
    "meta": {
        "total": 11,
        "generated_at": "2025-09-07 19:35:32"
    }
}

GET

/external/summary/fiats

Reveals the fiat currencies accepted by Asgard's vaults, with their symbols and sacred denominations.

Realms Coins200

{
    "message": "fiats_retrieved_success",
    "fiats": [
        {
            "code": "BRL",
            "name": "Brazilian Real",
            "symbol": "R$"
        },
        {
            "code": "USD",
            "name": "US Dollar",
            "symbol": "$"
        },
        {
            "code": "EUR",
            "name": "Euro",
            "symbol": "€"
        },
        {
            "code": "GBP",
            "name": "British Pound",
            "symbol": "£"
        },
        {
            "code": "ARS",
            "name": "Argentine Peso",
            "symbol": "$"
        },
        {
            "code": "MXN",
            "name": "Mexican Peso",
            "symbol": "$"
        },
        {
            "code": "CAD",
            "name": "Canadian Dollar",
            "symbol": "CA$"
        },
        {
            "code": "AUD",
            "name": "Australian Dollar",
            "symbol": "A$"
        },
        {
            "code": "CHF",
            "name": "Swiss Franc",
            "symbol": "CHF"
        },
        {
            "code": "JPY",
            "name": "Japanese Yen",
            "symbol": "¥"
        },
        {
            "code": "CNY",
            "name": "Chinese Yuan",
            "symbol": "¥"
        },
        {
            "code": "INR",
            "name": "Indian Rupee",
            "symbol": "₹"
        },
        {
            "code": "THB",
            "name": "Thai Baht",
            "symbol": "฿"
        }
    ],
    "meta": {
        "total": 13,
        "generated_at": "2025-09-07 19:38:19"
    }
}

The Nine Blockchain Realms

Warning from Asgard's Guardians

The Nine Realms and Their Mythical Correspondences

Sealed

Bitcoin - Asgard

The Realm of the Gods, where Odin resides

Sealed

Ethereum - Midgard

The Realm of Mortals, center of all activity

Active

Binance Smart Chain - Alfheim

Realm of the Light Elves, fast and bright

Sealed

Optimism - Ljosalfgard

Realm of the Luminous Elves, optimism and speed

Sealed

Arbitrum - Vanaheim

Realm of the Vanir, wisdom and scalability

Sealed

Cronos - Jotunheim

Realm of the Giants, colossal power and speed

Sealed

Avalanche - Niflheim

Realm of Frozen Mists, avalanche consensus

Sealed

Polygon - Svartalfheim

Realm of the Dark Elves, solution forgers

Sealed

Base - Muspelheim

Realm of Primordial Fire, incandescent energy

Coins of the Mortal Realms

"In the golden chambers of mortal realms, each coin carries the ancestral power of its homeland, forged with the wisdom of the ancients and blessed by celestial guardians."

Ancestral Warning from the Guardians

ARS - Pesos of the Argentine Realm

Born from the winds of infinite pampas

AUD - Dollars of the Australian Realm

Tempered by the winds of the mystical outback

BRL - Gold of the Brazilian Kingdom

Forged in the sacred mines of the Amazon

CAD - Dollars of the Canadian Realm

Crystallized in the eternal glaciers of the north

CHF - Francs of the Swiss Realm

Sculpted in the sacred Alpine peaks

EUR - Coins of the European Realm

Molded in the union of ancestral realms

GBP - Pounds of the Britannia Realm

Guarded by dragons of the mystical islands

INR - Rupees of the Indian Realm

Minted in Bharat’s bazaars, scented with ancestral spices

JPY - Yen of the Rising Sun Realm

Illuminated by the aurora of eternal samurai

MXN - Pesos of the Mexican Realm

Blessed by Aztec spirits

THB - Bahts of the Thai Realm

Forged on the banks of the Chao Phraya, consecrated in gilded pagodas

USD - Silver of the American Empire

Minted in the temples of eternal freedom

Global Realms Summary

GET

/external/summary

Reveals the complete wisdom of the nine realms: accepted tokens, fiat currencies and configurations.

Ancestral Warning from the Guardians

Wisdom of the Nine Realms200

{
    "message": "summary_retrieved_success",
    "data": {
        "accepted_tokens": [
            {
                "symbol": "ETH",
                "contract_address": null,
                "network": "Ethereum",
                "min_receipt": 0.001,
                "max_receipt": 9.223372036854776e+18,
                "min_withdrawal": 0.001,
                "max_withdrawal": 9.223372036854776e+18,
                "network_fee": 0.0005
            },
            {
                "symbol": "USDT",
                "contract_address": "0x55d398326f99059fF775485246999027B3197955",
                "network": "BinanceSmartChain",
                "min_receipt": 2,
                "max_receipt": 1000000000,
                "min_withdrawal": 2,
                "max_withdrawal": 1000000000,
                "network_fee": 0.5
            }
        ],
        "accepted_fiats": [
            {
                "code": "BRL",
                "name": "Brazilian Real",
                "symbol": "R$"
            },
            {
                "code": "USD",
                "name": "US Dollar",
                "symbol": "$"
            }
        ],
        "user_info": {
            "minimum_payment": 99.9,
            "receipt_rate": 5,
            "payment_rate": 2,
            "deposit_rate": 0.5,
            "withdrawal_rate": 0.5,
            "user_pays_payment_network_fee": false,
            "user_pays_receipt_network_fee": false,
            "user_pays_deposit_network_fee": false,
            "user_pays_withdrawal_network_fee": false
        },
        "summary_stats": {
            "total_tokens": 11,
            "total_fiats": 11,
            "generated_at": "2025-09-07 19:33:37"
        }
    }
}

GET

/external/summary/tokens

Queries only the tokens accepted by the gods of the nine realms.

Sacred Tokens200

{
    "message": "tokens_retrieved_success",
    "tokens": [
        {
            "symbol": "ETH",
            "contract_address": null,
            "network": "Ethereum",
            "min_receipt": 0.001,
            "max_receipt": 9.223372036854776e+18,
            "min_withdrawal": 0.001,
            "max_withdrawal": 9.223372036854776e+18,
            "network_fee": 0.0005
        },
        {
            "symbol": "BNB",
            "contract_address": null,
            "network": "BinanceSmartChain",
            "min_receipt": 0.001,
            "max_receipt": 100000,
            "min_withdrawal": 0.001,
            "max_withdrawal": 100000,
            "network_fee": 0.0005
        },
        {
            "symbol": "USDT",
            "contract_address": "0x55d398326f99059fF775485246999027B3197955",
            "network": "BinanceSmartChain",
            "min_receipt": 2,
            "max_receipt": 1000000000,
            "min_withdrawal": 2,
            "max_withdrawal": 1000000000,
            "network_fee": 0.5
        },
        {
            "symbol": "USDC",
            "contract_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "network": "Ethereum",
            "min_receipt": 2,
            "max_receipt": 1000000000,
            "min_withdrawal": 2,
            "max_withdrawal": 1000000000,
            "network_fee": 1.0e-5
        }
    ],
    "meta": {
        "total": 11,
        "generated_at": "2025-09-07 19:35:32"
    }
}

GET

/external/summary/fiats

Reveals the fiat currencies accepted by Asgard's vaults, with their symbols and sacred denominations.

Realms Coins200

{
    "message": "fiats_retrieved_success",
    "fiats": [
        {
            "code": "BRL",
            "name": "Brazilian Real",
            "symbol": "R$"
        },
        {
            "code": "USD",
            "name": "US Dollar",
            "symbol": "$"
        },
        {
            "code": "EUR",
            "name": "Euro",
            "symbol": "€"
        },
        {
            "code": "GBP",
            "name": "British Pound",
            "symbol": "£"
        },
        {
            "code": "ARS",
            "name": "Argentine Peso",
            "symbol": "$"
        },
        {
            "code": "MXN",
            "name": "Mexican Peso",
            "symbol": "$"
        },
        {
            "code": "CAD",
            "name": "Canadian Dollar",
            "symbol": "CA$"
        },
        {
            "code": "AUD",
            "name": "Australian Dollar",
            "symbol": "A$"
        },
        {
            "code": "CHF",
            "name": "Swiss Franc",
            "symbol": "CHF"
        },
        {
            "code": "JPY",
            "name": "Japanese Yen",
            "symbol": "¥"
        },
        {
            "code": "CNY",
            "name": "Chinese Yuan",
            "symbol": "¥"
        },
        {
            "code": "INR",
            "name": "Indian Rupee",
            "symbol": "₹"
        },
        {
            "code": "THB",
            "name": "Thai Baht",
            "symbol": "฿"
        }
    ],
    "meta": {
        "total": 13,
        "generated_at": "2025-09-07 19:38:19"
    }
}