Negotiation

Request a signed quote

Ask the seller what one call will cost before paying. Free and unauthenticated. The seller prices the estimate with the endpoint’s pricing model and returns a Quote signed by its Hedera account key, valid for about two minutes. Pass maxAmount to counter below list price: the seller accepts any offer at or above its floor (85% of list by default) and answers 409 with minimumAmount below it. Put quote.quoteId in the body (POST) or query string (GET) of the paid request and the 402 will carry exactly the agreed amount; a quote is consumed by the settlement, so it cannot be replayed.

POST

a2a

quote

curl --request POST \
  --url http://localhost:4402/a2a/quote \
  --header 'Content-Type: application/json' \
  --data '
{
  "endpointId": "infer",
  "estimate": {
    "inputTokens": 120,
    "maxOutputTokens": 256
  },
  "asset": "0.0.0",
  "maxAmount": "60000",
  "buyer": "uaid:aid:9GvnzC1pJ7yA4WQ2E;uid=agora-buyer;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.4009876"
}
'

{
  "quote": {
    "quoteId": "q_5f1c2a9b7d3e4c6a8b0f1e2d",
    "seller": "uaid:aid:2NEpo7TZRRrLZSi2U;uid=agora-demo-seller;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.5001234;domain=localhost:4402",
    "endpointId": "infer",
    "network": "hedera:testnet",
    "asset": "0.0.0",
    "amount": "60000",
    "expiresAt": 1789560120,
    "basis": {
      "pricing": {
        "kind": "per-token",
        "base": "50000",
        "inputPer1k": "20000",
        "outputPer1k": "60000"
      },
      "estimate": {
        "inputTokens": 120,
        "maxOutputTokens": 256
      },
      "listPrice": "67760",
      "countered": true,
      "buyer": "uaid:aid:9GvnzC1pJ7yA4WQ2E;uid=agora-buyer;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.4009876"
    },
    "signature": "3045022100a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9002200f1e2d3c4b5a69788796a5b4c3d2e1f00f1e2d3c4b5a69788796a5b4c3d2e1f0",
    "signerPublicKey": "302d300706052b8104000a032200027a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9"
  },
  "countered": true
}

Body

application/json

endpointId

string

required

id of the endpoint in the manifest, e.g. infer or hbar-rate

estimate

object

The work to price. Which fields matter depends on the pricing model kind.

Show child attributes

maxAmount

string

Your ceiling in atomic units. At or above list you pay list; between floor and list the seller accepts your counter; below floor you get 409.

Pattern: ^\d+$

asset

string

default:0.0.0

Asset to pay in. 0.0.0 is HBAR.

Pattern: ^\d+\.\d+\.\d+$

buyer

string

Your uaid, informational, echoed in basis.buyer

Response

Signed quote

quote

object

required

A priced, time-limited offer signed by the seller account key

Show child attributes

countered

boolean

required

true when the seller accepted your maxAmount below list price

⌘I

curl --request POST \
  --url http://localhost:4402/a2a/quote \
  --header 'Content-Type: application/json' \
  --data '
{
  "endpointId": "infer",
  "estimate": {
    "inputTokens": 120,
    "maxOutputTokens": 256
  },
  "asset": "0.0.0",
  "maxAmount": "60000",
  "buyer": "uaid:aid:9GvnzC1pJ7yA4WQ2E;uid=agora-buyer;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.4009876"
}
'

{
  "quote": {
    "quoteId": "q_5f1c2a9b7d3e4c6a8b0f1e2d",
    "seller": "uaid:aid:2NEpo7TZRRrLZSi2U;uid=agora-demo-seller;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.5001234;domain=localhost:4402",
    "endpointId": "infer",
    "network": "hedera:testnet",
    "asset": "0.0.0",
    "amount": "60000",
    "expiresAt": 1789560120,
    "basis": {
      "pricing": {
        "kind": "per-token",
        "base": "50000",
        "inputPer1k": "20000",
        "outputPer1k": "60000"
      },
      "estimate": {
        "inputTokens": 120,
        "maxOutputTokens": 256
      },
      "listPrice": "67760",
      "countered": true,
      "buyer": "uaid:aid:9GvnzC1pJ7yA4WQ2E;uid=agora-buyer;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.4009876"
    },
    "signature": "3045022100a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9002200f1e2d3c4b5a69788796a5b4c3d2e1f00f1e2d3c4b5a69788796a5b4c3d2e1f0",
    "signerPublicKey": "302d300706052b8104000a032200027a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9"
  },
  "countered": true
}

Overview

Discovery

Negotiation

Paid services

Trust

Receipts

SDK reference

Request a signed quote

Body

Response