> For the complete documentation index, see [llms.txt](https://docs.anoncoin.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.anoncoin.it/apis/coins-api.md).

# Coins

> 🚧 **Coming Soon** - This endpoint is not yet live.

> 🔑 **Authentication required.** See [API Key](/apis/api-key.md) for setup and rate limits.

## `GET` /services/v2/coins

Returns a list of coins sorted by the specified criteria.

```
GET https://api.anoncoin.it/services/v2/coins
```

***

## Query Parameters

| Parameter | Type    | Required | Description                                                             |
| --------- | ------- | -------- | ----------------------------------------------------------------------- |
| `sortBy`  | string  | ✅        | Sort order. One of: `trending`, `new`, `marketCap`, `topHolders`, `cto` |
| `limit`   | integer | ❌        | Number of results. Allowed: `10` (default), `20`                        |

***

## Sort Options

| Value        | Description                                                 |
| ------------ | ----------------------------------------------------------- |
| `trending`   | Coins currently trending on the platform                    |
| `new`        | Most recently created coins                                 |
| `marketCap`  | Coins ranked by market cap (highest first)                  |
| `topHolders` | Coins ranked by number of holders                           |
| `cto`        | Coins with active or completed Community Takeover elections |

***

## Example Request

```bash
curl --location 'https://api.anoncoin.it/services/v2/coins?sortBy=trending&limit=10' \
  --header 'x-api-key: YOUR_API_KEY'
```

***

## Response

Returns an array of coin objects.

```json
[
    {
        "creator": {
            "userName": "38BUNW",
            "profileImageUrl": "https://cdn.anoncoin.it/.../profile-image.png",
            "twitterFollowersBucket": "10k+"
        },
        "tickerName": "Anoncoin",
        "tickerSymbol": "ANONCOIN",
        "bannerImageUrl": "https://cdn.anoncoin.it/.../user-uploaded.jpeg",
        "tickerMetadataUrl": "https://cdn-aibackrooms.s3.amazonaws.com/ANONCOIN/token-metadata.json",
        "tickerImageUrl": "https://cdn.anoncoin.it/ANONCOIN/image.png",
        "lore": "The Doge launchpad. Create a coin anonymously. One ticker per coin.",
        "mint": "D25bi7oHQjqkVrzbfuM6k2gzVNHTSpBLhtakDCzCCDUB",
        "totalCreatorFeeEarnedUsd": 2220.49,
        "totalCreatorFeeEarnedSol": 2220.49,
        "graduationPercentage": 76,
        "priceUsd": "0.000024749985123278893798",
        "priceSol": "0.000024749985123278893798",
        "marketCapUsd": "$2,016,080",
        "marketCapSol": "24118.676832995682153",
        "priceChange24Hrs": "27.36%",
        "volume24HrsUsd": "22090.371827754578",
        "volume24HrsSol": "220",
        "totalSupply": "1000000000",
        "circSupply": "974492579.3552117",
        "liquidityUsd": "$57,102",
        "liquiditySol": "590",
        "holders": "2597",
        "isMigrated": true,
        "marketCapATHUsd": "$22,451,660",
        "marketCapATHSol": "$22,451,660",
        "devWalletAddress": "EPBmgCVSiX6oWGym5TfmpkDsEHPgnhsD6Vk2ek38BUNW",
        "metaData": {
            "twitterLink": "https://x.com/anoncoinit",
            "isTwitterVerified": true,
            "telegramLink": "https://t.me/AnoncoinIt",
            "taggedUserProfiles": [
                {
                    "profileURL": "https://x.com/nikitabier",
                    "userName": "nikitabier",
                    "name": "Nikita Bier"
                }
            ]
        },
        "createdOn": "2025-06-19T19:38:40.116Z",
        "devPosts": [
            {
                "title": "hey",
                "description": "desc",
                "createdOn": "2025-06-19T19:38:40.116Z"
            }
        ],
        "ctoElection": {
            "isActive": false,
            "endedOn": "2025-06-19T19:38:40.116Z",
            "ctoLeadProfile": {
                "twitterUserName": "DogeFatherAnon",
                "twitterName": "The DogeFather"
            }
        }
    }
]
```

***

## Response Fields

* `creator` :
  * `userName` : Anonymous username of the coin creator.
  * `profileImageUrl` : Creator's profile image URL.
  * `twitterFollowersBucket` : Follower count bucket (e.g., `10k+`).
* `tickerName` : Full name of the coin.
* `tickerSymbol` : Ticker symbol.
* `bannerImageUrl` : Banner image URL.
* `tickerImageUrl` : Coin logo URL.
* `lore` : Coin description / lore.
* `mint` : Solana token mint address.
* `totalCreatorFeeEarnedUsd` : Total creator fees earned (USD).
* `totalCreatorFeeEarnedSol` : Total creator fees earned (SOL).
* `graduationPercentage` : Progress toward graduation (0–100).
* `priceUsd` : Current price in USD.
* `priceSol` : Current price in SOL.
* `marketCapUsd` : Market cap in USD.
* `marketCapSol` : Market cap in SOL.
* `priceChange24Hrs` : 24-hour price change percentage.
* `volume24HrsUsd` : 24-hour trading volume in USD.
* `volume24HrsSol` : 24-hour trading volume in SOL.
* `totalSupply` : Total token supply.
* `circSupply` : Circulating supply.
* `liquidityUsd` : Pool liquidity in USD.
* `liquiditySol` : Pool liquidity in SOL.
* `holders` : Number of holders.
* `isMigrated` : Whether the coin has graduated to the AMM.
* `marketCapATHUsd` : All-time high market cap in USD.
* `marketCapATHSol` : All-time high market cap in SOL.
* `devWalletAddress` : Creator's wallet address.
* `metaData` :
  * `twitterLink` : X (Twitter) profile link.
  * `isTwitterVerified` : Whether the Twitter account is verified.
  * `telegramLink` : Telegram group link.
  * `taggedUserProfiles` : Array of tagged user profiles.
    * `profileURL` : Profile URL.
    * `userName` : Username.
    * `name` : Display name.
* `createdOn` : Coin creation timestamp.
* `devPosts` : Array of creator posts.
  * `title` : Post title.
  * `description` : Post description.
  * `createdOn` : Post creation timestamp.
* `ctoElection` :
  * `isActive` : Whether a CTO election is currently active.
  * `endedOn` : When the election ended.
  * `ctoLeadProfile` :
    * `twitterUserName` : CTO lead's Twitter username.
    * `twitterName` : CTO lead's display name.