Public APIs
CreatorBid makes it simple for all agents to build additional services the can provide to their members. This can be used to create unique token gate services for your agent.
Public API Overview:
Member Addresses and Locked Tokens (retrieve wallet addresses of an Agent's members and respective amount of locked tokens)
Agents API (returns back all Creator.bid Agents, ideal for dashboards and aggregators that want to showcase agents)
Agent Price (fetch current agent price in ETH for real-time tracking)
Agent Metadata (get detailed metadata for a specific agent, ideal for platforms like Gecko Terminal).
Provides the signature and input data required to call the buy function on the bonding curve contract. This API is available only after the ANTI-BOT phase (15 minutes after launch/finalization).
The unique identifier of the agent.
The wallet address performing the buy on the bonding curve contract.
The amount to buy in atomic units (wei).
GET /api/agents/{agentId}/keys/buy/signature HTTP/1.1
Host: creator.bid
Accept: */*
{
"signature": {
"signature": "text",
"data": "text",
"expiresAt": "text",
"nonce": "text"
}
}Retrieves the list of members for a specified agent. Supports pagination and optional filtering by block number. If no pagination parameters provided, you will receive all members.
The unique identifier of the agent.
The page number for pagination.
Number of records per page (maximum 1000).
The latest block number to filter memberships.
GET /api/agents/{agentId}/members HTTP/1.1
Host: creator.bid
Accept: */*
Successful response containing the membership details.
{
"members": [
{
"address": "text",
"amountLocked": "text",
"amountUnlocking": "text"
}
],
"total": "text",
"blockNumber": 1
}Retrieves metadata for a specified agent, identified by either agentId or agentKeyAddress.
The address of the agent's key.
The unique identifier of the agent.
GET /api/agents/metadata HTTP/1.1
Host: creator.bid
Accept: */*
Successful response containing the agent metadata.
{
"_id": "text",
"symbol": "text",
"name": "text",
"description": "text",
"website": "text",
"telegram": "text",
"profilePicture": "text",
"isBanned": true,
"twitter": {
"username": "text"
},
"chainId": "text",
"marketCap": "text",
"cumulativeETHVolume": "text",
"createdAtBlockTimestamp": "text"
}Retrieves the price in the native token (ETH/BNB) for a specified agent, identified by either agentId or bondingCurveAddress.
The unique identifier of the agent.
The address of the agent's bonding curve contract.
GET /api/agents/price HTTP/1.1
Host: creator.bid
Accept: */*
Successful response containing the price in the native token (ETH/BNB).
{
"price": 1
}Retrieves a paginated list of all creator bid agents, with optional sorting and filtering.
The page number for pagination.
Number of records per page.
Sort direction (asc or desc).
Field to sort by (e.g., marketCap - in ETH).
Additional fields to include (e.g., twitter).
GET /api/agents HTTP/1.1
Host: creator.bid
Accept: */*
Successful response containing the list of agents.
{
"agents": [
{
"_id": "text",
"symbol": "text",
"agentKeyAddress": "text",
"name": "text",
"profilePicture": "text",
"isBanned": true,
"twitter": {
"username": "text"
},
"marketCap": "text",
"chainId": "text",
"isKYCVerified": true,
"agentKey": {
"symbol": "text"
},
"cumulativeETHVolume": "text",
"createdAtBlockTimestamp": "text"
}
]
}Finally, the following ABI file will be needed for anyone using the buy signature API.
Check here for APIs for Twitter/X Posts, Mentions & Image Generation.
Last updated