Agent Newsstand Samples API
[meta] Free sample twins for every priced route — inspect response shapes before paying.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/agentnewsstand-com:agentnewsstand-com-samples-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Agent Newsstand Samples API
description: Market data and web intelligence for autonomous agents. Trading context for tokenized assets (candles, earnings, filings, macro, calendar), plus search, reader, unlock, and URL safety. 15 modules across 5 categories. Per-call USDC micropayments on Base via x402. Free sample twins at /v1/sample/* — inspect before paying. Machine-readable manifest at /.well-known/x402.
contact:
name: Agent Newsstand
email: admin@agentnewsstand.com
version: 0.2.0
tags:
- name: Samples
description: '[meta] Free sample twins for every priced route — inspect response shapes before paying.'
paths:
/v1/sample/search:
get:
tags:
- Samples
summary: Sample Search
operationId: sample_search_v1_sample_search_get
parameters:
- name: q
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: example query
title: Q
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Search V1 Sample Search Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/local:
get:
tags:
- Samples
summary: Sample Local
operationId: sample_local_v1_sample_local_get
parameters:
- name: q
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: coffee shop
title: Q
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Local V1 Sample Local Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/place:
get:
tags:
- Samples
summary: Sample Place
operationId: sample_place_v1_sample_place_get
parameters:
- name: q
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: example business
title: Q
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Place V1 Sample Place Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/read:
get:
tags:
- Samples
summary: Sample Read
operationId: sample_read_v1_sample_read_get
parameters:
- name: url
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: https://example.com
title: Url
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Read V1 Sample Read Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/unlock:
get:
tags:
- Samples
summary: Sample Unlock
operationId: sample_unlock_v1_sample_unlock_get
parameters:
- name: url
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: https://example.com
title: Url
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Unlock V1 Sample Unlock Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/screenshot:
get:
tags:
- Samples
summary: Sample Screenshot
operationId: sample_screenshot_v1_sample_screenshot_get
parameters:
- name: url
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: https://example.com
title: Url
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Screenshot V1 Sample Screenshot Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/url/safety:
get:
tags:
- Samples
summary: Sample Url Safety
operationId: sample_url_safety_v1_sample_url_safety_get
parameters:
- name: url
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: https://example.com
title: Url
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Url Safety V1 Sample Url Safety Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/universe:
get:
tags:
- Samples
summary: Sample Universe
operationId: sample_universe_v1_sample_universe_get
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Universe V1 Sample Universe Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/candles:
get:
tags:
- Samples
summary: Sample Candles
operationId: sample_candles_v1_sample_candles_get
parameters:
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: xyz:GOLD
title: Symbol
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Candles V1 Sample Candles Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/macro:
get:
tags:
- Samples
summary: Sample Macro
operationId: sample_macro_v1_sample_macro_get
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Macro V1 Sample Macro Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/calendar:
get:
tags:
- Samples
summary: Sample Calendar
operationId: sample_calendar_v1_sample_calendar_get
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Calendar V1 Sample Calendar Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/filings:
get:
tags:
- Samples
summary: Sample Filings
operationId: sample_filings_v1_sample_filings_get
parameters:
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: TSLA
title: Symbol
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Filings V1 Sample Filings Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/earnings:
get:
tags:
- Samples
summary: Sample Earnings
operationId: sample_earnings_v1_sample_earnings_get
parameters:
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Symbol
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Earnings V1 Sample Earnings Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/history:
get:
tags:
- Samples
summary: Sample History
operationId: sample_history_v1_sample_history_get
parameters:
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: xyz:GOLD
title: Symbol
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample History V1 Sample History Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/context:
get:
tags:
- Samples
summary: Sample Context
operationId: sample_context_v1_sample_context_get
parameters:
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: xyz:TSLA
title: Symbol
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Context V1 Sample Context Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/board/item:
get:
tags:
- Samples
summary: Sample Board Item
operationId: sample_board_item_v1_sample_board_item_get
parameters:
- name: id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Board Item V1 Sample Board Item Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
/v1/sample/dossier:
get:
tags:
- Samples
summary: Sample Dossier
operationId: sample_dossier_v1_sample_dossier_get
parameters:
- name: id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sample Dossier V1 Sample Dossier Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError