Announcements

How to Build On-Chain Crypto Trading Bots Using Token Metrics Crypto API and Chainlink Functions

How to Use Token Metrics Crypto API with Chainlink Function | Best Free Crypto API for Crypto Trading Bots
Token Metrics Team
8 min
MIN

In the evolving world of Web3 development, the need for real-time, reliable, and institutional-grade crypto data has never been greater. Whether you’re building decentralized trading bots, DeFi apps, or smart contract platforms, accessing powerful off-chain data is key to creating intelligent and profitable on-chain systems.

That’s where the Token Metrics Crypto API comes in.

In this guide, we’ll walk you through how to integrate the Token Metrics API with Chainlink Functions, enabling you to deploy live smart contracts that interact with real-time crypto signals, token prices, and trader grades. You’ll learn how to use more than 20 API endpoints and smart contract adapters to power decentralized apps with actionable data.

If you’re searching for the best crypto API for smart contract development, or you need a free crypto API to start testing on testnets, this article is your ultimate resource.

What Is the Token Metrics Crypto API?

The Token Metrics API is an advanced data interface designed for traders, developers, and Web3 builders. It provides access to over 20 endpoints covering everything from:

  • Token prices
  • AI-powered trading signals (bullish/bearish)
  • Trader and Investor Grades (0–100 scoring system)
  • Quant metrics
  • Support and resistance levels
  • Sentiment analysis

Built by a team of quant analysts, machine learning engineers, and crypto-native researchers, the Token Metrics Crypto API brings hedge-fund-grade intelligence into the hands of everyday builders.

Why Use the Token Metrics API with Chainlink Functions?

Chainlink Functions enable smart contracts to securely retrieve off-chain data from any API. By integrating with the Token Metrics Crypto API, you can bridge institutional-grade analytics into fully decentralized apps—something not possible with basic or unreliable data sources.

Here’s why this combo is so powerful:

  • đź”— Chainlink decentralizes your execution
  • đź§  Token Metrics powers your logic with predictive analytics
  • ⚙️ Smart contracts can now act on real market intelligence

This integration enables the creation of intelligent trading bots, dynamic token allocations, and governance proposals backed by hard data—not speculation.

Step-by-Step: How to Integrate Token Metrics API with Chainlink Functions

Let’s walk through how to connect the best crypto API—Token Metrics—with Chainlink Functions to build and deploy a live smart contract.

1. Clone the GitHub Repo

Start by cloning the GitHub repository that contains the full codebase. This includes:

  • A set of ~20 pre-built smart contracts
  • API adapter logic
  • Sample scripts to interact with the contracts
  • A detailed README with setup instructions

Each smart contract is tailored to one Token Metrics API endpoint—meaning you can plug and play any dataset, from prices to sentiment scores.

2. Set Up Your Environment

The README provides a full list of recommended environment variables, including:

  • API_KEY for Token Metrics
  • LINK_TOKEN_ADDRESS
  • CHAINLINK_SUBSCRIPTION_ID
  • ORACLE_ADDRESS

Once your .env is ready, you can start compiling and deploying.

3. Build and Deploy a Sample Trading Bot Smart Contract

In this walkthrough, the developer built a Solidity smart contract that:

  • Pulls live data from Token Metrics (price, signal, grade)
  • Evaluates the signal (e.g., bullish)
  • Executes a buy trade if the signal is positive

The contract is compiled in Remix IDE, connected via MetaMask (on testnet), and deployed using testnet ETH and LINK tokens.

After deployment, you’ll receive a contract address that can be added to your Chainlink subscription.

4. Create a Chainlink Subscription

To fund your contract for data requests:

  1. Go to the Chainlink portal
  2. Create a new subscription (testnet or mainnet)
  3. Fund it with some LINK
  4. Add your deployed smart contract as a consumer

This allows your contract to make external data calls using Chainlink’s decentralized oracle network.

5. Run a Script to Invoke Real-Time Token Metrics Data

Using the provided JavaScript scripts, you can interact with the smart contract and test data flow:

  • Check the bot’s active status
  • Retrieve token price, trading signal, and grade
  • See how the smart contract responds to live market conditions

In the demo, the bot received a bullish signal, saw that the grade was high, and executed a buy trade accordingly. This logic can be expanded into full-scale trading strategies, rebalancing rules, or even on-chain governance triggers.

