# Gmgn — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Monitor real-time Solana token trends and analyze detailed token statistics, security data, holder information, and trading activity all in one place. Track top traders and their wallet performance to make informed decisions about emerging cryptocurrencies on the Solana blockchain.

**Category:** Web3 & Onchain | **Website:** [gmgn.ai/](https://gmgn.ai/) | **Docs:** [parse.bot/marketplace/042b4dd6-3a7e-4d36-a81d-90fb8557a9db/gmgn-ai-api](https://parse.bot/marketplace/042b4dd6-3a7e-4d36-a81d-90fb8557a9db/gmgn-ai-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_token_candles

Retrieve OHLCV market-cap candlestick data for a token. Each candle contains open/high/low/close (in market-cap terms) plus volume and token amount for the interval. Single-page response; use limit to control count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Token contract address |
| `chain` | string | No | Blockchain network identifier (e.g. sol, eth, base, bsc, tron) |
| `limit` | integer | No | Number of candles to return (max 500) |
| `resolution` | string | No | Candle interval resolution. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/get_token_candles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","chain":"<string>","limit":"<integer>","resolution":"<string>"}'
```

### get_token_holders

Retrieve the holder list for a token ordered by holding percentage descending. Each holder includes balance, USD value, realized profit, cost basis, and wallet tags. Supports cursor-based pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Token contract address |
| `chain` | string | No | Blockchain network identifier (e.g. sol, eth, base, bsc, tron) |
| `cursor` | string | No | Opaque pagination cursor from the previous response's next field |
| `limit` | integer | No | Number of holders to return per page |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/get_token_holders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","chain":"<string>","cursor":"<string>","limit":"<integer>"}'
```

### get_token_info

Retrieve comprehensive token statistics and security details for a specific token by contract address. Returns holder analytics (holder count, top-10 concentration, dev holdings) and security flags (renounced mint, honeypot status, burn ratio) plus launchpad info. One round-trip per token.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Token contract address |
| `chain` | string | No | Blockchain network identifier (e.g. sol, eth, base, bsc, tron) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/get_token_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","chain":"<string>"}'
```

### get_token_trades

Retrieve the most recent trades for a token. Each trade includes maker address, amounts, USD value, price, event type (buy/sell), and transaction hash. Supports cursor-based pagination via the next field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Token contract address |
| `chain` | string | No | Blockchain network identifier (e.g. sol, eth, base, bsc, tron) |
| `cursor` | string | No | Opaque pagination cursor from the previous response's next field |
| `limit` | integer | No | Number of trades per page (max 50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/get_token_trades \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","chain":"<string>","cursor":"<string>","limit":"<integer>"}'
```

### get_trending_tokens

Retrieve trending tokens ranked by trading activity within a timeframe. Returns tokens with price, volume, market cap, holder count, swap counts, and security indicators. Single-page response of ranked results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chain` | string | No | Blockchain network identifier (e.g. sol, eth, base, bsc, tron) |
| `direction` | string | No | Sort direction. |
| `filters` | string | No | Comma-separated security filters: renounced, frozen, not_honeypot, has_twitter, has_website |
| `orderby` | string | No | Field to order results by. |
| `timeframe` | string | No | Timeframe bucket for trending data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/get_trending_tokens \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"<string>","direction":"<string>","filters":"<string>","orderby":"<string>","timeframe":"<string>"}'
```

### get_wallet_profile

Retrieve detailed statistics and profile for a specific wallet. Includes PnL across timeframes, realized/unrealized profit, trade counts, risk assessment, balance, social links, and classification tags. One round-trip per wallet.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chain` | string | No | Blockchain network identifier (e.g. sol, eth, base, bsc, tron) |
| `wallet_address` | string | Yes | Wallet address |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/get_wallet_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"<string>","wallet_address":"<string>"}'
```

### get_wallet_rankings

Retrieve the top-traders leaderboard ranked by PnL or realized profit. Returns wallet addresses with profit metrics, win rates, trade counts, and classification tags. Single-page response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chain` | string | No | Blockchain network identifier (e.g. sol, eth, base, bsc, tron) |
| `orderby` | string | No | Metric to rank wallets by. |
| `period` | string | No | Leaderboard time period. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/get_wallet_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"<string>","orderby":"<string>","period":"<string>"}'
```

### search_tokens

Search for tokens by name, ticker symbol, or contract address. Returns matching token results with address, name, symbol, price, and market cap. Single-page unordered results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chain` | string | No | Blockchain network identifier (e.g. sol, eth, base, bsc, tron) |
| `query` | string | Yes | Search query (token name, symbol, or contract address) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gmgn-ai-api-042b4dd6/search_tokens \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"<string>","query":"<string>"}'
```