---
title: "Announced listings and delistings"
method: GET
path: "/api/v1/listings"
tags: ["Reference data"]
---

# Announced listings and delistings

`GET /api/v1/listings`

## Request

- Base URL: `https://arbitron.app`
- URL: `https://arbitron.app/api/v1/listings`
- Auth: HTTP bearer

The listings calendar: what each venue has announced, when it takes effect and where the announcement is. Filter by coin, venue, kind, status, detection source, an effective window and what is new since a time (`detected_after`); nearest first by default.

## Query parameters

- `coin` string
- `exchange` string
- `exclude_exchange` string
- `type` string
- `status` string
- `source` string
- `from` string, date-time
- `to` string, date-time
- `days_ahead` integer
- `detected_after` string, date-time
- `sort` string
- `limit` integer
- `cursor` string
- `fields` string

## Response `200`

OK

- ApiEnvelopeOfIReadOnlyListOfListingItem
  - `data` ListingItem[], nullable, required
    - `exchange` string, required
    - `symbol` string, required
    - `coin` string, required
    - `kind` string, required
    - `status` string, nullable, required
    - `effective_at` string, date-time, nullable, required
    - `source` string, required
    - `announcement_url` string, nullable, required
    - `detected_at` string, date-time, required
  - `meta` ApiMeta, required
    - `as_of` string, date-time, required
    - `delayed_seconds` integer, required
    - `source` string, required
    - `url` string, required
    - `count` integer, nullable
    - `total` integer, nullable
    - `next_cursor` string, nullable
    - `withheld` integer, nullable

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/arbitron/apis/arbitron-api.md) · [All operations](https://skmtc.dev/arbitron/apis/arbitron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/arbitron/apis/arbitron-api/revisions/dd08806fd48e?raw)