Why Token Metrics API Is the Best Crypto API for Smart Contracts

Here’s what makes the Token Metrics Crypto API the best crypto API for building advanced, data-driven dApps:

âś… Institutional-Grade Signals

Get access to proprietary AI trading signals, used by hedge funds and institutional desks.

âś… 20+ Endpoints for Every Use Case

Whether you need sentiment data, grades, price trends, or quant models, it’s all there.

âś… Real-Time and Back-Tested

The data is not just live—it’s tested. Token Metrics backtests every signal against market conditions.

âś… Easy to Integrate

Pre-built smart contract adapters make it easy to use the API in Chainlink, Remix, or any EVM-compatible environment.

âś… Free Crypto API Tier Available

Start testing on testnets with a free crypto API key. Upgrade later for full production access.

Real-World Use Cases for Token Metrics + Chainlink Functions

Here are some examples of what you can build using this integration:

  • On-Chain Trading Bots: React to bullish or bearish signals in real time
  • Decentralized Rebalancing Strategies: Adjust token allocations based on trader grades
  • Token Governance: Trigger proposal alerts when sentiment crosses a threshold
  • Risk Management Contracts: Move funds to stablecoins when volatility spikes
  • NFT Floor Price Triggers: Use sentiment and price data for automated mint/pass logic

Final Thoughts: The Future of Crypto Intelligence Is On-Chain

As Web3 matures, the ability to combine decentralized execution with centralized intelligence will define the next generation of dApps. The integration of Token Metrics Crypto API with Chainlink Functions is a major step in that direction.

Developers can now build on-chain applications that make smarter, faster, and more profitable decisions—powered by data that was once out of reach.

Whether you're a DeFi developer, a DAO engineer, or just exploring your first smart contract, this setup gives you a free crypto API to experiment with and the power of the best crypto API when you're ready to scale.

🚀 Ready to Get Started?

  • âś… Get your free Token Metrics API key
  • âś… Clone the GitHub repo and install the smart contracts
  • âś… Join the Token Metrics Dev Telegram community
  • âś… Start building intelligent, AI-powered crypto applications today

Your next-generation crypto trading bot starts here.

Build Smarter Crypto Apps &
AI Agents in Minutes, Not Months
Real-time prices, trading signals, and on-chain insights all from one powerful API.
Grab a Free API Key
Token Metrics Team
Token Metrics Team

Recent Posts

Research

Crypto Trading Signals API: Put Bullish/Bearish Calls Right in Your App

Token Metrics Team
4
MIN

Timing makes or breaks every trade. The crypto trading signals API from Token Metrics lets you surface bullish and bearish calls directly in your product—no spreadsheet wrangling, no chart gymnastics. In this guide, you’ll hit the /v2/trading-signals endpoint, display actionable signals on a token (e.g., SOL, BTC, ETH), and ship a conversion-ready feature for bots, dashboards, or Discord. Start by creating a key on Get API Key, then Run Hello-TM and Clone a Template to go live fast.

What You’ll Build in 2 Minutes

  • A minimal script that fetches Trading Signals via /v2/trading-signals for one symbol (e.g., SOL).
  • A copy-paste curl to smoke-test your key.
  • A UI pattern to render signal, confidence/score, and timestamp in your dashboard or bot.

Endpoints to add next

  • /v2/hourly-trading-signals (intraday updates)
  • /v2/resistance-support (risk placement)
  • /v2/tm-grade (one-score view)
  • /v2/quantmetrics (risk/return context)

Why This Matters

Action over analysis paralysis. Traders don’t need more lines on a chart—they need an opinionated call they can automate. The trading signals API compresses technical momentum and regime reads into Bullish/Bearish events you can rank, alert on, and route into strategies.

Built for dev speed and reliability. A clean schema, predictable performance, and straightforward auth make it easy to wire signals into bots, dashboards, and community tools. Pair with short-TTL caching or webhooks to minimize polling and keep latency low.

Where to Find

You can find the cURL request for Crypto Trading Signals in the top right corner of the API Reference. Use it to access the latest signals!

