> For the complete documentation index, see [llms.txt](https://gitbook-docs.coinmetrics.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-docs.coinmetrics.io/cm-api-spec/atlas/list-of-blockchain-entities-v2/full-blockchain-entities-v2/full-transaction.md).
# Full transaction
Returns a full blockchain transaction with all balance updates.\
Results are limited to the last 30 days for Community users.
```json
{"openapi":"3.0.2","info":{"title":"Coin Metrics API v4","version":"4.0.0"},"tags":[{"name":"Full blockchain entities v2","description":"Endpoints for fetching full blockchain entities.\n\n**Endpoints on this page:**\n- `GET /blockchain-v2/{asset}/blocks/{block_hash}` — Full block\n- `GET /blockchain-v2/{asset}/blocks/{block_hash}/transactions/{txid}` — Full transaction for block\n- `GET /blockchain-v2/{asset}/transactions/{txid}` — Full transaction"}],"servers":[{"url":"https://api.coinmetrics.io/v4"},{"url":"wss://api.coinmetrics.io/v4"},{"url":"https://community-api.coinmetrics.io/v4"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"description":"Coin Metrics API key can be specified as `?api_key=` query parameter.","in":"query","name":"api_key","type":"apiKey"}},"parameters":{"BlockchainAsset":{"description":"Asset name.","in":"path","name":"asset","required":true,"schema":{"type":"string"}},"BlockchainTransactionId":{"description":"Transaction identifier (txid).","in":"path","name":"txid","required":true,"schema":{"type":"string"}},"BlockchainIncludeSubAccountsV2":{"description":"Boolean indicating if the response should contain sub-accounts.
This parameter is disabled for Community users.","in":"query","name":"include_sub_accounts","schema":{"default":false,"type":"boolean"}},"Pretty":{"description":"Human-readable formatting of JSON responses.","in":"query","name":"pretty","schema":{"type":"boolean","default":false}},"IgnoreUnsupportedErrors":{"description":"Ignore \"unsupported\" errors for not currently supported by Coin Metrics items.","in":"query","name":"ignore_unsupported_errors","schema":{"type":"boolean","default":false}}},"responses":{"BlockchainFullTransactionV2":{"description":"Blockchain full transaction.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainFullSingleTransactionResponseV2"}}}},"Unauthorized":{"description":"Requested resource requires authorization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"BlockchainForbidden":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource is not available with supplied credentials."}},"schemas":{"BlockchainFullSingleTransactionResponseV2":{"allOf":[{"$ref":"#/components/schemas/BlockchainTransactionInfoV2"},{"type":"object","description":"Blockchain full transaction response.","properties":{"balance_updates":{"$ref":"#/components/schemas/BlockchainTransactionBalanceUpdatesV2"}}}]},"BlockchainTransactionInfoV2":{"allOf":[{"$ref":"#/components/schemas/BlockchainBlockTransactionInfoV2"},{"type":"object","properties":{"block_hash":{"$ref":"#/components/schemas/BlockchainBlockHash"},"height":{"$ref":"#/components/schemas/BlockchainBlockHeight"},"version":{"$ref":"#/components/schemas/BlockchainTransactionVersion"},"physical_size":{"$ref":"#/components/schemas/BlockchainTransactionPhysicalSize"},"consensus_size":{"$ref":"#/components/schemas/BlockchainTransactionConsensusSize"},"fee":{"$ref":"#/components/schemas/BlockchainTransactionFee"},"stale":{"$ref":"#/components/schemas/BlockchainStaleBlock"}},"required":["block_hash","height"]}]},"BlockchainBlockTransactionInfoV2":{"properties":{"txid":{"$ref":"#/components/schemas/BlockchainTransactionId"},"consensus_time":{"$ref":"#/components/schemas/Time"},"miner_time":{"$ref":"#/components/schemas/Time"},"tx_position":{"$ref":"#/components/schemas/BlockchainTransactionPosition"},"min_chain_sequence_number":{"$ref":"#/components/schemas/BlockchainChainSequenceNumber"},"max_chain_sequence_number":{"$ref":"#/components/schemas/BlockchainChainSequenceNumber"},"n_balance_updates":{"$ref":"#/components/schemas/BlockchainNumberOfBalanceUpdates"},"amount":{"$ref":"#/components/schemas/BlockchainTransactionAmount"},"stale":{"$ref":"#/components/schemas/BlockchainStaleBlock"}},"required":["txid","consensus_time","tx_position","n_balance_updates","amount"]},"BlockchainTransactionId":{"description":"Identifier (txid) of the transaction.","type":"string"},"Time":{"description":"The time in ISO 8601 date-time format. Always with nanoseconds precision.","type":"string","format":"date-time"},"BlockchainTransactionPosition":{"description":"Transaction position.","type":"string","format":"int64"},"BlockchainChainSequenceNumber":{"description":"Chain sequence number.","type":"string","format":"int64"},"BlockchainNumberOfBalanceUpdates":{"description":"Number of balance updates.","type":"string","format":"int64"},"BlockchainTransactionAmount":{"description":"Sum of all debits in the transaction.","type":"string","format":"decimal"},"BlockchainStaleBlock":{"description":"This field is set to true if the corresponding block is stale. Otherwise omitted.","type":"string"},"BlockchainBlockHash":{"description":"Hash of the block.","type":"string"},"BlockchainBlockHeight":{"description":"Height of the block.","type":"string","format":"int64"},"BlockchainTransactionVersion":{"description":"Version of the transaction.","type":"string"},"BlockchainTransactionPhysicalSize":{"description":"Physical size of the transaction, bytes.","type":"string","format":"decimal"},"BlockchainTransactionConsensusSize":{"description":"Consensus size of the transaction.","type":"string","format":"decimal"},"BlockchainTransactionFee":{"description":"Fee of the transaction.","type":"string","format":"decimal"},"BlockchainTransactionBalanceUpdatesV2":{"type":"array","items":{"$ref":"#/components/schemas/BlockchainTransactionBalanceUpdateV2"}},"BlockchainTransactionBalanceUpdateV2":{"properties":{"chain_sequence_number":{"$ref":"#/components/schemas/BlockchainChainSequenceNumber"},"account":{"$ref":"#/components/schemas/BlockchainAccount"},"account_creation_height":{"$ref":"#/components/schemas/BlockchainBlockHeight"},"change":{"$ref":"#/components/schemas/BlockchainBalanceChange"},"rebasing_numerator":{"$ref":"#/components/schemas/BlockchainRebasingNumerator"},"rebasing_denominator":{"$ref":"#/components/schemas/BlockchainRebasingDenominator"},"rebasing_rounding_mode":{"$ref":"#/components/schemas/BlockchainRebasingRoundingMode"},"previous_balance":{"$ref":"#/components/schemas/BlockchainAccountBalance"},"new_balance":{"$ref":"#/components/schemas/BlockchainAccountBalance"},"transaction_sequence_number":{"$ref":"#/components/schemas/BlockchainTransactionSequenceNumber"},"n_debits":{"$ref":"#/components/schemas/BlockchainNumberOfDebits"},"n_credits":{"$ref":"#/components/schemas/BlockchainNumberOfCredits"},"previous_debit_height":{"$ref":"#/components/schemas/BlockchainBlockHeight"},"previous_credit_height":{"$ref":"#/components/schemas/BlockchainBlockHeight"},"previous_chain_sequence_number":{"$ref":"#/components/schemas/BlockchainTransactionSequenceNumber"},"sub_account":{"$ref":"#/components/schemas/BlockchainBalanceUpdateSubAccount"},"stale":{"$ref":"#/components/schemas/BlockchainStaleBlock"},"denomination":{"$ref":"#/components/schemas/BlockchainDenomination"}},"required":["chain_sequence_number","account","account_creation_height","change","previous_balance","new_balance","transaction_sequence_number","n_debits","n_credits"]},"BlockchainAccount":{"description":"Account id.","type":"string"},"BlockchainBalanceChange":{"description":"Balance change.","type":"string","format":"decimal"},"BlockchainRebasingNumerator":{"description":"This field represents the numerator of the rebasing coefficient at the time of the update. This value is omitted from responses if equal to the default value of '1'.","type":"string","format":"decimal"},"BlockchainRebasingDenominator":{"description":"This field represents the denominator of the rebasing coefficient at the time of the update. This value is omitted from responses if equal to the default value of '1'.","type":"string","format":"decimal"},"BlockchainRebasingRoundingMode":{"description":"This field represents the rounding mode used when converting tokens to shares using the rebasing coefficient at the time of the update. The possible values are: `UP`, `DOWN`, `HALF_UP`. This value is omitted from responses if equal to the default value of `DOWN`.","type":"string"},"BlockchainAccountBalance":{"description":"Balance of the account.","type":"string","format":"decimal"},"BlockchainTransactionSequenceNumber":{"description":"It is used to order balance updates inside a single transaction to distinguish between serial and parallel balance updates.","type":"string","format":"int64"},"BlockchainNumberOfDebits":{"description":"Number of debits.","type":"string","format":"int64"},"BlockchainNumberOfCredits":{"description":"Number of credits.","type":"string","format":"int64"},"BlockchainBalanceUpdateSubAccount":{"properties":{"sub_account":{"$ref":"#/components/schemas/BlockchainSubAccount"},"previous_balance":{"$ref":"#/components/schemas/BlockchainAccountBalance"},"new_balance":{"$ref":"#/components/schemas/BlockchainAccountBalance"},"n_debits":{"$ref":"#/components/schemas/BlockchainNumberOfDebits"},"n_credits":{"$ref":"#/components/schemas/BlockchainNumberOfCredits"},"previous_credit_height":{"$ref":"#/components/schemas/BlockchainBlockHeight"},"previous_debit_height":{"$ref":"#/components/schemas/BlockchainBlockHeight"},"previous_chain_sequence_number":{"$ref":"#/components/schemas/BlockchainTransactionSequenceNumber"},"total_received":{"$ref":"#/components/schemas/BlockchainTotalReceived"},"total_sent":{"$ref":"#/components/schemas/BlockchainTotalSent"},"creation_height":{"$ref":"#/components/schemas/BlockchainBlockHeight"}},"required":["chain_sequence_number","account","account_creation_height","change","transaction_sequence_number","previous_n_debits","previous_n_credits"]},"BlockchainSubAccount":{"description":"Sub-account id.","type":"string"},"BlockchainTotalReceived":{"description":"Total amount received.","type":"string","format":"decimal"},"BlockchainTotalSent":{"description":"Total amount sent.","type":"string","format":"decimal"},"BlockchainDenomination":{"description":"The denomination of the asset transacted. Only set if not the same as the asset being queried.","type":"string"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorObject"}},"required":["error"],"type":"object"},"ErrorObject":{"properties":{"type":{"description":"Error type string. Can be used for error identification.","type":"string"},"message":{"description":"Human-friendly error description. Can be amended without prior notification. Do not use for error identification in your code.","type":"string"}},"required":["type","description"],"type":"object"}}},"paths":{"/blockchain-v2/{asset}/transactions/{txid}":{"get":{"summary":"Full transaction","description":"Returns a full blockchain transaction with all balance updates.
Results are limited to the last 30 days for Community users.","operationId":"getBlockchainV2FullTransaction","tags":["Full blockchain entities v2"],"parameters":[{"$ref":"#/components/parameters/BlockchainAsset"},{"$ref":"#/components/parameters/BlockchainTransactionId"},{"$ref":"#/components/parameters/BlockchainIncludeSubAccountsV2"},{"$ref":"#/components/parameters/Pretty"},{"$ref":"#/components/parameters/IgnoreUnsupportedErrors"}],"responses":{"200":{"$ref":"#/components/responses/BlockchainFullTransactionV2"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/BlockchainForbidden"}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook-docs.coinmetrics.io/cm-api-spec/atlas/list-of-blockchain-entities-v2/full-blockchain-entities-v2/full-transaction.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.