FungibleToken

Purchase tokens from an existing offer.

Changed on Aug 18, 2025

Allows users to purchase tokens from an existing offer on the Mina blockchain. This endpoint facilitates the transaction where tokens are transferred from the offer address to the buyer's address in exchange for the specified price.

post/token/offer/buy

Request

Base URL: https://minatokens.com/api/v1
URL: https://minatokens.com/api/v1/token/offer/buy
Auth: API key in header x-api-key

Request body

txType'token:offer:buy'

Must be "token:offer:buy"

tokenAddressstring required

The address of the token contract.

senderstring required

The address (public key) of the sender.

senderPrivateKeystring

The private key of the sender. It is NOT recommended to use this field. Please use the sender field instead. Use this field at your own risk and only if you know what you are doing and do not have access to mina-signer or wallet to get the signature.

nonceinteger

Optional. The nonce for the transaction.

feeinteger

Optional. The fee for the transaction.

memostring

Optional. A memo for the transaction.

developerFeenumber double

Optional. The developer fee for the transaction.

offerAddressstring required

The address of the offer to buy from.

amountnumber double required

The amount of tokens to buy.

Response

Successfully built buy transaction.

senderstring required

The address initiating the transaction.

nonceinteger required

The nonce for the transaction.

memostring required

A memo for the transaction.

feenumber double required

The fee for the transaction.

proverPayloadstring required

The payload for the prover.

signedDatastring required

The signed data for the transaction.

transactionstring required

The raw transaction data.

sendTransactionboolean

Optional. Whether to broadcast the transaction after proving.

symbolstring required

The symbol of the token.

Changes

Aug 18, 2025fbc9e356ba50 Revision changes
- info
  added the new optional request property ////////
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
Feb 17, 20254b49862dbefe Revision changes
- breaking
  the ///// response's property type changed from any to object for status
- info
  api tag FungibleToken added
- info
  api tag Fungible Token removed

Operation history (4 revisions)