# API Keys Required for External Integrations

**Last Updated:** 2026-01-31  
**Use with:** reports/PRIORITIZED_TASKS_20260131.md (ext tasks)

---

## Cross-Chain & DeFi Routing

| Service | Env Variable | Where Used | Sign-up URL |
|---------|--------------|------------|-------------|
| **Li.Fi** | `LIFI_API_KEY` | alltra-lifi-settlement | https://li.fi |
| **Jumper** | `JUMPER_API_KEY` | alltra-lifi-settlement, .env.example | https://jumper.exchange |
| **1inch** | `ONEINCH_API_KEY` | chain138-quote.service.ts (api.1inch.dev) | https://portal.1inch.dev |
| **LayerZero** | Config/API | Bridge integrations | https://layerzero.network |
| **Wormhole** | API key | Bridge integrations | https://wormhole.com |

---

## Fiat On/Off Ramp

| Service | Env Variable | Where Used | Sign-up URL |
|---------|--------------|------------|-------------|
| **MoonPay** | `MOONPAY_API_KEY` | metamask-integration/ramps | https://www.moonpay.com/business |
| **MoonPay** | `MOONPAY_SECRET_KEY` | Optional | Same |
| **Ramp Network** | `RAMP_NETWORK_API_KEY` | metamask-integration/ramps | https://ramp.network/developers |
| **Onramper** | `ONRAMPER_API_KEY` | Fallback on-ramp | https://onramper.com |

---

## E-Signature & Legal

| Service | Env Variable | Where Used | Sign-up URL |
|---------|--------------|------------|-------------|
| **DocuSign** | `E_SIGNATURE_BASE_URL` + API key | the-order/legal-documents | https://developers.docusign.com |

---

## Alerts & Monitoring

| Service | Env Variable | Where Used | Sign-up URL |
|---------|--------------|------------|-------------|
| **Slack** | `SLACK_WEBHOOK_URL` | dbis_core alert.service | Incoming Webhooks in Slack |
| **PagerDuty** | `PAGERDUTY_INTEGRATION_KEY` | dbis_core alert.service | https://developer.pagerduty.com |
| **Email** | `EMAIL_ALERT_API_URL`, `EMAIL_ALERT_RECIPIENTS` | dbis_core (e.g. SendGrid) | SendGrid, etc. |

---

## Block Explorers & Price Data

| Service | Env Variable | Where Used | Sign-up URL |
|---------|--------------|------------|-------------|
| **Etherscan** | `ETHERSCAN_API_KEY` | Contract verification | https://etherscan.io/apis |
| **CoinGecko** | `COINGECKO_API_KEY` | Oracle, token aggregation | https://www.coingecko.com/en/api/pricing |
| **CoinMarketCap** | `COINMARKETCAP_API_KEY` | token-aggregation (optional) | https://pro.coinmarketcap.com |

---

## Already in .env.example

| Variable | Notes |
|----------|-------|
| `CLOUDFLARE_API_TOKEN` | Or CLOUDFLARE_EMAIL + CLOUDFLARE_API_KEY |
| `JUMPER_API_KEY` | Tezos/Etherlink cross-chain |
| `COINGECKO_API_KEY` | Has placeholder; free tier available |

---

**Where to set:** Root `.env` and subproject `.env` (e.g. `dbis_core/.env.example`, `the-order/services/legal-documents/.env.example`). Copy from each repo's `.env.example`; see [docs/00-meta/API_KEYS_DOTENV_STATUS.md](../docs/00-meta/API_KEYS_DOTENV_STATUS.md) for placeholder status.

## Quick Checklist (for ext task)

- [ ] LIFI_API_KEY
- [ ] JUMPER_API_KEY
- [ ] ONEINCH_API_KEY
- [ ] MOONPAY_API_KEY
- [ ] RAMP_NETWORK_API_KEY
- [ ] ETHERSCAN_API_KEY (if verifying contracts)
- [ ] SLACK_WEBHOOK_URL (optional, for alerts)