{"openapi":"3.1.0","info":{"title":"Base Agent Evidence & Route API","version":"0.3.0","x-x402-merchant-release-id":"git-cdb2d003d3eb6f98f9bcf714723581628f057505","contact":{"url":"https://mikedotexe.com"},"termsOfService":"https://merchant-base.mikedotexe.com/terms","description":"Paid, machine-readable chain evidence and an activity index whose availability is reported in every response.","x-guidance":"Use POST /v1/evidence/account for an EVM address, POST /v1/evidence/transaction for an EVM transaction hash, or POST /v1/routes/usdc/quote for a dry Base-USDC-to-NEAR-USDC route quote. An unpaid request returns HTTP 402 with canonical x402 v2 requirements."},"servers":[{"url":"https://merchant-base.mikedotexe.com"}],"paths":{"/v1/evidence/account":{"post":{"summary":"Inspect final account evidence","operationId":"inspect_final_account_evidence","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"example":{"address":"0x0000000000000000000000000000000000000000"}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["network","kind","observedFinality","observedAt","block","source","account"],"properties":{"network":{"type":"string","const":"eip155:8453"},"kind":{"type":"string","const":"account"},"observedFinality":{"type":"string","enum":["final","finalized","nonterminal"]},"observedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T"},"block":{"type":"object","additionalProperties":false,"required":["height","hash"],"properties":{"height":{"type":"string","pattern":"^[0-9]+$"},"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}},"source":{"type":"object","additionalProperties":false,"required":["type","status"],"properties":{"type":{"type":"string","const":"evm-jsonrpc"},"status":{"type":"string","enum":["final","finalized","nonterminal"]}}},"explorerUrl":{"type":"string","pattern":"^https://"},"account":{"type":"object","additionalProperties":false,"required":["address","balanceWei","isContract","asset"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"balanceWei":{"type":"string","pattern":"^[0-9]+$","description":"Native ETH balance in wei at the finalized block; it is not a USDC balance."},"isContract":{"type":"boolean"},"asset":{"type":"string","const":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Configured USDC payment asset; it does not denominate balanceWei."}}}},"example":{"network":"eip155:8453","kind":"account","observedFinality":"finalized","observedAt":"2026-07-27T20:00:00.000Z","block":{"height":"34567890","hash":"0x1111111111111111111111111111111111111111111111111111111111111111"},"account":{"address":"0x0000000000000000000000000000000000000000","balanceWei":"0","isContract":false,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"source":{"type":"evm-jsonrpc","status":"finalized"}}}}}},"402":{"description":"Payment Required"}}}},"/v1/evidence/transaction":{"post":{"summary":"Inspect transaction evidence","operationId":"inspect_transaction_evidence","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["transactionHash"],"properties":{"transactionHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}},"example":{"transactionHash":"0x0000000000000000000000000000000000000000000000000000000000000000"}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["network","kind","observedFinality","observedAt","block","source","transaction"],"properties":{"network":{"type":"string","const":"eip155:8453"},"kind":{"type":"string","const":"transaction"},"observedFinality":{"type":"string","enum":["final","finalized","nonterminal"]},"observedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T"},"block":{"type":"object","additionalProperties":false,"required":["height","hash"],"properties":{"height":{"type":"string","pattern":"^[0-9]+$"},"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}},"source":{"type":"object","additionalProperties":false,"required":["type","status"],"properties":{"type":{"type":"string","const":"evm-jsonrpc"},"status":{"type":"string","enum":["final","finalized","nonterminal"]}}},"explorerUrl":{"type":"string","pattern":"^https://"},"transaction":{"type":"object","additionalProperties":false,"required":["hash","from","confirmationDepth","status"],"properties":{"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"to":{"type":["string","null"],"description":"Transaction-envelope recipient. ERC-3009 USDC transfers normally target the token contract, not the payTo address."},"blockNumber":{"type":"string","pattern":"^[0-9]+$"},"confirmationDepth":{"type":"string","pattern":"^[0-9]+$"},"success":{"type":"boolean"},"status":{"type":"string","enum":["succeeded","failed","pending"]},"gasUsed":{"type":"string","pattern":"^[0-9]+$"}}}},"example":{"network":"eip155:8453","kind":"transaction","observedFinality":"finalized","observedAt":"2026-07-27T20:00:00.000Z","block":{"height":"34567890","hash":"0x1111111111111111111111111111111111111111111111111111111111111111"},"transaction":{"hash":"0x2222222222222222222222222222222222222222222222222222222222222222","from":"0x0000000000000000000000000000000000000000","to":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","blockNumber":"34567889","confirmationDepth":"1","success":true,"status":"succeeded","gasUsed":"65000"},"explorerUrl":"https://basescan.org/tx/example","source":{"type":"evm-jsonrpc","status":"finalized"}}}}}},"402":{"description":"Payment Required"}}}},"/v1/activity/search":{"post":{"summary":"Search the bounded final activity index","operationId":"search_the_bounded_final_activity_index","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string"},"account":{"type":"string"},"contract":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string"}}},"example":{"query":"transfer","limit":25}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["items","nextCursor","index"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","kind"],"properties":{"id":{"type":"string"},"network":{"type":"string"},"kind":{"type":"string"},"account":{"type":"string"},"contract":{"type":"string"},"entity":{"type":"string"},"block":{},"timestamp":{"type":"string"},"summary":{},"indexedAt":{"type":"string"}}}},"nextCursor":{"type":["string","null"]},"index":{"type":"object","additionalProperties":false,"required":["status","recordCount","indexedAt"],"properties":{"status":{"type":"string","enum":["ready","not_yet_indexed"]},"recordCount":{"type":"integer","minimum":0},"indexedAt":{"type":["string","null"]}}}},"example":{"items":[],"nextCursor":null,"index":{"status":"not_yet_indexed","recordCount":0,"indexedAt":null}}}}}},"402":{"description":"Payment Required"}}}},"/v1/routes/usdc/quote":{"post":{"summary":"Quote Base USDC to NEAR USDC","operationId":"quote_base_usdc_to_near_usdc","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["amountAtomic","recipient","refundTo"],"properties":{"amountAtomic":{"type":"string","pattern":"^[1-9][0-9]{0,15}$","description":"Base USDC amount in 6-decimal atomic units"},"recipient":{"type":"string","minLength":2,"maxLength":64,"pattern":"^(?=.{2,64}$)[a-z0-9]+(?:[._-][a-z0-9]+)*$","description":"Destination NEAR account id"},"refundTo":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Base address for a failed-route refund"},"slippageBasisPoints":{"type":"integer","minimum":0,"maximum":1000,"default":100}}},"example":{"amountAtomic":"1000000","recipient":"mike.near","refundTo":"0xcA202E03f11Aa076c57EAE666Da3f933dCc71CC9","slippageBasisPoints":100}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["kind","mode","fundsMoved","source","destination","amountInAtomic","amountOutAtomic","minAmountOutAtomic","recipient","refundTo","slippageBasisPoints","estimatedSettlementSeconds","providerFees","quote","provider"],"properties":{"kind":{"type":"string","const":"usdc_route_quote"},"mode":{"type":"string","const":"quote_only"},"fundsMoved":{"type":"boolean","const":false},"source":{"type":"object","additionalProperties":false,"required":["network","asset","assetId","symbol","decimals"],"properties":{"network":{"type":"string"},"asset":{"type":"string"},"assetId":{"type":"string"},"symbol":{"type":"string","const":"USDC"},"decimals":{"type":"integer","const":6}}},"destination":{"type":"object","additionalProperties":false,"required":["network","asset","assetId","symbol","decimals"],"properties":{"network":{"type":"string"},"asset":{"type":"string"},"assetId":{"type":"string"},"symbol":{"type":"string","const":"USDC"},"decimals":{"type":"integer","const":6}}},"amountInAtomic":{"type":"string","pattern":"^[0-9]+$"},"amountOutAtomic":{"type":"string","pattern":"^[0-9]+$"},"minAmountOutAtomic":{"type":"string","pattern":"^[0-9]+$"},"recipient":{"type":"string"},"refundTo":{"type":"string"},"slippageBasisPoints":{"type":"integer"},"estimatedSettlementSeconds":{"type":"integer","minimum":0},"providerFees":{"type":"object","additionalProperties":false,"required":["refundFeeAtomic","withdrawFeeAtomic"],"properties":{"refundFeeAtomic":{"type":"string","pattern":"^[0-9]+$"},"withdrawFeeAtomic":{"type":"string","pattern":"^[0-9]+$"}}},"quote":{"type":"object","additionalProperties":false,"required":["quotedAt","expiresAt","correlationId","signature"],"properties":{"quotedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T"},"expiresAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T"},"correlationId":{"type":"string"},"signature":{"type":"string","description":"Provider-supplied provenance preserved verbatim; this service does not claim cryptographic verification"}}},"provider":{"type":"object","additionalProperties":false,"required":["name","endpoint","status"],"properties":{"name":{"type":"string","const":"NEAR Intents 1Click"},"endpoint":{"type":"string","pattern":"^https://"},"status":{"type":"string","const":"live"}}}},"example":{"kind":"usdc_route_quote","mode":"quote_only","fundsMoved":false,"source":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetId":"nep141:base-0x833589fcd6edb6e08f4c7c32d4f71b54bda02913.omft.near","symbol":"USDC","decimals":6},"destination":{"network":"near:mainnet","asset":"17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1","assetId":"nep141:17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1","symbol":"USDC","decimals":6},"amountInAtomic":"1000000","amountOutAtomic":"998898","minAmountOutAtomic":"988909","recipient":"mike.near","refundTo":"0xcA202E03f11Aa076c57EAE666Da3f933dCc71CC9","slippageBasisPoints":100,"estimatedSettlementSeconds":35,"providerFees":{"refundFeeAtomic":"2400","withdrawFeeAtomic":"0"},"quote":{"quotedAt":"2026-07-27T20:00:00.250Z","expiresAt":"2026-07-27T20:05:00.000Z","correlationId":"quote-123","signature":"provider-signature"},"provider":{"name":"NEAR Intents 1Click","endpoint":"https://1click.chaindefuser.com/v0/quote","status":"live"}}}}}},"402":{"description":"Payment Required"}}}},"/v1/entities/{identifier}":{"get":{"summary":"Inspect an indexed entity","operationId":"inspect_an_indexed_entity","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["identifier","status","records","index"],"properties":{"identifier":{"type":"string","minLength":1,"maxLength":256},"status":{"type":"string","enum":["indexed","not_yet_indexed"]},"records":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","kind"],"properties":{"id":{"type":"string"},"network":{"type":"string"},"kind":{"type":"string"},"account":{"type":"string"},"contract":{"type":"string"},"entity":{"type":"string"},"block":{},"timestamp":{"type":"string"},"summary":{},"indexedAt":{"type":"string"}}}},"index":{"type":"object","additionalProperties":false,"required":["status","recordCount","indexedAt"],"properties":{"status":{"type":"string","enum":["ready","not_yet_indexed"]},"recordCount":{"type":"integer","minimum":0},"indexedAt":{"type":["string","null"]}}}},"example":{"identifier":"0x0000000000000000000000000000000000000000","status":"not_yet_indexed","records":[],"index":{"status":"not_yet_indexed","recordCount":0,"indexedAt":null}}}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256},"example":"0x0000000000000000000000000000000000000000"}]}}}}