Skip to main content
GET
/
assets
/
search
cURL
curl --request GET \
  --url https://api.long.xyz/v1/assets/search \
  --header 'X-API-KEY: <api-key>'
{
  "result": [
    {
      "asset_address": "<unknown>",
      "asset_numeraire_address": "<string>",
      "asset_creation_timestamp": "2023-11-07T05:31:56Z",
      "asset_current_pool": "<string>",
      "asset_migration_timestamp": "2023-11-07T05:31:56Z",
      "asset_categories": [
        "<string>"
      ],
      "auction_pool": {
        "pool_current_price": "<string>",
        "pool_current_sqrt_price": "<string>",
        "pool_current_fdv": "<string>",
        "pool_current_liquidity": "<string>",
        "pool_current_tick": 123,
        "pool_last_epoch": 123,
        "pool_current_market_cap": "<string>",
        "pool_current_fees_accrued": "<string>",
        "pool_current_total_proceeds": "<string>",
        "pool_current_total_tokens_sold": "<string>",
        "pool_last_epoch_total_tokens_sold": "<string>",
        "pool_current_sale_progress_percentage": 123,
        "pool_config_max_proceeds": "<string>",
        "pool_config_min_proceeds": "<string>",
        "pool_config_num_tokens_to_sell": "<string>",
        "pool_id": "<string>",
        "pool_address": "<string>",
        "pool_config_starting_time": "<string>",
        "pool_config_ending_time": "<string>",
        "pool_migration_timestamp": "2023-11-07T05:31:56Z",
        "pool_type": "<string>",
        "pool_market_data": {
          "pool_liquidity": "<string>",
          "pool_market_cap": "<string>",
          "pool_price": "<string>",
          "pool_price_scale": "<string>",
          "pool_price_change_24h": "<string>",
          "pool_volume_change_24h": "<string>",
          "pool_volume_usd_24h": "<string>"
        },
        "base_token": {
          "token_address": "<string>",
          "token_name": "<string>",
          "token_description": "<string>",
          "token_symbol": "<string>",
          "token_decimals": 123,
          "token_uri_data": {
            "name": "<string>",
            "description": "<string>",
            "image_hash": "<string>",
            "fee_receiver": "<string>",
            "social_links": [
              {
                "label": "<string>",
                "url": "<string>"
              }
            ],
            "vesting_recipients": [
              {
                "address": "<string>",
                "amount": "<string>",
                "percentage": "<string>"
              }
            ]
          },
          "token_image_public_url": "<string>",
          "token_creator_address": "<string>",
          "token_fee_receiver_address": "<string>",
          "token_vesting_recipient_addresses": [
            "<string>"
          ]
        }
      },
      "graduation_pool": {
        "pool_current_price": "<string>",
        "pool_current_sqrt_price": "<string>",
        "pool_current_fdv": "<string>",
        "pool_current_liquidity": "<string>",
        "pool_current_tick": 123,
        "pool_current_market_cap": "<string>",
        "pool_address": "<string>",
        "pool_migration_timestamp": "2023-11-07T05:31:56Z",
        "pool_type": "<string>",
        "pool_market_data": {
          "pool_liquidity": "<string>",
          "pool_market_cap": "<string>",
          "pool_price": "<string>",
          "pool_price_scale": "<string>",
          "pool_price_change_24h": "<string>",
          "pool_volume_change_24h": "<string>",
          "pool_volume_usd_24h": "<string>"
        },
        "base_token": {
          "token_address": "<string>",
          "token_name": "<string>",
          "token_description": "<string>",
          "token_symbol": "<string>",
          "token_decimals": 123,
          "token_uri_data": {
            "name": "<string>",
            "description": "<string>",
            "image_hash": "<string>",
            "fee_receiver": "<string>",
            "social_links": [
              {
                "label": "<string>",
                "url": "<string>"
              }
            ],
            "vesting_recipients": [
              {
                "address": "<string>",
                "amount": "<string>",
                "percentage": "<string>"
              }
            ]
          },
          "token_image_public_url": "<string>",
          "token_creator_address": "<string>",
          "token_fee_receiver_address": "<string>",
          "token_vesting_recipient_addresses": [
            "<string>"
          ],
          "integrator_address": "<string>"
        }
      },
      "asset_status": "stall"
    }
  ]
}

Authorizations

​
X-API-KEY
string
header
required

API key for authentication

Query Parameters

​
chainId
integer | null
default:8453

The chain ID of the assets to search

​
term
string
required

The term to search for in the assets

​
limit
integer | null
default:50

The limit of the assets to search

Required range: 0 <= x <= 50
​
assetCategory
enum<string>

Optional filter to only return assets with this category (e.g., builder-coin, product-coin).

Available options:
builder-coin,
product-coin

Response

200 - application/json

200

​
result
object[]
required