# Bitfinex Crypto Tickers Scraper (`parseforge/bitfinex-tickers-scraper`) Actor

Scrapes live ticker data from Bitfinex for all spot trading pairs. Returns each ticker as a flat row with last price, bid, ask, 24h volume, and percentage change. Filter by quote currency and sort by volume or price movement.

- **URL**: https://apify.com/parseforge/bitfinex-tickers-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Developer tools, Automation
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $23.70 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Bitfinex Crypto Tickers Scraper

**Scrape live crypto tickers from Bitfinex, filtered by quote asset and sorted by volume or price change.** Every ticker includes last price, 24h volume, bid, ask, and percentage change. No API key required. Export to CSV, JSON, Excel, or XML.

Bitfinex's REST API endpoints impose rate limits and require careful pagination logic when you need a broad market snapshot. This Actor reads the public ticker feed directly, lets you filter by quote currency like USD, UST, or BTC, and returns a clean, sorted dataset in one run. It is built for traders, bots, and portfolio trackers who need a fast, structured view of the entire Bitfinex spot market.

| Who uses it | What they scrape Bitfinex for |
|---|---|
| Quantitative traders | Feeding a sorted list of the most active pairs into a volatility scanner |
| Market analysts | Tracking 24h volume and price change across the entire USD-quoted market |
| Crypto bot operators | Pulling a filtered list of USDT pairs as input for a trading strategy |
| Portfolio managers | Getting a quick snapshot of last prices for all held assets quoted in BTC |

### What it does

This Actor collects live ticker data for all trading pairs on Bitfinex and returns each one as a flat row with price, volume, bid, ask, and 24h change.

- 💱 **Quote asset filter:** restrict results to pairs quoted in USD, USDT, USDC, BTC, ETH, EUR, GBP, or JPY.
- 📊 **Flexible sorting:** order tickers by 24h base volume, percentage change, last price, or symbol name.
- 🔢 **Result capping:** set a maximum number of tickers to collect, from a single pair up to the full market.
- ⚡ **Zero authentication:** reads Bitfinex's public ticker endpoint with no API key, login, or IP whitelist.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Bitfinex data

**📈 Build a market heatmap.**

A quant researcher pulls all USD-quoted tickers sorted by 24h volume to identify where liquidity is concentrating this hour.

**🤖 Feed a trading bot.**

A bot operator collects the top 50 USDT pairs by percentage change and passes the symbols to a momentum strategy.

**💼 Monitor a BTC-denominated portfolio.**

A fund manager scrapes all pairs quoted in BTC to value altcoin positions without converting through USD first.

**📋 Audit stablecoin pairs.**

A compliance analyst filters for USDC pairs and sorts by last price to spot deviations from the dollar peg.

### Why choose this scraper

|  | What you get |
|---|---|
| **No rate-limit headaches** | The Actor handles the request and parsing in one call, so you avoid REST API pagination and throttling. |
| **Fixed flat schema** | Every ticker arrives as a predictable row with last price, bid, ask, 24h volume, and daily change. |
| **Multi-format export** | Download your ticker snapshot as CSV, JSON, Excel, or XML for direct use in spreadsheets or scripts. |

### How it compares

Both actors scrape the same Bitfinex public ticker feed and return price, volume, and 24h change. This actor adds quote-asset filtering and multi-field sorting directly in the input.

| Feature | ParseForge | Bitfinex Crypto Ticker Scraper - Price, Volume & 24h Change |
|---|---|---|
| Quote asset filter (USD, USDT, BTC, etc.) | Yes, select from 8 quote currencies | Not listed |
| Sort by volume, change, price, or symbol | Yes, four sort options in input | Not listed |
| Last price field | Yes | Yes |
| Bid and ask fields | Yes | Yes |
| 24h base volume field | Yes | Yes |
| 24h percentage change field | Yes | Yes |

### Configure the run

