Gate · Acesso pago a APIs

Um paywall que os agentes dos seus clientes conseguem pagar.

Coloque preço em qualquer endpoint. Um agente chamador recebe um 402 com o preço, paga dentro do próprio mandato e passa. Os dois lados guardam o registro.

Começar a construir Fale com a gente

As chaves de teste são gratuitas.

GET /v1/datasets/retaildemochamador agt_r3sc · mnd_r3sc

0 msRequisição

execução do agente "buscar o dataset de varejo" · GET /v1/datasets/retail

sem pagamento

12 ms402 Payment Required

0.02 USDC

{ "x402Version": 1,
  "error": "X-PAYMENT header is required",
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "maxAmountRequired": "20000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x7a3f2c9d5e1b8a4f6c0d3e2b9a7f5c1d8e4b91fe",
    "resource": "https://api.orbital.example/v1/datasets/retail",
    "maxTimeoutSeconds": 60
  }]
}

15 msMandato

mnd_r3sc · teto por chamada US$ 0,10 · 0,02 dentro

dentro do teto

1.810 sPay

GET /v1/datasets/retail · X-PAYMENT

+0.02 USDCliquidado

1.894 s200 OK

X-PAYMENT-RESPONSE · rec_82d0 · assinado dos dois lados

recibo assinado

requisição · 0 ms

402 + preço · 12 ms

mandato · 3 ms

pagamento · liquida em 1,795 s

200 + registro · 84 ms

Execução em sandbox · dados de demonstração

Para quem é

Provedores de API e de dados cujos chamadores são agentes.

Datasets, enriquecimento, preços e qualquer endpoint que um agente chama sozinho.

/v1/datasets/retaildataset

/v1/enrich/companyenriquecimento

/v1/prices/fxpreços

O problema

Agentes chamam sua API e não há como cobrá-los por chamada.

Então você dá a chamada de graça ou recusa o agente.

GET /v1/datasets/retailgrátis

GET /v1/datasets/retailrecusado

O resultado

Toda chamada paga liquida antes da resposta.

O chamador paga dentro do próprio mandato. Os dois lados guardam o mesmo recibo assinado.

402 · 0.02 USDCcom preço

pago sob o mandato deleliquidado

200 OKrecibo assinado

Chamadas pagas

Toda chamada que pagou, e as que não pagaram.

Os dois livros guardam o mesmo recibo para cada chamada paga. Uma chamada recusada ou com falha também é registrada, sem cobrança.

O chamador guarda

Endpoint

Preço pago

Mandato que autorizou

Recibo assinado

Seu endpoint guarda

Chamador

Valor recebido

Resultado retornado

Recibo assinado

Seu endpoint · chamadas hoje demoUSDC

POST /v1/enrich/companyAgente de preços · rec_51e20.05em andamentoliquidado

GET /v1/datasets/retailAgente de pesquisa · rec_82d00.02liquidado

GET /v1/reports/fullAgente de pesquisa · acima do teto por chamada do chamador, nada cobrado0.40recusada

GET /v1/prices/fxAgente de preços · a cotação expirou, o chamador pediu de novo0.01expirada

GET /v1/datasets/retailAgente de sourcing · o pagamento não liquidou, nenhum dado retornado0.02falhou

Execução em sandbox · dados de demonstração

Coloque preço em um endpoint.

Seu endpoint responde chamadas não pagas com um 402 e o preço. Um agente chamador paga dentro do próprio mandato e tenta de novo.

Começar a construir Ver o caso de uso x402

agt_r3sc · chamada pagademo

$ agent run "busque o dataset de varejo"→ GET /v1/datasets/retail← 402 Payment Required · 0.02 USDC# mandato · teto US$ 0,10 por chamada · ok→ GET /v1/datasets/retail · X-PAYMENT# liquidado← 200 OK# rec_82d0 · recibo assinado dos dois lados

Execução em sandbox · dados de demonstração