# Bags

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/bags` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/bags |

## Description

Stream structured on-chain token and trading data from BagsThe Bags Scraper API provides reliable access to public data from Bags, the Solana-native ecosystem where creators can launch tokens, set royalties, and trade memecoins without handling complex blockchain scraping, node maintenance, or anti-bot challenges.Whether you’re building analytics dashboards, token explorers, price trackers, or creator earnings reports, our API lets you extract Bags data at scale in a structured, production-ready format.What Bags actually isBags is an all-in-one Solana platform to:Launch your own token or memecoin in minutesSet creator royalties that earn foreverDiscover and trade tokens and assets within a social marketplaceTrack performance, community growth, and trading activityAll of this happens natively on Solana no code required to get started. Why scrape Bags data?Unlike centralized APIs, on-chain apps like Bags don’t always expose full historical or structured data publicly. Retrieving it manually or by running your own node requires deep blockchain expertise.With our Scraper API, you can:Store structured token metadataMonitor trade volume, prices, and liquidityAnalyze royalty earnings and fee splitsBuild market insights and chartsDetect new token launches in real time

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/bags' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "stats": {
    "volume_24h": 1091,
    "current_price": 2.34,
    "total_fee_earned": 38.2
  },
  "symbol": "MYTOKEN",
  "creator": "F2ax...",
  "royalty": {
    "fee_shares": [
      {
        "recipient": "@partner",
        "percentage": 50
      }
    ],
    "percentage": 1
  },
  "last_updated": "2026-01-14T12:34:56Z",
  "token_address": "4Nd1m..."
}
```

## Documentation

## Overview
Stream structured on-chain token and trading data from BagsThe Bags Scraper API provides reliable access to public data from Bags, the Solana-native ecosystem where creators can launch tokens, set royalties, and trade memecoins without handling complex blockchain scraping, node maintenance, or anti-bot challenges.Whether you’re building analytics dashboards, token explorers, price trackers, or creator earnings reports, our API lets you extract Bags data at scale in a structured, production-ready format.What Bags actually isBags is an all-in-one Solana platform to:Launch your own token or memecoin in minutesSet creator royalties that earn foreverDiscover and trade tokens and assets within a social marketplaceTrack performance, community growth, and trading activityAll of this happens natively on Solana no code required to get started. Why scrape Bags data?Unlike centralized APIs, on-chain apps like Bags don’t always expose full historical or structured data publicly. Retrieving it manually or by running your own node requires deep blockchain expertise.With our Scraper API, you can:Store structured token metadataMonitor trade volume, prices, and liquidityAnalyze royalty earnings and fee splitsBuild market insights and chartsDetect new token launches in real time

## Quickstart
```
GET https://api.piloterr.com/v2/bags?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Bags data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Bags without maintaining scrapers
- Power internal dashboards and workflow automations with live Bags data