Drive the Actor by selecting a quote asset, a sort order, and a maximum number of tickers; filters apply before results are written so your dataset contains only the pairs you need. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "maxItems": 10,
  "sortBy": "volume"
}
```

A larger pull:

```json
{
  "maxItems": 200,
  "sortBy": "volume"
}
```

### Pricing

Pay-per-result: **$0.0316 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $3.16 |
| 1,000 results | $31.60 |
| 10,000 results | $316.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Bitfinex Crypto Tickers Scraper](https://apify.com/parseforge/bitfinex-tickers-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Bitfinex through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/bitfinex-tickers-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting fewer tickers than I set in maxItems?**

The Actor returns only the tickers that match your quote asset filter. If you selected USD but only 80 USD pairs exist on Bitfinex, you will get at most 80 rows even if maxItems is set to 200.

**Why is the 24h volume zero for some pairs?**

Bitfinex reports the volume as provided by its engine. Newly listed or extremely illiquid pairs may show zero or very low 24h volume. This is the value from the exchange, not an error in the Actor.

**The run failed with a timeout. What should I do?**

The Actor makes one HTTP request to Bitfinex. A timeout usually means Bitfinex's public endpoint was slow to respond. Retry the run after a minute. If it persists, check Bitfinex's status page for outages.

**Can I get historical ticker data from yesterday?**

No. This Actor reads the live public ticker endpoint, which returns current values only. For historical snapshots, schedule the Actor to run at intervals and store each run's dataset.

**Why do some symbols look different from what I see on the Bitfinex website?**

The Actor returns symbols exactly as Bitfinex's API represents them (e.g., 'tBTCUSD'). The prefix 't' denotes a trading pair. This is the native symbol format from the exchange.

### FAQ

| Question | Answer |
|---|---|
| Does this Actor need a Bitfinex API key? | No. It reads the public ticker endpoint that Bitfinex serves without authentication, so no API key or account is required. |
| What fields does each ticker row contain? | Each row includes the trading pair symbol, last price, bid, ask, 24h base volume, and 24h percentage change. The exact field list is shown in the sample output on the Actor's page. |
| Can I get only USDT pairs? | Yes. Set the Quote Asset Filter to 'USDT (UST)' and the Actor will return only pairs where the quote currency is USDT. |
| How many tickers can I collect in one run? | You can set the maximum anywhere from 1 to 1,000,000. The Actor will return up to that many tickers after applying your filter and sort order. |
| Does this include margin or derivatives tickers? | This Actor scrapes the spot market ticker feed. Margin and derivatives symbols are not included in the public ticker endpoint it reads. |
| How often should I run this Actor? | Bitfinex tickers update in real time. You can schedule the Actor to run every minute for near-live data, or less frequently for periodic snapshots. |
| Can I sort by the highest gainers? | Yes. Choose '24h % change (desc)' in the Sort By dropdown to get pairs with the largest positive daily change first. |
| What output formats are supported? | You can export your dataset as CSV, JSON, Excel, or XML from the Apify dataset tab after the run finishes. |
| Does this Actor handle delisted or inactive pairs? | The Actor returns whatever pairs Bitfinex's public ticker endpoint currently serves. Inactive or delisted pairs are typically removed from that feed by Bitfinex. |
| Is this faster than calling the Bitfinex REST API myself? | It is a single request to the ticker endpoint with no pagination, so it returns the full market snapshot in one response. The Actor adds filtering, sorting, and structured export on top. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Bitfinex. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `quoteAsset` (type: `string`):

Filter trading pairs by quote asset (e.g. USD, UST, BTC). Leave empty for all pairs.

## `maxItems` (type: `integer`):

Maximum number of tickers to collect per run.

## `sortBy` (type: `string`):

Sort results by this field

## Actor input object example

```json
{
  "quoteAsset": "",
  "maxItems": 10,
  "sortBy": "volume"
}
```

# Actor output Schema

## `overview` (type: `string`):

Overview of scraped data

## `fullData` (type: `string`):

Complete dataset

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "quoteAsset": "",
    "maxItems": 10,
    "sortBy": "volume"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/bitfinex-tickers-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "quoteAsset": "",
    "maxItems": 10,
    "sortBy": "volume",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/bitfinex-tickers-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "quoteAsset": "",
  "maxItems": 10,
  "sortBy": "volume"
}' |
apify call parseforge/bitfinex-tickers-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/bitfinex-tickers-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7On5Os3l6KJDB0MCT/builds/U3BFcMCGe1EfKl0XZ/openapi.json