---
title: "Changes to Get tokens by contract identifiers"
method: POST
path: "/api/v2/tokens/batch"
---

# Changes to Get tokens by contract identifiers

`POST /api/v2/tokens/batch`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `2c7935d84f90`: 10 breaking, 16 warning, 8 info

## Changes

- **2026-11-03** `2c7935d84f90`: 10 breaking, 16 warning, 8 info
  - the response property `tokens/items/created_at` became nullable for the status `200`
  - the response property `tokens/items/description` became nullable for the status `200`
  - the response property `tokens/items/description_generated_at` became nullable for the status `200`
  - the response property `tokens/items/description_source` became nullable for the status `200`
  - the response property `tokens/items/description_sources` became nullable for the status `200`
  - the response property `tokens/items/genesis_date` became nullable for the status `200`
  - the response property `tokens/items/holders_count` became nullable for the status `200`
  - the response property `tokens/items/image_url` became nullable for the status `200`
  - the `tokens/items/socials` response's property type changed from `object` to no type for status `200`
  - the `tokens/items/stats` response's property type changed from `object` to no type for status `200`
  - removed the optional property `tokens/items/socials/subreddit_identifier` from the response with the `200` status
  - removed the optional property `tokens/items/socials/telegram_identifier` from the response with the `200` status
  - removed the optional property `tokens/items/socials/twitter_follower_count` from the response with the `200` status
  - removed the optional property `tokens/items/socials/twitter_handle` from the response with the `200` status
  - removed the optional property `tokens/items/socials/website` from the response with the `200` status
  - removed the optional property `tokens/items/stats/circulating_supply` from the response with the `200` status
  - removed the optional property `tokens/items/stats/fdv_usd` from the response with the `200` status
  - removed the optional property `tokens/items/stats/market_cap_usd` from the response with the `200` status
  - removed the optional property `tokens/items/stats/max_supply` from the response with the `200` status
  - removed the optional property `tokens/items/stats/price_change_1h` from the response with the `200` status
  - removed the optional property `tokens/items/stats/price_change_24h` from the response with the `200` status
  - removed the optional property `tokens/items/stats/price_change_30d` from the response with the `200` status
  - removed the optional property `tokens/items/stats/price_change_7d` from the response with the `200` status
  - removed the optional property `tokens/items/stats/total_supply` from the response with the `200` status
  - removed the optional property `tokens/items/stats/volume_24h` from the response with the `200` status
  - added the new `undefined` enum value to the `tokens/items/description_source` response property for the response status `200`
  - added the media type `*/*` for the response with the status `400`
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `409` status
  - added the optional property `tokens/items/description_provider` to the response with the `200` status
  - added `#/components/schemas/TokenSocialsResponse, subschema #2` to the `tokens/items/socials` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/TokenStatsResponse, subschema #2` to the `tokens/items/stats` response property `anyOf` list for the response status `200`

---

[Operation](https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/tokens/batch/post.md) - [API](https://skmtc.dev/opensea/apis/opensea-api.md) - [Page](https://skmtc.dev/opensea/apis/opensea-api/changes/api/v2/tokens/batch/post)