OpenSea live NFT Insight

OpenSea live NFT Insight · GPT アクション

OpenSea API

API to interact with OpenSea

  • GET /accounts/{account_id}Retrieve account information from OpenSea
  • GET /collections/{collection_slug}Retrieve collection information from OpenSea
  • GET /collectionsGet a list of OpenSea collections.
  • GET /chain/{chain}/contract/{address}Get a smart contract for a given chain and address
  • GET /chain/{chain}/contract/{address}/nfts/{identifier}Get metadata, traits, ownership information, and rarity for a single NFT
  • GET /chain/{chain}/account/{address}/nftsGet NFTs owned by a given account address
  • GET /collection/{collection_slug}/nftsGet multiple NFTs for a collection
  • GET /chain/{chain}/contract/{address}/nftsGet multiple NFTs for a smart contract
  • GET /traits/{collection_slug}Get the traits in a collection
元の API スキーマ
{
  "openapi": "3.1.0",
  "info": {
    "title": "OpenSea API",
    "version": "1.0.0",
    "description": "API to interact with OpenSea"
  },
  "servers": [
    {
      "url": "https://api.opensea.io/api/v2"
    }
  ],
  "paths": {
    "/accounts/{account_id}": {
      "get": {
        "operationId": "getAccountInfo",
        "summary": "Retrieve account information from OpenSea",
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "address": {
                      "type": "string"
                    },
                    "username": {
                      "type": "string"
                    },
                    "profile_image_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "banner_image_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "website": {
                      "type": "string"
                    },
                    "social_media_accounts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "platform": {
                            "type": "string"
                          },
                          "username": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "bio": {
                      "type": "string"
                    },
                    "joined_date": {
                      "type": "string",
                      "format": "date"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/collections/{collection_slug}": {
      "get": {
        "operationId": "getCollection",
        "summary": "Retrieve collection information from OpenSea",
        "parameters": [
          {
            "name": "collection_slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "collection": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "image_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "banner_image_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "owner": {
                      "type": "string"
                    },
                    "safelist_status": {
                      "type": "string"
                    },
                    "category": {
                      "type": "string"
                    },
                    "is_disabled": {
                      "type": "boolean"
                    },
                    "is_nsfw": {
                      "type": "boolean"
                    },
                    "trait_offers_enabled": {
                      "type": "boolean"
                    },
                    "collection_offers_enabled": {
                      "type": "boolean"
                    },
                    "opensea_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "project_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "wiki_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "discord_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "telegram_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "twitter_username": {
                      "type": "string"
                    },
                    "instagram_username": {
                      "type": "string"
                    },
                    "contracts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "address": {
                            "type": "string"
                          },
                          "chain": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "editors": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "fees": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "fee": {
                            "type": "number"
                          },
                          "recipient": {
                            "type": "string"
                          },
                          "required": {
                            "type": "boolean"
                          }
                        }
                      }
                    },
                    "payment_tokens": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "symbol": {
                            "type": "string"
                          },
                          "address": {
                            "type": "string"
                          },
                          "chain": {
                            "type": "string"
                          },
                          "image": {
                            "type": "string",
                            "format": "uri"
                          },
                          "name": {
                            "type": "string"
                          },
                          "decimals": {
                            "type": "integer"
                          },
                          "eth_price": {
                            "type": "string"
                          },
                          "usd_price": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "total_supply": {
                      "type": "integer"
                    },
                    "created_date": {
                      "type": "string",
                      "format": "date"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/collections": {
      "get": {
        "operationId": "getCollections",
        "summary": "Get a list of OpenSea collections.",
        "parameters": [
          {
            "name": "chain_identifier",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include_hidden",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 100
            }
          },
          {
            "name": "next",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/chain/{chain}/contract/{address}": {
      "get": {
        "operationId": "getContract",
        "summary": "Get a smart contract for a given chain and address",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/chain/{chain}/contract/{address}/nfts/{identifier}": {
      "get": {
        "operationId": "getNFT",
        "summary": "Get metadata, traits, ownership information, and rarity for a single NFT",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/chain/{chain}/account/{address}/nfts": {
      "get": {
        "operationId": "getNFTsByAccount",
        "summary": "Get NFTs owned by a given account address",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "collection",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 50
            }
          },
          {
            "name": "next",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/collection/{collection_slug}/nfts": {
      "get": {
        "operationId": "getNFTsByCollection",
        "summary": "Get multiple NFTs for a collection",
        "parameters": [
          {
            "name": "collection_slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 50
            }
          },
          {
            "name": "next",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/chain/{chain}/contract/{address}/nfts": {
      "get": {
        "operationId": "getNFTsByContract",
        "summary": "Get multiple NFTs for a smart contract",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 50
            }
          },
          {
            "name": "next",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/traits/{collection_slug}": {
      "get": {
        "operationId": "getTraits",
        "summary": "Get the traits in a collection",
        "parameters": [
          {
            "name": "collection_slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    },
    "schemas": {}
  }
}