---
agentTools:
  projectIndex: https://geniidata.readme.io/llms.txt
---

# [Premium]Get Collection Events

Get events by inscription_id

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Geniidata API Endpoints",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.geniidata.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "x-default": "142cf1b0-1ca7-11ee-bb5e-9d74c2e854ac",
        "name": "api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/1/collection/inscription/{inscription_id}/events": {
      "get": {
        "summary": "[Premium]Get Collection Events",
        "description": "Get events by inscription_id",
        "operationId": "premiumget-collection-events",
        "parameters": [
          {
            "name": "inscription_id",
            "in": "path",
            "schema": {
              "type": "string",
              "default": "b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0"
            },
            "required": true
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20
            }
          },
          {
            "name": "search_after",
            "in": "query",
            "description": "Please add them in the strict order of their return.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "description": "default blocktimeDesc",
            "schema": {
              "type": "string",
              "enum": [
                "blocktimeDesc",
                "blocktimeAsc"
              ],
              "default": "blocktimeDesc"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": {\n    \"count\": 7,\n    \"search_after\": [\n      1678501115,\n      \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731:0:0\"\n    ],\n    \"list\": [\n      {\n        \"inscription_id\": \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0\",\n        \"collection_id\": \"bitcoin-frogs\",\n        \"item_name\": \"Bitcoin Frog #1445\",\n        \"collection_name\": \"Bitcoin Frogs\",\n        \"event_type\": \"transfer\",\n        \"marketplace\": \"MagicEden\",\n        \"price_in_sats\": \"4378050\",\n        \"price_in_usd\": \"2857.613214285\",\n        \"block_time\": 1718751131,\n        \"block_height\": 848537,\n        \"from_address\": \"bc1pgxh8wg4pend8hkpqmeeqky3qdhmzv8vhlzxemnsn4sy9qjcnd26q4ulvgu\",\n        \"to_address\": \"bc1pxa3t0m72x55wvxyh2fp65s9rh406mmujwqxj3fvvt2xv9j6ywzhq37k2xd\",\n        \"tx_id\": \"a3cec88df98622138a1e783e65925dd25222b8497b1dc9cb0e490b4cfbcc098e\",\n        \"tx_index\": 1263\n      },\n      {\n        \"inscription_id\": \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0\",\n        \"collection_id\": \"bitcoin-frogs\",\n        \"item_name\": \"Bitcoin Frog #1445\",\n        \"collection_name\": \"Bitcoin Frogs\",\n        \"event_type\": \"transfer\",\n        \"marketplace\": \"MagicEden\",\n        \"price_in_sats\": \"3921007\",\n        \"price_in_usd\": \"2549.5944153779\",\n        \"block_time\": 1718676286,\n        \"block_height\": 848410,\n        \"from_address\": \"bc1qcruzep3tced5jz256th8psuyzxsea3jsxa0mer\",\n        \"to_address\": \"bc1pgxh8wg4pend8hkpqmeeqky3qdhmzv8vhlzxemnsn4sy9qjcnd26q4ulvgu\",\n        \"tx_id\": \"9533c80d83e71ad5eb76206fc38ebfac2047637b46e552686111d102b2e8d6fa\",\n        \"tx_index\": 524\n      },\n      {\n        \"inscription_id\": \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0\",\n        \"collection_id\": \"bitcoin-frogs\",\n        \"item_name\": \"Bitcoin Frog #1445\",\n        \"collection_name\": \"Bitcoin Frogs\",\n        \"event_type\": \"transfer\",\n        \"marketplace\": \"OKX\",\n        \"price_in_sats\": \"20905000\",\n        \"price_in_usd\": \"8302.80331150\",\n        \"block_time\": 1706201902,\n        \"block_height\": 827334,\n        \"from_address\": \"bc1p7epuulzwm64umdll8ntqfak833em8zl53ggyfkz5gflsr5xzghzsdf8cgw\",\n        \"to_address\": \"bc1qcruzep3tced5jz256th8psuyzxsea3jsxa0mer\",\n        \"tx_id\": \"39b029f0788a994819d7d680f975d2fe6ceaa9e7865dd559146c27062c934c9a\",\n        \"tx_index\": 1349\n      },\n      {\n        \"inscription_id\": \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0\",\n        \"collection_id\": \"bitcoin-frogs\",\n        \"item_name\": \"Bitcoin Frog #1445\",\n        \"collection_name\": \"Bitcoin Frogs\",\n        \"event_type\": \"transfer\",\n        \"marketplace\": \"OKX\",\n        \"price_in_sats\": \"33521600\",\n        \"price_in_usd\": \"14176.18742736\",\n        \"block_time\": 1702729058,\n        \"block_height\": 821456,\n        \"from_address\": \"bc1pnaevyml4e6xrng5cpzn2642ypsw477he8uuqzaklqhrwhsvuuhyq3xawxm\",\n        \"to_address\": \"bc1p7epuulzwm64umdll8ntqfak833em8zl53ggyfkz5gflsr5xzghzsdf8cgw\",\n        \"tx_id\": \"b27f8fa7ff30d6dffe8403f8e98445f6e04439043c9247c9f0b7ecb17c3421ff\",\n        \"tx_index\": 3483\n      },\n      {\n        \"inscription_id\": \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0\",\n        \"collection_id\": \"bitcoin-frogs\",\n        \"item_name\": \"Bitcoin Frog #1445\",\n        \"collection_name\": \"Bitcoin Frogs\",\n        \"event_type\": \"transfer\",\n        \"marketplace\": \"marketplace\",\n        \"price_in_sats\": \"26875000\",\n        \"price_in_usd\": \"11497.03362500\",\n        \"block_time\": 1702615158,\n        \"block_height\": 821247,\n        \"from_address\": \"bc1p7q4atfhrvr42zaxhjlv0awlst7dv60aulgjx7xr66jvfwtnz43eqckt5a2\",\n        \"to_address\": \"bc1pnaevyml4e6xrng5cpzn2642ypsw477he8uuqzaklqhrwhsvuuhyq3xawxm\",\n        \"tx_id\": \"e1c555a1338736f90eff5e0bac6b9a66e738ac1d2a0309eab59ece47831d7721\",\n        \"tx_index\": 1258\n      },\n      {\n        \"inscription_id\": \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0\",\n        \"collection_id\": \"bitcoin-frogs\",\n        \"item_name\": \"Bitcoin Frog #1445\",\n        \"collection_name\": \"Bitcoin Frogs\",\n        \"event_type\": \"transfer\",\n        \"block_time\": 1689108950,\n        \"block_height\": 798307,\n        \"from_address\": \"bc1pwkgzpc8g4qzwe4l02kdpwgpxvuzz6dc4ynmxdjp0tmlp4akfqcdquuhtlz\",\n        \"to_address\": \"bc1p7q4atfhrvr42zaxhjlv0awlst7dv60aulgjx7xr66jvfwtnz43eqckt5a2\",\n        \"tx_id\": \"a019e8e3186832429f0f206eee52acb2a1e408b121e6618be09802bfa20923d5\",\n        \"tx_index\": 1054\n      },\n      {\n        \"inscription_id\": \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0\",\n        \"collection_id\": \"bitcoin-frogs\",\n        \"item_name\": \"Bitcoin Frog #1445\",\n        \"collection_name\": \"Bitcoin Frogs\",\n        \"event_type\": \"mint\",\n        \"block_time\": 1678501115,\n        \"block_height\": 780226,\n        \"from_address\": \"\",\n        \"to_address\": \"bc1pwkgzpc8g4qzwe4l02kdpwgpxvuzz6dc4ynmxdjp0tmlp4akfqcdquuhtlz\",\n        \"tx_id\": \"b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731\",\n        \"tx_index\": 1702\n      }\n    ]\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "message": {
                      "type": "string",
                      "example": "success"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "integer",
                          "example": 7,
                          "default": 0
                        },
                        "search_after": {
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "example": 1678501115,
                            "default": 0
                          }
                        },
                        "list": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inscription_id": {
                                "type": "string",
                                "example": "b91a9b993611a0ba9a81ac31ddc3291474da89e7a9f94b76700c76d00da85731i0"
                              },
                              "collection_id": {
                                "type": "string",
                                "example": "bitcoin-frogs"
                              },
                              "item_name": {
                                "type": "string",
                                "example": "Bitcoin Frog #1445"
                              },
                              "collection_name": {
                                "type": "string",
                                "example": "Bitcoin Frogs"
                              },
                              "event_type": {
                                "type": "string",
                                "example": "transfer"
                              },
                              "marketplace": {
                                "type": "string",
                                "example": "MagicEden"
                              },
                              "price_in_sats": {
                                "type": "string",
                                "example": "4378050"
                              },
                              "price_in_usd": {
                                "type": "string",
                                "example": "2857.613214285"
                              },
                              "block_time": {
                                "type": "integer",
                                "example": 1718751131,
                                "default": 0
                              },
                              "block_height": {
                                "type": "integer",
                                "example": 848537,
                                "default": 0
                              },
                              "from_address": {
                                "type": "string",
                                "example": "bc1pgxh8wg4pend8hkpqmeeqky3qdhmzv8vhlzxemnsn4sy9qjcnd26q4ulvgu"
                              },
                              "to_address": {
                                "type": "string",
                                "example": "bc1pxa3t0m72x55wvxyh2fp65s9rh406mmujwqxj3fvvt2xv9j6ywzhq37k2xd"
                              },
                              "tx_id": {
                                "type": "string",
                                "example": "a3cec88df98622138a1e783e65925dd25222b8497b1dc9cb0e490b4cfbcc098e"
                              },
                              "tx_index": {
                                "type": "integer",
                                "example": 1263,
                                "default": 0
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "64a6b5dfcf256b08a6c37d8a:6672afa6603a63006368434b"
}
```