Submit Signed Transaction

This endpoint is used to submit signed singular transaction.

Transactions submitted to this endpoint must include a bloXroute memo instruction in order to be processed. If you are using the Trader API endpoints or SDKs the instruction will be added automatically. If you want to construct your own transaction and use our submit endpoint, please read more about Transaction Submission. Elite & Ultra tier customers will be exempted if the transaction submitted includes a tipping instruction, to save an instruction in the transaction.

Request

Method:

POST ./api/v2/submit

Parameters:

Parameter type Description

Parameter	type	Description
`transaction`	`TransactionMessage`	See `TransactionMesssage` below
`skipPreFlight`	boolean	OPTIONAL. Useful for disabling transaction simulation before actual submission. `true` or `false`, Default `False`
`frontRunningProtection`	boolean	OPTIONAL. Specify if you would like to enable the Front-Running Protection feature. The transaction must include an `Tip` instruction to pay for the service fee. You can include an `Tip` instruction but set this field to `False`. In this case, Trader API will propagate to both Jito and publicly. Default `False`.
`fastBestEffort`	boolean	OPTIONAL. This is an optional parameter that effects the behavior of `frontRunningProtection` which must be set to True to use this feature. Enabling this parameter will allow you to submit your transaction not only to the Jito but also to bloXroute-identified low-risk validators.
`useStakedRPCs`	boolean	OPTIONAL. An `tip` instruction with a minimum of 0.001 SOL is required and `frontRunningProtection` must be set to False to use this feature. When enabled, Trader API will use weighted stake qOS to submit your transaction to the Leader. The cost will be 10% of the `tip` amount.

transaction

TransactionMessage

See TransactionMesssage below

skipPreFlight

boolean

OPTIONAL. Useful for disabling transaction simulation before actual submission. true or false, Default False

frontRunningProtection

boolean

OPTIONAL. Specify if you would like to enable the Front-Running Protection feature. The transaction must include an Tip instruction to pay for the service fee. You can include an Tip instruction but set this field to False. In this case, Trader API will propagate to both Jito and publicly. Default False.

fastBestEffort

boolean

OPTIONAL. This is an optional parameter that effects the behavior of frontRunningProtection which must be set to True to use this feature. Enabling this parameter will allow you to submit your transaction not only to the Jito but also to bloXroute-identified low-risk validators.

useStakedRPCs

boolean

OPTIONAL. An tip instruction with a minimum of 0.001 SOL is required and frontRunningProtection must be set to False to use this feature. When enabled, Trader API will use weighted stake qOS to submit your transaction to the Leader. The cost will be 10% of the tip amount.

TransactionMessage

Parameter type Description

Parameter	type	Description
`content`	txbase64Payload	Raw bytes of signed transaction.

content

txbase64Payload

Raw bytes of signed transaction.

Request example:

