Skip to main content
GET https://swarms.world/api/product/fees Returns the creator fees that the authenticated user has generated for one of their tokenized products (an agent or prompt with a launched token). Fee data is read live from the Jupiter partner API and reported in SOL. Identify the product by its ticker, its product UUID, or its full Swarms product URL. The endpoint resolves the product against your account, determines the fee-vault wallet, and returns the product name and UUID along with its total, unclaimed, and claimed fees and the time of the read. Authenticate with your Swarms API key in the Authorization header.
Only tokenized agents and prompts have creator fees. Tools and bundles are not tokenized and cannot be queried here.

​
Request

​
Headers

NameTypeRequiredDescription
AuthorizationstringYesBearer YOUR_API_KEY. Get your key at swarms.world/platform/api-keys.

​
Query Parameters

Provide one of the following to identify the product. If multiple are supplied, they are checked in the order below.
ParameterTypeDescription
urlstringFull Swarms product URL, e.g. https://swarms.world/agent/<uuid>.
idstringProduct UUID.
tickerstringToken ticker / symbol. A leading $ is optional.
productstringConvenience parameter that auto-detects whether the value is a URL, UUID, or ticker.

​
Response

​
Success (HTTP 200)

Fee amounts are in SOL.
FieldTypeDescription
namestring | nullProduct name.
uuidstringProduct UUID.
claimedFeesnumberFees already claimed, in SOL.
unclaimedFeesnumberFees available to claim, in SOL.
totalFeesnumberTotal fees earned (unclaimed + claimed), in SOL.
timestampstringISO 8601 server time when the fees were read.
Example success response: 
{
  "name": "Research Analyst",
  "uuid": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "claimedFees": 1.08,
  "unclaimedFees": 0.42,
  "totalFees": 1.5,
  "timestamp": "2026-07-01T18:30:00.000Z"
}
If the product exists but Jupiter has no fee data yet (for example the pool is not ready or no fees have been generated), the fee amounts are returned as 0.

​
HTTP Status Codes

CodeMeaning
200Success.
400Bad request: no product identifier provided, or the URL did not contain a valid product UUID.
401Unauthorized: API key is missing or invalid.
404No tokenized product found for the given identifier under your account.
500Internal server error.

​
Example Request

# By ticker
curl -X GET "https://swarms.world/api/product/fees?ticker=RSRCH" \
  -H "Authorization: Bearer YOUR_API_KEY"

# By UUID
curl -X GET "https://swarms.world/api/product/fees?id=1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
  -H "Authorization: Bearer YOUR_API_KEY"

# By full Swarms URL (auto-detected via `product`)
curl -X GET "https://swarms.world/api/product/fees?product=https://swarms.world/agent/1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Claim Fees API

Claim the unclaimed fees returned here

List Products API

List all products you’ve posted

Creator Fees

Understand how creator fees work

Tokenization

Launch a token for your agent or prompt