---
title: "Current advertisements"
method: GET
path: "/api/v1/crypto/dex/ads/latest"
tags: ["Crypto"]
---

# Current advertisements

`GET /api/v1/crypto/dex/ads/latest`

Active advertisement placements on the on-chain DEX market. Each record reports the advertised token (chain + address), the on-chain DEX page URL the ad targets, the ad type (e.g. tokenAd), impression count reported by upstream, and the ad publish date (ISO 8601 UTC). Useful for monitoring promoted tokens appearing on the on-chain DEX front page. Sourced from on-chain DEX data.

## Response `200`

Current advertisements from the on-chain DEX index, newest first.

- EnvelopeDexAdsPayload
  - `data` DexAdsPayload, required — Response payload for /api/v1/crypto/dex/ads/latest.
    - `count` integer, required — Number of ads returned.
    - `ads` DexAd[], required — Current advertisement records, newest first.
      - `url` string, nullable — Canonical page URL linked by the ad.
      - `chainId` string, nullable — Blockchain slug of the advertised token.
      - `tokenAddress` string, nullable — On-chain token contract address.
      - `date` string, nullable — Advertisement publish date (ISO 8601 UTC).
      - `type` string, nullable — Ad type label (e.g. tokenAd).
      - `impressions` integer, nullable — Impression count reported by upstream.
  - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope.
    - `endpoint` string, required — Requested endpoint path.
    - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request.
    - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced.
    - `provider` string, required — API name and version.
    - `source` string, nullable — Identifier of the primary upstream source used for this response.
    - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response.
    - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data.
    - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried.
    - `cached` boolean, nullable — True when this response was served from the internal cache.
    - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data.

## Other responses

- `401` — Missing or invalid `x-api-key` header.
- `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window.
- `503` — Upstream source is temporarily unavailable. Retry after a short delay.

---

[API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/4e2740743eb4/schema)