Reference data

Announced listings and delistings

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.

get/api/v1/listings

Request

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

Query parameters

coinstring

One ticker or a comma-separated list, e.g. BTC,ETH. Case-insensitive.

exchangestring

Keep rows on these venues. One venue or a comma-separated list, spelled as /exchanges spells it, e.g. Binance,Bybit.

exclude_exchangestring

Drop rows on these venues. One venue or a comma-separated list, spelled as /exchanges spells it, e.g. Binance,Bybit.

typestring

listing or delisting. Default: both.

statusstring

Exact status as the row carries it, e.g. preopen, newly listed, delisted.

sourcestring

announcement, instruments or diff: how the row was detected. Default: all.

fromstring date-time

Keep rows effective at or after this time (ISO 8601 UTC).

tostring date-time

Keep rows effective before this time (ISO 8601 UTC).

days_aheadinteger

Shortcut: rows effective between now and this many days ahead, 1 to 365. Ignored when from or to is given.

detected_afterstring date-time

Keep rows first seen after this time (ISO 8601 UTC): what is new since your last poll.

sortstring

nearest (default: upcoming soonest first, then past most recent first, undated last), effective_asc, effective_desc, detected_desc, detected_asc, coin_asc.

limitinteger

Rows per page, 1 to 500 (Demo: 50). Default 100.

cursorstring

meta.next_cursor from the previous page.

fieldsstring

Comma-separated row fields to keep, e.g. exchange,coin,rate_pct; the others are dropped from every row. Unknown names are a 400 that lists the fields.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.