Post /v2/tx/submit

Submit a signed base64 encoded transaction to be broadcast to the specified network. On successful submission, the status of the transaction and any subsequent IBC or Axelar transfers can be queried through the /status endpoint.

POST /v2/tx/submit

cURL

cURL

curl --request POST \
  --url https://api.skip.build/v2/tx/submit \
  --header 'Content-Type: application/json' \
  --data '
{
  "tx": "<string>",
  "chain_id": "<string>"
}
'

import requests

url = "https://api.skip.build/v2/tx/submit"

payload = {
    "tx": "<string>",
    "chain_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({tx: '<string>', chain_id: '<string>'})
};

fetch('https://api.skip.build/v2/tx/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.skip.build/v2/tx/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tx' => '<string>',
    'chain_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.skip.build/v2/tx/submit"

	payload := strings.NewReader("{\n  \"tx\": \"<string>\",\n  \"chain_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.skip.build/v2/tx/submit")
  .header("Content-Type", "application/json")
  .body("{\n  \"tx\": \"<string>\",\n  \"chain_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.skip.build/v2/tx/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tx\": \"<string>\",\n  \"chain_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

200

{
  "tx_hash": "F30790E79987F18F3A4DA8C7A9BA9FD837043EF59D8236CA85180E1078BC607F",
  "explorer_link": "https://www.mintscan.io/osmosis/tx/F30790E79987F18F3A4DA8C7A9BA9FD837043EF59D8236CA85180E1078BC607F"
}

{
  "code": 3,
  "message": "tx must be base64 encoded",
  "details": []
}

{
  "code": 5,
  "message": "chain ID not supported",
  "details": []
}

{
  "code": 2,
  "message": "internal server error",
  "details": []
}

Body

application/json

tx · string

Signed base64 encoded transaction

chain_id · string

Chain ID of the transaction

Response

200

application/json

The hash of the transaction.

tx_hash · string

Hash of the transaction

explorer_link · string

Link to the transaction on the relevant block explorer