curl -X 'POST' \
  'https://ny.solana.dex.blxrbdn.com/api/v2/submit' \
  -header "Authorization: $AUTH_HEADER" \
  -d '{
 "transaction": {"content": "AjF+Br2CUIENJqV10y7bkgvn48ZlEKaTQeZNMhaIntatrtIHdm5rvpf9o8tZJc42JvThn+KvgL/M9U/t3bkuGAzTILvd64CRiM6Nth3MsOzVK198UK4WUg3sx27b4G56du9gNhpAGfPW+WUFjsM/pIvYuGWzERAtT+3tQ3vfI7IMAgAFD4ls26fgpAnCYufUzDrXMMpDjMYkf2Y2FHuxqKE+2+Ir2imDM3wYq7Q5tLj5w93u4Gi/Y/2BJjzAaJGatpcPFFeEwvsYrtYZ9UZjJlPvBgKfAqhkvzgphnGBuyDfHXFcMEoHX5xmEhJgK0YZx3BKh/s3nhpE7IFyBzqsKBqiTDd6jfzI9XsPznt1ZnWa9u9nVKg1KibD5ElrzSfbftYpluJAIIlGU8/d+nt+YMlmaCc2otsPg4VkklsRB3oh4DbXlwD0JuFuuM8DEZF1+YBRQ0SVXONw52WUDzwpQ5VF+0Wppt/RXFB3Bfkzm5U8Gk39vJzBht0vYt9IqVgEXip2UlkfJvXwRhxAEL1cyMpwZt2lhKbucXk0xnet9MJfvRVqLWrj7TJ6D4hJp3KUHZcFDzpujLjdOrzbFHCIfIK1TT82BpuIV/6rgYT7aH9jRhjANdrEOdwa6ztVmKDwAAAAAAEGp9UXGSxcUSGMyUw9SvF/WNruCJuh/UTj29mKAAAAAAbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACFDy1uAqR6+CTQmradxC1wyyjL+iSft+5XudJWwSdi7/85rSrGxhLIwAh21TiJzegUWHfntjwLcPUo6p/NoXq/BA0CAAE0AAAAAIB3jgYAAAAApQAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqQwEAQoACwEBDgwCAwQFBgcBAAgJDAszAAoAAAABAAAAwAslCgAAAAABAAAAAAAAAACXePYDAAAAAAAAAAAAAACPlIPudw25w///DAMBAAABCQ=="}
}'

wscat -c wss://ny.solana.dex.blxrbdn.com/ws --execute '{"jsonrpc": "2.0", "id": 1, "method": "PostSubmit", "params": {
  "transaction": {"content": "AjF+Br2CUIENJqV10y7bkgvn48ZlEKaTQeZNMhaIntatrtIHdm5rvpf9o8tZJc42JvThn+KvgL/M9U/t3bkuGAzTILvd64CRiM6Nth3MsOzVK198UK4WUg3sx27b4G56du9gNhpAGfPW+WUFjsM/pIvYuGWzERAtT+3tQ3vfI7IMAgAFD4ls26fgpAnCYufUzDrXMMpDjMYkf2Y2FHuxqKE+2+Ir2imDM3wYq7Q5tLj5w93u4Gi/Y/2BJjzAaJGatpcPFFeEwvsYrtYZ9UZjJlPvBgKfAqhkvzgphnGBuyDfHXFcMEoHX5xmEhJgK0YZx3BKh/s3nhpE7IFyBzqsKBqiTDd6jfzI9XsPznt1ZnWa9u9nVKg1KibD5ElrzSfbftYpluJAIIlGU8/d+nt+YMlmaCc2otsPg4VkklsRB3oh4DbXlwD0JuFuuM8DEZF1+YBRQ0SVXONw52WUDzwpQ5VF+0Wppt/RXFB3Bfkzm5U8Gk39vJzBht0vYt9IqVgEXip2UlkfJvXwRhxAEL1cyMpwZt2lhKbucXk0xnet9MJfvRVqLWrj7TJ6D4hJp3KUHZcFDzpujLjdOrzbFHCIfIK1TT82BpuIV/6rgYT7aH9jRhjANdrEOdwa6ztVmKDwAAAAAAEGp9UXGSxcUSGMyUw9SvF/WNruCJuh/UTj29mKAAAAAAbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACFDy1uAqR6+CTQmradxC1wyyjL+iSft+5XudJWwSdi7/85rSrGxhLIwAh21TiJzegUWHfntjwLcPUo6p/NoXq/BA0CAAE0AAAAAIB3jgYAAAAApQAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqQwEAQoACwEBDgwCAwQFBgcBAAgJDAszAAoAAAABAAAAwAslCgAAAAABAAAAAAAAAACXePYDAAAAAAAAAAAAAACPlIPudw25w///DAMBAAABCQ=="}
}}'

