> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inkyswap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tokens by Owner

> Get all tokens created by a specific wallet address

## Description

Returns a paginated list of all tokens created by a specific wallet address. This endpoint is useful for viewing a creator's portfolio of launched tokens.

## Query Parameters

<ParamField query="owner" type="string" required>
  The wallet address of the token creator
</ParamField>

<ParamField query="page" type="number" default="1">
  Page number for pagination
</ParamField>

<ParamField query="limit" type="number" default="20">
  Number of tokens per page (max: 100)
</ParamField>

<ParamField query="sort" type="string" default="created_at_desc">
  Sorting order. Options:

  * `created_at_desc`: Newest first
  * `created_at_asc`: Oldest first
  * `market_cap_desc`: Highest market cap first
  * `market_cap_asc`: Lowest market cap first
  * `funding_progress_desc`: Highest funding progress first
  * `volume_24h_desc`: Highest 24h volume first
</ParamField>

<ParamField query="includeInactive" type="boolean" default="false">
  Include tokens that have been disabled or failed
</ParamField>

## Response

<ResponseField name="tokens" type="array">
  Array of token objects

  <Expandable title="Token Object">
    <ResponseField name="address" type="string">
      Token contract address
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO timestamp of token creation
    </ResponseField>

    <ResponseField name="owner" type="string">
      Creator's wallet address
    </ResponseField>

    <ResponseField name="name" type="string">
      Token name
    </ResponseField>

    <ResponseField name="ticker" type="string">
      Token symbol
    </ResponseField>

    <ResponseField name="description" type="string">
      Token description
    </ResponseField>

    <ResponseField name="image_url" type="string">
      Token logo URL
    </ResponseField>

    <ResponseField name="market_cap" type="number">
      Current market capitalization in ETH
    </ResponseField>

    <ResponseField name="funding_progress" type="number">
      Funding progress (0-1, where 1 means fully funded)
    </ResponseField>

    <ResponseField name="volume_24h" type="number">
      24-hour trading volume
    </ResponseField>

    <ResponseField name="total_holders" type="number">
      Total number of token holders
    </ResponseField>

    <ResponseField name="is_graduated" type="boolean">
      Whether the token has completed funding
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata

  <Expandable title="Pagination">
    <ResponseField name="page" type="number">
      Current page number
    </ResponseField>

    <ResponseField name="limit" type="number">
      Items per page
    </ResponseField>

    <ResponseField name="total" type="number">
      Total number of tokens
    </ResponseField>

    <ResponseField name="totalPages" type="number">
      Total number of pages
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "tokens": [
      {
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "created_at": "2024-01-15T10:30:00Z",
        "owner": "0xabcdef1234567890abcdef1234567890abcdef12",
        "name": "Moon Token",
        "ticker": "MOON",
        "description": "To the moon and beyond",
        "image_url": "https://example.com/moon-logo.png",
        "market_cap": 500.5,
        "funding_progress": 1.0,
        "volume_24h": 250.8,
        "total_holders": 1250,
        "is_graduated": true
      },
      {
        "address": "0x9876543210fedcba9876543210fedcba98765432",
        "created_at": "2024-01-14T08:15:00Z",
        "owner": "0xabcdef1234567890abcdef1234567890abcdef12",
        "name": "Star Token",
        "ticker": "STAR",
        "description": "Reach for the stars",
        "image_url": "https://example.com/star-logo.png",
        "market_cap": 125.3,
        "funding_progress": 0.65,
        "volume_24h": 45.2,
        "total_holders": 423,
        "is_graduated": false
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 5,
      "totalPages": 1
    }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://inkypump.com/api/tokens/by-owner?owner=0xabcdef1234567890abcdef1234567890abcdef12"

  curl -X GET "https://inkypump.com/api/tokens/by-owner?owner=0xabcdef1234567890abcdef1234567890abcdef12&sort=market_cap_desc&limit=10"
  ```

  ```typescript TypeScript theme={null}
  const ownerAddress = '0xabcdef1234567890abcdef1234567890abcdef12';
  const response = await fetch(`https://inkypump.com/api/tokens/by-owner?owner=${ownerAddress}`);
  const data = await response.json();

  const sortedResponse = await fetch(
    `https://inkypump.com/api/tokens/by-owner?owner=${ownerAddress}&sort=market_cap_desc&limit=10`
  );
  const sortedData = await sortedResponse.json();
  ```

  ```python Python theme={null}
  import requests

  owner_address = "0xabcdef1234567890abcdef1234567890abcdef12"
  response = requests.get(
      "https://inkypump.com/api/tokens/by-owner",
      params={"owner": owner_address}
  )
  data = response.json()

  sorted_response = requests.get(
      "https://inkypump.com/api/tokens/by-owner",
      params={
          "owner": owner_address,
          "sort": "market_cap_desc",
          "limit": 10
      }
  )
  sorted_data = sorted_response.json()
  ```
</RequestExample>