curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-opportunity-zone \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"census_tract": "48201532800"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-opportunity-zone", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"census_tract": "48201532800"
}),
});
const result = await agent.tool('lookup/place-opportunity-zone', {
census_tract: '48201532800'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_opportunity_zone",
"result": {
"designated": true,
"designation_round": "2018",
"census_tract": "48201532800",
"state": "TX",
"state_name": "Texas",
"county_fips": "48201",
"rural": false
},
"evidence": {
"source": "US Department of the Treasury",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-01-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Places & hazards
Opportunity Zone
Check the 2018 Qualified Opportunity Zone designation of a US tract or point.
POST
/
v1
/
tools
/
lookup
/
place-opportunity-zone
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-opportunity-zone \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"census_tract": "48201532800"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-opportunity-zone", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"census_tract": "48201532800"
}),
});
const result = await agent.tool('lookup/place-opportunity-zone', {
census_tract: '48201532800'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_opportunity_zone",
"result": {
"designated": true,
"designation_round": "2018",
"census_tract": "48201532800",
"state": "TX",
"state_name": "Texas",
"county_fips": "48201",
"rural": false
},
"evidence": {
"source": "US Department of the Treasury",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-01-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Says whether a US census tract or point is in a Qualified Opportunity Zone designated by the US Department of the Treasury in 2018, as published by the US Department of Housing and Urban Development, with tract, state, county and rural flag. Tracts are from 2010. The 2027 designation round is not included.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
Eleven-digit 2010 census tract GEOID.
number
Latitude in decimal degrees. From -90 to 90.
number
Longitude in decimal degrees. From -180 to 180.
Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
place_opportunity_zoneobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US Department of the Treasury.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
boolean
Designated.
string
Designation round.
string | null
Census tract.
null when the source gives no value.string | null
State.
null when the source gives no value.string | null
State name.
null when the source gives no value.string | null
County fips.
null when the source gives no value.boolean | null
Rural.
null when the source gives no value.integer
Overlapping tracts.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-opportunity-zone \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"census_tract": "48201532800"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-opportunity-zone", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"census_tract": "48201532800"
}),
});
const result = await agent.tool('lookup/place-opportunity-zone', {
census_tract: '48201532800'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_opportunity_zone",
"result": {
"designated": true,
"designation_round": "2018",
"census_tract": "48201532800",
"state": "TX",
"state_name": "Texas",
"county_fips": "48201",
"rural": false
},
"evidence": {
"source": "US Department of the Treasury",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-01-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
- Give exactly one 2010 census tract GEOID or coordinate pair. A point answers for its 2010 tract; 2020 census tract ids can differ.
- A point outside every designated zone, including outside the United States, returns designated: false. Place Resolve gives coordinates for an address.
- Rural means identified as a rural census tract according to the US Treasury. This is not tax advice.
- HUD and the dataset and metadata authors assume no responsibility for the use or misuse of the dataset.
- Results return inline. The finished job stays available at
/v1/requests/{request_id}