OPopensea
Search Endpoints

Search across OpenSea

Changed on

Search across collections, tokens, NFTs, and accounts. Results are ranked by relevance.

get/api/v2/search

Request

Query parameters

querystring required

Search query text

chainsChainIdentifier[]

Filter by blockchain(s)

[
  "ethereum"
]
asset_typesstring[]

Filter by asset type(s). Valid values: collection, nft, token, account. Defaults to [collection, token] if not specified.

limitinteger

Number of results to return (default: 20, max: 50)

Response

OK

Example response

{
  "results": [
    {
      "collection": {
        "collection": "bored-ape-yacht-club",
        "name": "Bored Ape Yacht Club"
      },
      "nft": {
        "best_listing": {
          "currency": "ETH",
          "currency_address": "0x0000000000000000000000000000000000000000",
          "price": "0.25",
          "price_usd": "812.5"
        },
        "collection": "bored-ape-yacht-club",
        "identifier": "1234"
      },
      "token": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "chain": "ethereum",
        "decimals": 6,
        "name": "USDC",
        "symbol": "USDC",
        "usd_price": "1.0"
      },
      "type": "collection"
    }
  ]
}

Changes

  • 2c7935d84f90Revision changes
    • breaking

      removed the enum value b3 from the property items/ of the query request parameter chains

    • breaking

      removed the enum value blast from the property items/ of the query request parameter chains

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • info

      added the enum value stablechain to the property items/ of the query request parameter chains

    • info

      added the media type */* for the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property /// to the response with the status