7mtmajty.nx.link

{
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "description": "Request object containing an array of encoded blockchain transactions to execute. All transactions must use the same from address and chainId. For contract calls, use /v1/contracts/write. For native token transfers, use /v1/wallets/send.",
          "examples": [
            {
              "chainId": 137,
              "from": "0x1234567890123456789012345678901234567890",
              "transactions": [
                {
                  "data": "0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b8d43c67b8c8b3e9c6000000000000000000000000000000000000000000000000016345785d8a0000",
                  "to": "0xA0b86a33E6411E3036C1C4c7E815D0a82e3F5fD6",
                  "value": "0"
                }
              ]
            },
            {
              "chainId": 84532,
              "from": "0x1234567890123456789012345678901234567890",
              "transactions": [
                {
                  "data": "0x095ea7b3000000000000000000000000742d35cc6634c0532925a3b8d43c67b8c8b3e9c60000000000000000000000000000000000000000000000000de0b6b3a7640000",
                  "to": "0xe352Cf5f74e3ACfd2d59EcCee6373d2Aa996086e",
                  "value": "0"
                },
                {
                  "data": "0x",
                  "to": "0x1234567890123456789012345678901234567890",
                  "value": "50000000000000000"
                }
              ]
            }
          ],
          "properties": {
            "chainId": {
              "description": "The blockchain network identifier where all transactions will be executed.",
              "examples": [
                1,
                8453,
                137,
                56,
                43114,
                42161,
                10
              ],
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            "from": {
              "description": "The wallet address or ENS name that will send the transaction. If omitted, the project wallet will be used if available.",
              "type": "string"
            },
            "transactions": {
              "description": "Array of encoded blockchain transactions to execute. All transactions will use the same from address and chainId.",
              "items": {
                "description": "A blockchain transaction with pre-encoded data payload. For contract calls, use /v1/contracts/write. For native token transfers, use /v1/wallets/send.",
                "properties": {
                  "data": {
                    "description": "Transaction data in hexadecimal format for contract interactions or custom payloads.",
                    "type": "string"
                  },
                  "to": {
                    "description": "The target address or ENS name for the transaction.",
                    "type": "string"
                  },
                  "value": {
                    "description": "Amount of native token to send in wei (smallest unit). Use '0' or omit for non-value transactions.",
                    "type": "string"
                  }
                },
                "required": [
                  "data",
                  "to"
                ],
                "title": "Transaction",
                "type": "object"
              },
              "minItems": 1,
              "type": "array"
            }
          },
          "required": [
            "chainId",
            "transactions"
          ],
          "title": "Transaction Request",
          "type": "object"
        }
      }
    }
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "result": {
                "properties": {
                  "transactionIds": {
                    "description": "Array of unique identifiers for the submitted transactions. Use these to track transaction status.",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "transactionIds"
                ],
                "type": "object"
              }
            },
            "required": [
              "result"
            ],
            "type": "object"
          }
        }
      },
      "description": "Encoded transactions submitted successfully. Returns the transaction IDs for tracking and monitoring."
    },
    "400": {
      "description": "Invalid request parameters. This occurs when transaction data is malformed, insufficient balance, or invalid encoded data."
    },
    "401": {
      "description": "Authentication required. For backend usage, include `x-secret-key` header. For frontend usage, include `x-client-id` + `Authorization: Bearer <jwt>` headers."
    },
    "402": {
      "content": {
        "application/json": {
          "schema": {
            "description": "Payment required response when user has insufficient funds. Contains a quote for completing the purchase.",
            "properties": {
              "result": {
                "properties": {
                  "id": {
                    "description": "Payment ID",
                    "type": "string"
                  },
                  "link": {
                    "description": "Link to purchase the product",
                    "type": "string"
                  },
                  "message": {
                    "description": "Message to display to the user",
                    "type": "string"
                  },
                  "quote": {
                    "description": "Bridge quote for completing the payment",
                    "properties": {
                      "blockNumber": {
                        "description": "Block number when quote was generated",
                        "type": "string"
                      },
                      "destinationAmount": {
                        "description": "Destination amount in wei",
                        "type": "string"
                      },
                      "estimatedExecutionTimeMs": {
                        "description": "Estimated execution time in milliseconds",
                        "type": "number"
                      },
                      "intent": {
                        "description": "Quote intent details",
                        "properties": {
                          "amount": {
                            "description": "The amount in wei",
                            "type": "string"
                          },
                          "destinationChainId": {
                            "description": "Destination chain ID",
                            "exclusiveMinimum": 0,
                            "type": "integer"
                          },
                          "destinationTokenAddress": {
                            "description": "Destination token address",
                            "type": "string"
                          },
                          "originChainId": {
                            "description": "Origin chain ID",
                            "exclusiveMinimum": 0,
                            "type": "integer"
                          },
                          "originTokenAddress": {
                            "description": "Origin token address",
                            "type": "string"
                          },
                          "receiver": {
                            "description": "Receiver address",
                            "type": "string"
                          },
                          "sender": {
                            "description": "Sender address",
                            "type": "string"
                          }
                        },
                        "required": [
                          "amount",
                          "destinationChainId",
                          "destinationTokenAddress",
                          "originChainId",
                          "originTokenAddress",
                          "receiver",
                          "sender"
                        ],
                        "type": "object"
                      },
                      "originAmount": {
                        "description": "Origin amount in wei",
                        "type": "string"
                      },
                      "steps": {
                        "description": "Array of steps to complete the bridge operation",
                        "items": {
                          "properties": {
                            "destinationAmount": {
                              "description": "Destination amount in wei",
                              "type": "string"
                            },
                            "destinationToken": {
                              "description": "Destination token information",
                              "properties": {
                                "address": {
                                  "description": "A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).",
                                  "type": "string"
                                },
                                "chainId": {
                                  "description": "The blockchain network identifier. Common values include: 1 (Ethereum), 8453 (Base), 137 (Polygon), 56 (BSC), 43114 (Avalanche), 42161 (Arbitrum), 10 (Optimism).",
                                  "examples": [
                                    1,
                                    8453,
                                    137,
                                    56,
                                    43114,
                                    42161,
                                    10
                                  ],
                                  "exclusiveMinimum": 0,
                                  "type": "integer"
                                },
                                "decimals": {
                                  "type": "number"
                                },
                                "iconUri": {
                                  "type": "string"
                                },
                                "prices": {
                                  "additionalProperties": {
                                    "type": "number"
                                  },
                                  "description": "Token price in different FIAT currencies.",
                                  "examples": [
                                    {
                                      "EUR": 0.84,
                                      "USD": 1
                                    }
                                  ],
                                  "type": "object"
                                },
                                "symbol": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "chainId",
                                "address",
                                "decimals",
                                "symbol",
                                "prices"
                              ],
                              "type": "object"
                            },
                            "estimatedExecutionTimeMs": {
                              "description": "Estimated execution time in milliseconds",
                              "type": "number"
                            },
                            "originAmount": {
                              "description": "Origin amount in wei",
                              "type": "string"
                            },
                            "originToken": {
                              "description": "Origin token information",
                              "properties": {
                                "address": {
                                  "description": "A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).",
                                  "type": "string"
                                },
                                "chainId": {
                                  "description": "The blockchain network identifier. Common values include: 1 (Ethereum), 8453 (Base), 137 (Polygon), 56 (BSC), 43114 (Avalanche), 42161 (Arbitrum), 10 (Optimism).",
                                  "examples": [
                                    1,
                                    8453,
                                    137,
                                    56,
                                    43114,
                                    42161,
                                    10
                                  ],
                                  "exclusiveMinimum": 0,
                                  "type": "integer"
                                },
                                "decimals": {
                                  "type": "number"
                                },
                                "iconUri": {
                                  "type": "string"
                                },
                                "prices": {
                                  "additionalProperties": {
                                    "type": "number"
                                  },
                                  "description": "Token price in different FIAT currencies.",
                                  "examples": [
                                    {
                                      "EUR": 0.84,
                                      "USD": 1
                                    }
                                  ],
                                  "type": "object"
                                },
                                "symbol": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "chainId",
                                "address",
                                "decimals",
                                "symbol",
                                "prices"
                              ],
                              "type": "object"
                            },
                            "transactions": {
                              "description": "Array of transactions for this step",
                              "items": {
                                "properties": {
                                  "action": {
                                    "description": "Type of action this transaction performs",
                                    "enum": [
                                      "approval",
                                      "transfer",
                                      "buy",
                                      "sell",
                                      "fee"
                                    ],
                                    "type": "string"
                                  },
                                  "chainId": {
                                    "description": "Blockchain network identifier",
                                    "exclusiveMinimum": 0,
                                    "type": "integer"
                                  },
                                  "data": {
                                    "description": "Transaction data payload",
                                    "type": "string"
                                  },
                                  "from": {
                                    "description": "Transaction sender address",
                                    "type": "string"
                                  },
                                  "spender": {
                                    "description": "Spender address for approval transactions",
                                    "type": "string"
                                  },
                                  "to": {
                                    "description": "Transaction recipient address",
                                    "type": "string"
                                  },
                                  "value": {
                                    "description": "Transaction value in wei",
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "chainId",
                                  "to",
                                  "data",
                                  "action"
                                ],
                                "type": "object"
                              },
                              "type": "array"
                            }
                          },
                          "required": [
                            "originToken",
                            "destinationToken",
                            "transactions",
                            "originAmount",
                            "destinationAmount"
                          ],
                          "type": "object"
                        },
                        "type": "array"
                      },
                      "timestamp": {
                        "description": "Quote timestamp",
                        "type": "number"
                      }
                    },
                    "required": [
                      "destinationAmount",
                      "intent",
                      "originAmount",
                      "steps",
                      "timestamp"
                    ],
                    "type": "object"
                  }
                },
                "required": [
                  "message",
                  "link"
                ],
                "type": "object"
              }
            },
            "required": [
              "result"
            ],
            "title": "Payment Required Response",
            "type": "object"
          }
        }
      },
      "description": "Payment required. Insufficient wallet balance to complete the purchase."
    },
    "500": {
      "description": "Internal server error. This may occur due to blockchain connectivity issues, gas estimation failures, or unexpected server errors."
    }
  }
}