Third-Party Services

Fystack integrates with several external services. Set up the ones you need before starting Fystack.

CoinMarketCap (Mandatory)

CoinMarketCap provides token pricing data. This is the only mandatory third-party service — Fystack requires it to display asset values.

Get an API Key

1. Go to pro.coinmarketcap.com
2. Create an account (free tier works for development)
3. Copy your API key from the dashboard

Configure

In config.yaml:

price_providers:
  coinmarketcap:
    endpoint: "https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest"
    api_key: "your-api-key-here"

warning

Without a valid CoinMarketCap API key, Fystack will not display token prices. The free tier includes 10,000 API calls per month, which is sufficient for most setups.

Other Price Providers (Optional)

Fystack also supports DexScreener and Codex as supplementary price sources:

price_providers:
  dexscreener:
    endpoint: "https://api.dexscreener.com/latest/dex/search"
    # No API key needed
  codex:
    endpoint: "https://graph.defined.fi/graphql"
    api_key: ""  # Optional, for on-chain DeFi price data

---

Resend — Email Notifications (Optional)

Fystack uses Resend to send transactional emails such as user invitations and password resets.

Not required for testing

Email is not required to get started. In the default setup, signup works without email verification. You only need Resend if you want to send email invitations or password reset links.

Get an API Key

1. Go to resend.com and create an account
2. Navigate to Domains and add your sending domain (e.g., yourdomain.com)
3. Verify your domain — Resend will ask you to add DNS records (SPF, DKIM). Follow the instructions to add the records at your DNS provider and click Verify.
4. Once the domain is verified, create an API key from the dashboard

Domain verification required

Emails sent from an unverified domain will fail or land in spam. Make sure your domain shows as Verified in the Resend dashboard before configuring Fystack. Without verification, Resend will only allow sending to the account owner's email address.

Configure

In config.yaml:

email:
  resend_api_key: "re_your_api_key_here"
  sender_name: "Your Company"
  sender_email: "noreply@yourdomain.com"

Field	Description
resend_api_key	Your Resend API key
sender_name	The "from" name that appears in emails
sender_email	The "from" email address — must be on a verified domain in Resend

---

Google OAuth (Optional)

Enable "Sign in with Google" for your Fystack instance.

Create OAuth Credentials

1. Go to Google Cloud Console
2. Create a new project (or select an existing one)
3. Navigate to APIs & Services > Credentials
4. Click Create Credentials > OAuth 2.0 Client ID
5. Set the application type to Web application
6. Add your authorized redirect URI:
   • Local: http://localhost:8150/api/v1/authentication/google/callback
   • VPS: https://api.yourdomain.com/api/v1/authentication/google/callback
7. Copy the Client ID and Client Secret

Configure

In config.yaml:

oauth2:
  google:
    client_id: "123456789-abcdefg.apps.googleusercontent.com"
    client_secret: "GOCSPX-your-secret-here"
    callback_url: "http://localhost:8150/api/v1/authentication/google/callback"

VPS deployment

Update callback_url to your public API URL when deploying to a VPS:

callback_url: "https://api.yourdomain.com/api/v1/authentication/google/callback"

The callback URL must exactly match what you configured in the Google Cloud Console.

---

Telegram Bot — Alerts & Notifications (Optional)

Fystack can send system alerts and notifications to a Telegram chat via a bot.

Create a Telegram Bot

1. Open Telegram and search for @BotFather
2. Send /newbot and follow the prompts to create a bot
3. Copy the bot token (looks like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
4. Note the bot username (starts with @)

Configure

In config.yaml:

telegram:
  bot_token: "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
  long_polling: true
  bot_name: "@YourBotName"

Field	Description
bot_token	The token from BotFather
long_polling	Keep as true — the bot polls for messages
bot_name	Your bot's username, starting with @

---

TronGrid API Key (Optional)

Required if you're using Tron mainnet. Testnet (Shasta) works without an API key.

Get an API Key

1. Go to trongrid.io
2. Sign up and create an API key

Configure

In config.yaml, add the API key as a header:

networks:
  TRON_MAINNET:
    enabled: true
    rpc_nodes:
      - url: "https://api.trongrid.io/"
        headers:
          TRON-PRO-API-KEY: "your-trongrid-api-key"

Without this key, Tron mainnet requests will be heavily rate-limited.

---

Summary

Service	Required?	Purpose	Free Tier?
CoinMarketCap	Yes	Token pricing	Yes (10k calls/month)
Resend	No	Email invitations & password resets	Yes (100 emails/day)
Google OAuth	No	"Sign in with Google"	Yes
Telegram Bot	No	System alerts & notifications	Yes
TronGrid	No (only for Tron mainnet)	Tron RPC access	Yes (rate-limited)

Next Steps

Once you've configured at least the CoinMarketCap API key, proceed to Start Fystack.