# submitting raw transactions
await api.post_submit("AjF+Br2CUIENJqV10y7bkgvn48ZlEKaTQeZNMhaIntatrtIHdm5rvpf9o8tZJc42JvThn+KvgL/M9U/t3bkuGAzTILvd64CRiM6Nth3MsOzVK198UK4WUg3sx27b4G56du9gNhpAGfPW+WUFjsM/pIvYuGWzERAtT+3tQ3vfI7IMAgAFD4ls26fgpAnCYufUzDrXMMpDjMYkf2Y2FHuxqKE+2+Ir2imDM3wYq7Q5tLj5w93u4Gi/Y/2BJjzAaJGatpcPFFeEwvsYrtYZ9UZjJlPvBgKfAqhkvzgphnGBuyDfHXFcMEoHX5xmEhJgK0YZx3BKh/s3nhpE7IFyBzqsKBqiTDd6jfzI9XsPznt1ZnWa9u9nVKg1KibD5ElrzSfbftYpluJAIIlGU8/d+nt+YMlmaCc2otsPg4VkklsRB3oh4DbXlwD0JuFuuM8DEZF1+YBRQ0SVXONw52WUDzwpQ5VF+0Wppt/RXFB3Bfkzm5U8Gk39vJzBht0vYt9IqVgEXip2UlkfJvXwRhxAEL1cyMpwZt2lhKbucXk0xnet9MJfvRVqLWrj7TJ6D4hJp3KUHZcFDzpujLjdOrzbFHCIfIK1TT82BpuIV/6rgYT7aH9jRhjANdrEOdwa6ztVmKDwAAAAAAEGp9UXGSxcUSGMyUw9SvF/WNruCJuh/UTj29mKAAAAAAbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACFDy1uAqR6+CTQmradxC1wyyjL+iSft+5XudJWwSdi7/85rSrGxhLIwAh21TiJzegUWHfntjwLcPUo6p/NoXq/BA0CAAE0AAAAAIB3jgYAAAAApQAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqQwEAQoACwEBDgwCAwQFBgcBAAgJDAszAAoAAAABAAAAwAslCgAAAAABAAAAAAAAAACXePYDAAAAAAAAAAAAAACPlIPudw25w///DAMBAAABCQ==")

# typically you'll want to use submit* methods to handle generation + sign + submit
# in a single step
await api.submit_order(
    owner_address=PUBLIC_KEY,
    payer_address=PUBLIC_KEY,
    market="SOLUSDC",
    side=proto.Side.S_ASK,
    types=[proto.OrderType.OT_LIMIT],
    amount=0.1,
    price=150_000,
    # optional, but much faster if known
    open_orders_address="5yyh4mzzycmjfR6arY736d1mB6vNSLiUaFWfepKLf8kZ",
    # optional, for identification
    client_order_id=0,
)

await api.submit_cancel_order(
    order_i_d="",
    side=proto.Side.S_ASK,
    market_address="SOLUSDC",
    owner_address=PUBLIC_KEY,
    open_orders_address="",  # optional
)

await api.submit_cancel_by_client_order_i_d(
    client_order_i_d=123,
    market_address="9wFFyRfZBsuAha4YcuxcXLKwMxJR43S7fPfQLusDBzvT",
    owner_address=PUBLIC_KEY,
    open_orders_address="",  # optional
)

await api.submit_settle(
    owner_address=PUBLIC_KEY,
    market="SOLUSDC",
    base_token_wallet=PUBLIC_KEY,
    quote_token_wallet=USDC_WALLET,
    open_orders_address="",  # optional
)

await provider.postSubmit({
    transaction: { content: encodedTxn, isCleanup: false },
    skipPreFlight: true,
})

Response:

Fields:

Parameter Type Description

Parameter	Type	Description
`signature`	string	Solana signature of the submitted transaction

signature

string

Solana signature of the submitted transaction

Example:

{
  "signature":"zPiAEU8RWfVP7HanC8V...5AErsYKiUQ7FbDiQecak3Fq"
}

You can look up this signature in a Solana Explorer like SolScan or Solana Explorer.

PreviousStream Bundle Tip NextSubmit Signed Transaction Batch

Last updated 24 days ago