Live Demo & Templates

  • Trading Bot Starter: Use Bullish/Bearish calls to trigger paper trades; add take-profit/stop rules with Support/Resistance.
  • Dashboard Signal Panel: Show the latest call, confidence, and last-updated time; add a history table for context.
  • Discord/Telegram Alerts: Post signal changes to a channel with a link back to your app.

How It Works (Under the Hood)

Trading Signals distill model evidence (e.g., momentum regimes and pattern detections) into Bullish or Bearish calls with metadata such as confidence/score and timestamp. You request /v2/trading-signals?symbol=<ASSET> and render the most recent event, or a small history, in your UI.

For intraday workflows, use /v2/hourly-trading-signals to update positions or alerts more frequently. Dashboards typically use short-TTL caching or batched fetches; headless bots lean on webhooks, queues, or short polling with backoff to avoid spiky API usage.

Production Checklist

  • Rate limits: Know your tier caps; add client-side throttling and queues.
  • Retries/backoff: Exponential backoff with jitter; treat 429/5xx as transient.
  • Idempotency: Guard downstream actions (don’t double-trade on retries).
  • Caching: Memory/Redis/KV with short TTLs for reads; pre-warm popular symbols.
  • Webhooks & jobs: Prefer webhooks or scheduled workers for signal change alerts.
  • Pagination/Bulk: Batch symbols; parallelize with care; respect limits.
  • Error catalog: Map common 4xx/5xx to clear fixes; log request IDs.
  • Observability: Track p95/p99 latency, error rate, and alert delivery success.
  • Security: Keep keys in a secrets manager; rotate regularly.

Use Cases & Patterns

  • Bot Builder (Headless): Route Bullish into candidate entries; confirm with /v2/resistance-support for risk and TM Grade for quality.
  • Dashboard Builder (Product): Add a “Signals” module per token; color-code state and show history for credibility.
  • Screener Maker (Lightweight Tools): Filter lists by Bullish state; sort by confidence/score; add alert toggles.
  • Community/Discord: Post signal changes with links to token pages; throttle to avoid noise.
  • Allocator/PM Tools: Track signal hit rates by sector/timeframe to inform position sizing (paper-trade first).

Next Steps

  1. Get API Key — create a key and start free.
  2. Run Hello-TM — confirm your first successful call.
  3. Clone a Template — deploy a bot, dashboard, or alerting tool today.

FAQs

1) What does the Trading Signals API return?

A JSON payload with the latest Bullish/Bearish call for a symbol, typically including a confidence/score and generated_at timestamp. You can render the latest call or a recent history for context.

2) Is it real-time? What about latency/SLOs?

Signals are designed for timely, programmatic use with predictable latency. For faster cycles, use /v2/hourly-trading-signals. Add caching and queues/webhooks to reduce round-trips.

3) Can I use the signals in a live trading bot?

Yes—many developers do. A common pattern is: Signals → candidate entry, Support/Resistance → stop/targets, Quantmetrics → risk sizing. Always backtest and paper-trade before going live.

4) How accurate are the signals?

Backtests are illustrative, not guarantees. Treat signals as one input in a broader framework with risk controls. Evaluate hit rates and drawdowns on your universe/timeframe.

5) Do you provide SDKs and examples?

You can integrate via REST using JavaScript and Python snippets above. The docs include quickstarts, Postman collections, and templates—start with Run Hello-TM.

6) Polling vs webhooks for alerts?

Dashboards often use cached polling. For bots/alerts, prefer webhooks or scheduled jobs and keep retries idempotent to avoid duplicate trades or messages.

7) Pricing, limits, and enterprise SLAs?

Begin free and scale as you grow. See API plans for allowances; enterprise SLAs and support are available.

Research

Fundamental Grade Crypto API: Real Crypto Fundamentals in One Score

Token Metrics Team
3
MIN

Most traders chase price action; Fundamental Grade Crypto API helps you see the business behind the token—community traction, tokenomics design, exchange presence, VC signals, and DeFi health—consolidated into one score you can query in code. In a few minutes, you’ll fetch Fundamental Grade, render it in your product, and ship a due-diligence UX that drives trust. Start by grabbing your key at the Get API Key page, Run Hello-TM to verify your first call, then Clone a Template to go live fast.

What You’ll Build in 2 Minutes

