Bitcoin Stamps (stampchain.io)
Bitcoin Stamps encompass a collection of sub-protocols built on Bitcoin, all embodying the ethos of immutability. Here's an overview of the various stamp types and their historical significance: ## CLASSIC STAMPS NFT tokens where each Stamp can utilize a built-in token layer via standards developed on Counterparty in 2014. Originally, Stamps were encouraged to be 1:1, but creators can issue up…
5 subscribers
46 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Bitcoin Stamps (stampchain.io) endpoints
| Method | Endpoint | Description |
|---|---|---|
| System | ||
| GET |
getHealthStatus /api/v2/health |
Checks if the API service is running and responding correctly. Validates the status of core services including the API, indexer, and mempool connectivity. Also provides block… |
| GET |
getApiVersion /api/v2/version |
Returns the current version of the API being used. |
| GET |
testErrorResponse /api/v2/error |
Test endpoint that always returns an error response. Used for testing error handling and responses. |
| Documentation | ||
| GET |
getApiDocs /api/v2/docs |
Returns the OpenAPI documentation. Can be filtered by path or tag. |
| Balance | ||
| GET |
getAddressBalance /api/v2/balance/{address} |
Convenience endpoint that combines stamp and SRC-20 balance data in a single request. For better performance and pagination control, consider using the dedicated endpoints: -… |
| Blocks | ||
| GET |
getBlockInfo /api/v2/block/{block_index} |
Retrieves detailed information about a specific block, including transactions, stamps, and other block-related data. |
| GET |
getLastBlocks /api/v2/block/block_count/{number} |
Returns information about the most recent blocks, with the number of blocks specified in the request. |
| Collections | ||
| GET |
getCollectionsByCreator /api/v2/collections/creator/{creator} |
Retrieves a paginated list of stamp collections for a specific creator. |
| GET |
getCollections /api/v2/collections |
Retrieves a paginated list of all stamp collections. |
| Cursed Stamps | ||
| GET |
getCursedStampsByBlock /api/v2/cursed/block/{block_index} |
Retrieves all cursed stamps that were created or identified in a specific block. |
| GET |
getCursedStamps /api/v2/cursed |
Retrieves a paginated list of cursed stamps. Cursed stamps are stamps with negative stamp numbers that have been identified as invalid or problematic. |
| GET |
getCursedStampById /api/v2/cursed/{id} |
Retrieves a specific cursed stamp by its identifier. Cursed stamps simply have a negative stamp number. This endpoint is equivalent to /api/v2/stamps/{id} but specifically for… |
| SRC-20 | ||
| GET |
getSrc20BlockTransactions /api/v2/src20/block/{block_index} |
Retrieves all SRC-20 transactions that occurred in a specific block. Results can be filtered and paginated. |
| GET |
getSrc20TickOperations /api/v2/src20/tick |
Retrieve paginated valid SRC-20 transactions by operation type (DEPLOY, MINT, TRANSFER) |
| GET |
getSrc20BlockTickTransactions /api/v2/src20/block/{block_index}/{tick} |
Retrieves SRC20 transactions filtered by block index and tick value, with additional optional filtering and pagination parameters. |
| GET |
getSrc20TickData /api/v2/src20/tick/{tick} |
Retrieve paginated tick data for a specific tick |
| GET |
getSrc20TickSnapshot /api/v2/src20/balance/snapshot/{tick} |
Retrieves a snapshot of all owners for the SRC-20 tick value based upon the current block height. This provides a complete overview of token distribution at the current point in… |
| GET |
getSrc20TickDeployInfo /api/v2/src20/tick/{tick}/deploy |
Retrieve deployment details for a specific tick in the tick API. |
| GET |
getSrc20Transactions /api/v2/src20 |
Retrieves a paginated list of valid SRC-20 transactions with optional limit and page parameters. |
| GET |
getSrc20TransactionInfo /api/v2/src20/tx/{tx_hash} |
Retrieves detailed information about a specific SRC-20 transaction by its transaction hash. |
| GET |
getSrc20AddressBalance /api/v2/src20/balance/{address} |
Retrieves all SRC-20 token balances for a specific Bitcoin address. |
| GET |
getSrc20AddressTickBalance /api/v2/src20/balance/{address}/{tick} |
Retrieves the balance of a specific SRC-20 token (identified by tick) for a given Bitcoin address. |
| SRC-101 | ||
| GET |
getSrc101TokenInfo /api/v2/src101/{deploy_hash}/{tokenid} |
Retrieve detailed information about a specific SRC-101 token using its deployment hash and token identifier. |
| GET |
getSrc101TotalSupply /api/v2/src101/{deploy_hash}/total |
Retrieve the total supply and related statistics for a specific SRC-101 token using its deployment hash. |
| POST |
createSrc101 /api/v2/src101/create |
This returns a hex encoded serialized PSBT transaction ready for signing and broadcasting via wallet or library. |
| GET |
getSrc101AddressBalance /api/v2/src101/balance/{address} |
Retrieve all SRC-101 token balances for a specific Bitcoin address, including details about each token held. |
| GET |
getSrc101TokensByAddress /api/v2/src101/{deploy_hash}/address/{address_btc} |
Retrieve deployment details for a specific deploy_hash in the deploy_hash API. |
| GET |
getSrc101DeployInfo /api/v2/src101/{deploy_hash}/deploy |
Retrieve comprehensive deployment information for a specific SRC-101 token using its deployment transaction hash. |
| GET |
getSrc101TokenByIndex /api/v2/src101/index/{deploy_hash}/{index} |
Retrieve token information using its deployment hash and numeric index. This endpoint provides an alternative way to access token data. |
| GET |
getSrc101TransactionByHash /api/v2/src101/tx/{tx_hash} |
Retrieve detailed information about a specific SRC-101 transaction using its transaction hash. |
| GET |
getSrc101Transactions /api/v2/src101 |
Retrieve paginated valid SRC-101 transactions with optional limit and page parameters |
| GET |
getSrc101TransactionList /api/v2/src101/tx |
Retrieve paginated SRC-101 transactions with optional filtering by block index, operation type, and validation status. |
| GET |
getSrc101Owner /api/v2/src101/{deploy_hash} |
Return all src101 data that matches the rule by filtering |
| Stamps | ||
| GET |
getStampBalance /api/v2/stamps/balance/{address} |
Retrieve all stamp balances for a specific Bitcoin address. |
| GET |
getStampHolders /api/v2/stamps/{id}/holders |
Retrieve all current holders of a specific stamp. |
| GET |
getStampsByIdent /api/v2/stamps/ident/{ident} |
Retrieve stamps based on their identifier type (SRC-721, STAMP). |
| GET |
getStamps /api/v2/stamps |
Retrieve a paginated list of stamps. |
| GET |
getStampById /api/v2/stamps/{id} |
Retrieve a specific stamp using its ID (tx_hash, stamp number, or cpid). |
| GET |
getStampDispenses /api/v2/stamps/{id}/dispenses |
Retrieve the complete dispense history for a specific stamp. |
| GET |
getStampDispensersById /api/v2/stamps/{id}/dispensers |
Retrieve all dispensers (open and closed) for a specific stamp. |
| GET |
getStampSends /api/v2/stamps/{id}/sends |
Retrieve the complete transfer history for a specific stamp. |
| GET |
getStampsByBlock /api/v2/stamps/block/{block_index} |
Retrieve all stamps that were created in a specific block. |
| POST |
attachStampById /api/v2/trx/stampattach |
Creates a PSBT transaction to attach a stamp using its identifier (cpid, stamp number, or tx_hash). The stamp will be attached to the specified address. Optionally, a specific… |
| POST |
detachStampFromUtxo /api/v2/trx/stampdetach |
Creates a PSBT transaction to detach a stamp from a specific UTXO. If no destination is provided, the stamp will be detached to the address corresponding to the UTXO. |
| Minting | ||
| POST |
createSrc20Token /api/v2/src20/create |
This returns a hex encoded serialized PSBT transaction ready for signing and broadcasting via wallet or library. |
| POST |
mintStamp /api/v2/olga/mint |
Creates a new stamp minting transaction that needs to be signed by the wallet |
Bitcoin Stamps (stampchain.io) pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
