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

# Trades

> Returns recent trades, newest first, for a set of tokens, a set of wallets, or a feed of notable wallets.

Returns recent trades, newest first, merged across every chain and token in scope. Each trade includes its own `chain` and `token`.

## What to read

Choose one of these reads:

* `tokens`, a comma-separated list of 1 to 10 token addresses, reads the trades on those tokens.
* `wallets`, a comma-separated list of 1 to 100 wallet addresses, reads the trades those wallets made.
* `tokens` and `wallets` together read the named wallets' trades on the named tokens.
* `identity` alone reads one feed of notable wallets across every token. `kol` covers wallets labelled as key opinion leaders, and `fomo` covers wallets with a fomo.family profile.

A read that names `wallets` returns only the last 90 days of trades.

`chains` limits results to a comma-separated list of [chain slugs](https://docs.metastreams.io/concepts/chains.md), such as `solana,bsc`. Omit it to include every chain. An address reads on every chain in scope of its format, so an EVM address reads on each EVM chain.

## Filters

* `flags` takes a comma-separated list of [wallet classifications](https://docs.metastreams.io/resources/glossary.md#wallet-classifications), such as `bundler,insider`. A trade is included when its trader has at least one of them. `fomo` matches traders flagged `fomo` and trades routed through the fomo.family terminal. `flags` applies only to a read by `tokens`.
* `side` keeps only `buy` or `sell` trades. It applies only to a read by `wallets`.

## Response

A page contains `trades`, `nextCursor` and `hasMore`. `nextCursor` is the cursor for the next page, or `null` on the last page, and `hasMore` is `true` while more pages remain. An unknown token or wallet returns an empty page, not a `404`.

## Pagination

* **Opaque cursors.** The cursor must not be constructed, modified or parsed. Send it back exactly as received.
* **Stable pages.** The cursor marks a position in the list, not an offset, so trades that arrive during pagination do not cause duplicated or skipped results.
* **One query per cursor.** A cursor continues only the query that made it. Send the same parameters with each page.
* **Invalid cursors.** An unreadable cursor returns `400 VALIDATION_ERROR` on the `cursor` field rather than silently restarting from the first page.

```typescript TypeScript theme={null}
const url = "https://api.metastreams.io/v1/trades";
const headers = { Authorization: `Bearer ${process.env.API_KEY}` };
let cursor: string | null = null;

do {
  const params = new URLSearchParams({ tokens: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", chains: "solana", limit: "100" });
  if (cursor) params.set("cursor", cursor);
  const response = await fetch(`${url}?${params}`, { headers });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const page = await response.json();
  for (const trade of page.trades) console.log(trade.id, trade.side, trade.volume.usd);
  cursor = page.hasMore ? page.nextCursor : null;
} while (cursor);
```

```rust Rust theme={null}
use serde_json::Value;

let url = "https://api.metastreams.io/v1/trades";
let key = std::env::var("API_KEY")?;
let client = reqwest::Client::new();
let mut cursor: Option<String> = None;

loop {
    let mut request = client.get(url).bearer_auth(&key).query(&[
        ("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"),
        ("chains", "solana"),
        ("limit", "100"),
    ]);
    if let Some(cursor) = &cursor {
        request = request.query(&[("cursor", cursor)]);
    }
    let page: Value = request.send().await?.error_for_status()?.json().await?;
    for trade in page["trades"].as_array().into_iter().flatten() {
        println!("{} {} {}", trade["id"].as_str().unwrap_or_default(), trade["side"].as_str().unwrap_or_default(), trade["volume"]["usd"].as_str().unwrap_or("null"));
    }
    if page["hasMore"] != true {
        break;
    }
    cursor = page["nextCursor"].as_str().map(String::from);
}
```

## Errors

| Code | When |
| - | - |
| `UNSUPPORTED_CHAIN` | A slug in `chains` is not supported |
| `VALIDATION_ERROR` | A combination of `tokens`, `wallets`, `identity`, `flags` and `side` that the rules above do not allow, such as `flags` with `identity`; more than 10 tokens or 100 wallets; a malformed address; an unknown flag or feed; a cursor that does not decode or that another query made; or an unknown parameter |

```bash cURL theme={null}
curl "https://api.metastreams.io/v1/trades?tokens=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&chains=solana&limit=50" \
  -H "Authorization: Bearer $API_KEY"
```

```bash Wallets theme={null}
curl "https://api.metastreams.io/v1/trades?wallets=7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5&side=buy" \
  -H "Authorization: Bearer $API_KEY"
```

```bash Identity feed theme={null}
curl "https://api.metastreams.io/v1/trades?identity=kol&chains=solana,bsc" \
  -H "Authorization: Bearer $API_KEY"
```

```typescript TypeScript theme={null}
const url = new URL("https://api.metastreams.io/v1/trades");
url.searchParams.set("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263");
url.searchParams.set("chains", "solana");
url.searchParams.set("limit", "50");

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { trades, nextCursor, hasMore } = await response.json();
```

```rust Rust theme={null}
use serde_json::Value;

let page: Value = reqwest::Client::new()
    .get("https://api.metastreams.io/v1/trades")
    .query(&[
        ("tokens", "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"),
        ("chains", "solana"),
        ("limit", "50"),
    ])
    .bearer_auth(std::env::var("API_KEY")?)
    .send()
    .await?
    .error_for_status()?
    .json()
    .await?;
let trades = &page["trades"];
```

```json Page theme={null}
{
  "trades": [
    {
      "id": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h:2",
      "chain": "solana",
      "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "name": "Bonk",
      "symbol": "Bonk",
      "trader": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5",
      "transactionHash": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h",
      "side": "buy",
      "amount": "12500000",
      "price": { "native": "0.000000121", "usd": "0.0000216" },
      "volume": { "native": "1.51", "usd": "270.12" },
      "marketCap": { "native": "10741962.1", "usd": "1917440000" },
      "timestamp": 1789632015120
    }
  ],
  "nextCursor": "eyJ0cyI6MTc4OTYzMjAxNTEyMCwiaWQiOiI0eFFtVmI4ZTJrVDFuUjdwWmNXM3NMZEhmQTlq",
  "hasMore": true
}
```

```json Empty page theme={null}
{
  "trades": [],
  "nextCursor": null,
  "hasMore": false
}
```


## OpenAPI

````yaml specs/openapi.json GET /v1/trades
openapi: 3.1.0
info:
  title: Metastreams API
  description: >-
    The Metastreams market-data API. Amounts are decimal strings, timestamps are
    Unix milliseconds, and every field name is camelCase.
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://{host}
    variables:
      host:
        default: api.metastreams.io
        description: API host.
security:
  - bearerKey: []
paths:
  /v1/trades:
    get:
      tags:
        - trades
      summary: >-
        Recent trades, newest first: the named tokens', the named wallets', or a
        notable identity's.
      description: >-
        Name `tokens` (1 to 10), `wallets` (1 to 100) or both, or name
        `identity` alone. Each named

        token and wallet costs one credit, and an `identity` read costs one. An
        address reads on

        every chain in scope of its address family. `tokens` and `wallets`
        together keep the named

        wallets' trades on the named tokens. A read that names `wallets` serves
        90 days of trades.

        `flags` keeps the trades whose trader matches any named classification,
        and takes `tokens`

        without `wallets`. `side` takes `wallets`. `identity` names a feed:
        `kol` for curated

        wallets, and `fomo` for wallets with a fomo.family identity. Page with
        `cursor` until

        `hasMore` is false. A cursor continues only the query that made it.
      operationId: trade_list
      parameters:
        - name: identity
          in: query
          description: >-
            Identity feed to read. A read that names it names no `tokens` or
            `wallets`.
          required: false
          schema:
            $ref: '#/components/schemas/IdentityFeed'
        - name: tokens
          in: query
          description: >-
            Token addresses, CSV; one to 10. Each reads on every chain in scope
            of its address family.
          required: false
          schema:
            type: string
          example: So11111111111111111111111111111111111111112
        - name: wallets
          in: query
          description: >-
            Wallet addresses, CSV; one to 100. Each reads on every chain in
            scope of its address family.
          required: false
          schema:
            type: string
          example: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
        - name: chains
          in: query
          description: >-
            Chains to scope to, CSV of the chain slugs. Absent means every spot
            chain.
          required: false
          schema:
            type: string
          example: solana,bsc
        - name: flags
          in: query
          description: >-
            Wallet classifications to keep, comma-separated. Absent or empty
            keeps every trade.
          required: false
          schema:
            type: string
          example: bundler,insider
        - name: side
          in: query
          description: Keep only this side of the book.
          required: false
          schema:
            $ref: '#/components/schemas/TradeDirection'
        - name: limit
          in: query
          description: Rows per page, clamped to 1-100; 20 when absent.
          required: false
          schema:
            type: integer
            format: int32
            maximum: 100
            minimum: 1
        - name: cursor
          in: query
          description: Opaque cursor from the previous page.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: >-
            Recent trades, newest first; a token or wallet with no trades adds
            none.
          headers:
            X-Credits-Cost:
              schema:
                type: integer
              description: >-
                Credits charged for this request. Zero on any non-2xx. Sent on a
                metered tier only.
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credit balance after this request. Sent on a metered tier only.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: >-
                Requests left in the bucket this request spent from. Not sent
                with a 401.
            X-Request-ID:
              schema:
                type: string
              description: >-
                This request's trace ID. Echoed from the request, or generated
                when it sent none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UiSpotTrades'
        '400':
          description: >-
            No `tokens`, `wallets` or `identity`, `identity` beside a list, a
            token count outside 1-10, a wallet count outside 1-100, an option
            the read does not take, an unsupported chain, a malformed address,
            an unknown flag or identity feed, a cursor of another query, or a
            malformed parameter.
          headers:
            X-Credits-Cost:
              schema:
                type: integer
              description: >-
                Credits charged for this request. Zero on any non-2xx. Sent on a
                metered tier only.
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credit balance after this request. Sent on a metered tier only.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: >-
                Requests left in the bucket this request spent from. Not sent
                with a 401.
            X-Request-ID:
              schema:
                type: string
              description: >-
                This request's trace ID. Echoed from the request, or generated
                when it sent none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: >-
            Missing or invalid credential: an API key, or a session token a key
            minted.
          headers:
            X-Credits-Cost:
              schema:
                type: integer
              description: >-
                Credits charged for this request. Zero on any non-2xx. Sent on a
                metered tier only.
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credit balance after this request. Sent on a metered tier only.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: >-
                Requests left in the bucket this request spent from. Not sent
                with a 401.
            X-Request-ID:
              schema:
                type: string
              description: >-
                This request's trace ID. Echoed from the request, or generated
                when it sent none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '402':
          description: >-
            The organization's credits this billing period reach its plan's
            limit.
          headers:
            X-Credits-Cost:
              schema:
                type: integer
              description: >-
                Credits charged for this request. Zero on any non-2xx. Sent on a
                metered tier only.
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credit balance after this request. Sent on a metered tier only.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: >-
                Requests left in the bucket this request spent from. Not sent
                with a 401.
            X-Request-ID:
              schema:
                type: string
              description: >-
                This request's trace ID. Echoed from the request, or generated
                when it sent none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: >-
            A key whose plan excludes this endpoint gets `FORBIDDEN`. A session
            token from an

            origin it does not name gets `ORIGIN_NOT_ALLOWED`.
          headers:
            X-Credits-Cost:
              schema:
                type: integer
              description: >-
                Credits charged for this request. Zero on any non-2xx. Sent on a
                metered tier only.
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credit balance after this request. Sent on a metered tier only.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: >-
                Requests left in the bucket this request spent from. Not sent
                with a 401.
            X-Request-ID:
              schema:
                type: string
              description: >-
                This request's trace ID. Echoed from the request, or generated
                when it sent none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Rate limit exceeded.
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying.
            X-Credits-Cost:
              schema:
                type: integer
              description: >-
                Credits charged for this request. Zero on any non-2xx. Sent on a
                metered tier only.
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credit balance after this request. Sent on a metered tier only.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: >-
                Requests left in the bucket this request spent from. Not sent
                with a 401.
            X-Request-ID:
              schema:
                type: string
              description: >-
                This request's trace ID. Echoed from the request, or generated
                when it sent none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '500':
          description: Unexpected server failure.
          headers:
            X-Credits-Cost:
              schema:
                type: integer
              description: >-
                Credits charged for this request. Zero on any non-2xx. Sent on a
                metered tier only.
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credit balance after this request. Sent on a metered tier only.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: >-
                Requests left in the bucket this request spent from. Not sent
                with a 401.
            X-Request-ID:
              schema:
                type: string
              description: >-
                This request's trace ID. Echoed from the request, or generated
                when it sent none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '503':
          description: Dependency down or maintenance.
          headers:
            X-Credits-Cost:
              schema:
                type: integer
              description: >-
                Credits charged for this request. Zero on any non-2xx. Sent on a
                metered tier only.
            X-Credits-Remaining:
              schema:
                type: integer
              description: Credit balance after this request. Sent on a metered tier only.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: >-
                Requests left in the bucket this request spent from. Not sent
                with a 401.
            X-Request-ID:
              schema:
                type: string
              description: >-
                This request's trace ID. Echoed from the request, or generated
                when it sent none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
components:
  schemas:
    IdentityFeed:
      type: string
      description: A cross-token feed of trades by a notable identity.
      enum:
        - kol
        - fomo
    TradeDirection:
      type: string
      description: 'Which way the traded token moved: `buy` or `sell`.'
      enum:
        - buy
        - sell
    UiSpotTrades:
      type: object
      description: A page of trades, newest first.
      required:
        - trades
        - hasMore
      properties:
        hasMore:
          type: boolean
          description: Whether a next page exists.
        nextCursor:
          type:
            - string
            - 'null'
          description: Cursor for the next page; `null` on the last page.
        trades:
          type: array
          items:
            $ref: '#/components/schemas/UiSpotTrade'
          description: Trades on the requested page, newest first.
    ErrorEnvelope:
      type: object
      description: The complete error response body — every error is exactly this.
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: The error.
    UiSpotTrade:
      type: object
      description: One executed swap on the token.
      required:
        - id
        - chain
        - token
        - name
        - symbol
        - trader
        - transactionHash
        - side
        - amount
        - price
        - volume
        - marketCap
        - timestamp
      properties:
        amount:
          $ref: '#/components/schemas/Decimal'
          description: Token units traded.
        chain:
          $ref: '#/components/schemas/SpotChain'
          description: Chain the trade executed on.
        flags:
          type: array
          items:
            type: string
            description: >-
              A flag the classifier put on the wallet. This is an open
              enumeration: the classifier learns new flags, so keep a value you
              do not recognize.
            examples:
              - bundler
              - sniper
              - insider
              - dev
              - fresh
              - whale
              - kol
              - liquidity_pool
              - locker
              - pro_trader
              - system
              - fomo
              - phishing
              - marketplace
          description: Classifications the wallet carries.
        id:
          type: string
          description: >-
            Stable identity for this trade, opaque to the caller. One
            transaction can settle several

            trades on a token, so this is not a transaction hash — never parse
            it.
        identities:
          type: array
          items:
            $ref: '#/components/schemas/UiWalletIdentity'
          description: Trader's resolved identities, one element per source.
        marketCap:
          $ref: '#/components/schemas/UiMoney'
          description: Token market cap at execution.
        name:
          type: string
          description: Traded token's name; empty until the token's metadata resolves.
        platforms:
          type: array
          items:
            $ref: '#/components/schemas/UiPlatform'
          description: >-
            Terminals this trade routed through. A trader's profile is an
            element of

            `identities`.
        price:
          $ref: '#/components/schemas/UiMoney'
          description: Token price at execution.
        side:
          $ref: '#/components/schemas/TradeDirection'
          description: Buy or sell.
        symbol:
          type: string
          description: Traded token's symbol; empty until the token's metadata resolves.
        timestamp:
          $ref: '#/components/schemas/UnixMilliseconds'
          description: When the trade executed.
        token:
          type: string
          description: Traded token's address.
        trader:
          type: string
          description: Wallet that sent the swap.
        transactionHash:
          type: string
          description: On-chain transaction hash.
        volume:
          $ref: '#/components/schemas/UiMoney'
          description: Trade value.
    ErrorDetail:
      type: object
      description: The `error` object inside the envelope.
      required:
        - code
        - message
      properties:
        code:
          $ref: '#/components/schemas/ErrorCode'
          description: >-
            Stable, machine-readable. Clients switch on this, never on
            `message`.
        details:
          description: Optional; shape is fixed per code.
        message:
          type: string
          description: |-
            Human-readable, written for the integrating developer:
            `[What happened]. [What to do next — if actionable].`
    Decimal:
      type: string
      format: decimal
      description: An exact decimal, as a string.
      example: '123.456789'
    SpotChain:
      type: string
      description: >-
        Chain slug. One spelling per chain, in paths and bodies alike. Only a
        chain with spot data is published.
      enum:
        - solana
        - bsc
        - robinhood
        - elysium
        - ethereum
    UiWalletIdentity:
      type: object
      description: One source's resolved profile for a trade's trader.
      required:
        - source
      properties:
        avatar:
          type:
            - string
            - 'null'
          description: >-
            CDN URL of the avatar to render; `null` until the picture is
            mirrored.
        displayName:
          type:
            - string
            - 'null'
          description: Human-readable name to render.
        farcaster:
          type:
            - string
            - 'null'
          description: The wallet's Farcaster handle, where the source links one.
        handle:
          type:
            - string
            - 'null'
          description: The wallet's handle on the source.
        source:
          $ref: '#/components/schemas/IdentitySource'
          description: Who resolved this identity.
        telegram:
          type:
            - string
            - 'null'
          description: The wallet's Telegram handle, where the source links one.
        twitter:
          type:
            - string
            - 'null'
          description: The wallet's bare X handle, where the source links one.
    UiMoney:
      type: object
      description: >-
        A chain-denominated value with its USD equivalent. The enclosing object
        carries the

        `chain` that names `native`'s unit.
      required:
        - native
      properties:
        native:
          $ref: '#/components/schemas/Decimal'
          description: Value in the owning chain's gas asset.
        usd:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/Decimal'
              description: Value in USD; `null` when the native asset is unpriced.
          description: Value in USD; `null` when the native asset is unpriced.
    UiPlatform:
      oneOf:
        - type: object
          description: >-
            fomo.family, the terminal that routed the trade. The trader's
            profile is the `fomo`

            element of `identities`.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - fomo
        - type: object
          description: >-
            A token's DexScreener listing; present only while its profile is
            paid.
          required:
            - isPaid
            - platform
          properties:
            isPaid:
              type: boolean
              description: Whether the token's DexScreener profile is paid.
            paidAt:
              oneOf:
                - type: 'null'
                - $ref: '#/components/schemas/UnixMilliseconds'
                  description: Earliest profile payment time.
              description: Earliest profile payment time.
            platform:
              type: string
              description: Which platform this is.
              enum:
                - dexScreener
        - type: object
          description: Axiom.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - axiom
        - type: object
          description: '"Banana Gun".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - bananaGun
        - type: object
          description: Bloom.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - bloom
        - type: object
          description: '"BONKbot".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - bonkbot
        - type: object
          description: BtcTurk.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - btcTurk
        - type: object
          description: BullX.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - bullX
        - type: object
          description: Click.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - click
        - type: object
          description: '"GMGN".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - gmgn
        - type: object
          description: '"Lucky Block".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - luckyBlock
        - type: object
          description: Maestro.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - maestro
        - type: object
          description: '"Manifold Trading".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - manifoldTrading
        - type: object
          description: '"MEVX".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - mevx
        - type: object
          description: Mintech.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - mintech
        - type: object
          description: Nighthawk.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - nighthawk
        - type: object
          description: Nova.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - nova
        - type: object
          description: '"OX.FUN".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - oxFun
        - type: object
          description: Padre.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - padre
        - type: object
          description: PepeBoost.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - pepeBoost
        - type: object
          description: Phantom.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - phantom
        - type: object
          description: Photon.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - photon
        - type: object
          description: SexBotSolana.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - sexBotSolana
        - type: object
          description: Shuriken.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - shuriken
        - type: object
          description: '"SOL Sniper Bot".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - solSniperBot
        - type: object
          description: '"Sol Trading Bot".'
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - solTradingBot
        - type: object
          description: Trojan.
          required:
            - platform
          properties:
            platform:
              type: string
              description: Which platform this is.
              enum:
                - trojan
      description: >-
        A platform attached to a token, a wallet, or a trade.


        The fieldless variants are trading terminals, each described by its
        display name.
    UnixMilliseconds:
      type: integer
      format: int64
      description: An instant, as milliseconds since the Unix epoch.
    ErrorCode:
      type: string
      description: |-
        Every wire error code the API can return.

        Append-only: a new code is non-breaking, since clients fall back on the
        HTTP status for one they do not recognize, and a published code is never
        renamed or removed.
      enum:
        - UNAUTHORIZED
        - FORBIDDEN
        - VALIDATION_ERROR
        - UNSUPPORTED_CHAIN
        - NOT_FOUND
        - RATE_LIMITED
        - CREDITS_EXHAUSTED
        - INTERNAL_ERROR
        - SERVICE_UNAVAILABLE
        - RANGE_TOO_LARGE
        - INVALID_CREDENTIALS
        - ORIGIN_NOT_ALLOWED
        - NOT_ORG_MEMBER
        - MEMBERSHIP_INACTIVE
        - EMAIL_NOT_VERIFIED
        - EMAIL_TAKEN
        - ALREADY_MEMBER
        - INVITATION_ALREADY_SENT
        - INVITATION_ALREADY_ACCEPTED
        - LAST_ADMIN
        - CANNOT_REMOVE_SELF
        - KEY_LIMIT_REACHED
        - TOKEN_EXPIRED
        - PAYLOAD_TOO_LARGE
        - UNSUPPORTED_MEDIA_TYPE
        - IMAGE_TOO_LARGE
    IdentitySource:
      type: string
      description: >-
        Who resolved a trader's identity. The set grows; keep a value you do not
        recognize.
      enum:
        - codex
        - fomo
        - pump
        - gmgn
        - axiom
        - arkham
        - unknown
  securitySchemes:
    bearerKey:
      type: http
      scheme: bearer
      description: >-
        Send an API key, or a session token a key minted, as `Authorization:
        Bearer <credential>`. A browser opening `/v1/stream` offers its session
        token in `Sec-WebSocket-Protocol` instead.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.