v1Public Beta

WhaleFactor API

Access crypto news, articles, and glossary data programmatically. Build dashboards, bots, research tools, or anything else with our REST API.

Get Your API KeyView Endpoints

Quick Start

1

Get your API key

Fill out the form below. It takes 5 seconds. Free tier gives you 100 requests/day.

2

Make your first request

Pass your key in the Authorization header or as a query parameter.

3

Build something cool

Crypto dashboards, Telegram bots, research pipelines, whatever you want.

Authentication

Every request needs an API key. Pass it one of two ways:

Option 1: Authorization Header (recommended)

Authorization: Bearer wf_your_key_here

Option 2: Query Parameter

GET /api/v1/articles?api_key=wf_your_key_here

Base URL

https://www.whalefactor.com/api/v1

All endpoints are relative to this base URL. Responses are JSON.

Response Format

Success

json
{
  "success": true,
  "data": [...],
  "meta": {
    "total": 100,
    "limit": 20,
    "offset": 0,
    "tier": "free",
    "requests_remaining": 95
  }
}

Error

json
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your daily request limit."
  }
}

Endpoints

GET/api/v1/articles

List published featured articles with pagination and filtering.

Parameters

categorystringFilter by category slug
qstringSearch articles by title or summary
authorstringFilter by author name
limitintegerResults per page (1-50, default 20)
offsetintegerPagination offset (default 0)
sortstringSort order: newest (default) or oldest
GET/api/v1/articles/:slug

Get a single article by slug. Free tier returns summary only. Pro/Enterprise gets full content.

GET/api/v1/articles/trending

Top 20 most recent featured articles.

GET/api/v1/categories

List all categories with article counts.

GET/api/v1/glossary

Search and browse 600+ crypto glossary terms.

Parameters

qstringSearch terms by name or definition
letterstringFilter by first letter (A-Z)
categorystringFilter by category (defi, blockchain, etc.)
limitintegerResults per page (1-100, default 50)
offsetintegerPagination offset (default 0)
GET/api/v1/glossary/:term

Get a single glossary term with full definition and related terms.

Code Examples

bash
# List trending articles
curl -s "https://www.whalefactor.com/api/v1/articles/trending" \
  -H "Authorization: Bearer wf_your_key_here"

# Search articles
curl -s "https://www.whalefactor.com/api/v1/articles?q=bitcoin&limit=10" \
  -H "Authorization: Bearer wf_your_key_here"

# Get a glossary term
curl -s "https://www.whalefactor.com/api/v1/glossary/defi" \
  -H "Authorization: Bearer wf_your_key_here"

Plans & Rate Limits

Free

$0

100 requests/day

  • Article listings and search
  • Article summaries
  • Full glossary access
  • Category data
Get Free Key

Pro

$29/mo

10,000 requests/day

  • Everything in Free
  • Full article content (HTML)
  • Article sources and metadata
  • Priority support

Enterprise

Custom

Unlimited requests

  • Everything in Pro
  • Dedicated support
  • Custom integrations
  • SLA guarantee

Get Your API Key

Error Codes

HTTPCodeDescription
401MISSING_API_KEYNo API key provided in request
401INVALID_API_KEYAPI key doesn't exist or is malformed
401API_KEY_DISABLEDKey has been deactivated
429RATE_LIMIT_EXCEEDEDDaily request limit reached
404NOT_FOUNDResource doesn't exist
500INTERNAL_ERRORSomething went wrong on our end

Built by LXGIC Studios