A minimal script to fetch Fundamental Grade from /v2/fundamental-grade for any symbol (e.g., BTC).

  • Optional curl to smoke-test your key in seconds.
  • A drop-in pattern to display the grade + key drivers in dashboards, screeners, and research tools.

Endpoints to consider next

  • /v2/tm-grade (technical/sentiment/momentum)
  • /v2/price-prediction (scenario planning)
  • /v2/resistance-support (risk levels)
  • /v2/quantmetrics (risk/return stats)

Why This Matters

Beyond price, toward quality. Markets are noisy—hype rises and fades. Fundamental Grade consolidates hard-to-track signals (community growth, token distribution, liquidity venues, investor quality, DeFi integrations) into a clear, comparable score. You get a fast “is this worth time and capital?” answer for screening, allocation, and monitoring.

Build trust into your product. Whether you run an investor terminal, exchange research tab, or a portfolio tool, Token Metrics discovery helps users justify positions. Pair it with TM Grade or Quantmetrics for a balanced picture: what to buy (fundamentals) and when to act (signals/levels).

Where to Find

The Fundamental Grade is easily accessible in the top right of the API Reference. Grab the cURL request for seamless access!

Ready to build?

  • Get API Key — generate a key and start free.
  • Run Hello-TM — verify your first successful call.
  • Clone a Template — deploy a screener or token page today.

Watch the demo: VIDEO_URL_HERE. Compare plans: Scale confidently with API plans.

FAQs

1) What does the Fundamental Grade API return?

A JSON payload with the overall score/grade plus component scores (e.g., community, tokenomics, exchange presence, VC backing, DeFi health) and timestamps. Use the overall grade for ranking and component scores for explanations.

2) How fast is the endpoint? Do you publish SLOs?

The API is engineered for predictable latency. For high-traffic dashboards, add short-TTL caching and batch requests; for alerts, use jobs/webhooks to minimize round-trips.

3) Can I combine Fundamental Grade with TM Grade or signals?

Yes. A common pattern is Fundamental Grade for quality filter + TM Grade for technical/sentiment context + Trading Signals for timing and Support/Resistance for risk placement.

4) How “accurate” is the grade?

It’s an opinionated synthesis of multiple inputs—not financial advice. Historical studies can inform usage, but past performance doesn’t guarantee future results. Always layer risk management and testing.

5) Do you offer SDKs and examples?

You can use REST directly (see JS/Python above). The docs include quickstarts, Postman, and ready-to-clone templates—start with Run Hello-TM.

6) Polling vs webhooks for fundamentals updates?

For UI pages, cached polling works well. For event-style notifications (upgrades/downgrades), prefer webhooks or scheduled jobs to avoid spiky traffic.

7) What about pricing, limits, and enterprise SLAs?

Begin free and scale as you grow. See API plans for allowances; enterprise SLAs and support are available—contact us.

Research

Fundamental Grade Crypto API: Invest with Conviction Using Real Project Signals

Token Metrics Team
4
MIN

Most traders chase price action; Fundamental Grade Crypto API helps you see the business behind the token—community traction, tokenomics design, exchange presence, VC signals, and DeFi health—consolidated into one score you can query in code. In a few minutes, you’ll fetch Fundamental Grade, render it in your product, and ship a due-diligence UX that drives trust. Start by grabbing your key at the Get API Key page, Run Hello-TM to verify your first call, then Clone a Template to go live fast.

What You’ll Build in 2 Minutes

A minimal script to fetch Fundamental Grade from /v2/fundamental-grade for any symbol (e.g., BTC).

  • Optional curl to smoke-test your key in seconds.
  • A drop-in pattern to display the grade + key drivers in dashboards, screeners, and research tools.

Endpoints to consider next:

  • /v2/tm-grade (technical/sentiment/momentum)
  • /v2/price-prediction (scenario planning)
  • /v2/resistance-support (risk levels)
  • /v2/quantmetrics (risk/return stats)

Why This Matters

Beyond price, toward quality. Markets are noisy—hype rises and fades. Fundamental Grade consolidates hard-to-track signals (community growth, token distribution, liquidity venues, investor quality, DeFi integrations) into a clear, comparable score. You get a fast “is this worth time and capital?” answer for screening, allocation, and monitoring.

