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

# Get Latest Token Profiles

Retrieve the latest token profiles from DEX Screener ordered by creation time. Returns token address, chain, description, links, and community takeover (CTO) status. Optionally filter by chain ID and limit results (max 100). Ideal for: discovering newly listed tokens, monitoring new project launches, tracking community takeover events.

![Get Latest Token Profiles logo](https://ai-icon.b3.fun/logo/dexscreener)
Catalog action Blockchain Data

Retrieve the latest token profiles from DEX Screener ordered by creation time. Returns token address, chain, description, links, and community takeover (CTO) status. Optionally filter by chain ID and limit results (max 100). Ideal for: discovering newly listed tokens, monitoring new project launches, tracking community takeover events.


## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `dexscreener-get-latest-profiles` |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | `dex`, `token`, `market`, `trending`, `read` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `chainId` | `string` | No | Filter by chain ID \(e.g. 'base', 'solana', 'bsc'\). If omitted, returns all chains. |
| `limit` | `number` | No | Maximum number of results to return \(1-100, default: 20\) |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `profiles` | `array` | Yes | Array of latest token profiles |

## Examples

**Workflow node**

```json
{
  "type": "dexscreener-get-latest-profiles",
  "payload": {
    "chainId": "8453",
    "limit": 20
  },
  "children": []
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/dexscreener-get-latest-profiles/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "chainId": "8453",
    "limit": 20
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.