Submit Sell

curl -X POST \
  https://grail-stack-dev.onrender.com/v1/sell/trd_8b21d7f3-2a4c-4b5e-9d1f-3e8a7c6b5d4e/submit \
  -H "x-api-key: grail_partner_<hex>" \
  -H "Content-Type: application/json" \
  -d '{
    "signed_tx": "AQAAAAABAAEC...<base64>..."
  }'

{
  "trade_id": "trd_8b21d7f3-2a4c-4b5e-9d1f-3e8a7c6b5d4e",
  "tx_hash": "3xJk9Pq2n...base58"
}

POST

sell

{trade_id}

submit

curl -X POST \
  https://grail-stack-dev.onrender.com/v1/sell/trd_8b21d7f3-2a4c-4b5e-9d1f-3e8a7c6b5d4e/submit \
  -H "x-api-key: grail_partner_<hex>" \
  -H "Content-Type: application/json" \
  -d '{
    "signed_tx": "AQAAAAABAAEC...<base64>..."
  }'

{
  "trade_id": "trd_8b21d7f3-2a4c-4b5e-9d1f-3e8a7c6b5d4e",
  "tx_hash": "3xJk9Pq2n...base58"
}

Overview

Broadcasts the fully-signed sell transaction and returns the on-chain signature. Semantics are identical to Submit Buy — pure passthrough, no database write; the indexer writes the Trade row asynchronously after on-chain confirmation.

Headers

string

required

A valid PARTNER scope key.

Path Parameters

string

required

Trade identifier (prefixed trd_) returned by Quote Sell.

Request Body

string

required

Base64-encoded, fully-signed Solana transaction (GRAIL’s partial sig + partner + user).

Response

string

Echo of the path parameter.

string

Solana transaction signature (base58).

Errors

HTTP	`error`	When
400	`invalid_request`	Missing or non-string `signed_tx`
400	`broadcast_failed`	Solana RPC rejected the transaction — message has reason

curl -X POST \
  https://grail-stack-dev.onrender.com/v1/sell/trd_8b21d7f3-2a4c-4b5e-9d1f-3e8a7c6b5d4e/submit \
  -H "x-api-key: grail_partner_<hex>" \
  -H "Content-Type: application/json" \
  -d '{
    "signed_tx": "AQAAAAABAAEC...<base64>..."
  }'

{
  "trade_id": "trd_8b21d7f3-2a4c-4b5e-9d1f-3e8a7c6b5d4e",
  "tx_hash": "3xJk9Pq2n...base58"
}

Quote Sell Get Trade

API Reference

General

Authentication

Partner

Users

Denominations

Trades

Redemptions

Overview

Headers

Path Parameters

Request Body

Response

Errors

​Overview

​Headers

​Path Parameters

​Request Body

​Response

​Errors

Overview

Headers

Path Parameters

Request Body

Response

Errors