Ban Management

Overview

Ban management allows administrators to prevent specific content from appearing on the platform by filtering text, patterns, images, and blocking user addresses.

All ban management endpoints require admin authentication. Changes take effect immediately and apply platform-wide.

Ban Terms

Manage banned text terms that will be filtered from token names and descriptions.

Get Ban Terms

curl -X GET "https://frontend-api-v3.pump.fun/moderation/ban-terms" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-terms"
headers = {"Authorization": "Bearer <your_token>"}

response = requests.get(url, headers=headers)
print(response.json())

Retrieves a list of all currently banned terms.

Add Ban Term

curl -X POST "https://frontend-api-v3.pump.fun/moderation/ban-terms" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{"term": "inappropriate_word"}'

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-terms"
headers = {
    "Authorization": "Bearer <your_token>",
    "Content-Type": "application/json"
}
data = {"term": "inappropriate_word"}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Adds a new term to the ban list. Content containing this term will be filtered.

Remove Ban Term

curl -X DELETE "https://frontend-api-v3.pump.fun/moderation/ban-terms/{id}" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-terms/{id}"
headers = {"Authorization": "Bearer <your_token>"}

response = requests.delete(url, headers=headers)
print(response.json())

string

required

The ID of the ban term to remove

Regex Ban Patterns

Use regular expressions for more sophisticated content filtering.

Get Regex Patterns

curl -X GET "https://frontend-api-v3.pump.fun/moderation/ban-regex-patterns" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-regex-patterns"
headers = {"Authorization": "Bearer <your_token>"}

response = requests.get(url, headers=headers)
print(response.json())

Retrieves all active regex ban patterns.

Add Regex Pattern

curl -X POST "https://frontend-api-v3.pump.fun/moderation/ban-regex-patterns" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{"pattern": "[0-9]{10,}"}'

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-regex-patterns"
headers = {
    "Authorization": "Bearer <your_token>",
    "Content-Type": "application/json"
}
data = {"pattern": "[0-9]{10,}"}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Test regex patterns thoroughly before adding them to avoid unintended filtering. Invalid patterns may cause errors.

Remove Regex Pattern

curl -X DELETE "https://frontend-api-v3.pump.fun/moderation/ban-regex-patterns/{id}" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-regex-patterns/{id}"
headers = {"Authorization": "Bearer <your_token>"}

response = requests.delete(url, headers=headers)
print(response.json())

string

required

The ID of the regex pattern to remove

Image Ban Terms

Manage banned terms for image content filtering.

Get Image Ban Terms

curl -X GET "https://frontend-api-v3.pump.fun/moderation/ban-image-terms" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-image-terms"
headers = {"Authorization": "Bearer <your_token>"}

response = requests.get(url, headers=headers)
print(response.json())

Add Image Ban Term

curl -X POST "https://frontend-api-v3.pump.fun/moderation/ban-image-terms" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{"term": "inappropriate_image_label"}'

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-image-terms"
headers = {
    "Authorization": "Bearer <your_token>",
    "Content-Type": "application/json"
}
data = {"term": "inappropriate_image_label"}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Remove Image Ban Term

curl -X DELETE "https://frontend-api-v3.pump.fun/moderation/ban-image-terms/{id}" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-image-terms/{id}"
headers = {"Authorization": "Bearer <your_token>"}

response = requests.delete(url, headers=headers)
print(response.json())

string

required

The ID of the image ban term to remove

User Bans

Manage banned user addresses.

Get Banned Users

curl -X GET "https://frontend-api-v3.pump.fun/moderation/ban-users?limit=50&offset=0&sortBy=createdAt&order=desc&searchQuery=&active=true&unbanRequest=false&fromDate=&toDate=" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban-users"
headers = {"Authorization": "Bearer <your_token>"}
params = {
    "limit": 50,
    "offset": 0,
    "sortBy": "createdAt",
    "order": "desc",
    "searchQuery": "",
    "active": "true",
    "unbanRequest": "false",
    "fromDate": "",
    "toDate": ""
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

string

required

Number of results to return

string

required

Number of results to skip for pagination

string

required

Field to sort by (e.g., createdAt, address)

string

required

Sort order: asc or desc

string

required

Search term to filter users

string

required

Filter by active ban status (true/false)

string

required

Filter users with unban requests (true/false)

string

required

Filter bans from this date (ISO 8601 format)

string

required

Filter bans until this date (ISO 8601 format)

Ban User Address

curl -X POST "https://frontend-api-v3.pump.fun/moderation/ban/address/{address}" \
  -H "Authorization: Bearer <your_token>"

import requests

address = "DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK"
url = f"https://frontend-api-v3.pump.fun/moderation/ban/address/{address}"
headers = {"Authorization": "Bearer <your_token>"}

response = requests.post(url, headers=headers)
print(response.json())

string

required

The wallet address to ban from the platform

Ban Content by ID

curl -X POST "https://frontend-api-v3.pump.fun/moderation/ban/{id}" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban/{id}"
headers = {"Authorization": "Bearer <your_token>"}

response = requests.post(url, headers=headers)
print(response.json())

number

required

The ID of the content to ban

Get Ban Details

curl -X GET "https://frontend-api-v3.pump.fun/moderation/ban?id={id}" \
  -H "Authorization: Bearer <your_token>"

import requests

url = "https://frontend-api-v3.pump.fun/moderation/ban"
headers = {"Authorization": "Bearer <your_token>"}
params = {"id": 123}

response = requests.get(url, headers=headers, params=params)
print(response.json())

number

required

The ID of the ban to retrieve

Best Practices

Start with specific terms: Add exact matches before using regex patterns
Test patterns: Verify regex patterns don’t create false positives
Document bans: Keep records of why terms or addresses were banned
Review regularly: Periodically audit ban lists to ensure they’re still relevant
Use bulk operations: For banning multiple addresses, consider using bulk endpoints
Monitor effectiveness: Check moderation logs to see if bans are working as intended

Coins

Trades

Users & Authentication

Social Features

Livestreams

Moderation

Advanced Analytics

Utilities

Overview

Ban Terms

Get Ban Terms

Add Ban Term

Remove Ban Term

Regex Ban Patterns

Get Regex Patterns

Add Regex Pattern

Remove Regex Pattern

Image Ban Terms

Get Image Ban Terms

Add Image Ban Term

Remove Image Ban Term

User Bans

Get Banned Users

Ban User Address

Ban Content by ID

Get Ban Details

Best Practices

​Overview

​Ban Terms

​Get Ban Terms

​Add Ban Term

​Remove Ban Term

​Regex Ban Patterns

​Get Regex Patterns

​Add Regex Pattern

​Remove Regex Pattern

​Image Ban Terms

​Get Image Ban Terms

​Add Image Ban Term

​Remove Image Ban Term

​User Bans

​Get Banned Users

​Ban User Address

​Ban Content by ID

​Get Ban Details

​Best Practices

Overview

Ban Terms

Get Ban Terms

Add Ban Term

Remove Ban Term

Regex Ban Patterns

Get Regex Patterns

Add Regex Pattern

Remove Regex Pattern

Image Ban Terms

Get Image Ban Terms

Add Image Ban Term

Remove Image Ban Term

User Bans

Get Banned Users

Ban User Address

Ban Content by ID

Get Ban Details

Best Practices