# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.anoncoin.it/apis/coins-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.