Account Endpoints

Set NFT profile picture

Changed on Nov 3, 2026

Set an onchain NFT owned by the authenticated wallet as its verified profile picture. The NFT must be from a verified collection and owned by one of the account's wallets.

post/api/v2/profile/nft-pfp

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key and OpenID Connect (https://auth.opensea.io/.well-known/openid-configuration, scopes: write:profile)
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/profile/nft-pfp/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

chainstring required

Chain the NFT is on

contractAddressstring required

Contract address of the NFT

tokenIdstring required

Token ID of the NFT

Example request

{
  "chain": "ethereum",
  "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "tokenId": "1"
}

Response

NFT profile picture set successfully

chainstring required

collection_slugstring nullable

contract_addressstring required

image_urlstring required

is_verifiedboolean required

token_idstring required

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  the response property became nullable for the status
- warning
  removed the request property
- info
  added the media type */* for the response with the status
- 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

Operation history