---
title: "Get tokens by contract identifiers"
method: POST
path: "/api/v2/tokens/batch"
tags: ["Token Endpoints"]
---

# Get tokens by contract identifiers

`POST /api/v2/tokens/batch`

Retrieve multiple tokens in a single request by providing a list of contract identifiers (chain and address). Not-found tokens are silently omitted from the response.

## Request body

- BatchTokensRequest — Request body for batch token retrieval by contract identifiers
  - `contracts` TokenContractInput[], required — List of token contract identifiers to retrieve
    - `chain` string, required — The blockchain the token is on
    - `address` string, required — The contract address of the token

## Response `200`

OK

## Other responses

- `400` — For error reasons, review the response data.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal server error. Please open a support ticket so OpenSea can investigate.

---

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