---
title: "Get EVM token creators"
method: GET
path: "/evm/token-creator"
tags: ["EVM"]
---

# Get EVM token creators

`GET /evm/token-creator`

Resolve the creator and fee-share claimers of a Bags EVM token, enriched with Bags social profile data (username, pfp, connected social provider).

On-chain data (creator, claimers, and their basis-point shares) is read from the Bags EVM factory registry. Each wallet is resolved to a Bags user, and wallets with no known Bags user are returned with blank social fields. The creator is always included; if the creator is not also a claimer, they are appended with `royaltyBps: 0` and `isCreator: true`.

The `tokenAddress` is trimmed and normalized to its EIP-55 checksum form before use. A token with a single creator/claimer still returns a one-element array.

## Query parameters

- `tokenAddress` string, required

## Response `200`

Successfully retrieved EVM token creators

- object
  - `success` boolean, required
  - `response` EvmTokenCreator[]
    - `username` string, required — Bags username of the creator/claimer. Empty string when the wallet has no usable social provider (i.e. no linked Bags user).
    - `pfp` string, required — Profile image URL. Empty string when the wallet has no usable social provider.
    - `royaltyBps` number, required — Share of the claimer pot in basis points (10000 = 100%). 0 for a creator who is not also a claimer.
    - `isCreator` boolean, required — Whether this wallet launched the token.
    - `wallet` string, required — EIP-55 checksummed EVM address of the creator/claimer.
    - `provider` union — Social/auth provider for the associated account (e.g. 'twitter'). Use this to render a platform logo. 'unknown' when the wallet is not linked to a Bags user, or null when unavailable.
      - 'apple' | 'google' | 'email' | 'solana' | 'twitter' | 'tiktok' | 'kick' | 'instagram' | 'onlyfans' | 'github' | 'moltbook' — Supported social/auth providers
      - 'unknown'
    - `providerUsername` string, nullable — Username/handle on the connected social provider. null when unavailable.
    - `twitterUsername` string — Twitter/X username. Optional; present only when provider is 'twitter'.
    - `bagsUsername` string — Bags platform username. Optional; present only when a Bags username is available.

## Other responses

- `400` — Bad request - Invalid EVM address, must be a 0x-prefixed 20-byte hex address
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not found - The address is not a Bags EVM token, or no creators/claimers could be resolved
- `429` — Too many requests - Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/bags/apis/bags-public-api-v2.md) · [All operations](https://skmtc.net/bags/apis/bags-public-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bags/bags-public-api-v2/revisions/4a14b82cd39d/schema)