---
updatedAt: 2025-11-12T01:01:31.000Z
agentTools:
  projectIndex: https://docs.blockberry.one/llms.txt
---

# getTransactionsByCoinType

Get a list of all transactions run with the queried type (denomination) of coin.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Iota mainnet API",
    "description": "This is the new API Module implementation. The IOTA Blockchain API is used to retrieve IOTA Blockchain data. In order to execute queries you need to get API Key and use it in header 'x-api-key'. However, before that you need to sign up on the explorer or company website. If an account is created on the website <strong>https://staketab.com/</strong> or <strong>https://iotascan.com/</strong>, the user will be granted the <strong>ROLE_USER</strong> role. After that you may fetch API KEY.",
    "termsOfService": "terms-of-service",
    "contact": {
      "name": "Staketab tech support",
      "url": "https://staketab.com/",
      "email": "support@staketab.com"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.blockberry.one/iota-mainnet",
      "description": "Production"
    }
  ],
  "security": [
    {
      "x-api-key": []
    }
  ],
  "paths": {
    "/v1/coins/{coinType}/transactions": {
      "post": {
        "tags": [
          "Coins"
        ],
        "summary": "getTransactionsByCoinType",
        "description": "Get a list of all transactions run with the queried type (denomination) of coin.",
        "operationId": "getTransactionsByCoinType",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Queried API page.",
            "required": true,
            "schema": {
              "minimum": 0,
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "description": "Number of queried entries.",
            "required": true,
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 20
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "description": "Sorting method: from the lowest element to the highest (ASC) or from the highest element to the lowest (DESC).",
            "required": true,
            "schema": {
              "type": "string",
              "default": "DESC",
              "enum": [
                "ASC",
                "DESC"
              ]
            }
          },
          {
            "name": "coinType",
            "in": "path",
            "description": "Erc-20 coin type - a field that looks like that “coin_id::coin::COIN”.",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Erc-20 coin type - a field that looks like that “coin_id::coin::COIN”.",
              "default": "0x2::iota::IOTA"
            }
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "Select sorting parameter.",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Select sorting parameter.",
              "default": "AGE",
              "enum": [
                "AGE"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/SliceTransactionDtoAPI"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "BalanceChanges": {
        "type": "object",
        "properties": {
          "owner": {
            "$ref": "#/components/schemas/ObjectOwner"
          },
          "amount": {
            "type": "string"
          },
          "coinType": {
            "type": "string"
          }
        }
      },
      "MetadataDtoAPI": {
        "type": "object",
        "properties": {
          "objectType": {
            "type": "string",
            "enum": [
              "ACCOUNT",
              "COIN",
              "OBJECT",
              "DOMAIN_NFT",
              "NFT",
              "COLLECTION",
              "OTHER_OBJECT",
              "PACKAGE",
              "TRANSACTION",
              "TRANSACTION_FUNCTION",
              "TRANSACTION_MODULE",
              "POOL",
              "UNKNOWN"
            ]
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "imgUrl": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "poolCoins": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PoolCoinMetadataAPI"
            }
          },
          "projectName": {
            "type": "string"
          },
          "projectImg": {
            "type": "string"
          },
          "isIndexed": {
            "type": "boolean"
          },
          "securityMessage": {
            "type": "string"
          }
        }
      },
      "ObjectOwner": {
        "type": "object",
        "properties": {
          "addressOwner": {
            "type": "string"
          },
          "ownerType": {
            "type": "string",
            "enum": [
              "ACCOUNT",
              "SHARED",
              "OBJECT",
              "IMMUTABLE"
            ]
          }
        }
      },
      "PageableObject": {
        "type": "object",
        "properties": {
          "pageNumber": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "offset": {
            "type": "integer",
            "format": "int64"
          },
          "sort": {
            "$ref": "#/components/schemas/SortObject"
          },
          "paged": {
            "type": "boolean"
          },
          "unpaged": {
            "type": "boolean"
          }
        }
      },
      "PoolCoinMetadataAPI": {
        "type": "object",
        "properties": {
          "coinType": {
            "type": "string"
          },
          "coinSymbol": {
            "type": "string"
          },
          "imgUrl": {
            "type": "string"
          },
          "coinSeq": {
            "type": "integer",
            "format": "int32"
          },
          "securityMessage": {
            "type": "string"
          },
          "hasNoMetadata": {
            "type": "boolean"
          }
        }
      },
      "SortObject": {
        "type": "object",
        "properties": {
          "sorted": {
            "type": "boolean"
          },
          "empty": {
            "type": "boolean"
          },
          "unsorted": {
            "type": "boolean"
          }
        }
      },
      "TransactionDtoAPI": {
        "type": "object",
        "properties": {
          "txHash": {
            "type": "string"
          },
          "txType": {
            "type": "string"
          },
          "packagesMetadata": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataDtoAPI"
            }
          },
          "functions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "txStatus": {
            "type": "string",
            "enum": [
              "SUCCESS",
              "FAILURE",
              "ABORT"
            ]
          },
          "senderAddress": {
            "type": "string"
          },
          "senderName": {
            "type": "string"
          },
          "senderImg": {
            "type": "string"
          },
          "senderSecurityMessage": {
            "type": "string"
          },
          "recipients": {
            "uniqueItems": true,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "fee": {
            "type": "number"
          },
          "timestamp": {
            "type": "integer",
            "format": "int64"
          },
          "checkpoint": {
            "type": "integer",
            "format": "int64"
          },
          "txsCount": {
            "type": "integer",
            "format": "int64"
          },
          "balanceChanges": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BalanceChanges"
            }
          }
        }
      },
      "SliceTransactionDtoAPI": {
        "type": "object",
        "properties": {
          "pageable": {
            "$ref": "#/components/schemas/PageableObject"
          },
          "size": {
            "type": "integer",
            "format": "int32"
          },
          "content": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TransactionDtoAPI"
            }
          },
          "number": {
            "type": "integer",
            "format": "int32"
          },
          "sort": {
            "$ref": "#/components/schemas/SortObject"
          },
          "numberOfElements": {
            "type": "integer",
            "format": "int32"
          },
          "first": {
            "type": "boolean"
          },
          "last": {
            "type": "boolean"
          },
          "empty": {
            "type": "boolean"
          }
        }
      }
    },
    "securitySchemes": {
      "x-api-key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```