Get Clanker Info by Address

Retrieve detailed information about a Clanker token using its contract address.

GET https://www.clanker.world/api/get-clanker-by-address

Headers:

x-api-key: your_api_key

Query Parameters:

Parameter	Type	Description
address	string	Ethereum address of the Clanker token contract

Example Request:

curl -X GET \
  'https://www.clanker.world/api/get-clanker-by-address?address=0x1bc0c42215582d5A085795f4baDbaC3ff36d1Bcb' \
  -H 'x-api-key: your_api_key'

Response Format

Example Response:

{
  "data": {
    "id": 103,
    "created_at": "2024-11-08T20:43:35.148032+00:00",
    "tx_hash": "0x2ec3ea2d291fc50d946a127328bec3e15336db0601ddb027f101309d874a18ec",
    "contract_address": "0x1bc0c42215582d5A085795f4baDbaC3ff36d1Bcb",
    "requestor_fid": 270504,
    "name": "tokenbot",
    "symbol": "CLANKER",
    "img_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/295953fa-15ed-4d3c-241d-b6c1758c6200/original",
    "pool_address": "0xC1a6FBeDAe68E1472DbB91FE29B51F7a0Bd44F97",
    "cast_hash": "0x17c631fc40ff1c8e825417450722032fe7210838",
    "type": null,
    "pair": null,
    "presale_id": null
  }
}

Response Fields

Top-Level Fields:

Field	Type	Description
data	object	Container object for the Clanker token information

Data Object Fields:

Field	Type	Description
id	integer	Unique identifier for the token
created_at	string	ISO 8601 timestamp of token creation
tx_hash	string	Transaction hash of the deployment
contract_address	string	Token contract address
requestor_fid	integer	Farcaster ID of the token requestor
name	string	Token name
symbol	string	Token symbol
img_url	string	URL of the token's image
pool_address	string	Address of the token's liquidity pool
cast_hash	string	Associated Farcaster cast hash
type	string | null	Token type identifier
pair	string | null	Trading pair identifier
presale_id	integer | null	ID of associated presale if applicable

Notes

• The created_at timestamp is returned in UTC timezone

• The img_url field provides a direct link to the token's image asset

• The requestor_fid can be used to link to the token creator's Farcaster profile