Crypto Analysis & Developer Tools · x402 V2

Bitcoin Fee Calculate

Use this service when you need this capability: calculate fee and fee rate from supplied input values and raw transaction outputs.

Price and endpoint

LivePOSTBase USDC

0.01 USDC per call

x402 V2 exact payment on Base mainnet (eip155:8453) using USDC. The HTTP 402 challenge confirms the exact requirements before an authorized payment.

POST https://signalharness.ai/api/agent/services/bitcoin_fee_calculate/invoke

Purpose

Calculate fee and fee rate from supplied input values and raw transaction outputs.

Caller-supplied data is processed deterministically. These tools do not supply live market feeds, query blockchain RPC, host AI models, or verify that supplied history is complete. Payment remains Base USDC for every chain category.

Inputs

Request fields and validation limits
FieldTypeRequiredLimits
bitcoin_fee_requeststringRequiredMinimum length 2; Maximum length 65536

Example request body

{
  "bitcoin_fee_request": "{\"raw_transaction\":\"0x01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff00ffffffff01e803000000000000015100000000\",\"input_values_sats\":[\"2000\"]}"
}
View complete input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "additionalProperties": false,
  "minProperties": 1,
  "maxProperties": 1,
  "required": [
    "bitcoin_fee_request"
  ],
  "properties": {
    "bitcoin_fee_request": {
      "type": "string",
      "minLength": 2,
      "maxLength": 65536
    }
  }
}

Realistic output shape

Illustrative output from the canonical adapter fixture and schema. It is not a completed paid execution or a current live observation.

{
  "service_id": "bitcoin_fee_calculate",
  "evidence_scope": "caller_supplied_data",
  "bitcoin_fee_calculation": "{\"fee_rate_sat_per_vbyte\":\"16.39344262\",\"fee_sats\":\"1000\",\"input_total_sats\":\"2000\",\"output_total_sats\":\"1000\",\"virtual_size\":61}",
  "warnings": [
    "Input values must be complete and are trusted as supplied."
  ]
}
View complete output schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "additionalProperties": false,
  "minProperties": 4,
  "maxProperties": 4,
  "required": [
    "service_id",
    "evidence_scope",
    "bitcoin_fee_calculation",
    "warnings"
  ],
  "properties": {
    "service_id": {
      "type": "string",
      "const": "bitcoin_fee_calculate",
      "minLength": 21,
      "maxLength": 21
    },
    "evidence_scope": {
      "type": "string",
      "const": "caller_supplied_data",
      "minLength": 20,
      "maxLength": 20
    },
    "bitcoin_fee_calculation": {
      "type": "string",
      "minLength": 1,
      "maxLength": 65536
    },
    "warnings": {
      "type": "array",
      "minItems": 1,
      "maxItems": 8,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 512
      }
    }
  }
}

Execution limits

  • MaxInputBytes: 131072
  • MaxOutputBytes: 131072
  • MaxConcurrentExecutions: 2
  • MaxArtifacts: 0
  • MaxArtifactBytes: 0
  • RateLimitPerMinute: 30
  • MaxNodes: 10000

Timeout: 5000 ms. Full schemas are in OpenAPI.

Copyable unpaid request

This schema-valid request returns the canonical HTTP 402 challenge without executing the service. A payment-capable client validates the challenge, signs only with prior authority and budget, and retries the identical body.

curl -i -X POST https://signalharness.ai/api/agent/services/bitcoin_fee_calculate/invoke \
  -H "Content-Type: application/json" \
  --data '{"bitcoin_fee_request":"{\"raw_transaction\":\"0x01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff00ffffffff01e803000000000000015100000000\",\"input_values_sats\":[\"2000\"]}"}'

Continue with the paid-call walkthrough →