Transactions

Create an itemized transaction (Professional/Enterprise plans)

post/transactions/create-detailed

Request

  • Base URL: https://api.griffnode.com/v1
  • URL: https://api.griffnode.com/v1/transactions/create-detailed
  • Auth: HTTP bearer

Headers

X-Idempotency-Keystring

Optional unique key for a create request (e.g. a UUID). A retried create with the same key returns the original transaction instead of creating a duplicate — send it on every create so a network retry can't double-charge the customer.

Request body

crypto'BTC' | 'LTC' | 'DOGE' | 'DASH' | 'ETH' | 'USDT' | 'USDC' | 'EURC' | 'DAI' | 'WBTC' | 'SHIB' | 'PEPE' | 'LINK' | 'UNI' | 'AAVE' | 'MKR' required

Supported coin/token symbol. /cryptos/list is authoritative at runtime.

currency_fiat'USD' | 'PLN' | 'EUR' | 'GBP'
order_idstring required
metadataMetadata nullable

Free-form key/value (≤20 keys, string values ≤500 chars, ≤4 KB total).

customer_emailstring email nullable
success_urlstring uri nullable
cancel_urlstring uri nullable

Response

Transaction created.

successunknown required

Example response

{
  "data": {
    "transaction_id": "MTX-A1B2C3D4"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.