Build trust into your product. Whether you run an investor terminal, exchange research tab, or a portfolio tool, Fundamental Grade lets users justify positions. Pair it with TM Grade or Quantmetrics for a balanced picture: what to buy (fundamentals) and when to act (signals/levels).

Where to Find The Fundamental Grade

The Fundamental Grade is easily accessible in the top right of the API Reference. Grab the cURL request for seamless access!

Build Smarter Crypto Apps & AI Agents with Token Metrics

Token Metrics provides real-time prices, trading signals, and on-chain insights all from one powerful API. Grab a Free API Key

How It Works (Under the Hood)

Fundamental Grade aggregates multiple project-quality signals into a normalized score and label (e.g., Strong / Average / Weak). Typical sub-signals include:

  • Community: momentum across channels (dev activity/user traction signals where applicable).
  • Tokenomics: supply schedule, distribution, unlock dynamics, incentives.
  • Exchange Presence: venue coverage, depth/liquidity proxies.
  • VC/Investor Signals: quality/durability of backing and ecosystem support.
  • DeFi Health: integrations, TVL context, composability footprint.

At query time, you call /v2/fundamental-grade with a symbol; responses include the overall score plus component scores you can visualize. For dashboards with many assets, batch fetches and short-TTL caching keep pages responsive. If you push alerts (e.g., “Fundamental Grade upgraded”), prefer webhooks or queued jobs to avoid hammering the API.

Production Checklist

  • Rate limits: Know plan caps; add client throttling and request queues.
  • Retries/backoff: Exponential backoff + jitter; surface actionable error messages.
  • Idempotency: Prevent duplicate downstream actions on retried calls.
  • Caching: Use memory/Redis/KV with short TTLs; pre-warm popular symbols.
  • Webhooks & jobs: For alerts, use signed webhooks or scheduled jobs; log delivery outcomes.
  • Pagination/Bulk: When covering many tokens, paginate or process in batches.
  • Error catalog: Map 4xx/5xx to user-visible fixes; log request IDs.
  • Observability: Track p95/p99 and error rate per endpoint; alert on spikes.
  • Security: Keep API keys in secrets managers; rotate regularly.

Use Cases & Patterns

  • Screener Maker: Rank tokens by Fundamental Grade, filter by market cap/sector, and add “rising fundamentals” badges for discovery.
  • Dashboard Builder: On each token page, show the headline grade with a component chart; link to methodology for transparency.
  • Research & PM Tools: Flag downgrades/upgrades to prompt re-evaluation; attach notes to component changes (e.g., DeFi health drop).
  • Allocator / Risk: Require a minimum Fundamental Grade before inclusion; rebalance only when grade crosses thresholds.
  • Community/Discord: Post weekly upgrades as digest messages with links back to your app.

Next Steps

  • Get API Key — generate a key and start free.
  • Run Hello-TM — verify your first successful call.
  • Clone a Template — deploy a screener or token page today.
  • Watch the demo: VIDEO_URL_HERE
  • Compare plans: Scale confidently with API plans.

FAQs

1) What does the Fundamental Grade API return?

A JSON payload with the overall score/grade plus component scores (e.g., community, tokenomics, exchange presence, VC backing, DeFi health) and timestamps. Use the overall grade for ranking and component scores for explanations.

2) How fast is the endpoint? Do you publish SLOs?

The API is engineered for predictable latency. For high-traffic dashboards, add short-TTL caching and batch requests; for alerts, use jobs/webhooks to minimize round-trips.

3) Can I combine Fundamental Grade with TM Grade or signals?

Yes. A common pattern is Fundamental Grade for quality filter + TM Grade for technical/sentiment context + Trading Signals for timing and Support/Resistance for risk placement.

4) How “accurate” is the grade?

It’s an opinionated synthesis of multiple inputs—not financial advice. Historical studies can inform usage, but past performance doesn’t guarantee future results. Always layer risk management and testing.

5) Do you offer SDKs and examples?

You can use REST directly (see JS/Python above). The docs include quickstarts, Postman, and ready-to-clone templates—start with Run Hello-TM.

Choose from Platinum, Gold, and Silver packages
Reach with 25–30% open rates and 0.5–1% CTR
Craft your own custom ad—from banners to tailored copy
Perfect for Crypto Exchanges, SaaS Tools, DeFi, and AI Products